前言¶
在 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。
