日常使用和恢复

Agent 可直接调用这些工具，不依赖 PATH 上另外安装的工具：

工具	用途
`data_safety_status`	当前实例与当前会话的版本、指纹、计数、存储状态和覆盖边界
`data_safety_snapshots`	`list` / `inspect` / `verify` / `restore`；默认恢复为旁边的新文件
`data_safety_trash`	`move` / `list` / `verify` / `restore`；仅接受已核实的绝对路径，无 purge
`data_safety_temp`	`create` / `list` / `retire`；退休也走可恢复回收

没有新增逐操作确认。正常读取、编辑、依赖安装和测试继续执行。遇到不确定路径、链接、超大旧文件或不可识别写入路径时，可改用明确路径、原生编辑工具或新的版本输出，不能绕过已发生的拒绝。

默认存储为用户主目录下 .dsh-safekeep。它保留文件内容和原路径、时间、会话/工具标识，不记录完整对话或完整 shell 命令。恢复数据可能含敏感内容，不要提交到 Git。目录 ACL 限于当前账户、SYSTEM 和 Administrators。跨盘可恢复移动使用该盘按用户区分的私有库，详见恢复手册。没有自动清理、自动上传和加密备份。

DSH 无法启动时，从下载的同版本 tgz 解压到一个新目录，使用包内 CLI：

node C:\DSHRecovery\package\bin\dsh-safekeep.mjs doctor
node C:\DSHRecovery\package\bin\dsh-safekeep.mjs snapshots --path C:\Work\project\notes.txt
node C:\DSHRecovery\package\bin\dsh-safekeep.mjs snapshots verify SNAPSHOT_UUID
node C:\DSHRecovery\package\bin\dsh-safekeep.mjs snapshots restore SNAPSHOT_UUID
node C:\DSHRecovery\package\bin\dsh-safekeep.mjs trash list

CLI 与原生工具使用同一个库，不需要 DSH 或网络。doctor 检查本地 CLI/存储/历史回执，明确不声称当前 DSH 已加载。完整恢复、升级、卸载与排错。

dsh-safekeep

Install

README

日常使用和恢复