dsh-opg-usage：在 DSH 界面里实时查看 OpenCode Go 套餐额度

前言¶

用 OpenCode Go 套餐跑任务，额度还剩多少、什么时候重置，通常得离开当前界面去别处查。查一次不够，还得记住上次查的时间估算消耗，稍不留神就撞上限制。

dsh-opg-usage 解决的就是这个问题：把额度面板直接挂进 DSH 的界面里，常驻一个浮动胶囊，随看随刷。下面介绍它的功能、安装和使用方式。

这是什么¶

dsh-opg-usage 是一个 DSH Web 插件，由 M4sh1r0-444 维护，MIT 许可证。它是一个可拖拽、可收缩的浮动胶囊，展示 OpenCode Go 套餐在滚动窗口、本周、本月三个额度窗口下的已用百分比、剩余百分比与重置倒计时。

插件分 Host 和 Client 两半：Host 半注册本地 API 路由，负责读凭据、请求 OpenCode 官方额度接口并返回归一化 JSON；Client 半注册到 Web 客户端的 shell.overlay 槽位，轮询该路由并渲染胶囊。

核心功能¶

插件提供的能力如下，均已写入 README：

1、右上角浮动胶囊，默认显示 Go · 周 X% · 月 Y%，用绿/黄/红圆点提示额度健康度——已用超过 50% 变黄，超过 80% 变红。

2、点击胶囊展开完整面板，可以看到三个窗口的已用/剩余百分比、进度条、状态徽章和重置倒计时。

3、按住胶囊或面板标题栏可以自由拖拽位置，位置自动限制在视口内，不会被拖出屏幕。

4、每 60 秒自动刷新一次，也支持通过 ⟳ 按钮手动刷新；连接异常时显示具体原因，并可重试。

5、面板浮于所有界面之上，包括展开的 better-sidebar 右侧面板——它注册的 shell.overlay 层级已抬升。

6、浅色 / 深色主题自适应，使用 DSH 主题 token，不需要手动切换配色。

安装与启用¶

这个插件没有 dsh plugin add 之类的命令，安装方式是手动编辑 DSH web profile 的 package.json，添加 github 依赖并登记 bundles：

{
  "dependencies": {
    "dsh-opg-usage": "github:M4sh1r0-444/dsh-opg-usage"
  },
  "dsh": {
    "profile": {
      "bundles": [ "...", "dsh-opg-usage" ]
    }
  }
}

文件路径为 ~/.dsh/profiles/<name>/package.json，其中 <name> 换成你自己的 profile 名。

然后执行安装并重启：

cd ~/.dsh/profiles/<name>
pnpm install
# 重启 DSH

插件会自动挂载宿主端并接入 Web 客户端，无需其它配置。当前版本为 0.1.0，要求 Node >= 18。插件是纯 JavaScript，没有构建步骤，也没有第三方运行时依赖，宿主侧只用到 Node 内置的 fetch。

典型用法¶

装好重启后，日常操作只有几个动作：

胶囊：点击展开 / 收起；按住拖动调整位置
面板：点 ⟳ 手动刷新；点「收起」折叠回胶囊

数据来自 OpenCode 官方额度接口 https://opencode.ai/zen/go/v1/usage。凭据方面，插件自动读取 ~/.local/share/opencode/auth.json 中的 opencode-go 项（sk- 开头的 API key），不需要手动配置。

展开面板后看到的三个窗口对应 Host 半返回的 rolling / weekly / monthly 字段，每个窗口带 percent、remaining 和 resetsAt。

适用场景与注意¶

适合同时用 DSH 和 OpenCode Go 套餐、想在跑任务时不离开界面就掌握额度余量的用户。如果你需要在额度紧张时决定任务节奏，常驻胶囊加 60 秒自动刷新基本够用。

安装前有几点值得确认：

1、插件以当前 dsh 进程的权限运行，会读取本地的 auth.json 并向 opencode.ai 发请求。安装前建议先查看仓库源码，确认行为符合预期。许可证为 MIT，README 与 package.json 均有标明。

2、隐私方面，README 写明所有请求在本机完成：Host 进程直接请求 opencode.ai，不经过任何第三方；API key 仅用于请求 OpenCode 官方接口，不写日志、不上传。

3、插件依赖 shell.overlay 槽位，与 better-sidebar 同屏使用时层级已抬升，面板不会被遮挡。

结尾¶

dsh-opg-usage 做的事情很集中：把 OpenCode Go 的额度数据变成一个常驻、可拖拽、自动刷新的界面元素，安装只改一个 profile 文件。如果你在用这个套餐，值得一试。

GitHub 仓库：https://github.com/M4sh1r0-444/dsh-opg-usage
社区目录页：https://www.skillhub.cn/plugins/M4sh1r0-444/dsh-opg-usage

需要说明，社区目录是独立站点，与 DeepSeek / 幻方没有官方从属关系。