FengYangXun123/dsh-opencode-usage

README excerpt

dsh-opencode-usage DSH Web GUI 插件： 订阅用量 / 余额监控 （多 provider，当前支持 opencode-go 用量 + deepseek 余额）。两个表面共享同一份数据： - 侧边栏底部徽标 （ sidebar.footer.action ，设置入口上方，全局常驻——首页/空态也可见）：显示主 provider（首个 usage 型） 5h 0% 周 87% 月 46% ，主 provider 为余额型时显示 DS CNY 110.00 ；侧边栏折叠时退化为小圆点，任一 provider 异常变红+红点； - 全局详情卡 （ shell.overlay ，点击徽标在左侧弹出，徽标正上方）：每个 provider 独立区块（用量三格/余额卡、重置倒计时、趋势、告警）+ 分 provider 的 API Key 配置；Esc 或点遮罩关闭。 用于在额度被他人盗刷/余额异常消耗时第一时间发现异常， 不遮挡会话内容 。 数据来源 provider 类型 接口 opencode-go usage（5h/周/月） GET https://opencode.ai/zen/go/v1/usage （官方未公开文档化接口，cc-switch 6433 发现） deepseek balance GET https://api.deepseek.com/user/balance 安装 Profile Bundle（推荐） ——路径用 Windows 正斜杠： 验证安装 ： 运行验证 （agent 端到端）： dsh run "查一下 opencode 用量" （agent 会调用 opencode usage 工具）。 然后 重启 dsh web （Ctrl+C 后重新运行），侧边栏底部（设置入口上方）出现用量徽标。 配置 API Key（分 provider，环境变量优先——key 不落盘） - opencode-go ：环境变量 OPENCODE API KEY /.local/share/opencode/auth.json （ opencode /connect 登录） 面板手动配置； - deepseek ：环境变量 DEEPSEEK API KEY 面板手动配置。 手动 Key 明文存 /.dsh/dsh-opencode-usage.json （权限 0600；Key 不经模型上下文，浏览器直连本机接口）——仅作兜底，推荐用环境变量。 能力与限制 - opencode-go：官方用量统计（5h 滚动 / 周 / 月百分比 + 重置时间），写入本地历史（ /.dsh/dsh-opencode-usage-history.json ，0600），默认每 5 分钟采样一次；deepseek：余额快照（不写历史）； - 页面 60 …

Category