READMESource: main@6486d64f
DeepSeek Harness Process Manager (进程管理器)
DeepSeek Harness 专属后台与子进程监控、诊断与生命周期管理插件。支持进程树追踪、残留孤儿进程识别、多层来源归属诊断及一键强制终止。

功能特性
- 完整进程追踪:枚举 DSH Host 及 Electron 派生的所有子进程(Python、Node、Git、PowerShell 等),并扫描父进程退出后残留的孤儿服务。
- 智能来源归属:自动识别插件包名与友好中文别名(如
billion-context-> 上下文压缩),子进程自动继承归属关系;区分系统核心、插件后台、工具命令与终端。 - 安全终止防护:服务端硬编码拦截保护,禁止终止 Host、Electron、渲染及 GPU 核心进程;通过
creationTime校验防御 PID 复用误杀;使用taskkill /F /T递归清理整棵子树并释放文件/端口占用。 - 接口跨站防御:限制本地同源调用(127.0.0.1 / localhost),校验
Sec-Fetch-Site并强制application/json请求头。 - 原生界面集成:侧边栏独立图标入口,支持多维分类筛选、关键词搜索、列头正倒序排序、命令行复制与可暂停的自动轮询。
界面操作
| 功能模块 | 说明 |
|---|---|
| 概览指标 | 实时显示全部进程数、插件服务数、残留孤儿数、工具外部进程数与总体内存占用。 |
| 分类标签 | 支持按全部、插件进程、残留孤儿、工具与命令、DSH 系统核心快速筛选。 |
| 检索与排序 | 支持按 PID、进程名、命令行及插件关键词搜索;支持点击列头(名称/内存/运行时间)升降序排列。 |
| 详情与复制 | 点击行展开抽屉,查看完整命令行、启动绝对时间及插件角色,支持一键复制完整命令。 |
| 终止进程 | 点击「结束进程」经二次确认后强制杀死目标树;核心进程自动处于受保护禁用状态。 |
| 自动刷新 | 支持开启或暂停 3 秒自动轮询,服务端内置 4 秒自适应防抖缓存。 |
Agent 工具
插件向环境注入两个 Agent 工具,支持模型自主排查与释放资源:
dsh_process_list({ category?: "all" | "plugin" | "tool" | "external" | "mcp" }):获取进程列表及归属诊断信息。dsh_process_kill({ pid: number }):强制终止指定 PID 及其子进程树(受保护核心进程自动拒绝)。
目录结构
dsh-process-manager/
├── package.json # 插件清单与 npm scripts
├── cordis.patch.yml # Cordis 服务插槽声明与生命周期配置
├── index.js # Host 后端服务(进程收集、归属推导、安全防护与 API)
├── client.js # Client 前端界面(React 面板、暗黑样式与交互逻辑)
├── test/
│ └── plugin.test.mjs # 回归测试(归属提取、同源防御、核心保护、PID复用校验)
├── locale/ # 多语言配置 (zh.json, en.json)
├── assets/
│ └── preview.png # 界面预览截图
├── icon.svg # 插件矢量图标
└── README.md # 说明文档
测试与验证
运行内置单元与回归测试:
npm test
测试覆盖插件归属提取、同源跨站拦截、核心进程受保护断言及 PID 复用防漂移校验。
环境要求
- 操作系统:Windows 10 / 11 (x64)
- 底层支持:PowerShell 5.1+ / PowerShell 7+ 与 WMI
- 运行时:DeepSeek Harness Desktop Runtime (Node.js 20+)
No comments yet. Be the first to write one.