dsh-opencode-quota

DeepSeek Harness (DSH) 的 Web 插件：在设置页查看 OpenCode Go 订阅配额用量。

在 settings.section 槽位注册「OpenCode 配额」页面，展示滚动 / 周 / 月三个时间窗口的用量进度、状态徽标与重置时间。

功能特性

• 📊 三个用量窗口卡片：滚动窗口（rolling）/ 本周（weekly）/ 本月（monthly）
• 🎯 进度条三档状态：正常（品牌色）、≥70% 警告（黄色）、≥90% 危险（红色）
• 🏷️ 状态徽标：正常 / 接近上限 / 超限
• ⏰ 显示每个窗口的配额重置时间
• ↻ 手动刷新按钮

架构

端	职责
Host（node）	注册 GET /dsh-opencode-quota 路由，携带 API Key 代理请求 https://opencode.ai/zen/go/v1/usage
Client（browser）	设置页 UI，XMLHttpRequest 请求该路由并渲染三个窗口卡片

API Key 解析顺序：行配置 config.apiKey → 环境变量 OPENCODE_GO_API_KEY。未配置时返回 missing-api-key。

安装（web profile）

1. 将插件链接到 profile 的 node_modules（junction，Windows）：

   New-Item -ItemType Junction -Path "$env:USERPROFILE\.dsh\profiles\web\node_modules\dsh-opencode-quota" -Target "（本仓库路径）"
   

2. 在 profile 组合文件 cordis.patch.yml 追加：

   - insert:
       - id: dsh-opencode-quota
         name: dsh-opencode-quota
         config:
           apiKey: 'sk-你的-OpenCode-API-Key'   # 可选：不填则读 OPENCODE_GO_API_KEY 环境变量
   

3. 重启 DSH 桌面应用 / 刷新 Web 界面，进入 设置 → OpenCode 配额 查看。

构建

在 deepseek-harness 仓库内（本插件依赖其 workspace 构建链）：

pnpm run build   # tsc -b && tsdown，产出 lib/client.js 与 lib/index.js

目录结构

src/
├── index.ts          # Host：quota 代理路由
└── client/index.ts   # Client：设置页 UI
package.json          # dsh.client.inject 声明（platform: web）
tsconfig.json
tsdown.config.ts      # clientBundle 构建

说明

• 本插件在 deepseek-harness 仓库内开发，package.json 使用 workspace:^ 的 peer 依赖、tsdown.config.ts 引用仓库内的 clientBundle 工具；脱离该仓库独立使用时需相应调整。
• 请勿将 API Key 提交到公开仓库；推荐使用环境变量或本地配置。

License

MIT