前言¶
在 DeepSeek Harness 里用 OpenCode Go 或 Console 按量时，额度窗口、花费和 token 往往分散在多个接口或网页控制台里。要自己对照滚动 / 周 / 月窗口、算本周花了多少、猜月底会不会撞线，既费时间也容易漏看。下面介绍的 OpenCode 用量面板（dsh-opencode-usage-dashboard）是社区维护的 DSH 客户端插件：把 OpenCode 官方数据收进侧栏一张卡片，用量、额度、预测、趋势和模型分布在一处展示，并支持多账户切换、服务账号筛选与中英双语界面。
这是什么¶
- 名称：
dsh-opencode-usage-dashboard（npm 包名同插件 id） - 维护者：zhxmt-xm
- 分类：客户端（侧栏 UI）
- 许可证：MIT
- 兼容：DeepSeek Harness Desktop 0.2.x（README 注明开发环境为
0.2.1-rc.5；Web profile 同理） - 数据来源：OpenCode 官方接口（README 标明为第三方插件，非 DSH 内置）
插件在侧栏「设置」按钮上方插入卡片；侧栏收起时退化为一个小方块（百分比或金额）。Key 仍在 DSH 的 provider 设置里配置（设置 → Providers，llm-pi-ai），用量面板的设置页对 Key 只读。
核心功能¶
侧栏卡片的五个分块¶
分块是否出现由接口返回的数据决定，不是单靠开关伪装（见下文「账户形态」）。默认侧栏只开「用量」和「额度重置时间」，其余在 设置 → OpenCode 套餐 里打开；顺序、收起、限高均可配置。
- 用量：今日花费、请求数、tokens；有月度额度时顶部油表显示本月剩余百分比；并排汇总今日、本周、本月。
- 额度：滚动 5 小时、本周、本月三个窗口，进度条四档变色，带重置倒计时；无 Go 订阅时整块隐藏。
- 预测：按当前计费周期花费速度线性外推，标出 50% / 100% 预计日期；无月度额度或有效数据不足两点时隐藏。
- 趋势：7 天 / 24 小时，花费 / tokens / 请求数可切换；无数据时显示空态。
- 模型：按花费排序的条形图，最多四行；无按模型计费记录时隐藏。
卡片还支持：分块标题旁箭头收成一行并显示关键摘要；右上角整卡收起为一行摘要；顶部拖拽条调整卡片限高；账户名入口切换组织与服务账号；手动刷新与可配置的自动刷新间隔。
多账户与 Console / Go¶
- 同一组织的 Key 合并成一张卡，不同组织分开；可切换「当前」账户，花费可按服务账号筛选。
- 仅有 Console 按量时：额度与预测隐藏，仍保留用量、趋势、模型。
- Go 与 Console 并存时合并展示，与「只有 Go 订阅」时分块一致。
插件用 GET /inference/go/v1/usage 的 200/404 判断是否存在 Go 订阅；provider id 只影响优先使用哪把 Key。完整规则见仓库 开发与原理 → 账户形态。
设置与偏好¶
设置 → OpenCode 套餐 含三个面板：
- 账户：按组织分组、切换账户、服务账号筛选、刷新间隔（30 秒 / 1 分钟 / 5 分钟 / 15 分钟）。
- 显示：左侧色条开关与颜色、卡片限高、进度条四档区间与颜色（可「恢复默认」为 0–50 绿、50–75 黄、75–90 橙、90–100 红）。
- 卡片展示：各分块在侧栏的开关与实时预览、拖拽排序；用量块可选「简化版本」仅保留今日一行布局。
界面跟随 DSH 主题，中英双语，README 写明无外部 CDN，偏好只存在本机。
安装与启用¶
环境¶
- DeepSeek Harness 0.2.x。
- 具备 OpenCode Go 订阅，或仅有 Console 用量的 OpenCode 账户。
- 本机可访问
opencode.ai。
从 DSH 插件市场安装（推荐）¶
- 打开 DSH → 设置 → 插件（或插件市场）。
- 搜索
dsh-opencode-usage-dashboard，或搜「OpenCode 额度」。 - 点击 安装；装完侧栏应出现卡片。
市场版本跟随 npm 发布；README 说明 1.2.0 及之后的功能（分块收起、统一提示气泡等）需要市场版本 ≥ 1.2.0。资料中 npm 包当前版本为 1.2.1。
重要：插件在 host 侧注册了 /api/opencode-quota/* 路由，属于 host 模块，无法热替换。首次安装或升级后请点「重启」，不要只「刷新页面」——刷新可能报 import failed，重启即可。
从 GitHub 安装¶
Desktop profile：
dsh plugin --profile desktop add github:zhxmt-xm/dsh-opencode-usage-dashboard
Web profile：
dsh plugin --profile web add github:zhxmt-xm/dsh-opencode-usage-dashboard
github: 源需本机能连 github.com:443 的 git 协议。若连不上，可改用 npm，或使用带 tag 的 codeload tarball，例如：
dsh plugin --profile web add https://codeload.github.com/zhxmt-xm/dsh-opencode-usage-dashboard/tar.gz/refs/tags/v1.2.1
从 npm 安装¶
dsh plugin --profile desktop add dsh-opencode-usage-dashboard
从旧包名迁移¶
2026-10-30 之前包名为 @local/dsh-opencode-quota（0.1.0），与现包不是同一个包。升级须先卸载再安装，否则两份并存、侧栏仍是旧卡片：
dsh plugin --profile web remove @local/dsh-opencode-quota
dsh plugin --profile web add dsh-opencode-usage-dashboard
装完同样建议 重启 DSH。
典型用法¶
经过上面的安装并重启后，日常可以按下面顺序使用（均来自 README 描述的界面行为）：
- 在 DSH 设置 → Providers 配置 OpenCode 相关 Key（
llm-pi-ai）。 - 展开侧栏卡片，点顶部 账户名 在组织与服务账号之间切换；需要即时数据时点 刷新。
- 在 设置 → OpenCode 套餐 → 账户 调整自动刷新间隔。
- 在 卡片展示 面板打开「趋势」「模型」「预测」等分块，拖拽排序；若侧栏较窄，可对单个分块点标题旁箭头收成一行。
- 有 Go 订阅时查看 额度 三窗口与 预测 曲线；仅 Console 时重点看 用量、趋势 与 模型。
趋势图的 7 天 / 24 小时与指标切换在「卡片展示」右侧预览里直接点，无单独「趋势图」设置页。
适用场景与注意¶
适合谁：长期在 DSH 里调用 OpenCode、需要随时对照额度窗口与花费、或管理多组织 / 多 Key 的开发者。
使用前请知悉：
- 插件以 当前 DSH 进程的权限 运行，会向 OpenCode 官方端点拉取用量数据；安装前建议自行查看 GitHub 源码 与 MIT 许可证。
- DSH 社区插件目录（如 SkillHub 插件页）为独立生态站点，与 DeepSeek / 幻方无官方从属关系；「一切皆插件」是 DSH 的产品思路，本面板属于其中的第三方客户端扩展。
- 数据准确性取决于 OpenCode 接口与账户形态；无 Go 订阅时不要期望看到额度 / 预测分块。
结尾¶
OpenCode 用量面板把 Go 订阅额度、Console 花费、趋势与月度预测收进 DSH 侧栏，减少反复打开网页控制台或手算窗口重置时间。安装优先走 DSH 插件市场或上述官方命令，装完记得重启进程。
