Introduction¶
DeepSeek Harness (DSH) adopts the philosophy of “everything is a plugin.” For developers of the Feishu “Algorithm Group” three-persona bots (yoga / Zi Yang / Huang Na), maintaining and debugging these bots in a local environment often requires frequently managing daemon processes, checking runtime status, and viewing recent activity. This plugin aims to provide a lightweight local control method by integrating management operations into the DSH Desktop interface.
Plugin Purpose¶
This is a DSH local console plugin maintained by CAI-MH. It does not include the bots themselves, but exists as a control panel. Users can see a floating button in the bottom-right corner of DSH Desktop, which is used to operate background daemon processes and view information.
Core Features¶
The plugin mainly provides the following features:
- Process Control: Start, stop, or reconnect daemon processes through the floating button.
- Status Monitoring: Display status indicators and recent activity.
- Workspace Shortcut: Quickly jump to the task workspace.
File Structure¶
The plugin includes the following key files:
index.js: Responsible for the Host side; it uses the local/api/agent-group/*endpoints and launchd to manage daemon processes.client.js: Responsible for the browser side; it provides the floating button and interactive panel, communicating via same-origin HTTP.cordis.patch.yml: Patch configuration for the Host composite plugin.package.json: Bundle metadata.
Installation and Activation¶
The plugin is registered via a bundle. You need to modify the package.json in the web profile and add the corresponding configuration under dependencies and dsh.profile.bundles. A copy is retained in the node_modules directory.
To modify the plugin code:
- Make changes in the plugin source directory.
- Copy the modified files to the corresponding location in
node_modules. - Restart DSH Desktop.
Configuration and Directory Migration¶
The daemon process itself (launchd ai.dsh.feishu-agent-group) and the bot data are not included in this bundle. They are located in the feishu-agent-group/ directory (default path ~/work/dph/feishu-agent-group/), which contains daemon.mjs, personas.json, knowledge/, and tasks/.
If you need to migrate the daemon process directory, do not modify the source code of this bundle. Instead, modify the patch configuration of the web profile:
~/Library/Application Support/dsh-desktop/harness/profiles/web/cordis.patch.yml
- id: agent-group-panel
config:
base: ~/work/dph/feishu-agent-group
After changing base, restart DSH Desktop to make the change take effect (also ensure that the path in the launchd plist is updated simultaneously).
Applicable Scenarios and Notes¶
This plugin is suitable for developers who need to manage the specific three-persona bot ecosystem in a local DSH Desktop environment. Before using it, ensure that the current dsh process has sufficient permissions to access the relevant directories.
Conclusion¶
This plugin provides a localized operation entry point for the Feishu “Algorithm Group” ecosystem, reducing the barrier to debugging and maintenance.