dsh-opencode-go-autosync
DeepSeek Harness 插件：一键把 models.opencode.ai/api.json 的 opencode-go 模型目录同步为 DSH 模型供应商 opencode-go-autosync。
已有 opencode-go-autosync 时只刷新模型列表；不存在时一键创建，无需手动更新 settings.yaml。
为什么需要它
DSH 的 llm-pi-ai 通过 @earendil-works/pi-ai 的内置目录提供 opencode-go 供应商，其模型列表是 打包时 的静态快照（dist/providers/data/opencode-go.json，当前 19 个模型），只有随 pi-ai 发版、再随 DSH 升级才会更新。
而上游 https://models.opencode.ai/api.json 是动态目录（当前 opencode-go 28 个模型，持续新增/下线），二者会随时间产生缺口：新模型在设置页选不到，已下线模型的 contextWindow / reasoningEfforts 也可能过时。llm-pi-ai 文档亦明确标注 A route's catalog never refreshes itself，discovery 的 GET /models 也只返回 id，拿不到 contextWindow / reasoningEfforts / compat 等富元数据，因此否则需要手动维护 settings.yaml 中的模型列表。
本插件把这一转换搬进运行时：设置页一个按钮（可选定时）fetch(api.json) → 映射 → mutate llm-pi-ai.providers.opencode-go-autosync，首次创建自定义供应商并写入 api / baseURL / compat / apiKeyEnv，之后仅覆盖 models，保留你已配的密钥与地址，从此无需手动更新。
功能
- 一键创建/更新：设置页按钮读取上游
https://models.opencode.ai/api.json 的 opencode-go，写入 llm-pi-ai.providers.opencode-go-autosync。
- 只动模型列表：已存在供应商时，仅覆盖
models，保留你配过的 apiKeyEnv / baseURL / compat 等字段。
- 完整字段映射：
limit.context→contextWindow / limit.output→maxTokens / modalities→input / reasoning+reasoning_options→reasoningEfforts（none→off:none，其余直通；非推理模型写 reasoningEfforts: false）。
- 自动过滤弃用模型：上游标记
status: "deprecated" 的模型不会写入目标（上游只打标不删除，并通常已放出替代版）。
- 可选自动同步：配置
autoSync: true 后每 6 小时（可配）自动刷新一次。
安装
前置
- DSH 已安装（
pnpm dsh --help 可用），profile 建议 web。
从 GitHub 安装
pnpm dsh plugin --profile web add github:CJYLZS/dsh-opencode-go-autosync
或先克隆再本地安装（注意 ./）：
git clone https://github.com/CJYLZS/dsh-opencode-go-autosync.git
pnpm dsh plugin --profile web add file:./dsh-opencode-go-autosync
# 也可用绝对路径：pnpm dsh plugin --profile web add file:/abs/path/to/dsh-opencode-go-autosync
安装后重启 DSH：
pnpm dsh --profile web
卸载：
pnpm dsh plugin --profile web remove dsh-opencode-go-autosync
使用
- 打开 DSH 设置页 → Plugins，找到 Opencode Go 同步 卡片。
- 点 一键创建/更新。首次会创建
opencode-go-autosync，再次点击仅刷新模型列表。
- 预览上游 可不落盘查看上游模型数。
目标供应商名默认为 opencode-go-autosync，可在插件配置中改为任意名字（如 opencode-go-custom）。
API Key 配置
本插件不存密钥，只把供应商的 apiKeyEnv 指向一个环境变量名，密钥由 DSH 凭据体系解析。
1. 设置供应商的凭据引用
- 设置页：模型 → 选中
opencode-go-autosync → apiKeyEnv 填 OPENCODE_API_KEY（或 OPENCODE_GO_CUSTOM_API_KEY 等自定义名）。
- 或直接编辑
~/.dsh/settings.yaml：
llm-pi-ai:
providers:
opencode-go-autosync:
apiKeyEnv: OPENCODE_API_KEY
api: openai-completions
baseURL: https://opencode.ai/zen/go/v1
compat:
thinkingFormat: openai
supportsReasoningEffort: true
插件首次创建时会自动写入上述 api / baseURL / compat / apiKeyEnv 默认值（apiKeyEnv 取上游 env[0]，默认为 OPENCODE_API_KEY）。
2. 写入密钥值
任选其一（优先级：设置凭据 > 环境变量）：
- 推荐：DSH 设置页的凭据/密钥管理中，为
OPENCODE_API_KEY 填入真实 key（存入 ~/.dsh/.credentials.yaml，设置页脱敏显示）。
- 或在启动 DSH 的环境中导出：
export OPENCODE_API_KEY="sk-..."
pnpm dsh --profile web
- 或写入
~/.dsh/.env / 项目 .env（被 loadLayeredEnv 载入）：
OPENCODE_API_KEY=sk-...
验证：设置页中该供应商显示已配置；对话选 opencode-go-autosync 下任意模型可正常出流。
插件配置
cordis.patch.yml 中 opencode-go-sync 的 config：
| 字段 | 默认 | 说明 |
|---|
sourceURL | https://models.opencode.ai/api.json | 上游目录地址 |
sourceProvider | opencode-go | 上游 JSON 中的 provider key |
targetProvider | opencode-go-autosync | 写入 llm-pi-ai.providers.<key> 的目标名 |
targetApiKeyEnv | 上游 env[0] | 覆盖目标的 apiKeyEnv（不设则用上游默认值） |
targetBaseURL | 上游 api | 覆盖目标的 baseURL |
targetCompat | {thinkingFormat: openai, supportsReasoningEffort: true} | 覆盖目标的 compat |
extraIds | [] | 额外保留的私有模型 id（如 hy3-preview），上游没有时仍以空条目写入 |
autoSync | false | 是否定时自动同步 |
autoSyncIntervalMs | 21600000 (6h) | 自动同步间隔，最小 60s |
示例（profiles/web/cordis.patch.yml 覆盖）：
- id: opencode-go-sync
config:
extraIds: [hy3-preview, muse-spark-1.2]
autoSync: true
autoSyncIntervalMs: 43200000
常见问题
file:.tmp/... 安装失败 LINKED_PKG_DIR_NOT_FOUND：本地路径必须带 ./，写 file:./.tmp/... 或 file:/abs/...。- 上游拉取失败：按钮会回显
sync-failed: HTTP ...，检查网络或 sourceURL。
- 密钥未生效：确认
apiKeyEnv 指向的变量名与凭据/环境变量一致，且 DSH 已重启载入。
许可
MIT
