前言¶
用 DeepSeek Harness 做智能體開發時，TeamAI 的安裝、團隊倉庫初始化、技能同步、MCP 和提示詞往往要在終端和多個工具之間切換。倉庫 README 說明：本插件提供 DeepSeek Harness 的側邊欄頁面，安裝後上述操作集中在一個界面完成；頁面調用本機 teamai，改倉庫時只提交對應文件，不重做 TeamAI，也不嵌入其儀表盤。
下面介紹插件定位、能力、安裝步驟和典型用法，事實以 GitHub 倉庫 README 爲準。
這是什麼¶
dsh-teamai-panel 由維護者 backtomyfuture 發佈，分類爲 客戶端 插件（package.json 中 dsh.client.platform 爲 web，通過 Cordis 注入側邊欄佈局）。一句話定位：DeepSeek Harness sidebar panel for TeamAI skills and usage（目錄簡介）；完整描述爲 TeamAI 技能、MCP 與提示詞在 DSH 側邊欄中的管理入口。
團隊倉庫、usage.jsonl 和 ~/.dsh/skills 留在每臺機器上，不會隨插件安裝包遷移。
核心功能¶
頁面打開後默認是「開始」，其餘分「技能」「MCP」「提示詞」。技能仍對應 README 中的三份清單：
- 團隊倉庫裏的技能，以及
pull是否會按目錄名下發。 - 當前工作區合併後真正生效的一份，標出目錄和優先級；項目副本不會被標成團隊副本。
- TeamAI 使用記錄裏
tool爲dsh的次數和最近時間。
開始¶
- 尚未安裝 teamai 時顯示「安裝 TeamAI」。
- 已安裝但未綁定倉庫時，填寫
owner/repo或https://github.com/owner/repo再初始化。 - 已初始化的機器會說明上述兩種情況。
若倉庫還沒有 teamai.yaml，初始化會向默認分支推送空骨架；頁面不收集令牌，認證依賴本機已登錄的 Git。已有配置時初始化不加 --force，不會靜默覆蓋。
技能¶
- 展示三份清單，支持安裝到本機、按技能推送。
- 安裝執行
teamai pull，會安裝當前配置應收到的全部技能，並同步規則、文檔、環境變量和鉤子；沒有按單個技能拉取的命令。 - 推送只提交點中的那一份；排除名單隻改本機，不進團隊倉庫。
插件對照的是磁盤上的技能目錄（未重做 pull），優先級如下：
| 優先級 | 目錄 |
|---|---|
| 100 | <項目>/.dsh/skills |
| 200 | <項目>/.agents/skills |
| 400 | $DSH_HOME/skills，默認 ~/.dsh/skills |
| 500 | ~/.agents/skills |
優先級 300 的自定義目錄不讀，因爲本插件不解析 DSH 的 Config。命名空間會裝平；標籤和 deliveredInstead 不在此重算。
MCP¶
- 查看團隊 MCP，以及新增、替換、刪除根
mcp/mcp.yaml裏的服務器；保存和刪除只提交該文件。 - 命令、參數、請求頭、環境變量值和地址寫入倉庫後，頁面不再顯示。
- 注入執行
teamai mcp inject，寫的是 TeamAI 支持的其他代理；DeepSeek Harness 不加載這些 MCP 服務器。 - 從其他代理移除執行
teamai mcp remove，只清本機工具配置，不改團隊倉庫。
團隊 MCP 與技能、規則、鉤子同屬一個倉庫與同一次發現；README 說明再拆一個插件會重複工作區發現與本機接口。列表僅說明服務器是否存在、傳輸方式、是否配置了命令或地址、工具名與所需鍵名。
提示詞¶
讀取、保存和刪除 prompts/ 下的 Markdown；保存和刪除只提交對應文件。提示詞正文僅在打開那一條時返回。
只讀資源¶
同一倉庫裏的規則、文檔、環境變量鍵名、子代理、鉤子、模型、工作流等仍爲只讀；0 表示倉庫尚未放置該項。環境變量只顯示鍵名。模型欄展示的是倉庫裏的網關配置，不是模型市場，頁面也不切換模型。
響應中不包含絕對路徑、變量值、密鑰、MCP 命令細節等；與 README 中的隱私設計一致。
安裝與啓用¶
本機需要已安裝 dsh，並且已經運行過 teamai init。Desktop 應用使用 desktop profile。先完全退出 DeepSeek Harness，再執行：
dsh plugin --profile desktop add dsh-teamai-panel
瀏覽器裏通過 dsh web 使用時，裝到 web profile，將上面命令中的 desktop 換成 web。# 後可跟包含界面版本的提交哈希；去掉則跟蹤 main。安裝包爲手寫 JavaScript，無 prepare 構建，因此不需要爲該包開啓 allowBuilds。
重新打開 DSH 後，側邊欄會出現 「TeamAI資源中心」。
package.json 標明版本 0.3.2，運行時 Node >= 20，許可證 MIT。
典型用法¶
- 在「開始」完成 teamai 安裝（若需要）、填寫團隊
owner/repo並完成初始化與同步。 - 在「技能」查看三份清單，執行
teamai pull等價操作（通過頁面觸發），按需推送選中的技能變更。 - 在「MCP」維護根
mcp/mcp.yaml，需要給其他代理用時執行teamai mcp inject；僅從本機其他代理清理時用teamai mcp remove。 - 在「提示詞」編輯
prompts/下 Markdown 並提交到團隊倉庫。
開發本插件時，倉庫內可執行：
npm install
npm test
側邊欄與客戶端契約對照 DeepSeek Harness 提交 ce7073d51254c26cd63b22a60835b8f948deb447（2026-10-29）；可行性說明見倉庫內 docs/dsh-teamai-plugin-feasibility.md。
適用場景與注意¶
適合誰：已在用 TeamAI 管理團隊技能與倉庫、並希望把這些操作放進 DSH 側邊欄的開發者，而不是在 Harness 裏重做一套 TeamAI 儀表盤。
使用記錄可能一直是 0：DSH 默認 DSH_PERMISSION_MODE=workspace-write 時，鉤子只能寫 dsh 的啓動目錄。啓動目錄不是用戶主目錄時，TeamAI 可能寫不下使用記錄。從主目錄啓動 dsh，或設置 DSH_PERMISSION_MODE=danger-full-access，記錄纔會出現；頁面上顯示 0 在此情況下不表示「沒有使用」。
權限與安全：插件在本機 dsh 進程權限下運行，會調用 teamai 並可能向 Git 遠程提交文件。安裝前應閱讀源碼與 MIT 許可證，確認團隊倉庫與 MCP 配置策略符合組織要求。社區目錄 skillhub.cn 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-teamai-panel 把 TeamAI 的安裝初始化、技能清單、MCP 根配置和提示詞維護收進 DeepSeek Harness 側邊欄，底層仍依賴本機 teamai 與 Git 認證，改動範圍控制在單文件或單目錄提交。
