前言¶
在 DSH 裏接智能體，常見兩難：要麼每次手動開 Session、跟進度，要麼把自動化拉滿卻把整組人的注意力都佔掉。DeepSeek Harness 的生態走「一切皆插件」——能力以 Bundle 形式掛進 profile，由 Cordis 編排服務與工具。dsh-personal-agent（中文名 搭檔）把原型的 super-agent 架構收成面向一個人的 proactive agent：一個入口、真實 Ticket、默認觀察再行動，適合想在面板或微信裏委派雜事、又希望工單可追溯的開發者自行試用。
下面按定位、能力、安裝與注意點說明；事實以倉庫 README 與 release 安裝說明爲準。倉庫寫明這是僅供參考的研究原型，非 DeepSeek 官方產品，使用前請閱讀源碼與 MIT 許可證。
這是什麼¶
dsh-personal-agent 由 yinguobing/dsh-personal-agent 維護，在 SkillHub 目錄中歸類爲工作流。包名與發佈標識使用 dsh-personal-agent；內部仍保留原型裏的 orchestrator 服務名與 orchestrator_* 工具名，便於與上游 diff。
一句話定位：以 DSH Bundle 發佈的個人超級智能體——你在面板或微信裏說話、往監控目錄丟材料，僅在你發起或規則允許時開工單（Ticket），在獨立 Session 與目錄裏執行，並把結果回到原對話；Web 面板展示進行中事項與需要你拍板的內容。設計理念在倉庫 docs/000-philosophy.md 中概括爲：儘量少佔用人注意力，儘量多交付價值；未獲授權或規則不允許時不主動開口、不擅自決策。
上游原型 dsh-superagent 面向單個 GitHub 倉庫（監聽 GitHub，可選飛書）。本 fork 弱化了「整倉庫協作」敘事，強調單人日常：對話、收件監控、工單與面板。README 註明公開版與內部版及論文 Exploring Super-agent Design 中部分設想並不完全一致，未實現項見 docs/known-gaps.md。
核心功能¶
以下能力均來自 README 與 package.json 導出說明，不擴寫未列出的集成。
-
Bundle 形態接入 DSH
通過cordis.patch.yml作爲 DSH bundle 安裝；客戶端注入 web 側 locale、settings、renderer、layout、sidebar、workspace 等模塊（見package.json的dsh.client.inject）。 -
工單（Ticket）驅動執行
授權請求在 Policy 下評估後變爲 Ticket，各自在獨立 DSH Session 中執行——與個人使用場景下的「一件事一張單」一致。 -
多來源監聽（按需啓用）
包導出包含github-watch、feishu-watch、chat-watch、weixin-watch、inbox-watch等入口；個人安裝路徑側重面板、微信與監控目錄，具體接線見docs/006-deployment.md與docs/008-cookbook.md。 -
Web 面板
面向使用者的界面：會話、進行中事項、智能體建議動作；運維向標籤頁可摺疊到一處切換（見docs/005-panel.md）。 -
可選長期記憶
安裝腳本默認寫入記憶索引；傳--no-memory可跳過。行爲細節見docs/memory.md。 -
文檔鏈
編號文檔從哲學、領域模型、授權、執行、提示詞、面板、部署、架構到 Cookbook，建議按000–008順序閱讀；上手五分鐘見docs/using.md。
當前 release 版本爲 0.10.0（package.json）。SkillHub 頁顯示星標爲 0，僅作目錄元數據，不代表功能完備度。
安裝與啓用¶
安裝前請準備：
- Node ^22.19.0 或 ≥24.0.0（
package.jsonengines） - DSH 版本滿足
>=0.2.1-alpha.2 <0.3.0或>=0.2.2-rc.1 <0.3.0 - 用戶主目錄下
~/.credentials.yaml配置DEEPSEEK_API_KEY；安裝器會提示：無 key 則每輪失敗
README 明確：不支持直接從 git 安裝（構建產物未提交，且 pnpm 對每次構建有審批要求）。推薦從 release tarball 安裝。
方式一：release 包（推薦）
dsh plugin --profile personal add \
https://github.com/yinguobing/dsh-personal-agent/releases/download/v0.10.0/dsh-personal-agent-0.10.0.tgz
若未用安裝腳本，可參考倉庫 examples/profile.cordis.patch.yml 自行寫入與腳本等價的配置。
方式二：已有 clone 時的一鍵安裝
在倉庫根目錄執行（會創建 personal profile、安裝 bundle 與記憶索引並打印啓動命令與材料目錄）：
node scripts/install.mjs --profile personal --port 3082
可加 --no-memory 禁用長期記憶安裝。
安裝後按終端提示啓動 DSH；面板默認端口示例爲 3082（與上述命令一致）。插件以當前 DSH 進程權限運行，安裝前請自行審查源碼與 MIT 許可證，勿在未審計的環境直接用於敏感資料。
典型用法¶
-
先讀短文檔再操作
安裝完成後依次閱讀docs/using.md（首五分鐘）、docs/memory.md、docs/known-gaps.md；遇問題優先對照 gaps 列表。 -
與個人工作流配合
- 在面板發起任務或回覆智能體提問。
- 將待處理材料放入安裝器輸出的材料目錄（inbox 監控）。
- 僅在明確請求或你所寫規則允許時，智能體纔會開立 Ticket 並進入 Session。 -
從原型遷移的完整搭建
若需原版 multi-step 的dsh-superagent式部署，README 仍保留SETUP.md路徑：可對 coding agent 說「Read SETUP.md in this repository and set up dsh-superagent with me」，由 agent 分步提問並安裝。個人 fork 日常以personalprofile 與 release 安裝爲主。 -
擴展數據源
按docs/008-cookbook.md增加 Source；授權模型見docs/002-authorization.md。
開發自檢（貢獻者）：在倉庫內 pnpm check 運行 typecheck、測試與 build。
適用場景與注意¶
適合誰
- 已使用 DeepSeek Harness，希望試驗「單人 proactive agent + 工單 + 面板」工作流的開發者。
- 願意按文檔配置 Policy、來源與 worker 權限（安裝腳本會寫入「worker 永不等待審批」一類設置，須理解含義後再用）。
- 接受研究原型：README 聲明可能存在 bug，工程風格不一致，非生產就緒。
務必注意
- 社區目錄 SkillHub 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；本文亦非官方文檔。
- 插件權限即 DSH 進程權限；微信、目錄監控等能力涉及憑據與數據出界，請在本機或可控環境試用。
- 不提供模型 key；憑據僅依賴
~/.credentials.yaml。 - 許可證：MIT。
結尾¶
dsh-personal-agent 把 super-agent 原型收成一人可用的 DSH Bundle：統一入口、Ticket 實參、默認觀察、面板彙總待辦。適合作爲工作流類插件閱讀其哲學與授權設計，再按需用 release v0.10.0 裝入 personal profile 驗證。
