dsh-orca

Orca 将远程操作接入 DeepSeek Harness 的工具、审批和侧栏体系。你可以在本机对话中完成资源检查、代码修改和任务管理，由已配置的 SSH 主机执行操作，无需迁移工作区。

界面预览

快速开始

1. 准备环境

远端执行逻辑使用 Python 标准库，无需部署独立的 Orca 常驻服务。

以下使用虚构别名 gpu-alpha。先换成自己的 SSH 别名并检查连接：

ssh -o BatchMode=yes gpu-alpha 'python3 --version'

2. 安装插件

git clone https://github.com/Becomingw/dsh-orca.git ~/plugins/dsh-orca

然后在 DSH 会话中发送：

请安装本地插件 ~/plugins/dsh-orca

由 DSH 插件管理器完成 bundle 安装。安装或更新后重启 DSH，以加载宿主工具和前端组件；无需单独启动前端开发服务器。

3. 打开并使用

1. 打开一个 DSH 会话，点击顶栏 机群，在右侧栏查看主机与任务。
2. 进入 设置 → Orca 配置 → 执行授权，选择模式或编辑规则，再点击 保存授权设置。
3. 在对话中描述需要完成的远程操作。

例如，替换下列示例主机和路径后发送：

查看 gpu-alpha 的 GPU、内存和磁盘状态。

读取 gpu-alpha 上 /srv/demo/vision/train.py 的前 120 行，
把 batch_size 从 32 改为 64，先展示补丁预检结果。

在 gpu-alpha 的 /srv/demo/vision 中用 tmux 启动 python3 train.py，
会话名为 vision-train，日志写入 /srv/demo/logs/train.log。

在本地修改已妥善保存后，拉取更新并重启 DSH：

git -C ~/plugins/dsh-orca pull --ff-only

本文描述仓库当前代码的功能；使用特定发行标签时，请以该标签内的文档为准。

授权模式

默认使用受控模式。 授权策略可以直接在前端修改，无需每次编辑配置文件。

展开 受控模式规则，可以编辑：

• 命令规则：每行一条 glob，支持 * 和 ?；拦截规则优先。免询问规则用于 run，拦截规则同时用于 run 和 launch。
• 信任目录：每行一个绝对路径或 glob；留空表示不限制目录范围。
• 审批方式：免询问、首次询问并记住、每次询问。受控模式下，停止任务固定为每次询问。
• 记忆期限：1–90 天，默认 7 天，仅影响新授权。授权按“主机 + 目录 + 操作类别”记录，可在机群面板撤销。

保存后，后续工具调用立即使用新策略，重启后保留。前端设置优先于配置文件中的 policy；点击 恢复配置文件并保存，可重新使用文件配置。模式切换保留受控规则，不取消已经执行或等待审批的调用。

开放模式只关闭 Orca 自身的命令过滤和额外审批。Harness 自身权限、配置的主机范围、工具参数校验、补丁冲突检测与任务身份校验仍然生效。

受控模式下，Harness 的 approval: never 表示不发起审批：需要审批的操作会被拒绝。它不等同于 Orca 的开放模式。

完整判定规则与存储说明见 授权策略文档。

工具一览

以下审批行为均指受控模式的默认策略；命令规则、目录范围与已有授权会参与最终判定。

连接与探测配置

日常授权设置使用前端即可。主机范围、Python 路径、后台探测间隔仍在当前 profile 的 cordis.patch.yml 中配置。

- id: orca 覆盖会替换整个 config，不是深度合并。请复制当前配置后修改，保留需要的字段。下面的别名和路径均为示例：

- id: orca
  name: dsh-orca
  config:
    hosts: [gpu-alpha, gpu-beta]
    python: python3
    policy:
      mode: controlled
      autoAllow: [status, read, grep, ls, grants]
      askOnce: [run, launch]
      alwaysAsk: [patch, rollback, stop]
      grantTtlDays: 7
      allowedCommands:
        - nvidia-smi
        - nvidia-smi *
        - git status
        - git log *
        - git diff *
        - ls *
        - tail *
        - df -h *
      deniedCommands:
        - rm -rf /*
        - sudo *
        - shutdown*
        - reboot*
        - mkfs*
        - kill -9 -1*
      trustedWorkdirs: [/srv/demo/*]
    panel:
      pollSeconds: 120
      jobLimit: 5

修改文件配置后重启 DSH。如果已在前端保存授权覆盖，需先在前端选择 恢复配置文件并保存，文件中的 policy 才会重新成为生效来源。

前端授权覆盖与记忆授权默认位于 $DSH_HOME/storages/orca/（未设置 DSH_HOME 时使用 ~/.dsh）。多个 profile 需要隔离策略时，分别设置独立的 policyPath 和 grantsPath。详见 授权策略文档。

数据与执行边界

• 面板是缓存视图。 打开面板本身不触发 SSH；宿主定期探测，点击刷新可主动更新。失败时保留最后成功的数据并标记过期。
• 任务数是已知数量。 面板只覆盖最近登记记录；统计不完整时显示 +。零任务不代表整台主机空闲，也不展示所有用户进程。
• 日志尾按需读取。 普通命令执行期间没有流式输出；长任务使用 tmux 和结构化日志查看进展。
• 停止针对登记任务。 面板停止前需要确认，并复核任务身份；过期记录不能直接停止。
• 补丁可能发生冲突。 写入前检查文件状态，失败结果会报告冲突、恢复或部分应用状态；需要根据结果处理，不能假定所有失败都已自动恢复。

开发与测试

本仓库使用原生 JavaScript 与 Python。运行测试需要 Node.js ≥ 22、Python 3、pytest 和本机 tmux；远端执行测试通过隔离的假 SSH 与 tmux socket 运行。

# 安装测试依赖到独立环境
python3 -m venv .venv
source .venv/bin/activate
python -m pip install pytest

# JavaScript + Python 测试
npm test

可选环境变量：

• ORCA_DSH_TOOLS：指向 @deepseek-ai/dsh-tools/lib/index.js，使用宿主校验器检查工具 schema。
• ORCA_CODEX_BIN：指向本机 Codex 可执行文件，启用补丁结果的交叉对照。
• ORCA_UPSTREAM_ENGINE：指向 remote-fleet 的 scripts/remote_fleet_mcp.py，启用协议契约测试；也会尝试相邻的 ../remote-fleet。

缺少可选依赖时，相应测试会跳过；以测试输出为准。

dsh-orca/
├── index.js                # 宿主入口、工具注册与审批接线
├── client.js               # 原生工具卡片、机群侧栏、可编辑设置
├── cordis.patch.yml        # bundle 默认配置
├── lib/
│   ├── engine.js           # Python 引擎桥与取消处理
│   ├── tools.js            # 工具 schema 与模型输出
│   ├── policy.js           # 受控 / 开放模式判定
│   ├── settings.js         # 授权覆盖的校验与持久化
│   ├── grants.js           # 记忆授权
│   ├── cache.js            # 机群状态缓存
│   └── routes.js           # 经过宿主鉴权的前端接口
├── engine/                 # SSH、任务、日志、文件与补丁执行
├── test/                   # JavaScript 测试
├── tests/                  # Python 测试与场景夹具
└── docs/                   # 设计说明、操作文档与示例截图

文档导航

来源与许可证

Orca 的执行引擎派生自 remote-fleet v0.7.0，以 DSH 原生工具提供能力，并在本仓库独立演进。冻结点见 UPSTREAM.md，协议差异见 兼容性文档。

本项目采用 MIT License。第三方来源与声明见 NOTICE；Codex 测试场景的 Apache-2.0 声明保留在 场景 NOTICE 中。