FlameCloudn/dsh-quota

README 摘要

@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-…

分类