dsh-process-board
DSH 服务面板：查看哪些服务由哪个对话（Agent 会话）启动——通过 PEB 环境块读取 DSH_SESSION_ID 归属（包括分离进程），提供三态健康探测和 HTTP 状态码，支持优雅停止、实时查看日志以及重放启动参数。主机扫描由 Agent 启动的服务并标注会话归属；客户端以全屏表格面板显示三态健康状态，支持优雅停止、实时日志和重启重放。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-process-board@0.2.1Process Board 以 dsh-process-board 发布，当前版本为 0.2.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DSH（DeepSeek Harness）服务面板插件——在 Web GUI 侧边栏查看由哪个对话（Agent 会话）启动了哪些服务，支持一键停止、日志实时查看、启动参数登记与重放。
English: A DSH service panel plugin — see which conversation (agent session) started which services, with tri-state health probes, graceful stop, live log tail and restart replay. Zero runtime dependencies, pure-DOM client.
服务面板——按会话分组、三态健康点、HTTP 探测码、端口徽章，一行一服务：
日志分栏——左侧服务列表 + 右侧选中进程的实时日志流（WARN/ERROR 高亮、4s 自动刷新、可全屏）：
| 能力 | 说明 |
|---|---|
| 会话归属 | 通过 DSH 宿主注入的 DSH_SESSION_ID 环境变量（Windows 经 PEB 环境块读取，含 Start-Process 分离进程）+ 宿主进程树血缘双通道，把每个服务归属到启动它的对话，面板按会话中文标题分组 |
| 服务视图 | 三道过滤（端口/日志标记闸门 → npm/cross-env 启动器壳剔除 → nginx master-worker 合并），面板只展示真正的服务，不刷屏子进程 |
| 三态探测 | 🟢 running（端口监听）/ 🟡 pid-alive（进程在、端口未监听，如 java 冷启动）/ ⚫ stopped；附 HTTP 探测响应码列（200/404 都算可达显绿，✗ 红） |
| 启停管理 | 停止走礼貌终止 → 宽限 → 进程树强杀；stopped 行出现「启动」按钮可重放 |
| 日志查看 | 启动时注入 DSH_PB_LOG 环境标记，面板分栏实时 tail（ERROR 红 / WARN 黄高亮，4s 自动刷新，滚动吸底） |
| 全屏 | 面板 ⛶ 铺满视口；日志 ⛶ 覆盖整个面板；Esc 逐级退出 |
前置：已安装 DSH（
dsh命令可用）。dsh plugin底层是 pnpm，以下任一方式均可。
# 方式 A（推荐）：npm 安装——版本语义化，升级方便
dsh plugin --profile web add dsh-process-board
# 方式 B：git 仓库直装（GitHub 或 Gitee 均可，锁定分支最新提交）
dsh plugin --profile web add https://github.com/cyanTao/dsh-process-board.git
# dsh plugin --profile web add https://gitee.com/mr-liangjx/dsh-process-board.git
# 方式 C：clone 后本地链接（可改代码、随改随生效）
git clone https://github.com/cyanTao/dsh-process-board.git ~/dsh-process-board
dsh plugin --profile web add link:~/dsh-process-board
升级（npm 方式）：
dsh plugin --profile web update dsh-process-board
安装后重启 DSH 宿主（重新 dsh web），浏览器刷新页面 → 侧边栏出现「进程面板」入口。
⚠️ 注意
link:只接受本地目录路径。写link:https://...会被当本地链接解析失败，插件卡片显示「未安装」。
卸载：
dsh plugin --profile web remove dsh-process-board
侧边栏「进程面板」→ 全屏居中面板（见上方「效果预览」截图）：
DSH_PB_LOG 标记的进程可用；点 ⛶ 日志区覆盖整个面板让面板"看得见"你起的服务（日志可查、可归属、可停止、可重启）：
# 1. 带日志标记启动（stdout 合流到文件）
export DSH_PB_LOG=/tmp/my-service.log
java -jar app.jar >> /tmp/my-service.log 2>&1 &
# 2. 或直接登记（之后面板「启动」按钮可重放）
curl -X POST http://127.0.0.1:3080/api/plugins/process-board/start \
-H 'content-type: application/json' \
-d '{"name":"my-svc","argv":["java","-jar","app.jar"],"cwd":"/path/to/app","port":8080,"logFile":"/tmp/my-svc.log"}'
PowerShell（Windows）：
$env:DSH_PB_LOG = "$env:TEMP\my-service.log"
Start-Process java -ArgumentList '-jar','app.jar' -RedirectStandardOutput $env:DSH_PB_LOG -WindowStyle Hidden
| 路由 | 方法 | 入参 | 说明 |
|---|---|---|---|
/api/plugins/process-board/state | GET | — | 扫描快照 + 逐服务三态探测 + HTTP 码 |
/api/plugins/process-board/kill | POST | {pid} | 礼貌停止进程树 |
/api/plugins/process-board/log | POST | {pid, lines?} | tail 日志（≤500 行；仅 DSH_PB_LOG 标记路径，防任意文件读取） |
/api/plugins/process-board/start | POST | {name} 或 {name, argv, cwd, port, logFile} | 重放登记 / 显式登记并启动 |
| 层 | Windows | macOS |
|---|---|---|
| 服务面板 UI / API / 登记表 | ✅ | ✅ |
| 端口/HTTP 探测、礼貌停止 | ✅ | ✅（POSIX 信号 + 进程组） |
| 进程扫描 + 会话归属 | ✅（WMI + PEB 环境块读取） | 🚧 待实现（方案：ps + lsof -i + 读 /proc/<pid>/environ，比 Windows PEB 简单；欢迎 PR） |
Mac 当前安装后插件可加载，但扫描器返回空（面板无数据）——
scanner.js中process.platform !== 'win32'提前返回。探测/停止层已跨平台就绪，补 POSIX 扫描器即完整可用。
src/host/ # 宿主侧（node，DSH host 进程内）
scanner.js # 进程扫描：PEB 环境块读 DSH_SESSION_ID + 三道服务过滤
probe.js # 跨平台探测（端口/HTTP/pid）+ 礼貌停止（SIGTERM→SIGKILL / taskkill）
registry.js # 服务登记表 ~/.dsh/gate/process-board/services.json（mkdir 锁 + 原子写）
index.js # 路由：state / kill / log / start + 周期扫描
src/client/index.js # 浏览器侧：侧边栏入口 + 全屏表格面板 + 日志分栏（纯 DOM，零 React）
cordis.patch.yml # web profile 插件行注册
DSH 宿主
└─ shell 工具（注入 DSH_SESSION_ID=<session-uuid>）
├─ 直接子进程 ────────────┐
└─ Start-Process 分离进程 ─┤ env 继承标记
▼
scanner 读每个候选进程的环境块
（Windows: PEB→ProcessParameters→Environment 分页读取）
命中 DSH_SESSION_ID → 归属该会话（面板显示会话中文标题）
未命中但在宿主进程树内 → 归属「宿主进程」组（MCP 子进程等）
MIT