前言¶
做 DSH 插件的開發者一般有兩條路：要麼從零寫自己的消息入口和任務調度，要麼找一個已經實現會話拆分、消息判定和恢復機制的基座來改。SuperAgent General 是第二條路上的一個現成選項。
它沒有改寫消息入口的底層邏輯，而是改在使用場景上：官方 SuperAgent 原型默認圍繞單個 GitHub 倉庫的維護與協作，這個插件把它拉回通用任務，並把飛書接入換成了填 APP_ID、APP_SECRET 的官方 SDK 長連接，而不是依賴一個預先配置好的機器人 CLI。下面介紹這個插件是什麼、相對原型改了哪些地方、怎麼裝怎麼配。
這是什麼¶
SuperAgent General（dsh-superagent-general）是一個面向通用任務的 DSH 插件，由 comeonzhj 維護，社區目錄中的分類爲「客戶端」，GitHub 星標 4，許可證 MIT。插件運行後通過飛書機器人接收私聊和羣聊消息，由常駐的 Router 協調任務，在獨立的 DSH Worker Session 中執行，主面板沿用 DSH 原生界面。
適用工作包括調研、分析、寫作、翻譯、資料整理、文件操作及軟件開發，實際能力取決於 DSH 提供的工具、模型和用戶授權。
它是社區適配項目，基於 DeepSeek Harness 官方 SuperAgent 原型（deepseek-ai/dsh-superagent-prototype）開發，保留上游版權與許可。
相對官方原型的調整¶
插件沒有另起一套任務編排，而是在原型基礎上改了使用場景、接入方式和初始化。對照如下，逐項來自 README 的表格。
| 項目 | 官方原型 | 當前插件 |
|---|---|---|
| 使用場景 | 單個 GitHub 倉庫的維護與協作 | 默認面向通用任務，GitHub 作爲可選來源 |
| 飛書接入 | 通過配置好的機器人 lark-cli 接入 |
填寫 APP_ID、APP_SECRET，使用官方 SDK 建立長連接並調用 API |
| 初始化 | 需要配置倉庫、CLI 賬號和運行目錄 | 自動提供默認數據目錄與任務目錄，模型沿用 DSH 設置 |
| 消息過濾 | 來源羣、是否被提及、發送者准入與模型評估 | 保留原型准入和評估，增加可配置的關注/忽略關鍵詞 |
| 默認要求 | 以代碼修改、PR 和審查爲中心 | 通用業務要求優先中文，GitHub 專用要求歸入可選場景技能 |
| 場景定製 | 團隊提示詞與技能 | 爲翻譯、項目分析、知識庫維護等配置適用條件與交付要求 |
| 管理界面 | DSH 原生面板與自動輪詢 | 默認概覽、執行設置前置、設置標籤最後，配置說明用 ? 懸浮提示 |
| 飛書資源操作 | 主要通過機器人 CLI | Worker 通過應用身份的 API 處理獲授權的消息、文檔、知識庫和表格等資源 |
消息過濾裏增加的關鍵詞變更會納入策略版本，也就是說策略和關鍵詞不是各改各的。
保留的核心設計¶
沿用原型的 Engine、Router/Worker 會話、Trigger/Thread、訂閱直通、上下文按需讀取、SQLite、Effect/Outbox 與恢復機制。src/core/ 保持與上游基線一致，適配改動集中在周邊。
主面板可以查看消息、判斷、任務、線程與訂閱並自動更新。任務詳情能打開真實的 worker-… 執行會話，查看推理、工具調用和交付過程；Router 統一回復入口消息。
上游來源、基線提交和適配邊界寫在倉庫的 docs/UPSTREAM.md，給插件找閒話說之前可以先看這份邊界。
安裝¶
安裝方式是裝插件包，不是裝 npm 包，README 給出的步驟如下。
1、從 Releases 下載預編譯的 .tgz 插件包。
https://github.com/comeonzhj/SuperAgent-General/releases
2、在 DSH 的插件頁面安裝這個壓縮包，啓用 dsh-superagent-general，打開側邊欄的 SuperAgent。
當前版本基於 DSH 0.2.1-alpha.2 的接口開發，聲明的宿主兼容範圍見倉庫的 package.json；Node.js 要求爲 ^22.19.0 或 >=24。倉庫自身版本爲 0.2.2，運行時依賴包括 @larksuiteoapi/node-sdk 1.76.0、zod 4.4.3 和 proper-lockfile 4.1.2。
如果你要從源碼自行打包，README 提供的流程是取乾淨倉庫後依次跑 pnpm install --frozen-lockfile、pnpm check、pnpm pack --pack-destination dist，產物爲 dist/dsh-superagent-general-<版本>.tgz。pnpm pack 會先構建再打包，倉庫另有 docs/ARCHITECTURE.md、docs/PROMPTS.md 等文檔。
配置飛書應用¶
插件裝好後需要在側邊欄的 SuperAgent 面板裏完成接入。
1、在最後的“設置”標籤中連接飛書應用，填寫 APP_ID、APP_SECRET，選擇接收的羣與可交辦任務的人。
2、需要時在“更多設置”中添加團隊技能，填寫場景要求。
飛書應用側要啓用機器人、開啓長連接接收消息、申請相應消息權限併發布。如果要讀寫文檔和知識庫，目標資源也需要授權，只有消息權限不夠。配置說明使用 ? 懸浮提示，介紹內容放在“關於”裏，設置標籤放在最後。
典型流程¶
裝好並接好飛書之後，一次任務大致走四步。
1、飛書側發消息。私聊或被允許的羣內的消息會被機器人接收。
2、Router 判定。Router 負責消息過濾、准入判斷和模型評估，決定是否轉爲任務，並在面板中留下判斷記錄。
3、Worker 會話執行。被接受的任務在獨立的 worker-… 會話裏跑，使用 DSH 已有的模型、工具、工作區和權限，產出推理和工具調用記錄。
4、在面板裏看與回。面板顯示任務、線程和訂閱狀態，任務詳情可打開真實執行會話；Router 統一回復入口消息，避免多處回覆。
飛書資源的讀寫走應用身份的 API 工具，落的是插件所屬應用的權限範圍。
驗證與當前邊界¶
README 記錄的驗證範圍是：已通過自動化測試、類型檢查和構建，並驗證了隔離 DSH 中的安裝、原生面板、自動更新和主會話入口。飛書真實消息收發和資源讀寫需要用你自己的應用權限做聯調，這一步沒有被預先驗證過。
從早期版本升級時會遷移接入與模型等配置；舊版任務庫保留，歷史任務暫未轉換到當前原型的領域模型，具體變化見 docs/USER-GUIDE.md。
適用場景與注意¶
一個人或小團隊想在飛書裏直接派活、又希望執行過程留在 DSH 的 Worker 會話裏被看到和被審計，適合用這個插件。已經有自己在用的機器人 CLI、或任務邊界與某個 GitHub 倉庫強綁定的，更適合留在官方原型上。
需要先明確的幾點：
1、插件隨 DSH 進程運行，用的是當前 DSH 進程的權限，不是獨立沙箱；授權給插件的工具與目錄，實際上也是授權給運行它的 DSH 進程，安裝前先看源碼，確認哪些權限會被用到。
2、飛書側要準備好一個已發佈的應用憑證，並且消息、文檔、知識庫權限按實際需要授予，插件不會替你申請。
3、當前宿主接口基線是 DSH 0.2.1-alpha.2，package.json 聲明的是 ^0.2.1-alpha.2 || ^0.2.2-alpha.3，升級 DSH 前對照一下兼容範圍。
來源與許可¶
插件採用 MIT License，是社區適配項目，保留 DeepSeek Harness Team 的上游版權與許可。宿主兼容、依賴版本和包名見倉庫 package.json，完整安裝步驟與升級說明見 docs/USER-GUIDE.md，接單規則見 docs/PROMPTS.md。
目錄頁：https://www.skillhub.cn/plugins/comeonzhj/SuperAgent-General
倉庫：https://github.com/comeonzhj/SuperAgent-General
