Goary · Sep 20, 2026 · Sep 23, 2026 · Oct 8, 2026 · Oct 12, 2026 · Oct 12, 2026
diff --git a/.github/workflows/windows-ci.yml b/.github/workflows/windows-ci.yml
@@ -0,0 +1,60 @@
+name: Windows CI
+
+on:
+  push:
+    branches: [main, windows-port]
+    paths:
+      - "windows/**"
+      - ".github/workflows/windows-ci.yml"
+  pull_request:
+    paths:
+      - "windows/**"
+      - ".github/workflows/windows-ci.yml"
+  workflow_dispatch:
+
+permissions:
+  contents: write # required by the release step on windows-v* tags
+
+jobs:
+  test-and-package:
+    runs-on: windows-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup .NET 8
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: 8.0.x
+
+      - name: Build (Release)
+        run: dotnet build windows/LeftOpen.sln -c Release
+
+      - name: Unit tests
+        run: dotnet test windows/LeftOpen.sln -c Release --no-build
+
+      # Regression probe for the console-close safety boundary: proves the
+      # Ctrl+C / Ctrl+Break broadcast scope and that production refuses them.
+      - name: Console-safety probe
+        run: dotnet run --project windows/tests/LeftOpen.ConsoleSafety.Probe -c Release
+
+      # The release layout the maintainer asked for: unzip and run, no .NET install.
+      - name: Package self-contained zip
+        run: powershell -File windows/Scripts/publish.ps1 -Shared -OutputDir windows/release
+
+      - name: Upload package artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: LeftOpen-windows-x64
+          path: windows/release/LeftOpen-windows-x64.zip
+          if-no-files-found: error
+
+      - name: Attach to release (windows-v* tags only)
+        if: startsWith(github.ref, 'refs/tags/windows-v')
+        uses: softprops/action-gh-release@v2
+        with:
+          files: windows/release/LeftOpen-windows-x64.zip
+          body: |
+            Self-contained Windows build — unzip and run, no .NET installation required.
+
+            - `LeftOpenApp.exe` — tray app (door icon in the notification area)
+            - `leftopen.exe` — CLI (`leftopen [port] / open / close / --json`)
diff --git a/README.md b/README.md
@@ -123,6 +123,18 @@ LEFTOPEN_OUTPUT_DIR=dist/dev Scripts/build-app.sh
 
 ---
 
+## Windows port
+
+A Windows port lives in [`windows/`](windows/README.md): a system-tray app plus a `leftopen` CLI that share one C# engine (`LeftOpen.Core`). It keeps the same philosophy and safety model — scan only when the panel opens, explainable ownership inference with confidence and reasons, and gentle close only (WM_CLOSE / console Ctrl+C / Ctrl+Break, never a force-kill).
+
+```powershell
+dotnet build windows\LeftOpen.sln
+windows\src\LeftOpen.Tray\bin\Debug\net8.0-windows\LeftOpenApp.exe   # tray app
+windows\src\LeftOpen.Cli\bin\Debug\net8.0-windows\leftopen.exe       # CLI
+```
+
+---
+
 ## License
 
 [MIT License](LICENSE)
diff --git a/README.zh-CN.md b/README.zh-CN.md
@@ -123,6 +123,18 @@ LEFTOPEN_OUTPUT_DIR=dist/dev Scripts/build-app.sh
 
 ---
 
+## Windows 版
+
+Windows 移植版位于 [`windows/`](windows/README.md)：系统托盘应用 + `leftopen` 命令行，共用一个 C# 引擎（`LeftOpen.Core`）。理念与安全模型完全一致——面板打开时才扫描、归属推断带置信度与依据、只温和关闭绝不强杀（WM_CLOSE / 控制台 Ctrl+C / Ctrl+Break）。
+
+```powershell
+dotnet build windows\LeftOpen.sln
+windows\src\LeftOpen.Tray\bin\Debug\net8.0-windows\LeftOpenApp.exe   # 托盘应用
+windows\src\LeftOpen.Cli\bin\Debug\net8.0-windows\leftopen.exe       # 命令行
+```
+
+---
+
 ## 许可证
 
 [MIT License](LICENSE)
diff --git a/windows/.gitignore b/windows/.gitignore
@@ -0,0 +1,20 @@
+# 构建产物
+bin/
+obj/
+dist/
+dist-*/
+release/
+
+# 面板快照与图标校验产物（--snapshot / 人工验证生成的图片）
+panel-snapshot*.png
+exe-icon-check.png
+
+# 测试结果
+TestResults/
+*.trx
+
+# IDE
+.vs/
+.idea/
+*.user
+*.suo
diff --git a/windows/LeftOpen.sln b/windows/LeftOpen.sln
@@ -0,0 +1,50 @@
+
+Microsoft Visual Studio Solution File, Format Version 12.00
+# Visual Studio Version 17
+VisualStudioVersion = 17.0.31903.59
+MinimumVisualStudioVersion = 10.0.40219.1
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "src", "src", "{544456D8-8129-4FAD-AD56-DB2E2C7430CC}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "LeftOpen.Core", "src\LeftOpen.Core\LeftOpen.Core.csproj", "{89B0270A-D388-4543-8F02-313CFD214F71}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "LeftOpen.Cli", "src\LeftOpen.Cli\LeftOpen.Cli.csproj", "{AA4897B1-4FED-4F6A-8CC6-0C153474F015}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "LeftOpen.Tray", "src\LeftOpen.Tray\LeftOpen.Tray.csproj", "{424F7028-34BE-4810-B495-1920CD69AD40}"
+EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "tests", "tests", "{4670D1DC-9A3F-4770-A065-9C5D9B7ACE4E}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "LeftOpen.Core.Tests", "tests\LeftOpen.Core.Tests\LeftOpen.Core.Tests.csproj", "{F3CBD148-FDE5-4123-9413-00426F82E4ED}"
+EndProject
+Global
+	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+		Debug|Any CPU = Debug|Any CPU
+		Release|Any CPU = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(SolutionProperties) = preSolution
+		HideSolutionNode = FALSE
+	EndGlobalSection
+	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{89B0270A-D388-4543-8F02-313CFD214F71}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{89B0270A-D388-4543-8F02-313CFD214F71}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{89B0270A-D388-4543-8F02-313CFD214F71}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{89B0270A-D388-4543-8F02-313CFD214F71}.Release|Any CPU.Build.0 = Release|Any CPU
+		{AA4897B1-4FED-4F6A-8CC6-0C153474F015}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{AA4897B1-4FED-4F6A-8CC6-0C153474F015}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{AA4897B1-4FED-4F6A-8CC6-0C153474F015}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{AA4897B1-4FED-4F6A-8CC6-0C153474F015}.Release|Any CPU.Build.0 = Release|Any CPU
+		{424F7028-34BE-4810-B495-1920CD69AD40}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{424F7028-34BE-4810-B495-1920CD69AD40}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{424F7028-34BE-4810-B495-1920CD69AD40}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{424F7028-34BE-4810-B495-1920CD69AD40}.Release|Any CPU.Build.0 = Release|Any CPU
+		{F3CBD148-FDE5-4123-9413-00426F82E4ED}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{F3CBD148-FDE5-4123-9413-00426F82E4ED}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{F3CBD148-FDE5-4123-9413-00426F82E4ED}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{F3CBD148-FDE5-4123-9413-00426F82E4ED}.Release|Any CPU.Build.0 = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(NestedProjects) = preSolution
+		{89B0270A-D388-4543-8F02-313CFD214F71} = {544456D8-8129-4FAD-AD56-DB2E2C7430CC}
+		{AA4897B1-4FED-4F6A-8CC6-0C153474F015} = {544456D8-8129-4FAD-AD56-DB2E2C7430CC}
+		{424F7028-34BE-4810-B495-1920CD69AD40} = {544456D8-8129-4FAD-AD56-DB2E2C7430CC}
+		{F3CBD148-FDE5-4123-9413-00426F82E4ED} = {4670D1DC-9A3F-4770-A065-9C5D9B7ACE4E}
+	EndGlobalSection
+EndGlobal
diff --git a/windows/README.md b/windows/README.md
@@ -0,0 +1,162 @@
+# LeftOpen (Windows)
+
+> 把那些虚掩着的门，轻轻关上。
+
+LeftOpen 是一个 Windows 系统托盘应用 + 命令行工具，用来**看清 localhost 上还有哪些进程在监听，并把不再需要的温和地关掉**。
+
+它是 [SonghaiFan/leftopen](https://github.com/SonghaiFan/leftopen)（macOS 菜单栏应用）的 Windows 移植版：同一套理念、同一套安全规则、同样的“按需扫描、不做驻留”的行为，只是把菜单栏换成了系统托盘，把 `lsof`/`ps` 换成了 Windows 原生 API。
+
+## 它解决什么问题
+
+同时开几个编码代理、跑一堆 dev server 时，一天下来总有 `node`/`python` 还挂在 5173、8000、3000 上。Windows 自带的 `netstat` 只告诉你“端口被占用”，不告诉你**是哪个进程、属于哪个项目**。
+
+LeftOpen 做三件事：
+
+1. **端口归属**：从进程的工作目录向上找 `.git` / `package.json` / `pyproject.toml` / `Cargo.toml` / `go.mod`，把监听者归类为**我的项目 / 应用 / 系统服务 / 未知**，并给出判定依据（confidence + reason）。
+2. **一眼看清**：托盘图标是一扇门（有遗留进程时门是开的），点开面板就是分组列表——端口、进程、运行时长、是否局域网可见。
+3. **温和关闭**：关闭前展示完整信息并要求二次确认；只发送“温和”信号，**绝不强杀**；关不掉就如实告诉你。
+
+## 安装与构建
+
+需要 [.NET 8 SDK](https://dotnet.microsoft.com/download)（`winget install Microsoft.DotNet.SDK.8`）。
+
+```powershell
+# 开发构建
+dotnet build LeftOpen.sln
+
+# 运行
+src\LeftOpen.Tray\bin\Debug\net8.0-windows\LeftOpenApp.exe     # 托盘应用
+src\LeftOpen.Cli\bin\Debug\net8.0-windows\leftopen.exe         # 命令行
+
+# 发布（默认框架依赖单文件，约 700 KB；需要 .NET 8 运行时）
+powershell -File Scripts\publish.ps1
+
+# 发布自包含版本（目标机器无需安装 .NET，托盘约 158 MB——WinForms 不支持裁剪）
+powershell -File Scripts\publish.ps1 -SelfContained
+
+# 发布自包含"共享运行时"文件夹 + zip（约 67 MB，解压即用；CI 打包用的就是它）
+powershell -File Scripts\publish.ps1 -Shared
+```
+
+## CI 与发布
+
+`.github/workflows/windows-ci.yml` 在每次改动 `windows/` 时自动运行：Release 构建 → 60 个单元测试 → 控制台安全探针 → 打出自包含 zip（`LeftOpen-windows-x64.zip`，解压即用、无需安装 .NET）并上传为构建产物。打 `windows-v*` 标签时，zip 会自动附加到 GitHub Release。
+
+## 托盘应用
+
+- 启动后只驻留一个托盘图标（门）：**不扫描、不轮询、无守护进程**。
+- 点击图标 → 弹出面板 → **此刻才扫描一次**；再次点击或点击别处自动收起。
+- 面板分组：`我的项目` / `其他进程` / `不可关闭（系统或应用，默认折叠）`。
+- 每行显示：端口（多端口显示 `+N`）、进程图标、归属标签、命令与 PID、运行时长、`LAN` 徽标（局域网可见时）。
+- 悬停出现红色 `✕`，右键菜单：浏览器打开 / 复制端口 / 复制 PID / 关闭进程。
+- 点击行进入详情：完整证据链（进程、用户、可执行路径、工作目录、项目标记、判定依据）。
+- 关闭是**两步**：先看确认页（进程信息、其他端口警告、温和关闭说明），再点“关闭”。
+- 托盘右键菜单：刷新 / 开机自启动（默认关）/ 退出。
+- 再次启动 `LeftOpenApp.exe` 会唤起已运行实例的面板（可做快捷方式）。
+
+## 命令行
+
+```text
+leftopen               # 列出所有监听活动
+leftopen <port>        # 解释某个端口属于谁
+leftopen open <port>   # 在浏览器中打开
+leftopen close <port>  # 温和关闭端口上的进程
+leftopen --json        # 机器可读输出
+```
+
+选项：`--pid <pid>`（一个端口被多个进程持有时指定）、`--dry-run`（只预览不发信号）、`--yes`（跳过交互确认）、`--no-color`。
+
+```text
+$ leftopen 5173
+PORT 5173 · 1 listener
+Owner:      fdi_project_info_web
+Type:       project
+Confidence: high
+Process:    node.exe
+PID:        5252
+User:       MOMENTA\yan.gao1
+Uptime:     2h 14m
+Scope:      LOCAL
+Addresses:  127.0.0.1
+Executable: C:\nvm4w\nodejs\node.exe
+CWD:        ~\workspace\fdi_project_info_web\
+Marker:     ~\workspace\fdi_project_info_web\.git
+Reason:     CWD is within a project root containing git at ...\.git.
+```
+
+## 工作原理：macOS → Windows 映射
+
+| 原版（macOS） | 本移植版（Windows） |
+|---|---|
+| `lsof -iTCP -sTCP:LISTEN` | `GetExtendedTcpTable`（iphlpapi，netstat 同源的原生 API，自带 PID） |
+| `ps -axo pid,ppid,comm` | 一次 WMI 查询拿到 PID/父 PID/可执行路径/命令行/启动时间 |
+| `lsof -d cwd` 读工作目录 | 读目标进程 PEB 的 `RTL_USER_PROCESS_PARAMETERS.CurrentDirectory`（`NtQueryInformationProcess` + `ReadProcessMemory`） |
+| `.app` 包识别应用 | 可执行文件位于 `Program Files` / `WindowsApps` / `%LOCALAPPDATA%\Programs` |
+| 系统目录 `/usr/bin` 等 | `C:\Windows` 树 |
+| `127.0.0.1` vs `0.0.0.0` | 同样区分 `LOCAL`（仅本机）/ `LAN`（局域网可见） |
+| 只发 SIGTERM | 仅向目标 PID 自己的窗口发送 WM_CLOSE；拒绝控制台广播 |
+| 菜单栏 `MenuBarExtra` | 系统托盘 `NotifyIcon` + 弹出面板 |
+
+`LeftOpen.Core` 是共享引擎，托盘应用与 CLI 用的是**完全相同**的扫描、推断与关闭规则。
+
+### 控制台关闭的安全边界
+
+`GenerateConsoleCtrlEvent(..., 0)` 会向共享控制台的所有进程广播。Ctrl+C 不能限定进程组；Ctrl+Break 可以限定组，但组包含后代，PID 也不等于已验证的组身份。现有扫描和 PID 身份复核无法证明所有接收者均已获准关闭，因此控制台信号路径已移除。
+
+仅在窗口确实属于已复核的目标 PID 时发送 `WM_CLOSE`，并检查发送结果。普通 node/python 控制台服务通常没有自己的窗口，因此会被安全拒绝；需要在原终端手动停止。即使用户确认或使用 `--yes`，也不会启用广播或强杀。
+
+## 安全规则
+
+关闭是**三段式**的，任何一步不满足就拒绝执行、绝不发信号：
+
+1. **准备**：拒绝系统进程（PID ≤ 4）、LeftOpen 自身、非当前用户（含 SYSTEM）的进程、可执行文件位于 `C:\Windows` 的进程、以及“装在 Program Files 里的应用本体”（例如 Spotify）；共享运行时（node/python/dotnet…）不算应用本体，可以关闭。
+2. **复核**（防 PID 复用）：发信号前重新扫描，核对目标 PID 仍在该端口监听、没有出现新的持有者、用户 SID / 可执行路径 / **启动时间**都与预览时一致——任何一项变化都判定为“PID 被换人”，放弃并明确报告“未发送任何信号”。
+3. **执行**：发送温和信号后轮询最多 5 秒确认端口释放，结构化返回 `targetStoppedListening` / `portFree` / `remainingPids` / `signalsDelivered`。
+
+**从不强杀**（没有 `taskkill /F`，没有 `Process.Kill`）。进程不响应就如实报告；连温和信号都送不到（无可达的目标进程窗口）时，也会明确说明“未送达，进程未受影响”。
+
+## 已知限制
+
+- 管理员 / 受保护进程的工作目录读不到（PEB 不可读），这些进程归类为“未知”，面板会在底部列出限制说明。
+- 32 位进程的 PEB 读取未做 WOW64 特化处理，失败时同样优雅降级。
+- 使用 `http.sys` 的程序（如 .NET `HttpListener`）在 TCP 表中归属 PID 4（SYSTEM），因此会被识别为系统进程、不可关闭——这是 Windows 的行为，不是误判。
+- `LAN` 只表示绑定地址不是回环地址，不代表防火墙后真的可达（与原版一致）。
+- 面板暂不支持深色主题跟随与搜索历史。
+
+## 项目结构
+
+本目录是原仓库 [SonghaiFan/leftopen](https://github.com/SonghaiFan/leftopen) 的 `windows-port` 分支上的 Windows 移植部分；macOS 的 Swift 源码与 TypeScript CLI 原型仍在仓库根的 `Sources/`、`src/`，未做改动。
+
+```
+windows/
+├── LeftOpen.sln
+├── src/LeftOpen.Core/          # 引擎：TCP 表、进程事实、PEB 工作目录、项目识别、归属推断、关闭服务
+├── src/LeftOpen.Tray/          # 托盘应用（WinForms）：门图标、面板、两步确认
+├── src/LeftOpen.Cli/           # 命令行（leftopen.exe）
+├── tests/LeftOpen.Core.Tests/  # 56 个单元测试（项目标记、排除规则、推断优先级、关闭规则）
+└── Scripts/publish.ps1
+```
+
+## 测试
+
+```powershell
+dotnet test
+```
+
+覆盖：项目标记向上查找与排除规则（`node_modules`、缓存、AppData、系统树、home 根、隐藏目录）、归属推断优先级与置信度、局域网判定、父进程链（环检测与深度上限）、关闭保护规则、PID 复用复核、端口被抢占的报告、信号未送达的如实报告，以及端口字节序解析的回归测试。
+
+## 致谢与许可
+
+设计与交互来自 [SonghaiFan/leftopen](https://github.com/SonghaiFan/leftopen)（MIT）。本移植版沿用同一理念与安全模型。
+
+### Windows 原生控制台回归探针
+
+在 Windows + .NET 8 SDK 中运行（退出码非零表示失败）：
+
+```powershell
+dotnet run --project tests/LeftOpen.ConsoleSafety.Probe
+```
+
+探针先分离调用者的控制台，再创建专用控制台和三个受控测试进程（共享组的服务、显式新组的服务、该新组中的后代）。只在确认控制台成员全部为这些测试进程后广播，并记录真实控制事件。检查广播范围、Ctrl+C 非零组行为、Ctrl+Break 组内后代范围，以及生产关闭路径拒绝所有控制台服务且没有事件送达。测试处理器拦截退出，finally 用停止文件让测试进程自行退出；不会向开发者的终端广播。
+
+此探针是待 Windows 实测的回归验证，不是现有 mock 单元测试的替代。Linux 代码审查不能证明其运行结果；合并或发布预览版前须保留 Windows 输出并运行 `dotnet test LeftOpen.sln`。