# 窗口管理MCP工具 **Repository Path**: dekao_nous/batch-close-window-widget ## Basic Information - **Project Name**: 窗口管理MCP工具 - **Description**: 一个跨平台、零依赖的批量关窗命令行工具,同时支持 AI 客户端通过 MCP 协议调用。 它是什么 Windows 下任务栏堆了一堆窗口要批量关掉?普通工具要么一个个点,要么直接杀进程(可能丢数据)。这个工具专门解决"批量、优雅地关窗口": - Windows:枚举任务栏窗口,对目标发送 WM_CLOSE(等同点右上角 ×,让应用正常保存退出) - Linux:退化为枚举用户进程 - **Primary Language**: C++ - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2026-01-08 - **Last Updated**: 2026-08-04 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Batch Close Window Widget (WinTaskManger) 跨平台批量关闭窗口工具。枚举任务栏窗口与进程,通过 `WM_CLOSE` 优雅关闭窗口;提供 **交互模式**、**命令行模式** 与 **MCP 服务器模式**(供 AI 客户端调用)。 ## 功能特性 - **跨平台**:Windows(Win32 API)+ Linux(`/proc`),平台逻辑经 `IProcessProvider` 抽象隔离 - **优雅关窗**:Windows 上通过 `WM_CLOSE` 请求窗口正常关闭(非强制杀进程) - **三种运行模式**: - 交互模式(默认):窗口编号列表 → 输入 `1,3-5` / `all` 批量关闭 - 命令行模式:`--list` / `--close` / `--format json` 等脚本友好 - MCP 服务器模式(`--mcp`):stdio JSON-RPC,暴露 `list_windows` / `list_processes` / `close_windows` / `close_all_windows` - **输出格式策略**:文本表格 / JSON 可切换 - **零第三方依赖**:C++20 + 标准库 + 平台 API ## 快速开始 ### 构建(CMake >= 3.16,推荐 CLion) ```bash cmake -S . -B build cmake --build build --config Release -j ``` - Windows:MSVC(Visual Studio)+ `-G "Visual Studio 18 2026" -A x64` 可选 - Linux:`cmake --build build -j`;产物 `build/WinTaskManger` ### 交互模式(默认) ```bash WinTaskManger # 列出窗口后输入编号(如 1,3-5)批量关闭;all=全部;q=退出 ``` ### 命令行模式 ```bash WinTaskManger --list # 列出任务栏窗口 WinTaskManger --list --format json # JSON 输出 WinTaskManger --list-processes # 列出进程 WinTaskManger --close 1,3-5 # 关闭窗口(编号/区间/all) WinTaskManger --close-all # 关闭全部窗口 WinTaskManger --mode interactive # 强制交互模式(默认 auto) WinTaskManger --help / --version # 帮助 / 版本 ``` ### MCP 服务器模式 ```bash WinTaskManger --mcp ``` 供 opencode / Claude Desktop 等 AI 客户端通过协议调用批量关窗能力,接入配置见 [`docs/MCP接入说明.md`](docs/MCP接入说明.md)。 ## 架构 ``` WinTaskManger/ ├── main.cpp # 入口:解析选项 → 工厂创建 → 模式分发 ├── core/ # 数据与平台抽象层 │ ├── types.h # ProcessInfo / WindowInfo(UTF-8) │ ├── selection.h/.cpp # SelectionParser(编号/区间解析,双模式复用) │ ├── process_provider.h # IProcessProvider 抽象接口 + Create() 工厂 │ ├── process_provider_win.cpp # Windows:EnumWindows / Toolhelp32 / WM_CLOSE │ └── process_provider_linux.cpp # Linux:/proc 进程枚举 ├── ui/ # 交互层 │ ├── cli_options.h/.cpp # 命令行参数解析 │ ├── output_formatter.h/.cpp # 输出策略(Text / Json) │ ├── commands.h/.cpp # 命令模式(--list / --close / --close-all) │ ├── mode.h/.cpp # IMode 抽象 + 工厂(模板方法 Run) │ ├── interactive_mode.h/.cpp # 交互模式 │ └── command_mode.h/.cpp # 命令行模式 └── mcp/ # MCP 服务器层 ├── json.h/.cpp # 最小 JSON 解析/序列化(零依赖) └── server.h/.cpp # stdio NDJSON + JSON-RPC 生命周期 ``` 采用工厂方法、策略、模板方法、命令等设计模式;`SelectionParser`、`IProcessProvider`、`IOutputFormatter` 在多种模式间优雅复用。详细说明见 [`docs/项目升级说明.md`](docs/项目升级说明.md)。 ## 支持平台 | 平台 | 窗口枚举/关闭 | 进程枚举 | 实测 | |------|--------------|----------|------| | Windows | ✅ `EnumWindows` + `WM_CLOSE` | ✅ `CreateToolhelp32Snapshot` | ✅ MSVC 19.51 | | Linux | —(无窗口概念) | ✅ `/proc` | ✅ g++ 15.2(WSL2) | ## 许可证 MIT,仅供学习和研究使用。