# DSH Service Console

[English](./README.md) | **简体中文**

[![License](https://img.shields.io/github/license/Jiyr0119/dsh-service-console)](LICENSE)
[![npm](https://img.shields.io/npm/v/@jiyr0119/dsh-service-console)](https://www.npmjs.com/package/@jiyr0119/dsh-service-console)
[![npm downloads](https://img.shields.io/npm/dt/@jiyr0119/dsh-service-console)](https://www.npmjs.com/package/@jiyr0119/dsh-service-console)
[![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
[![Last commit](https://img.shields.io/github/last-commit/Jiyr0119/dsh-service-console)](https://github.com/Jiyr0119/dsh-service-console)
[![GitHub stars](https://img.shields.io/github/stars/Jiyr0119/dsh-service-console?style=social)](https://github.com/Jiyr0119/dsh-service-console/stargazers)

<p align="center">
  ⭐ 顺手留颗 Star，作者能高兴一整天 · <a href="https://github.com/Jiyr0119/dsh-service-console">行，给你一颗 Star</a>
</p>

> A local development service console for DSH: discover listening ports, identify services related to the current conversation or workspace, and safely inspect, stop, or restart them.
>
> **DSH 本地开发服务控制台：发现监听端口，识别与当前对话或工作区相关的服务，并安全地查看、停止和重启。**

面向 DeepSeek Harness Web UI 的单职责插件。当模型（或你）启动本地开发服务（`npm run dev`、Vite、Next.js、Uvicorn、Express、Rust 等）时，Service Console 在一个地方把它们展示出来：监听了哪些端口、由什么命令和目录启动、是否属于当前对话或工作区、能否安全停止或重启。

## 功能

- **服务发现** — 扫描监听 TCP 端口，关联 PID、PPID、命令、工作目录、进程组与启动时间（macOS/Linux）。
- **归属与风险** — 五级归属：`本次对话`（与会话启动台账匹配）、`工作区`、`本机其他`、`未知`、`受保护`。
- **受控操作** — 对进程组优雅停止；对保存了安全启动命令的服务重启。每个动作均二次确认，并在操作前重新校验快照。
- **安全防护** — 任何信号前校验 PID 复用 / fingerprint；未知与受保护服务只读；强制终止默认关闭；无隐式自动清理；命令输出脱敏。
- **全量本机服务** — 展示本机全部监听服务；归属只作为安全提示，不再隐藏端口分类，用户可自行选择要查看或停止的服务。
- **搜索 / 配置 / 国际化** — 支持关键字过滤、优雅超时 / 强制终止设置；中英文界面自动跟随 DSH 当前语言。
- **按需扫描** — 打开控制台时获取一次当前快照；点击刷新按钮才会主动重新扫描，不进行后台定时轮询。
- **DSH 原生检查卡片** — 展开详情采用 DSH Web token 化视觉风格，展示进程身份、端口、命令、工作目录和归属证据。

## 安装

原生安装（推荐）：

```bash
dsh plugin --profile web add -w @jiyr0119/dsh-service-console@latest
```

安装后刷新 DSH Web UI——会话头部出现 `🖥 SC` 入口，点击打开控制台面板。

> 注意：插件被 dsh-market/awesome 收录 ≠ 浏览器自动出现 UI。本包同时提供 Host 路由与浏览器 bundle，`dsh plugin add` 后面板即可用。支持 macOS / Linux；Windows 暂不支持。

备用方式——动态粘贴（零构建、进程级）：通过动态 Cordis 插件流程粘贴 `dynamic/host.js` + `dynamic/client.js`。

## 界面预览

![Service Console 0.2.0：全量本机服务与 DSH 风格检查卡片](./assets/service-console-0.2.0.gif)

预览展示本机完整监听服务列表与展开后的检查卡片。归属徽标仍作为安全提示保留，但列表不再按对话 / 工作区 / 本机拆分隐藏服务。

**[→ 交互式演示](./demo/index.html)** — 无需安装即可在浏览器中体验 Service Console 界面。

## 权限与安全

- Client 不直接传任意 PID 或 Shell 命令，只以 service ID 为目标，Host 在操作前重新校验 PID / 启动时间 / fingerprint。
- 优先优雅终止（SIGTERM 到进程组）；SIGKILL 仅在显式开启并确认后使用。
- 命令摘要中的敏感 token/密码会脱敏。
- 本插件**不是**通用进程管理器：系统关键、高权限、未知和受保护进程一律只读。

## 开发

```bash
pnpm install
npm run typecheck
npm run build
npm test          # 单元 + 集成测试（node --test）
```

## 测试

`npm test` 会先构建一次，再用 Node 内置测试运行器（`node --test`）执行整个测试套件，无需额外测试框架。

| 文件 | 类型 | 覆盖内容 |
| --- | --- | --- |
| `test/process-inspector.test.mjs` | 单元测试 | 平台输出解析（`parseLstart`、`parseListenRows`、`parsePsRows`、`parseAddress`）、命令脱敏、五级归属分类 |
| `test/host-more.test.mjs` | 单元测试 | 配置校验、会话台账、基于 fake 依赖的生命周期状态机（停止/重启）、服务聚合与 fingerprint 稳定性 |
| `test/integration.test.mjs` | 集成测试 | 真实系统命令 + 测试自建的临时 HTTP 服务；只对测试自有进程发信号 |

```bash
npm test                                                       # 全部用例
npm run build && node --test test/process-inspector.test.mjs   # 单独运行某个文件
```

单元测试直接 import 构建产物（`lib/`），因此需要先编译源码——`npm test` 会自动完成。

## 许可证

MIT