Skip to content

feat(windows): 集成 Windows 11 一级右键菜单,安装时自动注册、卸载时清理 - #1025

Open
pingg241 wants to merge 2 commits into
Kuddev:mainfrom
pingg241:feat/windows11-context-menu
Open

pingg241 wants to merge 2 commits into
Kuddev:mainfrom
pingg241:feat/windows11-context-menu

Conversation

@pingg241

@pingg241 pingg241 commented Nov 17, 2026 •

Copy link
Copy Markdown

用户结果

现有安装器注册的是传统右键菜单,Windows 11 用户需要进入“显示更多选项”才能找到“在 Pebrel 中打开”。本 PR 增加 Windows 11 一级菜单的目录、目录空白处入口,打开 Pebrel 时使用对应目录作为工作目录。

安装器在复制组件后自动为当前用户注册,重复安装和升级重新注册;确认卸载后先注销,再删除组件。取消卸载保留菜单,注销失败则停止卸载并保留文件。Windows 10 继续使用现有传统菜单。

发布前提:普通用户电脑需要受信任证书签名的稀疏 MSIX 包。 build-installer.ps1 -ContextMenuPackage <signed.msix> 接收签名包;没有提供签名包时是本地开发构建,需要系统已开启开发者模式。注册失败会显示错误、保存诊断并返回非零安装结果,不会静默报告成功。本 PR 没有配置发布签名或修改 GitHub 工作流,请维护者评审签名包的发布接入方式。

设计边界

  • tools/windows-context-menu 是独立 Cargo workspace,包含 IExplorerCommand COM DLL 和短时运行的原生注册程序。Explorer 通过 COM surrogate 承载扩展,不加载应用、终端或 GPUI 依赖。
  • DLL 根据自身位置寻找 pebrel.exe,使用现有 --gpui --working-directory 参数;文件夹路径以独立原生参数传递,支持中文、空格及盘符根目录。背景菜单通过宿主的文件夹视图获取目录。
  • 原生注册程序调用 Windows PackageManager API,安装后的功能不依赖 PowerShell。包名、发布者和实际外部安装目录共同限制归属:注册拒绝覆盖另一安装,旧安装卸载也不会注销另一安装拥有的菜单。
  • 安装器构建包含组件版本、架构和新鲜度检查;签名包校验签名和清单匹配。菜单标题复用现有安装器中英文翻译,按 Windows UI 语言选择。
  • 不启用开发者模式、不导入证书、不主动结束 Explorer。签名包被拒绝后不改用开发注册掩盖错误。
  • 本分支从上游 303a7f4e 创建,仅包含右键菜单及其构建、安装、测试和设计说明。

设计依据见 architecture/notes/packaging/2026-11-17-explorer-menu-lifecycle.md,构建及签名要求见 tools/windows-context-menu/README.md。

验证依据

已在 Windows x64 本机执行:

  • cargo test --locked --manifest-path tools/windows-context-menu/Cargo.toml --target-dir target/windows-context-menu:5 个单元测试通过,覆盖路径、清单身份、URI 转义、COM 错误和启动失败。
  • scripts/build-windows-context-menu.ps1 -Configuration release -TargetDirectory target:独立组件 release 构建通过。
  • scripts/tests/windows-context-menu.tests.ps1:实际 Windows 包注册、重复注册、版本升级、另一安装归属保护、无效签名包拒绝及重复注销通过。
  • scripts/tests/installer-context-menu.tests.ps1 -InnoCompiler <ISCC.exe>:最小 Inno 安装器实际执行生产生命周期代码,自动注册、重复安装、取消卸载、注销失败保留文件及成功卸载通过。
  • scripts/tests/build-windows-product.tests.ps1、scripts/tests/windows-package-architecture.tests.ps1:通过。
  • scripts/build-windows-product.ps1 -Configuration release -TargetDirectory target -ContextMenu:完整 GPUI 产品 release 构建通过,耗时 6 分 28 秒,程序版本为 2.5.0 (378df60f)。
  • 新生成的生产 DLL 通过隔离 COM 回调探针实际启动新生成的应用:选中中文/空格目录、空白处的真实 Windows shell folder view、盘符根目录三种路径均成功;Runtime API 核实三个实际 pane cwd,并确认运行版本 2.5.0 (378df60f)。该探针在进程内加载原始 DLL,不代表完成 Explorer 菜单的鼠标和视觉验收;包注册生命周期另由上述测试验证。
  • scripts/build-installer.ps1 -TargetDirectory target -OutputDirectory <local-output> -InnoCompiler <ISCC.exe>:完整 Pebrel-v2.5.0-windows-x64-setup.exe 构建通过(36,400,086 字节);未跳过产品构建或新鲜度检查。未将该完整安装包安装到现有用户环境。
  • 完整产品安装器和隔离验收安装器另使用语法测试载荷编译通过;未执行这些语法测试包。
  • PowerShell 语法解析、独立 workspace 格式检查、git diff --check、python scripts/check_architecture.py --base 303a7f4e750f8c60998df47423f028ae425540a2:通过。

包生命周期测试使用随机包名和 CLSID,不操作实际安装的菜单。未验证:受信任签名包在未开启开发者模式电脑上的安装、Windows ARM64 实机、完整产品在普通用户配置下的安装/升级/卸载、Explorer 全部视觉状态及多 DPI 验收。签名分发需要维护者提供签名包后补充验收。

必须确认

  • 遵循贡献指南、架构地图及工程合同。
  • 按职责组织独立组件,复用现有 CLI 和翻译来源。
  • 基于实际 PR 基线的架构检查通过,未提高预算或扩大排除范围。
  • 已覆盖成功与失败路径,并说明未验证的平台和发布范围。
  • 菜单标题复用已有翻译;安装器错误文案提供中英文,其他系统语言沿用英文回退。
  • 治理规则未修改;不涉及治理规则修订确认项。

@pingg241
pingg241 requested a review from Kuddev as a code owner November 17, 2026 14:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant