# windows软件进程管理工具

**Repository Path**: user_gitee/ProcPortManager

## Basic Information

- **Project Name**: windows软件进程管理工具
- **Description**: 可管理系统中正在运行中的软件和使用中的端口
- **Primary Language**: C++
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-14
- **Last Updated**: 2026-09-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 进程与端口管理器（ProcPortManager）

面向 **Windows 10 / Windows 11** 的进程与端口管理工具，使用 **C++17 + Qt 6 Widgets** 开发。
单实例运行、支持收回到系统托盘、可一键 UAC 提权；进程表与端口表均可排序、搜索、
定位程序文件并结束进程（结束系统进程时给出分级风险提示）。

> **1.2.0 完成 Windows 11 适配**：可执行文件内嵌应用清单，显式声明 Windows 10/11
> `supportedOS`、PerMonitorV2 DPI 感知与长路径支持；系统版本改用 `RtlGetVersion` 识别，
> 能准确区分 Windows 10 与 Windows 11。详见 [`docs/develop_readme.md`](docs/develop_readme.md) §4。

## 交付物

编译完成的程序位于 **`dist/ProcPortManager/`**，该目录已是完整的绿色免安装版本，
可直接复制到任意 Windows 10/11 x64 电脑运行：

```
dist/ProcPortManager/
├─ 启动程序.cmd              ← 推荐的双击入口：先自检环境，再启动主程序
├─ launch.ps1                ← 启动器脚本（中文提示）
├─ ProcPortManager.exe       ← 主程序（内嵌图标 / 版本信息 / 应用清单）
├─ docs/                     ← 软件介绍与开发说明
├─ config/                   ← 配置（持久化）
├─ logs/                     ← 运行日志（首次运行自动创建）
├─ redist/                   ← 微软官方 VC++ 运行库安装包（备用修复）
└─ Qt 运行库 / 平台插件 / MSVC 运行库
```

> 打包好的发布归档为 `dist/ProcPortManager_v1.2.0_win64.zip`，同目录下附带 `.sha256` 校验值。
> 分发时请**整个目录 / 整个 zip 一起给**——只给 `ProcPortManager.exe` 是无法运行的
> （Qt 平台插件 `platforms\qwindows.dll` 在 exe 之外）。

冒烟验证：

```powershell
# 部署到新电脑后先跑这个：确认随包组件是否齐全（不弹窗，退出码 0 = 通过）
.\dist\ProcPortManager\ProcPortManager.exe --check-runtime --quiet

# 核心链路自检：枚举进程与端口后退出（退出码 0 = 通过，结果写入 logs\）
.\dist\ProcPortManager\ProcPortManager.exe --self-test
echo $LASTEXITCODE

# 布局检查：把加载完数据的主窗口渲染成 PNG 后退出
.\dist\ProcPortManager\ProcPortManager.exe --screenshot shot.png --screenshot-delay 5000

# 托盘行为回归：连续最小化两次，断言只提示一次
powershell -ExecutionPolicy Bypass -File scripts\verify_tray.ps1
```

## 界面特性

* 现代化浅色扁平界面：内置 Fusion 基样式 + 样式表主题，Windows 10 与 Windows 11 外观一致
* 进程页默认只显示**非系统进程**，可在“显示”下拉框切换 全部 / 仅非系统 / 仅系统
* 表格文字单元格内居中，短列按内容自适应、长文本列自动分摊宽度
* 关闭或最小化都收回系统托盘，气泡提示**每次运行只弹一次**

## 文档

| 文件 | 内容 |
| --- | --- |
| [`docs/readme.md`](docs/readme.md) | **软件介绍**：功能总览、使用说明、目录结构、常见问题 |
| [`docs/develop_readme.md`](docs/develop_readme.md) | **开发说明**：架构分层、关键实现、构建与发布流程、验证记录 |

## 从源码构建

前置条件：Visual Studio 2022/2026（含“使用 C++ 的桌面开发”）、Python 3.8+、可访问 `download.qt.io`。

```powershell
# 1) 拉取并拼装 Qt 6 SDK（首次执行，约 5 分钟）
python tools\fetch_qt.py --version 6.8.0 --arch win64_msvc2022_64 ^
    --components qtbase qttools qtsvg --out .qt\6.8.0\msvc2022_64

# 2) 编译并打包到 dist\ProcPortManager
powershell -ExecutionPolicy Bypass -File scripts\build.ps1
```

`scripts\build.ps1` 会自动定位 Visual Studio 与 Qt、选择 CMake 生成器、编译 Release、
运行 `windeployqt`、复制必需的 Qt 插件与 MSVC 运行库，并把 `docs/`、`config/` 放到程序旁边。
构建日志写入 `build-logs\`。

## 工程结构

```
src/
├─ app/    基础设施层：目录解析、日志、配置、单实例、提权、图标、shell 工具
├─ core/   数据与系统层：进程/端口枚举、进程说明知识库、进程控制（无 Widget 依赖）
└─ ui/     界面层：主窗口、托盘、两张标签页及其表格模型与过滤器
```

详细设计请见 [`docs/develop_readme.md`](docs/develop_readme.md)。