dsh-budget-guard
DeepSeek Harness 插件：LLM 成本计量与预算控制（拒绝/警告）、峰谷定价和实时使用情况仪表板
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-budget-guard@0.4.0Budget Guard 以 dsh-budget-guard 发布，当前版本为 0.4.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →DeepSeek Harness 插件：LLM 成本计量 + 预算执行（超预算硬拦截），支持 DeepSeek 峰谷定价。
与其他「只显示数字」的成本插件不同，本插件在
llm/stream调用层执行预算： 超出日/月/总预算时直接拦截模型调用，而不只是弹一个红条。
llm/stream waterfall，观察 provider usage（input / output / cache），跨会话累计deny（默认）：超预算硬拦截 agent-loop 调用，抛 BUDGET_EXCEEDED（LlmError），loop 走 request-error 流程warn：只记录不拦截sessionId）永不拦截，避免死锁budget_status 工具：模型/用户可查询当前用量与剩余预算storage 服务（json KV）；未挂载时进程内存累计shell.overlay 角落常驻面板（5s 轮询），见下面板把已经在记的数据变成可判断的信息，而不只是三个累计数字：
| 区块 | 内容 |
|---|---|
| 主视觉 | 今日消耗环形进度（占日预算百分比）+ 大号金额 + 剩余额度 |
| 24h 趋势 | 每小时花费柱状图，高峰时段着黄色，当前小时描边 |
| 其他周期 | 本月 / 总计进度条，80% 处有警戒刻度，无限额显示虚线轨道 |
| 洞察 | 消耗速率（$/h）、触限预测、缓存命中率与省下金额、当前时段单价与折扣 |
几个刻意的设计：
deny 模式下调用已经发不出去了，今日预计 $12.81 描述的是不可能发生的开销；这时显示的是「明日 00:00（12.6 小时后）」这类恢复时间。总预算耗尽则明说需要调高上限——等到明天也不会自动恢复。$0.03 / $5 是 0.6%，按真实比例渲染会得到 0 像素宽的条——面板退化成几行文字，看起来像坏了。百分比数字仍按真实值显示。# 方式一：npm（推荐）
npm install dsh-budget-guard
# 方式二：dsh 插件命令
dsh plugin --profile web add "github:haoku123/dsh-budget-guard#main"
# 方式三：本地开发
git clone https://github.com/haoku123/dsh-budget-guard.git
cd dsh-budget-guard
npm install --legacy-peer-deps
npm run build
pnpm dsh web --patch ./cordis.patch.yml
见 cordis.patch.yml 示例。默认价格基于 DeepSeek 官方公告（峰价，USD/1M tokens），可通过 prices.models 覆盖。
llm/stream waterfall
├── store.check() → deny? → 抛 LlmError(BUDGET_EXCEEDED) ← 预算执行
└── meterStream() → 观察 usage chunk → store.record() ← 计量
GET /dsh-budget-api/status → { status, history, budget, prices, pricing }
│ └ list + effective 单价
└ 近 24 个小时桶（含空桶）
src/index.ts：插件入口（拦截 + 工具注册 + status 路由）src/prices.ts：价格表 + 峰谷逻辑 + 费用计算（纯函数，独立可测）src/budget.ts：预算状态与持久化（storage KV / 内存降级）+ 小时桶趋势src/client.tsx：仪表盘组件记账分四个 scope：d: 日、m: 月、t:total 总计、h: 小时。前三个永久累计；小时桶只为趋势图存在，保留 48 小时后裁剪——每天 24 条，不设上限会无限增长。deleteRecord 在 storage 后端是可选的，所以内存里一定裁剪，落盘行删不掉也无所谓：connect 加载时会用同一个窗口过滤，过期桶不会复活。
npm test # vitest：host 17 用例（计量/deny/warn/峰谷/时区/小时桶/status 契约）
# + client 18 用例（渲染/趋势/洞察/拦截态/低占用可见性）