前言¶
DeepSeek Harness (DSH) 的插件生態強調模塊化與增量擴展。在開發 Live Agent 場景時，”回合邊界實時切換預設” 是一個特定的功能點。Agent 在運行時需要知道如何選擇合適的預設，以及切換行爲的觸發機制。dsh-live-preset-switch 是一個爲此場景設計的標準 DSH Bundle，它不直接實現引擎邏輯，而是提供指導內容。
定位與作用¶
這是一個由 HaoyanZhang123 維護的標準 DSH Bundle，屬於工作流類別。
它通過一個 Host 適配器向 Profile 添加一個條目，並註冊一個名爲 live-preset-switch 的內置 Skill。該 Skill 包含關於 Agent 預設選擇的指導，以及針對支持該功能的構建版本中，”回合邊界預設切換” 的行爲說明。
核心特性¶
該 Bundle 的設計目標是作爲純增量組件存在：
- 純增量安裝：通過
cordis.patch.yml僅插入一個條目dsh-live-preset-switch-skill-provider。它不會禁用、替換、重排或遮蔽任何官方@deepseek-ai/*組件。 - 自包含：無運行時依賴，無生命週期腳本（如 preinstall、install 等），無原生製品或符號鏈接。
- 運行時只讀：適配器在運行時不進行任何文件、網絡、子進程或憑據訪問，Skill 正文爲靜態字符串。
- 提供指導：明確解釋瞭如何選擇 Agent 預設以及切換行爲的具體表現。
安裝與啓用¶
安裝該插件需指定 Profile 和倉庫的固定 Commit 版本。
dsh plugin --profile <name> add --ignore-scripts 'git+https://github.com/HaoyanZhang123/dsh-live-preset-switch.git#<commit>'
安裝完成後，可以通過以下命令驗證配置是否生效：
dsh --profile <name> --dump-config
預期輸出中應包含新增的條目 dsh-live-preset-switch-skill-provider，且在技能目錄中可檢索到 live-preset-switch 技能。
兼容性與注意事項¶
兼容性聲明¶
兼容性聲明位於 package.json 的 dsh.compatibility 字段：
- DSH 版本：
>=0.1.0-rc.8 <0.2.0 - Node 版本：
>=22.19.0 - Release 版本：對
0.1.5-alpha.2、0.1.5-rc.1、0.1.5-rc.2以及0.1.2-alpha.4、0.1.2-alpha.5、0.1.2-rc.1、0.1.3-alpha.2、0.1.5-alpha.1均聲明爲compatible。
注意：以上屬於來源聲明，不等於運行時的實際驗收。目前尚未完成各版本的隔離 Profile 安裝、啓動、卸載及回滾的證據收集。
重要區別¶
該 Bundle 不是 Live 預設切換的引擎本身。
真正的切換引擎會修改 DSH 核心包（包括會話歷史推導、agentPreset.select 回合邊界守衛、Composer 芯片等），因此無法以純增量的插件形式發佈；該引擎邏輯保留在 fork 分支中等待上游評審。本 Bundle 僅提供指導內容。
許可證¶
本項目採用 MIT 許可證。
總結¶
dsh-live-preset-switch 是一個專注於提供指導信息的輕量級插件。如果你需要在 Profile 中集成關於 Agent 預設切換的行爲說明，可以使用此 Bundle。它通過純增量的方式擴展功能，不干擾 DSH 核心組件，且運行時無副作用。
