ClaudeMap

Context Bridge Guide

自建 AI 应用的上下文工程中文手册:API 缓存、聊天压缩、记忆召回、API / Claude Code 切换,以及网页、手机、消息渠道共享同一段对话

教程与指南guidecontext engineeringprompt cachingmemorymulti-channel

context-bridge-guide(中文标题「让 AI 接得上话」)是一份整理自持续使用的个人 AI 应用的中文手册,覆盖让同一段对话跨设备、跨引擎保持连贯的上下文层:历史如何组织(分话题摘要、最近原话、备忘,以及字符估算与真实 token 为什么不能混算)、记忆怎样真正进入请求(写入来源、规则与事件分层、按问题相关召回、预取与查询对齐,以及「存了但没注入」的排查路径)、两种 Claude Code 路径怎样取舍(原生续会话需要补课水位;每轮独立的 CC 需要应用准备完整资料与明确的工具结论)、渠道怎样共享一次对话(可信身份映射、来源事件去重、完整回合次序)。七章正文、可离线运行的示例(Python 3.10+、只用标准库、不需要模型账号;payload 示例需显式加 --send 才联网)与测试。README 推荐与 Cheiineeey/api-where-it-breaks 搭配排查 API 接入问题,并注明参考文档查阅日期为 2026-11-14。

它做什么

  • 七章正文:整体架构、API 缓存、上下文压缩、记忆、API 与 Claude Code 切换、多渠道互通、验证观测与回退
  • 一张责任对照表,分清 prompt cache、聊天压缩、记忆系统、渠道/引擎适配各自「负责什么、不负责什么」
  • 两条 Claude Code 接入路径如实对比:原生续会话与每轮独立会话,两者都不会自动获得对方的状态
  • 先跑再信的离线示例:demo.py 演示网页提到约定、手机接着问、再换引擎;anthropic_payload.py 输出带缓存断点的请求;cc_command.py 只预览 claude -p 参数、不真正启动
  • 边界写在前面:没有「固定省钱比例」或「永不失忆」的承诺;教学替身都明确标注

什么时候用

适合自建 AI 应用时使用——需要同一段对话跨设备(网页、手机、消息桥接)跨引擎(Messages API 与 Claude Code)保持连贯;也适合在接入记忆与渠道适配前,向团队讲清 prompt cache 到底负责什么、不负责什么。

如何上手

五分钟离线体验——需要 Python 3.10+,只用标准库,不需要模型账号,不发起网络请求:

python3 examples/demo.py
python3 examples/anthropic_payload.py
python3 examples/cc_command.py
python3 -B -m unittest discover -s tests -v

demo.py 模拟网页提到一个约定、手机接着问、再换引擎;anthropic_payload.py 需显式加 --send 才会联网。

注意事项

README 自述的边界:离线示例的账本、摘要缓存与锁都在内存里,重启即失去状态;接入真实应用需要数据库持久化、可信的渠道身份映射、完整回合串行化与工具执行结果的幂等记录。示例里的「回复器」与「摘要器」是明确标注的教学替身;词命中检索不冒充向量检索;这些示例不能验证真实模型的记忆效果、缓存命中或网关兼容性。真实端点的缓存能力、计费口径与 CLI 参数以你实际使用的版本为准。MIT 许可。撰稿时 15 星(2026-11-15)。

代码仓库

yanke521/context-bridge-guide

收录日期

地图上的相关资源