ThreadRelink 是一个本地 VS Code 扩展，全部操作都可以通过侧边栏、右键菜单和 VS Code 命令面板完成。项目文件夹改名或移动后，它仍然可以把原来的 Codex 对话连接到这个项目。Codex 会记录对话开始时的工作目录。例如把 toolspec 改成 finspec 后，按路径筛选的恢复列表可能不再显示旧对话，但聊天文件实际上仍在本机。ThreadRelink 给项目分配一个不随路径变化的本地 UUID，记录新旧路径，并从新目录继续原线程。
| ThreadRelink | 具体内容 |
|---|---|
| 读取 | Codex 列表元数据、项目身份、本地路径、Git remote 和 commit 信息 |
| 写入 | 项目 UUID 和 ~/.threadrelink/registry.json |
| 绝不会 | 上传数据、提供遥测、写入 ~/.codex、修改 Codex 数据库或 transcript、复制完整消息正文 |
没有明确设置项目并授权前，ThreadRelink 不会扫描对话元数据。registry version 1 会在下次更新时自动迁移到 version 2。写入 version 2 后，ThreadRelink 0.4 可能无法继续读取，因此不建议降级。
ThreadRelink 只在本机运行，没有遥测或网络服务。它通过本地 Codex app-server 读取 Codex 对话元数据，并在 ~/.threadrelink 中保存少量项目和对话索引。请勿在公开 Issue 中附加 registry.json、Codex transcript 或未脱敏的绝对路径。如果你认为发现了安全漏洞，请使用GitHub 私密漏洞报告，不要创建公开 Issue。
欢迎提交 Issue 和 Pull Request：
- Issue 可用于反馈可复现的 Bug、功能建议和使用体验；提交前请先搜索已有 Issue；
- 截图和诊断信息必须移除绝对路径，绝不要上传 ThreadRelink registry 或 Codex transcript；
- Pull Request 应保持聚焦，说明对用户的影响，更新相关测试或文档，并在提交前运行
pnpm check。