前言¶

在 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 仓库。