给任意文件夹留下历史时间点，随时一键回到过去——像 Git 一样有版本历史，但不需要懂 Git，任何文件夹都能用。
解决的是“改之前先备份一下”这个动作很难做的问题：找到备份工具、选目录、起名，三步之后往往没人做。装上这个插件后，面板上一个按钮就能存一个时间点，时间线上一行代表当时的样子，点“恢复”就回去了。模型自己也能存、看历史、回滚。
安装¶
通过 GitHub 安装：
dsh plugin --profile desktop add github:guomi6450/dsh-folder-timemachine
核心功能¶
- 任意文件夹历史：给任意文件夹留历史版本，支持实时（改动静默 8 秒）或定时自动存档。
- 智能去重：按内容去重，内容没变不产生空版本。
- 安全回滚：每次恢复前自动存安全点，恢复本身也可撤销。
- 模型工具：支持模型工具调用。
使用方法¶
面板操作¶
- 填路径 → 开始保护：把文件夹加入保护列表。
- 立即存一个 / 存一个时间点：存一个时间点。
- 自动存档 下拉：关闭 / 实时（一改就存，静默 8 秒） / 定时（每 5、15、30 分钟 / 1 小时）。
- 点文件夹行：展开它的历史时间线。
- 某一行 恢复：回到那一刻（恢复前会自动先存一个安全时间点）。
- 移出保护：不再跟踪，历史仍然留在磁盘上。
模型工具¶
工具名为 folder_timemachine。dir 省略时用当前会话的工作目录。
action=snapshot：存一个时间点。action=history：列出某个文件夹的时间点。
存储与限制¶
- 存储位置：
$DSH_HOME/folder-timemachine/。 - 保留策略：默认每个文件夹保留最近 50 个时间点。
- 默认排除：
.git、node_modules、.DS_Store等目录。 - 安全限制：
- 恢复是可撤销的（每次 restore 前自动存一个安全时间点）。
exact模式会删掉快照之后新建的文件。- 非空目录一律不动。
- 对象只加不改（不是硬链接）。
生态¶
这是一个 MIT 许可证的插件，属于 DeepSeek Harness 生态的一部分。
