TencentDB Agent Memory · 第 8 章 MemoryProxy 八步管道精读

TencentDB Agent Memory · 第 8 章 MemoryProxy 八步管道精读

章节摘要:这是全书最硬核的第二章,也是工程上最精巧的一笔。面对 Claude Code / CodeBuddy 这些已经成熟、你不可能去改源码的 Coding Agent,系统不要求你改造代码,而是提供一个透明 HTTP 代理——你只改一行 baseURL,Agent 的所有流量就被导向代理层;代理层在把请求转发给真正的 LLM 之前与之后,做八步处理。前四步是「准备」:auth 验证用户密钥、systemUser 解析系统用户、sessionInit 用交互式表单确定 team/agent/task、injection 把记忆注入上下文;中两步是「执行」:rateLimit 滑窗限流、forward 转发给 LLM;后两步是「收尾」:extract 把对话回写成 skill 与 L0、report 上报可观测。其中 injection 又分两种策略:稳定的 L2/L3/Skill 走 inject 拼进 system prompt 命中 KV cache,易变的 L0/L1 走 toolize 作为只读工具按需调用避免 cache 失效。存储层抽象为 ProxyStorage,支持 cos/sqlite/fs/memory 五后端按优先级降级。本章逐段读这条八步管道,把「透明代理如何让 Coding Agent 零改造拥有记忆」彻底讲透。

学习目标

阅读完本章,你应当能够:

1. 背出八步管道的顺序与每一步的职责,并解释为什么是这个顺序
2. 说清 sessionInit 交互式表单(team→agent→task)解决了什么问题
3. 解释 inject 与 toolize 两种注入策略各自的适用内容与性能权衡
4. 描述 extract 回写流程(对话如何变成 skill 与 L0)与存储五后端降级链的工作方式

核心概念速览

一句话金句:八步管道的精髓不在「做了八件事」,而在「让 Agent 一行代码都不用改」——所有记忆能力都藏在这一行 baseURL 背后的转发链路里。

子章节导航

01 透明代理定位与八步管道全景

给出八步管道全景,讲清代理为何是「透明」的(不改 Agent 代码、只改 baseURL),以及八步如何串成一条「准备 → 执行 → 收尾」的流水线。

02 auth + systemUser + sessionInit:身份与交互式表单

深入前三步:密钥如何换 user_id、系统用户如何解析、sessionInit 如何用交互式表单确定 team/agent/task 这个关键三元组。

03 injection 策略:inject 注入 vs toolize 工具化

本章核心节:讲清 inject(稳定内容拼进 system prompt 命中 cache)与 toolize(易变内容作只读工具按需调用避免 cache 失效)的精细分工与性能权衡。

04 rateLimit + forward + extract:限流、转发与回写

讲清限流的 TPM/QPM 滑窗机制、转发如何清理与补回头部、extract 如何把对话回写成 skill 与 L0 喂给抽取 Pipeline。

05 存储抽象五后端降级链与 Credit 计费

讲清 ProxyStorage 的 cos/sqlite/fs/memory 五后端如何按优先级降级保可用,以及 Credit 计费如何基于 token 消耗上报。

子章节之间的逻辑关系

本章五节按八步管道的天然顺序展开,前三节是「准备段」、第四节跨「执行 + 收尾」、第五节是横切的存储与计费:

(准备段:0→4步)
┌──────────┐   ┌──────────────┐   ┌──────────────┐
│ 01 全景   │──▶│ 02 身份三连   │──▶│ 03 注入双策略 │   ★ 本章核心
│ 八步总览  │   │ auth/        │   │ inject vs    │
└──────────┘   │ sessionInit  │   │ toolize      │
               └──────────────┘   └──────────────┘
                                          │
                  (执行+收尾段:5→8步)        ▼
                                  ┌──────────────┐   ┌──────────────┐
                                  │ 04 限流转发回写│──▶│ 05 存储与计费 │
                                  │ rate/forward/ │   │ 五后端降级   │
                                  │ extract       │   │ Credit       │
                                  └──────────────┘   └──────────────┘
​

铺垫说明:本章是源码精读章,与第 9 章 SDK 四步法构成「代理接入 vs 代码接入」的对子——同样四件事(召回/捕获/工具/降级),代理层帮你做了,SDK 要你自己写。读完本章你会理解为什么对 Claude Code 这类成熟 Agent 推荐用代理、对自研 Agent 推荐用 SDK。建议结合本地源码对照阅读。

前置知识与后续延伸

前置知识:

• 第 2 章的控制流旅程(八步管道是其展开版)
• 第 3 章的装配机制(sessionInit 确定的 team/agent/task 是装配过滤的输入)
• 第 6 章的抽取 Pipeline(extract 步骤的下游消费者)与召回预算(injection 的判据)
• 第 7 章的 /v3/tools/call(toolize 策略的工具来源)
• 对 HTTP 代理、KV cache 有基本概念

本章为后续章节奠定的基础:

• 八步管道是第 10 章 Claude Code / CodeBuddy 接入实战的内部原理
• injection 双策略是第 9 章 SDK「注入两区块」的对标方案
• 存储降级与限流计费是第 12 章生产级运行(可观测/限流)的前置