dong-victor/dsh-opencodego-usage

README 摘要

@dong-victor/dsh-opencodego-usage 查看 链接的 opencode Go 套餐余额 的 DSH Web GUI 插件：侧边栏「Go 余额」入口 + 中央列面板，展示 rolling / weekly / monthly 三档用量百分比、状态徽章、重置时间与实时倒计时；同时提供 agent 工具 opencode go balance 与系统提示词声明，让助手也能直接回答「opencode Go 套餐还剩多少」。 完全复用 DSH 已有的 LLM 接线（ llm-pi-ai 的 opencode-go 路由设置 + credentials 服务）， 无需再配一把密钥 ——默认密钥引用就是官方 opencode 模型专用的 OPENCODE GO API KEY ，绝不复用 llm-deepseek 的 DEEPSEEK API KEY 。 数据来源 官方端点（OpenAI 兼容网关的用量接口）： 响应： - percent = 该窗口已使用的百分比（ 100 - percent 即剩余额度）； - status = ok （正常）或其它（如超额时提示注意）； - resetsAt = 该窗口重置时间（ISO），面板显示本地时间 + 每秒跳动的倒计时。 无密钥 / 无效密钥 → HTTP 401；本插件把 401/403 转成可读错误「密钥缺失、过期或无 Go 套餐权限」。 其它路径（ /zen/go/v1/subscription 、 /api/usage 等）均为 404， /zen/go/v1/usage 是唯一可用余额端点（已实测验证）。 架构 双面插件（同 dsh-ssh 模式），零构建依赖、纯 JS、即装即用。运行时唯一的外部依赖是 @deepseek-ai/dsh-tools （工具注册契约，peer 依赖 ^0.1.0-rc.6 ，与 dsh-ssh 等官方插件声明一致）——由 DSH 宿主按官方版本提供，插件不自带固定旧版副本、不随包维护： 宿主半面 lib/index.js 能力 说明 GET /api/dsh-opencode-go/balance 回环防护（仅本机/同源）， ?refresh=1 绕过缓存；返回 {ok, fetchedAt, cached, source, usage?, error?} 密钥/端点解析 默认取 settings.get('llm-pi-ai') 的 providers.opencode-go 路由 baseURL （取 origin）与 apiKeyEnv （即 OPENCODE GO API KEY ），回退到插件自带默认 https://opencode.ai / OPENCODE GO API KEY ；credentials 服务 resolve(ref) ， p…

分类