前言¶
在 DeepSeek Harness（DSH）裏做學習、寫腳本或跑自動化實驗時，助手常會卡在交互層：反覆確認、提示詞與宿主規則互相拉扯、改完設置不確定到底有沒有生效。社區裏常把針對這類摩擦的插件叫作「破甲」或「無限制模式」——指的是降低往返確認、讓 agent 能連續執行任務，並不改變模型能力本身。
dsh-purge（維護者 cute-gugu）是跑在本機上的 Harness 附加組件，分類爲 admin-security。當前發行版 2.0.0，README 寫明適配 DSH Desktop 0.2.1-rc.3（rc.1 / rc.2 同樣通過）。它把狀態可見、宿主補丁、提示詞注入、預設與備份回滾收到左側欄整頁設置裏，並附帶 80 條宿主補丁與 25 層狀態自檢。2.0.0 起已將 dsh-unrestricted 併入本插件，無需再單獨安裝後者。
本倉庫基於 YuJunZhiXue/dsh-purge 獨立維護，2.0.0 另合併 yexi-by/dsh-unrestricted（MIT），保留原作者署名與 MIT 許可證，並非原作者官方發行。
這是什麼¶
dsh-purge 在本機運行，目標是把日常最耗注意力的事收斂到一處：
- 看清楚狀態：安裝、補丁、注入是否就緒，可用一條命令或一屏面板給出結論；
- 少一些往返：把反覆出現的確認與打斷，收斂成一次設置；
- 隨時能回去：應用、回滾、開關留記錄，操作前自動快照；
- 方便做實驗：提示詞、規則、預設集中管理，改壞了能撤。
package.json 中的描述爲：DSH 指令權威性清洗一體化插件——運行時提示詞注入、宿主補丁、預設與演練臺；合併自 dsh-purge-community 1.6.55 與 dsh-unrestricted 0.2.4。
設計原則在 README 中歸納爲：本機優先（不改雲端賬號、不上傳提示詞或配置）、可見（每個動作有狀態與證據）、可回滾（應用 / 安裝 / 回滾前自動快照）、不替你做決定（只減少摩擦，開什麼由你確認）。
核心功能¶
狀態與自檢¶
- 左側欄整頁面板：頂部一句話說明當前狀態，主操作是「應用」；其餘分區可摺疊，維護頁可看最近動作、備份佔用、更新偏好。
- 命令行：
purge-community selfcheck [--json]做逐層狀態與證據；purge status查看宿主路徑與計數；purge-community host-status只讀查看安裝佈局與當前入口；purge-community diagnose做錨點漂移診斷；另有reanchor、probe等維護向命令（完整列表見倉庫 README）。
宿主補丁與提示詞注入¶
插件通過宿主補丁與運行時提示詞注入，降低交互層面的摩擦。README 強調：不會自動應用宿主補丁、不會自動重啓——安裝、應用補丁、手動重啓是獨立動作，需在面板中確認「應用」。
2.0.0 合併版說明：dsh-unrestricted 與本插件曾改寫同一段系統提示；併入後只吸收運行時注入指紋（attest）與狀態端點形狀，原 unrestricted 的融合鏈與設置卡片已移除，避免「看着是開的、實際沒上去」。
按預設排除注入（excludePresets）¶
自 1.6.40 起支持 excludePresets：默認空列表；可將 roleplay、minimal 等預設排除在 Purge 提示詞注入之外，仍保留命令、面板與工具。切換預設、並行會話與子 Agent 各自判斷。這不會撤銷全局宿主補丁；配置細節見倉庫文檔 按預設排除說明。
安裝器與遷移¶
社區安裝器在遷移前備份，調用當前實例的官方 dsh plugin --profile … add …，覈對版本與入口，並保留提示詞、規則、更新偏好及其他插件設置。1.6.54 起修復舊運行時鏈接遷移與應用失敗詳情：先備份、失敗恢復，保留現有設置。
安裝與啓用¶
DSH 官方入口負責安裝插件；社區安裝器由本倉庫維護，不是 DeepSeek 官方腳本。 已經裝過舊版 dsh-purge 或獨立面板時，宜用社區安裝器原地遷移，不要先卸載。
方式一：DSH 官方界面（首次安裝）¶
- 打開 DSH 並完成初始化。按官方文檔進入「插件」，在「實驗性插件」旁啓用「自定義插件市場」，再進入「發現 → 添加索引源」。
- 添加社區索引：
https://kingcharleslzy-ai.github.io/dsh-purge/index.json。 - 選擇 dsh-purge，覈對來源爲
cute-gugu/dsh-purge、包名爲dsh-purge，確認後安裝。
已有舊包時 README 建議改用方式三（社區安裝器）。
方式二：DSH 官方 CLI（首次安裝）¶
適用於已安裝 dsh 命令且使用 web profile 的 CLI/Web 用戶；桌面版用戶優先用界面安裝。
dsh plugin --profile web add "https://github.com/cute-gugu/dsh-purge"
web 須與實際啓動的 profile 一致；自定義數據目錄需沿用該實例的 DSH_HOME。README 明確：不要替換成 add dsh-purge 等裸包名；本項目通過 GitHub 發行。
方式三：社區安裝器（備份、舊版遷移）¶
先安裝並打開一次 DSH。以 Linux CLI/Web 爲例：先 dry-run，再正式安裝。
PURGE_INSTALL_DIR="$(mktemp -d)"
curl -fSL --connect-timeout 20 --max-time 90 "https://raw.githubusercontent.com/cute-gugu/dsh-purge/master/scripts/install.sh" -o "$PURGE_INSTALL_DIR/install.sh"
sh "$PURGE_INSTALL_DIR/install.sh" --dry-run
校驗成功後，在同一終端執行：
sh "$PURGE_INSTALL_DIR/install.sh"
macOS Desktop、Windows PowerShell 的腳本 URL 與參數見 GitHub README 安裝章節。安裝成功應記錄 backup_id 並覈對磁盤版本；運行中的 DSH 可能仍顯示舊版，需手動退出重開。
安裝後怎麼確認¶
- 社區安裝器不會自動應用宿主補丁；裝好後在左側欄 Purge 面板點「應用」。
- 可用
purge-community selfcheck或面板內狀態查看是否就緒。 - 回滾優先用「Purge → 狀態 → 本機備份」，或按 安裝指南 中的 CLI 回滾。
典型用法¶
狀態自檢¶
在終端（需能調用插件登記的 purge-community）執行：
purge-community selfcheck
需要機器可讀輸出時：
purge-community selfcheck --json
面板工作流¶
- 安裝插件並重啓 DSH（若安裝器提示需要）。
- 打開左側欄 Purge 整頁設置，閱讀頂部狀態摘要。
- 確認備份與目標實例無誤後，點擊「應用」使宿主補丁生效。
- 維護頁查看最近動作；出問題則從本機備份回滾。
與本機出圖組合（可選）¶
README 提到可搭配社區插件 Qwen Studio（dsh-qwen-studio）在本機生圖；破甲減少「要不要畫」的反覆確認，出圖插件負責實際調用。該組合爲可選生態說明，安裝與硬件要求見 dsh-qwen-studio 文檔。
適用場景與注意¶
適用：本機學習、個人項目、自動化實驗與維護工作。README 要求在你擁有或已獲授權的環境中使用；涉及他人系統應先取得許可。
權限與安全：插件以當前 DSH 進程權限運行，會修改 profile 下的插件佈局，並在你確認後應用宿主補丁。安裝前應自行閱讀源碼、MIT 許可證 與 NOTICE.md，理解補丁與提示詞注入的範圍。
生態說明：DSH 理念是「一切皆插件」；SkillHub 等社區目錄與 DeepSeek / 幻方無官方從屬關係，本插件索引由社區維護（kingcharleslzy-ai.github.io/dsh-purge）。
下載失敗：獨立安裝器自 1.6.39 起會顯示失敗階段與錯誤碼，有限重試後可切換系統 curl；仍失敗見 下載排查說明。安裝器不會自動改代理或重啓 DSH。
結尾¶
dsh-purge 把「有沒有生效、能不能撤、少問多做」收進一套本機可見的自託管流程：官方市場或 CLI 可首次安裝，舊版遷移與 SHA256 校驗安裝器適合已有實例；裝完後記得在面板應用補丁並用 selfcheck 驗收。
