dsh-time-machine

LIMITATIONS

已知限制

- 第一版只处理 Host 本地 Git 仓库、UTF-8 常规文本文件。二进制、过大文件、symlink/junction、嵌套仓库不恢复；跳过的文件会列入记录。 - 不跟踪未纳入 Git 且被 ignore 的文件、空目录、数据库、部署或外部副作用。已跟踪文件即使匹配 ignore 仍可能被记录，行为与 Git 一致。 - 快照覆盖整个仓库。用户在 Agent 同一轮中手动做的修改也可能归入该轮，记录不证明“所有修改都由 AI 做出”。 - 两次快照并非文件系统原子快照。恢复前先关闭写入这些文件的编辑操作和后台进程；本插件会检查指纹、拒绝已知冲突，并阻止同一 Host 已知活跃 Agent 的恢复，但不能对不合作的外部进程提供原子隔离。 - 多个合作插件进程通过文件锁互斥；Host 外部写入不受锁控制。恢复是逐文件事务，失败时保留恢复日志，不声称多文件同时原子替换。 - 不改写 Git index、commit 或对象库。保存的内容与 Git index 状态分别存在；如果修改曾经被暂存，恢复后需要用户自行检查暂存状态。 - 正常记录在 turn/end 后异步完成；命令会等候队列。崩溃后残留的起始快照在下次访问时与当前磁盘比较，此间人工改动也可能进入恢复记录。 - 检查点记录跨重启保留，但列表当前展示本会话最近 50 条；旧记录可用 id 直接访问。第一版没有跨会话浏览、全文搜索、自动清理和 Git 分支切换。 - 撤回不会自动撤销文件夹创建，也不恢复 ACL、扩展属性和时间戳。常规权限位记录并恢复；Windows 权限语义以系统为准。 - 遇到无法读取的仓库或达到快照上限时，原 Agent 任务仍可继续；日志和时间线会报告警告。该轮不应被视为受到完整保护。