dsh-budget-guard

dsh-budget-guard

DeepSeek Harness 插件：LLM 成本计量 + 预算执行（超预算硬拦截），支持 DeepSeek 峰谷定价。

与其他「只显示数字」的成本插件不同，本插件在 llm/stream 调用层执行预算：

超出日/月/总预算时直接拦截模型调用，而不只是弹一个红条。

功能

用量计量：包装 llm/stream waterfall，观察 provider usage（input / output / cache），跨会话累计

费用计算：内置 DeepSeek 价格表，按模型计费（USD）

峰谷定价：感知 DeepSeek 峰谷时段（北京时间 9:00–12:00、14:00–18:00 为高峰，其余半价），按调用时刻计价

预算执行：

- deny（默认）：超预算硬拦截 agent-loop 调用，抛 BUDGET_EXCEEDED（LlmError），loop 走 request-error 流程
- warn：只记录不拦截
- 内部调用（compaction、标题生成等，无 sessionId）永不拦截，避免死锁

budget_status 工具：模型/用户可查询当前用量与剩余预算

持久化：可选接入 storage 服务（json KV）；未挂载时进程内存累计

安装

```bash

方式一：npm（推荐）

npm install dsh-budget-guard

方式二：dsh 插件命令

dsh plugin --profile web add "github:haoku123/dsh-budget-guard#main"

方式三：本地开发

git clon