DeepSeek Harness Autopilot 插件介紹

前言¶

運行一個編碼智能體相對容易，但持續穩定地操作它則更具挑戰：仍需有人決定哪些工單已就緒、追蹤 token 使用量、限制併發、恢復中斷的工作以及通知團隊。DeepSeek Harness Autopilot（DSH Autopilot）爲 DSH 增加了這一層操作管理能力。它僅負責在“批准的工單”和“審查就緒的拉取請求”之間自動化執行工作，不干擾最終的審查、CI 決定和合並流程。該插件當前處於 Alpha 階段。

核心能力¶

該插件通過一系列機制將 DSH 的能力轉化爲可操作的流水線：

入站控制：僅接受帶有配置的 ready marker 以及當前人工授權的工單。這確保了只有經過確認的任務纔會進入處理隊列。
隊列與調度：在調度和併發限制下對工作進行排隊，並預留配置的 allowance 以防止超出提供商的 token 限制。
工作樹執行：通過 DSH 在受管理的 Git 工作樹中運行倉庫自身的指令，保持環境隔離。
生命週期管理：支持暫停、恢復和取消操作，且不丟棄持久運行歷史。即使中斷，也能恢復已保留的工作樹、中斷的發佈和通知。
狀態驗證：在創建拉取請求之前，會重新驗證確切的 Git 狀態，確保提交內容符合預期。
Web 可觀測性：在 DSH Web 界面中展示隊列、運行詳情、工作樹、交付狀態和設置，便於監控。
人類決策點：工作流在拉取請求創建處停止，最終的代碼審查、CI 決策和合並權限仍由人類掌握。

安裝與啓用¶

安裝該插件需要先擁有現有的 DeepSeek Harness 安裝環境。

1、安裝插件（使用 Alpha 版本）：

dsh plugin --profile web add @canhta/dsh-autopilot@alpha

2、啓動 DSH Web 服務：

dsh --profile web

3、在終端輸出的 URL 中打開 Web 界面，並在側邊欄選擇 Autopilot。

配置說明¶

在 DSH Web 中打開 Settings → Autopilot，即可配置追蹤器與代碼倉庫的綁定、調度策略、併發限制、預算、通知和保留策略。

1. 準備工作¶

啓用執行前，需先在 DSH Web 中選擇默認的 Agent 預設和模型，並配置每個提供商的 DSH Settings 命名空間。憑證（OAuth、模型密鑰、Token）應保留在 DSH Credentials 中，不要通過 Autopilot 創建新的認證流程。

2. 配置 MCP 服務器¶

Autopilot 通過 DSH 的官方 MCP 服務器（@deepseek-ai/dsh-mcp-client）與外部服務通信，而非第三方克隆。

編輯配置文件 $DSH_HOME/profiles/<profile>/cordis.patch.yml，添加以下配置：

GitHub MCP 配置：

- insert:
    - id: mcp-github
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: github
        transport: streamable-http
        url: https://api.githubcopilot.com/mcp/
        headers:
          Authorization: !!js '`Bearer ${process.env.GITHUB_TOKEN}`'

Jira MCP 配置：

- insert:
    - id: mcp-jira
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: atlassian
        transport: streamable-http
        url: https://mcp.atlassian.com/v2/mcp?tools=all
        headers:
          Authorization: !!js >-
            `Basic ${Buffer.from(`${process.env.JIRA_EMAIL}:${process.env.JIRA_API_TOKEN}`).toString('base64')}`

配置完成後，重啓 Web Profile (dsh --profile web)。

注意事項¶

依賴環境：必須先安裝並運行 DeepSeek Harness。
不替代集成：該插件不替換 DSH 本身或供應商集成（如 GitHub/Jira 的 MCP 服務器），它僅提供調度和生命週期管理。
版本狀態：當前版本爲 Alpha，生產環境推廣受到提供商合規性限制。
預算機制：預算字段保留容量用於對賬，但並非確切的累積硬上限。
Jira 認證：使用 Jira 時，必須啓用 API token 認證。
通知中斷：通知服務的中斷不會撤銷已完成的 Pull Request。

結語¶

DeepSeek Harness Autopilot 爲開發者提供了一個在 DSH 環境中穩定運行智能體的操作層。它通過隊列管理、持久化工作樹和狀態驗證，解決了持續操作智能體的痛點。如需瞭解詳情或貢獻代碼，可訪問其 GitHub 倉庫。