用途与实际影响
这项功能怎样使用
为什么需要它
直接恢复到正在变化的应用目录，会覆盖新文件或混合版本。先还原副本能保留现场并明确恢复结果。
举个实际例子
“从最近一份完整对话备份恢复到空目录，先让我确认旧任务能不能找回来。”AI核对恢复点和文件完整性，在隔离目录恢复并用副本列出任务、读回对话；原来正在使用的目录保留。能看到旧对话不等于应用已经登录或新任务能继续运行。
最后我会得到什么
先得到一个在空目录中可核对的旧对话副本，现役 Codex 目录不被覆盖。能列出旧任务仍不等于应用已经登录，或新电脑可以继续那项工作。
正常时
备份点完整，空目录恢复文件并逐项核对后，报告文件层完成；应用是否可用再试。
发现问题时
目标恰是正在使用的 Codex 目录时拒绝覆盖，改选独立空目录。
入口不可用或证据不足时
备份不完整、目标已有文件或链接到受保护位置时停下并指出原因。
从哪里开始
在已接入的 AI 对话中指定 Codex 备份 PointId 和全新空目录，要求先恢复副本并查看旧任务。
需要准备什么
- 可验证的备份点
- 空恢复目录
- 要核查的旧对话或设置
从开始到拿到结果
- 1
先验材料再选择空目录
系统确认恢复点所需文件都在、目标是空目录，避免把旧材料盖到现役 Codex 上。
- 2
只还原隔离副本
按原相对路径恢复并核对文件，不覆盖正在使用的 Codex。
- 3
再验应用能力
从副本查旧任务并核对登录、配置和新任务能否运行；文件可读不等于应用已全部恢复。
技术实现与依据
这里保留实现、关键条件、精确入口、历史记录和验证结果。
9月10日次机隔离副本可列任务并读12轮；未启动新回合，9月12日只读旧回执关键规则与设计选择
Restore 要求 -Execute 与显式 DestinationRoot。
拒绝当前活动根及子目录、Hot/Cold/State 根及子目录；已有目录须为空且非 reparse point。
先完整核验点，再写目标文件，写后核验；未完成的目标不能算恢复成功。
桌面仍由原有轻量20:05/22:05与会话21:15任务经VBS隐藏启动。次机配置、安装与既有隐藏调度归PCConfig的Manage-CodexDataBackup.ps1，不在备份引擎另建服务。
本模块用到的名词
- DestinationRoot（恢复目标目录）
- 本次还原文件的专用空位置，不能与活动运行根或备份/状态目录混用。
- WScript Silent Launcher（WScript 静默启动器）
- VBS 用窗口样式 0 启动后台 PowerShell，保留既有任务调度，无需另建守护服务。
专业定义
保留现在的 Codex，先检查历史文件副本
解决什么
防止历史文件直接覆盖当前运行根，防止与备份池/状态目录混写。
当前怎样实现
- Resolve-PointId 选择指定点或 latest，Test-CodexConversationPoint 校验点与对象。
- Invoke-RestorePoint拒绝受保护目标，验证后重读manifest（清单）防止读入变化。只读校验及隔离恢复不要求旧主机身份；仍须现场确定实际介质路径并保持目录隔离，不能把原盘符当成新机已绑定。
- Copy-ObjectToFile 按清单恢复原始相对路径与内容并校验。
- 恢复进度写本地restore-progress.json，采用codex.conversation-backup.progress.v1；返回includes_configuration明确该点是否包含profile私有配置。不会把配置文件存在等同登录或新回合续作。
执行流程
- 1
提供点位、空目标和 -Execute。
- 2
检查活动根/备份根/状态根边界与目录形态。
- 3
验证清单、闭包与全部引用对象。
- 4
按相对路径创建文件并回读校验。
- 5
返回文件恢复结果；应用启用、登录和服务配置继续独立验证。
边界
- Restore只重建选中Hot或Cold点纳入的文件；桌面点不包含轻量管道全部配置，次机profile可含选定私有配置。它不安装程序、注册服务、设置全局变量或恢复登录；安全云投影也不能原样替代config.toml。
- 次机9月10日旧回执证明隔离副本可列出139项任务并读选定任务12轮；未复制凭据或启动新回合。当前新机登录、新回合续作仍未验，不用文件可读替代全部E2E（端到端验证）。
失败与恢复
- 目标为活动 CODEX_HOME 或子目录
- live_codex_home_restore_forbidden，停止恢复。
- 目标不为空或是链接
- restore_destination_not_empty 或 restore_destination_reparse_forbidden，停止写入。
真实入口
tools\Invoke-CodexConversationBackup.ps1隔离恢复模式与安全门禁断言核心实现
tools\Install-CodexConversationBackupTask.ps1Windows 计划任务静默注册器
tools\test-codex-conversation-task.ps1任务计划调度与权限等级验证测试
如何验证
- 三个合成点的文件恢复与哈希验证通过；不代表生产对象或新机器应用恢复。
- 任务 Plan/Inspect 匹配 CodexConversationBackup-Hot-Daily、Highest、每日 21:15，最近返回 0。
与其他模块的关系
把选定会话点重建为可检查的文件副本，不自动切换或启动恢复后的 Codex。