Skip to content

dsh-opencode-acp

Verified

dsh-opencode-acp · v0.3.1 · MIT · Web UI

Run opencode as an ACP subagent inside DeepSeek Harness: a delegation tool, a settings page, and a run history with opencode session ids and token usage.

Install

dsh plugin add dsh-opencode-acp

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Creators

Readme

dsh-opencode-acp

把 opencode 接成 DeepSeek Harness(DSH)的子代理。

主代理继续用自己的模型和上下文;subagent_opencode 把一件独立的任务交给另一个进程里的 opencode,由它用自己的模型、工具和免费额度干活,只把最终答案带回来。设置页里可以切换模型、 选择权限策略和工作目录,并查看每一次运行——包括 opencode 那边的会话 id、耗时和 token 用量。

English

为什么值得装

  • 两个 harness,一次对话。 DSH 负责调度,opencode 出模型和手脚;它干活的中间过程不进你的 上下文,也不进你的账单。
  • 看得见发生了什么。 这个插件自己说 ACP,所以每次运行都会记下远端会话 id、模型、耗时、 工具调用次数和 token——"刚才那次是 opencode 里的哪个会话"有答案。
  • 改设置不用重启。 设置在每次委派开始时读取,保存后下一次委派就生效。

前置条件

DeepSeek Harness >=0.2.1-rc.1 <0.3.0(写在 engines.dsh 里,不匹配会拒绝安装)
opencode v2,带 acp 子命令(opencode --version、opencode acp --help 能跑)
opencode 登录 已登录(opencode auth login);子进程复用它,包括免费模型

安装

在 DSH 的插件页面安装,或者用命令行:

# 从 npm(预构建,无需构建步骤)
dsh plugin --profile default add dsh-opencode-acp

# 或者从 tarball
dsh plugin --profile default add ./dsh-opencode-acp-0.3.0.tgz

装完重启或刷新 DSH,会出现两样东西:

  • 一个叫 subagent_opencode 的委派工具,该 profile 下所有 agent 都能用;
  • 设置 → OpenCode 委派 配置页。

怎么用

直接说,或者调工具:

交给 subagent_opencode:在这个仓库里给 parseDuration 补一个单元测试,并说明你改了什么。

调用立刻返回一个子代理 id,完成通知里带 opencode 的最终答复。子进程只拿到你的任务文本和工作 目录,拿不到你的对话历史。

设置项

分组 设置 含义
模型 主模型 下拉列出你 opencode 用过的模型,也允许手填 id
模型 小模型 opencode 生成标题/小任务用的模型(留空让它自己挑)
模型 健康检查 跑一次 opencode --version,确认可执行文件找得到
模型 测试当前模型 用已保存的模型起一个一次性会话,当场告诉你能不能跑(会真实消耗一次请求)
执行 权限应答 allow 自动放行权限请求,reject 一律拒绝
执行 工作目录 跟随调用方会话,或固定一个路径
高级 命令 / 参数 opencode 可执行文件 + acp 参数
高级 收尾宽限 子进程退出等待,毫秒
高级 环境变量 额外环境变量(JSON 对象)

设置存在 $DSH_HOME/opencode-acp/settings.json,运行记录在同目录的 runs.json(最近 100 条)。

原理

DSH agent ── subagent_opencode ──► ctx.subagents ──► dsh-opencode-acp(provider 名 "opencode")
                                                        │ spawn: opencode acp
                                                        ▼
                                              ACP over stdio(NDJSON JSON-RPC)
                                       initialize → session/new → session/prompt
                                                        │
                                     ◄── agent_message_chunk、usage_update
  • ACP 协议不带模型参数,所以模型只能在 opencode 侧决定。这个插件向子进程注入 OPENCODE_CONFIG_CONTENT;OPENCODE_CONFIG(文件路径)在 v2 的 acp 模式下会被忽略——这是 实测结论,不是猜的。
  • 一次性执行:外部 ACP 子代理收不到后续消息,所以不可追问。需要多轮请用 DSH 自带的 subagent。
  • 子进程用你的用户账号运行,不受 DSH 沙箱约束,和 DSH 官方的 @deepseek-ai/dsh-subagent-acp 行为一致。把它当成"opencode 能干你本人能干的事"。

排错

现象 原因与处理
委派失败,category: free-limit opencode 免费额度按账号耗尽。点 测试当前模型 看现在哪个能用,或在 opencode 里接一个付费 provider。
委派失败,category: provider.internal + "Model is unavailable" 该模型的端点此刻不可用,换一个模型。
设置页读不出来 / 空白 Host 没能注册 /.dsh-opencode-acp/*。重启 DSH;仍不行就去插件页确认 bundle 是启用的。
委派一直卡住不返回 0.3.0 已修:请求进行中若子进程死掉,现在会立即失败而不是挂起。
Windows 下别的插件报 EPERM ... rename ... state.json 两个 DSH 实例在写同一份 profile 状态。从托盘退出后再启动一个。

/.dsh-opencode-acp/* 这组路由没有鉴权,本机任何进程都能访问(只监听回环)。运行记录和设置以明文 JSON 存在 $DSH_HOME/opencode-acp/,敏感程度等同于你的 shell 历史。

已知限制

  • 只回传 assistant 文本;opencode 的工具调用、思考、计划都留在它自己的会话里。
  • 每次运行新起一个进程,有数秒启动开销。
  • Windows / macOS / Linux 都支持。默认命令在 Windows 上是 npm 全局安装的 %APPDATA%\npm\node_modules\@opencode\cli\bin\opencode.exe,其他平台是 PATH 里的 opencode;装法不同就在 高级 → 启动命令 改掉。

卸载

dsh plugin --profile default remove dsh-opencode-acp

移除后工具和设置页一起消失;$DSH_HOME/opencode-acp 里的数据要手动删。

开发

纯 JavaScript,没有构建步骤。

npm run check   # 两半都做 node --check
npm test        # 契约冒烟测试:用桩运行时加载两半并校验注册结果
npm pack --dry-run

宿主半是 index.js(ACP 客户端、provider、存储、/.dsh-opencode-acp 下的 HTTP 路由), 浏览器半是 client.js(通过客户端模块表注册的 settings.section 页面)。两半都是具名导出, cordis.patch.yml 插入两行。

许可

MIT