dsh-file-dedupe

File Dedupe

DeepSeek Harness 文件去重插件：扫描目录，通过 SHA-256 内容哈希查找字节完全相同的重复文件，并通过可逆隔离区进行清理。提供 Web 面板（浮动按钮 + Settings 部分）以及 file_dedupe_scan / file_dedupe_cleanup / file_dedupe_restore 代理工具

目标 Profile

插件会安装到这里；不确定时保持 web。

npx -y @deepseek-ai/dsh plugin --profile web add github:zizhuang/dsh-file-dedupe#0453bfe5e32381dab43eb2091112a3339de7f920

说明

兼容性与来源证明

File Dedupe 以 dsh-file-dedupe 发布，当前版本为 1.0.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。

DSH 兼容范围: *
运行环境: web
发布来源: github
Registry 更新时间: 2026/10/8

版本

1.0.0

说明

README

dsh-file-dedupe

中文 | English

DeepSeek Harness（DSH）文件查重插件：扫描任意本地目录，按 SHA-256 内容哈希找出内容完全相同的重复文件，并安全地清理。

一句话价值：装完就能在界面左下角点「🔍 文件查重」，几十秒内知道哪些文件是重复的、能腾出多少空间。

可视化面板：应用左下角常驻的「🔍 文件查重」浮动按钮（点开即面板），以及 设置 → 文件查重 区块。
对话工具：file_dedupe_scan / file_dedupe_cleanup / file_dedupe_restore，直接让 Agent 帮你查。
安全设计：只处理确实属于某个重复组的路径；每个重复组永远至少保留一个文件；Agent 工具只能把冗余副本移入可恢复的隔离区，永久删除必须由你在面板里二次确认。

安装

从 GitHub 直接安装（推荐）：

dsh plugin --profile web add github:zizhuang/dsh-file-dedupe

把 web 换成你的 profile 名（desktop、headless、tui 等）。安装后重启/刷新即可看到浮动按钮。

尚未发布到 npm（因此 add dsh-file-dedupe 暂时不可用）；被社区插件市场收录后，也可以在应用内「设置 → 插件市场」一键安装。

工作原理

遍历目标目录，先按文件大小分组；
只对「同大小且存在多个成员」的候选文件做 SHA-256 哈希（1 MiB 流式分块，大文件不占内存）；
内容哈希相同的文件即为真重复——与文件名无关。

结果包含：重复组数、冗余文件数、可释放空间、每组文件清单。

清理方式

操作	入口	可恢复
移入隔离区	面板 + `file_dedupe_cleanup`	✅ 用 `file_dedupe_restore` 恢复
永久删除	仅面板，需二次确认	❌

隔离文件存放于 $DSH_HOME/dsh-file-dedupe/quarantine/，并记录清单；恢复时精确回到原路径（目标位置已被占用则拒绝覆盖）。

配置

在 profile 的 cordis.patch.yml 中覆盖：

字段	默认值	含义
`minFileSize`	`1`	忽略小于该字节数的文件
`maxFiles`	`100000`	单次扫描最多收录的文件数
`maxGroups`	`500`	展示的重复组上限（按可释放空间排序）

对话工具示例

file_dedupe_scan(root="D:\\file store")            → 重复组清单 + 可释放空间
file_dedupe_cleanup(scanId="scan-…", paths=[…])    → 把冗余副本移入隔离区
file_dedupe_restore(paths=[…])                     → 从隔离区恢复

注意事项

查重是字节级内容相同判定：同名不同内容不算重复，不同名同内容算重复。
超大目录扫描需要时间，可用 minFileSize / maxFiles 缩小范围。
清理只影响你勾选的冗余副本，每组永远至少保留一个文件。

兼容性

在 DSH 0.2.0-rc.2（Windows 桌面版）上实测通过：安装、宿主路由、浮动按钮/设置面板、扫描 → 隔离 → 恢复全流程。

许可证

MIT

README

dsh-file-dedupe

中文 | English

DeepSeek Harness（DSH）文件查重插件：扫描任意本地目录，按 SHA-256 内容哈希找出内容完全相同的重复文件，并安全地清理。

一句话价值：装完就能在界面左下角点「🔍 文件查重」，几十秒内知道哪些文件是重复的、能腾出多少空间。

可视化面板：应用左下角常驻的「🔍 文件查重」浮动按钮（点开即面板），以及 设置 → 文件查重 区块。
对话工具：file_dedupe_scan / file_dedupe_cleanup / file_dedupe_restore，直接让 Agent 帮你查。
安全设计：只处理确实属于某个重复组的路径；每个重复组永远至少保留一个文件；Agent 工具只能把冗余副本移入可恢复的隔离区，永久删除必须由你在面板里二次确认。

安装

从 GitHub 直接安装（推荐）：

dsh plugin --profile web add github:zizhuang/dsh-file-dedupe

把 web 换成你的 profile 名（desktop、headless、tui 等）。安装后重启/刷新即可看到浮动按钮。

尚未发布到 npm（因此 add dsh-file-dedupe 暂时不可用）；被社区插件市场收录后，也可以在应用内「设置 → 插件市场」一键安装。

工作原理

遍历目标目录，先按文件大小分组；
只对「同大小且存在多个成员」的候选文件做 SHA-256 哈希（1 MiB 流式分块，大文件不占内存）；
内容哈希相同的文件即为真重复——与文件名无关。

结果包含：重复组数、冗余文件数、可释放空间、每组文件清单。

清理方式

操作	入口	可恢复
移入隔离区	面板 + `file_dedupe_cleanup`	✅ 用 `file_dedupe_restore` 恢复
永久删除	仅面板，需二次确认	❌

隔离文件存放于 $DSH_HOME/dsh-file-dedupe/quarantine/，并记录清单；恢复时精确回到原路径（目标位置已被占用则拒绝覆盖）。

配置

在 profile 的 cordis.patch.yml 中覆盖：

字段	默认值	含义
`minFileSize`	`1`	忽略小于该字节数的文件
`maxFiles`	`100000`	单次扫描最多收录的文件数
`maxGroups`	`500`	展示的重复组上限（按可释放空间排序）

对话工具示例

file_dedupe_scan(root="D:\\file store")            → 重复组清单 + 可释放空间
file_dedupe_cleanup(scanId="scan-…", paths=[…])    → 把冗余副本移入隔离区
file_dedupe_restore(paths=[…])                     → 从隔离区恢复

注意事项

查重是字节级内容相同判定：同名不同内容不算重复，不同名同内容算重复。
超大目录扫描需要时间，可用 minFileSize / maxFiles 缩小范围。
清理只影响你勾选的冗余副本，每组永远至少保留一个文件。

兼容性

在 DSH 0.2.0-rc.2（Windows 桌面版）上实测通过：安装、宿主路由、浮动按钮/设置面板、扫描 → 隔离 → 恢复全流程。

许可证

MIT

File Dedupe

说明

兼容性与来源证明

版本

File Dedupe

说明

README

dsh-file-dedupe

安装

工作原理

清理方式

配置

对话工具示例

注意事项

兼容性

许可证

兼容性与来源证明

版本

相关插件

相关插件

README

dsh-file-dedupe

安装

工作原理

清理方式

配置

对话工具示例

注意事项

兼容性

许可证

相关插件