前言¶
在 DeepSeek Harness（DSH）裏做自動化或整理本地資源時，經常要對一批文件統一改文件名：把舊關鍵詞換成新詞、加日期前綴、或按序號重排。手寫 shell 循環容易寫錯路徑，直接在文件管理器裏逐個改又費時。若希望命令可復現、且能在真正寫入磁盤前先看一遍結果，需要一個掛在 DSH 客戶端上的批量改名工具。
下面介紹社區插件 dsh-file-rename（npm 包名 @deepwhale-cn/dsh-file-rename）：按替換、前綴、後綴、編號等規則批量重命名，默認只預覽，確認後再執行，且不覆蓋已存在的目標文件名。
這是什麼¶
dsh-file-rename 是 DSH 生態下的客戶端插件，由維護者 feely0208 發佈在 GitHub（feely0208/dsh-file-rename），可在 SkillHub 目錄頁查看說明：feely0208/dsh-file-rename。插件解決的是「目錄內多文件按規則改名」：把規則寫成 CLI 參數，先列出將要發生的改名，滿意後再一次性應用。
與臨時寫 mv 腳本相比，它把幾種常見規則（替換文字、前綴、後綴、編號）收斂到同一命令行入口，並強調先預覽、不覆蓋兩條安全約束。
核心功能¶
依據倉庫 README 與 package.json 描述，當前版本（0.1.0）能力包括：
- 替換文字（
--op replace）：在文件名中把指定片段--from換成--to。 - 加前綴（
--op prefix）：在文件名前加上--to指定的內容。 - 加後綴（
--op suffix）：README 未單獨示例，與替換/前綴/編號同屬「按規則批量重命名」能力範圍；具體參數以 CLI 幫助爲準。 - 批量編號（
--op number）：按--to作爲基名、--start起編序號等方式批量編號（見下方示例）。 - 預覽與執行分離：不加
--apply 1時僅預覽；加--apply 1後執行實際改名。 - 不覆蓋：若目標文件名已存在，不會覆蓋已有文件。
插件面向 web 客戶端 profile 注入（dsh.client.platform: web），依賴 @deepwhale-cn/dsh-guard-core，運行環境要求 Node.js >= 18，DSH 版本 >=0.1.0-rc.6 <0.3.0。許可證爲 MIT。
安裝與啓用¶
安裝命令須使用資料原文，針對 web profile：
dsh plugin --profile web add @deepwhale-cn/dsh-file-rename
上述命令會把插件註冊到當前 DSH 的 web 配置中；安裝完成後可通過 dsh-file-rename 命令調用（見 package.json 的 bin 字段）。
典型用法¶
以下示例均來自 GitHub README，可直接在本地目錄上試跑（先不加 --apply 1 看預覽）。
替換文件名中的文字：
dsh-file-rename --op replace --input ./下載 --from 舊 --to 新
按序號批量編號（基名與起始序號由參數指定）：
dsh-file-rename --op number --input ./照片 --to 照片 --start 1
爲文件名加前綴：
dsh-file-rename --op prefix --input ./合同 --to 2026-
預覽結果無誤後，在同一條命令末尾加上 --apply 1 纔會真正改名。默認行爲是隻預覽，避免誤操作。
適用場景與注意¶
適合誰： 需要在 DSH 客戶端側整理下載目錄、照片文件夾、合同掃描件等，且希望改名規則可腳本化、可重複執行的開發者或智能體工作流編排者。
運行權限： 插件以當前 dsh 進程所具備的本地文件系統權限運行，能讀寫的路徑與當前用戶一致。安裝或使用前，應自行查看 GitHub 源碼 與 MIT 許可證，確認行爲符合預期。
生態說明： DSH 採用「一切皆插件」的擴展方式；SkillHub 等社區目錄爲獨立站點，與 DeepSeek、幻方無官方從屬關係，本文僅作插件能力說明，不代表官方應用商店條目。
結尾¶
dsh-file-rename 把批量改名的幾種常見規則收到一條 CLI 裏，並用「默認預覽、不覆蓋、滿意再加 --apply 1」降低誤改風險。需要安裝說明與 issue 跟蹤時，可訪問目錄頁 https://www.skillhub.cn/plugins/feely0208/dsh-file-rename 與倉庫 https://github.com/feely0208/dsh-file-rename。
