前言¶
在 DSH 裏做辦公類智能體，常見做法是隻在對話框裏發指令，真正的工作卻落在桌面應用裏：WorkBuddy 裏的報告、千問辦公里的排版、磁盤上的 PDF、羣聊裏的審批。任務狀態和產出往往要來回複製，多個 Bot 也缺少統一的線程和權限邊界。
BotCrew（hankniu77/dsh-botcrew）把 WorkBuddy 與千問辦公（QwenWork）收進同一個 DSH 羣聊：成員、@ 提及、附件、審批卡片和實時工位面板在同一界面完成。維護者爲 GitHub 用戶 hankniu77，分類爲客戶端插件，採用 local-first 設計——不依賴雲端沙箱，不爲辦公應用單獨配置 API Key，也不做屏幕推流；通過 Chromium DevTools Protocol 驅動本機已登錄的 Mac 或 PC 上的應用，並暴露與 mcp__office__* 工具一致的操作。
這是什麼¶
BotCrew 的定位是：一個羣聊，指揮整組桌面 Bot。它在 DSH Desktop 中提供羣聊 UI、本地工位面板服務，以及 MCP 服務端，使 UI 與外部 Agent 都能以同一套接口操作 WorkBuddy 與千問辦公。
插件當前版本爲 0.1.3（見倉庫 package.json），許可證 MIT，要求 DSH Desktop 0.2.1+、Node.js 22+（DSH 自帶運行時即可）。
核心功能¶
多成員羣聊與真實桌面執行¶
羣聊內可包含 Chief、WorkBuddy、千問辦公及自定義成員（最多 10 人，至少保留 1 人）。通過 @ 指定執行者，任務說明、文件與回覆留在同一線程，減少跨窗口搬運。
WorkBuddy 經 CDP 端口 9331 控制，千問辦公經 9444；自定義成員由 qoderclicn（千問 CLI）按名稱與角色真實執行。
文件、產物與審批¶
支持粘貼本地路徑、拖拽或 ＋ 附件 上傳；任務產出以卡片形式回到線程。敏感操作可通過 office_request_approval / office_resolve_approval 掛審批，待辦在工位面板中可見。
實時工位面板¶
本地面板服務綁定 127.0.0.1:8765，只讀爲主：並排展示 WorkBuddy 與千問桌面截圖、當前任務、隊列、調試端口及待審批項。聊天區可打開 工位面板 對照進度。
MCP 與架構¶
每條聊天能力也對應 MCP 工具（如 office_send、office_wait、office_artifacts 等），Agent 可不經過 UI 驅動辦公應用。插件由三部分組成：Host 插件（啓動本地 panel 服務）、Client 插件（羣聊、成員面板、@ 芯片、右側工位面板）、MCP server。
成員權限¶
可爲成員配置 讀 / 寫 / 命令 / 外發 開關。移除正在跑任務的成員時會詢問 停止並移除 / 僅移除 / 取消。頭部 環境 按鈕可隨時重新運行環境檢測。
環境與依賴¶
| 項目 | 要求 |
|---|---|
| 系統 | Windows 10/11 或 macOS 13+ |
| DSH | Desktop 0.2.1+ |
| WorkBuddy | 5.x，已安裝並登錄 |
| QwenWork | 1.4+，已安裝並登錄；CLI 工具 qoderclicn 可用 |
| Node.js | 22+ |
首次打開羣聊時會自動檢測本機應用。典型路徑示例（README 原文）：
Windows: C:/Users/<you>/AppData/Local/Programs/WorkBuddy/WorkBuddy.exe
macOS: /Applications/WorkBuddy.app/Contents/MacOS/WorkBuddy
Windows: .../QwenWorkCN/<version>/resources/bin/qoderclicn.exe
macOS: /Applications/QwenWorkCN.app/Contents/Resources/bin/qoderclicn
已安裝未運行時插件會嘗試帶調試端口自動啓動；已在運行但未開調試端口時，會提示 Restart WorkBuddy / Restart 千問，避免靜默結束未保存的工作。千問 CLI 未登錄時會啓動 qoderclicn login 並輪詢授權狀態。
安裝與啓用¶
推薦從 DSH 插件市場安裝：打開 DSH Desktop → Plugins → Discover，搜索 BotCrew 安裝，再在 Workspace → 對話羣聊 中打開。若列表尚未上架，可使用本地目錄或 Release 包配合 plugin_manager。
本地目錄或解壓 Release 後的安裝方式（README 原文）：
plugin_manager install_bundle { "target": "C:/path/to/dsh-botcrew" }
預構建包可從 GitHub Releases 下載 tarball，解壓後對上述 target 指向解壓目錄執行同一命令。包無 npm 依賴，無需額外 build 步驟。
社區目錄頁：https://www.skillhub.cn/plugins/hankniu77/dsh-botcrew（獨立站點，與 DeepSeek / 幻方無官方從屬關係）。
典型用法¶
- 進入 Workspace → 對話羣聊 → ＋ 新建羣聊。
- 輸入指令，按需
@成員，例如：
@WorkBuddy 把這份 PDF 提煉成 8 頁彙報，先出大綱，數字要能追溯。
@千問辦公 按公司模板 v3 重排，不要改數字。
@Reviewer 檢查第 4 頁的口徑，只回復問題清單。
- 用 ＋ 附件 或拖拽添加文件。
- 在聊天中看進度，需要時打開 工位面板 對照兩側桌面。
- 用 標準 ▾ 切換輸出模式，用 會話 N ▾ 切換線程。
成員管理：若羣聊中尚未包含 WorkBuddy / 千問，可手動添加；自定義成員填寫名稱與角色，由 qwen CLI 執行。
適用場景與注意¶
適合：已在 Windows 或 macOS 上使用 WorkBuddy 5.x 與 QwenWork 1.4+，希望在 DSH 裏用一條線程協調提取、排版、複覈，並需要本地工位可視化與審批門禁的團隊或個人開發者。
注意：
- 插件以當前 DSH 進程權限運行，安裝前請閱讀倉庫源碼與 MIT 許可證，確認路徑與自動化行爲可接受。
- 面板與 CDP 均在本機 127.0.0.1 側完成，README 說明不存儲辦公賬號密碼；仍應對本機已登錄的辦公應用與會話安全自行負責。
- WorkBuddy / 千問版本與調試端口要求需滿足 README 中的 Requirements，否則首次運行設置卡片會持續提示修復。
結尾¶
BotCrew 把「一個羣聊 + 真實桌面 Bot + 產物與審批留在線程裏」落到 DSH 客戶端插件與 MCP 雙通道上，適合 local-first 的辦公自動化編排。進一步瞭解可查看目錄頁 skillhub.cn/plugins/hankniu77/dsh-botcrew 與源碼倉庫 github.com/hankniu77/dsh-botcrew。
