前言¶

在 DSH 或本地開發環境裏，下載目錄、臨時導出和附件往往會堆成一層散文件：類型混雜、同名覆蓋風險、重複佔用空間。手動拖拽分類費時，腳本又容易誤刪或覆蓋。DeepSeek Harness 社區裏有一款客戶端插件，把「按規則整理、查重複、清空目錄」收成一套 CLI 與側欄入口，且默認只預覽計劃、不移動也不刪除文件。下面介紹它的定位、能力與用法。

這是什麼¶

深鯨文件整理（npm 包名 @deepwhale-cn/dsh-file-organizer，倉庫 feely0208/dsh-file-organizer）由維護者 feely0208 發佈，在 SkillHub 上歸類爲客戶端插件。它解決的是散文件歸檔的三件事：按類型/年月整理、找重複、清空目錄；設計原則是默認只看不動，確認後再 --apply 或 --delete。

核心功能¶

按類型與年月歸檔¶

對指定目錄生成整理計劃或執行移動。默認會按文件類型並配合年月路徑（例如 doc/2026-10/xxx.docx）；也可只用 --by date 僅按年月歸檔。

同名不覆蓋¶

若目標路徑已存在同名文件，自動追加 -2、-3 等序號，不會覆蓋已有文件。

重複文件檢測¶

基於文件大小 + sha256 找出內容相同的重複項，便於人工決定是否刪除冗餘副本。

清空目錄¶

默認只報告可清理內容；顯式加上 --delete 纔會刪除。與整理一樣，需要先理解輸出再操作。

安全與範圍¶

• 默認不刪除；--apply 才移動，--delete 才刪除。
• 跳過 node_modules、.git 等常見目錄。
• 處理在本機完成，不上傳文件內容（README 說明）。

圖形入口¶

啓用 web 配置後，DSH 側欄會出現 「深鯨文件整理」 面板，與 CLI 能力對應同一插件。

安裝與啓用¶

安裝命令以倉庫 README 爲準（web 客戶端配置）：

dsh plugin --profile web add @deepwhale-cn/dsh-file-organizer

package.json 標明依賴 Node >=18，DSH 引擎範圍爲 >=0.1.0-rc.6 <0.3.0，許可證 MIT。插件通過 @deepwhale-cn/dsh-guard-core 等與 DSH 運行時集成；安裝前建議在 GitHub 查看源碼與 LICENSE，並確認本機 dsh 版本在聲明範圍內。

典型用法¶

以下示例均來自官方 README，路徑請換成自己的目錄。

1、先看計劃（不寫盤）

dsh-file-organizer --plan ./下載

2、確認後執行整理

dsh-file-organizer --apply ./下載

3、只按年月歸檔

dsh-file-organizer --apply ./下載 --by date

4、查找重複文件

dsh-file-organizer --dups ./下載

5、清空目錄（默認只報告）

dsh-file-organizer --clean ./下載 --delete

建議流程：對每個目錄先 --plan 或 --dups / --clean 的無刪除模式看清輸出，再使用 --apply 或帶 --delete 的 --clean。

適用場景與注意¶

適合誰： 需要在本地批量整理下載文件夾、項目附件或備份目錄的開發者；希望先預覽再動文件、且要避免同名覆蓋的人。

運行權限： 插件以當前 DSH / 終端進程的權限讀寫路徑，--apply 與 --delete 會真實改變磁盤內容，應對準目錄後再執行。

生態說明： DSH 強調「一切皆插件」；SkillHub（如 插件目錄頁）是社區目錄，與 DeepSeek、幻方無官方從屬關係，不要當作官方應用商店。

安裝前： 覈對 GitHub 源碼、MIT 許可證與上述安裝命令；不要憑倉庫 slug 自行拼接未在文檔出現的 dsh plugin add 形式。

結尾¶

深鯨文件整理把類型/年月歸檔、重複檢測和目錄清理收進一條 CLI 與側欄入口，並用「默認只看不動」降低誤操作風險。需要細節與 issue 時，可查看 SkillHub 目錄頁 與 GitHub 倉庫。