AI 简明手册
DeepSeek Harness 源码解读 · 工程方法论为什么 KV Cache 也应当视为接口

专题篇章 · 工程方法论源码解读

为什么 KV Cache 也应当视为接口

它要解决什么

KV Cache 依赖稳定前缀；从首个变化 Token 起，后续内容可能无法复用。DSH 用文档纪律、工具顺序中心列表和严格插值减少无意变化。

源码给出的答案

前缀变化决定缓存从哪里失效

agent 开头由 system prompt 与工具 schema 等内容组成；persona、工具顺序或动态时间改变后，变化点之后的缓存可能无法复用。实际折扣以 Provider 定价为准，前缀稳定性应当作接口维护。

[repo]

工具顺序由中心列表在 waterfall 前规范化

工具顺序由中心列表在 waterfall 前规范化。模板引用未注册变量、无值或格式错都抛异常，不发请求。对话历史只追加，旧前缀保留，新增部分付全价。

[repo]

收益与代价

  • system prompt 中写动态时间会怎样影响缓存： 时间串变化后，其后的前缀可能无法复用。可把动态内容后移，并按任务需要控制精度。

  • 插件热重载改变注册顺序，工具顺序会变吗： 不变。中心列表在 waterfall 前规范化，注册顺序不可观测。

别把取舍当成定律

  • 本页结论对应 revision 0a53fb55bea101816fa226bb964ae2bed71c343b。文件位置、命名和默认行为可能随版本变化，引用实现细节时应同时记录 commit。

来源与核验

  1. [repo] DeepSeek Harness 官方源码（固定 revision）
  2. [official] DeepSeek Harness 官方介绍

Revision：0a53fb55bea101816fa226bb964ae2bed71c343b · 核验日期：2026-08-31