qknc-bot/dsh-opencode-go-usage

README 摘要

dsh-opencode-go-usage DeepSeek Harness (DSH) Web GUI 插件:OpenCode Go 套餐用量监控。 输入框工具行常驻一个 5 小时用量圆环 (与内置"上下文已用"圆环同款交互),点击在圆环旁展开白色卡片,显示 5 小时滚动 / 每周 / 每月 三个窗口的已用百分比与重置倒计时。 功能特性 - 工具行圆环 :5 小时滚动窗口已用百分比,按阈值变色(绿 / 橙 / 红),30 秒自动刷新,悬停显示详情 - 展开卡片 :三窗口进度条、百分比、重置倒计时、最近更新时间;白色卡片样式与内置"上下文用量"卡片一致,悬浮在圆环按钮正上方 - Agent 工具 :注册 opencode go usage 工具,对话里直接让模型查询余额(无参数) - 系统提示词公告 :agent 自动获知插件能力,用户提到「余额 / 用量 / quota」时主动使用工具 - 安全 :API key 经 DSH 凭据引用( OPENCODE GO API KEY )解析,只留在 host 进程,浏览器永不接触;代理路由带 loopback-only 围栏,局域网暴露的部署不会泄露 key - 零 SDK 运行时依赖 :host 半部不 import 任何 @deepseek-ai/ 包,git vendoring / 目录安装开箱即用,无构建步骤 安装 或从本地目录安装(注意 pnpm 的 file: 协议无法解析含空格 / 中文的路径,源码需放在纯 ASCII 路径): 安装后 重启 dsh web ,输入框工具行左侧出现 5h 圆环即生效。 首次 git 安装若被 pnpm 的 allowBuilds 拦下 (git 依赖的 prepare 脚本默认被阻止),把下面这段加进 profile 的 pnpm-workspace.yaml 后重跑安装命令: 从旧版本升级时,先 dsh plugin --profile web remove dsh-opencode-go-usage 再重新 add,避免新旧安装方式在 package.json 里残留冲突。 卸载 重启 dsh web 后圆环消失,路由与工具一并卸载。 配置 插件行配置位于 profile 的 cordis.patch.yml (安装时自动生成),可覆盖以下字段: API key 解析:DSH 凭据引用 OPENCODE GO API KEY (即模型 provider 配置的 apiKeyEnv ),通常 零配置 即可工作。 Agent 工具 opencode go usage (无参数)返回三个窗口的已用百分比与重置倒计时,示例输出: 工作原理 - 用量接口 : GET {baseUrl}/v1/usage ,请求头 Authorization: Bearer 。该接口 不在…

分类