DeepSeek Harness 的核心設計理念是插件化。在構建智能體時，模型面對的工具和技能往往非常龐大。直接向模型暴露所有能力會導致上下文膨脹和選擇混亂。rangeking/dsh-iris 旨在解決這個具體問題，它實現了一種漸進式的能力選擇機制。
插件介紹¶
rangeking/dsh-iris 是一個爲 DeepSeek Harness 提供漸進式能力路由的插件，由 RangeKing 維護。它的核心邏輯是：當前模型讀取簡短描述，選擇能力 ID，然後使用 DSH 的正常加載和執行路徑。
核心功能¶
該插件主要提供以下能力：
- 漸進式能力選擇：允許模型基於描述選擇能力。
- 自適應模式：提供多種運行模式以適應不同場景。
- MCP 支持：支持
iris_search和iris_activate接口。 - 原生人物角色保留：在路由過程中不依賴額外的路由模型，保留原生人物角色。
安裝與配置¶
安裝插件需要使用官方提供的命令。
dsh plugin --profile web add dsh-iris
安裝後，可以在 DeepSeek Harness 的界面中找到 Iris 控制開關。進入 Settings → Iris 進行配置和遙測設置。
默認的卡片預算參數如下（初始產品參數，非 Token 估算）：
iris:
enabled: true
policy: auto
legacyInterface: false
cards:
maxCards: 8
descriptionChars: 200
totalChars: 1800
典型用法¶
在代碼層面，可以通過調用 iris_activate 來直接激活特定能力。例如：
iris_activate({ capabilityId: "tool:text_word_count" })
這種方式會觸發導入、應用、驗證和揭示的過程，最終調用原生的 ToolRuntime 執行。
模式與邊界¶
DSH 插件提供了四種自適應模式，不同模式下的行爲如下：
- Minimal / Preserve：保留原生人物角色、工具和順序；不啓用 Iris 控制、卡片或自動激活。未知自定義模式默認爲 Preserve。
- Standard：提供核心工具和預算卡片；對於隱藏或未掛載的能力，需要顯式激活；長尾能力通過搜索獲取。
- Code / PTC：使用原生
run_code和 DSH SDK。運行中的程序保持綁定；新激活的能力等待後續的主機步驟。 - Cordis / creation：保留原生人物角色、創建限制和創建條目（包括
cordis_mount/cordis_unmount）。搜索失敗不會授權插件創建。
在權限和運行時邊界方面，需要注意以下幾點：
- 元數據讀取安全：元數據讀取從不導入 Providers，加載 Skill 主體，連接 MCP 服務器或執行業務工具。
- 描述無權限：描述文本不授予任何權限。
- 無額外運行時：Iris 不安裝社區插件，也不創建第二個 Skill/MCP 運行時。
- 本地能力激活：配置的本地能力需要顯式激活和策略檢查。
- 原生描述歸屬：原生 Skill 描述保留其原生所有者，以避免生成重複卡片。
MCP 工具的運行時身份使用完整註冊名稱（如 mcp__github__create_issue），而非簡短顯示名。
總結¶
rangeking/dsh-iris 通過漸進式能力路由，幫助開發者更精細地控制智能體在 DeepSeek Harness 中的工具暴露與調用。它在不依賴額外模型的情況下，通過 iris_search 和 iris_activate 實現了能力的按需加載。
更多技術細節和源碼，請訪問 GitHub 倉庫。
