Agent 教程

外观

第 5 章合同：上下文、会话与记忆 ​

章节目标 ​

读者理解长会话 Agent 如何管理消息、上下文窗口、压缩、附件、记忆和恢复。

必须覆盖的源码 ​

  • restored-src/src/services/compact/
  • restored-src/src/utils/sessionStorage.ts
  • restored-src/src/utils/messages.ts
  • restored-src/src/utils/attachments.ts
  • restored-src/src/utils/fileStateCache.ts
  • restored-src/src/memdir/

必须回答的问题 ​

  • 为什么 Agent 不能无限追加历史？
  • Claude Code 有哪些 compact 路径？
  • 会话保存和恢复解决什么问题？
  • 文件读取缓存有什么意义？
  • 自研 Agent 一开始需要做到什么程度？

必须包含的迁移观点 ​

最小实现可以先做 append-only session log；当上下文增长后，再加摘要压缩和文件状态缓存。

验收标准 ​

  • 给出上下文进入模型前的处理链路。
  • 给出简化版 SessionStore。
  • 说明 compact 的收益和风险。