Codex Turn Navigator

将完整回合时间树安装到官方 Codex 原始聊天中。当前安装包为 0.2.0，包含此前已实测的原生导航 v7 界面，不是早期的只读 JSONL 列表。

发布者为 ET08042，扩展标识为 ET08042.codex-turn-navigator。此前安装 local.codex-turn-navigator 的用户，请先执行“恢复官方原版”、卸载旧版并重载窗口，再安装此发布者的版本。

安装到另一台电脑

1. 在本机桌面 VS Code 安装官方 Codex（openai.chatgpt）26.1007.21434。版本不一致时，在官方扩展齿轮菜单选择“安装其他版本”。
2. 打开扩展面板的“…”菜单，选择“从 VSIX 安装”，安装 codex-turn-navigator-0.2.0.vsix。
3. 如 VS Code 提示重载，先重载一次；在通知中点击“启用时间树”，再点击“立即重载”。也可通过命令面板执行“Codex 回合时间树：启用 / 更新”。
4. 打开官方 Codex 本地聊天，时间树会出现在对话标题右侧。另一台电脑无需安装 Node.js、npm 或运行 PowerShell，也无需复制本项目或本机安装记录。

包含的全部原生功能

• 跟随当前聊天显示用户指令，读取历史索引及回答预览。
• 搜索指令；卡片显示本回合最多三行的灰色回答预览。
• 点击卡片调用官方历史加载与虚拟列表定位，跳转原始聊天。
• 跳转成功后自动收起；重新展开时定位并高亮上次点击的回合卡片。
• 默认位置跟随标题；可拖动标题栏，点击展开或折叠。
• 卡片不显示额外的原生悬停详情框。

拖动位置和选中回合保留在当前聊天组件内，不跨窗口重载保存。

管理与恢复

命令面板提供：

• Codex 回合时间树：启用 / 更新
• Codex 回合时间树：恢复官方原版
• Codex 回合时间树：查看状态

状态栏也可查看和管理启用状态。禁用或卸载管理扩展前，请先执行“恢复官方原版”并重载窗口；仅禁用或卸载不会撤销已写入的补丁。恢复原版后不会在下次启动自动装回。

安装器自动读取官方扩展的实际安装位置，在该资源旁保留 .ctn-original 原版备份；预览与安装记录存放在 VS Code 用户数据目录。可接管本项目之前手动安装的同一份 v7 补丁。已启用的选择跨重载保留；相同兼容资源被恢复或重装后会按该选择重新启用。

兼容性与边界

这是非官方资源补丁的管理扩展，启用时会备份并修改官方 Codex 的一个 Webview 脚本。仅支持 Codex 26.1007.21434 及已记录的资源 SHA-256；版本或文件内容不匹配时会明确报错并停止，不会强行适配。官方升级可能覆盖补丁，新版本需要重新适配。

已验证平台为 Windows x64 桌面 VS Code。扩展运行在本机 UI 扩展宿主；其他系统、VS Code Web、远程安装侧的官方资源尚未验证。不包含或分发官方 Codex 扩展本体，不读取凭据、不修改会话记录，不额外发送聊天请求。

开发打包

在项目根目录运行 scripts/Build-VSIX.ps1。运行时仅依赖 VS Code 自带的 Node.js。早期只读 TreeView 的 extension.js、session.js 保留在源码中，不再作为 VSIX 入口，也不与原生时间树重复展示。