前言¶
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 进程有足够的权限访问相关目录。
结语¶
该插件为飞书「算法组」生态提供了本地化的操作入口，降低了调试和维护的门槛。
