opencode-usage

by amatsumeakira

1 UI 增强github收录于 08-23

OpenCode Go 订阅额度徽章插件（dsh bundle） \| OpenCode Go quota badge plugin for dsh

安装

$ dsh plugin --profile web add github:amatsumeakira/opencode-usage

GitHub 源码安装：首次需按提示配置 allowBuilds 构建授权后重试

安装与环境配置指引、插件开发教程见 DSH 中文社区文档 ↗

安装即在你的机器上以你的权限运行第三方代码——它可读写文件、使用凭据、访问网络，DSH 的工具审批不会为插件代码加沙箱。「检测到 manifest」仅代表发现 dsh.bundle / dsh.plugin 清单，不构成兼容性或安全审查；安装前请审阅源码，不熟悉的插件先在不含密钥的环境试用。

English | 中文

OpenCode Go 订阅额度徽章插件（bundle）——在 dsh Web 界面显示 OpenCode Go 滚动 / 周 / 月三个窗口的额度用量与重置时间。

截图

对话输入区中的 OpenCode Go 额度徽章

功能

在对话输入区（composer dock）显示三个窗口的用量百分比（颜色随用量变化：绿 → 黄 → 红）与重置倒计时
显示最近一次数据获取时间（「更新 M/D HH:mm」），刷新期间显示「更新中…」
点击「OpenCode Go」文字可手动刷新额度
每 5 分钟自动刷新一次
API 密钥只存在于 harness 进程内：通过凭据服务逐请求解析，经 curl 环境变量传递，绝不序列化到浏览器或日志

安装

本包是官方 dsh bundle 格式：发布即预构建产物（lib/ 随仓库分发），无任何 install 脚本，因此 git 安装不需要 pnpm 的 allowBuilds 授权。

dsh plugin --profile web add github:AmaTsumeAkira/opencode-usage

或从本地目录安装：

dsh plugin --profile web add ./opencode-usage

卸载：

dsh plugin --profile web remove opencode-usage

配置凭据

插件通过官方凭据服务读取 OPENCODE_GO_API_KEY（环境变量或 ~/.dsh/.credentials.yaml 均可）：

# ~/.dsh/.credentials.yaml
OPENCODE_GO_API_KEY: your-opencode-go-api-key

未配置凭据时，徽章显示「获取失败」。

结构

opencode-usage/
├── package.json       # dsh.bundle + dsh.client(web) manifest
├── cordis.patch.yml   # 插件行插入层
├── lib/index.js       # host 半部：/opencode-usage 路由（ESM，零依赖）
└── lib/client.js      # 浏览器半部：composer dock 徽章（__ModuleLoader__ 格式）