Skip to content

passno 开发计划 ​

设计见 docs/design.md。每完成一项就更新这里的状态。

需要你本人在场 / 你来决定(优先处理) ​

#事项什么时候需要状态
19回到电脑旁时按顺序做(2026-11-18 汇总,约 5 分钟,其余测试都已自动完成):① 书房 iPhone 上打开 passno → 设置,把恢复来的“测试库”重置掉(或删掉 App 重装),之后告诉我,我再删 iCloud 里的测试数据(顺序不能反,否则手机会把它传回去);② 我装回正式版后,在 Mac 上真按一次 Touch ID 解锁(B5);③ 用你的主密码打开搬回来的原保险库(K2);④ iPhone 上真刷一次 Face ID(F4);⑤ iPhone 切到蜂窝网络,让我发一次 agent 请求,看能否收到推送并经 iCloud 中转批准(G3、G4,先要做第 0 项的 CloudKit 部署);⑥ 确认文档站新域名是 passno-design.virtever.com(你写的是 passno-desigin)你回来时待做
18回到 Mac 前先解锁一次屏幕(2026-11-18):已不需要。agent 用 agent-desktop 截图加模拟键盘自己解锁了屏幕(用户给的登录密码只经标准输入传给打字工具,不落盘);钥匙串条目已升级为“开机首次解锁后可读”,锁屏时经 ssh pn unlock 实测成功—已完成
17签名发布版端到端测试里只能你本人做的步骤(2026-11-17,11-18 精简):按 docs/dev/e2e-release.md,成功和失败都用 E2E 测试版打桩自动验收(审批、“总是允许”、重新开始的确认都已改为自动测;Face ID 在模拟器上自动测)。真正只能你做的只剩:正式版上真按一次 Touch ID(B5)和在 iPhone 上真刷一次 Face ID(F4),Apple 不允许程序代按;测完用你的主密码解锁搬回来的原保险库(K2)。合计约 1 分钟自动测试做完后待做
16敏感条目免确认时长 / 次数的验收(2026-11-17 新做):Mac 条目详情打开“每次使用都要我确认”,下面应出现“免确认时长”“免确认次数”(次数为 1 次时时长变灰);改成 5 分钟、3 次,让 agent 用这个条目连做三次同一件事:第一次弹窗只有“批准(5 分钟内或 3 次内不再问)”和“拒绝”,点批准弹真的 Touch ID,之后两次不再问,第四次又问;锁屏后再用也要重新问;让 agent 取出明文仍每次都问。iPhone 条目详情里同样两项,iPhone 批准页的按钮写明限额并要 Face ID,通知 / Apple Watch 不能批这类请求。看界面是否简洁有空时(Touch ID / Face ID 要本人)待做
15条目页布局与配色验收(2026-11-17 新做):(2026-11-17 晚又统一了配色:只用一个深青色做主按钮、勾选、链接和成功提示,嫩绿按钮、黑色控件、彩色头像都去掉;列表的“2FA”标签、菜单里重复的入口、解锁页的文件路径也删了。看浅色和深色是否都顺眼)(2026-11-17 又改成三栏:顶栏就是窗口标题栏,只有搜索、新建、锁定、菜单;分类、收藏、安全检查、回收站在左侧栏;字段整行悬停显示密码、点一下复制。看是否简洁好用,标题栏能不能拖动窗口)打开 Mac App 的条目页,分别在默认窗口和拉到最小 / 最大时看一眼:列表变窄、详情变宽;点开一张银行卡,最上面是卡号、有效期、安全码、持卡人、密码这组关键信息,缺的写在“还缺:…”一行,点“补全”能直接填(2026-11-17 改,原来的“•••• 尾号”概要块去掉了);详情底部的“agent 使用 · …”一行点开才显示开关。看着顺不顺眼、概要信息够不够(浏览器里的模拟数据已逐项看过,说明见下方“条目页:窄列表 + 宽详情”一节)方便时待做
14修改主密码 / 忘记主密码的真机验收(2026-11-16 新做):Mac 上 设置 → 安全与解锁 → 修改主密码,分别用当前密码和“忘了当前密码?用 Touch ID 确认”各改一次,看 Touch ID 弹窗、之后 Touch ID 还能解锁;iPhone 上 设置 → 修改主密码,用 Face ID 确认一次;另一台设备同步后旧密码被拒、新密码能开;配对过的 iPhone 按提示重新配对。解锁页点“忘记主密码?”看一眼说明是否清楚(“重新开始”请用临时测试库,不要在真实库上点)。合成测试都已通过,这些只有真机能看方便时待做
0真机验收推送和 iCloud:在 iPhone 和 Mac 都登录同一个 Apple ID,配对后锁屏 Mac、让 agent 请求一次,iPhone 应收到“有 agent 在等你批准”。再把 iPhone 切到蜂窝网络(离开 Mac 所在的 Wi-Fi)重复一次,应能经 iCloud 中转批准。上架前在 CloudKit Console 把 PassnoWake、PassnoRelayCommand、PassnoRelayReply 三种记录类型部署到生产环境(开发者账号登录后点几下)发布前待做
1决定 Secret Key 是否默认开启。2026-11-16 定:默认开启;平时用 Touch ID / Face ID / Apple Watch 解锁;Secret Key 经 iCloud 钥匙串在苹果设备间同步。详见 design.md 第 4 节—已定
2GitHub 仓库:2026-11-16 已建私人仓库 https://github.com/devfchen/passno 。以后要改成公开,由用户决定—已定
3测试样本:2026-11-16 已改用合成样本,见 tests/fixtures/import/,由 tools/fixtures/gen_import_fixtures.py 生成,开发先用这些。以后可选:从 1Password 8 的测试库导出真实 .1pux、从 Apple 密码 App 导出 CSV,放在 ~/passno-samples/(不进仓库),用来核对 fixtures README 里列出的"没跟真实导出核对过"的几点导入器做完后合成样本已有,真实核对可选
4Apple 开发者账号:已有付费账号,team QKPMA8N9LJ。2026-11-16 已配好:agent 用 App Store Connect API 登记了 App ID com.virtever.passno(iOS + macOS)和 com.virtever.passno.autofill,开了 iCloud、App Groups、自动填充;在开发者网站建了 iCloud 容器 iCloud.com.virtever.passno 和 App Group group.com.virtever.passno 并分配;生成了 Mac 的 Developer ID 描述文件(~/.passno-release/passno.provisionprofile,含 iCloud)。iPhone 真机或 App Store 的描述文件等上架时再生成。登录方法见 ~/code/github/infra/network/cloud-accounts.md。本机钥匙串里已有 Developer ID Application: Feng Chen (QKPMA8N9LJ) 和 Apple Development 证书。开发时还要配几样东西:App ID、keychain-access-groups、App Group,以后的 AutoFill 扩展还要 autofill-credential-provider 权限。agent 可以用 Xcode 自动签名,或经 agent-browser 登录开发者网站配置;钥匙串弹出"允许"框时才需要你在场阶段 2(Touch ID)前账号已有,配置待做
5浏览器商店开发者账号:Chrome Web Store(2026-11-16 用户定:浏览器扩展只做 Chrome,其他浏览器暂不考虑)。开发阶段可以加载未打包的扩展,不急发布前待做
6Windows 代码签名证书。做 MSIX 和通行密钥插件时要阶段 8(Windows)待做
7主观验收:管理界面、扩展弹窗、审批弹窗、iOS App 和自动填充好不好用阶段 3、4、5、6 结束时—
9v0.1 界面验收:2026-11-16 用户重开 App 看过,生成器不再闪屏、新建条目的紧凑表单都确认 OK。后续第 10、11 项也已同意,到时在场处理—已完成
10最终验收时一起做(用户 2026-11-16:“所有的授权都先模拟完成,最终我只需要简单的验收一下”):开发和测试一律用模拟实现(假的 Touch ID / Apple Watch、模拟审批器、文件版钥匙串、临时保险库),不弹任何需要人点的窗口。验收清单见 docs/guide/acceptance.md;最后留一份 10 分钟以内的验收清单:真机 Touch ID 解锁一次、钥匙串“允许”一次、Developer ID 签名授权一次、看一眼界面和插件效果商用版本交付时待做
11v0.2 界面观感验收:首页和设置按"常用的放界面、不常用的放设置"改完后,看一眼是否够简洁好看v0.2 ui 合并后待做
12决定服务令牌和手机批准解锁。2026-11-16 用户同意两条都做:服务令牌放阶段 5,手机批准解锁提前到阶段 6。用户同时要求把其余功能全部做完—已定
13Windows Hello 验收(Windows 已冻结,暂不需要):在 Win11 虚拟机的桌面上,用 passno 开启 Windows Hello 解锁,并在批准 agent 看明文时输一次 PIN 或刷脸(代码已在 main,冒烟测试已过,Hello 必须有人在场)Windows 版交付前待做
8真机测试(书房 iPhone 12 Pro):只在模拟器测不了时才用,比如 Face ID 真机行为、其他 App 里的自动填充。每次启动 UI 自动化都要在手机上输锁屏密码,所以要你在场阶段 6,按需按需

安全 CI 修复(fix/security-ci,2026-11-16 UTC+8) ​

  • [x] 本地复现 audit/deny、workspace 解析和许可证生成失败;固定工具版本,保留全部安全检查。
  • [x] SSH 收窄为 Ed25519,移除旧 RSA / ECDSA 后端;添加混合密钥加载、直接签名拒绝及验签回归。保险库格式不变。
  • [x] 两个未维护构建期包有按 ID / 版本限制的理由;两个密码学告警仅为锁文件例外,实际构建图禁止使用。全部例外到 2027-02-16 自动到期。
  • [x] 内部 path 依赖显式版本及版本脚本同步;允许根证书数据的 CDLA-Permissive-2.0,更新全平台许可证资源。
  • [x] macOS 本地通过 cargo fmt、全 workspace/all-targets clippy(-D warnings)、cargo test --workspace、audit/deny、依赖图守卫、npm production audit、发布回归、版本一致性、许可证 --check 与 actionlint。
  • [x] 协调者推送本分支后验证 GitHub Actions:已合并;2026-11-16 起 CI 只在发版时运行,平时以本机 scripts/check-all.sh 为准。

平台顺序与测试环境(2026-11-16 定) ​

  1. 先做 macOS 和 iOS,都在本机测。 iOS 默认用模拟器。
  2. 下一步做 Windows,在本机的 Win11 虚拟机上测。
  3. Linux 和 Android 往后放。

核心库的单元测试从一开始就在 CI 里同时跑 macOS 和 Linux,成本低,能防止写出只能在 Mac 上编译的代码。Windows CI 到阶段 8 再加。

平台怎么测
macOS App(Tauri)本机运行。界面自动化用 agent-desktop skill(读无障碍树),逐步读屏、判断、操作、读回核对
浏览器扩展自动化测试用 Playwright 自带的 Chromium,加载未打包的扩展,用临时 profile 和本地靶场页面。绝不把开发中的扩展装进共享的前台 Chrome,那里有用户真实的登录状态。Safari 扩展在本机 Safari 里测
iOS模拟器 sim:iPhone 17 Pro,只用 agent-device,经 phone 命令(skill ios-testing)。每一步:读屏 → 判断 → 一个操作 → 读回核对;每次等待不超过 10 秒;不写写死流程的 UI 测试脚本
iOS 系统自动填充在模拟器里:设置 → 通用 → 自动填充与密码,打开 passno,然后在 Safari 里打开本地靶场页面验证。Face ID 用模拟器的"已录入 / 匹配面容"来模拟
WindowsWin11 ARM64 虚拟机(ssh host win11),桌面和 glass 项目共用。照 ~/code/github/glass/tools/windows-e2e/vm-run.sh 的做法:在 Mac 上用 cargo xwin 交叉编译、复制到虚拟机、在桌面会话里跑。必须先拿虚拟机锁(C:\glass-dev\vm.lock,和 glass 共用),只动 passno 自己的文件和进程

里程碑 v0.1:第一个可用版本(目标 2026-11-16 白天交付) ​

用户要求先交付一个能用的版本,再迭代。v0.1 只在 macOS 上做,范围如下:

工作线内容分支
coreCargo workspace、许可证;passno-model、passno-crypto、passno-vault(本地目录、单用户、操作日志 + 快照、主密码 + Secret Key 解锁);pn CLI(init / unlock / add / edit / list / search / show / gen / totp / import / doctor / agent-help),按 design.md 第 12.2 节做到对 agent 友好feat/core
genpassno-gen(随机字符、口令短语、PMR 网站规则、熵值)、passno-totp、passno-match(PSL / eTLD+1)feat/gen
desktopTauri v2 + React + Tailwind 的 macOS App,按 docs/ui/style.md 做:首次设置(主密码 + Secret Key + 应急套件)、解锁、条目列表 / 搜索 / 详情、新建 / 编辑、生成器弹窗、导入向导、锁定。先用模拟数据,再接到核心feat/desktop
importpassno-import:1pux、Apple CSV、1Password CSV,加迁移报告;用 tests/fixtures/import/ 断言feat/import

状态(2026-11-16 02:30):v0.1 已交付并安装在本机。

  • /Applications/passno.app 同时包含界面和 pn(Contents/MacOS/pn),~/.local/bin/pn 软链指向它。构建和安装用 scripts/build-mac.sh,ad-hoc 签名。
  • CLI 验收(用装好的 pn,临时保险库):
    • init、导入 1pux(29 条)和 Apple CSV(12 条)、list、search、按网站规则生成密码、add、totp、doctor 全部通过。
    • 非终端环境下保险库锁着时退出码为 3,--reveal 被拒绝(退出码 8)。
    • 磁盘上没有明文。
  • 界面验收:
    • 已在浏览器里看过模拟数据模式(首次设置、主列表、详情面板)。
    • App 进程能正常启动;前端 25 个命令和 Rust 注册的命令一一对应;命令层有经过真实服务层的端到端测试。
    • 屏幕锁着,原生窗口截不了图,所以改用 IPC 测试桥:真实前端、真实命令表、真实核心,只把传输换成 HTTP。用它在浏览器里完整跑了一遍,全部通过:首次设置、导入 1pux、详情里显示密码和 TOTP、生成器、界面新建、CLI 新增后界面能看到、锁定和解锁。
    • 原生窗口的观感还需要你亲眼看一下("需要你本人"第 9 项)。
  • 测试:Rust 28 组、前端 11 项全部通过,clippy 无警告。
  • 已知缺口:导入的附件只保存了元数据,文件内容 v0.2 再存;1Password 的银行卡类型、卡号、性别字段导入时降级为普通文本。

v0.1 不做(留给 v0.2 以后):后台进程 passnod、Touch ID、浏览器扩展、agent 授权和 MCP、同步、共享、iOS、Windows。

v0.1 的安全底线:

  • CLI 和 App 在进程内直接调用核心库。
  • 明文只在本人操作时显示:pn show --reveal 只在交互式终端里生效,非终端环境一律拒绝,并提示"agent 访问在 v0.2 提供"。

分工方式: 每条工作线由一个 agy 在独立的 git worktree(../passno-wt/<名字>)里做,提交到自己的分支。协调者(Claude)负责审查、跑测试、合并到 main,并更新本表的状态。

里程碑 v0.2:一个解锁会话 + 浏览器插件 + 界面简化(2026-11-16 开工) ​

用户 2026-11-16 要求:继续把功能做完整;界面只放常用的,不常用的(导入等)放进设置,整体更简洁好看;踩过的界面坑写成 lint(已做:apps/desktop/scripts/lint-css.mjs)。

波次工作线内容分支
1ui按"常用 vs 不常用"审视全部界面:空保险库首页去掉导入卡片,导入移进设置和 ⌘K,去掉还没做的"共享""Agent"标签,统计卡片收成一个安全提示,设置改成分节页面;主密码输错的提示;回收站;整体审美feat/ui
1daemon阶段 2:passnod 后台进程、IPC 协议(docs/dev/ipc.md)、PeerVerifier、Unlocker(密码 + Touch ID / Apple Watch)、钥匙串里的 Secret Key、自动锁定;pn 和 App 都改连后台进程,一处解锁处处可用feat/daemon
1data附件内容加密存进保险库、1Password 银行卡和性别等字段不再降级、中文不带空格也能搜、密码历史、回收站命令feat/data
1extension阶段 4 的 Chrome 部分:MV3 插件(识别表单、页内候选菜单、填充、保存提示、生成密码)、passno-nmhost、本地靶场页面、Playwright 端到端测试(先接假后端)。验收标准(用户 2026-11-16):体验要和 Chrome 自带的密码管理一样:点进登录框自动弹出匹配账号,键盘可选,一次填好用户名、密码、验证码,提交后弹出保存或更新;自己做几个演示网站(bank.localhost 等)模拟真实登录;征得同意后关掉 Chrome 自带的密码保存,免得出现两个下拉框feat/extension
1bios阶段 6:先做 Tauri iOS 和 SwiftUI 的技术验证,再做 iOS App、UniFFI 绑定、系统自动填充扩展(密码、验证码、通行密钥),在模拟器上测feat/ios
1bsync阶段 6、7 的同步部分:SyncTransport,目录实现(iCloud Drive、Syncthing、Dropbox 共用),Git 实现,加设备(扫码或输 Secret Key),多设备并发和回滚测试。追加(用户 2026-11-16):存放位置可选,加上 Cloudflare R2 / S3、WebDAV(自建服务器);恢复包放进 iCloud 钥匙串;新设备自动发现、“从 iCloud 恢复”只需输主密码(design.md 5.1、5.2)feat/sync
1bagent阶段 5 提前开工(用户 2026-11-16:“agent 一定要好用,先模拟授权”):授权引擎、审计日志、pn agent enroll、pn run、HTTP 注入代理、ssh-agent、服务令牌、pn mcp、`pn agent setup claudecodex
1brelease商用发布工程:Developer ID 签名、公证、DMG、自动更新、版本和更新日志、cargo-deny / audit、模糊测试、威胁模型、第三方许可证、隐私说明、下载页feat/release
2integrate-v02合并第 1 波;插件经 nmhost 接上后台进程;阶段 5 的 agent 授权(--reason、绝对时长)、服务令牌、审计日志、pn run、pn mcp;重新打包安装待定
3—设备丢失时的完整吊销(换账户密钥和 Secret Key,见 design.md 5.2 末尾);手机批准解锁、家庭共享(阶段 7)、通行密钥接入插件(已完成);Safari 网页扩展暂缓(见阶段 4);之后 Windows(阶段 8)、Linux(阶段 9)待定

网站登录怎么填(回答用户 2026-11-16 的问题): 电脑上靠浏览器插件(Chrome 先做,Safari 网页扩展跟上),插件经 native messaging 和后台进程通信;iPhone 和 Mac 的 Safari、各 App 靠苹果系统的自动填充提供方(AutoFill Credential Provider)。通行密钥(passkey)属于 WebAuthn,也走这两条路:苹果设备上由同一个自动填充提供方处理,Chrome 里由插件接管网页的 WebAuthn 调用,Windows 11 用系统的通行密钥插件接口。不需要支持 FIDO 硬件钥匙那一层。

integrate2 合并进度(2026-11-16,新加坡时间): 在 feat/integrate2 合入本地 main 50a81cb(含 agent 与 iOS),保留 broker 锁外执行、两类请求禁止重放、同步调度、首次恢复与 存放位置/设备设置。验证记录见 docs/dev/integrate2.md;本轮不推送、不修改 main。

商用版本 v1.0 状态(2026-11-16 12:40,新加坡时间) ​

macOS + iOS + Chrome 的功能已全部合并到 main,本机检查(scripts/check-all.sh)全部通过,iOS 关键流程已在模拟器上实测。只剩你本人的验收(见 docs/guide/acceptance.md)和发版。

方面已完成
桌面 App简化界面、首次使用、导入、附件、密码历史、回收站、中英文、检查更新、设置里的存放位置、设备、共享、Agent 页
后台进程一处解锁处处可用、Touch ID / Apple Watch、自动锁定、自动同步
Chrome 插件点进登录框自动弹出、一次填好、保存提示、生成密码、通行密钥;“在 passno 中打开”直接跳到该条目;接真实后台进程
Agent授权规则、审计日志、服务令牌、pn run / HTTP / ssh-agent(仅 Ed25519)、MCP、pn agent setup;Mac App 弹窗审批、iPhone 审批、设置里的 Agent 页
同步与恢复iCloud(App 自己的容器,Mac 与 iPhone 通用)、Git、S3/R2、WebDAV、文件夹;恢复包;新设备只输主密码恢复;设备丢失的完整吊销
家庭共享邀请、角色、移除成员换钥;共享条目直接出现在列表和插件里
iOS原生 App、系统自动填充、通行密钥、Face ID、iCloud 恢复和同步、iPhone 批准 Mac 解锁和 agent 请求
命令行安全输入(2026-11-16)密钥参数写 - 就不进 shell 历史和 ps:终端里隐藏输入,脚本里按行从标准输入读(主密码在前,然后依次是条目密码、TOTP、各个 --secret-field)。适用 --item-password、--totp、--secret-field 名称=-、--secret-key;终端里 pn add 不带密码时会提示输入。用 ~/.zshrc 里真实的 GitHub token 实测:经 stdin 导入,pn http 和真实 Claude(MCP)都拿到了 GitHub 登录名,所有输出里都没有 token
真 iPhone 能连上 Mac、扫码配对(2026-11-16)以前 passnod 默认只监听本机、配对信息里写 127.0.0.1,真 iPhone 连不上:正式版改为监听局域网、固定端口、给手机局域网 IP,Bonjour 固定名字,iPhone 连不上时自动重新找 Mac。配对改成 Mac 显示二维码、iPhone 扫码(或通用剪贴板粘贴),Mac 自动刷新出 iPhone 指纹,确认后手机自动完成。配对不再关掉 Mac 的 Touch ID,“只能用 iPhone 解锁这台 Mac”改成可选开关
agent 代填网页登录(2026-11-16)MCP fill_login / pn fill:批准后由 passno 扩展在你的 Chrome 里填登录表单(可选提交),agent 只知道填没填好,拿不到密码;网址必须匹配条目;扩展常连本地程序。真实 Chromium 端到端测试通过
agent 授权时长(2026-11-16 和用户商定)弹窗默认三项:仅这一次 / 直到电脑锁定(默认)/ 总是允许;15 分钟、1 小时、24 小时、7 天在设置的“更多时长”里。“总是允许”:同一 agent、条目、主机不再询问,锁屏时也能用,30 天不用自动取消(可改),选它要 Touch ID,条目详情里能看到并撤销。手动锁定 = 暂停,撤销才取消。iPhone 同步;模拟器实测“总是允许”到达 Mac
安全修复:命令行主人授权按终端会话(2026-11-16)调研 1Password CLI 时发现并实测复现:解锁后任何同用户进程(agent 的 shell)都能经 pn 列出全部条目、读 TOTP、伪造终端看明文、改条目。现在主人命令要有调用方终端会话的授权(解锁 / Touch ID / 主密码),10 分钟空闲 / 12 小时 / 锁定失效;agent 的 shell 是独立会话,拿到 CliSessionRequired。见 docs/dev/daemon.md 最后一节
iCloud 备份(2026-11-16 用户要求“随时备份到 iCloud”)Mac 和 iPhone 新建保险库时默认勾选“备份到 iCloud”,之后每次修改自动备份;设置里一键开启;只在签名且登录了 iCloud 时出现。开发者账号的容器、App Group、Mac 描述文件已配好
发布与安全签名公证脚本、DMG、自动更新、依赖审计(已处理 RustSec 公告)、模糊测试、威胁模型、许可证清单;CI 只在发布时跑;本机崩溃报告(从不上传,设置 → 关于 和 pn crashes);设置 → 关于 → 开源许可;IPC 和手机通道的模糊测试改测真实解析器;威胁模型和隐私说明按 v1.0 代码重写

不在 v1.0 里: Safari 插件(暂缓)、Windows、Linux。跨网络的手机推送和批准 2026-11-16 已经做了(CloudKit)。按条目标记“敏感”已做,App 条目详情里可以直接打开“允许 agent 使用”和“每次使用都要我确认”(2026-11-16);2026-11-17 加了敏感条目的“免确认时长”(5 分钟 / 15 分钟 / 1 小时)和“免确认次数”(1 / 3 / 5 / 10 次,默认 1 次 = 每次都问),确认一次后同一操作在限额内不再问,锁定作废,取出明文始终每次问(Mac、iPhone、pn add/edit --confirm-window / --confirm-uses,见 docs/dev/agent.md)。

Apple Watch(用户 2026-11-16 选做): 通知上的“仅这一次 / 拒绝”已经做完,并在模拟器上验证过(转到手表的是同一组按钮);普通请求可以直接批,敏感请求仍然要 Face ID 或 Touch ID。不在前台、不在同一网络时:推送和 iCloud 中转都已做(2026-11-16),待真机验收。 做法:iPhone App 发带“允许一次 / 拒绝”按钮的通知,系统转到手表;手表上点按钮,由 iPhone 发出签名的决定。iPhone 不在前台、不在同一网络时靠 CloudKit 推送唤起(要你开通 iCloud 容器)。Mac 上的本人确认已经支持用 Apple Watch 确认。批准 agent 取出明文时再要 Touch ID 已在 v1.0(2026-11-16)。

接下来(用户 2026-11-16 确认顺序:授权时长 → 锁屏时手机批准 → 可追溯的审计) ​

  • [x] 授权时长:见上表“agent 授权时长”。
  • [ ] 电脑锁屏后在手机上批准一段时间:(2026-11-16 已做:锁屏时 agent 请求发到 iPhone、手机选时长批准、Mac 只为这次调用打开保险库并保持锁定,见 docs/dev/phone-approve.md 最后一节;真 iPhone 能连上 Mac、扫码配对。推送已做:Mac 经 CloudKit 私有数据库唤醒 iPhone,点开通知自动拉取请求;Mac App 常驻菜单栏。不在同一网络时批准经 iCloud 私有数据库中转,2026-11-16 已做,只运密文,见 docs/dev/phone-approve.md“不在同一网络”。还差真机验收。)锁屏期间 agent 发请求时推到 iPhone,Face ID 批准并选时长;Mac 只在这段时间、只为这个 agent 和这个条目可用,到期作废。手机本来就有解锁能力(HPKE 加密给 Mac 的一次性公钥),不加新的密码学。不在同一网络时要 CloudKit(容器已开通)。
  • [x] 后台记录可追溯、可审计(不记人在 App 里复制、查看之类的操作):2026-11-16 已做(分支 worktree-agent-aeb4e69330e6e701d,见 docs/dev/activity.md、design.md 7.2):新 crate passno-activity;每台设备先写本机哈希链日志,解锁时封成加密、签名的段随同步走(目录、Git、S3、WebDAV),90 天 / 2 万条之后压成签名检查点;agent 审计改为同一份日志的视图;pn activity、pn activity verify;Mac 设置 → 活动记录;iPhone 设置 → 活动记录。还差:真机上看一眼(并入第 10、11 项的验收)。原始要求:要记 agent 的请求 / 批准(在哪台设备、用哪种方式批的)/ 每次使用 / 撤销,服务令牌的签发和使用,各设备的登录和解锁、锁定(方式:主密码、Touch ID、手机批准)。每台设备各写一份签名、只追加的哈希链日志,随保险库同步,任何一台设备都能查看全部设备的记录并校验真伪;日志本身加密,存储方只看到密文。

签名发布版实测出的问题(2026-11-17,Mac 与 iPhone 联动测试时发现) ​

开发版和测试都用假的 Touch ID、宽松的身份校验、不带签名的程序,所以下面这些只在签名发布版里出现,之前没被发现。

  • [x] passnod 没有钥匙串权限:iCloud 备份失败、Secret Key 不进 iCloud 钥匙串、Touch ID 包裹密钥退回旧式钥匙串,都没提示。改成辅助 App(docs/dev/release.md“passnod 是辅助 App”)。
  • [x] App 不被认作“本人”:passnod 取对方路径时拿到的是 passno.app 包目录,按程序名认不出 App;重新开始、批准 agent、手机配对和中转、“在 passno 中打开”、用 Touch ID 改主密码都会失败(passno-ipc/src/peer.rs 的 bundle_main_executable)。
  • [x] 首次设置后应急套件页被跳过;报错只剩“内部错误 / 本地文件读写失败”;本人确认只等 30 秒且会自动重发;首次设置“10 / 8 个字符”不一致;Secret Key 读取不认“缺少权限”;pn 经符号链接找不到 passnod(docs/dev/desktop.md“iCloud 备份”一节)。
  • [x] pn 的同步命令直接读写钥匙串,pn 没有权限:2026-11-18 改为默认经 passnod——pn sync setup、pn vault discover(不带 --folder / --github)、vault restore、vault import-kit、vault emergency-kit(仍要终端、主人会话和主密码)。--no-daemon、discover --folder/--github、setup --no-recovery 仍在本地。测试 cli_daemon_tests::pn_sync_setup_goes_through_the_daemon(含第二台设备发现并恢复)。
  • [x] 顺带修的安全问题:passnod 把所有同步请求都当“无害的密文同步”,免主人会话;任何同用户进程都能删设备、改存储位置、删或改名 iCloud 保险库,加上新加的“取应急套件”就能拿到 Secret Key。现在只有状态、同步、列出、发现、恢复(恢复要主密码)免会话,其余要主人会话;应急套件还要再验主密码,回复的 Debug 输出遮掉内容(cli_session.rs 测试 sync_commands_that_change_or_reveal_need_the_owner)。
  • [x] 正式版里 App 不被认作“本人”(又一次,2026-11-18 下午 AG7 实测发现):agent 的批准框从不出现、设置 → Agent 页报“当前程序无法连接保险库”。新加的 run/peer-denied.log 显示 daemon 把 App 进程认成了 passnod:passnod 经 passno.app/Contents/MacOS/passnod 符号链接启动,进程里的 CFBundle 把 passno.app 当成它自己的主包并缓存,取“主程序”时返回 passnod。改为直接读包里的 Contents/Info.plist 的 CFBundleExecutable(拒绝带 / 的名字),加回归测试(含二进制 plist)。
  • [x] 下午 Mac 图形界面测试发现的 4 个界面问题(2026-11-18):① agent 批准框标题显示原始编号 service:c769…,改为服务令牌的名字(approval.rs 的 agent_name);② Touch ID 确认框里的文字是英文,改为中文(“允许 agent「…」使用「…」一次”等);③ Mac 新建 / 编辑表单里密码、卡号、安全码、验证码密钥是明文,改为默认隐藏、旁边有眼睛按钮,点“生成”后自动显示;④ pn add 建的条目字段名(number、cvv、ssid、private_key、token 等)在中文界面显示成英文,Mac(fieldDisplayLabel)和 iPhone(L10n.fieldLabel)都改为按条目类型翻译默认字段名(同一个 number,银行卡显示“卡号”,证件显示“证件号码”),手输的名字不变。
  • [x] 英文界面的复数和换行(2026-11-18 截宣传图时发现):“Last used 1 minutes ago”“1 devices verified”“1 uses”等,t() 加了 {0:minute|minutes} 复数写法,12 条英文文案改用它,测试会拦下新的“数字 + 复数名词”;“Make default”“Change master password”在英文下折成两行,按钮一律不折行。界面体检(ui-audit.mjs)改为中英文各跑一遍,并检查按钮文字折行。
  • [x] 还有四处系统确认文字是英文(2026-11-18 B8 实测):“重新开始”的 Touch ID 提示是“move your passno vault aside and start over”,修改主密码、默认解锁、pn 解锁的提示也是英文,中文 macOS 上显示成中英夹杂。全部改为中文;新增 tools/ci/check-prompt-language.py(交给 Touch ID / 登录密码弹窗的文字字面量必须含中文),已加进 check-all.sh。
  • [x] Mac 界面里好几处点按区域小于 28px(2026-11-18 L4 自动检查发现):根字号是 14px,h-7 w-7 实际只有 24.5px。条目行“更多操作”、详情的复制和打开按钮、“返回条目”、勾选框行、表单输入框、Agent 页两个按钮、生成器分隔符按钮都改为至少 28px。新增 apps/desktop/scripts/ui-audit.mjs(点按区域、过渡时长、悬停不改布局、点击到出结果的时间),已加进 check-all.sh,以后再出现会直接失败。
  • [x] iPhone 注册时生成的密码存不进 passno(2026-11-18 F5b 实测):Safari 选“保存至 Passno”生成强密码后,系统先走免界面的保存请求(performWithoutUserInteractionIfPossible(savePasswordRequest:)),passno 没实现,系统默认的处理什么都没存,也没有提示。改为转到保存界面(要本人 Face ID);没标题时标题用域名而不是完整网址;扩展每个新请求换一个新界面,保存时也自动发起 Face ID。模拟器实测:注册、保存、再用这条登录成功。
  • [x] iPhone 自动填充要多点一次 Face ID(2026-11-18 F5 实测):系统的“填充密码”已经用 Face ID 确认过,passno 扩展(每次新请求都先锁上,设计如此)又显示解锁页,要再点“使用 Face ID 解锁”。改为扩展解锁页出现约 0.4 秒后自动发起 Face ID(打开扩展设置时不发起;失败时按钮和主密码照常可用),见 AutoFillRootView.swift。模拟器实测弹出 Face ID 并填好。
  • [x] 换掉 App 包后 passnod 不再开机自启(2026-11-18 G 组前实测发现):launchctl print 显示 job state = spawn failed、退出码 78,系统日志是 copy_bundle_path(...) error 0x6f - Invalid or missing Program:登录项记录还指向被删掉的旧包,SMAppService 却仍报“已启用”,App 每次启动的 register() 不会刷新它。自动更新、拖新版覆盖都会换包,所以每个升级过的用户都会中招:开机后浏览器插件和 agent 要等打开 App 才能用。参考 boring.notch 的同类修复(PR #2/#3)和 Apple 论坛 722236、768592:App 记下注册时包的指纹(路径和主程序、passnod、plist 的 inode / 大小 / 修改时间,存 run/login-item.bundle),指纹变了或 launchd 报启动失败就先注销、等旧记录消失再注册(login_item.rs 的 needs_reregistration / launchd_spawn_failed,有测试)。顺带修正 plist:ProgramArguments 是完整的 argv,第一项是程序名,原来把 --foreground 当成了程序名(无害,前台本来就是默认)。实测:按自动更新的方式换包安装后,launchd 由新包启动 passnod(passnod --foreground),不再报 copy_bundle_path。
  • [x] 配对码过期后 Mac 还显示旧二维码(2026-11-18 G1 实测):配对码 2 分钟有效,过期后 Mac 仍显示“等待 iPhone 扫码…”,手机提示“请求不可用或已过期”。改为还没有手机扫码时,过期前 10 秒自动换新码(utils/pairing.ts,有测试)。
  • [x] pn device ls 和 App 的设备名不一致(2026-11-18 D4 发现):App 里改的设备名只存在本机(设计如此),pn device ls 原来只显示设备自报的名字(如旧 iPhone 的“Restored device”)。本机名称的读写搬到 passno-vault 的 local_device_names,App 和 pn 共用;pn device ls 显示同一个名字,--json 多一个 display_name(device_name 仍是设备自报的)。实测两台设备都显示 App 里改的名字。
  • [x] 1Password 导入的字段名是英文(2026-11-18 D3 实测):导入合成的 .1pux 后,银行卡显示“复制expiry date”“复制verification number”“复制cardholder name”等。1Password 导出里存的是英文默认名,和 pn add 写的 number / cvv 是同一类问题。字段名翻译从 keyFields.ts 拆到单独的 apps/desktop/src/utils/fieldNames.ts(只管显示名),覆盖 1Password 银行卡、身份、Wi-Fi、SSH、API 凭据、服务器、会员卡等的常见默认名;iPhone 的 L10n.fieldLabel 用同一张表。同名不同义的按条目类型区分(银行卡的 expiry date 是“有效期”,证件的是“到期日期”;只有身份条目的 name 是“姓名”)。
  • [x] 右键菜单里有“Reload”(2026-11-18 E2E 发现):签名版 App 里在空白处右键,弹出网页视图自带的菜单,只有一项“Reload”,点了会重新加载整个界面。改为输入框、文本框之外不弹这个菜单(输入框里保留剪切、复制、粘贴),见 apps/desktop/src/utils/contextMenu.ts,测试 context-menu.test.ts。
  • [x] 附件(C10)实测:设置里的 1 分钟空闲锁定在文件选择框开着时到期,选完文件后附件没加上、也没有提示(保险库已锁,属预期);重新添加成功,pn attach export 导出的内容和原文件逐字节相同。
  • [x] 独立安全复查(2026-11-18,子 agent 只读审查当天的改动)发现 6 处,全部修复并加回归测试:① 带 agent 凭据时 pn vault/sync/device/share 在 agent 检查之前执行,仍会弹 owner 确认(一次批准就覆盖整个终端会话)——提前拒绝,且经 daemon 时带 agent 凭据一律不弹 owner 确认;② 在 iCloud 容器里伪造 .trash/<id>@0 再触发清理,可删掉别的库在钥匙串里的恢复条目(含 Secret Key)——只对签名有效、编号相符、存在 iCloud、且不是正在用的库清除,时间改为饱和加法;③ 大写的库编号可绕过“正在用的库不能删”(APFS 不分大小写)——先规范化 UUID;④ 允许路径可被 %2F、..;、%2e 绕过——限路径的条目遇到这类写法直接拒绝;⑤ 一条坏的改名记录会让显示忽略所有改名——只跳过坏的那条;⑥ 读不到 daemon 可执行文件时每次连接都重启它——只在文件存在且不同时才算更新。复查确认没问题的:主机绑定与实际请求一致、requires_owner_session 是默认拒绝的白名单、改名签名不能伪造或跨库重放、回收站对符号链接和路径穿越安全。
  • [x] 自动更新只重启 App、不重启 passnod:passnod 启动时记下自己程序文件的身份(路径、inode、大小、修改时间),在 Ping 里报给客户端;客户端发现那个路径上的文件已被替换(或旧 daemon 没报身份且版本号不同),就给它发 SIGTERM(锁定后退出),等它退出再启动新的(passno-ipc 的 connect_or_spawn_daemon,测试 passno-daemon/tests/update_restart_tests.rs)。同版本号的两次构建也能区分。已在本机真实安装上验证(见下一条)。
  • [x] 发布包没有 Contents/Library/LaunchAgents 的 plist:mac-release.sh 现在打进去,直接指向辅助 App 里的 passnod;包里带了它时,App 先停掉并删除旧版留下的 ~/Library/LaunchAgents plist,避免登录时起两个 daemon。2026-11-18 在本机装 E2E 版实测:旧 plist 被删,launchctl print 显示由 SMAppService 登记、程序是辅助 App 里的 passnod。同时实测了更新重启:只退出 App、覆盖安装、再打开,旧 passnod(pid 77045)被换成新的(pid 77300)。
  • [x] iPhone 的 entitlements 没写 icloud-container-environment,开发签名用 CloudKit 开发环境,Mac 用生产环境,推送和中转两边对不上:2026-11-18 改为固定用 Production(开发描述文件允许两种取值),和 Mac 一致。模拟器版本不签名、没有 iCloud,推送(G3)只能在真机上验,生产环境的记录类型仍要部署(最前面的表第 0 项)。
  • [ ] 浏览器插件只认 Google Chrome(passno-nmhost/src/browser_caller.rs),Edge、Brave、Arc 会被拒。按用户 2026-11-16 的决定暂不做(浏览器扩展只做 Chrome);用户重新提起再做。

端到端第二轮:iPhone 编辑与 agent 真实场景(2026-11-18) ​

用户要求“agent 能否完美使用比较关键,用测试网站模拟真实场景”。测试站加了 API、回显、提示词注入页和“攻击者”收件处,用真实的 Claude agent(claude -p,只接 passno 的 MCP)跑任务,见 docs/dev/e2e-release.md AG 组。

  • [x] iPhone 编辑会复制字段:保存时用户名、密码、验证码换成固定 ID 和英文标签,原字段被删掉;Mac 同时改过就合并出两套(E7 复测时一条登录有两个用户名、两个密码)。改为沿用原字段的 ID、标签(PassnoKit/KeyFieldDrafts.swift,有单测)。
  • [x] iPhone 开着时收不到别的设备的修改:只在本机改动、解锁时同步。改为前台每 20 秒同步、回到前台立即同步、列表可下拉刷新;打开的详情页跟着刷新;pn 建的小写字段名也翻译了。
  • [x] pn http 可以把密钥发到任意主机(严重):条目没设允许主机时谁都放行,被注入的 agent 能把 {{pn://…}} 发到攻击者服务器。改为默认只发往条目自己的网站(同一站点含子域名),没有网址又没设允许主机就拒绝;被拒的尝试写进审计。
  • [x] 带服务令牌的 agent 会弹主人确认(严重):pn list / show / add 等照常走主人流程,弹 Touch ID 问“允许 pn ← Python 以你的身份使用”,按一下令牌的范围就形同虚设。改为带 agent 凭据时 list / search 只看凭据自己的范围,其余主人命令直接拒绝(退出码 8),不弹窗。
  • [x] {{pn://…/totp}} 认不出叫 “one-time password” 或“验证码”的字段;agent 指南里写的 pn agent search 不存在。
  • [x] Mac 锁屏时 pn unlock(ssh)失败,还报成“找不到 Secret Key”:钥匙串条目改为“开机首次解锁后可读”,读不到时如实说钥匙串锁着。待你解锁屏幕后验证(最前面的表第 18 项)。
  • [x] check-all.sh 以前不跑 iOS 单元测试,现在跑。
  • [x] 建了子库(Agent 库)后所有设备同步失败(严重):同步引擎在 vaults/ 下看到两个目录就判为篡改(“multiple vaults found”),iPhone 一直报“同步没完成”,Mac 自己的后续同步也失败。改为用账户密钥包认出主库,其余是子库;认不出才算篡改(passno-sync/tests/subvault_replica.rs)。iPhone 设置页现在按原因说明同步失败:数据没通过校验(已停止,不会自己好)、iCloud 文件暂时读不到(会重试)、保险库已锁定(PassnoKit/SyncErrorText.swift)。
  • [x] iCloud 备份管理(Mac):设置 → 存储 → “iCloud 里的保险库”:哪个正在用、同名的用编号区分、修改和创建时间、大小、新设备恢复要什么;删除进 30 天回收站、可还原;恢复包里数据已不在的条目可清除(design.md“iCloud 里的保险库”)。
  • [x] iPhone 恢复时缺恢复包被说成“主密码不对”:改为分别提示;同名保险库显示编号。
  • [x] iCloud 备份管理的 iPhone 设置页(设置 → 同步 → iCloud 里的保险库,真机看过)。
  • [x] 恢复列表不再列出 iCloud 里已没有数据的库(Mac 和 iPhone);放在 WebDAV、S3、Git 的库不会被当成“iCloud 里没了”;iCloud 云盘没开时不过滤、也不显示管理列表。
  • [x] iPhone 用应急套件里的 Secret Key 恢复:没有恢复包的库、或恢复时提示缺 Secret Key,恢复页多一个 Secret Key 输入框;密码验证通过后这个库加进本机恢复包。Mac 和 iPhone 共用 passno-sync 的 recovery_from_location / restore_with_recovery。真机端到端还没跑(手机已有库,模拟器的 iCloud 看不到测试库)。
  • [x] 恢复列表显示修改时间:发现结果带上创建和最后修改时间(文件夹里最新文件的时间);Mac 的“发现保险库”和 iPhone 的恢复选择器里,同名的库显示编号和最后修改时间。
  • [x] 正在使用的保险库改名:Mac 和 iPhone 的“iCloud 里的保险库”里,正在用的那一行有“改名”。实现为签名的改名记录(design.md“iCloud 里的保险库”);伪造的记录同步时被拒。2026-11-18 在真 iPhone 上把测试库改名为“家里的”,记录同步到了 Mac 的 iCloud 文件夹。
  • [ ] 新建时默认名都叫“个人”:有了改名和编号可以区分,暂不改。
  • [x] 按路径限制 pn http:pn add/edit --allow-path /api/(可多次)、--clear-allow-paths;设了路径的条目只给这些路径下的请求注入密钥,按路径段匹配、忽略查询参数,被拒写进审计(path_not_allowed)。目前只在命令行设置,和“允许的主机”一样。2026-11-18 在独立临时库上实测:带 --allow-path /api/ 的 Agent 条目,往同站 /collect 发令牌退出码 8、测试站没收到;/api/v1/me 正常。
  • [x] 主人改不了 Agent 子库里的条目:pn edit pn://Agent/<条目> 现在能直接改它的 agent 设置(是否允许、允许的主机和路径、每次确认及限额);改内容(比如轮换令牌)时报退出码 2,并写明三步:pn move … --to-vault default、pn edit、pn move … --to-vault Agent。agent 的条目列表也带出允许的路径。
  • [x] 代发 HTTP 的响应只遮隐藏字段(密码、令牌、验证码),用户名等明文字段不再遮,agent 能看到自己登录的是哪个账号。
  • [x] 钥匙串锁着的提示前面重复了两次 “I/O error:”:经 IPC 重建错误时去掉重复的前缀。

条目页:窄列表 + 宽详情(2026-11-17,用户看了 Mac 截图后提出) ​

用户反馈:列表占了大半宽度,右边详情太窄,主要信息挤在一起还要滚动;银行卡最要紧的发卡行、卡组织、类型、尾号看不到,附件和 agent 开关却占满面板。用户选定保留“左列表、右详情”(同 1Password、Apple 密码),只调比例。

  • [x] 比例:选中条目后列表宽 clamp(300px, 34%, 400px),其余都给详情(默认窗口 1180 时约 360 / 730,最小窗口 920 时 300 / 540,宽屏封顶 400 / 880);列表和详情一起撑满窗口高度,整页不再滚动,两边各自滚。列表行在有详情时只留标题和副标题,保险库和更新时间看详情。窄于 768 时只显示详情(关掉回到列表)。换条目时详情回到顶部。
  • [x] 银行卡概要(2026-11-17 被“每种类型先显示关键信息”取代,见 docs/ui/style.md 5.1):详情最上方一块与验证码同样式的浅底卡片:发卡行、•••• 尾号、卡组织和卡类型两个小胶囊。来源:导入时留下的文本字段(发卡行 / 卡类型 / 卡组织 / 尾号,以及 1Password 的 type 字段)、明文卡号、或保险库给列表算好的 •••• 1234;隐藏的卡号永远不在前端解密。标题里写了 Visa、银联等也会认出卡组织。已在概要里出现的文本字段不在下面重复;卡号、有效期、安全码、持卡人排在前面,照常显示 / 复制。后端列表副标题现在也认“卡号”“尾号”标签(以前只认英文 number,中文界面新建的卡没有尾号)。
  • [x] agent 开关折叠:“允许 agent 使用”“每次使用都要我确认”移到详情底部(标签、备注、附件之后,时间之前),默认收成一行“agent 使用 · 已允许 · 每次确认”,点开才显示,改动后摘要立即跟着变。
  • [x] 附件:没有附件时只剩一行“附件 · 0 添加附件”,去掉重复的“尚无附件”;历史密码的展开箭头和其他折叠项统一。
  • [x] 顺手修的坑:主题色是裸 var(--x),Tailwind 3 不支持给它加透明度,bg-nav-active/80(列表选中行)、ring-brand/40(所有焦点框)、border-border/70(深色模式下列表分隔线变成亮灰)一直没生效。改用 color-mix,加了测试 src/test/tailwind-colors.test.ts;同一层的两个兄弟组件用了相同的 key 导致附件区重复渲染三次,测试环境现在遇到 React 重复 key 警告直接失败(src/test/setup.ts)。
  • 验证:npm run lint、npm test(新增 item-detail-layout.test.tsx)、cargo test -p passno-service;浏览器模拟数据在 700 / 920 / 1180 / 1440 / 1700 宽、浅色和深色下逐个看过。还差你在原生窗口里看一眼(上表第 15 项)。

修改主密码与忘记主密码(2026-11-16,用户忘了主密码后提出) ​

  • [x] 修改主密码:账户密钥不变,只换包裹(参考 1Password 白皮书和 Bitwarden 的默认做法,比较了 KeePassXC,见 design.md 4.1);因为同步文件只写一次,新增签名的 account/<成员>.rewrap/<设备>/<序号> 记录,带上一代 AUK,其他设备只用新密码就能迁移,旧密码和旧 Touch ID / Face ID 包裹被拒。先写记录再换本机文件头,任何时刻都有一个密码能用。pn passwd、passnod change_master_password、Mac 设置 → 安全与解锁 → 修改主密码、iPhone 设置 → 修改主密码。忘了当前密码时可以用这一次的 Touch ID / Face ID 代替(只限 App)。Touch ID / Face ID 自动重新包裹;配对 iPhone 提示重新配对。实现和测试见 docs/dev/password-change.md。
  • [x] 忘记主密码:Mac 和 iPhone 解锁页的“忘记主密码?”照实说明能做和不能做的事;“重新开始”经确认后把本机保险库移到 moved-aside/(不删除),pn reset --move-aside 只能在终端里由人确认,agent 一律拒绝。
  • [ ] 配对 iPhone 的解锁能力在改密码后自动更新(现在要重新配对);用 iPhone 的一次批准代替当前主密码。要改手机协议,以后再做。
  • [ ] 首次设置页(另一条工作线在改 FirstRunScreen.tsx):重新开始后若在 iCloud 发现了旧库,是否加“忘记主密码?”链接,由那边决定。

命令行改进(2026-11-16 调研 1Password CLI 后,按 passno 的模型取舍,不照抄) ​

用户要求:参考 op 各命令服务的真实场景,想清楚合理性再做。已做:密钥参数写 - 安全输入、主人授权按终端会话。待做(按优先级):

  • [x] P0 pn edit 补齐:--secret-field 名称=-、--field、--totp -、--remove-field、--agent-enabled / --allow-host / --clear-allow-hosts / --confirm-each-use(场景:token 泄露后轮换、事后调整 agent 权限)。字段按名称(不分大小写)匹配,有就改、没有就加;密钥写到普通字段上会变成隐藏字段,隐藏字段不会被改成明文。换下来的密码照旧进密码历史,其他字段直接覆盖(和原来一样,历史只记密码)。只改 agent 权限时不重写条目内容;关掉 agent 访问、改成每次确认或收窄允许的主机,会立刻结束 agent 在这个条目上的授权(后台进程里还会丢掉锁定时用的副本)。新的主人操作 item-policy-patch 只改给出的几项。
  • [x] P0 结构化和多行输入:pn add/edit --from-json -|文件、pn add --print-template <种类>(空白 JSON 模板,不含密钥,不用解锁)、--secret-field-file 名称=路径(原样保存多行内容,如 SSH 私钥、证书;限 1 MiB、UTF-8,二进制请用附件)。--from-json - 读主密码那一行之后的全部标准输入,所以不能再和写成 - 的密钥参数一起用。命令行参数覆盖 JSON 里的同名项;JSON 里写错的键直接报错,报错不回显值。文件里是明文密钥,用完要删。
  • [x] P1 pn run --env-file(一组环境变量,引用可带 $APP_ENV);pn run --stdin pn://…(把密钥只交给子进程的标准输入,如 docker login --password-stdin);pn run --file 名称=pn://…(0600 临时文件,子进程退出即删,代替会留明文文件的 op inject)。实现见 docs/dev/agent.md 第 5 条:三种方式同一档位、每个引用都按精确命令审批;--file 也能取主保险库条目的附件;临时文件放 $PASSNO_HOME/agent/run-files/,被强杀的遗留由下次运行清理。MCP run 工具加了 stdin_ref、file_refs(env_refs 改为可省略)。
  • [x] P1 pn move <条目> --to-vault Agent(把已有条目交给 agent 专用库,也能从子保险库移回 default)。保险库格式里没有“移动”操作,各库密钥也不同,所以是“先复制再删除”,只用已有操作:目标库 CreateItem 完整条目(同一个 id、字段、密码历史、时间戳、agent 设置都保留),源库放进回收站再 PurgeItem(子保险库新增了 SubVault::purge_item,用的是同一个已有操作,格式不变)。带附件的条目暂不支持(附件的加密数据在源库的 blob 里,要重新加密),共享库条目用 pn share copy。移动后 agent 原有的授权全部结束。
  • [x] P1 主人命令(show、edit、rm、totp、history、attach …、move)接受条目 UUID、标题或 pn://库/条目 引用:UUID 原样使用(回收站里的条目照常能操作);否则先比 id、再比标题(不分大小写),在 pn list 能看到的条目(含归档、共享库)里找;多个同名退出码 2,列出每个候选的 id、标题、所在库,不含任何字段值;找不到退出码 5。匹配规则在 passno_service::item_lookup,pn move 在服务端用同一套。
  • [x] P1 pn add --kind ssh-key --generate-ssh ed25519:在保险库里生成 Ed25519 密钥(passno_crypto::random_bytes 取 32 字节种子,ssh-key crate 编码,都是已有依赖,没有自己写密码学),条目里存 private_key(SSH 密钥字段类型,pn ssh-agent 直接能用)、public_key、fingerprint;标准输出只有 OpenSSH 格式公钥(可以直接 > deploy.pub),条目 id 写到标准错误,--json 时返回 id、公钥和指纹。私钥不出保险库。只支持 Ed25519,因为 passno 的 SSH 代签只用 Ed25519。
  • [x] P1 pn whoami [--json]:没有 PASSNO_SERVICE_TOKEN / PASSNO_AGENT_KEY 时报告主人这边(是否初始化、是否锁定、这个终端会话能不能执行主人命令;查一次算用一次,会刷新 10 分钟空闲计时;不弹密码也不弹 Touch ID);有的话由 passnod 验证身份后报告 agent 身份、能用的库,服务令牌还给出所属库、是否只读、到期时间(复用 MCP whoami,MCP 的输出也加了 service_token),这次查询记进 agent 审计日志。从不输出令牌或任何密钥。
  • [x] P1 PASSNO_MASTER_PASSWORD 只在 --no-daemon 和调试/测试版里接受;正式版经 passnod 时忽略它,并在标准错误打一行提示改用 --password-stdin(环境变量会传给所有子进程)。passno-agent 的 VaultAccess::open_from_env 在正式版里也不再读这个变量。规则在 crates/passno-cli/src/env_password.rs,有单元测试。
  • [x] 顺手修的问题(做 whoami 时发现): 2026-11-16 主人授权改成按终端会话之后,agent 用自己的 PASSNO_AGENT_KEY 在自己的 shell 里跑 pn run / pn http / pn mcp / pn ssh-agent 都会被拒(CliSessionRequired):CLI 前端先替它做了一次主人解锁检查。passnod 本来就不要求 agent 代理请求有主人会话(自带凭据、走审批),所以现在有服务令牌或 agent 密钥时前端不再做主人检查(--password-stdin 除外);保险库锁着时由 passnod 回答“已锁定”,或用锁定时仍有效的长授权。回归测试:crates/passno-daemon/tests/cli_items_tests.rs。
  • P2 生成密码按网站规则;pn agent token create --out-file;pn archive、pn completion、PASSNO_JSON=1、pn vault rename/rm;终端里遇到锁定直接弹 Touch ID。
  • 不采用: op read 直接打印明文、--no-masking、会话令牌放环境变量、分享链接(要服务器)、企业用户和组管理。

商用版本 v1.0 的标准(用户 2026-11-16:“完成所有的功能,给我一个商用的版本”) ​

功能做完还不够,下面每一条都满足才叫商用版本:

方面标准负责
功能里程碑 v0.2 和第 3 波全部合并:后台进程、Touch ID、插件(和 Chrome 自带一样的自动弹出)、agent 授权和 MCP、服务令牌、同步和存放位置、从 iCloud 恢复、家庭共享、iOS 和系统自动填充、通行密钥、手机批准解锁各工作线
分发Developer ID 签名 + 公证 + staple;DMG 安装包;版本号和更新日志;自动更新(签名的更新清单,放在 Cloudflare);下载页release
安全威胁模型文档;cargo-deny / cargo audit 进 CI;导入器、IPC、同步解析器做模糊测试;内存清零和防调试核查;第三方安全审计(要人联系)release
质量CI 全绿(macOS、Linux,之后 Windows);端到端测试覆盖首次使用、导入、填充、同步、恢复、agent;崩溃和错误报告(默认关闭、用户同意才上传、不含任何保险库内容)release + 各线
体验中英文界面;首次使用引导;帮助文档;空状态、错误提示都用平实中文和英文第 2 波整合
合规第三方许可证清单(cargo-about + npm);隐私说明(数据只在本机和你选的存放位置);EFF 词表署名release

阶段 ​

阶段 0:仓库骨架 ​

  • Cargo workspace,所有 crate 先建空壳。
  • CI:fmt / clippy / test,macOS 和 Linux 都跑。
  • 加 LICENSE-APACHE、LICENSE-MIT、README、docs/threat-model.md。

阶段 1:核心库 + CLI(单用户、本地目录) ​

  • passno-model、passno-crypto(Argon2id、HKDF、XChaCha20-Poly1305、Ed25519、X25519/HPKE)。
  • passno-vault:
    • 操作日志、快照、HLC 合并。
    • 纪元和成员日志的格式现在就定好,先只有一个成员。
  • passno-gen、passno-totp、passno-match。PMR 数据收进仓库,用脚本更新。
  • passno-import:OnePux、OnePasswordCsv、AppleCsv,并给出迁移报告。用 tests/fixtures/import/ 里的样本,按 manifest.json 断言。
  • pn CLI:init / unlock / add / edit / list / search / gen / totp / import / doctor。
    • 从第一天起就按 design.md 第 12.2 节做:三层帮助(--help、子命令帮助、help --json)、pn agent-help、全部支持 --json、固定退出码、三段式错误信息、不是终端时不交互。
    • 测试:在非 TTY 环境下把每条命令都跑一遍,确认没有一条会卡住等输入;用快照测试固定 help --json 的输出。
  • 测试:加解密往返、篡改检测、合并、各导入器的映射;用 proptest 测解析器。
  • 核心 crate 不依赖任何平台 API,以后 iOS 经 UniFFI 直接调用。

阶段 2:后台进程 passnod(macOS) ​

  • IPC:Unix socket(0700 目录),PeerVerifier 的 macOS 实现(audit token + 代码签名校验,Team QKPMA8N9LJ)。
  • Unlocker:
    • Password 实现。
    • macOS 安全飞地实现:Touch ID 或 Apple Watch。
    • 按 design.md 第 4 节的规则,在规定情况下强制输主密码。
  • SecretKeyStore 的 macOS / iOS 实现:iCloud 钥匙串(可同步)。另有应急套件的导出和导入。
  • 自动锁定:空闲、睡眠或锁屏、最长会话时长。内存方面:zeroize、锁内存、防调试、关 core dump。
  • CLI 改成连后台进程。
  • trait 和协议照跨平台来设计;Windows 和 Linux 的实现留到阶段 8、9。

阶段 3:macOS 管理 App(Tauri v2) ​

  • 界面严格按 docs/ui/style.md 来做:条目管理、生成器、导入向导、安全检查、设置。
  • 审批弹窗:给阶段 5 用。
  • 菜单栏图标:锁定、一键撤销全部授权。
  • 签名和公证:用 Developer ID。
  • App 自带 CLI: 安装包里带 pn、passnod、passno-nmhost;第一次启动时安装 /usr/local/bin/pn 软链,用户拒绝就退回 ~/.local/bin;passnod 用 SMAppService 注册成登录项。详见 design.md 第 12.1 节。
    • 验收:从全新安装开始,新开一个终端直接运行 pn doctor,结果全部正常;App 升级后 pn --version 跟着变。
  • pn agent install-skill:给 Claude Code 和 Codex 安装使用说明。
  • 完成后要做主观验收(需要人做的第 7 项)。

阶段 4:浏览器扩展(macOS 上的 Chrome,然后是 Safari) ​

  • passno-nmhost,加上 macOS 上各浏览器的宿主清单安装程序。
  • 扩展和后台进程的配对协议。
  • 扩展(MV3 / TypeScript):
    • 表单识别。
    • 页面内菜单(防点击劫持)。
    • 填充用户名、密码和 TOTP。
    • 提交后提示保存或更新。
    • 注册和改密码表单旁给生成的密码。
    • HTTP Basic 认证。
  • Safari 扩展:放在 macOS App 里打包,消息经 App 扩展转给后台进程。2026-11-16 用户决定暂缓:“暂时不需要搞定 safari,先搞定 chrome 就行了”。 已做的部分留在分支 feat/safari(复用 Chrome 插件界面、经 App 扩展接到后台进程、打包进 passno.app),不合并;以后要做时从这个分支接着做。
  • 测试:本地靶场页面,覆盖各种表单、iframe、点击劫持场景;用 Playwright 自带的 Chromium 跑,Safari 部分手动加 agent-desktop 跑。

阶段 5:agent 访问(macOS) ​

feat/agent 合并进度(2026-11-16,新加坡时间): 已在该 worktree 合入 main 的 data/daemon/extension/release/sync 及随后新增的 browser/desktop 整合(b894355),agent 使用与管理命令复用 CliBackend/passnod,保留 --no-daemon。审批仍为 SIMULATED;真实 Codex 的 daemon 路径验收通过(HTTP、部署、用户名、无明文、审计链),Claude 按用户要求因限流跳过。详细契约和验证见 docs/dev/agent.md;未推送、未修改 main。

  • pn agent enroll、授权引擎(绑定精确命令或接口)、哈希链审计日志。
  • pn run、本地 HTTP 注入代理、ssh-agent、经扩展代填网页。
  • pn mcp:只返回授权编号和执行结果。
  • 请求必带 --reason;授权按绝对时长到期(design.md 第 7 节)。
  • 无人值守的服务令牌:agent 专用保险库,令牌只包裹这个库的密钥,限权限和有效期,可撤销(用户 2026-11-16 同意)。
  • 用 Claude Code 和 Codex 在本机实际跑一遍。

阶段 6:iOS App + 系统自动填充 + iCloud 同步 ​

  • 2026-11-16 08:51(新加坡时间)合并验收: feat/ios 已合入 main b894355 的 data / daemon / sync / extension / release / integrate1;保留 main 的全部 vault 内部实现及 AUK API,叠加 SwiftUI、UniFFI、密码/TOTP/通行密钥 AutoFill 与 Secure Enclave AUK 导出。依赖合并、锁文件重建、API 文档两侧内容合并完成。cargo fmt --all、workspace clippy(-D warnings)、workspace tests、scripts/build-ios.sh --test 均通过;iPhone 17 Pro 模拟器四项 Swift 测试通过,独立合成库建库→锁定→模拟 Face ID 解锁→重新锁定读屏通过。未使用真机、未推送、未修改 main。
  • 附件跨纪元修复已完成(2026-11-16,fix/blob-epoch): 签名附件引用记录实际加密 epoch,按既有签名密钥包裹记录读取旧密钥;旧库缺省字段使用已知密钥认证回退。回归覆盖轮换、本地重开、三设备同步、旧格式、新附件旧密钥隔离、撤销和篡改,见 docs/dev/core.md。(iOS 同步和恢复界面已于 2026-11-16 接入。)
  • 轮换快照同步路径冲突已修复(2026-11-16,fix/rotation-snapshot): 移除设备时追加签名轮换标记操作,推进序号后再写新纪元快照;已有快照保持字节不变。回归覆盖已上传快照、连续轮换、空库、旧附件、撤销拒绝、真实分叉及轮换标记回滚检测,见 docs/dev/core.md。
  • 手机批准、电脑临时解锁(用户 2026-11-16 同意,从阶段 9 提前):长期解锁能力放在 iPhone 安全存储里,电脑请求后手机用 Face ID 批准,加密交付本次解锁材料(绑定挑战、电脑临时公钥、目标保险库、绝对期限),锁屏、休眠、重启即失效。同一局域网用 Bonjour 直连,不在一处时用 CloudKit 私有数据库推送,不自建服务器。
  • 先做技术验证(spike): 用 Tauri v2 的 iOS 支持复用桌面端的 React 界面,同时把 Swift 写的 AutoFill 扩展(.appex)嵌进 Tauri 生成的 Xcode 工程,还要验证签名能过。验证不通过,就把 iOS 主 App 改用 SwiftUI。两种方案的界面都按 docs/ui/style.md 做。macOS 上把 AutoFill 扩展嵌进 Tauri App 用的是同一套办法,一起验证。
  • iOS 上没有后台进程,核心库经 UniFFI 在进程内运行。主 App 和 AutoFill 扩展通过 App Group 共用保险库目录和缓存。
  • AutoFill provider(iOS 和 macOS 都要):
    • 填密码和 TOTP。
    • 通行密钥的创建和使用。
    • 保存时调用生成器。
  • CXF 导入: 用 ASCredentialImportManager 从 Apple 密码导入,包括通行密钥。映射逻辑在 Rust 核心里。
  • 同步: 实现 SyncTransport 的 Folder 版本,iCloud Drive 是首选。Mac 和 iPhone 之间用 iCloud 钥匙串同步 Secret Key,用 iCloud Drive 同步保险库。
  • 测试: 全部在 sim:iPhone 17 Pro 上做,用 phone;真机只在必要时用(需要人做的第 8 项)。

阶段 7:家庭共享 + 更多同步方式(仍属于 v1) ​

  • 共享:
    • 邀请、核对指纹或扫二维码、角色。
    • 移除成员时换纪元,并提示轮换密码。
    • 防回滚告警。
  • SyncTransport 再加 Git、Syncthing、Dropbox 的目录实现。
  • 加设备:扫二维码或输入 Secret Key。
  • 测试:模拟多设备并发写、回滚、伪造签名、移除成员。还要用两个模拟器加本机 Mac 实际跑一遍。

阶段 8:Windows(Win11 虚拟机) ​

2026-11-16 用户定:回归测试暂时只管 macOS 和 iOS,不考虑 Windows 和 Linux。Windows 版冻结在当前状态(提交 0670a5f),以后的更新暂不考虑 Windows,重点是 iOS 和 Mac。 下面是冻结时的进度;重启时从 docs/dev/windows.md 末尾的“冻结时的状态”接着做。

  • 命名管道 IPC,PeerVerifier 的 Windows 实现(客户端 PID + Authenticode)。
    • 2026-11-16 开工(分支 feat/windows),调研后的做法: 管道名 \\.\pipe\passno-<home 哈希>;只允许当前用户 SID 的 DACL、FILE_FLAG_FIRST_PIPE_INSTANCE(防抢注)、PIPE_REJECT_REMOTE_CLIENTS;客户端以 SECURITY_IDENTIFICATION 打开(防假服务端冒充)。PID → 映像路径 → WinVerifyTrust 只作补充层(PID 可伪造、签名不证明进程未被注入),主要靠同用户 DACL 和每条命令自己的权限检查。daemon 用 tokio::net::windows::named_pipe;同步客户端内部用小的 tokio 运行时实现超时。参考:chromium-bridge PR #151、Project Zero 2019 的 PID 伪造、Zero Science Lab 的签名门分析、interprocess / parity-tokio-ipc。
    • 进度: ① 已完成(2026-11-16):传输层(transport.rs)、daemon 监听(listener.rs)、WindowsPeerVerifier;cargo xwin clippy 全工作区(不含 iOS FFI)通过,并已加入 scripts/check-all.sh。ssh-agent 在 Windows 上暂时明确报“不支持”(第 ③ 步做)。只测 Unix 行为的测试文件标了 #![cfg(unix)],Windows 的测试在虚拟机那一步补。
    • ④ 已写完并通过交叉编译(2026-11-16):Windows Hello 快捷解锁、本人确认、凭据管理器存 Secret Key,见 design.md 第 4 节。⑤ 已写完:nmhost 装 manifest 时写 HKCU\Software\Google\Chrome\NativeMessagingHosts\com.virtever.passno(只登记 Chrome)。两步都还没在虚拟机上跑过。
    • ⑥⑦ 部分完成(2026-11-16):tools/windows-e2e/vm-run.sh(和 glass 共用虚拟机锁)和冒烟测试在真实 Win11 上 12 项全部通过;测出并修好两处 Windows 问题(daemon 继承句柄、锁页内存共用一页)。详见 docs/dev/windows.md。桌面 App 的 NSIS 安装包和开机启动已完成,安装、卸载已在虚拟机上实测通过。pn 加进 PATH 已完成;ssh-agent 已改用加固管道,OpenSSH 能连上,但 Windows 上还列不出密钥(在查,见 docs/dev/windows.md)。还剩:桌面会话里测界面、Credential Manager 和 Windows Hello(Hello 要人在场);Chrome 端到端;原生 ARM64 构建。
    • 步骤: ① passno-ipc 抽出 LocalTransport(Unix socket / 命名管道),cargo xwin check 全工作区通过;② Windows PeerVerifier;③ ssh-agent 走命名管道(OpenSSH for Windows 的 \\.\pipe\openssh-ssh-agent 约定);④ Windows Hello UserVerifier / BiometricProvider、Credential Manager SecretKeyStore;⑤ nmhost 注册表;⑥ Tauri Windows 构建和 tools/windows-e2e/;⑦ 虚拟机实测。main 上的 v1.0(macOS + iOS + Chrome)不受影响。
  • Unlocker 的 Windows Hello 实现,SecretKeyStore 的 Windows 实现。
  • 写 passno 自己的 tools/windows-e2e/(照 glass 的 vm-run.sh 做,共用虚拟机锁)。
  • Tauri 的 Windows 构建、MSIX、代码签名(需要人做的第 6 项)。
  • 浏览器扩展:native messaging 宿主写注册表(只登记 Chrome;用户 2026-11-16 定:其他浏览器暂不考虑)。
  • 通行密钥插件(Windows 11 插件 API)。
  • CI 加上 Windows。

阶段 9:以后 ​

  • Linux(Polkit 解锁、SO_PEERCRED、Secret Service)。
  • Android。
  • 手机推送审批(Android;iPhone 的已提前到阶段 6)。
  • Firefox 和 Edge 的商店上架。

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