前言¶
DeepSeek Harness（DSH）採用「一切皆插件」的理念。對於飛書「算法組」三人格機器人（yoga / 子揚 / 黃拿）的開發者而言，在本地環境維護和調試這些機器人時，需要頻繁管理守護進程、查看運行狀態與動態。這個插件旨在提供一種輕量級的本地控制方式，將管理操作集成到 DSH Desktop 的界面中。
插件定位¶
這是一個 DSH 本地控制台插件，由 CAI-MH 維護。它不包含機器人本體，而是作爲一個控制面板存在。用戶在 DSH Desktop 右下角可以看到懸浮按鈕，用於對後臺守護進程進行操作和查看信息。
核心功能¶
插件主要提供以下功能：
1. 進程控制：通過懸浮按鈕開啓、關閉或重連守護進程。
2. 狀態監控：顯示狀態指示燈與最近動態。
3. 工作區直達：快速跳轉到任務工作區。
文件結構¶
插件包含以下關鍵文件：
* index.js：負責 Host 半部分，通過 /api/agent-group/* 本機接口利用 launchd 管理守護進程。
* client.js：負責瀏覽器半部分，提供懸浮按鈕與交互面板，通過同源 HTTP 通信。
* cordis.patch.yml：Host 組合插件的補丁配置。
* package.json：Bundle 元數據。
安裝與生效¶
插件通過 bundle 的方式註冊。需要修改註冊在 web profile 的 package.json，在 dependencies 和 dsh.profile.bundles 中添加對應配置。node_modules 目錄下會保留一份副本。
若要修改插件代碼：
1. 在插件源碼目錄進行修改。
2. 將修改後的文件重新拷貝至 node_modules 對應位置。
3. 重啓 DSH Desktop。
配置與目錄遷移¶
守護進程本體（launchd ai.dsh.feishu-agent-group）與機器人數據不在此 bundle 內，它們位於 feishu-agent-group/ 目錄（默認路徑爲 ~/work/dph/feishu-agent-group/），包含 daemon.mjs、personas.json、knowledge/、tasks/。
如果需要遷移守護進程目錄，不要修改本 bundle 的源碼，而是修改 web profile 的補丁配置：
~/Library/Application Support/dsh-desktop/harness/profiles/web/cordis.patch.yml
- id: agent-group-panel
config:
base: ~/work/dph/feishu-agent-group
修改 base 後重啓 DSH Desktop 即可生效（同時需確保 launchd 的 plist 路徑同步修改）。
適用場景與注意¶
該插件適合需要在 DSH Desktop 本地環境中管理特定三人格機器人生態的開發者。使用前請確保當前 dsh 進程有足夠的權限訪問相關目錄。
結語¶
該插件爲飛書「算法組」生態提供了本地化的操作入口，降低了調試和維護的門檻。
