故障排查
Contextify 已经打开，但某个项目或对话不见了。
历史记录缺失的情况，大多可以归结为以下四种原因之一：还没有受支持的对话记录，应用无法读取对话记录文件夹，对话记录仍在建立索引，或者你查看的项目标识与预期不同。
快速检查
-
确认会话确实存在
Contextify 会为 Claude Code 和 Codex CLI 会话建立索引。如果你还没在这个项目中使用过其中任一工具，请先开启一个简短的会话。
-
给应用一点时间
新会话先由 AI 助手工具写入，再由 Contextify 检测并建立索引。刚刚产生的活动可能不会立即出现，已有的大量历史记录也需要更长时间。
-
检查应用权限
沙盒化的 App Store 版本需要读取对话记录文件夹的权限。应用请求访问时，请授权访问它指定的文件夹。
-
搜索一个有辨识度的词
使用会话中出现过的文件名、错误字符串、任务 ID、分支名或不常见的短语。泛泛的搜索更难验证。
常见症状及其含义
| 症状 | 可能原因 | 下一步 |
|---|---|---|
| 应用中没有任何项目。 | 尚未发现受支持的会话，或者对话记录访问受阻。 | 在某个项目中运行 Claude Code 或 Codex；如果仍然没有任何内容，再检查权限。 |
| 项目出现了，但缺少一个最近的对话。 | 对话记录可能仍在写入或建立索引。 | 给 Contextify 1 分钟时间，然后搜索新会话中一个有辨识度的短语。 |
| 搜索找不到某个已知的结果。 | 查询可能与分词后的文本不匹配，带标点的标识符尤其如此。 | 减少搜索词、去掉标点，或者搜索附近的一个短语。 |
| Cloud 显示旧数据，但这台 Mac 上没有。 | 云同步和本地索引是两项相互独立的检查。 | 先确认本地应用能看到该项目，再检查云同步状态。 |
CLI 检查
如果已经安装了 CLI，它可以帮你区分“应用界面是空的”和“数据库里没有已索引的历史记录”这两种情况。
contextify status --json
contextify search "distinctive phrase from your session"
如果找不到 contextify，请打开 Contextify 的“Settings → CLI”（CLI 设置页），点击“Enable”（启用）；如果出现“Repair”（修复），则点击它。
想深入了解本地处理过程，请阅读 导入与同步。
何时联系支持
如果你能在磁盘上找到 Claude Code 或 Codex 的实际对话记录，Contextify 也有该文件夹的访问权限，但重新启动应用后项目仍未出现，请联系支持团队（英文）。
请提供 macOS 版本、你安装的是 DMG 版还是 App Store 版、所用的 AI 助手工具，以及“Settings”（设置）中显示的任何 Cloud 状态消息。
最后更新：2026 年 5 月 6 日