ctx 实测:编码会话检索、引用与增量更新
用发布版 ctx 2.4.1 导入人工 Claude Code 和 Codex 原生记录,验证跨来源搜索、引用回读、稳定 ID、手动刷新及部分记录拒绝的返回语义。
AgentIndex · 发布于 2026-11-07 · 更新于 2026-11-07
ctx 面向已有编码智能体记录,提供搜索、原文回读和上下文定位。它与让模型重新总结记忆不同:读者需要确认搜索结果能否回到记录中的具体内容,更新是否可见,以及导入异常会怎样反馈。本文围绕 Claude Code 与 Codex 的历史检索流程实测。
发布版 2.4.1 完成了所测原生记录导入、跨来源词法搜索、会话与事件回读、重复导入 ID 稳定性和追加更新。也有两个需要调用方明确处理的边界:关闭刷新后,新追加内容在再次导入前不可见;导入有效内容同时拒绝一个坏行时,退出码可以是 0,JSON 却明确报告部分拒绝。
固定二进制与独立数据目录
2026 年 11 月 7 日,我们下载 GitHub 发布资产 ctx-macos-arm64 2.4.1,SHA-256 为 3876f1c197ac2a6dc74ae0020a4aa3a38dd3cf055c857142d9e4fddcfbd8593d,与发布资产 API 给出的摘要一致。对应源码标签为 v2.4.1,提交 33ba4645b620fd89d138c6db1fabf33096a0ee16,执行环境为 macOS 26.6.2。发布版本
本次没有扫描个人 ~/.claude 或 ~/.codex。我们为三个会话生成两种原生格式的人工 JSONL:两个 Claude 会话、一个 Codex 会话,涉及迁移回滚与页面布局两个不同主题。独立 CTX_DATA_ROOT 的配置持久设为手动索引,关闭自动来源发现、遥测、升级和语义检索;每次导入都显式指定来源目录并跳过 Blame。
复现脚本与原始 JSON 记录十八次命令调用。搜索与回读由真实发布二进制和本地索引执行,没有用假搜索响应或模型输出代替。
| 流程 | 实测结果 |
|---|---|
| 两种原生来源导入 | Claude 与 Codex 内容均进入索引 |
| 查询迁移与回滚 | 同一结果集包含两种来源的相关会话 |
| provider/workspace 过滤 | 返回所选来源及工作区范围内结果 |
| 事件与会话回读 | 读回完整人工文本及中文,包含事件引用 |
locate event | 返回 Core 来源标识、provider 会话标识与格式信息 |
| 重复导入同一记录 | 选定结果未重复,事件及会话 ID 保持一致 |
| 追加与手动刷新 | 刷新关闭时查不到新增词,增量导入后可检索 |
| 混入一个坏 JSON 行 | 有效内容仍可搜索,JSON 报告一个拒绝,退出码为 0 |
这些小语料检查没有建立真实工作记录的召回率、中文搜索质量或任何倍数的 token 节省。
原生记录有目录与身份约束
ctx 不只是对任意 JSON 文件做全文搜索。所测原生来源要求目录根,Claude 会话文件名需要与记录中的会话身份一致;不符合所接纳形式的输入会被拒绝。准备过程中,我们先修正了人工目录和身份映射,再把有效来源交给最终脚本,没有放松这些检查。Claude 来源路径实现
macOS 的 /tmp 还是 /private/tmp 的别名。本次使用规范化真实路径,避免把路径别名触发的来源拒绝误写成内容解析故障。复现脚本会先解析路径。
手动索引也不等于导入完全没有工作进程。显式导入仍通过有限期 Core 工作进程发布索引;关闭的是持续自动跟踪。最终脚本同时把模式写进该独立目录的配置,避免父子进程读取到不同的默认设置。配置实现
检索结果必须能够继续回读
对人工唯一词的查询返回一个会话结果,带事件 ID、会话 ID、片段和引用。我们用这个事件 ID 运行 show event,连同一条上下文窗口读取;再用会话 ID 读取会话,两者都保留预期内容和中文。
跨来源查询包含 Claude 与 Codex,而来源过滤只保留 Codex。另一个工作区的布局会话没有混入所测迁移查询范围。这验证了选定检索和过滤路径;它没有证明所有来源格式、子智能体关系或目录过滤组合都可靠。
需要区分引用身份和原始路径:本次 locate event 返回稳定的 Core 来源 ID、原生会话 ID 和格式,没有返回原始 JSONL 文件路径。因此,本篇不把定位能力描述成任意结果都可直接跳到物理文件某一行。查询与来源约束
追加内容的可见性是显式选择
重复导入相同输入后,选定命中仍只有一个,事件和会话 ID 没有变化。我们还核对了输入文件哈希,导入及搜索没有改写人工来源。
随后向已有 Claude 记录追加一条消息。采用 --refresh off 搜索时,新标记没有命中;执行显式增量导入后,新的独立命令能搜到它。这验证了手动模式下的发布边界,不代表实时自动跟踪已测试,也不代表仅调用 search 就一定检查了所有变化。
需要快速读取一个已发布快照时,关闭刷新有明确用途;需要刚产生的记录时,应明确安排导入或选择合适的刷新策略。自动化需要同时理解“查到的内容是什么”和“这份索引更新到了哪里”。
部分拒绝不能只看退出码
在有效会话末尾加入一行人工损坏的 JSON 后,导入保留了可用内容,之后仍可检索原来的标记。报告的 outcome 为 completed_with_rejections,current_rejected_records 为 1,包含行号与错误分类,但进程退出码是 0。
这是所测部分成功的返回语义,不应擅自当作整个工具失败,也不能等同“每条记录均导入成功”。依赖零退出码就继续处理的流水线,应另外检查结果中的 outcome 和拒绝计数,决定是否需要人工检查。
人工文本中还放入了明确标注为假的 token 样式字符串。事件回读保留了它。ctx 的原文检索不自动等同脱敏;分享回读内容前,仍要自己确认其中包含什么。本次没有真实凭据,也没有启用远程共享或外部语义执行器。
选型判断
如果经常需要找回编码会话中的决策、失败尝试和原文证据,ctx 值得用一份可控的历史副本试用。先确定原生来源目录,记录索引模式,核查 search 到 show 的完整链路,并处理部分拒绝。
本篇没有评测语义模型、所有 provider、Blame 代码归因、代码图、Sift 压缩、持续 daemon、托管分享或其他操作系统,也没有复现 README 的速度与 token 倍数。需要编辑整理成文的知识库,而非搜索既有会话,可看 OpenKnowledge 实测;需要测量网页问题并保留可回查的报告,可看 WebPerf Snippets 实测。