支持
Windows Native x64；Claude Code、Codex；Windows Terminal / PowerShell / cmd Resume。
05 · TROUBLESHOOTING
先定位失败层，再决定下一步。
会话“看不见”、备份“还在”和目标客户端“能 Resume”属于三层问题。不要用一次重试掩盖证据缺口。
为什么会话突然消失？
先确认它是从 Swob 视图消失，还是原客户端源文件真的被清理。Claude Code 的本地保留策略可能删除旧源文件：一次真实审计中，1,621 个会话里有 253 个原路径已缺失，但 Vault 备份仍在。这个比例只描述该审计语料，不是每个人的预言。
- 检查来源排除
首启动或设置里排除的来源既不显示也不备份。
- 搜索 Vault
用标题、项目或 transcript 全文确认 Swob 副本是否存在。
- 检查保留期
对 Claude Code 延长本地会话保留期；它只能降低未来风险，不能凭空恢复已删除文件。
- 需要续接时再复活
只有点击 Resume 才进入受控写回；先核对目标实例和冲突。
复活失败原因（当前 23 类）
本表直接从代码消息表生成。任务设计稿曾写“24 类”，当前主干真相源实际是 23 类；以后代码增删而文档未更新，生成检查会失败。
| reason | 用户可见说明 |
|---|---|
session-id-mismatch | 备份中的会话 ID 与当前会话不一致，已停止以避免导入错误记录 |
missing-source-path | 会话没有可定位的 Claude 源路径 |
invalid-source-path | Claude 源路径格式无效，无法安全确定复活位置 |
missing-backup | 找不到可用于复活的备份 |
invalid-backup | 备份未通过严格 JSONL 校验，未写入 Claude 源目录 |
remote-source-requires-explicit-target | 这是其他安装的会话，需要先选择要导入的 Claude 实例 |
non-standard-source-requires-explicit-target | 源路径不是标准 Claude 目录，需要先明确选择导入目标 |
target-instance-not-found | 找不到所选的 Claude 实例，请重新选择可用实例 |
target-instance-unavailable | 目标 Claude 实例当前不可用，请确认该实例已安装且目录可访问 |
target-instance-untrusted | 目标 Claude 实例未通过路径安全检查，已停止写入 |
missing-target-inventory | 缺少目标实例的文件清单，无法排除覆盖风险 |
target-inventory-incomplete | 目标实例文件清单不完整，无法安全复活 |
target-instance-missing-config-dir | 目标 Claude 实例缺少配置目录，无法确定安全写入边界 |
missing-local-device-id | 本机缺少设备标识，无法判断会话是否来自其他安装 |
missing-local-username | 本机缺少用户名信息，无法安全判断旧版会话来源 |
non-standard-target-refused | 所选目标不是受支持的 Claude 实例，已拒绝写入 |
target-conflict | 目标 Claude 实例已有同名或同 ID 会话，已停止以避免覆盖 |
source-not-claude | 此会话没有可复活到 Claude 的源记录 |
unverified-backup | 备份缺少 SHA-256/大小证据，需要明确确认后才能复活 |
materialization-failed | iCloud 备份尚未完整下载或完整性证据不匹配 |
recovery-locked | 另一 Swob 进程正在复活该会话，请稍后重试 |
post-publish-verification-failed | 目标已发布但最终校验失败，已保留现场且未自动删除 |
io-error | 读取备份或写入目标时发生本地 I/O 错误，请检查磁盘和目录权限 |
Windows Native Alpha 边界
Alpha 只验证 Windows x64 上 Claude Code 与 Codex 的本地浏览、搜索、备份、Resume 和 Library 最小闭环，不是 macOS 功能对等版。
不支持 / 不在本阶段
其他九类 harness、WSL、OneDrive 占位文件、Windows CLI 安装、ARM64、自动更新、签名、SSH 和手机连接。
本站只保留用户能力边界；构建、CI 证据与真机验收清单见仓库的 Windows Alpha 工程文档，不把 CI 证据包装成已经交付的功能承诺。