Skip to content

integrate2:后台同步、恢复与存放位置 ​

设计与执行顺序(2026-11-16,新加坡时间) ​

沿用 passno-sync 的验签、staging 恢复和存储 trait,daemon 为唯一运行时入口。 先接后台调度与 IPC,再做首次发现/恢复、设置页,最后补跨 daemon 测试与截图。 不改 agent/iOS 工作线,不改协调者负责的 plan.md,不推送或合并 main。

调度使用现有 SyncScheduler:解锁、写入防抖、定期检查、唤醒;网络与磁盘操作在 blocking worker 执行,不在 Tokio runtime 内创建 blocking HTTP runtime。运行时操作串行,避免恢复与写入竞争。 界面只显示不含秘密的 DTO;凭据输入不读回,错误统一清理,不向普通 IPC 返回恢复包。 首次启动先发现,用户可以选择已有保险库,或明确创建新库。

实现参考 ​

  • rbw(MIT):CLI 与长驻后台的职责分离;仅参考架构,不复制代码。
  • Tokio(MIT):计时器、通知及 blocking worker 分工。
  • Radix Primitives(MIT):沿用项目已有可访问控件与焦点处理。

Contract changes ​

新增同步 IPC、Tauri 与 TypeScript 契约详见下文及 api.md;没有修改密码学或保险库格式。

需要用户本人 ​

最终在签名 App 中验收 iCloud 钥匙串、真实跨设备 iCloud Drive、Touch ID 与界面观感。 开发仅用合成数据、临时 PASSNO_HOME、模拟生物识别与加密文件恢复存储。

Contract changes(已实现) ​

  • RequestBody::Sync / ResponseBody::Sync 与 Tauri sync_command;参数和无秘密 DTO 见 api.md。
  • SyncTrigger::Unlock/Wake、RecoverySyncScheduler:注入恢复存储,保留旧默认 scheduler。
  • SyncState.backups 为兼容旧数据的可选字段;主库与每个备份分别报告成功时间/错误。
  • pn sync now 默认返回 SyncStatusRecord,--no-daemon 仍返回原 SyncReport;status 经 daemon。
  • DaemonConfig 新增可选 scheduler/store 及发现根目录,测试不依赖环境变量共享状态。
  • FileRecoveryBundleStore 测试入口同时接受 macOS 临时目录与 /tmp 子目录,拒绝临时根目录本身。

运行与验收 ​

所有命令从此 worktree 根目录执行,绝不运行安装脚本:

sh
npm ci --prefix apps/desktop
npm ci --prefix apps/extension
npm run build --prefix apps/desktop
cargo build -p passno-cli --bin pn -p passno-daemon --bin passnod -p passno-desktop --example ipc_bridge
# 必要时安装 Playwright 自带浏览器(不使用共享 Chrome):
(cd apps/extension && npx playwright install chromium)
PASSNO_SHOTS_DIR=/Volumes/Code/github/passno-wt/shots/integrate2 \
  node apps/desktop/scripts/sync-e2e.mjs

脚本自行创建 /tmp/passno-integrate2-e2e-*:两个 daemon 共用一个加密文件恢复存储, 模拟 iCloud 目录与生物识别;启动 127.0.0.1:5298 的真实 IPC 桥,恢复 B、写入 A、 等待 B 界面自动出现条目,然后添加/同步/移除备份。结束时关闭自己的 Chromium、后台 进程并删除临时数据。端口可用 PASSNO_E2E_PORT 改写。截图不含密码或 Secret Key。

本轮截图:

  • /Volumes/Code/github/passno-wt/shots/integrate2/first-run-restore.png
  • /Volumes/Code/github/passno-wt/shots/integrate2/storage-settings.png

快速浏览模拟界面:npm run dev --prefix apps/desktop,演示密码 passno123。 此方式不调用真实钥匙串或保险库。?firstRun=1 可体验创建与恢复入口。

回归检查 ​

sh
cargo fmt --all
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace
npm run lint --prefix apps/desktop
npm test --prefix apps/desktop
npm run build --prefix apps/desktop

新增测试覆盖:两个 daemon 自动交换写入/恢复/订阅事件、错误密码不安装目标、恢复存储 失败不安装目标、每备份独立状态、移除备份保留远端、撤销设备、IPC 往返与 Debug 遮蔽、 首次发现/仅密码恢复/Secret Key 恢复/来源故障、设置页交互。 恢复包写入安排在密码验证之后、正式安装之前,避免权限故障留下半安装保险库。 同步 IPC 的写操作不会在连接超时后自动重放,避免重复添加位置或重复撤销设备。

已知边界 ​

  • 真实 iCloud 同步/钥匙串 entitlement、Git 托管账号、R2/S3、WebDAV 服务端行为,仍需实际 账号验收;四种传输的核心协议测试均为临时目录/本地 Git/loopback 合成服务。
  • 发现页没有可信的远端最后更新时间,显示恢复材料状态;不把 immutable header 创建时间 当作更新时间。设置页显示本设备实际成功同步的时间。
  • 同步暂与请求串行,慢远端可能增加界面等待;传输超时不等同于事务回滚。
  • 设备移除不是完整账户恢复材料吊销(第 3 波负责)。不提供删除远端数据操作。
  • 没有变动 agent/iOS 工作线、安装目录、真实用户保险库或协调者的 plan.md。

需要用户本人(最终验收,约 5–10 分钟) ​

  1. 协调者合并并打包后,用签名 App 允许一次真实 iCloud 钥匙串访问。
  2. 选实际存放位置,核对成功时间;新 Mac 用同 Apple ID 发现保险库并仅输主密码恢复。
  3. 如需启用生物识别,由本人在设置中启用,再验证 Touch ID 解锁一次。
  4. 看一眼恢复页、存放位置和设备列表的留白、文案与操作层级。

自动防回归 ​

新增断言:更换主位置后不能沿用旧位置的成功时间;锁定状态下的唤醒同步必须绕过 正常轮询间隔并在解锁后可见;备份成功状态不能改动主位置回滚哈希。

显式传入隔离 home(即使没有设置环境变量)也只扫描该 home 的 discovery/;正式默认 home 自动扫描 iCloud Drive,其他目录须用户选择,避免把 Dropbox 误标成 iCloud。

全量测试偶发暴露既有生成器测试问题:EFF 含 drop-down/felt-tip/t-shirt/yo-yo,不能按 连字符直接计词。已将测试改为词表合法分词校验,并独立检查目标词数对应的熵;加入含四种 连字符词的固定回归。没有修改生成器行为或词表。

最终验证记录(2026-11-16,新加坡时间) ​

  • cargo fmt --all -- --check、workspace clippy(warnings 视为错误)通过。
  • cargo test --workspace:120 项通过;桌面 Vitest:24 项通过。
  • 桌面 lint、TypeScript 检查和生产构建通过;构建仍提示已有的大 chunk 体积警告。
  • 真实双 daemon + IPC 桥 + 独立 Chromium 验收通过:仅密码恢复、错误密码不安装、 A 写入后 B 界面自动更新、备份添加/同步/移除及设备列表;截图见上方路径。
  • 没有调用真实钥匙串、iCloud 或 Touch ID。实际云账号与签名 App 验收仍需用户。

合入 main 的 agent / iOS(2026-11-16,新加坡时间) ​

本次在 feat/integrate2 执行 git merge main,目标为 50a81cb。上文“不改 agent/iOS、 不改 plan.md”是原工作线边界;此次按用户明确要求整合两侧,并同步本地计划记录。 没有修改 main 分支、安装目录或真实保险库。

合并保留 Sync、Agent、AgentAdmin 协议和 Debug 遮蔽、两侧原有测试。broker 在 core 锁外的 blocking worker 中运行自己的 runtime;同步和普通请求继续在 blocking worker 中串行。 补齐 call_raw(Sync) 的禁止重放,并统一每类请求的响应超时,防止 main 的 30 秒默认值 覆盖同步原有的 120 秒。详细行为见 docs/dev/ipc.md。

新增回归:五类同步写操作通过 call_raw 与 sync_command 都不重放;真实 broker 子进程 等待期间,同步与锁库仍能及时完成。Agent 测试使用隔离的加密文件恢复存储。

自动合并的 CLI 参考保留了旧 sync 帮助,文档一致性测试已发现;已从合并后的 clap 定义 重新生成 docs/cli/pn.md,保留 daemon / 本地模式的参数、输出和退出码说明。

双 daemon + IPC 桥验收再次通过:临时 home、模拟生物识别与加密文件恢复存储;仅密码恢复、 错误密码不安装、A 写入后 B 界面自动更新、备份添加/同步/移除与设备显示均通过。 本次截图:/Volumes/Code/github/passno-wt/shots/integrate2-merge/。

最终检查:cargo fmt --all -- --check、cargo clippy --workspace --all-targets -- -D warnings、 cargo test --workspace(168 项通过,0 失败/忽略)、桌面 lint、Vitest(24 项)与生产构建均通过。 首次 workspace 测试发现上述文档漂移,另有两项 CLI 子进程在并发重编译时触发 15 秒超时; 生成文档、结束重编译后完整重跑通过,无需放宽超时或跳过测试。

合并期间其他工作线推进了共享 main,本次 MERGE_HEAD 固定为开始时的 50a81cb; 不追加合入后续 main 提交,不推送、不改 main 引用。

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