dsh-opencode-go-meter
DeepSeek Harness（dsh）Web 界面插件：在对话输入区直接显示 OpenCode Go 订阅用量（5h 滚动 / 每周 / 每月）与真实花费金额（美元），并在弹窗内完成登录与凭据配置——无需接触终端、无需改代码。
OpenCode Go · 5h 滚动 9% · 每周 12% · 每月 6% · $1.23
✨ 特性
- 三个用量窗口 —— 5h 滚动 / 每周 / 每月 的百分比与重置倒计时，按阈值变色（≥80% 黄、≥90% / 限流红）。
- 真实花费 —— 月度合计美元金额（官方聚合接口，精确），弹窗内可展开按天费用明细柱状图。
- 双数据源自动回退 —— 官方配额 API（Bearer key）优先，失败自动回退仪表盘 SSR（auth cookie）。
- 凭据安全 —— API key / cookie 只在 Host 侧进程使用，浏览器只读取同源 JSON 端点。
- 开箱即用 —— 无配置时显示 ``，点「Go 用量」弹窗自动展开登录表单，1 分钟完成配置。
- 轻量 —— 前端 30s 轮询；host 60s 缓存 + 60s 失败冷却；单飞去重。
📦 安装
> 环境要求：DeepSeek Harness（web profile）0.1.0-rc.6+；PATH 上有 pnpm（dsh plugin 依赖）。
方式一：npm（已发布，最快）
dsh plugin --profile web add dsh-opencode-go-meter
方式二：GitHub（源码跟进 / 检查更新）
dsh plugin --profile web add github:willwhi/dsh-opencode-go-meter
方式三：tarball（离线安装 / 分发）
# 拿到 .tgz 后：
dsh plugin --profile web add ./dsh-opencode-go-meter-0.1.2.tgz
方式四：本地 link（开发调试）
git clone https://github.com/willwhi/dsh-opencode-go-meter.git
cd dsh-opencode-go-meter
dsh plugin --profile web add "link:$(pwd)" # Windows PowerShell: link:绝对路径
验证安装（任选）
dsh --profile web --dump-config # 输出应出现 "# == dsh-opencode-go-meter" 层
生效
重启 dsh web（结束当前进程 → 重新启动），浏览器强制刷新（Ctrl+Shift+R）。
成功标志：对话输入框下方出现 OpenCode Go · … 一行，输入框内出现「Go 用量」按钮。
⚙️ 首次配置（约 1 分钟，纯界面操作）
- 浏览器打开 opencode.ai 并登录 → 工作区 → API Keys → 复制 Go API key（
sk-opencode-…）。 - 回到 dsh，点输入框内「Go 用量」→ 弹窗自动展开登录表单。
- 在 ① API Key 粘贴 key → 保存并验证 → 用量立即出现。
- （可选，推荐）② 仪表盘凭据：F12 → Application → Cookies 复制
auth值 + 页面 URL 里的wrk_…→ 保存仪表盘凭据 → 出现月度费用与按天明细。
> 若本机已用过 opencode CLI（opencode auth login），API key 已被自动读取，步骤 1–3 可跳过。
配置方式对比
| 方式 | 内容 | 说明 |
|---|---|---|
| 弹窗登录表单（推荐） | API key / cookie+workspaceID | 最快，无需碰文件；凭据仅写本机 |
| 配置文件 | ~/.dsh/opencode-go-meter.json |
{ "cookie": "auth=…", "workspaceID": "wrk_…" }（可含 apiKey/baseUrl/timeoutMs） |
| 复用 opencode CLI | ~/.local/share/opencode/auth.json |
自动读取 opencode-go 条目的 key（回退 opencode） |
取值优先级 —— API key：opencode-go-meter.json 的 apiKey > auth.json；cookie/workspaceID：仅 opencode-go-meter.json。
> 完整配置细节、FAQ 与排查：见 docs/使用指南.md。
🖥️ 使用
- 摘要行（输入框下方）：三窗口百分比 + 本月花费，颜色随健康度变化。
- 详情弹窗（「Go 用量」按钮）：每窗口百分比进度条 + 重置倒计时 + 已花费；「按天费用明细」柱状图（最近 10 天）。
- 手动刷新：弹窗右下角「刷新」。
- 改配置：弹窗「登录」随时更新 key / cookie / workspaceID。
🔄 更新插件
- npm / GitHub 安装：重新执行安装命令即可拉取最新版本，然后重启
dsh web。 - link 开发安装：
git pull拉取最新代码，然后重启dsh web。
🗑️ 卸载
dsh plugin --profile web remove dsh-opencode-go-meter
重启并刷新后界面恢复原样。卸载不会删除 ~/.dsh/opencode-go-meter.json 与 auth.json。
🔧 工作原理（简述）
- Host 半（
index.js）：所有抓取/解析/缓存都在 host 进程；向conversation.composer.dock/conversation.input.left对应的同源 JSON 端点（/api/opencode-go-meter*）提供数据；凭据永不进浏览器。 - 浏览器半（
client.js）：注册 dock 摘要行与「Go 用量」按钮，弹窗展示明细与登录表单；30s 轮询 + 1s 倒计时。 - 数据源：官方配额 API → 仪表盘 SSR（用量窗口）；仪表盘请求记录 → 官方聚合 RPC（月度费用，按天/按模型）。
🔒 安全说明
authcookie 是完整 OpenCode 用户会话：插件只在 host 侧使用，绝不发送给浏览器、不写日志、不进错误信息。- 建议为本机配置文件收紧权限（Unix：
chmod 600 ~/.dsh/opencode-go-meter.json）。 - 零遥测、无第三方依赖（仅 dsh 自带运行时）。
📚 文档
- docs/功能介绍.md —— 功能细节、数据来源、阈值与缓存策略、与同类插件对比。
- docs/使用指南.md —— 安装、首次配置分步、配置方式对比、更新、FAQ、卸载、排查。
📄 License
MIT
