前言¶
DeepSeek Harness（DSH）采用「一切皆插件」的扩展方式：第三方包、官方内置能力都会出现在插件库里。日常开发里常见两类麻烦——自己装的第三方插件用管理器卸掉后，Profile 里仍残留依赖或列表条目；安装包自带的内置插件没有卸载按钮，只能长期占着列表。官方插件管理器能覆盖常规卸载，但对被锁定的第三方插件、以及内置插件的「从列表移出」缺少统一入口。下面介绍社区插件 @ggxx/dsh-plugin-purge（维护者 ggxx001，分类：客户端），它在 插件 → 彻底卸载 增加专门页面，做收尾清理，并支持仅隐藏与恢复显示。
这是什么¶
@ggxx/dsh-plugin-purge（npm 包名 @ggxx/dsh-plugin-purge，当前资料中版本为 1.0.0，MIT 许可证）是一款 DSH 客户端 Web 插件：在插件库界面提供「彻底卸载」「强制卸载」「停用并移出插件库」「仅隐藏」「恢复显示」等操作，并带二次确认与失败时的错误诊断。源码与说明见 GitHub；社区目录页为 skillhub.cn/plugins/ggxx001/dsh-plugin-purge（独立社区站点，与 DeepSeek / 幻方无官方从属关系）。
核心功能¶
README 用表格归纳了不同插件类型下的行为，经核对资料后概括如下。
| 插件类型 | 操作 | 结果 |
|---|---|---|
| 自己安装的第三方插件（可卸载） | 彻底卸载 | 通过官方插件管理器卸载插件、删除当前 Profile 里的依赖，插件库不再显示 |
被插件管理锁定、无法停用/卸载的第三方插件（如 @deepseek-harness-tui/dsh-tui） |
强制卸载 | 先停用，再用 Profile 自带的 pnpm 删除依赖，并清理 package.json 与 cordis.patch.yml 残留 |
| 安装包内置 / 官方插件（不能删文件） | 停用并移出插件库 | 先停用，再把条目从插件库列表隐藏；文件仍随安装包保留 |
| 任何插件 | 仅隐藏 | 保留安装，只从插件库列表隐藏 |
| 已隐藏的插件 | 恢复显示 | 重新出现在插件库；恢复不会自动启用它 |
交互与安全方面，资料还说明：
- 点击「彻底卸载 / 强制卸载」后需再点「确认」才会执行，避免误删。
- 卸载失败会显示插件管理器返回的错误码和诊断信息；此时仍可选择「仅隐藏」先清出列表。
- 「强制卸载」通过本插件在
/api下注册的认证 Fetch 路由执行，用 Profile 的 pnpm 跑pnpm remove，仅限availability: 'profile'且已停用的锁定插件。 - 隐藏记录保存在
127.0.0.1的 Cookie 中，不随端口变化丢失，重启应用后仍然生效；失效的隐藏记录会单独标记，可一键清理。
安装与启用¶
安装命令以 README 原文为准（示例为本地 link 路径，使用时请改为你本机插件目录）：
dsh plugin --profile desktop add link:D:\deepseek\plugins\dsh-plugin-purge
也可以由 plugin_manager 的 install_bundle 安装本目录。
卸载本插件后，隐藏记录立即失效，被隐藏的插件会重新出现在插件库。
典型用法¶
- 在 DSH 客户端打开 插件 → 彻底卸载 页面。
- 在列表中找到目标插件，根据类型选择对应操作：
- 可正常卸载的第三方插件：选 彻底卸载，确认后走官方pluginManager.removeBundle并清理 Profile 依赖。
- 被management-required锁定的第三方插件：选 强制卸载（需已停用；若仍启用，页面会先停用再卸载，或提示先停用）。
- 内置 / 官方插件：选 停用并移出插件库，文件仍在app.asar内，仅从列表隐藏。
- 暂不想动安装状态、只想整理列表：选 仅隐藏。 - 若之前隐藏过条目，在页面中对已隐藏项使用 恢复显示；恢复不会自动重新启用插件。
- 若强制卸载失败，查看错误码与诊断；必要时先用 仅隐藏 清理界面，再排查 Profile 与依赖。
适用场景与注意¶
适合谁： 经常在同一 Profile 里试装、卸载大量 DSH 插件的开发者；需要处理锁定第三方插件残留；希望内置插件从插件库列表中「眼不见为净」但不指望删安装包内文件的用户。
边界（资料原文）：
- 安装包内置插件的文件在
app.asar内，任何插件都无法删除；本插件只能停用并移出插件库。 - 第三方插件的普通删除通过官方
pluginManager.removeBundle完成；只有被标记为management-required的锁定插件才走「强制卸载」的pnpm remove。 - 强制卸载不会删除正在启用的插件。
- 隐藏是界面层的显式过滤，不改变插件是否安装、是否运行；停用与隐藏是两个独立步骤。
安全提示： 本插件以当前 DSH 进程权限运行，「强制卸载」会调用 Profile 的 pnpm 修改依赖与 patch 文件。安装前请自行查看 GitHub 源码 与 MIT 许可证，确认符合你的环境与合规要求。
结尾¶
dsh-plugin-purge 把插件库里「删不干净、卸不掉、内置插件没按钮」等收尾问题收到一个页面里：能删的走官方卸载与 Profile 清理，锁定的走认证 API + pnpm remove，内置的只能停用并隐藏，并支持恢复显示与失效 Cookie 清理。需要进一步了解时，可看社区目录 https://www.skillhub.cn/plugins/ggxx001/dsh-plugin-purge 与仓库 https://github.com/ggxx001/dsh-plugin-purge。
