dsh-opencode-go
DeepSeek Harness 的 OpenCode Go LLM provider 插件：注册 zen-go 路由，
每次出站推理请求都携带每会话稳定的 x-opencode-session。
运行环境：适配 DeepSeek Harness
0.1.5-rc.1（peer 依赖
@deepseek-ai/dsh-*声明为^0.1.5-rc.1）。
- 三端面全接：
chat/completions（mimo / deepseek-v4 / glm / kimi / longcat / hy）、
responses（grok / gpt-5.6-luna / muse-spark，含独立response.incomplete终态）、
messages（Anthropic 兼容：minimax / qwen，用x-api-key鉴权，max_tokens缺省 8192）。 - 会话头：
x-opencode-session取会话 id，缺失时按请求生成 UUID 兜底，保证请求一定带头。 - 客户端标识：
user-agent: deepseek-harness/<版本> (+url) dsh-opencode-go/<版本>，
三端面一致，可被运营方识别放行（绝不是Go-http-client/1.1那种通用串）。 - 凭证只走 seam：
credentials.resolve按“进程 env → 托管 store
（$DSH_HOME/.credentials.yaml，热加载）→ 项目/家目录.env”分层，
存换 key 不用重启。无明文字段。 - 设置卡：Models 页行 + 设置侧边栏独立入口（key 录入/清除、模型勾选与全选、
刷新实时目录、每模型自填上下文与输出上限、密钥状态点）。 - 推理档位：responses 系 Minimal/Low/Medium/High/Xhigh（落
reasoning.effort），chat 系
Low/Medium/High（reasoning_effort透传；deepseek-v4-flash/pro/flash-vision-exp
另有 Max 档——上游网关实测支持，感谢 @34262315716
真机验证并贡献，见 #1），messages 系
无档位词汇（显式传会报错）。
均不设默认值，Default 即不发字段。 - 多模态：vision 模型（
deepseek-v4-flash-vision-exp、两个 muse-spark）声明
["text","image"]，图片经 attachment 服务读盘转 base64 内联
（png/jpeg/webp/gif，单图 20MB 上限）；纯文本模型由 runtime 自动替换占位；
未知 id 默认放行，服务端说了算。 - 用量：三端面 usage 统一换算（
prompt_tokens/input_tokens双词汇），
输入输出总量原样保留，缓存读/写、reasoning token 分桶上报。 - 用量账本：每次调用记一条（模型/会话/实际发出的
x-opencode-session/用途/
输入输出/缓存读写/推理/finish），落$DSH_HOME/plugin-data/dsh-opencode-go/usage.jsonl
（append-only，清空时归档，不出网）；卡片里「概览/模型」双标签页：大格日历热力图 +
分模型表，可一键清空。点热力图任意一天，展开当天总计 + 按 dsh 会话 id
分组的明细（含实际发出的 session 头）。
路由刻意叫 zen-go 而不是 opencode-go——后者是用户自建 pi-ai profile
的常用名，llm 注册表单路由独占，撞名会顶掉别人的路由；apply() 启动时
也会主动检查，撞了就报 DUPLICATE_ADAPTER 快速失败，不连累他人。
安装
dsh plugin --profile web add github xia-sc/dsh-opencode-go
# 重启 dsh web，然后在会话模型选择器里选 zen-go/<模型>本地源码安装（dsh plugin add <目录>，pnpm link: 方式）
多一步——否则启动直接崩（见 #2）：
cd <插件源码目录>
node scripts/setup-local-deps.cjs # 自动定位宿主依赖树，建 node_modules/@deepseek-ai 桥
dsh plugin --profile web add <插件源码目录>
# 重启 dsh web原理一句话：link: 安装只是在 profile 里建个 junction 指回源码目录，
Node 按真实路径向上找 @deepseek-ai/* peer 包——源码盘里没有，只能
桥到宿主那份。--host <目录> 可显式指定宿主依赖树（install root /
node_modules / @deepseek-ai 本级都认），--dry-run 只探测不建链。
建桥失败（比如启动报 Cannot find package '@deepseek-ai/xxx'）就检查桥
还在不在：node_modules/@deepseek-ai 必须是 junction，不在就重跑脚本。
registry / github 安装不受影响，不用跑这步。
存 key（任选其一，存完即生效，不用重启）：
# $DSH_HOME/.credentials.yaml
version: 1
refs:
OPENCODE_GO_API_KEY: sk-你的key或设环境变量 OPENCODE_GO_API_KEY，或在设置卡里直接粘贴保存。
配置（layer config / llm-opencode-go settings section）
| 字段 | 默认 | 说明 |
|---|---|---|
apiKeyEnv |
OPENCODE_GO_API_KEY |
credential ref 名 |
apiBase |
https://opencode.ai/zen/go |
去掉尾部 /v1 前缀后的基址 |
requestTimeoutMs / streamIdleTimeoutMs |
60000 / 300000 |
建连+首包超时（响应头一到即停表，长流不受总时长限制） / 流空闲看门狗 |
enabledModels |
全表 | 提供哪些模型（卡片勾选即改这里） |
modelCaps |
[] |
[{id, contextWindow?, maxTokens?}]，自填容量覆盖 |
测试
node --test test/smoke.mjs
# 联网探活（花一点点额度）：
$env:OPENCODE_GO_API_KEY='<key>'; node --test test/smoke.mjs浏览器半构建
lib/client.js 是生成物，不要手改：改 src/client/*.js
（数字前缀即拼接顺序），然后跑 npm run build:client。
构建脚本拼完会做语法门检查，坏了直接失败，不会把坏包写进 lib/。
已知限制
- responses 系推理 effort 高时容易烧光 token 预算，大 maxTokens 起步更稳。
- 官方
/v1/models不返回上下文窗口，modelCaps目前靠手填；
官方补了字段即插即用。 - 价格由计费插件自己的价格表定，本插件只保证用量上报正确。
致谢
- @34262315716（Critical Natural）：真机验证上游网关
支持reasoning_effort=max，并贡献 deepseek-v4 三模型的 Max 档
（#1）；本地源码 link 安装
启动崩溃的根因分析（#2）。