前言¶

DeepSeek Harness (DSH) 是一個以插件爲核心架構的系統。在構建複雜的智能體工作流時，開發者常需要接入外部服務或工具。OrgX 提供了 MCP 工具和工作日誌訪問能力，useorgx/orgx-deepseek-harness-plugin 就是用於將 OrgX 能力集成到 DSH 中的插件。

插件定位¶

這是一個開發者預覽插件，旨在爲 DeepSeek Harness profile 添加 OrgX MCP 工具，並提供一個運行在工作區內的 OrgX gateway peer。

• 名稱：@useorgx/deepseek-harness-plugin
• 所有者：useorgx
• 許可證：MIT
• 核心價值：OrgX MCP 工具，Work Ledger 訪問，以及 DeepSeek Harness 的 Sovereign Execution peer。

核心功能¶

該插件主要完成以下工作：

1. 集成 OrgX 工具：將 OrgX MCP 工具添加到 DeepSeek Harness 配置中。
2. 運行 Gateway Peer：通過 Harness 的 headless 模式運行一個綁定到工作區的 OrgX gateway peer。
3. 掛載客戶端：掛載一個名爲 orgx 的 dsh-mcp-client 實例，用於與 OrgX 服務通信。

安裝與啓用¶

推薦使用 OrgX 提供的嚮導進行安裝和配置。

1. 運行 OrgX 嚮導初始化設置：

    npx @useorgx/wizard@latest setup

2. 通過嚮導觸發一次 DeepSeek 任務，以刷新 OAuth Token 並確保 DSH 啓動前憑證就緒：

    npx @useorgx/wizard@latest deepseek "List the OrgX tools available in this workspace."

對於高級用戶，也可以直接安裝插件包。DeepSeek Harness 版本需鎖定在 0.1.0-rc.6，Node.js 版本需爲 ^22.19.0 或 >=24.0.0。

dsh plugin --profile headless add @useorgx/deepseek-harness-plugin@0.1.0

典型用法¶

安裝完成後，可以在 DSH headless profile 中調用 OrgX 工具或檢查配置：

dsh --profile headless "List the OrgX tools available in this workspace."

檢查當前掛載的配置：

dsh --profile headless --dump-config

注意事項與風險¶

由於這是開發者預覽版本，使用時需注意以下具體限制和風險：

1. 狀態驗證：插件包的安裝成功並不代表 OrgX 認證通過、網關准入成功或部署就緒。如果 MCP 連接或初始工具同步失敗，DSH bundle 將無法啓動。
2. 功能缺失：當前版本不支持通過此客戶端訪問 MCP Resources 和 Prompts。此外，非文本 MCP 塊在模型端會有損投影（即使執行本地的結果保留了 JSON 塊）。
3. 主機訪問權限：Peer 將執行目錄設置在 ORGX_WORKSPACE_ROOT 內。這構成了路徑和變異邊界，而非主機隔離。DSH 的 workspace-write 權限不限制同一用戶的文件讀取、進程可見性或網絡訪問。
   • 若需利用此能力，需設置環境變量 ORGX_DEEPSEEK_HOST_ACCESS_ACK=1，並在接受相關風險後手動設置。
4. 憑證範圍：API Key 必須針對 gateway:drive 和 plugin:heartbeat 進行授權。
5. 認證機制：OAuth Token 必須是客戶端管理的 OrgX OAuth 2.1 訪問令牌（格式爲 oxk_ 開頭的 gateway key 不適用於託管 MCP）。

總結¶

該插件爲 DeepSeek Harness 提供了接入 OrgX 生態的途徑，允許在 Harness 中直接使用 OrgX 的 MCP 工具鏈和工作日誌。鑑於其開發者預覽屬性及在主機訪問權限上的特殊設計，開發者在使用前應仔細評估權限邊界與功能缺失。

• GitHub 倉庫
• 社區目錄