moduqishi/dsh-opencode-usage ↗★ 1

@local/dsh-opencode-usage

Persistent opencode.ai usage widget: header progress + settings page + webServer API routes. 适合需监控 opencode.ai 各窗口额度用量的用户,需配置凭据与渠道。

Package
@local/dsh-opencode-usage
Compatibility
Unverified
Version
0.2.6
License
MIT
Last updated
Aug 13, 2026

Install

This plugin has no verified bundle, or compatibility checks failed. Read the repository notes first. Read the full README ↗

dsh-opencode-usage

DeepSeek Harness(dsh web)持久化插件:在聊天窗口顶部标题行显示 opencode.ai 额度用量进度(5 小时 / 本周 / 本月),毛玻璃详情面板,实时重置倒计时,支持按模型渠道(Provider)过滤显示。

功能

  • 标题行进度组件:三个迷你进度条 + 百分比(5h / 7d / 30d),颜色随用量变化(85% 红),跟随主题配色
  • 输入框同心圆(可选,默认开启):在输入框工具行右侧(模型名左侧)显示三层同心圆——最内层月、中间层周、最外层 5 小时额度,最大圈与上下文圈等大(14px);圆环按真实百分比绘制(0% 不画弧、100% 无端帽凸起、低百分比保持比例);点击弹出与上下文圆环同款样式的详情弹窗:5h / 周 / 月 三行,每行一条等长绝对值进度条 + 百分比 + 重置时间
  • 毛玻璃详情面板:点击标题行组件展开,每个窗口一行进度条,始终显示全部窗口,倒计时每秒实时跳动,点面板外自动收起(Esc 亦可)
  • 渠道过滤:实时读取当前会话的模型 Provider(渠道),只在配置的渠道中显示组件,切换渠道即时响应
  • 设置页(设置 → OpenCode 用量):Workspace ID、完整 Auth Cookie、刷新间隔、显示哪些窗口、输入框同心圆开关、渠道过滤;配置持久化到 ~/.dsh/ocu-config.json(0600),重启不丢
  • 总开关:可整体启用/禁用标题行组件

安装

  1. 把本目录链接进 dsh web profile 的模块目录(让 loader 能解析):

    ln -sfn "$PWD" ~/.dsh/profiles/node_modules/@local/dsh-opencode-usage
    
  2. 在 ~/.dsh/profiles/web/cordis.patch.yml 追加:

    - insert:
        - id: opencode-usage
          name: '@local/dsh-opencode-usage'
    
  3. 重启 dsh web(客户端模块扫描需重启生效)。

使用

设置 → OpenCode 用量:填入 Workspace ID 和完整 Auth Cookie(浏览器打开 opencode.ai,从开发者工具复制 auth cookie),点"测试连接"。

工作原理

  • 双端结构:lib/index.js 是 Host 插件(Cordis plugin),lib/client.js 是浏览器 bundle(window.__ModuleLoader__.load(...),由 package.json 的 dsh.client 声明发现)。
  • RPC:Client 通过同源 fetch 调用 Host 注册的 webServer 路由:GET/POST /ocu/api/config、POST /ocu/api/usage。
  • 数据源:Host 用 subprocess 跑 curl 抓取 https://opencode.ai/workspace/{workspaceId}/go,解析页面内嵌的 lite.subscription.get 数据(rollingUsage / weeklyUsage / monthlyUsage,含 usagePercent 与 resetInSec)。
  • 渠道过滤:Client 通过 modelDirectories 服务读取当前会话的模型 Provider。

安全

  • 切勿把 auth cookie 或 workspace ID 提交到仓库。源码默认值为空,实际值只存在于 ~/.dsh/ocu-config.json(0600)。
  • API 路由仅监听本机 dsh 服务,请勿在不可信环境暴露。

许可证

MIT — see LICENSE

使用

设置 → OpenCode 用量:填入 Workspace ID 和完整 Auth Cookie(浏览器打开 opencode.ai,从开发者工具复制 auth cookie),点"测试连接"。