Skip to content

商用版本验收清单(给用户本人,约 10 分钟) ​

开发期间所有授权都用模拟实现(用户 2026-11-16 要求)。下面这些只有你本人在 Mac 前才能做,做完就算验收通过。每一步写了"预期结果",不符合就截图告诉我。

准备 ​

  • 打开 /Applications/passno.app(Spotlight 里只应该有一个 passno)。
  • 终端里能用 pn:pn --version、pn doctor。

1. 首次使用(2 分钟) ​

  1. 第一次打开:如果 iCloud 里没有旧保险库,看到“创建保险库”;设主密码,记下 Secret Key(应急套件)。 预期:只有一个主按钮,界面简洁;Secret Key 只显示这一次。
  2. 设置 → 导入与导出 → 从 1Password(.1pux)或 Apple 密码(.csv)导入你的真实导出。 预期:预览条目数和你的导出一致;导入后列表里能搜到(中文不带空格也能搜)。

2. 解锁与钥匙串(2 分钟,需要你点) ​

  1. 设置 → 安全与解锁 → 启用 Touch ID。系统可能弹钥匙串“允许”框,点“始终允许”。
  2. 锁定(⌘L),再用 Touch ID / Apple Watch 解锁。 预期:一次解锁后,终端里 pn list 不用再输密码;pn lock 后 App 也回到锁定页。

3. 浏览器插件(2 分钟) ​

  1. 设置 → 浏览器插件 → 安装。按提示在 Chrome(建议先用一个单独的 Chrome 配置)里加载插件。
  2. 打开一个你真实登录过的网站的登录页,点进用户名框。 预期:自动弹出 passno 下拉框,选一个账号,用户名、密码(和验证码)一次填好;登录后如果是新密码,弹“保存到 passno?”。
  3. 可选:在支持通行密钥的网站上创建一个通行密钥,选“使用 passno”。

4. Agent(2 分钟) ​

  1. 终端:pn agent setup claude(会调用 claude mcp add 注册,用户级)。
  2. 在 Claude Code 里说:“用 passno 查一下 GitHub 的用户名是什么”。 预期:Claude 能查到用户名,但拿不到密码明文;需要用密钥时走批准,审计日志里有记录(pn agent audit --verify)。 注意:passno 的 ssh-agent 只支持 Ed25519 密钥(RSA / ECDSA 因安全公告已关闭,见 docs/security/threat-model.md)。

4b. 批准 agent 请求(1 分钟) ​

先在 App 里打开某个条目,在详情底部打开“允许 agent 使用”。

在 Claude Code 里让它“用 passno 里的 xx 调一下 API”。 预期:passno 窗口弹到前面,显示是哪个 agent、哪个条目、具体网址和它写的用途;点“仅这一次”后 agent 继续,设置 → Agent 里能看到这次授权和审计记录。iPhone 配对过的话,也可以在 iPhone 的「批准 Mac」页里批准。

再让它“把 xx 的密码明文给我看一下”(走取出明文)。预期:弹窗里多一行“批准后会请你用 Touch ID(或登录密码)确认一次”;点“仅这一次”后弹出 Touch ID;取消 Touch ID 则请求还留着,再点一次确认后 agent 才拿到值。拒绝不会弹 Touch ID。

5. 同步与恢复(可选,需要第二台设备) ​

  1. 设置 → 存放位置:主位置选 iCloud Drive(或 GitHub 私有仓库 / Cloudflare R2 / WebDAV),点“立即同步”。
  2. 在另一台登录同一 Apple ID 的 Mac 上打开 passno。 预期:显示“发现保险库 → 恢复”,只输主密码就能打开,数据一致。

5b. iCloud(需要签名后) ​

iCloud 用的是 App 自己的 iCloud 容器(iCloud.com.virtever.passno)。2026-11-16 已在开发者账号里建好容器和 App Group,并分配给两个 App ID;Mac 的 Developer ID 描述文件也已生成(放在 ~/.passno-release/passno.provisionprofile,含 iCloud 权限)。用 scripts/release/mac-release.sh 正式签名后:

  1. 新建保险库时,“备份到 iCloud(推荐)”默认勾选(Mac 和 iPhone 都一样);不勾也可以以后在设置 → 存放位置里点“备份到 iCloud”。
  2. 之后每次修改都会自动备份,设置里显示“上次同步”的时间。
  3. 新 iPhone 或 Mac 登录同一个 Apple ID 后打开 passno,应自动显示“恢复保险库”,只输主密码。

只有签了 iCloud 权限、并且登录了 iCloud 的 App 才会显示这个选项;开发版没有签名,不会出现,避免出现“以为备份了,其实只在本机”的情况。

6. iPhone(可选,等 iOS 上架流程) ​

真机安装需要签名和设备授权,等你决定上架方式后再做;模拟器上已验证 Face ID、自动填充和通行密钥。

7. 签名与公证(发布前一次) ​

在 Mac 前运行 scripts/release/mac-release.sh --arch aarch64(不加 --dry-run)。钥匙串询问 codesign 能否使用 “Developer ID Application: Feng Chen” 私钥时点“始终允许”。 预期:生成已公证、可双击安装的 DMG;spctl -a -vv 显示 “Notarized Developer ID”。

iPhone 配对与批准(真机,需要 Mac 和 iPhone 在同一 Wi-Fi) ​

  1. Mac:设置 → 安全 → iPhone 和 Apple Watch → 配对 iPhone。第一次会弹 macOS 防火墙“允许传入连接”,点允许。
  2. iPhone:passno → 设置 → 批准 Mac → 扫码配对,扫 Mac 上的二维码(第一次会要相机权限、本地网络权限)。核对两边指纹,在 Mac 上点“完成配对”,手机自动完成。
  3. 预期:Mac 的 Touch ID 解锁照常可用;让 agent 请求一个条目,iPhone 上“查看 agent 请求”能看到并批准。
  4. 可选:打开“只能用 iPhone 解锁这台 Mac”,Touch ID 解锁应被拒绝,只能用 iPhone 批准或主密码。
  5. 推送:Mac 锁屏,让 agent 请求一个没有长期授权的条目;iPhone(App 在后台)应收到“有 agent 在等你批准”,点开后自动显示请求,选时长批准后 agent 成功,Mac 仍锁着。
  6. 关掉 Mac 上 passno 的窗口:菜单栏里应还有 passno,菜单能打开窗口、立即锁定、撤销所有 agent 授权、退出。

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