Appearance
v0.2 第一轮整合
范围:真实 daemon 的浏览器适配、macOS 打包、桌面安全与数据入口。仅在 feat/integrate1 工作树;不推送、不合并,不修改协调者的 docs/plan.md。
实现与决定
- Native Messaging 默认使用
IpcPassnoClient;合成后端必须显式--fake-backend,只设置旧的 fake state 环境变量不再切换后端。 - 查找只取非明文摘要,填充前再次验证目标 frame 的 URL;明确条目 ID 的更新也必须匹配网站。按用户名精确匹配自动更新,避免合并大小写不同的账号。
- 网站匹配沿用
passno-match的 PSL 私有段、HTTPS 禁降级、端口和 PMR 规则。Regex / Never 不填充;旧 daemon 未提供 URL 规则时拒绝匹配。 - 更新登录在 daemon 的一个保险库锁内只修改用户名 / 密码,保留其他客户端最新写入的 TOTP、自定义字段、备注、标签、收藏和 URL 规则。填充也在同一个锁内检查当前 URL 策略并读取密码 / TOTP,杜绝检查与读取之间的竞态。
- 密码生成直接复用无状态
passno-gen,可在锁定时使用,不涉及保险库解密。
开源参考
只研究结构,代码独立实现:
- Browserpass native(ISC):stdio 宿主入口保持很小,诊断与消息分开。
- rbw agent(MIT):解锁状态和计时由单一后台进程持有,客户端不另建会话。
- Tauri 资源打包(MIT / Apache-2.0):使用资源映射固定扩展目录,和 externalBin 一起随 bundle 分发。
Contract changes
passno-service::Item.url_rules(Vec<passno_model::ItemUrl>,serde 缺省空):补充原始匹配策略,旧urls保持兼容;更新已有 URL 时保留 label / match mode。无保险库格式变化。- Native Messaging 现有 wire contract 保持不变;真实 stdio 模式必须提供允许的浏览器 origin,并经
BrowserCallerVerifier验证运行中的父进程。macOS 通过 Security.framework 校验 Google Chrome 签名(TeamEQHXZ8M8AV+ Chrome bundle ID),拒绝 shell / agent 伪造 argv。其他平台暂时拒绝真实宿主。 - 服务 / IPC 新增
browser_fill(id, url) -> BrowserFill、update_login_credentials(id, url, username, password) -> bool。这些是受信任客户端内部接口,不新增 CLI / MCP 明文路径;Debug 输出隐藏凭据。旧 daemon 不支持时拒绝请求,不退回分离的 reveal / 全条目写入。
需要用户本人
- 最终在安装后的签名 App 中验收真实 Touch ID / 钥匙串权限;本轮只测试 fake provider,绝不触发系统授权。
- 在 Chrome 开启开发者模式加载随 App 的未打包扩展;若需要关闭 Chrome 自带密码管理,仍由用户在插件中主动选择。
- 原生窗口与真实网页主观验收;商店账号、签名公证由其他工作线负责。
验证记录
2026-11-16(新加坡时间)在本工作树完成:
| 检查 | 结果 |
|---|---|
cargo fmt --all -- --check | 通过 |
cargo clippy --workspace --all-targets -- -D warnings | 通过 |
cargo test --workspace | 93 项测试通过 |
apps/desktop: npm run lint && npm test && npm run build | 通过;19 项测试 |
apps/extension: npm run lint && npm test && npm run build | 通过;11 项测试 |
cd apps/extension && npx playwright test | 17 项通过(14 项 fake + 3 项真实 daemon / UI) |
PASSNO_SIGN_IDENTITY=- APPLE_SIGNING_IDENTITY=- scripts/build-mac.sh --no-install | 通过;仅生成本工作树 App |
codesign --verify --deep --strict target/bundle.noindex/passno.app | 通过;nmhost 与扩展资源齐全 |
真实链路测试使用临时保险库、合成账号和模拟生物识别。原生文件选择器仅在 E2E 传输层替换返回路径, 附件读写、历史、设置及回收站都经过实际 Tauri 命令表与 daemon。截图在 /Volumes/Code/github/passno-wt/shots/integrate1/。
最终审查发现并修复的回归均有自动覆盖:shell 伪造 origin、密码更新覆盖其他字段、 填充与当前 URL 策略一致性、筛选 / 选择时监听断档、订阅前漏收锁定、daemon 断线重连、 取消生物识别后重试、TOTP 刷新导致空闲锁定失效。 release 宿主实测拒绝 shell 伪造 origin,拒绝前没有访问临时保险库;release passnod --help 不含 --simulate-biometrics。生产 Chrome 签名 requirement 也已对本机 Chrome 做只读校验,未启动或修改它。
构建仍有现有 Vite 单 chunk 大于 500 kB 的非阻断提示,未放宽检查门槛。 日志和工作记录位于本工作树 gitignored .superpowers/sdd/integrate1/。
打包与安装
scripts/build-mac.sh --no-install 构建 CLI、daemon、nmhost、扩展和桌面 App, 把 bundle 留在 target/bundle.noindex/passno.app,不会改动已安装 App 或 CLI 软链。 passno-nmhost 在 Contents/MacOS/,扩展在 Contents/Resources/extension/。 保留原单 bundle 清理检查,默认 ad-hoc 签名无需用户授权。
设置中的「浏览器插件」只在点击「连接 Chrome」后安装用户级 native manifest; 固定扩展 origin,指向当前 App 内的宿主,不回退到另一份 /Applications 安装。 安装器通过临时 bundle / 临时 Chrome 目录测试,校验了缺失资源时拒绝安装、目标路径和 origin。
桌面入口与测试边界
设置页增加浏览器插件;安全分节接入 daemon 的 Touch ID 和锁定策略。详情增加附件与历史; 回收站增加永久删除和清空确认。文件选择使用 rfd(MIT),只在本人点击时打开,未在无人值守验收中触发。
Contract changes 补充:新增 Tauri 数据命令、原生文件选择器命令和浏览器安装状态命令, 详见 api.md;历史明文接口只供本人 UI 操作,不加入 CLI / MCP。 vault-locked 清除全部已解锁 UI 状态,事件桥转发真实 daemon 事件。
调试版 passnod --vault-dir <临时目录> --simulate-biometrics 使用 fake biometric provider、 文件版 Secret Key store 和模拟系统事件。该参数只在 debug 构建存在,且强制指定临时目录。 生产构建没有该入口。Playwright 的 Chromium 是 ad-hoc 签名,测试额外设置 PASSNO_TEST_BROWSER_PATH=chromium.executablePath();仅 debug 宿主、显式临时保险库、完全匹配的运行中父进程路径才接受此测试替代。release 完全不包含此绕过。本工作树未触碰已安装 App、真实保险库、共享 Chrome、钥匙串或管理员授权。
已知范围边界
- 插件仍需未打包加载;Safari / WebAuthn / HTTP Basic 认证不在本次整合范围。
- 插件「在 App 中打开」会激活当前捆绑的 App,尚不通过 deep link 定位具体条目。
- 附件导出不覆盖已有目标文件;需选择新文件名。原生文件选择窗口留给用户最终验收。
- 本轮仅本机 macOS 验证;其他平台与真机生物识别按整体项目计划验收。