Skip to content

Windows 开发与测试 ​

Windows 版是阶段 8(见 计划),分支 feat/windows,做完的部分已经合进 main。浏览器扩展只做 Chrome(用户 2026-11-16 定)。

在虚拟机上跑 ​

bash
tools/windows-e2e/vm-run.sh ssh tools/windows-e2e/smoke.ps1   # 编译、拿锁、复制、运行、放锁
tools/windows-e2e/vm-run.sh status                             # 谁拿着虚拟机锁
  • 虚拟机: Win11 ARM64,ssh 主机名 win11,桌面和 glass 共用。
  • 锁: 和 glass 是同一把锁。脚本运行时读取 glass 仓库里的 tools/windows-e2e/vm-lib.ps1(GLASS_REPO,默认 ~/code/github/glass),锁的格式和规则因此永远和 glass 一致。拿不到锁时退出码为 75。
  • 只动 passno 自己的东西:
    • 文件只在 C:\passno-dev;
    • 退出时(包括超时)只结束 C:\passno-dev 下的程序和正在跑我们脚本的 pwsh,然后放锁;
    • 冒烟测试只写、并删除 passno 自己的 Chrome 注册表项。原本就有这个项时,跳过这一步,不去动它。
  • 目前编译 x64 版本(cargo xwin,需要 Homebrew 的 LLVM),在虚拟机上靠 Windows 的 x64 模拟运行。原生 ARM64 版暂时编不出来:ring 必须用 clang 编,而 aws-lc-sys 用 clang 编 MSVC 目标时,NEON 向量代码(hrss.c)不过;换成 clang-cl 又轮到 ring 不过。等上游修好,或者整个项目统一改用 ring 后再做。

2026-11-16 冒烟测试结果 ​

在真实的 Windows 上 12 项全部通过(ssh 会话,没有桌面):

  1. pn init 自动拉起 passnod,经命名管道 \\.\pipe\passno-<哈希> 通信;
  2. 查看状态;
  3. 解锁;
  4. 加条目;
  5. 列条目,输出里不带密码;
  6. 锁定;
  7. 锁定后状态正确;
  8. passno-nmhost install-manifest;
  9. Chrome 注册表项指向 manifest;
  10. uninstall-manifest 删除注册表项。

此外,对端校验也生效了:同一用户、未签名的进程被放行,并打出告警,和设计一致。

测出来并修好的问题 ​

  • daemon 继承了调用方的句柄:Rust 标准库的 Command 在 Windows 上用 bInheritHandles = TRUE,passnod 会继承 pn 的输出管道,调用方于是一直等不到输出结束,命令卡死。由 Chrome 拉起时,Chrome 的管道也会被占住。
    • 现在 passno_ipc::spawn_windows 直接调 CreateProcessW:不继承任何句柄、不开窗口;能脱离调用方的作业对象就脱离;环境变量里剔除主密码、服务令牌。
    • passnod 发现自己没有 stderr 时,把日志写进 run\passnod.log。
  • 锁页内存和别的密钥共用同一页:32 字节的密钥缓冲可能落在同一个内存页上。页锁不计数,释放一个就把整页解锁了;Windows 上第二次 VirtualUnlock 还会报错,开发版因此 panic,表现为 pn lock 返回内部错误。
    • 现在每个密钥独占一个按页对齐的页,释放时清零再解锁,解锁出错一律忽略。
    • 回归测试:hardening.rs 的 each_key_has_its_own_aligned_page_and_drops_in_any_order。
    • 这次是靠新做的崩溃报告找到出错位置的。

还没在 Windows 上验证的 ​

  • Credential Manager:ssh 会话里写不进去,按设计退回了 0600 文件。要在桌面会话里再测一次。
  • Windows Hello 快捷解锁和本人确认:需要桌面会话,还要有人在虚拟机上输 PIN 或刷脸,归到需要你本人做的事里。
  • SSH 代签:第 ③ 步,用加固过的命名管道来做。
  • 其他部件:桌面 App 的 Windows 构建、安装包、开机启动 passnod,以及 Chrome 扩展在 Windows 上的端到端测试。

桌面 App 和安装包(2026-11-16) ​

  • 打包:scripts/release/build-windows.sh 在 Mac 上交叉编出 pn、passnod、passno-nmhost 和 passno.exe,再用 NSIS 打成安装包 target/x86_64-pc-windows-msvc/release/bundle/nsis/passno_<版本>_x64-setup.exe。
    • 需要先装 brew install nsis、cargo-xwin 和 Homebrew 的 LLVM。
    • 按当前用户安装(%LOCALAPPDATA%\passno),不需要管理员权限。
    • 在 Windows 代码签名证书到位前,安装包没有签名。
  • 开机启动:已安装的 App 启动时,把 passnod.exe 写进 HKCU\Software\Microsoft\Windows\CurrentVersion\Run(值名 passno daemon)。从 target\ 运行的开发版不写。
  • 按程序名认人:后台进程原来比的是文件名,Windows 上会带 .exe,所以 App 的批准、Chrome 的通行密钥和“在 passno 中打开”都会被拒。现在统一用 PeerIdentity::program_name(),去掉 .exe,Windows 上不区分大小写;冒充用的近似名字仍然被拒。找同目录下的 passnod 时也带上 .exe。
  • 浏览器插件设置页:Windows 上在 passno.exe 旁边找 passno-nmhost.exe 和 extension\。

安装包实测(2026-11-16,tools/windows-e2e/install-smoke.ps1) ​

在虚拟机上静默安装(/S),11 项全部通过:

  • 安装程序退出码为 0;
  • passno.exe、pn.exe、passnod.exe、passno-nmhost.exe、extension\manifest.json、许可证清单、uninstall.exe 都在;
  • 装好的 pn 能找到同目录的 passnod.exe,建库和查看状态都正常;
  • 静默卸载后,所有程序文件都被删掉。

本轮发现主程序装成了 passno-desktop.exe,已在打包配置里设成 passno.exe。

bash
scripts/release/build-windows.sh
tools/windows-e2e/vm-run.sh -B -f target/x86_64-pc-windows-msvc/release/bundle/nsis/passno_0.1.0_x64-setup.exe \
  ssh tools/windows-e2e/install-smoke.ps1 -Installer passno_0.1.0_x64-setup.exe

还没做:

  • 在桌面会话里打开 App,看界面、Credential Manager、Windows Hello;
  • 把 pn 加进用户 PATH(Windows 上不用符号链接,现在的“安装命令行工具”在 Windows 上会提示不支持);
  • SSH 代签;
  • Chrome 扩展在 Windows 上的端到端测试;
  • 原生 ARM64 构建。

命令行工具和 SSH 代签(2026-11-16) ​

  • 把 pn 加进 PATH:Windows 上“安装命令行工具”的做法,是把安装目录加进用户 PATH(HKCU\Environment\Path),再广播 WM_SETTINGCHANGE,新开的终端就能直接用 pn。
    • 不建符号链接,不需要管理员权限,只支持当前用户。
    • 代码在 apps/desktop/src-tauri/src/cli_path_windows.rs,在 Windows 上替换 cli_installer 模块,调用方不变。
  • SSH 代签:pn ssh-agent 在 Windows 上监听加固过的命名管道,默认名是 \\.\pipe\passno-ssh-agent-<哈希>,把 SSH_AUTH_SOCK 设成它即可。
    • 管道和 daemon 用的是同一套加固做法:只允许当前用户访问,管道名被别人抢先占用时启动失败。
    • 实现在 passno-agent/src/ssh_pipe.rs。ssh-agent-lib 自带的 NamedPipeListener 用的是系统默认权限,所以不用它。
  • 虚拟机实测(tools/windows-e2e/ssh-smoke.ps1):
    • Windows 自带的 OpenSSH ssh-add -L 能经管道连上 passno,协议通了。
    • 但还列不出密钥:同样的步骤在 macOS 上能找到 1 把,Windows 上是 0 把,原因还在查。
    • 已经排除的原因:
      • 私钥换行符(虚拟机上生成的是 LF);
      • 写入(磁盘上的文件结构和 macOS 一致);
      • 保险库和 agent 两个库的单元测试(交叉编译后在虚拟机上 38 项全部通过)。

冻结时的状态(2026-11-16) ​

用户定:Windows 版停在提交 0670a5f,以后的更新不考虑 Windows,重点是 iOS 和 Mac。scripts/check-all.sh 里的 Windows 交叉检查改成要加 --windows 才跑,所以之后的改动不保证还能在 Windows 上编译。

已完成并在虚拟机上测过:

  • 命名管道 IPC 和对端校验;
  • 建库、解锁、加条目、锁定;
  • Chrome 注册表登记;
  • NSIS 安装包,安装和卸载;
  • 开机启动;
  • pn 加进 PATH;
  • 保险库和 agent 两个库的单元测试。

写完了但没在 Windows 上实测: Windows Hello 快捷解锁和本人确认、凭据管理器存 Secret Key,这两项都需要桌面会话。

没做:

  • SSH 代签:管道通了,但列不出密钥。最后一次排查发现,用同一个服务令牌走 MCP 的 search 能看到这个 SSH 条目和它的 private_key 字段,所以问题出在 SSH 代签解析或筛选密钥那一段,而不是令牌读取保险库。下一步应该看 load_agent_ssh_keys 在 Windows 上为什么跳过了这个字段。
  • 桌面界面实测;
  • Chrome 端到端测试;
  • 原生 ARM64 构建;
  • 代码签名。

文档对应提交 56d1c45 · 由仓库 docs/ 自动生成