dsh-superagent-prototype

1. 專案概述

dsh-superagent-prototype 是一個開源的 TypeScript 編碼代理原型，它將針對單一 GitHub 儲存庫的授權請求轉化為可追蹤的工作，在專用的 DeepSeek Harness 工作階段和目錄中執行每個任務，並將結果返回原始對話。儲存庫 README

2. 背景與定位

該專案源自 DeepSeek Harness 團隊的日常開發工作。其使命是交付有用的工程成果，同時盡量減少團隊成員所需投入的注意力。工作透過明確的請求或書面的團隊規則啟動，溝通則聚焦於可操作的問題和可用的結果。設計理念

其顯著重點在於持續的團隊工作流程：請求、授權、執行、後續跟進和交付都圍繞一個儲存庫一起建模。這使得它對探索互動式編碼工作階段之外的儲存庫代理的開發者具有相關性，儘管該專案並未發布比較效能基準。領域模型

維護者明確將其描述為研究程式碼，而非官方 DeepSeek 產品或生產就緒的服務。公開原型與內部實作及伴隨的研究文章有所不同；該文章討論的一些想法仍屬於未來方向。專案狀態

3. 功能類別

以下計數描述每個類別中列出的具體功能或資源，而非官方總能力數量。

協作與事件接收

🔌 儲存庫與聊天輸入 — 4 項代表性功能

• 針對已配置儲存庫的 GitHub 通知接收。
• 可選的飛書/Lark 機器人整合。
• 執行緒訂閱，將後續上下文傳遞給現有工作。
• 基於頻道的回覆，回覆與請求相關聯的對話。

目的：將團隊對話連接到可執行的工作，同時保留繼續工作所需的上下文。領域模型

授權與主動工作

🛡️ 策略控制 — 5 項代表性功能

• 每個來源的允許發送者清單。
• 基於範圍、發送者成員資格以及是否針對代理的准入表。
• 針對推斷的主動請求的書面規則。
• 三種接受模式：關閉、觀察和自動。
• 票據授權，記錄接受工作所依據的權限。

目的：區分啟動工作的權限與僅提供上下文的訊息。授權指南

任務執行

⚙️ 執行生命週期 — 4 項代表性功能

• 每個票據的專用執行器工作階段。
• 可配置的任務目錄準備命令，包括 Git 工作樹。
• 工作人員並行度和模型配置。
• 中斷任務的恢復和重試處理。

目的：使工作項目在執行輪次和重新啟動之間保持獨立可追蹤和可管理。執行指南

人工監督

📊 操作面板 — 6 個標籤頁，含 5 個代表性範例

• 概覽突出顯示需要人工關注的工作。
• 來源顯示整合健康狀態和交付問題。
• 觸發器呈現執行緒、傳入事件和訂閱。
• 評估記錄決策、原因和匹配的規則。
• 執行暴露票據狀態、工作人員活動和干預控制。

目的：使待處理的決策和工作流程歷史可見；第六個標籤頁「設定」配置來源、評估、執行、提示和部署。面板指南

自訂與擴展

🧩 擴展資源 — 4 項代表性資源

• 可編輯的團隊提示區段。
• 捆綁的 GitHub 和飛書技能。
• 一個 DeepSeek Harness 設定檔配置範例。
• 用於實作額外來源外掛的食譜。

目的：讓團隊根據自己的儲存庫工作流程調整指令和事件整合。提示指南、來源食譜

4. 關鍵亮點

• 在啟用主動執行之前先觀察。 預設的觀察模式會記錄推斷的工作是否會被接受，而不建立該工作，讓操作員有辦法先評估其規則。授權
• 從請求到結果的可追蹤工作。 觸發器、決策、票據和指派提供了共同的詞彙，用於理解代理接受了什麼以及如何進展。領域模型
• 分離的執行上下文。 每個票據都有自己的工作階段和工作目錄；Git 工作樹可以提供獨立的儲存庫簽出。這些是工作流程邊界，而非作業系統安全沙箱。執行、部署
• 聚焦注意力的監督。 面板優先顯示受阻的工作和可操作的問題，並在需要時提供詳細歷史記錄。面板
• 可擴展的事件來源。 食譜說明了事件轉換、回覆傳遞、授權整合和來源生命週期行為。食譜

5. 依角色劃分的使用案例

以下是已記錄工作流程的潛在應用，而非聲稱內建專門功能。

角色	實際用途
一般開發者	從儲存庫對話中委派範圍明確的錯誤修復或功能工作，並審查產生的變更或拉取請求。
DevOps/SRE	操作專用代理設定檔，監控健康狀態，並實驗對儲存庫 CI 事件的規則授權回應。
安全工程師	審查發送者權限、執行憑證和執行階段隔離；透過正常的儲存庫請求指派範圍明確的補救工作。
資料/研究科學家	研究事件路由、策略評估和任務恢復，或在研究儲存庫中委派程式碼變更。
專案經理	審查等待決策的票據，釐清請求的結果，並透過監督面板跟蹤工作。

底層機制記錄在領域模型、面板指南和部署指南中。

6. 開始使用

路徑 1：找到您需要的內容

從 README 開始，然後按順序閱讀九份編號文件，從理念到來源食譜。使用架構來導覽實作，並使用部署了解操作細節。

路徑 2：安裝與整合

推薦的起點是代理輔助的 SETUP.md。將此指令交給您的編碼代理：

Read SETUP.md in this repository and set up dsh-superagent with me.

先決條件包括 Node.js 22.19+（22.x 系列）或 Node.js 24+、pnpm、Git 2.32+、Python 3.8+、tmux、GitHub CLI 2.48+、github.com 上的儲存庫，以及在 DeepSeek Harness 中配置的模型提供者。飛書還需要其機器人設定和 lark-cli。

對於沒有現有 superagent 設定檔的新安裝，部署指南提供了以下序列，並填入儲存庫 URL：

npm install -g @deepseek-ai/[email protected]
git clone https://github.com/deepseek-ai/dsh-superagent-prototype.git dsh-superagent
cd dsh-superagent
pnpm install
pnpm build
dsh superagent --from-default-profile web --dump-config > /dev/null
dsh plugin --profile superagent add "link:$PWD"

設定檔建立命令會取代現有設定檔，因此請勿在升級時重複使用。在開始之前，請遵循其餘部署步驟：配置專用代理 GitHub 帳戶和 CLI 憑證，填寫範例設定檔配置，並配置來源、策略、執行和團隊提示。僅安裝命令並不能完成設定。

路徑 3：貢獻

在變更行為之前，請閱讀架構指南。對於整合，請遵循來源擴展食譜，包括其文件和測試要求。

從您的開發簽出中，執行儲存庫的組合類型檢查、測試和建置：

pnpm check

審查的樹狀結構不包含獨立的 CONTRIBUTING.md。使用已記錄的開發工作流程和 GitHub 的拉取請求介面提出變更。

7. 專案結構

dsh-superagent-prototype/
├── README.md                  # 概覽與文件索引
├── SETUP.md                   # 代理輔助設定工作流程
├── LICENSE                    # MIT 授權條款
├── docs/                      # 九份有序的設計與操作文件
├── examples/
│   └── profile.cordis.patch.yml
├── prompts/                   # 代理指令與團隊區段
├── skills/                    # GitHub 與飛書技能
├── locale/                    # 英文與中文介面資源
├── scripts/
│   └── dsh-superagent          # 服務生命週期輔助工具
├── src/
│   ├── index.ts               # 套件進入點
│   ├── core/                  # 領域引擎與生命週期規則
│   ├── app/                   # 執行階段、儲存、API 與協調
│   ├── executor/              # Harness 執行轉接器
│   ├── sources/               # GitHub、飛書與來源基礎設施
│   └── client/                # 網頁監督介面
├── tests/                     # 領域、整合與介面測試
├── cordis.patch.yml           # 套件外掛配置
└── package.json               # 相依性、相容性與腳本

架構將領域規則與執行和整合轉接器分開，而客戶端提供面向操作員的面板。請參閱原始碼樹和架構指南。

8. 相關生態系統

• DeepSeek Harness： 提供代理工作階段、工具、模型整合和網頁介面的主機執行階段。其官方首頁連結到執行階段儲存庫和開發者文件；其通用能力不應與此原型實作的功能混淆。
• Cordis： Harness 生態系統和此套件配置所使用的外掛架構。該專案的套件清單列出了其 Harness 和 Cordis 相容性要求。
• GitHub 和 GitHub CLI： 用於代理身分和儲存庫操作的儲存庫協作平台和命令介面。
• 飛書/Lark 和 lark-cli： 用於接收請求和返回回覆的可選聊天整合。帳戶設定記錄在部署中。
• Git 工作樹和 tmux： 用於準備任務簽出和管理服務程序的互補工具，如部署工作流程所示。

9. 授權條款

該儲存庫使用 MIT 授權條款，版權歸屬於 DeepSeek Harness 團隊。

• ✅ 允許商業和私人使用、修改、複製、散布、再授權和銷售副本。
• ✅ 修改版本可以依您選擇的條款散布，前提是保留所需的聲明。
• ❌ 您不得從軟體副本或實質部分中省略版權和許可聲明。
• ℹ️ 軟體不提供保證，且授權條款免除作者責任。
• ℹ️ 原型的授權條款不取代外部服務、模型提供者或相依性的條款。

10. 常見問題

問：這是官方、生產就緒的 DeepSeek 服務嗎？

答：不是。README 將其標識為供參考的研究原型。在採用之前，請審查並調整其實作。

問：主動模式是否意味著代理會啟動任意工作？

答：推斷的工作需要配置的准入路徑、評估、匹配的書面規則和自動模式。觀察模式記錄潛在的接受而不執行；明確的請求在所有三種模式中仍然可用。請參閱授權。

問：一個執行個體可以管理多個儲存庫或 GitHub Enterprise Server 嗎？

答：已記錄的範圍是每個執行個體一個 GitHub 儲存庫，且部署需要 github.com。明確不支援 GitHub Enterprise Server。請參閱部署。

問：工作人員目錄是安全沙箱嗎？

答：不是。受管理工作階段以操作員的作業系統使用者身分執行，具有完整存取權限；憑證包裝器選擇帳戶而不隔離程序。部署指南建議在需要隔離時使用僅包含代理憑證的專用作業系統帳戶。請參閱權限與隔離。

問：飛書是必需的嗎，我可以新增另一個整合嗎？

答：飛書是可選的。GitHub 是核心儲存庫整合，食譜說明了如何實作另一個來源，包括其策略、上下文和交付行為。

11. 快速連結

• 專案儲存庫
• README 與專案狀態
• 官方專案文件
• 代理輔助設定
• 手動部署與疑難排解
• 貢獻指南：架構與開發工作流程
• 來源擴展指南
• 拉取請求與程式碼審查
• DeepSeek Harness 首頁與社群外掛連結
• MIT 授權條款

審查的 README 中沒有連結獨立的貢獻指南或專案討論論壇；請使用儲存庫和上游首頁作為參與的已記錄起點。

12. 總結

dsh-superagent-prototype 為全球開發者提供了一個具體參考，結合儲存庫對話、明確授權、持續任務執行和人工監督。它對研究儲存庫編碼代理並擴展 DeepSeek Harness 生態系統的團隊和研究人員很有用，但預期其研究實作在投入實際使用前需要審查和調整。