Appearance
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与 Taurisync_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 分钟)
- 协调者合并并打包后,用签名 App 允许一次真实 iCloud 钥匙串访问。
- 选实际存放位置,核对成功时间;新 Mac 用同 Apple ID 发现保险库并仅输主密码恢复。
- 如需启用生物识别,由本人在设置中启用,再验证 Touch ID 解锁一次。
- 看一眼恢复页、存放位置和设备列表的留白、文案与操作层级。
自动防回归
新增断言:更换主位置后不能沿用旧位置的成功时间;锁定状态下的唤醒同步必须绕过 正常轮询间隔并在解锁后可见;备份成功状态不能改动主位置回滚哈希。
显式传入隔离 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 引用。