# dsh-process

**Repository Path**: DaFei_93/dsh-process

## Basic Information

- **Project Name**: dsh-process
- **Description**: DSH process hygiene plugin
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-15
- **Last Updated**: 2026-08-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# dsh-process — DSH 进程卫生

> DSH（DeepSeek Harness）插件：会话结束自动清理该会话期间 spawn 的进程树，防止残留进程堆积。

## 解决的问题

长会话中 Agent 会启动各种子进程（脚本、服务、构建工具等），会话结束或失败后这些进程可能残留，占内存、占端口、互相干扰。本插件在会话结束时自动清理：

- **会话隔离**：记录每个会话 spawn 的进程树，会话结束按组清理（`taskkill /T /F`）。
- **白名单豁免**：系统关键进程 / 用户明确豁免的进程不杀（保守不误杀）。
- **孤儿仅上报**：无法确认归属的孤儿进程只记录上报，不擅自杀掉。
- **TDD 覆盖**：17/17 单测（快照 diff / 豁免 / 清理清单 / 进程注册表 / 孤儿判定）。

## 使用（Agent 视角）

- 只读查询：`process_list`（当前跟踪的会话与最近清理历史）。

## 安装

- `package.json`：`dependencies` 加 `"dsh-process": "git+https://gitee.com/DaFei_93/dsh-process.git"`，`dsh.profile.bundles` 加 `"dsh-process"`。

## 安全策略

- 白名单保守：拿不准就不杀。
- 清理仅限「本会话期间 spawn 的」进程树，不动用户手动启动的进程。

## 许可

MIT