前言¶
在 DeepSeek Harness（DSH）裏做智能體相關開發，往往需要把「工單、執行、策略」放在本機可控的環境裏，而不是完全依賴在線演示或重量級自建服務。社區裏已有 dsh-superagent-prototype 等原型概念；若你希望在自己的 DSH 桌面端裏掛一個個人向入口，並沿原型思路逐步落地領域邏輯，可以關注維護者 kulebbb 發佈的 dsh-superagent。需要說明：這不是 DeepSeek 官方插件，當前以 GitHub 安裝爲主，npm 包 @kulebbb/dsh-superagent 尚未發佈。
這是什麼¶
dsh-superagent 是個人版 superagent：參考 dsh-superagent-prototype 的概念，爲 DSH 桌面端製作的插件，目標用戶是個人開發者，在自己的電腦上使用。
- 維護者：kulebbb
- 目錄頁：https://www.skillhub.cn/plugins/kulebbb/dsh-superagent
- 源碼：https://github.com/kulebbb/dsh-superagent
- 許可證：MIT（版權人 Liang；部分代碼取自原型，見倉庫內 THIRD_PARTY_NOTICES.md）
當前能力與進度¶
安裝並啓用後，在 階段 0（骨架） 下，你應能在側邊欄看到 Superagent 入口，面板顯示「插件骨架已加載」。該階段已在 DSH 桌面端 0.2.1-rc.5 上驗收。
階段 1（領域核心） 在倉庫中已完成代碼與測試，包括：從原型搬入的領域核心、基於 node:sqlite 的 Store、Effects 持久隊列，以及簡化爲「只有我」的個人版 Policy。README 寫明：這些內容尚未接到插件入口上，接線計劃在階段 2。因此，現階段不要把本插件當成「已可完整下單與執行」的生產能力，而是可安裝的骨架與可本地驗證的核心模塊。
後續階段（來自 README 路線圖，尚未全部落地）包括：下單與執行（本地來源、每工單一個執行器 Session 與 git worktree）、面板與通知、GitHub 來源（gh 監聽）、主動工作等。
核心模塊概覽¶
| 路徑 | 內容 |
|---|---|
src/index.ts |
服務端 cordis 插件入口 |
src/core/ |
領域核心（取自原型）：Engine、模型、工單階段、理由碼，無 I/O |
src/policy.ts |
個人版設置與准入：只有我、規則、accept 模式（off / observe / auto） |
src/app/store.ts |
SQLite 存儲，實現領域倉儲、設置版本與發件箱回執 |
src/app/effects.ts |
持久副作用隊列：事務內入隊、提交後執行、失敗指數退避 |
src/client/ |
客戶端插件：側邊欄圖標、主面板、中英文案 |
cordis.patch.yml |
bundle 層，把插件插入 profile |
個人版准入規則（src/policy.ts）大意如下：你向智能體發起的明確請求、或在已有工單線程上的追問會生效；他人直接 @ 智能體不接；推斷類候選在 off 下不接，默認 observe 只記錄「本來會接單」，只有 auto 且命中已啓用規則時纔會開工。
環境要求¶
- DSH：^0.2.1-rc.5（
package.json中engines.dsh鎖定在該版本線） - Node.js：22.19+ 或 24+
- 包管理：pnpm 11
桌面端請使用 DSH Desktop 自帶的 dsh；README 指出 npm 上的 @deepseek-ai/dsh 不能管理名爲 desktop 的 profile。
安裝與啓用¶
倉庫已提交構建產物 lib/。從 Git 安裝不會執行 build，也不需要在 profile 的 pnpm-workspace.yaml 裏爲該包打開 allowBuilds。
桌面端安裝命令（來自 README 原文）：
dsh plugin --profile desktop add github:kulebbb/dsh-superagent
若希望釘住某次提交，避免後續推送替換已安裝代碼，將 <commit> 換成完整 40 位 SHA：
dsh plugin --profile desktop add github:kulebbb/dsh-superagent#<commit>
說明：Git 安裝地址是 github:kulebbb/dsh-superagent，不是 npm 包名。若裝到命令行 Web profile，把命令中的 desktop 換成 web。安裝後啓用對應 bundle；若提示 restart-required，需完全退出並重啓 DSH，再在側邊欄點開 Superagent 確認骨架文案。
npm 注意：包名是 @kulebbb/dsh-superagent；無作用域的 dsh-superagent 因與已有包 dsh-super-agent 過於相似被拒絕發佈。README 明確不要安裝他人發佈的 dsh-superagent-desktop。包發佈到 npm 之後，可用：
dsh plugin --profile desktop add @kulebbb/dsh-superagent
本地開發與目錄安裝¶
貢獻或二次開發時，在倉庫根目錄執行：
pnpm install
pnpm check # 類型檢查 + 構建 + 測試，產物在 lib/
修改 src/ 後需重新 pnpm build，並把新的 lib/ 一併提交；用戶通過 Git 安裝依賴的是倉庫裏的 lib/，不會在用戶機器上編譯。
本機絕對路徑安裝（開發時）：
dsh plugin --profile desktop add /absolute/path/to/dsh-superagent
開發安裝後若提示 restart-required，同樣需要重啓 DSH。
適用場景與注意¶
適合誰：已在用 DSH 桌面端（0.2.1-rc.5 線）、想了解 superagent 原型如何在個人環境以插件形態落地，並願意接受當前僅爲骨架 + 未接線領域核心的開發者。
權限與安全：插件以當前 DSH 進程權限運行。安裝前請閱讀源碼與 MIT 許可證，自行評估 Policy、存儲與後續將接入的執行能力是否符合你的本機安全策略。
生態說明：DSH 生態強調「一切皆插件」；SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係，本文介紹的插件亦不屬於官方應用商店條目。
結尾¶
dsh-superagent 把個人版 superagent 的工程骨架與階段 1 領域核心帶到 DSH 桌面端：現在能驗證安裝、側邊欄入口與骨架面板；完整下單、執行與 GitHub 來源等能力按 README 階段表陸續推進。進一步瞭解可從目錄頁 https://www.skillhub.cn/plugins/kulebbb/dsh-superagent 進入，或直接查看倉庫 https://github.com/kulebbb/dsh-superagent。
