进程间通信

目的与范围

本文档描述了 PowerToys 中用于协调主运行程序和设置 UI 应用程序的进程间通信 (IPC) 系统。这包括基于命名管道的通信机制、JSON 消息协议以及进程生命周期管理。

有关常规设置管理和配置存储的信息，请参阅设置管理。有关模块加载系统详细信息，请参阅模块加载系统。

架构概述

PowerToys 使用双向命名管道 IPC 系统，以实现主 PowerToys 运行程序 (PowerToys.exe) 和设置 UI 应用程序 (PowerToys.Settings.exe) 之间的实时通信。此架构允许设置 UI 作为单独的进程运行，同时与正在运行的 PowerToys 模块保持同步的配置状态。

来源： src/runner/settings_window.cpp34-38 src/runner/settings_window.cpp489-490 src/runner/main.cpp84-94

命名管道实现

IPC 系统使用 UUID 创建两个命名管道，动态生成名称，以确保多个 PowerToys 实例之间的唯一性。

管道创建和命名

管道名称遵循以下模式：

运行程序管道：\\.\pipe\powertoys_runner_{uuid}
设置管道：\\.\pipe\powertoys_settings_{uuid}

来源： src/runner/settings_window.cpp344-365 src/runner/settings_window.cpp409-421

TwoWayPipeMessageIPC 类

核心 IPC 功能通过 TwoWayPipeMessageIPC 类实现，该类负责管理双向通信。

来源： src/runner/settings_window.cpp489-491 src/runner/settings_window.cpp520-527

消息类型和 JSON 协议

进程间的通信使用 JSON 消息，其中包含特定的消息类型，这些类型会触发接收进程中的不同行为。

核心消息类型

消息类型	方向	目的	处理函数
`general`	设置→运行程序	应用常规设置更改	`apply_general_settings()`
`powertoys`	设置→运行程序	更新模块配置	`dispatch_json_config_to_modules()`
`refresh`	设置→运行程序	请求当前设置状态	`get_all_settings()`
`action`	设置→运行程序	执行系统操作	`dispatch_json_action_to_module()`
`bugreport`	设置→运行程序	启动 bug 报告工具	`launch_bug_report()`
`killrunner`	设置→运行程序	终止 PowerToys 进程	窗口关闭消息