DeepSeek Harness (DSH) 的核心设计理念是「一切皆插件」。在开发智能体或本地服务时,我们经常需要启动并维持后台进程(如数据库、后端服务)。在 DSH 的 CLI 或旧式界面中,管理这些进程通常需要多个命令组合,日志查看也不够直观。dsh-process-panel 插件将进程管理能力引入 Web GUI 侧栏,让你在图形界面中直接操作这些进程,同时为 AI 侧提供了对应的工具集。
插件简介¶
dsh-process-panel 是一个位于 DeepSeek Harness Web GUI 侧栏的进程管理插件,由用户 ALIWUER 维护。它解决了在图形界面中管理长时后台进程的需求,支持启动、停止、重启、查看实时日志等操作,同时也为 AI 侧提供了对应的工具链。
核心功能¶
- 侧栏入口与状态显示:侧栏底部有「进程任务」入口,显示运行中的任务数。面板支持运行中、孤儿进程、已失效、已停止、已退出、启动失败等多种状态。
- 进程操作:支持重启、停止、终止(针对孤儿进程)以及清除操作。列表顶部还有「清理已结束」按钮。
- 日志查看:日志支持自动跟随底部,手动滚动即可暂停跟随,滚回底部恢复。
- AI 工具集成:提供
sv_start、sv_stop、sv_restart、sv_logs、sv_list、sv_clear工具,AI 可直接通过自然语言控制进程。 - 共享列表:所有会话与 GUI 面板共享同一份任务列表。
安装与启用¶
安装前请确保环境满足以下依赖:
* DeepSeek Harness 0.1.1-rc.2
* Node.js ^22.19.0 || >=24.0.0
* pnpm 11
执行以下命令安装插件:
dsh plugin --profile web add github:ALIWUER/dsh-process-panel#v0.5.0
安装完成后,重启 DSH Web 进程(或刷新 GUI 页面),侧栏底部(设置旁边)会出现「进程任务」入口。
典型用法¶
GUI 操作:点击侧栏底部的「进程任务」打开面板。左侧列表显示任务状态,右侧显示实时日志。选中任务后,可点击「重启」、「停止」等按钮。
AI 命令:
* sv_start:启动指定任务。
* sv_restart:重启指定任务。
* sv_stop:停止指定任务。
* sv_logs:查看指定任务的日志。
* sv_list:列出当前所有任务。
* sv_clear:清理已结束的任务。
适用场景与注意¶
依赖要求:插件依赖 DeepSeek Harness 0.1.1-rc.2。请确保宿主版本与插件依赖版本一致,否则可能无法正常工作。
进程权限:插件以当前 DSH 进程的权限运行,进程的输出权限和端口占用受限于 DSH 的启动配置。
孤儿进程处理:如果 DSH 进程被强制杀掉(kill -9),残留的孤儿进程无法读取输出(管道已断开),面板只能显示 PID 并提供终止操作。
命令执行方式:sv_start 中的 command 参数是直接通过 spawn 执行的,不经过 shell 解析。如需管道或重定向,需自行通过 bash -c '...' 包裹命令。
该插件将进程管理的命令行操作转化为可视化的侧栏交互,并打通了 AI 工具链,适合需要在 DSH 环境中频繁管理后台服务的开发者。更多细节请查看插件目录或 GitHub 仓库。