OpenCode 子智能体 NewSpringWei/dsh-subagent-opencode

dsh-subagent-opencode

OpenCode 子智能体插件，用于 DeepSeek Harness。

把任务委派给本机或远端（SSH）的 OpenCode；OpenCode 用自己的模型和工具执行，Harness 负责验收。

功能

- 子代理 provider opencode：可被标准子代理工具调用。
- 委派工具 opencode_delegate_<name>：先询问用户选择模型（单面板），然后默认在后台执行并返回 job id；完成后通知，用 job_output 收集结果。传 wait: true 可同步等待最终文本。
- 命令 /oc-<name> <task>：直接执行，不经过模型选择。
- 目标管理 opencode_targets：在对话中列出、添加、修改、删除、测试目标。
- 技能 dsh-opencode-subagent：引导模型在合适时委派，模糊请求先询问用户选择目标。

要求

- OpenCode 支持 ACP，即能运行 opencode acp；不限制版本。
- 本机模式：opencode 在 PATH 中，或填写可执行文件的绝对路径。Windows 桌面版自带的 opencode-cli.exe 通常不在 PATH，需要填绝对路径。
- 远端模式：目标机已配置 SSH 免密登录，且 opencode 在远端 PATH 中。远端需为 Linux 或 macOS。

安装

GitHub（推荐）
dsh plugin --profile <profile> add github:NewSpringWei/dsh-subagent-opencode

预构建 tarball（安装更快，不需要本地构建）
dsh plugin --profile <profile> add https://github.com/NewSpringWei/dsh-subagent-opencode/releases/download/v0.1.1/dsh-subagent-opencode-0.1.1.tgz

本地 checkout（开发）
dsh plugin --profile <profile> add file:<path-to-plugin>/code

安装后打开「插件 → OpenCode 子智能体」配置目标，也可以直接在对话里用 opencode_targets 工具管理。

配置示例

- name: dsh-subagent-opencode
config:
providers:
- name: local
mode: local
command: opencode
args: ['acp']
permission: allow
- name: remote
mode: remote
sshHost: user@host
remoteCwd: /home/user/workspace
permission: allow

每个 providers 条目会注册一个子代理 provider、一个委派工具和一个 /oc-<name> 命令。配置保存后立即生效，不需要重启 dsh。

执行方式

委派默认后台执行，不阻塞当前会话：调用后立即返回 job id，任务完成后通过后台任务通知提醒，用 job_output <job-id> 读取最终结果，job_kill <job-id> 可终止。需要当场拿到答案时传 wait: true。

目标卡片上的「测试」按钮会启动目标并完成 ACP 握手，用来确认连接是否正常。

字段

| 字段 | 默认 | 说明 |
| name | 必填 | 实例名，用于 provider、工具名和历史记录 |
| mode | local | local 或 remote |
| command | opencode | 启动 OpenCode 的命令；远端模式下为远端命令 |
| args | ['acp'] | 命令参数 |
| sshHost | — | SSH 目标，remote 必填 |
| sshArgs | ['-o','BatchMode=yes'] | SSH 参数 |
| remoteOs | linux | 远端系统；linux/darwin 走 POSIX，windows 未验证 |
| localCwd | 临时目录 | 远端模式下 SSH 子进程的本机工作目录 |
| remoteCwd | — | 远端工作目录，传给 OpenCode 的 session/new |
| permission | allow | 自动应答权限请求：allow 或 reject |
| model | — | 可选固定模型；默认由委派工具询问用户 |
| env | {} | 子进程环境变量 |
| disposeEofGraceMs | 6000 | 子进程关闭前的宽限时间 |
| disposeGraceMs | 3000 | 终止子进程的等待上限 |

模型选择

模型列表来自 OpenCode session/new 的 configOptions[id=model]，一次列出全部可用模型：上次使用的模型排第一，其余按使用次数、名称排序；选项附带上下文、输出上限和输入模态。选择记录保存在 Harness 存储中。

兼容性

- DeepSeek Harness 0.2.x（开发验证版本 0.2.1-rc.2）。
- OpenCode 支持 opencode acp 即可。
- 远端支持 Linux 和 macOS；Windows 远端暂未验证。

版本更新记录见 changelog/CHANGELOG.md。

许可证

MIT

dsh-subagent-opencode（英文）

OpenCode 子智能体插件，用于 DeepSeek Harness。

把任务委派给本机或远端（SSH）的 OpenCode 实例。OpenCode 用自己的模型和工具执行；Harness 验收结果。

功能

- 服务商 opencode：标准子代理工具可直接调用。
- 工具 opencode_delegate_<name>：先让你选模型，然后在后台运行，默认返回 job id；跑完会通知你，你用 job_output 读取结果。传 wait: true 可阻塞到拿到最终文本。
- 命令 /oc-<name> <task>：立即运行，不弹模型选择器。
- 工具 opencode_targets：在会话里列出、添加、更新、删除、测试目标。
- 技能 dsh-opencode-subagent：引导模型在合适时机委派，遇到含糊请求时先问用哪个目标。

环境要求

- 支持 ACP 的 OpenCode（opencode acp）；不锁定版本。
- 本地模式：opencode 在 PATH 里，或用绝对路径。Windows 桌面版把 opencode-cli.exe 放在 PATH 之外，请用它的绝对路径。
- 远程模式：免密 SSH、远程 PATH 里有 opencode、远程系统为 Linux 或 macOS。

安装

GitHub (recommended)
dsh plugin --profile <profile> add github:NewSpringWei/dsh-subagent-opencode

prebuilt tarball (faster, no local build)
dsh plugin --profile <profile> add https://github.com/NewSpringWei/dsh-subagent-opencode/releases/download/v0.1.1/dsh-subagent-opencode-0.1.1.tgz

local checkout (development)
dsh plugin --profile <profile> add file:<path-to-plugin>/code

打开 Plugins → OpenCode subagent 配置目标，也可以在会话里用 opencode_targets 管理。

配置示例

- name: dsh-subagent-opencode
config:
providers:
- name: local
mode: local
command: opencode
args: ['acp']
permission: allow
- name: remote
mode: remote
sshHost: user@host
remoteCwd: /home/user/workspace
permission: allow

每个条目注册一个服务商、一个委派工具和一个 /oc-<name> 命令。改动立即生效，不用重启 dsh。

执行模型

委派默认在后台运行，不阻塞当前会话：工具立刻返回 job id，跑完后会收到后台任务通知，再用 job_output <job-id> 读取最终结果（job_kill <job-id> 可终止）。传 wait: true 可阻塞到拿到最终文本。

目标卡片上的 Test 按钮会启动目标并跑一遍 ACP 握手，验证连接。

字段

| 字段 | 默认值 | 含义 |
| name | 必填 | 实例名，供服务商、工具和历史记录使用 |
| mode | local | local 或 remote |
| command | opencode | 启动命令；远程模式下为远程命令 |
| args | ['acp'] | 命令参数 |
| sshHost | — | SSH 目标；remote 模式必填 |
| sshArgs | ['-o','BatchMode=yes'] | SSH 参数 |
| remoteOs | linux | 远程系统；linux/darwin 走 POSIX，windows 未验证 |
| localCwd | 临时目录 | 远程模式下 SSH 子进程的本地工作目录 |
| remoteCwd | — | 传给 session/new 的远程工作目录 |
| permission | allow | 自动应答权限请求：allow 或 reject |
| model | — | 可选的固定模型；默认情况下，delegate 工具会询问用户 |
| env | {} | 子进程环境 |
| disposeEofGraceMs | 6000 | 关闭子进程前的宽限时间 |
| disposeGraceMs | 3000 | 终止子进程的上限 |

模型选择

模型列表来自 session/new（configOptions[id=model]）。一个界面列出所有可用模型：先显示上次用过的模型，再按选择次数和名称排序；每个选项都带有上下文大小、输出上限和输入模态。选择结果保存在 Harness 存储中。

兼容性

- DeepSeek Harness 0.2.x（基于 0.2.1-rc.2 开发）。
- 支持 opencode acp 的 OpenCode。
- 远程：Linux 和 macOS；Windows 远程尚未验证。

更新日志见 changelog/CHANGELOG.md。

许可证

MIT