dsh-opencode-acp
在 DeepSeek Harness 中将 opencode 作为 ACP 子代理运行：提供委派工具、设置页面，以及包含 opencode 会话 ID 和 token 使用量的运行历史。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:wangqingdhuo/dsh-opencode-acp#ae71c51e7bc6b993e3a041acb5afd78bbad1e74aOpencode Acp 以 dsh-opencode-acp 发布，当前版本为 0.3.2。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Run opencode as an ACP subagent inside DeepSeek Harness (DSH).
Your main agent keeps its own model and context; subagent_opencode hands a self-contained task to
opencode in a separate process, opencode does the work with its own models, tools and free tier,
and only the final answer comes back. A settings page lets you switch models, choose the permission
policy and working directory, and watch every run — including the opencode session id, duration and
token usage.
dsh plugin --profile default add dsh-opencode-acp, then restart or refresh DSH.| DeepSeek Harness | >=0.2.1-rc.1 <0.3.0 (declared as engines.dsh; install refuses other versions) |
| opencode | v2 with the acp subcommand (opencode --version, opencode acp --help) |
| opencode auth | already logged in (opencode auth login); the child reuses your login and free models |
From the DSH Plugins page, or from a terminal:
# from npm (prebuilt, no build step)
dsh plugin --profile default add dsh-opencode-acp
# or from a tarball
dsh plugin --profile default add ./dsh-opencode-acp-0.3.1.tgz
Then restart or refresh DSH. Two things appear:
subagent_opencode for every agent in the profile;Just ask for it, or call the tool directly:
Delegate to subagent_opencode: in this repo, add a unit test for parseDuration and report what you changed.
The call returns immediately with a child id; the completion notice carries opencode's final answer. The child gets only your task text and the working directory — never your conversation.
| Group | Setting | Meaning |
|---|---|---|
| Model | main model | Picker built from the models your opencode has used, plus a free-form id |
| Model | small model | opencode's model for titles and small jobs (blank = let opencode choose) |
| Model | health check | Runs opencode --version and reports whether the executable resolves |
| Model | test model | Starts one throwaway session against the saved model and answers whether it works right now (it spends one real request) |
| Model | refresh list | Runs opencode models and merges the free-tier entries into the picker; cached in catalog.json, so it costs one short subprocess, not a request |
| Execution | permission | allow auto-answers permission requests, reject denies them |
| Execution | working directory | Follow the calling session, or pin one path |
| Advanced | command / args | The opencode executable plus the acp argument |
| Advanced | grace | Process teardown window in milliseconds |
| Advanced | env | Extra environment variables as a JSON object |
Settings live in $DSH_HOME/opencode-acp/settings.json; runs in runs.json beside it (last 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
OPENCODE_CONFIG_CONTENT into the child; OPENCODE_CONFIG (a file path) is
ignored by opencode acp in v2 — verified, not assumed.subagent instead.@deepseek-ai/dsh-subagent-acp. Treat delegation as "opencode may do what you
could do".| Symptom | Cause and fix |
|---|---|
Delegation fails with category: free-limit | opencode's free tier is exhausted for the account. Click 测试模型 to see which model works now, or connect a provider in opencode. |
Delegation fails with category: provider.internal + "Model is unavailable" | that model's endpoint is down right now; pick another one |
| The settings page shows a read error or is blank | the Host could not register /.dsh-opencode-acp/*. Restart DSH; if it persists, check that the bundle is enabled in Plugins. |
卡住 on a delegation that never returns | fixed in 0.3.0: a child that dies mid-request now fails the run instead of leaving it pending |
Windows: EPERM ... rename ... state.json from another plugin | two DSH instances writing the same profile state. Quit from the tray and start once. |
The /.dsh-opencode-acp/* routes are unauthenticated by design and reachable from any process on
this machine (localhost only). Run history and settings are stored as plain JSON under
$DSH_HOME/opencode-acp/; treat that directory as sensitive as your shell history.
%APPDATA%\npm\node_modules\@opencode\cli\bin\opencode.exe) and opencode on PATH
elsewhere; override Advanced → command if your install differs.dsh plugin --profile default remove dsh-opencode-acp
Removing the bundle removes the tool and the settings page; $DSH_HOME/opencode-acp stays until you
delete it.
Plain JavaScript, no build step.
npm run check # node --check on both halves
npm test # contract smoke test: loads both halves with stubbed runtimes
npm pack --dry-run
The Host half is index.js (ACP client, provider, storage, HTTP routes under /.dsh-opencode-acp),
the browser half is client.js (a settings.section page registered through the client module
table). Both are named exports; cordis.patch.yml inserts the two rows.
MIT