[1.5.2 Patch] 端口管理进阶特色增强：软件识别库、智能快捷操作、项目联动与证据评分体系

[weidonglang]

背景

当前已经有 #66 端口检测全面增强，主要聚焦识别准确性、详情解释、风险分级、历史记录和项目端口联动收口。

但用户进一步希望端口管理不只是“能扫描端口”，而是成为 DevEnv Manager 的特色功能之一：

• 能自动识别更多类型的软件和开发服务端口。
• 准确性不能差，不能靠端口号乱猜。
• 能提供更多快捷操作。
• 能结合项目、进程、服务、命令行、历史记录给出实用建议。
• 仍然不要新增抓包、防火墙、网络监控等新方向。

本 issue 是 #66 的进阶补充，用于把端口管理做得更有特色、更实用、更可信。

总目标

端口管理应升级为：

本机开发端口识别与安全处理面板

核心体验：

我看到一个端口被占用 → 软件告诉我它大概率是什么 → 为什么这么判断 → 是否会影响我的项目 → 我能安全做哪些操作

不做什么

本任务仍然不做：

• 抓包。
• 网络流量监控。
• 防火墙管理。
• 入侵检测。
• 端口扫描远程主机。
• 自动结束进程。
• 自动修改系统网络设置。
• 自动修改项目端口。
• 上传端口数据。

只增强现有本机端口管理。

---

一、建立端口软件识别库

1. 识别库设计

新增或统一一个轻量端口识别规则库，例如：

PortAppSignature {
    id: String,
    category: String,
    display_name: String,
    process_names: Vec<String>,
    path_keywords: Vec<String>,
    command_keywords: Vec<String>,
    service_keywords: Vec<String>,
    common_ports: Vec<u16>,
    risk_hint: String,
    safe_actions: Vec<String>,
}

识别时不能只看端口号，必须计算证据得分。

2. 必须覆盖的软件 / 服务类型

Java / 后端开发

• Spring Boot
• Tomcat
• Jetty，如可识别
• Netty，如可识别
• Maven 启动的 Java 服务
• Gradle bootRun
• Nacos
• Sentinel Dashboard
• Seata
• Jenkins
• Nexus
• SonarQube

Node / 前端开发

• Vite
• Webpack Dev Server
• Next.js
• Nuxt
• React Scripts
• Astro
• Vue CLI
• npm / pnpm / yarn dev server

Python Web / AI / 脚本服务

• Flask
• Django
• FastAPI
• Uvicorn
• Gunicorn，如 Windows 下可识别
• Jupyter Notebook / JupyterLab
• Streamlit
• Gradio
• ComfyUI
• Stable Diffusion WebUI
• Ollama
• LM Studio，如可识别

Go / Rust / .NET 开发服务

• Go 本地 HTTP 服务，如 commandLine/path 有项目证据
• Rust actix / axum / tauri dev，如可识别
• ASP.NET Core / dotnet run

数据库与中间件

• MySQL
• PostgreSQL
• Redis
• MongoDB
• Elasticsearch
• RabbitMQ
• Kafka，如可识别
• MinIO
• Consul
• Etcd

Web 服务器 / 反向代理

• Nginx
• Apache HTTPD
• Caddy

桌面应用 / WebView / 常见误判对象

必须优先正确识别，避免误判为开发服务：

• Steam / steamwebhelper.exe
• QQ
• WeChat
• Chrome
• Edge
• Firefox
• VS Code
• Discord
• Telegram
• OneDrive
• 百度网盘
• 其他 Electron / WebView 应用，如只能低置信度识别则不要强判

Docker / WSL / 虚拟化相关

• Docker Desktop 代理或后端进程
• WSL 相关代理进程
• Hyper-V / WSL 网络相关进程，如可安全识别

要求：识别不了时宁可显示 unknown / low confidence，不要乱标。

---

二、证据评分与置信度体系

1. 证据来源

识别一个端口时，至少考虑：

进程名
进程路径
命令行
父进程
Windows 服务名
本地端口
连接状态
当前已分析项目配置
最近历史记录
是否在 DevEnv Manager 受管目录或项目目录内

2. 得分规则

建议：

进程名强命中：+40
命令行强命中：+35
服务名强命中：+30
路径关键词命中：+20
项目配置端口命中：+25
端口号命中：+5 到 +10
仅端口号命中：最高只能 low confidence
桌面应用进程命中：优先覆盖开发端口推断

3. 置信度

high：多个强证据一致，例如进程名 + commandLine。
medium：一个强证据或多个弱证据。
low：只有端口号或模糊路径。
unknown：证据不足。
conflict：证据冲突，例如端口像 Spring，但进程名是 Steam。

4. UI 展示

端口详情必须显示：

识别结果：Spring Boot / Steam WebView / Unknown
置信度：high / medium / low / conflict
证据：java.exe + commandLine 包含 spring-boot
反证：无
建议：可以打开浏览器访问 / 不建议结束 / 建议检查项目端口

---

三、智能快捷操作增强

快捷操作必须安全、可解释，不能危险自动化。

1. 通用快捷操作

每条端口记录应提供：

• 复制端口号。
• 复制 PID。
• 复制进程路径。
• 复制命令行摘要。
• 打开进程所在目录。
• 查看端口详情。
• 刷新该端口。
• 复制诊断摘要。

2. HTTP 服务快捷操作

如果端口是 HTTP 类服务或疑似 HTTP 服务，提供：

• 打开 http://127.0.0.1:<port>。
• 打开 http://localhost:<port>。
• 复制 curl 命令。
• 检测 HTTP 响应状态，如现有能力允许，只做轻量 HEAD/GET，不新增监控。

注意：如果无法确认是 HTTP，按钮显示为“尝试打开浏览器”，并说明可能失败。

3. 开发服务快捷操作

对 Spring Boot / Vite / Node / Python Web 等：

• 打开本地地址。
• 复制启动/检查建议。
• 跳转项目端口配置分析，如已选择项目。
• 查看是否与当前项目端口冲突。

4. 数据库 / 中间件快捷操作

对 MySQL / Redis / PostgreSQL 等：

• 复制连接命令示例。
• 打开服务详情。
• 跳转本地服务检查。
• 不直接停止服务，除非经过高风险确认。

示例：

MySQL 3306：复制 mysql -h 127.0.0.1 -P 3306 -u root -p
Redis 6379：复制 redis-cli -h 127.0.0.1 -p 6379

5. 桌面应用快捷操作

对 Steam / QQ / WeChat / 浏览器 / 网盘：

• 打开进程目录。
• 复制进程信息。
• 标记“普通桌面应用，不建议仅因端口号结束”。
• 不显示开发服务建议。

6. 结束进程按钮规则

结束进程按钮必须更保守：

• 开发服务：可显示，但仍需确认。
• 数据库 / 本地服务：默认谨慎，强提示。
• 桌面应用：默认不推荐结束。
• 系统服务 / 权限不足 / 安全软件：阻止或隐藏。

---

四、端口冲突处理建议

如果某端口与常见开发端口冲突，应给出可选建议：

方案 A：确认占用进程是否可关闭
方案 B：修改当前项目端口
方案 C：停止对应开发服务
方案 D：换用其他端口

但不自动执行。

对当前已分析项目，显示：

你的项目配置端口：8080
当前占用进程：steamwebhelper.exe
判断：不是当前项目进程，可能造成启动冲突
建议：不要结束 Steam 前先确认；也可以把项目端口改为 8081，并先备份配置文件

---

五、常见端口知识库

可内置轻量说明，不联网：

3000：常见前端开发端口，但也可能被其他应用占用。
5173：Vite 默认端口，但必须结合 node.exe / vite 命令行判断。
8080：常见 Java Web / Tomcat / Spring Boot，但也常被 Steam/QQ/WebView 占用。
3306：常见 MySQL，但必须结合 mysqld.exe 或服务名判断。
6379：常见 Redis，但必须结合 redis-server.exe 判断。

UI 中应明确：

端口号只是弱证据。

---

六、端口历史和常用占用画像

增强最近 7 天历史：

• 端口最近被哪些进程占用。
• 哪个进程最常占用。
• 是否经常是桌面应用占用。
• 是否经常与当前项目冲突。
• 最后出现时间。

示例：

8080 最近 7 天出现 12 次，其中 9 次为 steamwebhelper.exe，2 次为 java.exe，1 次为 unknown。
判断：该端口在本机经常被 Steam 占用，启动 Java 项目前建议先检查。

注意隐私：历史不保存敏感 commandLine 全量内容，必要时脱敏用户目录、token、密码参数。

---

七、项目联动进一步增强

如果用户在项目启动向导里分析过项目，端口管理应能显示：

• 当前项目声明的端口。
• 当前端口是否被占用。
• 占用进程是否属于当前项目。
• 如果不是，展示冲突原因。
• 提供“跳转项目端口配置”或“生成端口修改预览”。

修改项目端口必须：

• 先备份。
• 预览 diff。
• 用户确认。
• 不自动覆盖未知配置。

---

八、UI 体验要求

建议新增或优化：

1. 顶部端口状态摘要

监听端口：x 个
开发服务：x 个
数据库/中间件：x 个
桌面应用：x 个
高风险/系统服务：x 个
低置信度：x 个

2. 快捷筛选

保留现有筛选并增强：

全部
开发服务
前端
Java
Python
数据库
中间件
桌面应用
系统/高风险
低置信度
当前项目冲突

3. 详情卡片

端口详情不只显示文本，要结构化：

基本信息
进程信息
识别证据
风险与建议
快捷操作
历史记录
项目联动

---

九、准确性要求

必须遵守：

• 证据不足时不要强结论。
• 端口号不能单独决定软件类型。
• 桌面应用强证据优先于开发端口弱证据。
• 识别结论必须可解释。
• 每个规则要能测试。
• 不为追求“看起来智能”而乱猜。

---

十、测试要求

新增测试 fixture，至少覆盖：

steamwebhelper.exe + 8080 → Steam WebView，高置信度，不是 Spring
QQ.exe + 8082 → QQ 客户端，高置信度，不是 Spring
java.exe + spring-boot commandLine + 8080 → Spring Boot，高置信度
java.exe + catalina + 8080 → Tomcat，高置信度
node.exe + vite + 5173 → Vite，高置信度
node.exe + next dev + 3000 → Next.js，高置信度
python.exe + uvicorn + 8000 → FastAPI/Uvicorn，高置信度
python.exe + flask + 5000 → Flask，中高置信度
python.exe + jupyter + 8888 → Jupyter，高置信度
mysqld.exe + 3306 → MySQL，高置信度
redis-server.exe + 6379 → Redis，高置信度
postgres.exe + 5432 → PostgreSQL，高置信度
nginx.exe + 80/443 → Nginx，高置信度
unknown.exe + 8080 → unknown/low，不强判 Spring
ESTABLISHED 状态 → 不当作本地监听服务
权限不足 commandLine 缺失 → UI 不崩溃，显示证据不足

---

十一、文档更新

更新：

• docs/user-guide.md
• docs/troubleshooting.md
• docs/release-v1.5.2.md
• docs/issues-57-71.md

文档说明：

• 端口识别为什么不能只看端口号。
• 如何理解置信度。
• 如何判断能不能结束进程。
• 常见端口可能对应的软件。
• 如何处理项目端口冲突。

---

十二、验收标准

• 端口管理能识别更多开发服务、数据库、中间件、桌面应用。
• 识别准确性明显提升，不再靠端口号乱猜。
• 每条识别结果都有证据和置信度。
• 提供更多安全快捷操作。
• 项目端口冲突说明更清晰。
• 历史记录能帮助判断常见占用。
• 结束进程仍然保守、安全、可确认。
• 不新增抓包、防火墙、网络监控等方向。
• cargo test --all-targets 通过。
• npm run build 通过。
• release notes 记录该端口管理特色增强。

[weidonglang]

补充：进一步扩大端口识别范围与增强重点

在 #71 原有基础上继续加强，但仍保持边界：只做本机开发端口识别与安全处理，不做抓包、防火墙、远程扫描或网络流量监控。

---

一、进一步扩大识别范围

1. Java / JVM 生态

除原有 Spring Boot、Tomcat、Maven、Gradle、Nacos、Sentinel、Seata、Jenkins、Nexus、SonarQube 外，补充识别：

• Undertow：常见于 Spring Boot 内嵌服务器。
• Jetty：jetty、start.jar、org.eclipse.jetty。
• Netty：netty、reactor-netty，只作为弱到中等证据，避免误判。
• Quarkus：quarkus、quarkus-run.jar、默认 8080。
• Micronaut：micronaut、io.micronaut。
• Dubbo：dubbo，常见 20880，但端口号仅作弱证据。
• Zookeeper：zookeeper、zkServer，常见 2181。
• Eureka：eureka，常见 8761。
• Spring Cloud Gateway：gateway、spring-cloud-gateway。
• Admin / actuator 类服务：只在 commandLine 或项目配置有证据时标记。

2. 前端 / Node 生态

除 Vite、Webpack、Next、Nuxt、React Scripts、Astro、Vue CLI 外，补充识别：

• Angular CLI：ng serve、@angular/cli，常见 4200。
• SvelteKit：svelte-kit、vite dev。
• Storybook：storybook，常见 6006。
• Parcel：parcel。
• Remix：remix dev。
• NestJS：nest start、@nestjs，常见 3000。
• Express / Koa / Hapi：只有 commandLine、package.json 或项目路径证据时识别，不靠端口号强判。
• Electron dev server：electron、electron-vite、vite 组合证据。
• Tauri dev：tauri dev、cargo tauri dev、vite 组合证据。

3. Python Web / 数据科学 / AI 本地服务

除 Flask、Django、FastAPI、Uvicorn、Jupyter、Streamlit、Gradio、ComfyUI、Stable Diffusion WebUI、Ollama、LM Studio 外，补充识别：

• Hypercorn：hypercorn。
• Waitress：waitress-serve。
• Celery Flower：flower，常见 5555。
• Airflow Webserver：airflow webserver，常见 8080。
• MLflow UI：mlflow ui，常见 5000。
• TensorBoard：tensorboard，常见 6006。
• Ray Dashboard：ray dashboard，常见 8265。
• Jupyter Server / Lab：jupyter server、jupyter-lab、notebook，常见 8888。
• vLLM OpenAI server：vllm.entrypoints.openai.api_server，常见 8000。
• llama.cpp server：llama-server 或相关可执行文件。
• text-generation-webui：server.py + 项目路径关键词，只作中等证据。
• Dify / FastGPT / AnythingLLM 本地相关服务：如能从 Docker/Node/Python 证据判断则低到中等置信度。

4. Go / Rust / .NET / PHP / Ruby

补充识别：

• Go HTTP 服务：go run、可执行文件位于 Go 项目目录、命令行含 main.go、gin、fiber、echo，端口号只作弱证据。
• Rust Web 服务：cargo run、actix、axum、rocket。
• Tauri dev sidecar / dev server：结合 cargo tauri dev、vite。
• ASP.NET Core：dotnet run、Kestrel、ASPNETCORE_URLS，常见 5000/5001/7xxx。
• PHP 内置服务器：php -S，常见 8000。
• Laravel：artisan serve，常见 8000。
• Rails：rails server、puma，常见 3000。

5. 数据库 / 中间件 / 基础设施

在原有 MySQL、PostgreSQL、Redis、MongoDB、Elasticsearch、RabbitMQ、Kafka、MinIO、Consul、Etcd 基础上补充：

• MariaDB：mariadbd.exe、mysqld.exe + MariaDB 路径/版本证据。
• SQL Server：sqlservr.exe，常见 1433。
• Oracle XE：oracle.exe / listener，常见 1521，只作谨慎识别。
• ClickHouse：clickhouse-server，常见 8123/9000。
• InfluxDB：influxd，常见 8086。
• Prometheus：prometheus，常见 9090。
• Grafana：grafana-server，常见 3000。
• Kibana：kibana，常见 5601。
• Logstash：logstash，常见 5044/9600。
• ZooKeeper：zookeeper，常见 2181。
• ActiveMQ：activemq，常见 61616/8161。
• RocketMQ：mqnamesrv、broker，常见 9876、10911。
• EMQX / Mosquitto：MQTT 服务，常见 1883/8883。

6. Web 服务器 / 代理 / 网关

补充识别：

• Nginx：nginx.exe，80/443/8080。
• Apache HTTPD：httpd.exe。
• Caddy：caddy.exe。
• Traefik：traefik。
• FRP：frps、frpc。
• Clash / Mihomo / V2Ray / Xray / sing-box：只识别为本地代理工具，不标记为 Web 服务。
• Charles / Fiddler / Proxyman：识别为调试代理，避免误判为开发后端。

7. IDE / 调试器 / 开发工具

补充识别：

• IntelliJ IDEA / JetBrains Gateway / JetBrains IDE backend。
• VS Code / Code.exe。
• Visual Studio / devenv.exe。
• Android Studio。
• adb.exe / Android emulator / emulator.exe。
• Chrome DevTools remote debugging：常见 9222，但必须结合 chrome.exe / msedge.exe 命令行。
• Node inspector：常见 9229，必须结合 node.exe + inspector 参数。
• Java debug：常见 5005，必须结合 java.exe + JDWP 参数。
• Python debugpy：常见 5678，必须结合 python.exe + debugpy 参数。

这些调试端口要标记为“调试端口 / 谨慎”，不要当成普通 Web 服务。

8. 桌面应用 / WebView / 常见误判对象

继续扩大桌面应用白名单和低风险识别：

• Steam / steamwebhelper.exe。
• QQ / TIM。
• WeChat / WeCom。
• Chrome / Edge / Firefox。
• VS Code / Cursor / Trae / Windsurf 等编辑器。
• Discord / Telegram。
• OneDrive / 百度网盘 / 阿里云盘 / 坚果云。
• Spotify / 网易云音乐 / QQMusic。
• Epic Games / Battle.net / Riot Client。
• Electron / WebView 应用：如果只有 Electron 外壳证据，标记为“桌面 WebView 应用”，不要强判业务类型。

9. Docker / WSL / 容器相关

增强识别：

• com.docker.backend.exe。
• Docker Desktop 代理进程。
• wslhost.exe。
• vmmem / WSL 相关提示，但不要尝试结束。
• 端口可能来自 Docker 端口映射时，提示“可能是容器映射端口，需要结合 docker ps 确认”。
• 如已有 Docker 检查功能，可提供跳转到 Docker / WSL 检查，但不要新增复杂容器管理。

---

二、我认为还应该加强的地方

1. 增加“误判抑制规则”

识别规则不只要会命中，还要会主动避免误判。

示例：

如果进程名是 steamwebhelper.exe，即使端口是 8080，也不能标 Spring/Tomcat。
如果进程名是 QQ.exe，即使端口是 8082，也不能标 Spring。
如果只有端口 3306，但进程不是 mysqld/mariadbd/sqlservr，不能标数据库。
如果状态不是 LISTENING，不能标为本地监听服务。

2. 增加“冲突证据”展示

端口详情除“证据”外，还应展示“反证 / 冲突证据”。

示例：

端口号 8080 像 Java Web 服务，但进程名 steamwebhelper.exe 明确指向 Steam WebView，因此最终识别为 Steam。

3. 增加“可执行性建议”而不是只显示识别结果

每条端口应给出建议：

可以安全打开浏览器访问
建议先查看项目端口配置
不建议结束桌面应用
高风险：不要结束系统服务
数据库服务：结束前确认是否有项目正在连接

4. 增加“端口冲突助手”

当用户输入或选择一个项目端口时，给出三类判断：

端口空闲：可以使用。
端口被当前项目占用：可能已启动。
端口被其他进程占用：可能冲突。
端口被桌面应用占用：建议改项目端口或关闭对应应用。
端口被数据库/系统服务占用：不建议抢占。

5. 增加“规则测试 fixture”

端口识别必须可测试，不能只靠手动试。

建议新增：

tests/fixtures/ports/*.json

每个 fixture 包含：

{
  "processName": "steamwebhelper.exe",
  "port": 8080,
  "state": "LISTENING",
  "commandLine": "...",
  "expectedLabel": "Steam WebView",
  "expectedConfidence": "high",
  "mustNotContain": ["Spring", "Tomcat"]
}

6. 增加“规则覆盖报告”

测试或构建时输出：

端口识别规则数量
已覆盖的软件类别
fixture 通过数量
高风险误判防护数量

这能让端口管理看起来更工程化，也适合写进 README / release notes。

7. 增加“隐私脱敏”

commandLine 里可能有 token、password、secret、key、用户目录。端口详情和历史记录要脱敏：

--password=***
--token=***
C:\Users\用户名 → %USERPROFILE%

8. 增加“低权限模式说明”

如果权限不足导致 commandLine / processPath 读取失败，应显示：

当前权限不足，无法读取完整命令行，因此识别置信度较低。可以尝试以管理员运行本程序获取更完整信息，但不强制。

不要因为字段缺失而乱猜。

9. 增加“端口标签体系”

每个端口可以有多个标签：

HTTP
开发服务
数据库
桌面应用
代理工具
调试端口
容器映射疑似
当前项目冲突
低置信度
高风险进程

搜索和筛选可以基于标签。

10. 增加“本机常见端口画像”

例如：

你本机 8080 最常被 Steam 占用。
你本机 5173 通常是 Vite。
你本机 3306 是 MySQL80 服务。

这比静态规则更贴近用户真实环境，但必须只本地保存，不上传。

---

三、进一步验收要求

在 #71 原有验收基础上补充：

• 至少覆盖 60+ 个常见软件 / 服务识别规则。
• 至少覆盖 Java、Node、Python、数据库、中间件、AI 本地服务、桌面应用、代理工具、调试端口、Docker/WSL 10 大类。
• 每个识别大类至少有 2 个 fixture。
• 对 Steam/QQ/浏览器/WebView 这类常见误判对象必须有 must-not 测试。
• 端口详情必须显示证据、反证、置信度和建议操作。
• commandLine 展示和历史记录必须脱敏。
• 识别不出来时显示 unknown / low confidence，不允许强猜。

最终目标：端口管理不是简单 netstat UI，而是 DevEnv Manager 的“本机开发端口识别与安全处理”亮点功能。

[weidonglang]

补充：常见软件识别库扩展清单与冲突证据 UI 约束

本补充用于把 #71 的“端口软件识别库”进一步工程化。目标不是堆更多名字，而是把常见 Windows 开发环境中容易占用端口的软件按类别归档，并明确 UI 不应因为证据过多而拥挤、错位或显示错误。

---

一、常见软件 / 服务识别库扩展清单

识别原则仍然是：

进程名 > 进程路径 > commandLine > Windows 服务名 > 项目配置 > 历史画像 > 端口号

端口号只作为弱证据，不能单独决定软件类型。

---

1. 浏览器 / WebView / 调试端口

应识别或低风险标注：

• Chrome：chrome.exe
• Edge：msedge.exe
• Firefox：firefox.exe
• WebView2 Runtime：msedgewebview2.exe
• Electron 应用：electron.exe 或应用自身 exe + Electron 路径/命令行证据
• Chrome Remote Debugging：--remote-debugging-port，常见 9222
• Node Inspector：--inspect / --inspect-brk，常见 9229
• Java JDWP Debug：-agentlib:jdwp，常见 5005
• Python debugpy：debugpy，常见 5678

UI 标记：浏览器 / WebView / 调试端口。

注意：调试端口应标记为“谨慎”，不要当作普通 Web 服务。

---

2. 即时通讯 / 社交 / 会议软件

这些软件常见本地监听或 WebView 端口，应优先避免误判为开发服务：

• QQ：QQ.exe
• TIM：TIM.exe
• 微信：WeChat.exe
• 企业微信：WXWork.exe
• 钉钉：DingTalk.exe
• 飞书：Feishu.exe / Lark.exe
• Telegram：Telegram.exe
• Discord：Discord.exe
• Slack：slack.exe
• Teams：ms-teams.exe / Teams.exe
• Zoom：Zoom.exe

UI 标记：桌面通信软件 / WebView 客户端。

默认建议：不建议仅因端口号结束进程。

---

3. 游戏平台 / 启动器

这些非常容易占用 8080、8082 等端口，必须纳入误判抑制：

• Steam：steam.exe、steamwebhelper.exe
• Epic Games Launcher：EpicGamesLauncher.exe
• Battle.net：Battle.net.exe
• Riot Client：RiotClientServices.exe
• Ubisoft Connect：upc.exe
• EA App：EADesktop.exe
• Xbox App / Gaming Services：XboxPcApp.exe、GamingServices.exe
• WeGame：WeGame.exe

UI 标记：游戏平台 / WebView 组件。

强规则：即使端口号是 8080 / 8082 / 3000，也不得强判 Spring / Tomcat / 前端服务。

---

4. 网盘 / 同步 / 下载工具

常见后台服务、同步端口、本地代理端口：

• OneDrive：OneDrive.exe
• 百度网盘：BaiduNetdisk.exe
• 阿里云盘：aDrive.exe
• 夸克网盘：QuarkCloudDrive.exe，如可识别
• 坚果云：Nutstore.exe
• Dropbox：Dropbox.exe
• 迅雷：Thunder.exe
• IDM：IDMan.exe
• Motrix：Motrix.exe
• qBittorrent：qbittorrent.exe
• aria2：aria2c.exe

UI 标记：网盘 / 下载工具 / 同步服务。

建议：这类进程可能正在同步或下载，不建议直接结束。

---

5. IDE / 编辑器 / 开发工具

应识别为开发工具，不要误判为用户项目服务：

• VS Code：Code.exe
• Cursor：Cursor.exe
• Trae：Trae.exe
• Windsurf：Windsurf.exe
• IntelliJ IDEA：idea64.exe
• PyCharm：pycharm64.exe
• WebStorm：webstorm64.exe
• Android Studio：studio64.exe
• Visual Studio：devenv.exe
• JetBrains Gateway / backend
• adb：adb.exe
• Android emulator：emulator.exe

UI 标记：IDE / 开发工具 / 调试相关。

如果端口来自 IDE 内置调试器或插件，应显示“可能是 IDE 插件或调试端口”。

---

6. Java / JVM 开发生态

应重点识别：

• Spring Boot
• Spring Cloud Gateway
• Tomcat
• Jetty
• Undertow
• Netty / Reactor Netty
• Quarkus
• Micronaut
• Dubbo
• Nacos
• Sentinel Dashboard
• Seata
• Eureka
• Zookeeper
• Jenkins
• Nexus
• SonarQube
• Maven 启动的 Java 服务
• Gradle bootRun

强证据：

• java.exe / javaw.exe
• commandLine 包含 spring-boot、bootRun、catalina、tomcat、nacos、sentinel、seata、jenkins、sonarqube
• Windows 服务名命中
• 项目配置命中 server.port

弱证据：8080、8081、8090、9000 等端口号。

---

7. Node / 前端 / 全栈开发生态

应重点识别：

• Vite
• Webpack Dev Server
• Next.js
• Nuxt
• React Scripts
• Vue CLI
• Angular CLI / ng serve
• SvelteKit
• Astro
• Storybook
• Parcel
• Remix
• NestJS
• Express
• Koa
• Hapi
• Electron dev server
• Tauri dev server
• npm / pnpm / yarn / bun dev server

强证据：

• node.exe
• commandLine 包含 vite、webpack、next、nuxt、react-scripts、ng serve、storybook、nest start、electron、tauri dev
• package.json scripts 证据

弱证据：3000、4200、5173、5174、6006。

---

8. Python Web / 数据科学 / AI 本地服务

应重点识别：

• Flask
• Django
• FastAPI
• Uvicorn
• Hypercorn
• Waitress
• Jupyter Notebook
• JupyterLab
• Streamlit
• Gradio
• TensorBoard
• MLflow
• Ray Dashboard
• Airflow Webserver
• Celery Flower
• ComfyUI
• Stable Diffusion WebUI / A1111
• Forge / SD.Next，如可识别
• Ollama
• LM Studio
• vLLM OpenAI server
• llama.cpp server
• text-generation-webui
• Dify / FastGPT / AnythingLLM 本地服务，如有 Docker/Node/Python 证据

强证据：

• python.exe
• commandLine 包含 uvicorn、flask、django、manage.py runserver、streamlit、gradio、jupyter、tensorboard、mlflow、airflow webserver、ollama、vllm

弱证据：5000、8000、7860、8888、11434、6006、8265。

---

9. Go / Rust / .NET / PHP / Ruby

应识别：

• Go：go run、Gin、Fiber、Echo、项目可执行文件
• Rust：cargo run、actix、axum、rocket
• .NET：dotnet.exe、ASP.NET Core、Kestrel、ASPNETCORE_URLS
• PHP：php -S
• Laravel：artisan serve
• Rails：rails server、Puma

强证据来自 commandLine / 项目路径 / 框架关键词，不靠端口号强判。

---

10. 数据库 / 中间件 / 基础设施

应识别：

• MySQL：mysqld.exe
• MariaDB：mariadbd.exe
• PostgreSQL：postgres.exe
• Redis：redis-server.exe
• MongoDB：mongod.exe
• SQL Server：sqlservr.exe
• Oracle XE / listener
• Elasticsearch
• Kibana
• Logstash
• RabbitMQ
• Kafka
• Zookeeper
• RocketMQ
• ActiveMQ
• MinIO
• Consul
• Etcd
• ClickHouse
• InfluxDB
• Prometheus
• Grafana
• EMQX
• Mosquitto

要求：数据库端口必须结合进程名 / 服务名 / 路径。不能仅凭 3306、6379、5432、9200 强判。

---

11. Web 服务器 / 代理 / 本地代理工具

应识别：

• Nginx
• Apache HTTPD
• Caddy
• Traefik
• FRP：frps / frpc
• Clash / Mihomo
• V2Ray
• Xray
• sing-box
• Shadowsocks / ShadowsocksR，如可识别
• Charles
• Fiddler
• Proxyman
• mitmproxy

UI 标记：Web 服务器 / 本地代理 / 调试代理。

代理工具不应误判为普通开发后端。

---

12. Docker / WSL / 容器 / 虚拟化

应识别或提示：

• Docker Desktop：Docker Desktop.exe
• Docker backend：com.docker.backend.exe
• Docker proxy / port proxy，如可识别
• WSL：wslhost.exe
• vmmem / vmmemWSL
• Hyper-V 相关进程
• 端口可能来自 Docker 容器映射

如果有容器映射迹象，显示：

该端口可能来自 Docker/WSL 映射。建议结合 Docker / WSL 检查确认实际容器。

不要自动结束 Docker/WSL 相关进程。

---

二、冲突证据 UI 展示硬要求

用户特别强调：冲突证据不能显示错位、不能拥挤、不能占地方、不能导致表格变形。

因此 UI 必须遵守：

1. 表格行只显示短标签

表格中不要直接显示长证据文本。

建议只显示：

识别：Steam WebView
置信度：High
证据：3
冲突：1

或者显示紧凑 badge：

High · 3证据 · 1冲突

2. 冲突证据默认隐藏

冲突证据默认不展开，不占用表格行高度。

触发方式：

• 鼠标悬停冲突 badge 显示 tooltip。
• 点击冲突 badge 打开 popover。
• 键盘 focus 时也能显示，保证可访问性。

3. Tooltip / Popover 内容限制

悬停内容必须短，不允许撑爆页面。

示例：

冲突证据：端口 8080 常见于 Java Web，但进程 steamwebhelper.exe 明确指向 Steam，因此未标记为 Spring/Tomcat。

如果证据很多，tooltip 只显示摘要，详情放到右侧详情面板。

4. 详情面板承载完整证据

完整证据、反证、评分过程不要塞进表格，而放在端口详情面板：

识别证据
反证 / 冲突证据
评分过程
安全建议

5. 表格布局要求

• 单元格文本必须 ellipsis。
• badge 固定最大宽度。
• 不允许因为证据文本导致列宽撑开。
• 不允许多行证据把行高撑大。
• 表格横向滚动和响应式布局必须正常。
• 小屏窗口下仍然可用。
• Tooltip 不应被父容器 overflow hidden 截断。
• Tooltip 位置应自动避让窗口边缘。

6. 状态颜色与信息密度

建议：

High：正常识别，不必强提示。
Low：灰色/弱提示。
Conflict：黄色小 badge。
High Risk：红色风险 badge。
Unknown：灰色 unknown。

不要把所有信息都做成醒目颜色，避免页面花。

7. 空字段和异常字段

如果 commandLine / path / serviceName 读取不到：

• 表格显示 证据不足 或 权限不足。
• Tooltip 解释原因。
• 不显示 undefined / null / 空白错位。

---

三、进一步补充验收标准

在 #71 原验收基础上补充：

• 端口识别库应覆盖至少 80 个常见进程/服务签名。
• 常见误判对象必须有 must-not 规则：Steam、QQ、微信、浏览器、VS Code、Docker/WSL、代理工具。
• 表格中不得直接展示长证据文本。
• 冲突证据默认通过 hover/focus/click 显示，不撑开表格。
• 详情面板负责展示完整证据和评分过程。
• 小窗口下无明显错位、溢出、遮挡。
• Tooltip / popover 不被截断，不遮挡关键操作按钮。
• 所有证据字段缺失时 UI 不显示 undefined/null。
• commandLine 必须脱敏后展示。

最终目标：端口管理既要“识别强”，也要“界面干净”。不能为了展示智能证据，把端口表格做得拥挤、错位或难用。

[weidonglang]

完成内容

• 端口管理增加软件识别库、智能证据评分、快捷操作和项目联动，抑制 Steam/QQ/Chrome/VS Code/unknown 误判。
• 已合入 PR v1.5.3 Quality Patch first round #87 / chore: release DevEnv Manager v1.5.3 stable #88，并发布 v1.5.3 Stable。

修改文件

• tauri/src-tauri/src/lib.rs
• tauri/src-tauri/src/mysql_repair.rs
• tauri/src-tauri/src/cleanup/duplicates.rs
• tauri/src-tauri/src/cleanup/large_files.rs
• tauri/src/main.ts
• tauri/src/styles.css
• tauri/src/types/index.ts
• tauri/src/api/tauri.ts
• tauri/src/features/safety/index.ts
• README.md
• docs/release-v1.5.3.md
• update-manifest.json

验证命令

• cargo test --all-targets
• cargo clippy --all-targets -- -D warnings
• npm ci
• npm run build
• npm run tauri:build
• py -3 scripts\check_safety_wording.py
• py -3 scripts\check_repo_hygiene.py

手动验证

• GitHub Release v1.5.3 已创建并上传 DevEnv.Manager_1.5.3_x64-setup.exe。
• 已从 Release 下载安装包并校验 SHA256：32439838bc46687010b83d4c5f80583fbb0c2b99ed4a836078772184f50e069c。
• update-manifest.json 指向 v1.5.3 真实下载链接，下载后 SHA256 与 manifest 一致。

Release

• https://github.com/weidonglang/DevEnv-Manager/releases/tag/v1.5.3
• https://github.com/weidonglang/DevEnv-Manager/releases/download/v1.5.3/DevEnv.Manager_1.5.3_x64-setup.exe

[weidonglang]

QA 复核：端口识别库和特色体验未达到完成标准，建议重开并纳入 1.6

当前端口管理已做 UI 骨架和部分识别，但真实复测发现：大量常见进程仍无法被解释，unknown 没有进一步分析，“1冲突”也缺少判断依据。

1.6 应补齐：

• 常见系统 / 桌面 / 游戏 / 浏览器 / 虚拟化 / 安全软件 / 厂商服务进程识别库。
• 对 QQ、Edge、Steam、Bilibili、VMware、NVIDIA、ArmouryCrate、MuMu、Autodesk、Kaspersky 等给出人话解释。
• unknown 进程进一步分析：文件名、路径、签名/公司名、父进程、命令行关键词、是否位于系统目录。
• 冲突判断要展示证据和置信度，不能只显示“1冲突”。

建议重开本 issue。

[weidonglang]

已在 v1.6.1 Stable 收口：用户已完成实机验收，PR #91/#92 已合并，v1.6.1 已发布为 latest，update-manifest 已指向 v1.6.1 安装包与 SHA256。