前言¶
DeepSeek Harness（DSH）採用「一切皆插件」的架構，裝得越多，未捕獲異常、插件衝突或一行代碼寫錯導致進程退出的概率就越高。默認情況下，一次插件故障可能讓整個界面打不開、堆棧難讀，或只能禁用全部第三方插件並備份配置後重來——模型、接口地址、密鑰與正常插件的配置一併受損。
dsh-phoenix（社區稱「不死鳥」）面向這類兜底場景：在插件引發故障時儘量攔住進程退出、歸因到具體插件，並只隔離肇事插件，不動供應商與其它插件。下面介紹它的定位、能力與安裝方式；事實以 GitHub 倉庫 README 爲準。
這是什麼¶
dsh-phoenix 由維護者 KDreamelf 發佈，在 SkillHub 目錄中歸類爲工作流。簡介爲：Keep DSH alive through plugin faults: attribute the crash, quarantine only the culprit row, leave providers untouched.
一句話：DSH 因某個插件崩潰或卡死時，用可歸因的隔離與「復活模式」讓你仍能開新會話、讓 AI 協助排查，而不是把整個 profile 賠進去。
核心功能¶
判斷依據只有兩條：進程是否即將退出，以及能否指向是哪個插件。對應三種情形，應對不同。
進程將退出且能歸因到插件¶
DSH 未捕獲異常默認會直接退出。不死鳥會攔截退出，展示崩潰頁，說明插件名稱、圖標、版本、安裝位置與用途，以及完整錯誤細節，並提供三個選項：
| 選項 | 含義 |
|---|---|
| 給個機會 | 撤銷對該插件的臨時停用並重啓，驗證是否偶發 |
| 停職 | 保持禁用該插件，其它不變後重啓 |
| 開除 | 保持禁用，並在下次啓動後徹底卸載該插件 |
爲渲染崩潰頁，肇事插件在捕獲時會被臨時停用（寫在 home 層，不改 profile）；「給個機會」即撤銷該臨時停用。重啓後 DSH 以新進程繼續運行；模型、接口與其它插件不被修改。
進程將退出但無法歸因¶
棧中無插件信息時不猜測、不亂禁，提供：
| 選項 | 含義 |
|---|---|
| 再試一次 | 重啓，看是否恢復 |
| 進入復活模式（讓 AI 查） | 本次啓動不加載第三方插件，進入後將原始報錯交給 AI 反查 |
進程仍存活但無法對話¶
界面在但發不出消息、建不了新會話時，不死鳥用對話框展示原文報錯，並提供「再試一次」（刷新）與「進入復活模式」。
復活模式¶
相當於一次性的安全啓動：不改 profile 與設置，關閉重開即回到正常加載；不修改你在設置裏配置的供應商（接口、密鑰、模型列表）；不禁用不死鳥自身；僅不加載第三方插件，官方組件照常。若某供應商由插件在運行時註冊，插件停用後該供應商會隨插件退場，與設置裏靜態配置的供應商不是同一類。
標準流程：出事 → 對話框展示原錯 → 選「進入復活模式」→ 正常對話並請 AI 查插件 → 處理完畢後關閉重開恢復正常。是否進入復活模式由用戶點擊決定，避免誤判消耗 token。
能力與邊界¶
- 安裝後無需配置，平時不彈窗、不佔用正常使用。
- 進程被系統直接殺掉、故障發生在任何插件加載之前、或配置文件本身無法解析時，JS 層無法兜底；桌面版（Desktop）點復活模式時需手動關閉再打開應用，CLI 不能替桌面版另開窗口。
- 除捕獲肇事插件時的臨時停用（頁面上會說明，可用「給個機會」撤銷）外，不自動改配置、不自動卸載。
不確定選哪個時，README 建議選「停職」。恢復隔離可執行：
dsh-phoenix restore --all
安裝與啓用¶
CLI 安裝（將 <你的 profile 名> 換成實際 profile）：
dsh plugin --profile <你的 profile 名> add github:KDreamelf/dsh-phoenix
桌面端的 profile 由應用管理，需在應用內插件管理界面安裝，命令行不能直接改該 profile。
裝完重啓一次 DSH 生效。package.json 標明依賴 Node >=20、DSH >=0.2.0；當前插件版本爲 0.1.0，許可證 MIT。
典型用法¶
- 將不死鳥作爲常駐兜底插件安裝並重啓，日常無需操作。
- 若出現崩潰頁或攔截對話框，根據是否已歸因選擇「停職」「給個機會」「開除」，或「再試一次 / 進入復活模式」。
- 在復活模式中把報錯與現象描述給 AI，定位衝突或問題插件後，在 profile 中禁用或卸載，再正常重啓。
- 誤隔離或需批量恢復時：
dsh-phoenix restore --all
更細的機制與自測步驟見倉庫內 docs/how-it-works.md、docs/verification.md。
適用場景與注意¶
適合：剛接觸 DSH、希望少碰底層異常的人；以及熟悉 fail-loud、希望故障可歸因、可撤銷、可審計（判斷寫入日誌、隔離可命令撤回）的進階用戶。
注意：插件與 DSH 同進程權限運行，安裝前應閱讀源碼與 MIT 許可證，確認接受其 home 層臨時停用與隔離行爲。社區目錄 SkillHub 插件頁 與 GitHub 爲獨立生態信息源，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-phoenix 的價值在於：插件壞了不必讓整個 DSH 與配置一起壞掉——能指認就只動那一行，指認不了仍保留帶供應商的復活會話。目錄與源碼：
- https://www.skillhub.cn/plugins/KDreamelf/dsh-phoenix
- https://github.com/KDreamelf/dsh-phoenix
