前言¶
DeepSeek Harness（DSH）内置的 pi-ai 模型目录会随发行版更新，往往落后于 OpenCode Go、OpenCode Zen 以及原生 OpenAI Codex 线上可用的模型列表。若只依赖内置目录，设置里可能选不到新模型，或仍保留已下线的条目。手动改配置或等待 DSH 发版合并目录，对日常开发都不方便。
下面介绍社区插件 dsh-opencode-live-models（维护者 Luca4Don3，分类：模型推理）。它在运行时刷新上述三条路线的模型目录，并在不破坏 OpenCode 会话头与 prompt-cache 保留策略的前提下合并到 DSH；同时把 ChatGPT 登录、订阅用量与 OpenCode Zen 余额查询收进同一插件，减少单独装「订阅用量」类 bundle 的重复。
这是什么¶
dsh-opencode-live-models 是一个 DSH 插件 bundle，当前版本 0.11.3（MIT 许可证）。它面向已在 DSH 里使用 pi-ai 与 OpenCode / Codex 路线的开发者，解决「内置目录滞后」和「模型选择与账号侧信息分散」两类问题。
插件要求 DSH 0.1.5-rc.1 或更新，且插件自身需 0.3.0 或更新（0.3.0 起不再内置模型描述符；无网络首次启动时，相比旧版会少列出一个仅依赖 bundled 描述的模型 space-bunny-free，详见仓库 README 的 How it works）。
核心功能¶
实时模型目录¶
- OpenCode Go（
opencode-go）与 OpenCode Zen（opencode）各自从 Pi catalog 与 live roster 刷新，协议表独立；一条网关故障不会影响另一条目录。 - 原生 OpenAI Codex（
openai-codex）同样走目录更新与校验、ETag、缓存与生命周期机制；Codex 仍使用原生 OAuth 与传输，不会注入 OpenCode 头或覆盖 cache 选项。 - 与 DSH 原生 Settings → Models → Fetch available models 及已保存模型选择集成；支持 API Key 与 OAuth 路线。0.11.x 起在 live 描述符补全缺失 API 时会同步更新运行时诊断与 Models 设置中的错误展示。
登录与订阅 / 余额（只读）¶
- 在侧边栏 Plugins → dsh-opencode-live-models 详情页：Sign in with ChatGPT、重新登录、授权状态、回调粘贴兜底与取消。
- 同一详情页可 登录 OpenCode Console（设备授权，文档化流程仅使用
https://opencode.ai/console/auth/device/*）；Zen 计费优先 Console 工作区登录，无 Console 授权时才回退 API Key，过期授权不会静默换 key 或工作区。 - Settings → Account & balance：在官方 DeepSeek 余额下方展示已配置凭据的订阅信息（最多三个 provider、不重复 DeepSeek 卡片）。OpenAI 与 OpenCode Go 以百分比卡片优先展示；OpenCode Zen 以全宽货币余额行放在底部。进入页面加载，可点 Refresh usage；显示剩余配额百分比与重置时间，不把配额换算成金额。结果本地缓存，完全退出 DSH（如 Command+Q）后仍可在下次启动先看到上次数据再在后台校验凭据。
从独立插件 dsh-subscription-usage 升级时，应先禁用旧 bundle 再启用本插件，避免重复服务；已有 llm-pi-ai/openai-codex 与 subscriptionUsage 相关凭据可继续使用。
安装与启用¶
安装 spec 从 codeload.github.com 经 HTTPS 下载，主机需能访问 GitHub（npm 镜像不代理该 spec）。
桌面端：侧边栏打开 Plugins，Add plugin，粘贴 spec，选择 Enable now 并重启 DSH：
github:Luca4Don3/dsh-opencode-live-models
CLI：add 会安装并选中 bundle，需重启 DSH 以完成 compose：
dsh plugin --profile desktop add github:Luca4Don3/dsh-opencode-live-models
典型用法¶
1. 刷新并选择模型¶
- 确认 DSH 中已配置相应 provider（Codex 需在
llm-pi-aiproviders 里已有openai-codex）。 - 打开 Settings → Models，使用 Fetch available models，按需勾选模型并保存；取消勾选后需应用选择并保存才能从目录中移除条目（0.11.2 起修复「仅增不减」的问题）。
- Go 路线使用既有凭据引用
OPENCODE_GO_API_KEY；Zen 使用OPENCODE_API_KEY。OAuth 与 token 刷新由宿主处理，插件不自行实现 OAuth 或另存一套凭据。
2. ChatGPT 与 Console 登录¶
- Plugins → dsh-opencode-live-models 详情页完成 ChatGPT 或 OpenCode Console 登录。
- Console 登录后在设备授权页选择与你的 Zen key 对应的工作区。
- 到 Settings → Account & balance 查看或 Refresh usage；Zen 余额依赖 Console 或 API Key 策略如上。
3. 可选配置¶
在 opencode-live-models 插件条目下可写：
config:
freshMs: 300000
timeoutMs: 15000
goApiKeyRef: OPENCODE_GO_API_KEY
zenApiKeyRef: OPENCODE_API_KEY
freshMs 默认五分钟，控制同一次运行内用量卡片的新鲜度；Refresh usage 会强制重新查询。
适用场景与注意¶
适合：在 DSH 里长期用 OpenCode Go、OpenCode Zen 或 Codex，希望模型列表与上游一致，并在同一处查看 ChatGPT / Go 订阅用量与 Zen 余额的开发者。
注意：
- 插件在 当前 DSH 进程权限 下运行；安装前应在 GitHub 阅读源码与 MIT 许可证，自行评估信任边界。
- 禁用插件会取消进行中的设备授权与计费请求；卸载时会中止进行中的目录请求（0.6.0 起）。
- 社区目录 SkillHub 插件页 与 GitHub 仓库 为独立信息源，与 DeepSeek / 幻方无官方从属关系；DSH 生态遵循「一切皆插件」思路，以仓库 README 与版本说明为准。
结尾¶
dsh-opencode-live-models 把 OpenCode Go、OpenCode Zen 与 Codex 的 live 模型目录、原生模型选择，以及 ChatGPT / Console 登录与只读用量展示合并到一个 bundle，减少等 pi-ai 内置目录更新的空窗。需要安装 spec、变更日志与细节时，请直接查阅 GitHub README 与 SkillHub 目录页。
