DeepSeek Harness 插件：dsh-ultracode

DeepSeek Harness (DSH) 的核心設計理念是“一切皆插件”。在開發需要高精度推理或嚴格流程控制的智能體時，開發者通常希望在一個會話中強制模型使用最大推理深度，並統一應用特定的編排策略。dsh-ultracode 插件正是爲此設計的：它爲 DSH 添加了一個“Ultra Tier”。通過一個開關，該插件將所有模型請求強制鎖定在服務模型聲明的最大推理層級，並激活一套駐留的編排策略。

插件定位¶

名稱: dsh-ultracode
維護者: BackMountainBird
許可證: MIT
核心價值: 單次開關，強制最大推理深度，激活編排策略。

核心功能¶

該插件主要提供以下能力：

按會話的努力層級：開啓後，插件會攔截請求，將每個 Agent 請求的推理層級（effort）強制鎖定爲服務模型聲明的最大值（默認爲 auto，即自動選擇最大值）。如果配置了具體值，則會直接使用該值。
編排策略：在會話激活期間，一個名爲 ultra:policy 的提示詞段落會注入到系統提示中。對於頂層會話，這包含工作流默認啓用、對抗性驗證、上下文清洗以及在提供商限制下進行“窄波”重試的策略。
UI 交互：在 Web 界面的 Composer 工具欄中會出現一個 “ULTRA” 芯片。激活時，Composer 卡片會顯示彩虹邊框（在減少動畫偏好下爲靜態）。
選擇器一致性：切換模式時，插件會通過公共模型 API 重新同步原生的努力層級選擇器，確保顯示狀態與實際強制的請求狀態一致。
委託感知：子代理（Delegated Children）會通過委託鏈繼承“有效狀態”。它們會獲得努力層級的鎖定和“工作政策”（childSection），但不會繼承頂層會話的“工作流指令”。分支（Forks）則通過種子前綴繼承，一旦生成即凍結。

安裝¶

使用該插件前，需確保已安裝 DeepSeek Harness 且版本滿足要求（@deepseek-ai/dsh-* >= 0.1.0-rc.6）。

通過 npm 安裝：

dsh plugin --profile <name> add dsh-ultracode

典型用法¶

安裝完成後，可以通過命令或 Composer 界面切換模式：

開啓模式：
在對話中輸入 /ultra。此時模型將強制使用最大推理深度，並啓用編排策略（例如審計依賴點）。
關閉模式：
輸入 /ultra off 或再次點擊 Composer 中的 ULTRA 芯片。
界面切換：
直接在 Composer 中切換 ULTRA 芯片，該操作會觸發 Picker 的同步。

工作原理¶

插件通過 Harness 的事件系統進行狀態管理和注入：

狀態管理：狀態由 Harness 擁有的 command/run 事件管理，插件本身不定義自定義會話事件。這意味着狀態是持久的，且在恢復和重放時無需額外處理。
策略注入：當 Tier 激活時，ultra:policy 或 childSection 會渲染到請求中。頂層會話使用 section（包含編排策略），子會話使用 childSection（僅包含工作政策）。
請求攔截：插件使用一個前置的 agent/request waterfall 監聽器來替換請求的推理層級，確保無論模型選擇器如何設置，實際請求的 effort 都被鎖定。
繼承機制：子代理通過 parentSession 解析父會話，獲取鎖定值和工作政策。生成的分支（Forks）僅通過種子前綴繼承，無法接收後續的層級切換。

注意事項與邊界¶

依賴版本：必須使用 @deepseek-ai/dsh-* >= 0.1.0-rc.6。
繼承規則：繼承僅增加內容，子代理沒有用戶命令表面，無法通過子代理退出 Ultra Tier。
顯示與真理：Picker 的同步僅爲了顯示一致性；請求端的 pin 纔是真理。在 Ultra 模式下手動更改 Picker，下次切換時會重置，但當前請求仍保持鎖定。
模式隔離：Ultra 模式不觸碰 Plan Mode，兩者是獨立記錄的狀態。
提供者限制：默認策略要求模型在提供商併發限制下進行“窄波”重試，但實際的扇出能力取決於提供商本身。

總結¶

dsh-ultracode 爲 DeepSeek Harness 提供了一套標準化的“深度推理 + 編排”方案。它通過插件機制在不修改核心框架的情況下，解決了開發者對單次會話推理深度和策略執行的強制控制需求。