前言¶
用 DeepSeek Harness（DSH）做开发时，模型和工具往往绑在本机工作区：查 GPU、改训练脚本、在远端跑长任务，常见做法是切终端、手写 SSH，或再挂一层 MCP。操作结果散落在多个窗口，Harness 侧的审批与工具卡片也难以统一承接。
Orca 是 DSH 的本地 bundle 插件，把「受信 SSH 主机」接进 Harness 的原生工具、审批和右侧栏。决策留在本机对话里，执行落在 ~/.ssh/config 里已配置的主机别名上；远端只需 Bash、Python 3 与 OpenSSH，不部署 Orca 常驻服务。执行引擎派生自 remote-fleet v0.7.0，在本仓库以 orca_* 工具独立演进（当前包版本 0.8.0，MIT）。
维护者：Becomingw。目录页：skillhub.cn/plugins/Becomingw/dsh-orca；源码：github.com/Becomingw/dsh-orca。社区插件目录与 DeepSeek / 幻方无官方从属关系。
这是什么¶
一句话：本机决策，机群执行。
插件提供 10 个原生 orca_* 工具，以及带缓存的机群面板：主机连接状态、GPU / 内存 / 磁盘、登记任务、命令输出、分页读文件、服务端 grep、带预检与回滚的补丁、tmux 长任务等，都在对话与侧栏里查看结果。支持中英双语界面。
核心功能¶
机群面板¶
顶栏打开 机群，在右侧栏集中查看主机状态与最近任务。面板是缓存视图：打开侧栏本身不发起 SSH；宿主按配置间隔后台探测，也可手动刷新。失败时保留上次成功数据并标记过期。未显式配置 hosts 时，工具可使用 SSH 配置中的别名，面板自动发现并监控最多 12 台；显式配置后，工具与面板范围限于该列表。
原生工具与展示¶
工具调用结果以 Harness 原生工具卡片呈现：命令输出、带行号的文件内容、搜索结果、diff 与冲突分块展示，可展开与复制。普通 orca_run 在时限与输出上限内执行，无流式输出；长任务通过 orca_launch 走 tmux 与结构化日志，按需查看日志尾。
补丁与任务¶
orca_patch 在写入前做预检，校验上次读取的文件哈希；记录备份与 patch ID，冲突时给出可操作的反馈。orca_rollback 按 patch ID 回滚。orca_stop 针对面板登记的任务，停止前需确认并复核任务身份。
授权模式¶
默认 受控模式：命令 glob 拦截与免询问规则、信任目录、按操作类别的审批（免询问 / 首次询问并记住 / 每次询问）、1–90 天记忆期限，均可在 设置 → Orca 配置 → 执行授权 中编辑并保存，无需每次改配置文件。开放模式 关闭 Orca 自身的命令过滤与额外审批，但 Harness 权限、主机范围、参数校验、补丁冲突检测与任务身份校验仍生效。
受控模式下各工具默认审批策略（可被规则与记忆授权覆盖）如下：
| 工具 | 用途 | 默认审批 |
|---|---|---|
orca_status |
主机资源、GPU、tmux 与登记任务 | 免询问 |
orca_read |
分页读取远端文件 | 免询问 |
orca_grep |
服务端搜索（含上下文与 .gz） |
免询问 |
orca_ls |
列出目录与文件 | 免询问 |
orca_run |
限时、限输出的命令 | 首次询问并记住 |
orca_launch |
tmux 长任务与日志 | 首次询问并记住 |
orca_patch |
预检与应用补丁 | 每次询问；dry_run 免询问 |
orca_rollback |
按 patch ID 回滚 | 每次询问 |
orca_stop |
停止登记任务 | 每次询问 |
orca_grants |
列出或撤销记忆授权 | 免询问 |
主机范围、python 启动命令、面板 pollSeconds / jobLimit 等仍在当前 profile 的 cordis.patch.yml 中配置；前端保存的授权覆盖优先于文件中的 policy，可通过 恢复配置文件 再保存以回到文件策略。记忆与覆盖默认目录为 $DSH_HOME/storages/orca/（未设置 DSH_HOME 时为 ~/.dsh）。
安装与启用¶
1. 准备环境¶
| 位置 | 要求 |
|---|---|
| 本机 | DeepSeek Harness、Node.js ≥ 22、Python 3、OpenSSH 客户端 |
| 远端 | 可 SSH 的 Linux，Bash 与 Python 3；长任务需 tmux；GPU 指标需 nvidia-smi |
| SSH | 使用 ~/.ssh/config 中的 Host 别名，终端应能无交互连接 |
先用 BatchMode 检查别名（示例主机名请换成自己的）：
ssh -o BatchMode=yes gpu-alpha 'python3 --version'
2. 安装插件¶
按仓库 README，将插件放到本机目录后，在 DSH 会话 中让插件管理器安装 bundle：
git clone https://github.com/Becomingw/dsh-orca.git ~/plugins/dsh-orca
请安装本地插件 ~/plugins/dsh-orca
安装或更新后 重启 DSH，以加载宿主工具与前端组件；无需单独启动前端开发服务器。更新已安装副本时，可在仓库目录 git pull --ff-only 后同样重启 DSH。
3. 初次使用¶
- 打开 DSH 会话，点顶栏 机群 查看主机与任务。
- 进入 设置 → Orca 配置 → 执行授权，选择模式或编辑规则，点击 保存授权设置。
- 在对话中描述远程操作，由模型调用
orca_*工具。
典型用法¶
下列示例来自官方 README，替换主机别名与路径后即可复现。
查看资源：
查看 gpu-alpha 的 GPU、内存和磁盘状态。
读文件、改参数并先看补丁预检：
读取 gpu-alpha 上 /srv/demo/vision/train.py 的前 120 行，
把 batch_size 从 32 改为 64，先展示补丁预检结果。
用 tmux 启动训练并写日志：
在 gpu-alpha 的 /srv/demo/vision 中用 tmux 启动 python3 train.py，
会话名为 vision-train，日志写入 /srv/demo/logs/train.log。
适用场景与注意¶
适合谁： 已在 DSH 里做智能体或日常开发，有多台受信 Linux（尤其带 GPU）需要通过 SSH 统一查看状态、读改代码、跑 tmux 任务，并希望操作走 Harness 工具与审批链路，而不是另开一套远程 MCP 或迁工作区。
运行边界： 插件以当前 DSH 进程权限在本机运行，通过你的 SSH 身份访问远端；安装前请阅读源码与 MIT 许可证，确认主机范围与授权规则符合自己的安全要求。面板任务数只覆盖最近登记记录，零任务不代表主机空闲；补丁失败时需根据冲突报告自行处理，不能假定已全部自动恢复。受控模式下若 Harness 配置 approval: never，需要审批的操作会被拒绝，这与 Orca 开放模式不是同一概念。
更细的面板口径、策略存储与架构说明见仓库 docs/（如 panel.md、policy.md）。
结尾¶
Orca 把 SSH 机群收成 DSH 内的 10 个 orca_* 工具与缓存机群面板：状态可读、文件可搜可改、命令与 tmux 任务可管，授权可在前端可视化配置。若你正在扩展 DSH 插件生态，可从目录页与 GitHub 仓库获取安装步骤与配置示例。
- 目录页：https://www.skillhub.cn/plugins/Becomingw/dsh-orca
- GitHub：https://github.com/Becomingw/dsh-orca
