Appearance
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 会话,没有桌面):
pn init自动拉起 passnod,经命名管道\\.\pipe\passno-<哈希>通信;- 查看状态;
- 解锁;
- 加条目;
- 列条目,输出里不带密码;
- 锁定;
- 锁定后状态正确;
passno-nmhost install-manifest;- Chrome 注册表项指向 manifest;
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 项全部通过)。
- Windows 自带的 OpenSSH
冻结时的状态(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 构建;
- 代码签名。