前言¶
DeepSeek Harness(DSH)默認運行時通常包含大量工具,即使處於空閒狀態也會佔用空間並增加複雜度。Minimal Omni 插件旨在解決這一問題:它保持 DeepSeek Harness 的默認狀態最小化,僅在任務明確需要瀏覽器、文檔解析或代碼導航能力時,才按需啓用這些功能。
插件簡介¶
該插件是 DeepSeek Harness 的一個獨立開發者預覽包,由 Rainflowers686 維護,遵循 MIT 許可證。它通過向現有的 DSH web 配置文件添加一個包來工作,不會改變默認預設、提供商設置、憑證、代理或權限。
核心功能¶
插件提供以下核心能力:
- Minimal brain:最小化默認運行時。
- 按需能力:按需啓用代碼/LSP、瀏覽器、Web 獲取、PDF/DOCX/ZIP 提取。
- 任務管理:Jobs(任務)、Session reload(會話重載)。
- 目標與壓縮:Native Goal(原生目標)、Manual /compact(手動 /compact)、Goal continuity across a successful compaction(成功壓縮後的目標連續性)。
- 集成路徑:Integrated coding path(集成編碼路徑)。
- 工作流支持:XLSX 和 PPTX 模型面向工作流、Automatic compaction tuning(自動壓縮調優)。
安裝與啓用¶
在使用前,請確保你的環境滿足要求:Node.js >= 22.19.0。Windows 是當前首個支持的平臺。
- 在現有的 DSH 環境中執行安裝命令:
dsh plugin --profile web add github:Rainflowers686/deepseek-harness-minimal-omni#v0.2.0-preview.2
- 啓動 DeepSeek Harness Web 配置文件:
dsh --profile web
- 創建新會話,打開 Agent preset,並選擇 Minimal Omni。
典型用法¶
在選中 Minimal Omni 預設後,默認界面保持簡潔,僅顯示 pwsh、str_replace_editor、request_capability、release_capability 等基礎工具。
當任務需要訪問當前網頁、解析文檔(如 PDF、DOCX、ZIP)或進行倉庫代碼導航時,會話可以請求相應的瀏覽器、文檔或代碼/LSP 能力,並在任務完成後釋放這些能力。
若需卸載該插件,可執行:
dsh plugin --profile web remove @rain/minimal-omni
注意事項與限制¶
- 平臺支持:Windows 是目前的首個支持平臺,其他平臺的支持情況請參考項目文檔。
- 功能狀態:XLSX 和 PPTX 工作流、自動壓縮調優仍處於實驗階段。
- Vision 支持:支持情況取決於所選路由是否支持圖像輸入。
- 安全與權限:能力工具使用當前會話工作區和有界輸出。瀏覽器資料、下載、截圖和任務由運行時擁有。已知不支持的 Vision 路由會在圖像工具使用前被拒絕。
- 社區使用:正常社區使用不需要接受賬本或人工請求預算。Acceptance/CI 模式有更嚴格的請求和家庭隔離檢查。
- 日誌安全:切勿將 API 密鑰、Cookies 或私人會話日誌粘貼到 issue 中。
結語¶
Minimal Omni 插件通過按需啓用機制,幫助開發者在保持 DeepSeek Harness 默認簡潔性的同時,獲得瀏覽器、文檔解析等高級能力。對於需要精細控制會話工具列表的開發者,這是一個實用的開發者預覽方案。