Skip to content

[Contribution]: 验证 Windows 上能正确打出安装包 #5

Closed

Description

@lkk48775-tech

What do you want to change?

认领 #1 第四项中 Windows 上"能正确打出安装包"的验证。范围:在真实 Windows 环境从源码构建出安装包(NSIS/MSI),并完成 安装 → 启动 → 卸载 的端到端验证,产出一份可复现的验证报告。macOS 与 Linux 部分尚待认领,本 issue 仅覆盖 Windows。

Why?

#1 提出,v0.1.0 发版前需要确认各平台能正确打出安装包。Windows 链路有平台特殊性:NSIS 与 MSI 两种产物、WebView2 运行时的引导方式、未签名产物在 SmartScreen 下的表现,这些都还没在真实 Windows 环境上端到端验证过。

Technical approach

  • 环境:Windows 11 x64,Rust stable(≥1.85)、Node 22、pnpm 12,基于 main 分支
  • pnpm install --frozen-lockfile 安装依赖,pnpm build(tauri build)构建,完整记录构建日志
  • 检查产物:target/release/bundle/nsis/ 与 target/release/bundle/msi/ 下的安装包,核对版本号(0.1.0)、架构与体积
  • 安装验证:运行安装向导,记录安装模式与实际安装目录;从开始菜单启动,确认主窗口经 WebView2 正常加载;使用临时 AIDGET_HOME 走一遍 widget 创建/展示的冒烟流程
  • 卸载验证:通过系统卸载入口卸载,检查安装目录、开始菜单快捷方式与用户数据目录的残留
  • 只验证打包与安装链路,不改动应用代码;若发现构建/打包问题,提供最小复现并与维护者确认修复范围,超出范围的另开 Issue
  • 不发布 Release 或 tag

Platforms affected

Windows。以验证为主,不改动应用行为。

How should this be verified?

  • 构建阶段:pnpm build 成功退出且日志无 error,NSIS 与 MSI 两种安装包均生成
  • 安装阶段:向导可完成,记录安装模式与目录;开始菜单出现入口;启动后主窗口渲染正常、可交互
  • 冒烟阶段:临时 AIDGET_HOME 下创建一个简单 widget 并正常显示、删除
  • 卸载阶段:卸载后安装目录与快捷方式被清理,记录用户数据是否保留
  • 记录环境、操作步骤、预期与实际结果,附脱敏截图;明确列出未执行或受阻的检查项(如代码签名——产物当前未签名,SmartScreen 提示属预期,只记录不判失败)

Acknowledgement

  • I understand the code I propose and can explain its behavior.
  • I will follow CONTRIBUTING.md and will not tag releases.

Activity

  1. micooz commented on Oct 24, 2026

    @micooz
    Contributor

    lgtmi

  2. github-actions commented on Oct 24, 2026

    @github-actions

    @lkk48775-tech, you are approved to open pull requests.

  3. micooz commented on Oct 30, 2026

    @micooz
    Contributor

    ping @lkk48775-tech 进度怎么样?

  4. lkk48775-tech commented on Nov 1, 2026

    @lkk48775-tech
    ContributorAuthor

    验证已完成,三轮执行、其中两轮独立交叉,结果如下:

    环境:Windows 11 x64 (10.0.26200)、Rust 1.99.1 stable、Node v22.20.0、pnpm 12.6.0、WebView2 Runtime 156.0.4314.50,基于 main @ 3c27fde。

    构建:pnpm install --frozen-lockfile + pnpm build(tauri build,独立 CARGO_TARGET_DIR)exit 0、无 error。产物aidget_0.1.0_x64-setup.exe(NSIS,5.84 MiB)、aidget_0.1.0_x64_en-US.msi(8.12 MiB),均 0.1.0 / x64(SHA256 与 MSI 属性表已核对)。

    安装:NSIS /P 被动向导 → currentUser 模式,默认路径 %LOCALAPPDATA%\aidget,开始菜单 + 桌面快捷方式生成;MSI → 每机器安装至 C:\Program Files\aidget。

    启动:开始菜单快捷方式启动,主窗口经 WebView2 正常渲染。

    冒烟(临时 AIDGET_HOME):widget create → 桌面窗口正常显示→ widget delete,回收站含渲染预览。

    Image

    卸载:卸载向导执行,安装目录 / 快捷方式 / 卸载注册表项全部清除;用户数据(AIDGET_HOME)按设计保留。查实卸载向导的 "Delete the application data" 勾选框控制记忆键与 WebView2 数据的清除,属设计行为。

    未执行/受阻项:签名/SmartScreen 属预期,未触发;macOS/Linux 不在本范围。

    顺带发现(与打包无关,应用层,供参考):

    1. aidget.cmd 与接入页展示的 MCP 命令含 \\?\ 前缀,cmd.exe 无法执行;
    Image
  5. lkk48775-tech commented on Nov 1, 2026

    @lkk48775-tech
    ContributorAuthor

    关于上面提到的 \\?\ 路径问题**:

    问题回顾:app 写入数据根的 CLI 入口 aidget.cmd,以及接入页"第一步:接入 MCP 服务"
    展示的 MCP 命令,路径都带 \\?\ verbatim 前缀(process.rs:30 和 integration.rs:230
    的 canonicalize() 产生,Windows 平台特性)。

    危害评估:

    • 正常使用(GUI、开始菜单启动、widget 操作、直接调 exe 的 CLI)完全不受影响;
    • agent 的 MCP 接入基本不受影响——CreateProcess 认 \\?\ 路径,主流 MCP 宿主
      (codex/claude 等)都是直接拉起命令的,实测正常;
    • 会踩坑的场景只有一种:把入口交给 cmd.exe 解释——运行 aidget.cmd、把命令写进
      .bat 批处理、PowerShell 调 .cmd;
    • 具体影响:README 承诺的 CLI 入口不可用;照接入页引导复制的命令在 cmd/批处理环境
      直接报"系统找不到指定的路径"。属于低严重度的功能缺陷,不在主路径上,
      但卡在产品核心引导(接入页)展示的命令上。

    改进方案(二选一):

    1. 引入 dunce crate(极小、零依赖),dunce::simplified() 剥前缀——
      成熟、UNC 等边界情况有测试覆盖,代价是新增一个依赖;
    2. 手动 strip_prefix(r"\\?\") 内联处理 \\?\UNC\ 特例——零新依赖,代码约 5 行;

    两个方案修改点相同:src/runtime/process.rs 的 publish_cli 与
    src/agents/integration.rs 的 current_executable,并同步更新
    tests/runtime/process.rs 的断言。

    请问这个修复是否由我来做?方向是否是在 canonicalize() 之后剥离 Windows 的 \\?\verbatim 前缀(publish_cli 与 current_executable 两处,或引入 dunce::simplified),并补测试?

  6. micooz commented on Nov 1, 2026

    @micooz
    Contributor

    感谢验证,直接开 PR 修复即可。

  7. lkk48775-tech commented on Nov 1, 2026

    @lkk48775-tech
    ContributorAuthor

    PR 已提交:#20

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions