OpenCode Go 用量
Xenia0922/dsh-opencode-go-usage is a DeepSeek Harness ecosystem project for tools and capabilities. Review its public README for features, setup, and usage details.
これは DeepSeek Harness（DSH）プラグインです。当サイトは GitHub README、インストール情報、メンテナンス状況、公開セキュリティシグナルをまとめています。
📊 OpenCode Go 用量面板
DeepSeek Harness 插件 — 可拖拽缩放的悬浮仪表盘,实时展示 OpenCode Go 配额、逐请求用量与花费
数据完全本机获取 · API key 不出本机、不进日志 · 官方限额实时监控
✨ 功能一览
| 能力 | 说明 | |
|---|---|---|
| 🖱️ | 悬浮 FAB | 右下角胶囊,可拖动,实时显示累计金额 + 滚动配额 %(配额 ≥70% 变黄、≥90% 变红) |
| 🪟 | 窗口控制 | 拖标题栏移动、拖边缘/右下角缩放、双击/按钮最大化、淡入动画、位置/大小持久化 |
| 📅 | 今日/本月/累计 | 花费 + 请求数 + token 明细(输入/输出/cache 读) |
| 🏛️ | 官方账户级视图 | 主数据源:直接调官网 usage.list API,逐请求官方计费(与官网账单一致,跨设备);凭据自动提取(调试端口 CDP,一键启动),零配置 |
| 📊 | DSH 会话分析 | 保留会话级视角:估算 + 官方逐请求精确回填(实测匹配率 83%,金额修正 3.3×) |
| 🍩 | 配额环形图 | 滚动(5 小时)/ 周 / 月官方配额百分比 + 重置倒计时(如 3h 45m 后重置) |
| 🔮 | Pace 期末预测 | 按烧速外推窗口期末用量(预计 X%),超速时红色提示预计耗尽时间(窗口刚重置时不误报) |
| 📈 | 按模型排行 | 花费降序 + 条状图,点击展开费用分项与来源构成 |
| 📊 | 花费趋势 | 7 / 14 / 30 天柱状图 |
| 🕒 | 最近会话 | 真实标题 + 花费 |
| ⚠️ | 配额告警条 | 任一窗口 ≥90% 时面板顶部醒目提示(FAB 同步变色) |
| ⬇️ | CSV 导出 | 标题栏一键导出当前视图(统计/配额/按模型/最近会话) |
| 🌐 | 中英切换 | 面板标题栏一键切换(EN/中),记忆选择;未手动选择时跟随 DSH 全局语言 |
| 🔄 | 自动刷新 | 面板打开时 60s 定时 + 即时刷新;关闭时零后台轮询;45s Host 缓存 |
📸 界面预览
上图为按真实界面绘制的示意图(DSH 视图)。将实际截图保存为
docs/screenshot.png即可替换预览(该文件已被.gitignore排除,不会入库)。
📋 官方限额与定价(2026-08)
OpenCode Go 的限额与定价来自 opencode.ai/docs/go,面板的配额百分比与 DSH 估算均以此为基准:
| 窗口 | 限额 | 换算示例 |
|---|---|---|
| 5 小时(滚动) | $12 用量 | 10% ≈ $1.20 |
| 每周 | $30 用量 | 16% ≈ $4.80 |
| 每月 | $60 用量 | 8% ≈ $4.80 |
模型定价(per 1M tokens,部分常用模型):
| 模型 | 输入 | 输出 | Cache 读 | Cache 写 |
|---|---|---|---|---|
| DeepSeek V4 Flash | $0.14 | $0.28 | $0.031(实测) | — |
| DeepSeek V4 Pro | $0.435 | $0.87 | $0.003625 | — |
| GPT 5.6 Luna | $0.20 | $1.20 | $0.02 | $0.25 |
| GLM-5.2 | $1.40 | $4.40 | $0.26 | — |
| Kimi K3 | $3.00 | $15.00 | $0.30 | — |
| MiniMax M3 | $0.30 | $1.20 | $0.06 | — |
…(共 26 个模型,详见源码 PRICING 表) |
🗄️ 数据来源与口径
┌──────────────────────────────────────────────────────────┐
│ 官方用量明细 opencode.ai/_server usage.list │
│ (调试端口 CDP 自动 逐请求官方计费(账户级,跨设备,与官网 │
│ 提取,一键启动 / 账单逐模型吻合 ±2%)——面板主数据源 │
│ 手动粘贴兜底) │
├──────────────────────────────────────────────────────────┤
│ DSH 会话分析 sessionQuery 事件(仅 opencode-go) │
│ (估算 + 官方回填) cache 增量法估算;再与 usage.list 逐 │
│ 请求按 模型+时间+token 匹配,匹配到的 │
│ 行用官方 cost 精确回填(实测匹配率 83%) │
├──────────────────────────────────────────────────────────┤
│ 官方配额接口 opencode.ai/zen/go/v1/usage │
│ (curl native TLS) 滚动/周/月配额百分比 + 重置时间 │
│ (auth.json key, 不需要 cookie,官方明细不可用时也正常 │
│ 始终可用) 显示配额百分比) │
└──────────────────────────────────────────────────────────┘
- 面板主数据源为官方
usage.list(账户级逐请求官方计费,与官网账单一致、跨设备、不受本地数据丢失影响);DSH视图保留会话级分析 - DSH 金额精度:先用官方定价估算(cache 按会话增量 × 实测单价 $0.031/M),再与官方逐请求记录按(模型 + ±60s + token ±30%)匹配,匹配到的记录直接用官方 cost(实测匹配率 83%,金额从估算 $2.57 修正为官方 $8.44);未匹配的保持估算(如 8-14 数据目录迁移前的丢失会话)
- 来源口径:DSH 分析只统计
source.provider == 'opencode-go';deepseek 直连、opencode 免费模型等非 Go key 流量不计入 - 对账:官方视图 foot 显示
官方月估算 vs 明细合计(quota monthly% × $60 vs usage.list 本月)
🚀 安装
方式 A:会话内动态加载(快速体验,免构建)
- 打开 DSH 会话,让 Agent 执行
cordis_define(kind: new, idPrefix:zenus) - 将
src/host.js内容粘贴为code.host,将src/client.js内容粘贴为code.client cordis_run授权后,右下角出现 FAB 胶囊
⚠️ 动态定义只活在当前进程,DSH 重启后丢失;想长期使用请用方式 B。
方式 B:Bundle 插件(推荐,随 DSH 启动自动加载)
host 半区注册本地 HTTP 路由(
webServer→/ocgo-usage/fetch),客户端同源fetch取数——bundle 形态功能完整,且随 DSH 启动自动加载,无需每次会话重建。 动态方式(方式 A)仍走harness.handle/host.call私有 RPC,两种形态共用同一套聚合逻辑。
git clone https://github.com/Xenia0922/dsh-opencode-go-usage.git
cd dsh-opencode-go-usage
# 从父目录安装进 profile 并启动
dsh plugin --profile my-profile add ./dsh-opencode-go-usage
dsh --profile my-profile
💡 插件目录路径含空格时
dsh plugin add会解析失败(如D:\Opencode view\...): 先把目录放到无空格路径(如 junction 链接到C:\Users\<你>\dsh-plugin-src\...), 再cd到 profile 目录用pnpm add link:<无空格路径>安装。
dsh plugin add 会执行 pnpm add 并把声明了 dsh.bundle 的包写进
dsh.profile.bundles;bundle 的 cordis.patch.yml 随后插入插件行
(inject: ['webServer'] 等待服务就绪),host 聚合路由与客户端 UI 随 DSH
启动自动注册。若 dsh CLI 不可用,可手动等价操作(见下方 FAQ)。
package.json 已声明官方 bundle 字段(dsh.bundle.patch -> cordis.patch.yml);构建产物由 npm run build 生成(host ESM + 浏览器注册形态 bundle)。
方式 C:把链接丢给 AI 装(最省事)
把下面这句话复制给任意 AI(DSH 会话里的),它自己会 clone、安装并告诉你重启:
帮我安装 https://github.com/Xenia0922/dsh-opencode-go-usage 这个 DSH 插件:按仓库 README 的方式 B 装进我的 DSH profile(数据目录以 DSH_HOME 环境变量为准),装完告诉我需要重启 DSH
AI 会读本 README,自己完成 clone、pnpm add link:、写 dsh.profile.bundles 等步骤——你只需要等它说"重启吧"。
🕹️ 使用
| 操作 | 效果 |
|---|---|
| 点击胶囊 | 打开面板(从胶囊位置展开) |
| 拖动胶囊 | 移动入口位置 |
| 拖标题栏 / 双击 | 移动 / 最大化还原 |
| 拖右缘 / 底缘 / 右下角 | 调整宽度 / 高度 / 整体缩放 |
| 视图切换 | 官方 / DSH |
| 点击 🌐 | 面板界面中/英切换(记忆选择,可随时切回) |
| 点击 ⬇ | 导出当前视图为 CSV(统计 / 配额 / 按模型 / 最近会话) |
| 点击模型行 | 展开费用分项(输入/输出/cache)与来源构成 |
| 刷新 | 标题栏按钮,或等 60s 自动刷新 |
📁 项目结构
dsh-opencode-go-usage/
├── src/ # 源码(动态插件函数体,含注释)
│ ├── host.js # Host 半区:聚合、缓存、python 数据管道(官方 usage.list/CDP 自动提取)
│ └── client.js # Client 半区:shell.overlay FAB + React 仪表盘
├── lib/ # 构建产物(勿手改)
│ ├── index.js # host ESM 入口(注入 node:fs 供凭据保存)
│ └── client.js # 浏览器注册形态 bundle
├── scripts/
│ ├── build-lib.mjs # 构建 + 回归门禁(注册形态/harness 守卫断言)
│ ├── start-browser-debug.bat # 以调试端口 9222 启动独立 Edge(CDP 自动提取用)
│ └── verify-cdp.mjs # 端到端验证 CDP 提取(从 src/host.js 提取真实函数测试)
├── tests/
│ └── test.mjs # 10 个用例:聚合、口径过滤、静态降级、bundle 注册、i18n、官方源
├── cordis.patch.yml # bundle 补丁层(插入插件行,inject webServer)
├── package.json # dsh.bundle / dsh.client 声明
└── README.md
🏗️ 技术架构
┌─────────────┐ ① harness.handle / host.call(动态包) ┌─────────────┐
│ Client 半区 │ ─────────────────────────────────────▶ │ Host 半区 │
│ shell.overlay│ ② fetch('/ocgo-usage/fetch')(bundle) │ webServer │
│ React 仪表盘 │ ─────────────────────────────────────▶ │ 路由 + 聚合 │
└─────────────┘ JSON(纯数据,无 live 对象) └──────┬──────┘
│
┌──────────────┬───────────────┬───────────────┬──────────────┐
▼ ▼ ▼ ▼
sessionQuery python(自动提取) curl(官方配额) python(官方明细)
DSH 会话事件 CDP 调试端口 usage 百分比 usage.list
(token+增量) → auth cookie (auth.json key) (auth cookie)
- Host 半区:动态模式走
harness.handle私有 RPC;bundle 模式走webServer本地路由 (/ocgo-usage/fetch取数 +/ocgo-usage/config存凭据 +/ocgo-usage/launch-browser一键启动调试浏览器)。45s 本地聚合缓存,官方源自带 15 分钟缓存 + 磁盘缓存,失败各自降级互不影响 - 配额接口走 curl native TLS(代理兼容),key 在子进程内从
auth.json读取,不需要 cookie, 官方明细不可用时配额百分比照常显示;官方凭据通过调试端口 CDP 由浏览器自身解密(支持 v20), 均不进命令日志、不落盘 - 官方明细不可用时,官方视图自动降级显示 DSH 会话数据(配额环形图始终可用),不再整屏"拉取中"
- 构建回归门禁:
build-lib.mjs断言客户端注册形态、工厂require('react')、host 无裸harness引用
🛠️ 开发
npm run build # 构建 lib 产物 + 回归门禁
npm test # 10 个用例(node --test,零依赖)
npm run typecheck # src 语法校验
❓ 常见问题
为什么"累计"和官方配额百分比对不上?
本地"累计"是全部历史记录;官方百分比是 5 小时 / 周 / 月的窗口用量。金额对比请用面板"本月" vs monthly% × $60。
DSH 部分准确吗? DSH 会话事件没有官方 cost,先用官方定价估算(cache 按会话增量 × 实测单价);官方明细就绪后自动与 usage.list 逐请求匹配回填官方 cost(实测匹配率 83%)。DSH 视图 foot 会显示"官方回填 N 条"。想精确看账户级总额请用"官方"视图。
codex 流量算不算 Go 用量?
算。codex 的 config.toml 指向 opencode.ai/zen/go/v1(同一 Go key),其用量已在官网
usage.list 中按请求计费,官方视图与配额百分比天然包含;本地不再单独读 codex 会话(与官网重复)。
免费模型会被计入吗?
不会。*-free(OpenCode Zen 免费)以及 deepseek 直连等非 opencode-go 流量全部被过滤。
重启后插件不见了 / 加载不起来?
动态方式(方式 A)是进程内定义,重启即失(设计如此)。要随 DSH 自动加载请用
方式 B:在 profile 目录执行 pnpm add link:<插件目录>(或 dsh plugin --profile <名> add <目录>),
并把包名追加进 profile package.json 的 dsh.profile.bundles 列表(等价于 dsh plugin
的 reconcile 步骤),然后重启 DSH。重启后 host 路由与右下角 FAB 自动出现。
官方视图怎么配置?
面板"官方"视图直接调官网 usage.list 接口(账户级逐请求计费,与官网账单一致),凭据获取
全自动,只需手动做一次登录:
🚀 快速开始(首次只做这三步)
- 打开面板,官方视图提示"未找到调试浏览器"时,点击 "🚀 一键启动调试浏览器并登录"
(或双击运行
scripts/start-browser-debug.bat)——弹出一个独立 Edge 窗口,不影响日常浏览器 - 在该窗口里登录一次 opencode.ai
- 关闭该窗口,刷新面板
之后插件自动探测调试端口(9222–9230),由浏览器自身解密并交出 auth cookie,再解析
workspaceId 写入配置——之后每次启动直接复用,无需再操作。
提取方式(仅调试端口 CDP,别无分店)
- 通过浏览器调试协议读取 cookie,浏览器自身解密,支持任何加密版本(含新版 v20), 无需关闭日常浏览器、无需管理员权限、不触碰数据库文件
- 调试浏览器是独立 profile(
%USERPROFILE%\.ocgo-browser-debug),登录一次长期有效; 日常浏览器是否登录过 opencode.ai 都不影响 - 手动粘贴兜底:错误区仍可粘贴
authCookie和workspaceId并保存- cookie:浏览器 F12 → Application → Cookies → 复制
auth值 - workspaceId:打开
https://opencode.ai/workspace/<你的工作区>/usage,地址栏里的wrk_xxx
- cookie:浏览器 F12 → Application → Cookies → 复制
配置与重置
- 配置保存在
~/.config/dsh-opencode-go-usage.json:首次自动提取后生成,之后每次启动 直接复用,不重复抓取;cookie 失效时面板会自动提示 - 重抓(cookie 过期 / 换账号 / 想彻底重新提取):
- 删除
~/.config/dsh-opencode-go-usage.json(或先改名备份) - 面板点"🚀 一键启动调试浏览器并登录"(或运行
scripts/start-browser-debug.bat) - 在调试窗口登录一次 opencode.ai,然后关闭窗口
- 刷新面板 —— 插件自动重新提取并重新生成配置
- 删除
- 也可以随时在面板错误区手动粘贴
authCookie+workspaceId直接覆盖
为什么只用调试端口方式:新版 Edge/Chrome(v137+)cookie 使用 v20 应用绑定加密,普通用户 权限无法从数据库直读;而调试端口方式让浏览器自己解密,任何版本、任何浏览器都适用, 且不需要关闭任何正在运行的浏览器。注意调试端口开启期间本机其它程序可访问该窗口浏览 数据,用完请关闭该窗口。
凭据只在本机使用,不进日志、不发送任何第三方;15 分钟缓存,失败自动降级不影响本地视图。
🔒 隐私
- API key 只在本机由子进程从
~/.local/share/opencode/auth.json读取 - 官方凭据(auth cookie)仅本机提取使用(调试端口 CDP,浏览器自身解密),不进日志、不落盘外传
- 网络请求只发往官网(opencode.ai 配额接口 + usage.list 明细接口),不向任何第三方发送数据
- 不写入、不修改任何数据库(全部
mode=ro只读;调试端口方式由浏览器自身返回 cookie,不触碰数据库文件)
📝 变更日志
见 CHANGELOG.md。
License
セキュリティとインストールエビデンス
このスコアは公開リポジトリメタデータと当サイトに登録されたインストールエビデンスのみに基づくもので、コードセキュリティ監査とは異なります。
公開プラグインカタログから取得し、公開 GitHub リポジトリにリンクしています。
リポジトリは MIT ライセンスを宣言しています。
過去180日以内にコードの更新があります。
再現可能な正確なインストールメタデータはまだ登録されていません。リポジトリの説明に従って手動で確認してください。
確認したパッケージメタデータにインストールライフサイクルスクリプトは宣言されていません。