前言¶

DeepSeek Harness（DSH）桌面版在官方更新後，有時會出現運行時缺件、補丁與宿主版本錯位、應用內更新裝不完等問題。社區裏有人 fork 上游補丁包自行維護，但版本錨點、Windows 換包流程和狀態是否可查，往往要靠自己摸。

dsh-purge 是維護者 555bbbAAA 基於上游 YuJunZhiXue/dsh-purge 1.1.71 繼續維護的社區兼容包，歸類爲 DSH 客戶端插件。它只負責 Harness 的版本對齊與本機 Windows 運行兼容，並在 GitHub 上開源（MIT，當前包版本 1.3.6，dshTarget 爲 >=0.2.1-rc.3 <0.3.0）。目錄頁見 SkillHub，源碼見 555bbbAAA/dsh-purge。

下面介紹它做什麼、怎麼裝、裝完怎麼驗。

這是什麼¶

一句話：dsh-purge 是跑在你本機上的本地開發工具，通過補丁與可選的 app.asar 換包，修改已安裝的 DeepSeek Harness 桌面版內部文件，並管理換包、重啓與運行時自愈。

維護者 555bbbAAA 在 README 中說明：本包基於上游 1.1.71 維護，面向 DSH 0.2.1-rc.3 及同系列 rc 宿主；對 0.2.1-rc.2 向下兼容，對 0.2.1-rc.5 等版本有核查記錄（補丁目標文件與 rc.3 錨點一致的情況見倉庫兼容性表）。

DSH 生態的理念是「一切皆插件」；SkillHub 等社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，本文介紹的插件來自社區維護者，不是官方應用商店條目。

核心功能¶

以下能力均來自倉庫 README 與 package.json 描述，安裝前可在 GitHub 自行覈對。

宿主版本兼容¶

6 條 na 均爲 optional: true 且目標在上游不存在，屬正常。

運行時與更新¶

• 運行時自愈：preflight 插件 + 120 秒 settle + Startup 守衛三層。
• 更新三態：active / dormant（官方安裝窗口內不寫盤、不換包、不殺進程）/ needs-reapply。
• 補丁換包與狀態可查：CLI 與客戶端側可查看補丁落地情況。
• 清洗：清洗上游身份段與拒答面（README 用語）。
• 退出與更新：修復宿主收到 shutdown 後不退出（#89），使應用內更新能裝完並重啓。

內置演練臺¶

README 寫明：內置演練臺含 5 個執行角色、23 個技能文檔，入口在右側欄（package.json 中另有 ./redteam 等導出路徑，面向紅隊評測類場景）。

本機操作範圍（INSTALL.md）¶

安裝說明中歸納的本機動作包括：對安裝目錄下 @deepseek-ai/** 內文件做文本替換（帶 .dshpurge.bak 備份）、必要時換包 app.asar、換包前結束 DeepSeek Harness.exe、通過 schtasks 一次性 PowerShell 完成換包等。文檔同時聲明：運行期不聯網、不收集數據、不開端口；修改的是用戶自己安裝的應用，判定是否可信取決於使用者是否爲本機主人並已理解上述行爲（靜態特徵可能與殺軟告警重合，INSTALL.md 有專門說明）。

安裝與啓用¶

安裝前請完全退出 DeepSeek Harness（含托盤）。插件以當前 dsh 進程權限運行，會改本機已安裝應用文件；動手前應閱讀 INSTALL.md、LICENSE 與倉庫源碼，確認可接受風險。

官方文檔給出的步驟是解壓到用戶目錄並向 desktop profile 註冊，而不是憑倉庫名拼接未在文檔出現的命令。下面命令摘自 INSTALL.md（<zip 路徑> 需替換爲你下載的發佈包路徑；示例目錄名 dsh-purge-1.3.6 與當前 README 版本一致）：

# 0) 先完全退出 DeepSeek Harness（托盤圖標也要退出）

# 1) 備份現有插件（若已安裝）
$dst = "$env:USERPROFILE\.dsh\plugins\dsh-purge"
if (Test-Path $dst) {
  Move-Item $dst "$dst.bak-$(Get-Date -Format yyyyMMdd-HHmmss)" -Force
}

# 2) 解壓
Expand-Archive "<zip 路徑>" -DestinationPath "C:\dp" -Force
Move-Item "C:\dp\dsh-purge-1.3.6" $dst -Force

# 3) 向 profile 註冊依賴（缺這一步插件不會被加載）
dsh plugin --profile desktop add "file:$dst"

# 4) 打開應用

若第 3 步提示 dsh 不是命令，INSTALL.md 建議：

node "<插件目錄>\bin\dsh-purge.js" --fix-shim

會生成 <DSH_HOME>\bin\dsh.cmd，按提示加入 PATH 後重試註冊。

dshTarget 含義：>=0.2.1-rc.3 <0.3.0 表示兼容 0.2.1-rc.3 及之後 rc，不含 0.3.0 及以上。可用 dsh --version 或安裝目錄 package.json 覈對宿主版本。

驗收記錄見倉庫 VERIFY.md，版本變更見 release-notes.md。

典型用法¶

裝完後用狀態命令確認補丁與插件根路徑，INSTALL.md 給出的期望輸出包含「補丁 71/77 已清洗，0 待清洗」以及真實的 插件根 / root：

dsh-purge --status

若 profile 已聲明但解析不到插件，重跑 dsh plugin --profile desktop add "file:$dst"。

若提示「app.asar 尚未換包」，可在應用面板點「應用」，或完全退出後執行：

dsh-purge --swap-asar

卸載時先還原補丁再從 profile 移除（用戶自己的 prompt-inject.md 保留）：

dsh-purge --uninstall

客戶端側：package.json 中 dsh.client 配置了 web 平臺注入與 cordis.patch.yml 補丁 bundle，並在 desktop profile 下 immediately: true 加載；設置頁部分「繼續/重試」配置區不顯示時，README 說明可改 cordis.patch.yml 後重啓生效。

適用場景與注意¶

適合誰：在 Windows 上使用 DeepSeek Harness 桌面版、宿主落在 0.2.1-rc.3～0.3.0 之前 rc 段，且需要在官方更新後維持補丁落地、換包與自愈能力的開發者或本機維護者。

務必注意：

• 插件修改本機 Harness 安裝目錄與進程，行爲見 INSTALL.md；安裝前檢查源碼與 MIT 許可證，勿在未理解範圍時交給不可信第三方代裝。
• Startup 守衛只覆蓋登錄窗口；非管理員賬號可能無法創建計劃任務。
• GET /dsh-purge/update 走 30 秒短緩存，連續點「檢查更新」可能仍是上次結果。
• README 免責：本地開發工具，不對外提供服務。

結尾¶

dsh-purge 把上游 1.1.71 的補丁思路延續到當前 DSH rc 宿主，用分層自愈、三態更新和可查詢的換包狀態，減輕桌面版更新後的本地兼容成本；同時提供 CLI 驗收與可選紅隊演練臺入口。

進一步信息：

• 社區目錄：https://www.skillhub.cn/plugins/555bbbAAA/dsh-purge
• GitHub：https://github.com/555bbbAAA/dsh-purge