dsh-opencode-go-usage DSH 插件

一个 DSH 插件，提供可拖拽缩放的悬浮面板，展示 OpenCode Go 配额、逐请求用量和花费。数据来自官方 OpenCode API 和 DSH 会话分析，通过 CDP 自动提取 cookie。

如何安装 dsh-opencode-go-usage DSH 插件

dsh plugin --profile my-profile add ./dsh-opencode-go-usage

复制不会执行命令。安装 dsh-opencode-go-usage DSH 插件前请核对仓库和版本。

dsh-opencode-go-usage DSH 插件数据来源

dsh-opencode-go-usage DSH 插件快照日期：2026年8月16日

discovered

dsh-opencode-go-usage DSH 插件能做什么

悬浮 FAB 胶囊，显示累计金额和滚动配额百分比，≥70% 变黄，≥90% 变红
窗口控制：拖标题栏移动、拖边缘/右下角缩放、双击最大化、位置大小持久化
官方账户级视图：直接调用 usage.list API，通过 CDP 自动提取 cookie，无需手动配置
DSH 会话分析视图：官方定价估算，并与 usage.list 按请求精确回填（匹配率 83%）
多 key 配额池：自动发现 .credentials.yaml 中的 OPENCODE_GO_KEY_*，用 ★ 标记当前生效 key，⚠️ 标记已限流 key
按模型排行条状图、花费趋势（7/14/30 天）、最近会话列表含真实标题
配额告警条：任一窗口 ≥90% 时面板顶部醒目提示
中英文切换（记忆选择，未选择时跟随 DSH 语言）、CSV 导出当前视图统计

dsh-opencode-go-usage DSH 插件适合哪些场景

实时监控 OpenCode Go 的花费和配额使用情况，支持多 key 池
分析逐请求的官方计费明细，与官网账单一致
追踪 DSH 会话中的 OpenCode Go 请求花费，并与官方记录对账
导出用量数据为 CSV 文件，用于开销报告或预算规划
快速发现配额即将耗尽，获取预计耗尽时间

dsh-opencode-go-usage DSH 插件适合谁

使用 OpenCode Go 的开发者，希望跟踪 API 用量和花费
DSH 用户，需要一个可视化面板来监控 OpenCode Go 活动
管理多个 OpenCode Go API key 和配额的运维人员

dsh-opencode-go-usage DSH 插件的限制

数据依赖 OpenCode 官方 API（usage.list 和配额接口）；离线或 API 故障时显示“加载中”
需要手动通过 CDP 调试浏览器登录 opencode.ai 一次以提取 cookie；cookie 可能过期需刷新
动态加载方式（方式 A）在 DSH 重启后丢失；只有 bundle 方式（方式 B）能持久化
插件目录路径含空格会导致 dsh plugin add 安装失败（如 D:\Opencode view\...）
数据刷新间隔为 60 秒自动刷新；官方视图的磁盘缓存仅作为增量基准，不是即时数据
DSH 视图的金额部分为估算（cache 增量），与官方记录匹配率仅 83%
usage.list 抓取页数上限为 5000 页（约 25 万条），可通过 maxPages 配置覆盖，但可能截断

dsh-opencode-go-usage DSH 插件的仓库 README 摘录

以下文字摘自 dsh-opencode-go-usage DSH 插件的上游仓库 Xenia0922/dsh-opencode-go-usage 的 README，版权归原作者，仅作引用。

> 由 Xenia0922 维护。数据完全本机获取,API key 不出本机、不进日志。 ## 特性 - **悬浮 FAB**:右下角胶囊,可拖动,实时显示累计金额 + 滚动配额 %(≥70% 变黄、≥90% 变红);**面板开/关都 60s 自动刷新**;位置越界自动重置 - **窗口控制**:拖标题栏移动、拖边缘/右下角缩放、双击/按钮最大化、位置/大小持久化 - **官方账户级视图(主数据源)**:直接调官网 `usage.list`,逐请求官方计费(与官网账单一致、跨设备);凭据**自动提取**(调试端口 CDP,一键启动),零配置 - **DSH 会话分析**:会话级视角,官方定价估算 + 与 `usage.list` 逐请求**精确回填**(实测匹配率 83%) - **配额环形图**:滚动(5h)/ 周 / 月配额 % + 重置倒计时;**多 key 池支持**(自动发现 `.credentials.yaml` 的 `OPENCODE_GO_KEY_*`,key 切换标签 ★ 当前生效,⚠ 已限流状态红色徽标);**明细不可用时也始终显示**;超速时红色提示预计耗尽时间 - **按模型排行 / 花费趋势 / 最近会话**:花费降序条状图 + 费用分项展开、7/14/30 天柱状图、真实会话标题 - **配额告警条**:任一窗口 ≥90% 面板顶部醒目提示 - **中英切换 / CSV 导出**:面板标题栏一键切换(记忆选择,未选择时跟随 DSH 语言)、导出当前视图统计 ## 界面预览 <img src="docs/screenshot.svg" alt="OpenCode Go 用量面板界面预览" width="640"> > 上图为按真实界面风格绘制的示意图(默认官方视图)。将实际截图保存为 `docs/screenshot.png` 即可替换预览(该文件已被 `.gitignore` 排除,不会入库)。 ## 安装 ### 方式 A:会话内动态加载(快速体验,免构建) 1. 打开 DSH 会话,让 Agent 执行 `cordis_define`(kind: new, idPrefix: `zenus`) 2. 将 [`src/host.js`](src/host.js) 内容粘贴为 `code.host`,将 [`src/client.js`](src/client.js) 内容粘贴为 `code.client` 3. `cordis_run` 授权后,右下角出现 FAB 胶囊 > ⚠️ 动态定义只活在当前进程,**DSH 重启后丢失**;想长期使用请用方式 B。 ### 方式 B:Bundle 插件(推荐,随 DSH 启动自动加载) ```sh git clone https://github.com/Xenia

阅读完整 README仓库许可: MIT

dsh-opencode-go-usage DSH 插件常见问题

如何安装 OpenCode Go 用量面板插件？

推荐使用方法 B：克隆仓库，进入目录后运行 'dsh plugin --profile my-profile add ./dsh-opencode-go-usage'，然后使用该 profile 启动 DSH。也可以使用方法 A（通过 cordis_define 动态加载 src/host.js 和 src/client.js），但重启后会丢失。

需要手动配置 API key 或 cookie 吗？

对于官方视图，插件通过 CDP（调试端口）在您登录一次后自动提取 auth cookie。配额池会自动从 .credentials.yaml 中发现 OPENCODE_GO_KEY_* 条目。无需手动配置，除非您想覆盖 key 名称或最大页数。

为什么累计金额和官方配额百分比对不上？

累计金额是所有历史请求的美元总成本。官方百分比是基于滚动 5 小时/周/月的用量单位窗口（部分模型限时 2×）。两者计量基准不同，不可直接对比。请使用面板的“本月”与官方窗口换算作为参考。

codex 的流量算不算 Go 用量？

算。codex 的 config.toml 指向 opencode.ai/zen/go/v1（同一 Go key），其用量已包含在官方 usage.list 中。官方视图和配额百分比天然包含 codex 流量。

重启 DSH 后插件不见了怎么办？

如果您使用了方法 A（通过 cordis_define 动态加载），它设计为仅会话内有效，重启即丢失。要持久化，请使用方法 B：通过 'dsh plugin add' 添加插件，并确保它位于 profile 的 bundles 中，然后重启 DSH。