安全文件恢复助手
北极星目标
在不删除、不覆盖、不污染现场的前提下，指导普通用户与 Agent 半自动协作，尽可能恢复崩溃、误删、回退混乱后的原始文件，并重建可继续工作的上下文。
普通用户先读这段
如果你只是想把文件找回来，请先记住三句话：
- 先停手：不要继续在出问题的位置保存、下载、解压或整理文件。
- 先找副本：回收站、自动保存、云端历史版本、旧电脑、U 盘、同事发过的附件，都可能比“硬恢复”更安全。
- 先放到隔离目录：找到任何候选文件，都先复制到一个新文件夹，不要直接覆盖原文件。
Agent 应使用普通话术引导用户，例如：
> 我们先不碰原文件。你告诉我文件大概在哪、什么时候出问题、最重要的是哪几个文件。我会先帮你列清单，再一步一步判断哪些最可能是你要找的版本。
适用场景
当用户出现以下情况时使用本技能：
- 长会话崩溃后，对话内容混乱，文件状态不可信。
- 文件被异常删除、覆盖、回退，用户希望尽可能恢复原文件。
- 用户有部分存档、回退结果、缓存目录、同步盘历史版本，需要整理为可验证的恢复方案。
- 用户需要把恢复过程沉淀为清单、差异报告、候选恢复计划和新会话交接提示词。
不适用场景
- 用户要求绕过系统权限、破解加密、恢复他人数据。
- 用户要求直接删除、覆盖、移动大量文件作为第一步。
- 用户希望承诺 100% 找回未落盘的文件或对话内容。
- 用户要对磁盘进行底层取证或硬盘坏道修复；这类任务应建议找专业数据恢复机构。
必须遵守的安全门禁
- 冻结现场优先：先停止原会话和高风险操作，不继续在混乱会话中执行修复。
- 只读优先：扫描、清点、比对可以做；删除、覆盖、移动原件默认禁止。
- 先复制再分析：对当前工作区、存档、缓存、checkpoint、同步盘候选来源，只复制到独立隔离目录或隔离恢复目录后再分析。
- 不删除原则：除非用户明确要求删除，并完成两次确认，否则不得执行删除或等价清理动作。
- 不覆盖原则：不得把候选文件直接覆盖回原工作区；应先形成 merged-candidate，再由用户确认。
- 脱敏原则：报告中默认隐藏用户名、密钥、token、隐私路径和敏感正文；必要时只保留哈希、大小、时间、相对路径。
- 可验证原则：所有判断必须来自文件清单、哈希、修改时间、内容差异、应用日志或用户确认，不凭印象推断。
- 不夸大原则：明确说明“尽可能恢复”，不能保证 100% 恢复，不能承诺 100% 恢复未保存、未落盘或已被覆盖的数据。
启动时先问用户的 6 个问题
- 事故类型是什么：崩溃、误删、覆盖、回退混乱、同步冲突，还是多种混合？
- 当前工作区路径是什么？
- 崩溃前阶段存档路径是什么？如果没有，说明没有。
- 回退后恢复出的文件在哪里？
- 是否允许只读扫描这些路径，并在独立恢复目录中写入清单和报告？
- 执行方式是完全自动推进，还是每一步都需要确认？
如果用户已经明确给出这些信息，不要重复追问；直接进入只读体检。
标准工作流
阶段 0：确认北极星与执行边界
- 复述目标：尽可能恢复原文件和可继续工作的上下文。
- 明确边界：不删除、不覆盖、不移动原件；只读扫描和复制隔离。
- 约定恢复目录，例如
recovery-case/。
阶段 1：冻结现场
指导用户暂停原会话、停止清缓存、停止批量同步整理。若需要命令，只提供只读命令。不得执行删除类命令。
阶段 2：建立恢复目录结构
建议结构：
recovery-case/
├── 00-current-state-copy/
├── 01-precrash-archive/
├── 02-recovered-sources/
├── 03-merged-candidate/
├── 04-session-reconstruction/
└── 99-evidence-log/
除非用户明确允许，Agent 不应直接复制大目录；可先生成执行建议或只读清单。
阶段 3：生成文件清单
对每个来源生成清单：脱敏路径、大小、修改时间、文件类型、临时文件线索、是否为空、是否可读。可选使用 scripts/readonly_inventory.py 做只读元数据清点。
阶段 4：差异比对
使用清单比较：
- 存档有、当前没有；
- 当前有、存档没有；
- 同路径但哈希不同；
- 文件大小异常变小；
- 空文件或疑似损坏文件；
- 最近修改但来源不明的文件。
阶段 5：候选恢复分级
将文件标为：
- A：确定权威版本；
- B：大概率正确；
- C：冲突，需人工确认；
- D：疑似损坏；
- E：待恢复。
不得直接把候选文件覆盖回原目录。
阶段 6：重建上下文
根据文件、计划、todo、goal、日志、浏览器历史、终端历史、文档内容，重建：
- 事故前北极星目标；
- 已完成阶段；
- 未完成事项；
- 权威文件列表；
- 冲突和缺口；
- 下一会话启动提示词。
阶段 7：交付恢复报告
最终交付至少包含：
recovery-intake.md：用户事故信息；manifest-*.csv：各来源文件清单；diff-summary.md：差异摘要；recovery-plan.md：候选恢复计划；handoff-prompt.md：新会话交接提示词。
Agent 行为规范
- 每个阶段开始前，回顾 0 级北极星目标、当前阶段目标和当前操作目标。
- 若工具失败、权限不足或扫描量过大，立即停下汇报卡点、已尝试内容、失败原因和可选路径。
- 如果用户要求删除、覆盖、清理，要先二次确认；未完成两次确认前不得执行。
- 对用户隐私内容只做脱敏摘要，不在报告中全文复制敏感信息。
内置辅助材料
references/user-friendly-guide.md：普通用户友好版一步一步引导。references/recovery-sop.md：完整恢复 SOP。references/platform-adapters.md：Windows、macOS、WPS/Office、飞书云文档和同步盘适配说明。examples/multi-scenario-examples.md：误删、自动保存、云同步冲突、Agent 会话崩溃四类示例。templates/recovery-intake.md：事故信息采集模板。templates/diff-summary.md：差异报告模板。templates/recovery-plan.md：候选恢复计划模板。templates/handoff-prompt.md：新会话交接提示词模板。scripts/readonly_inventory.py：可选只读生成文件清单。scripts/validate_package.py：技能包结构与 YAML 校验。
成功标准
- 用户知道下一步该做什么，不因技术细节迷路。
- Agent 不删除、不覆盖、不污染现场。
- 每个候选恢复动作都有证据来源和人工确认点。
- 即使无法 100% 找回，也能形成清晰的缺口清单和可继续工作的上下文。
