給任意文件夾留下歷史時間點，隨時一鍵回到過去——像 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 生態的一部分。
