Total Recall

让 AI 助手找到你已经做过的工作

你在 Claude Code 和 Codex 中的当前会话可以搜索每一个过往会话,让决策、代码模式和解决方案成为可检索的上下文。Total Recall 不是搜索框;AI 助手会在处理当前任务时调取所需内容。

问题跟踪工具记录有哪些工作项。Total Recall(跨会话历史检索)帮你找回决策背后的原因,以及工作推进的过程。

何时使用

找回决策

问问某个设计为什么改了、当时接受了什么取舍,或者某个 bug 最早是在哪里诊断出来的。

接续之前的工作

重新打开某个分支或 issue 之前,先让 AI 助手找出最近一次有用的上下文。

复用解决方案

问问你以前在这个项目或其他项目里是怎么解决类似问题的,不用再从头摸索一遍。

好的提示词

与其这样问 不如试试
“搜一下以前的对话。” “用 Total Recall 找找我们在哪里讨论过托管版 Cloud 的登录交接。”
“文档那边怎么样了?” “用 Total Recall 找出公开文档信息架构(IA)的规划对话。”
“找一下那个构建错误。” “用 Total Recall 搜索我们在 CloudSettingsView 里修复的那个 Swift 6 警告。”

工作原理

Total Recall 依赖 Contextify CLI。AI 助手的技能调用 CLI,再由 CLI 搜索 Contextify 数据库。

Total Recall 只能找到 Contextify 已在本地建立索引的会话。如果找不到某个新对话,先等应用处理完毕,或者先运行 CLI 导入。

哪些数据留在本地、哪些可以同步,以及 Cloud 如何影响数据流向,请参阅隐私与数据和导入与同步。

配置 AI 助手

Total Recall 通过 Contextify CLI 运行,AI 助手调用的技能也由 CLI 安装。安装方法取决于你运行 Contextify 的方式,请选择对应的方式:

1. 配置 CLI 和技能

安装 Contextify 应用时已完成配置,这里无需额外安装。直接跳到下方的确认可以正常使用。如果技能缺失,可前往 Settings → CLI → Enable 或 Repair 修复。

App Store 版本运行在沙盒中,无法自行安装 CLI,所以请用 Homebrew 安装 CLI,再添加技能:

brew install PeterPym/contextify/contextify-query
contextify install-plugin

先安装 CLI,再添加技能:

curl -fsSL https://contextify.sh/install.sh | sh
contextify install-skill

2. 确认可以正常使用

新开一个 Claude Code 或 Codex 会话,输入 /total。如果输入时 AI 助手提示补全 total-recall,说明技能已安装就绪。找一件之前做过的事问问它,看看实际效果:

Use Total Recall to find how we fixed the last deploy failure.

理想的回复会说明它执行了什么搜索,并给出之前已索引会话中的具体上下文。

3. 如果没有自动补全

确认 CLI 已在 PATH 中:

contextify --version

如果没有显示版本号,或出现“command not found”错误,说明上述安装尚未完成;请按你的使用方式重新安装。如果显示版本号,CLI 就已正常安装,只需按对应 AI 助手的步骤注册技能:

重新启动 Claude Code,然后再次输入 /total

退出并重新打开 Claude Code,让它重新加载技能。如果还有其他 Claude Code 进程在运行,只关闭一个终端窗格可能不够。技能位于 ~/.claude/skills/total-recall/SKILL.md。

仍未解决 可能原因 解决方法
Claude 不知道有 Total Recall。 缺少技能,或者没有重新启动 Claude。 按上面对应你使用方式的步骤重新安装,然后彻底重新启动 Claude Code。
技能能运行,但搜索提示找不到数据库。 Contextify 尚未创建或找到本地数据库。 先打开一次 Contextify,然后运行 contextify status。
结果太宽泛。 查询太笼统。 用任务 ID、文件名、分支名、报错原文或少见的措辞来搜索。

确认 Codex 会加载技能,然后重新启动 Codex

只有启用技能后,Codex 才会显示 Total Recall。在 codex --help 中查看你所用版本启用技能的参数,启用技能后启动 Codex,然后再次输入 /total。

Contextify 会把技能复制到 Codex 读取的两个位置(Codex 会忽略符号链接形式的技能目录):

$CODEX_HOME/skills/total-recall/SKILL.md
~/.agents/skills/total-recall/SKILL.md

如果 contextify doctor 显示这些文件都已就位,但技能仍未出现,请先再重新启动一次 Codex,然后再考虑重新安装。

技能正常工作后,Claude Code 和较新版本的 Codex 还可以使用随附的 contextify-researcher 智能体,执行范围更广的多查询搜索。

最后更新:2026 年 5 月 31 日