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.0/dsh-subagent-opencode-0.1.0.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 握手，用来确认连接是否正常。

字段

模型选择

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

兼容性

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

许可证

MIT

---

dsh-subagent-opencode (English)

An OpenCode subagent plugin for DeepSeek Harness.

Delegate a task to a local or remote (SSH) OpenCode instance. OpenCode runs it with its own models and tools; the Harness reviews the result.

Features

• Provider opencode: callable by standard subagent tools.
• Tool opencode_delegate_<name>: asks the user to pick a model, then runs in the background and returns a job id by default; it notifies you when finished and you read the result with job_output. Pass wait: true to block until the final text.
• Command /oc-<name> <task>: runs immediately without the model picker.
• Tool opencode_targets: list, add, update, remove, and test targets from a conversation.
• Skill dsh-opencode-subagent: guides the model to delegate when appropriate and to ask which target to use for ambiguous requests.

Requirements

• OpenCode with ACP support (opencode acp); no version pin.
• Local mode: opencode on PATH, or an absolute path. The Windows desktop build ships opencode-cli.exe outside PATH, so use its absolute path.
• Remote mode: passwordless SSH, opencode on the remote PATH, and a Linux or macOS remote.

Install

# 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.0/dsh-subagent-opencode-0.1.0.tgz

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

Open Plugins → OpenCode subagent to configure targets, or manage them from a conversation with opencode_targets.

Configuration example

- 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

Each entry registers a provider, a delegate tool, and an /oc-<name> command. Changes apply immediately; no dsh restart is needed.

Execution model

Delegations run in the background by default and do not block the current session: the tool returns a job id immediately, a background-job notification arrives when the run finishes, and job_output <job-id> reads the final result (job_kill <job-id> stops it). Pass wait: true to block until the final text.

The Test button on a target card starts the target and runs the ACP handshake to verify the connection.

Fields

Model selection

The model list comes from session/new (configOptions[id=model]). One screen lists every available model: the previously used model first, then by pick count and name; each option carries its context size, output limit, and input modalities. Choices are stored in Harness storage.

Compatibility

• DeepSeek Harness 0.2.x (developed against 0.2.1-rc.2).
• OpenCode with opencode acp support.
• Remote: Linux and macOS; Windows remotes are unverified.

License

MIT