DeepSeek Harness，简称 DSH，是 DeepSeek 开源的 AI 智能体工作台。它可以连接模型，通过文件、终端和插件完成代码修改、资料整理、脚本执行等任务。

本文以 Apple 芯片 Mac 为例，介绍 DSH 桌面版及 dsh-purge 社区插件的安装、启用和测试方法。

本文核查日期：2026 年 11 月 13 日。使用版本为 DSH Desktop 0.2.2-rc.2 + dsh-purge Community 1.6.97。后续版本可能调整安装入口和兼容范围。

一、先分清工具和插件

名称	作用	来源
DeepSeek Harness	AI 工作台，负责会话、模型连接、工具执行和插件管理	DeepSeek 官方
dsh-purge Community	第三方插件，提供提示词管理、宿主补丁、状态检查和备份回滚	社区维护

所谓“破甲”，在这个插件中涉及提示词注入，以及对 DSH 宿主部分运行逻辑的修改，包括放宽沙箱、文件访问和审批限制。

它不保证模型一定回答所有请求，也不提供免费模型额度。 使用时应了解它会扩大 AI 在本机的操作范围，建议先在测试工作区体验。

相关地址：

• DeepSeek Harness 官方 GitHub
• DeepSeek Harness 官方下载页面
• dsh-purge Community GitHub
• dsh-purge Community 1.6.97 发布页面

二、安装 DeepSeek Harness

1. 下载桌面版

打开官方下载页面，选择与电脑匹配的安装包。

本文使用的是：

macOS（Apple silicon）

也就是适用于 M 系列芯片 Mac 的版本。Intel Mac 不应使用这个安装包。

下载后打开安装包，按提示把 DeepSeek Harness.app 放进“应用程序”目录。

默认安装位置为：

/Applications/DeepSeek Harness.app

2. 首次启动

打开 DeepSeek Harness，按照欢迎页提示选择：

• 登录账号；
• 或添加 API Key。

完成初始化后，进入主界面，创建一个专门用于测试的工作区。

先测试普通对话是否正常。如果尚未配置模型或账号，后续即使插件安装成功，也无法验证实际模型调用。

3. 桌面安装与源码下载有什么区别？

直接使用工具，安装桌面应用即可。

GitHub 源码主要用于阅读、开发或自行构建。下载仓库 ZIP 文件并不等于安装完成，也不需要为了使用桌面版另外编译整套源码。

需要研究源码时，可以使用：

git clone https://github.com/deepseek-ai/deepseek-harness.git

官方仓库 README另有源码构建和 Web 界面的启动说明。

三、选择插件版本

本文选择 dsh-purge Community 1.6.97。

维护者明确列出它兼容 DSH Desktop 0.2.2-rc.2，并报告 macOS 上的补丁应用、自检和回退测试通过。`1.6.97` 还修复了 1.6.95/1.6.96 中导致部分预设加载失败的导入问题。兼容说明、发布记录

安装时核对三个信息：

仓库：kingcharleslzy-ai/dsh-purge
包名：dsh-purge-community
版本：1.6.97

GitHub 的 Tags 页面还可能出现 archive/... 或 upstream-snapshot/...。这些通常是历史存档，日常安装优先使用有明确发布说明的 Release。

四、安装 dsh-purge 插件

以下方法适用于首次安装。如果原来已经安装过旧版 dsh-purge 或独立面板，应先阅读项目的迁移说明，保留旧配置和备份。

方法一：通过插件界面安装

按照社区项目当前说明：

1. 打开 DSH，进入左侧“插件”。
2. 在实验性插件中找到并启用“自定义插件索引／自定义插件市场”。
3. 进入“发现”，添加索引源：

https://kingcharleslzy-ai.github.io/dsh-purge/index.json

4. 找到 dsh-purge Community。
5. 核对仓库、包名和版本后安装。

不同 DSH 版本的入口名称可能略有变化。插件管理界面由 DSH 提供，索引和插件则由社区维护。插件安装说明

方法二：使用 Mac 桌面版自带的 CLI

本文实际安装时使用了这个方法。

前提是 DSH 已放入“应用程序”，并且至少打开过一次、完成初始化。对于本文这套桌面版本，在终端执行：

"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" \
  plugin --profile desktop add \
  "https://github.com/kingcharleslzy-ai/dsh-purge/releases/download/v1.6.97/dsh-purge-community-1.6.97.tgz"

这条命令使用当前桌面应用自带的插件管理器，把固定版本装入 desktop 配置。

安装输出应包含类似信息：

dependencies:
+ dsh-purge-community 1.6.97

注意：

• 本文使用的是 desktop 配置，CLI/Web 用户应核对自己实际使用的 profile。
• 自定义应用位置或数据目录不能直接照抄上述路径。
• 不需要为了装这个插件，再运行 npx 下载另一套 DSH。
• 不要把下载地址替换成裸包名 dsh-purge 或 dsh-purge-community。

安装完成只说明插件已加入配置，不代表宿主补丁已经应用。

五、应用补丁并重启

1. 先备份

应用前，建议保留：

• 原始 DeepSeek Harness.app；
• DSH 的 profile 配置；
• 自己修改过的提示词与规则。

默认桌面配置位于：

~/.dsh/profiles/desktop

这些备份可能包含个人配置，应保存在本机，不要直接公开上传。

2. 打开 Purge 面板

插件加载后，左侧会出现 Purge。

如果没有出现，先完整退出并重新打开 DSH，然后检查插件是否已启用。

在面板中核对：

DSH：0.2.2-rc.2
插件：1.6.97

3. 点击“应用”

在 Purge 的“状态”页面点击“应用”，等待处理完成。

这一过程会准备解包宿主、写入匹配的补丁，并安排宿主切换。处理中不要反复点击，也不要直接手动覆盖应用内部文件。

4. 完整退出再打开

按面板提示，在 Mac 上使用：

⌘Q

完整退出 DSH，再重新打开。

只关闭窗口或刷新界面，不能代替完整退出重开。

重启后，Purge 面板应显示类似：

已从解包目录启动（换包完成）

这比单纯看到“磁盘补丁已写入”更有意义：它说明当前服务已经从修改后的宿主入口启动。

六、如何测试是否成功？

建议分三层检查。

第一层：检查插件与补丁状态

打开 Purge → 状态，确认：

• 插件版本正确；
• 宿主兼容信息正常；
• 换包完成；
• 没有未处理的必需补丁错误。

本文实际操作后，界面显示：

已从解包目录启动（换包完成）
65/71 条补丁已生效

同一面板顶部另有 74/80 的磁盘写入计数。不同区域统计范围不同，不应把两个数字混为同一指标，也不需要盲目追求“全部条目都应用”。

“不适用”可能只是当前没有安装对应组件。需要关注的是必需项目中的失败、缺失和漂移。

第二层：检查自检与访问模式

展开“破甲自检 → 查看逐层”，检查沙箱、文件访问、审批和运行时注入等项目。

然后打开新会话，查看输入框附近的访问模式。

本文实际验证时，新会话显示：

完全权限

自检中的权限项可能显示“宿主推导”，它与明确失败不同，需要结合运行界面判断。

第三层：执行一个无害的实际任务

在一个专门的测试工作区，新建会话并输入：

请在当前工作区创建 harness-test.txt，内容为“DSH 安装测试成功”。
创建后重新读取这个文件，核对内容，并告诉我最终文件路径。

检查：

1. 文件是否实际创建；
2. 内容是否正确；
3. AI 是否确实重新读取了文件；
4. 最终报告的路径是否与文件一致。

这个测试能验证模型连接、文件工具和任务执行链路。

如果还想测试终端，可以输入：

请在当前工作区执行 pwd，并列出当前目录的文件。
只查看信息，不修改文件。

一次任务没有弹审批，不足以证明所有补丁都生效。 应结合 Purge 自检、当前访问模式和执行记录一起判断。

可选：测试提示词注入链路

Purge 面板提供“探针”功能，可生成一次性标记。

按照面板提示，在后续对话中检查模型是否回显该标记。这个测试用于辅助判断提示词注入是否到达模型；它不能证明模型会接受所有后续请求。

本文没有执行实际模型对话或探针回显测试，因此不把这两项列为已通过。

七、常见问题

安装成功，为什么还显示补丁未生效？

插件安装、补丁应用和宿主重启是三个步骤。

依次检查：

插件已安装 → 点击应用 → 完整退出 → 重新打开 → 查看运行状态

为什么模型还是会拒绝部分请求？

宿主权限、工具执行限制和模型自身行为属于不同层面。

即使宿主补丁加载成功，也不等于模型行为完全可控。不要仅凭一次拒绝就认定插件安装失败。

更新 DSH 后需要做什么？

官方更新可能恢复原始宿主文件，或改变插件的补丁匹配位置。

更新后先核对插件兼容说明，再查看状态和自检结果；发现漂移时使用项目提供的诊断流程，不要反复强行覆盖。

如何撤销？

Purge 面板提供“还原”，用于撤销宿主补丁；撤销后同样需要完整退出重开。

“还原宿主补丁”“回滚插件版本”和“卸载插件”是不同操作。遇到启动问题时，应结合之前保留的原应用、配置备份及恢复文档处理。

八、本文实际验证范围

本文这次在 Apple 芯片 Mac 上完成了：

• 官方 DSH Desktop 0.2.2-rc.2 安装与启动；
• 插件发行包 SHA256 与 GitHub 发布摘要比对；
• dsh-purge-community 1.6.97 安装及入口加载检查；
• 宿主补丁应用、退出重开和换包状态检查；
• 沙箱、文件访问与审批相关自检；
• 新会话“完全权限”状态确认。

尚未验证实际模型回复、文件任务、探针回显和回滚流程。 这些步骤可以按本文测试方法继续验收；Windows、Linux 和其他版本的兼容结果，应以各自环境实测为准。