把工作集外化
让有用的信息离开现行上下文而不丢失:外部 payload 可恢复,系统须保留什么,怎么独立模型行为测试。
第 12 章问准入内容对象的哪种合法表示现行。即使最便宜的有用驻留表示还占容量。设想说明性依赖迁移会话。智能体累积了约 18,000 token 的架构调查、12,000 的 benchmark 报告、25,000 的编译器轨迹、15,000 的设计备选笔记、30,000 的 vendored API 引用。这些数描述完整工作对象,不一定是当前驻留的 token:假设选的视图已经压缩过,合起来还占可观容量。大多数轮次任务至多用五样之一。第 12 章问展示哪种形式。没问对象要不要展示。
渐进保真还耗窗口空间。下一步是把信息整个拿出窗口。
本章把这个区分操作化。它拥有离开:payload 离开当前模型输入、后面须可恢复时,运行时须满足的要求。它不承诺任何离开默认无损。identity、表示、访问、完整、成功恢复是须确立测试的义务。第 14 章拥有运行时选什么回来。
可用不是驻留
到此本书管理上下文好像有用信息须在窗口里占某种表示。那是假设,本章打破它:
系统可用 ≠ 上下文驻留
[第 1 章](/zh-cn/books/context/01-chapter/)的流适用:可用信息、运行时 state、组装、模型输入。外化利用信息能对运行时可用而不出现在当前推理。
外部相对模型可见上下文边界定义,不相对机器网络。本地文件、进程内存储、数据库、远端服务都能外部。不变量是有用 payload 不在当前模型输入里表示:
现行上下文之外 ≠ 远端
操作系统工作集只在一处是好类比:大存储的驻留子集。止于硬件帮忙止处。模型不对地址空间跑,缺页透明换入而同一算子继续。运行时须认出需要、resolve 引用、经工具结果或另一次模型调用给内容。它能在智能体序列里做,早先的模型算子追认拿不到缺席的字节。上下文外化因此不是虚拟内存分页。
表示选择与驻留选择
[第 12 章](/zh-cn/books/context/12-chapter/)的链条从保留政策到合法表示集,再选择,再现行表示。第 13 章加不同的决定。表示选择问哪种合法表示现行。驻留选择问语义 payload 应不应该现行:
表示选择 ≠ 驻留选择
引用渲染给模型时占 token,引用 payload 不占。运行时也能把外部对象的 identity 完全放模型输入外存,一驻留引用没有,只要别的机制后面认得出它。本章集中可见引用 case,因为它们暴露短语义 cue 和 opaque 指针的区别。表描述那些 case,不是每种外化设计:
| 状态 | 语义 payload 驻留? | 恢复引用驻留? | 要外部对象? | 政策要求未来恢复? |
|---|---|---|---|---|
| 驻留表示 | 是 | 可选 | 不 | 不适用 |
| 外化,语义引用 | 只有 cue | 是 | 是 | 是 |
| 外化,opaque 指针 | 不 | 是 | 是 | 是 |
| 剪枝 | 不 | 不要求 | 没保证 | 不 |
末行标和[第 10 章](/zh-cn/books/context/10-chapter/)的政策边界。剪枝契约下系统不必为删掉的 payload 保留恢复路;独立留存的来源还是可能有。外化下恢复是明确义务,要求 horizon 内。同一源文件 underlying 两种操作都行。区别在契约,不在磁盘字节碰巧留没留,实验须记录适用哪个契约。
锚点、指针与语义引用
第 12 章按功能定义锚点:满足一些声明义务的低成本驻留语义表示。指针是驻留引用,有用内容住别处,参与前须 resolve:
锚点 ≠ 指针
锚点带声明的语义内容,模型不用加载完整来源就能用。artifact://incident-17 之类的 bare 指针识别潜在恢复目标,没确立事故里发生什么;连指针 identity 与可达都须验证。语义引用把短语义 cue 和外部 identity 组合。两半独立挂:cue 漏掉扭曲状态关系约束,identity resolve 错或解不出。cue 因此是新表示,受[第 11 章](/zh-cn/books/context/11-chapter/)的保留检查。说明性字段不是通用 schema;要求字段跟声明义务与恢复接口走。
外化是什么
上下文外化把语义 payload 从当前模型输入拿掉,同时保留识别的外部表示与恢复契约,运行时经它后面再把那个表示拿回来。
外化不是删来源,和后面的取回重准入动作不同:离开和回来契约分开。它也和[第 7 章](/zh-cn/books/context/07-chapter/)政策下的重取不同。可重取来源 independent persist,运行时搬上下文出去与否一样在,比如源头的版本化文档;外化调查报告是运行时 deliberate 保留,因为后面恢复要。两种机制读文件用同样工具。区别是来源为什么还在,哪种 identity 保留保证系统欠,不是物理读操作:
外化 ≠ 重取
推导的保留政策允许外化,允许不强制。内容对象合法外化、经济不 rationality 搬,省的违反驻留要求也可能:
政策合法 ≠ 经济可取,合格 ≠ 现在执行
它也不要求永久 persist。外部表示按政策要求的 horizon 留存,存什么合适存什么,本章不设计存储。
在 Context Viewer 里检查
本章的 viewer scene 外化一 payload 留两引用:一语义 cue,一 opaque 指针。打开 scene 按恢复契约测每引用。看什么:哪个指针带版本完整性检查 resolve,哪个只是点名。来源保留不是可恢复,指针全程画成引用——永不当它点名的证据。
恢复契约
指针是语法。背后的操作承诺是恢复契约,那是本章的主要对象。属性比任何生产 schema 重要:对象 identity;表示 identity 类型;保真要处版本或内容 identity;定位器 resolver;允许的项目任务范围;来源;可用 horizon;字节精确重要处完整性检查。契约还须说什么算成功:找到文件、读到匹配字节、恢复表示给后面的模型调用可用,是不同的终点。没验证的标识符访问断言须照实报告,永不静默提成保证。
四 identity 不同,各自独立变:
对象 identity ≠ 表示 identity ≠ 版本 identity ≠ 定位器
durable 对象 identity 设计跨存储移动存活,定位器描述当前哪里 resolve;成立否都要测。artifact://incident-17 resolve 到 raw 日志、结构化记录、报告都行,契约须识别意图表示或定义确定性 resolve 规则。progress.md 可变,路径本身确立不了以前用的版本。初始实验冻结表示引用,版本漂移冒充不了推理失败。可变工作 artefact 是显式扩展,没解决的 case。metadata 字节 payload 字节分开核算,内容 hash 只对期待的内容 identity 确立相等,不确立语义 valid。
来源是 artefact 从哪来、怎么产出的。它的 discipline 从第 11、12 章跨边界延伸,加 artefact identity、写事件、版本 identity、后面的恢复事件。它没确立权威性,权威性归[第 19 章](/zh-cn/books/context/19-chapter/):
来源 ≠ 权威性
范围记下来防意外 resolve 到意图项目任务边界外,更广的范围语义归[第 21 章](/zh-cn/books/context/21-chapter/)。
测试要紧的区分:
指针 ≠ 可恢复性 ≠ 恢复成功
存在 ≠ 可及 ≠ 可恢复
可恢复 ≠ 可逆
指针表达去内容的意图路线;它不是路线 work 的证据。恢复契约同样是规格,不是完成的恢复。测试过的恢复检查意图 identity、resolve、存在、授权、可读表示、期待版本、完整性,再记录 payload 只是回到运行时还是真准入后面的模型调用。后两件事绝不能搞混。契约允许更新或变换的表示,轨迹须说清;那不是 earlier 上下文的字节精确恢复。结果是测试条件下的恢复,不是可逆的 general 保证。
模型观测到什么
认识风险是本章最重要的。驻留行"Evidence: artifact://incident-17" 不等于模型观测了 artefact:
可用证据 ≠ 观测证据,引用在场 ≠ artefact 被观测
驻留文本须区分真供给模型的证据和经外部 handle 可及的信息。不然模型把没读的 artefact 当支撑结论的用。轨迹至少区分引用渲染、resolve 尝试、identity 访问检查、payload 返回、payload 准入某调用。成功的工具读取 alone 证明不了结果进了下次模型输入。本章规定这些区分,不实现事件。认识状态在 artefact 创建 cue 生成两边都须留存:来源只怀疑时间戳 corrupt,生成的 cue 不许静默把怀疑提成发现。
契约挂时
失败按契约断在哪分类,每种和推理质量分开打分:
- **identity 失败:**引用没唯一识别意图对象,比如两对象共享 ambiguous 路径。
- **resolve 失败:**identity 解不出当前定位器对象。
- **版本完整性失败:**解出的对象不是期待的表示版本字节。
- **访问范围失败:**对象在,运行时没许可或够不着。
- **可解释性失败:**解对了,脱离原对话看不懂。
- **表示契约失败:**引用声称 raw 精确内容,存的对象变换过或不全。
前五个机器可查的失败和表示契约失败归离开恢复契约,可解释性引入独立问题:恢复的表示能不能正确用。运行时拿到精确 identity 却 resolve 错版本对象,[第 13 章](/zh-cn/books/context/13-chapter/)的契约挂了。运行时须在十个 valid artefact 里选,选错任务目标,[第 14 章](/zh-cn/books/context/14-chapter/)的取回选择政策挂了。两失败位置交出同样的错误答案,测试不同:
恢复完整性失败 ≠ 取回选择失败
最后, artefact 正确恢复不一定正确使用,又是[第 5 章](/zh-cn/books/context/05-chapter/)的梯子。artefact 内容过时否归[第 20 章](/zh-cn/books/context/20-chapter/),本章只问 handle 到不到意图字节。
冻结精确字节外化在写步骤没引入意图语义变换,还能引入截断、编码、版本、corruption 错误,所以不是 failure-proof。外化生成的摘要在上面叠加[第 11 章](/zh-cn/books/context/11-chapter/)的变换风险。第一个实验因此外化 raw 冻结来源,把驻留和变换隔开。
离开的代价
更小的 live 上下文不自动是更便宜的系统。成本分开:
- **驻留:**拿掉的 payload token、引入的引用 token、轨迹现行 token。标识符标题摘要标签范围版本来源丰富的引用吃掉大半省的。
- **写:**生成(有处)、序列化、验证、存储、引用构造,是发生的成本,测到价格才是计费的。
- **管理:**registry、版本、范围执行、完整性检查。
- **恢复:**resolve 延迟、读的字节 token、重引入 token、工具调用。
- **行为:**单独测。
- **缓存复用:**provider 语义 telemetry 支持处才有。按[第 9 章](/zh-cn/books/context/09-chapter/)第一分歧与可观测复用 effect 记录,变更半径还是提议的核算概念。
两频率重要,分母说清。驻留频率是某 payload 或其选定语义表示准入的观测模型调用占比。恢复频率是每调用或每任务尝试或成功的 resolve 数,分开报告,重复读不一定准入。多数轮次全恢复重准入吃掉 token 省的,加延迟。任务边界、缓存安全边界、压力阈值是候选 transition 时机,不是推荐。轨迹须数外化机器的成本和它省的上下文。
什么可以驻留
有些信息 plausibly 驻留,因为它改变后面每行动的读法:当前目标、关键现行约束、即时计划 state。这些是 likely 候选,不是 law,每轮重复恢复目标能纯 overhead。外面 raw 证据、里面语义 cue 是有用的切分,只要模型不像检查过 raw 证据那样推理。驻留浪费只对 fixture specific oracle(hidden 要求 hindsight)度量,永不当生产断言。
工程例子
三来源展示现行模型上下文外维护、经显式机制够到的信息。它们是工程例子,不是受控研究,也不是独立复现。
| 来源 | 证据类型 | 验证的断言 | 本章用 | 没确立 |
|---|---|---|---|---|
| Anthropic,“Effective context engineering for AI agents”(Applied AI 团队) | 厂商工程指南 | 智能体留轻标识符(文件路径、存的查询、链接),运行时经工具加载数据;笔记存窗口外后面拉回;子智能体干净窗口;运行时探索慢于预计算取回 | 无驻留的可用当 work 模式,带陈述的代价 | 效果 |
| Anthropic,“Effective harnesses for long-running agents”(2025 年 11 月) | 厂商工程报告 | 两失败模式(揽太多、过早宣布完成);压缩 alone 不够;initializer 写 pass/fail 功能清单、init 脚本、progress 文件、初始提交;每会话读 progress git 历史,做一功能,提交 | durable artefact 里的工作 state 加压缩 | 文件是最好的 substrate |
| WithContext MCP(boxpositron) | 第三方实现,MIT | Obsidian vault 里项目范围笔记的 MCP 服务器,33 工具,会话 changelog todo,操作限制在配置项目文件夹(路径验证) | 小 workspace 的范围执行 | 效果;工具面的采用 |
那些机器之前,文件系统是任何机制须打赢的基线:写文件,留路径版本,后面读。普通文件给定位器,有时给实用 identity,但改名断路径,版本 identity 只在记录提交或内容 hash 时有,仓库本身不执行语义范围。更多基础设施在做不出普通文件做不到的事之前不是更好的外化。产品 artefact 和智能体工作 artefact lifecycle 能不同,别 accidental 搞混,这是 hygiene 规则不是第一性原理 law。
提议的实验
这里什么都没跑。
**生态门。**精巧机器前描述真实轨迹:现行上下文多少是大对象(多数调用用不到、后面还要)、多久 recurring、活多久、引用多大、精确要求什么。真实会话语料是空的,机会没测量:
外化能 work ≠ 机会常见
**实验 A:离开。**payload 离开现行上下文省占用吗,当前任务用不到 payload 时行为 effect 什么?fixture 用 15,000–30,000 token 冻结来源,含精确标识符决定;目标任务提前指定不依赖那些来源,测量区间禁用恢复。条件是:完整来源驻留;驻留压缩表示;驻留语义锚点(无外部依赖);来源存外部加 opaque 指针;来源存外部加语义 cue(测试 identity);fixture specific oracle 驻留。压缩锚点条件引入变换,指针条件更干净 isolate 离开。它们当不同对比解释,不当一纯 manipulation。匹配的语义 cue 跨 cue 条件带同样的断言,不然差别反映多余信息不是驻留。记录现行 payload 引用 token、总占用、外部写管理成本,单独评估任务成功与没读 artefact 的不支持断言。现行尺寸故意不同;预算匹配对比次要,行为差不自动归因驻留 alone。
**实验 B:恢复完整性。**运行时给显式冻结 artefact identity,要求 resolve 不排名备选候选,这个测试和[第 14 章](/zh-cn/books/context/14-chapter/)的选择问题隔开。确定性断言检查对象表示 identity、版本、期待 hash、存在、范围、访问、来源要求。记录回到运行时的取回和准入调用的实际准入(测试契约含准入处)。注入缺失对象、移动定位器、ambiguous 别名、错版本、权限拒绝、corrupt 字节、表示 mismatch、缺失来源。上下文相关 artefact 可解释性单独评估,正确恢复的字节看不懂和坏 hash 不是一类失败。解释问题才用人 review 或 blind 模型 judge;确定性检查不用 judge。
变换 artefact 条件后面单独加,混[第 11 章](/zh-cn/books/context/11-chapter/)的变换风险和[第 13 章](/zh-cn/books/context/13-chapter/)的恢复风险。
**缩小本章的结果。**驻留类型化压缩打平外化还便宜;引用吃掉大半省的;恢复 frequent 到总成本延迟涨;opaque 指针在取回前 degrade 决定;语义引用扭曲状态关系;契约失败常见;真实轨迹很少这种对象;普通文件打平 artefact 机器。每条都是 valid 结果。
下一步回来什么
第 13 章止于外部表示、引用、恢复契约指定,运行时测试下演示要求的 resolve 路。它不断言模型选得出 artefact 或用对内容。第 14 章从选择问题开始:哪个对象回来、何时、什么形式、哪个任务。排名、查询扩展、自动回忆这里不建,窗口外 persist 的 artefact 不自动是智能体记忆。durable 跨会话影响还是记忆书的问题。
本章实验说什么都留三 point。上下文是从更大信息世界取的工作集,不是存储系统。信息能可用而不驻留。安全离开窗口不止像引用的字符串:要识别的外部表示、带来源范围的恢复契约、独立模型行为的证据(契约 resolve 到意图信息)。
系统的外部信息世界比上下文装得下时,它怎么决定这次算子回来什么?
参考
- Anthropic Applied AI team (Rajasekaran, Dixon, Ryan, Hadfield, et al.). “Effective context engineering for AI agents.” Vendor engineering guidance, September 2025. https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents
- Young, J., et al. “Effective harnesses for long-running agents.” Anthropic engineering report, published 26 November 2025. https://www.anthropic.com/engineering/effective-harnesses-for-long-running-agents
- boxpositron. “WithContext MCP Server.” Third-party implementation, MIT licence, verified September 2026. Implementation facts only. https://github.com/boxpositron/with-context-mcp