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 / 目录安装开箱即用,无构建步骤

安装

## 配置

插件行配置位于 profile 的 `cordis.patch.yml`(安装时自动生成),可覆盖以下字段:

```yaml
- id: opencode-go-usage
  name: dsh-opencode-go-usage
  config:
    baseUrl: https://opencode.ai/zen/go   # 上游网关基址,自动拼接 /v1/usage
    timeoutMs: 15000                      # 上游请求超时(毫秒)
    refreshSeconds: 30                    # 圆环自动刷新间隔(秒)
    warnPercent: 60                       # 5h 窗口达到该百分比后变橙
    dangerPercent: 85                     # 达到该百分比后变红
    announceToAgent: true                 # 是否向 agent 公告插件能力

API key 解析:DSH 凭据引用 OPENCODE_GO_API_KEY(即模型 provider 配置的 apiKeyEnv),通常零配置即可工作。