花费限额 FlameCloudn/dsh-quota

@dsh-external/dsh-quota

DeepSeek Harness（DSH）的花费限额 supermod：读取 DeepSeek API 开放平台余额，按花费金额限制任务，可手动设置、随时开关。

兼容性：客户端 UI 为纯 Web 实现（React + 插槽系统）。DSH 桌面窗口与 host 服务的网页端 GUI 是同一页面，本插件随 DSH host 运行——桌面窗口和任意浏览器访问 host 地址均同样生效，无需区分「桌面版/网页版」。
仅要求 DSH host 提供 webServer/agents/credentials 服务（桌面版默认具备）。

功能

- 计量口径：花费额。每 30s 用 DEEPSEEK_API_KEY 读取 https://api.deepseek.com/user/balance，相邻两次余额的下降值记为花费（充值上升不计），计入两个额度池：
- 5 小时池：以首条消息时刻为锚点、每 5 小时滚动（锚点 08:35 时当前池显示重置时刻）；
- 周池：首条消息 + 7 天重置（如 8月27日 08:35），具体时刻显示。
- 周池用尽 → 5 小时池一并不可用；任一池用尽即禁止开启新任务，当前任务（含子代理）继续执行。
- 拦截：host 侧 ctx.agents.create 漏斗硬拦截（DSH_QUOTA_EXHAUSTED），客户端同步拦截「新会话」入口并弹一次性提示。
- 侧边栏卡片（插件市场按钮上方）：↻ 剩余用量 标题 + 内联仪表盘 SVG 图标、时段徽标（北京时 09:00-12:00 / 14:00-18:00 显示「高峰时段」，其余「空闲时段」，右侧同一行显示平台余额）、 5 小时 / 1 周剩余百分比 + 重置时刻 + 进度条。
- 设置页（设置 → 手动限额）：余额、花费进度、限额（元）、启停开关、重置用量。
- 会话统计条：拉满整行显示全部统计（轮次/步骤/LLM 时长/工具调用/首 token/tok/s/缓存命中/token 数）。
- 持久化：插件目录旁 quota-state.json（原子写、30s 节流）；限额关闭时计量照常运行。

配置默认值

| 项 | 默认 |
| enabled | true（随时可关） |
| 5 小时限额 | ¥30 |
| 每周限额 | ¥150 |

HTTP 路由（仅本机回环）

- GET /api/dsh-quota/state — 花费/限额/余额/重置时刻/是否耗尽。
- POST /api/dsh-quota/config — { enabled?, fiveHourYuan?, weeklyYuan?, reset?: 'fiveHour' | 'weekly' | 'all' }。

安装

1. 下载最新 Release 的 dsh-external-dsh-quota-<version>.tgz；
2. 在 DSH 的插件市场中通过 tgz 安装（或按 supermod 注入流程挂载）；
3. 在凭据中配置 DEEPSEEK_API_KEY（与官方余额挂件共用）。

构建

npm install
npm run build # tsdown → lib/impl.js (host) + lib/client.js (client)
npm pack # 产出 dsh-external-dsh-quota-<version>.tgz

⚠️ 桌面端 Node ESM 解析缓存按 profile node_modules 的 junction 路径记忆；入口 lib/entry.js 与包名 @dsh-external/dsh-quota 一旦成功加载就不要改动。

变更记录

- v0.1.4 — 限额提示区分窗口：耗尽时明确显示「5 小时限额已用完 / 本周限额已用完 / 两者均用完」（此前只显示笼统的「花费已达限额」，重置 5 小时后周限额仍超时容易误解为 bug）；state 路由新增 fiveHourExhausted/weeklyExhausted 细分字段与 LLM 注册表诊断探针（llm 字段）。
- v0.1.3 — reasoning-effort UI 打磨（非 DeepSeek 模型极简滑块、242px 居中菜单、13px/500 字体、 50px 固定 effort 字段）；限额关闭时隐藏侧栏卡片；空闲轮询降频 + 内存探针。
- v0.1.2 — 跨版本兼容：统计条加宽改为功能检测，footer 换行改用 data-slot 结构锚点。