前言¶
在 DSH 插件生态里，router / mode-boost 一类插件通常处理路由或模式，persona 处理人格与表达。如果只调用 DeepSeek API 而不自部署，另一个常见问题是成本：会话花了多少钱、缓存命中率如何、峰谷和错峰怎么配合、预算花完后是否能停止新增计费。
sixtysevenlf/dsh-cost-guard 就是面向这个场景的成本插件。它装配在 router / mode-boost 之上，不碰 persona，只做与「钱」相关的事。
这是什么¶
dsh-cost-guard 是一个 DSH 成本插件，仓库名为 sixtysevenlf/dsh-cost-guard，许可证为 MIT。
它面向「只用 API、不自部署」场景，按 DeepSeek 官方 2026-08-17 峰谷分级（¥/百万 token）核算 DeepSeek V4-Flash-0731 的会话成本，并提供预算守卫、会话级收敛开关、自动成本路由、峰谷感知、错峰队列、客户端面板和 dsh-optab 子包。
核心功能¶
成本核算与缓存统计¶
插件会核算会话成本，并统计缓存命中率、全命中可省金额与已花 ¥。
cost_status 可用于查看当前状态。
预算守卫¶
cost_budget {budget} 用于设置预算。预算即硬上限：花到预算后，由 llm/stream 短路拦截，不再产生新计费。
这里有一个明确边界：正在飞行的那一次请求会走完；之后的新请求短路，不再新增费用。
预算硬顶只在项目成本守卫开启时生效。守卫关闭时，预算只记录、不拦截。错峰 daemon 和无 sessionId 的一次性调用不受预算闸门影响。
会话级收敛开关¶
输入框按钮可作为会话级收敛开关：点一次注入收敛引导，再点一次撤回未消费的引导并退出收敛模式。
cost_guide {target} 也可用于注入收敛引导。
这里有一个原则：不要向 system 注入动态内容，动态信号应走消息尾，避免破坏前缀缓存。
自动成本路由¶
复杂任务可按复杂度、峰谷、预算余量自动选择深度、收敛或错峰。
峰谷感知与错峰队列¶
cost_peak 用于查看当前峰谷状态与错峰建议。
cost_defer {task, maxTokens?} 用于把任务登记到错峰队列，空闲时段由 daemon 自动执行。
cost_deferred 用于查看队列状态。
客户端面板¶
客户端面板提供监控卡片、预算三级作用域、错峰队列、延期结果、项目级启用开关与项目分组。
dsh-optab 子包¶
dsh-optab 子包提供前缀瘦身、工具输出压缩、推理档位自动，并支持峰时封顶与超支收紧。
安装与启用¶
先安装插件包：
dsh plugin --profile web add <tgz>
如果已有本地目录，资料中给出的安装方式包括：
dsh plugin --profile web add <此目录>
热注入场景下，可以使用：
dev_inject_plugin D:\DSH\测试\优化\dsh-cost-guard
也可以执行：
dev_install_package
插件依赖 cordis：
cordis >=4.0.0-rc <5
面板注册依赖重启：client-modules 按包名缓存且永不过期，插件集变化需重启 web 生效。热注入场景下如果面板或「收敛」按钮未出现，需要重启 web 一次。
如果从源码构建 dsh-optab：
cd optab && bash scripts/build.sh
该构建需要 DSH_CHECKOUT；lib/ 为构建产物且不入库。
典型用法¶
下面列出资料中给出的工具与接口示例。
查看状态并设置预算：
cost_status
cost_budget {budget}
查看峰谷并登记错峰任务：
cost_peak
cost_defer {task, maxTokens?}
cost_deferred
注入收敛引导，或切换项目级开关：
cost_guide {target}
cost_enable {mode: on|off|auto}
面板可调用以下接口：
GET /cost-guard/api/state
POST /cost-guard/api/enable
POST /cost-guard/api/optab {enabled}
适用场景与注意¶
这个插件适合只使用 API、希望统一查看成本、缓存命中、预算和错峰任务的人。
它与 router / mode-boost 的分工是：它们管路由和模式，dsh-cost-guard 管成本。
使用注意：
- 插件以当前 dsh 进程权限运行，安装前应检查源码与
MIT许可证。 - 预算硬顶只在项目成本守卫开启时生效；守卫关闭时预算只记录、不拦截。
- 正在飞行的请求会走完，之后的新请求才会被短路。
- 错峰 daemon 和无
sessionId的一次性调用不受预算闸门影响。 - 不要向
system注入动态内容；动态信号应走消息尾，避免破坏前缀缓存。 - 面板删除项目或会话使用两步确认，因为沙箱 iframe 中
window.confirm会被静默拦截。 v0.1.17移除了基于越权访问dsh-client-modules私有 API 的「开机自愈」。- 插件零依赖、前缀缓存中性，宿主平面装配，不触碰
dsh-client-modules内部状态。
结尾¶
dsh-cost-guard 的价值在于把成本核算、预算硬顶、收敛引导、自动成本路由和错峰执行放在同一套 DSH 插件里。
GitHub 仓库地址：
https://github.com/sixtysevenlf/dsh-cost-guard
