前言¶
在 DSH 或智能体开发里，如果每次请求的系统提示前缀因为工作目录等可变内容而发生变化，provider 侧基于前缀匹配的 prompt cache 可能不容易复用。dsh-cache-stabilizer 是一个面向 DeepSeek Harness 的 MIT 许可插件，由 dongsheng123132 维护。它做两件事：一是把 DSH 已知默认人格句中的工作目录移到 runtime-context snapshot；二是规范化 tool schema 中 object-key 的顺序。插件还提供 /cache 命令，用于报告 provider 返回的缓存读取、未缓存输入和缓存写入 token。
这是什么¶
dsh-cache-stabilizer 的定位是 cache-prefix stabilization 和 evidence-based cache metrics。它不实现第二套缓存，不代理模型响应，不冻结 tool catalog，也不复用 stale context。它只在当前 DSH 请求构造阶段做一些语义保持的前缀稳定化，并通过 provider 指标展示缓存证据。
该插件要求 Node.js >=22。
核心功能¶
把 cwd 从默认人格句中移出¶
插件会把 DSH standard/headless coding persona 中已知的确切句子里的 working directory 移出系统提示前缀，改放到 runtime-context snapshot 中。这样，不同项目可以共享同一段 system-prompt 前缀，同时每个请求仍然能收到正确的 cwd。
这里有一个明确边界：只有 DSH 标准或 headless coding persona 使用的确切句子会被迁移。如果自定义 persona 以其他形式提到 {{cwd}}，插件不会改动，因为盲目移动任意自然语言可能改变含义。
规范化 tool schema 的 key 顺序¶
插件会规范化 tool schemas 内部 object-key 的顺序。这个改动服务于前缀稳定，但不会改变 tool 集合本身。
增加 /cache 命令¶
插件增加 /cache 命令。这是一个 human-only 命令，用于报告 provider 的持久指标：
cacheReadTokens- 未缓存的
inputTokens - cache-write tokens
/cache 不会凭空构造一个 cache hit。DeepSeek provider cache 是自动的，依赖从 token zero 开始的精确前缀匹配；缓存存储和淘汰仍由 provider 控制。
安装与启用¶
在 web profile 下安装：
dsh plugin --profile web add dsh-cache-stabilizer
如果使用自定义 profile，把 web 替换为对应 profile 名称。
典型用法¶
1、安装插件：
dsh plugin --profile web add dsh-cache-stabilizer
2、重启 DSH，发送几条消息，然后在支持命令的客户端中输入：
/cache
如果需要在某个 profile 中关闭某项优化，可以用 profile patch 配置：
- id: dsh-cache-stabilizer
config:
relocateCwd: false
canonicalizeTools: false
适用场景与注意¶
适合使用 DSH standard/headless coding persona、希望减少可变内容对系统提示前缀影响、并且想查看 provider 缓存证据的开发者。
使用前需要注意：
- 插件以当前 DSH 进程权限运行，安装前应检查源码和许可证。
- 该插件不会创建新的缓存层，也不会改变 provider 的缓存存储和淘汰策略。
- 如果自定义 persona 的
{{cwd}}不是 DSH 已知默认句子的精确形式，插件不会自动迁移。 /cache只报告 provider 给出的指标，不会推断或生成不存在的 cache hit。
开发与验证¶
仓库提供开发命令：
npm test
npm run check
链接¶
GitHub：
https://github.com/dongsheng123132/dsh-cache-stabilizer
社区目录页面（资料提供，未由 README/package.json 确认）：
https://www.skillhub.cn/plugins/dongsheng123132/dsh-cache-stabilizer
社区目录是独立站点，并非 DeepSeek 或幻方官方应用商店。
