前言¶
在 DeepSeek Harness（DSH）里，智能体每一步都会把整个会话上下文连同工具表、系统提示一起发给模型。真实会话里，平均每步上下文在 13 万 token 左右，其中工具表和系统提示这类固定前缀占了 44%。这些内容在每一步都会重发，导致即使任务长度不长，累计成本也很快攀升。很多开发者只能通过肉眼观察日志，难以量化“每步到底重发了多少 token”，更难决定哪些地方可以优化。
dsh-context-budget 是一个 DSH 插件，它把“每一步的重发情况”变成可看的账本，并提供四个可独立开关的闸门。默认只观测，零行为变化；开闸门后，可以在不改变模型推理的前提下，按预算裁剪工具表、外置长尾结果、减少重复读取。
这是什么¶
dsh-context-budget 是一个为 DeepSeek Harness 提供每步上下文账本与可选闸门的插件，由 JinShuXuan 维护。它默认开启观测，记录每步的构成、固定前缀、闸门命中与真实 usage；其它四个闸门默认关闭，需要通过命令或配置显式启用。
插件解决的是三个可测问题：重发什么、重发多大、要不要重复付费。
核心功能¶
插件提供以下核心能力：
- L0 观测（默认开启）
- 折叠会话事件，算出每步构成、固定前缀、闸门命中、真实 usage。 - G1 工具档（默认关闭）
- 在会话开始时，按 schema 体积将工具表裁剪到预算内（新装插件的工具同样纳入）。 - G2 长尾外置（默认关闭）
- 结果超过阈值时落盘，上下文只保留前 1200 / 后 600 字符并附带指针。 - G3 重复读（默认关闭）
- 对同 path+区间且文件未变的内容，直接返回指针而不重发内容。 - read_many（默认关闭）
- 一次调用读多个文件的可选工具。 - 命令
- /budget：展示本会话的每步构成、工具表 Top5 体积、技能目录占比、闸门命中、真实 usage。
- /budget-set key=value …：修改配置并落盘（G2/G3 立即生效，toolset.* 在新会话生效）。
- /budget-full：撤销本会话的工具档，恢复全量工具（会重建一次前缀缓存）。 - 配置优先级与落盘
- 优先级：/budget-set 落盘值 > profile 覆盖层（cordis.patch.yml）> 包内默认。
- 落盘文件位于 $DSH_HOME/context-budget.json，重启后仍然存在。
安装与启用¶
安装插件：
dsh plugin --profile <profile> add github:JinShuXuan/dsh-context-budget
安装完成后，插件只会增加一个只读观测和三个命令，不改变任何行为。如需开启闸门，可在对话中执行 /budget-set 命令或通过配置文件修改。
典型用法¶
- 查看当前会话的每步构成与 usage：
/budget
- 开启长尾外置，将超过 8000 字符的结果落盘，上下文保留前 1200 / 后 600 字符：
/budget-set tail.enabled=true tail.thresholdChars=8000
- 开启工具档，按 token 预算裁剪工具表，新会话生效：
/budget-set toolset.enabled=true toolset.strategy=budget toolset.budgetTokens=25000
- 恢复全量工具（本会话）：
/budget-full
适用场景与注意¶
- 适合需要精细控制上下文成本、希望量化每步重发情况的 DSH 智能体开发者。
- 插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。
- 插件不改变模型、不改变推理、不注入 system prompt、不在会话中途改变工具集，也不写入会话事件或新增事件类型。
短结尾¶
dsh-context-budget 提供了“看得见的每步上下文账本”与可独立开关的闸门，让开发者可以在不改动推理逻辑的前提下，有针对性地控制重发内容与大小。安装后默认只观测，按需开启闸门即可开始优化。
- 目录页：https://www.skillhub.cn/plugins/JinShuXuan/dsh-context-budget
- GitHub：https://github.com/JinShuXuan/dsh-context-budget
