Codex 会话体检与专项修复Codex Provider Sync 诊断扫描与 Repair 实战教程【免费下载链接】codex-provider-syncSynchronize Codex session provider metadata across rollout files and SQLite state.项目地址: https://gitcode.com/gh_mirrors/co/codex-provider-syncCodex Provider Sync是一个用于同步 Codex 会话 Provider 元数据rollout 会话文件与 SQLite 索引的本地工具。本文带你用它的诊断扫描diagnostics给会话数据做一次体检再用 4 个专项修复Repair targets精准处理模型、工作目录、用户消息标记等元数据不一致问题——全程只读检查、备份保护聊天正文与凭据绝不进入报告。 为什么会话数据需要体检Codex 的会话状态分散在三处config.toml的当前 Provider、sessions/下的 rollout 会话文件、以及 SQLite 状态库的索引。日常同步只保证首行 Provider 信息与配置一致而模型名、会话目录cwd、用户消息标记这类字段同步不会顺手修改它们。当历史会话的元数据和当前环境对不上时你可能需要一次主动的Codex 诊断扫描。它和日常同步的关系可以概括为操作是否修改数据触发方式日常 Provider 同步是仅 Provider 元数据自动/手动诊断扫描diagnostics❌ 完全只读仅手动触发专项修复repair是仅限所选目标手动选择 预览确认 关键点进入诊断页面、同步失败都不会自动触发扫描更不会自动应用修复。 快速开始运行一次 Codex 会话体检两种方式任选CLI 一行命令详见 docs/README_CLI_ZH.mdcodex-provider diagnostics桌面/Web 界面打开高级功能页点击运行扫描页面会展示扫描进度完成后按运行环境 / 存储 / Provider / 问题计数 / 安全状态五个分区呈现结果。诊断扫描会做哪些检查运行时与存储检查Codex Home、SQLite Home 是否找到、数据库是否可读、当前 Provider 在 rollout 文件与 SQLite 中的分布是否一致问题计数注意⚠️计数 ≠ 损坏模型差异历史会话选了不同模型可能完全正常encrypted_content文件数仅表示检测到该字段不表示无法解密或数据损坏工作区待调整项、cwd 待修复行数、用户消息标记缺失数历史完整性只读检查historyIntegrity受限读取 JSONL 流检查 UTF-8、JSON 格式与根级数字序号的重复/倒退只输出计数与有界行号不保存任何正文。结果界面还会明确标注扫描未完成/上次结果已过期等状态避免把旧数据当成当前健康度。实现入口见 DiagnosticsPage.tsx、HistoryIntegrityPanel.tsx。 4 个专项修复目标选对才修对扫描发现的计数只有对应上修复目标时才需要动手。项目内置 4 个 Repair targets定义见 RepairControls.tsx目标实际作用适用症状models将历史模型名称调整到 config 当前根模型切换模型后希望统一历史模型cwd按会话文件记录修正索引中的会话目录不移动文件索引里工作目录与实际不符userEvent补全索引中已有用户消息的标记不增删消息用户消息标记缺失workspaceRoots整理全存储配置的工作区设置自动包含cwd工作区设置需要统一整理在桌面端诊断结果下方会出现本次检查可处理的项目卡片例如N 行 cwd 待修复点击查看修复会直接展开对应勾选项。CLI 则直接指定逗号分隔的目标codex-provider repair cwd,userEvent执行流程预览 → 确认 → 应用勾选目标后先Prepare预览计划最多展示 100 条 before/after 摘要只含会话 ID 与目标字段不回显路径或正文确认Apply时才真正写入写入发生在 Home 锁内默认先创建受管备份保留 2 份位于Codex Home/backups_state/provider-sync/修复结束会返回verification 核验verified / remaining / unavailable若仍有剩余差异会形成 partial 结果可再次修复收敛或用既有备份恢复。还可以只针对部分会话修复prepareRepair支持传入 1100 个原生会话 ID 作为范围见 docs/adr/0021-scoped-advanced-repair-and-readonly-integrity.md但选择workspaceRoots时不允许指定会话子集避免用局部目录覆盖全局工作区设置。如上图所示概览页会直接把待修复字段如 user-event、cwd 计数以提示条形式展示点进高级功能页即可完成扫描与修复闭环。⚠️ 注意事项安全边界与常见问题它不做什么不修复会话记录序号ordinal、不重建 Codex 历史显示索引、不修改加密内容、不删除项目目录——这些能力被明确排除见 docs/adr/0019-everyday-sync-and-advanced-repair.md结果会过期任何写操作成功后旧的诊断结果自动标记为过期需重新扫描防止拿历史快照做决策失败要看结果而非退出码CLI 建议加--json部分完成退出码为 3查看失败阶段、备份与重试建议详见 错误码合同占用中的会话会被跳过结束正在写入的会话后重试只处理仍未对齐的目标撤销用操作输出里给出的受管备份 ID 执行codex-provider restore BACKUP_ID即可。需要本地源码对照时可克隆仓库https://gitcode.com/gh_mirrors/co/codex-provider-sync后重点阅读诊断页 UIpackages/app-ui/src/features/diagnostics/核心诊断逻辑packages/core/src/application/diagnostics.js专项修复目标packages/core/src/application/repair.js分层设计决策docs/adr/0019-everyday-sync-and-advanced-repair.md、docs/adr/0021-scoped-advanced-repair-and-readonly-integrity.md小结日常同步保持轻量只在明确出现元数据不一致时用一次只读诊断扫描定位问题再按目标勾选专项修复并确认预览。记住计数只是提示、修复需经预览、备份随时可回三句话就能安心使用这套 Codex 会话体检与修复流程。【免费下载链接】codex-provider-syncSynchronize Codex session provider metadata across rollout files and SQLite state.项目地址: https://gitcode.com/gh_mirrors/co/codex-provider-sync创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考