2026年7月16日 周四晚上19:30,报名腾讯会议了解“如何构建自进化的动态知识库(Brain)”(限30人)
免费POC, 零成本试错
FDE知识库

FDE知识库

学习大模型的前沿技术与行业落地应用


收藏

让所有 AI Agent 共享上下文:一个开源 Skill解决多工具记忆断裂

发布日期:2026-07-10 21:01:12 浏览次数: 1525
作者:九歌AI

微信搜一搜,关注“九歌AI”

推荐语

cross-tool-chat-indexer开源Skill,解决多AI工具间的记忆断裂问题,让上下文无缝衔接。

核心内容:
1. 多工具记忆断裂的三大痛点
2. 统一索引不同格式的本地对话记录
3. 实现项目级上下文精准召回

杨芳贤
53AI创始人/腾讯云(TVP)最具价值专家


QUOTE

搜索只是手段,让 AI 的记忆连续不断裂,才是目的。

—— 九歌

大家好,我是九歌。

今天跟大家分享一个我自己开发的开源Skill——cross-tool-chat-indexer

说起来也是被逼出来的:我同时用 Codex、Claude Code 和 WorkBuddy 三个 AI 编码助手,每次换工具或开新对话,AI 就跟失忆了一样,之前聊的全忘了。

本文看点

01

三工具记忆各自为政,上下文反复断裂

02

项目级上下文召回:开新对话前把记忆续上

03

中文按字分词,跨工具精准命中本地记录

01

THE PROBLEM

AI 助手最大的问题,不是不够聪明,是太健忘

你有没有过这种经历?

上周在 Codex 里跟 AI 讨论了一个项目的架构方案——选 PostgreSQL 而不是 MongoDB 的理由、踩过的连接池坑、最终定的分表策略。这周打开 Claude Code 想继续做这个项目,结果——AI 把你当陌生人

你得从头再说一遍背景,重新解释一遍约束条件,重新喂一遍上周已经聊过的上下文。它不是不想帮你,它真的不记得了。

更要命的是,你可能连“上次聊过”这件事本身都忘了。工具一多,时间一长,那段对话就像从没发生过。

问题不是 AI 不够聪明,而是你和 AI 之间的上下文,一直在断裂

上下文断裂发生在三个层面

工具间断裂

Codex 里聊的,Claude Code 不知道;WorkBuddy 里做的,Codex 看不到。三个工具各自封闭,记忆互不相通。

会话间断裂

同一个工具里,开一个新对话就是一张白纸。上周的架构决策、踩坑记录、技术选型,全部清零。

你自己的脑断裂

你也记不清“上次在哪聊的、聊了什么”。工具一多,时间一长,连找回的线索都断了。

这三层断裂叠起来,就是AI 编码助手最大的效率黑洞

02

THE LANDSCAPE

三个工具,三种格式,记忆各自为政

如果你同时是 Codex、Claude Code 和 WorkBuddy 的用户,下面的情况应该很熟悉:

Codex 把对话存在 ~/.codex/sessions/ 下的 jsonl 文件里,每次会话一个 rollout 文件。

Claude Code 也用 jsonl,但路径在 ~/.claude/projects/ 下,按项目目录分文件夹。

WorkBuddy 更特殊——会话元信息在本地 SQLite 里,但聊天正文在腾讯云端,本机只有标题和工作目录。

三种格式,三套路径,三种数据结构。每个工具都在忠实地记录你和 AI 的交互,但这些记忆彼此隔离,就像三个各自为政的“电子牛马”,谁也不理谁。

这正是 cross-tool-chat-indexer 要解决的问题——不是做一个更好的搜索框,而是建一座桥,把断裂的上下文重新连起来。

03

HOW IT WORKS

一个 Skill,重建你的 AI 记忆

cross-tool-chat-indexer 是一个开源 Skill,符合标准目录结构。核心目标不是“搜得快”,而是让你的 AI 编码助手拥有跨工具、跨会话的连续记忆

实现起来分三步,每个步骤对应一条命令:

STEP 01统一索引——把散落的记忆收回来
...bash

python scripts/indexer.py index --source all

一条命令,三个工具的历史全部抽取、归一化、写入 FTS5 全文索引。从此 Codex、Claude Code、WorkBuddy 的历史不再各自为政,汇入同一个记忆库。

STEP 02跨工具检索——想找什么,一条命令搞定
...bash

python scripts/indexer.py search "wireguard 配置"

不用管当初在哪个工具里聊的,直接搜。结果标注来源,附带原始文件路径。搜索是手段——真正帮你省掉的,是“翻三个工具找一段对话”的时间。

STEP 03项目级上下文召回——这才是核心,也是最实用的部分
...bash

python scripts/indexer.py recall "D:/3D汽车/enginecar" --top 5

给一个项目目录,自动找出所有相关历史对话,压缩成精简卡片,直接贴进新对话的 system prompt。

这一步是整个 Skill 最有价值的部分。不是搜索,是记忆的延续。

04

RECALL

为什么“项目级上下文召回”最实用

如果说搜索是“找回一段话”,那 recall 是“找回一个项目的完整记忆”。开了一个新对话,AI 把你当陌生人——你上周讨论过的架构设计、踩过的坑、最终选的技术方案,全部清零。cross-tool-chat-indexer 的 recall 命令就是来终结这个循环的。

1

路径侧:把项目目录拆成 token,跟每条历史记录的 cwd(工作目录)做匹配打分,项目名命中权重最高。

2

内容侧:用项目名 + 顶层文件名(README、package.json 之类的)在全文索引里查相关记录。

3

合并排序:两边分数加起来取 top N 条。

4

压缩输出:压成「意图 + 关键问答」的精简卡片,支持 --format md 直接输出 Markdown。

开新对话前跑一次 recall,把输出贴进 system prompt——AI 就能“想起来”之前在这个项目上做过什么。选了什么技术栈、踩过什么坑、做了哪些决策、上次停在哪里。不是从零开始,而是从上次结束的地方继续。

05

SEARCH

中文搜索这件事,比你想的坑多

“找回记忆”的前提是能搜到。但如果你用过 SQLite FTS5 的默认配置,你就会知道——中文搜索默认是坏的

原因在于 FTS5 默认分词器 unicode61 会把连续中文当成一个整体 token。比如对话里有“淘宝排名优化方案”,整个被当成一个词,你搜“淘宝”根本搜不到——因为它不是一个独立的 token。cross-tool-chat-indexer 的解决方案:在每个汉字之间插空格,强制按字分词。

“淘宝排名优化方案” → “淘 宝 排 名 优 化 方 案”。unicode61 按单字建索引,搜“淘”能命中,搜“淘宝”也能命中。同时还建了一张 trigram 索引表兜底——按三字符滑窗切分,对子串匹配更精准。两张表并集检索,中文单字、双字、长词、中英混合都能搞定。

实测结果

搜索词
命中情况
“淘”
✅ 命中(单字生效)
“淘宝”
✅ 命中 WorkBuddy 淘宝排名会话
"wireguard"
✅ 命中 Codex K3S/WireGuard 配置会话
“wireguard 配置”
✅ 中英混合,OR 语义正常
“K3S”
✅ 跨源命中 Codex + Claude Code

中文开发者的记忆检索,不再有语言障碍。

06

PIPELINE

四阶段流水线:大白话讲技术原理

如果你好奇它底层怎么实现“记忆连续”的,这里用大白话讲一遍。整个流程分四层:

1

抽取:三个工具各写一个解析器,Codex 读 jsonl 事件流,Claude Code 读项目目录下的 jsonl,WorkBuddy 读本地 SQLite 元信息 + AI 生成的文件。每条记录额外记录 cwd(工作目录),这是做项目级召回的关键。

2

归一化:三个来源格式各不相同,统一成同一张表。不管记忆从哪来,进了这张表都是同一种格式。三份独立记忆,合并成一份完整记忆。

3

存储:写入 SQLite FTS5,建两张虚拟表 fts_unicode(unicode61 分词 + 中文按字分词)和 fts_trigram(trigram 分词器,擅长子串匹配)。两张表并集检索。

4

检索与召回:查询时先做特殊字符处理,再同时在两张 FTS 表里搜,结果取并集。recall 命令额外做路径匹配 + 内容匹配 + 合并排序 + 压缩输出。

07

BOUNDARIES

说句实话:能做什么,不能做什么

✅ 它能做的

统一记忆

三个工具的本地记录统一成一份连续记忆,跨工具检索不用分别翻找。

中文检索

中文关键词 / 子串检索(单字、双字、长词、中英混合都行)。

项目召回

按项目目录召回历史上下文,压缩后注入新对话——终结“开新对话就失忆”循环。

增量索引

新增对话后重跑即可,记忆只增不减。

零依赖

只用 Python 标准库,不需要 pip install 任何东西。

❌ 它做不到的

1

WorkBuddy 聊天正文不在召回范围:内容在腾讯云端,本机只有标题和生成物文件。不是 bug,是数据可得性的客观限制。

2

多词查询是 OR 语义不是 AND:搜“wireguard 配置”会召回包含任一词的记录。需要 AND 精排得自己后处理。

3

是关键词检索不是语义向量检索:能精确找到包含某词的对话,但找不到“意思相近但没出现这个词”的对话。需要语义相似度的得额外接 embedding 层。

知道边界在哪,才能用对地方。

08

DATA

真实数据:拿本机跑出来的

不是 demo 数据,是我自己机器上的真实会话:

指标
数值
总索引记录数
25,323 条
独立会话数
466 个
索引库大小
190 MB
Codex 记录
22,405 条
Claude Code 记录
2,733 条
WorkBuddy 记录
185 条

增量索引也验证了:从零重建 25,323 条,立即再跑一次,还是 25,323 条。第三次再跑,依然 25,323 条。不重复、不丢失,稳定。

466 个会话的记忆,从此连续不断裂。

09

INSTALL

安装使用:三个工具都能用

cross-tool-chat-indexer 符合标准技能目录结构,零依赖,纯 Python 标准库实现。话不多说,直接上干货。

GitHub 地址(cross-tool-chat-indexer 子 skill):https://github.com/JiugeLi/JiugeSkills/tree/main/cross-tool-chat-indexer

STEP 01获取代码
...bash

git clone https://github.com/JiugeLi/JiugeSkills.git

STEP 02安装到你的 AI 编码工具

安装到 WorkBuddy:

cp -r JiugeSkills/cross-tool-chat-indexer ~/.workbuddy/skills/

安装后 WorkBuddy 自动识别 SKILL.md,对话中提到“搜索之前的对话”等需求时自动调用脚本,无需手动输入命令。

安装到 Codex:

cp -r JiugeSkills/cross-tool-chat-indexer ~/.codex/skills/

如果 Codex 版本不支持自动 skill 调用,也可以直接手动运行:

python ~/.codex/skills/cross-tool-chat-indexer/scripts/indexer.py index --source all

python ~/.codex/skills/cross-tool-chat-indexer/scripts/indexer.py search "wireguard"

安装到 Claude Code:

cp -r JiugeSkills/cross-tool-chat-indexer ~/.claude/skills/

Claude Code 读取到 SKILL.md 后自动加载,对话中出现“之前怎么配的”等意图时自动调用。

STEP 03构建索引

python cross-tool-chat-indexer/scripts/indexer.py index --source all

一条命令三个工具全搞定。之后新增对话后重跑一次即可(增量 upsert,不会丢旧数据)——你的 AI 记忆库只增不减。

前提条件与隐私

前提条件:你机器上有 Python 3(建议 3.10+),不需要装任何第三方包。

隐私说明:索引只读本地文件,不修改源数据,不联网。索引库建在 data/memory.db,随时可删了重建。不读取 Codex 遥测日志、WorkBuddy 的 secret:// 配置和各工具缓存目录,检索结果不含凭据。

THE END

总结一下

AI 编码助手越来越强,但共同的硬伤是没有连续的记忆。换工具记忆断了,开新对话上下文清零。你和 AI 花了半小时讨论出的架构方案、踩坑经验——下次见面全忘了。

cross-tool-chat-indexer 做的事情,本质上是给 AI 编码助手装一个“外置记忆体”:三个工具里散落的对话统一收进来,按项目归类,需要的时候自动召回,压缩后注入新对话。

搜索只是手段。让上下文连续不断裂,让 AI 不再每次从零开始,才是这个 Skill 真正想解决的问题。

不是让 AI 更聪明,而是让 AI 不再健忘。

如果你也是多工具用户,被“开新对话就失忆”折磨过——赶紧动手试试吧!有什么问题评论区留言,我们一起交流。

开源,零依赖,一条命令开始。

GitHub 地址(cross-tool-chat-indexer 子 skill):https://github.com/JiugeLi/JiugeSkills/tree/main/cross-tool-chat-indexer

END

我是九歌,平时专注于 AI 编码工具与效率实践。


53AI,企业落地大模型首选服务商

产品:场景落地咨询+大模型应用平台+行业解决方案

承诺:免费POC验证,效果达标后再合作。零风险落地应用大模型,已交付160+中大型企业

联系我们

售前咨询
186 6662 7370
预约演示
185 8882 0121

微信扫码

添加专属顾问

回到顶部

加载中...

扫码咨询

扫码登录
登录即表示您同意《53AI网站服务协议》
服务协议

欢迎您使用【53AI 官方网站】(以下简称“本网站”或“我们”)。本《会员服务协议》(以下简称“本协议”)是您(以下简称“会员”或“用户”)与【深圳市博思协创网络科技有限公司】之间关于注册、登录及使用本网站会员服务所订立的法律协议。

在您注册或登录前,请务必审慎阅读、充分理解各条款内容,特别是免除或限制责任的条款、知识产权条款、争议解决条款等。此类条款将以加粗形式提示您注意。 当您通过微信公众号授权、手机验证码验证或其他方式成功登录本网站时,即视为您已完全理解并同意接受本协议的全部内容。

一、 定义

本网站:指由【深圳市博思协创网络科技有限公司】运营的,域名为【53ai.com】的网站及相关移动端页面。

会员服务:指本网站向注册会员提供的知识库文章查阅、内容检索及其他相关增值服务。

知识库内容:指本网站发布的包括但不限于文字、图表、数据、研究报告、行业分析等数字化内容资源。

二、 账号注册与登录

登录方式:本网站支持以下登录方式,您可根据实际情况选择:

微信公众号授权登录:您同意将您的微信OpenID信息授权给本网站,用于创建或关联会员账号。

手机验证码登录:您需提供真实有效的手机号码,并通过短信验证码完成身份验证与登录/注册。

账号安全:您的账号仅限您本人使用,禁止赠与、借用、租用、转让或售卖。因您保管不善导致的账号被盗、密码泄露等损失,由您自行承担。

实名认证:根据相关法律法规要求,我们可能要求您在特定功能下完成实名认证。如您拒绝提供,可能无法使用部分或全部服务。

未成年人保护:若您未满18周岁,请在法定监护人的陪同下阅读本协议,并在征得监护人同意后使用本服务。

三、 服务内容与规范

知识库查阅权限:会员登录后,有权按照其会员等级对应的权限范围,在线浏览、检索本网站知识库中的相关文章及内容。

服务变更:我们有权根据业务发展需要,调整、变更或终止部分服务内容,并将以网站公告、公众号消息等方式提前通知。

禁止行为:您在使用服务时不得实施以下行为:

利用技术手段批量爬取、下载、转存知识库内容;

将知识库内容用于商业目的或未经授权地向第三方传播;

干扰本网站正常运行或侵犯其他用户合法权益;

发布违法违规信息或从事违反公序良俗的活动。

四、 知识产权声明

权利归属:本网站知识库中的排版设计、软件代码等内容的知识产权均归【公司全称】或原权利人所有,受《中华人民共和国著作权法》等法律保护。

有限许可:本网站授予会员一项非独占、不可转让、不可转授权的普通许可,仅限于个人学习、研究之目的在线查阅知识库内容。

侵权追责:未经书面许可,任何单位或个人不得以任何形式复制、转载、摘编、镜像、汇编或以其他方式使用上述内容。一经发现,我们保留追究其法律责任的权利。

五、 个人信息保护

我们重视对您个人信息的保护。关于我们如何收集、使用、存储和保护您的个人信息,请单独阅读 《隐私政策》。

您通过微信公众号授权或手机号验证所提供的信息,我们将严格按照《个人信息保护法》的规定处理,仅用于身份识别、服务提供及安全验证等必要用途。

您可以随时通过网站设置或联系客服行使查阅、更正、删除个人信息及撤回授权同意的权利。

六、 免责声明

内容准确性:知识库内容仅供参考,不构成专业建议。我们不对其完整性、准确性、时效性作任何明示或暗示的保证,您应自行判断并承担使用风险。

不可抗力:因自然灾害、政策法规变化、网络故障、第三方平台接口异常(如微信接口维护、运营商短信通道故障)等不可抗力导致的服务中断或延迟,我们不承担违约责任。

第三方链接:本网站可能包含指向第三方网站的链接,该等网站的内容和服务不受我们控制,请您自行甄别风险。

七、 违约责任

如您违反本协议约定,我们有权视情节采取警告、限制功能、暂停服务、注销账号等措施,并保留要求赔偿损失的权利。

如因您的违约行为导致我们遭受行政处罚、第三方索赔或商誉损失,您应承担全部赔偿责任(包括但不限于罚款、赔偿金、律师费、公证费等)。

八、 法律适用与争议解决

本协议的订立、执行和解释均适用中华人民共和国大陆地区法律。

因本协议产生的或与本协议有关的任何争议,双方应友好协商解决;协商不成的,任何一方均可向【公司所在地】有管辖权的人民法院提起诉讼。

九、 其他

本协议构成双方就本服务达成的完整协议,取代此前任何口头或书面约定。

本协议任一条款被认定为无效或不可执行的,不影响其他条款的效力。

我们对本协议享有最终解释权,并在法律允许的范围内保留随时修改的权利。修改后的协议一经公布即生效,继续使用服务即视为同意修订内容。


已查阅