Skip to content

集成工作线交付说明(integrate) ​

本文档汇总 v0.1 feat/integrate 集成阶段将各核心 crate、桌面端(Tauri + React)与 pn 命令行工具统一打包为可安装 macOS 应用包的关键设计。

1. 服务层接入真实密码学与生成能力 ​

在 crates/passno-service 中移除了临时实现(原 gen_temp.rs 与 totp_temp.rs),保留 Generator、TotpProvider、TotpSupportChecker 与 ImporterBridge 依赖倒置接口,并通过 crates/passno-service/src/adapters.rs 接入真实 crate:

  • PassnoGenAdapter → passno-gen(EFF diceware 词表、CSPRNG 生成与 Apple PMR 站点密码规则、主密码强度评估)。
  • PassnoTotpAdapter → passno-totp(RFC 6238 SHA-1 / SHA-256 / SHA-512、otpauth:// URI 与裸 Base32 解析)。
  • PassnoMatchTotpChecker → passno-match(基于 PSL 与 Apple PMR shared-credentials.json 域名等价匹配计算 missing_totp_where_supported 与 security_audit)。
  • DefaultImporterBridge → passno-import(随分支合并自动生效)。

2. 桌面端与 CLI 共用保险库及并发安全 ​

GUI 与 pn CLI 默认共用同一个数据目录(~/Library/Application Support/passno,支持 PASSNO_HOME 覆盖):

  1. 排他文件锁(VaultFileLock):crates/passno-vault/src/store.rs 通过 $PASSNO_HOME/local/vault.lock 使用系统级建议锁串行化 Vault::init、Vault::open、create_item、update_fields、write_snapshot 与 reload_if_changed。
  2. 变更检测与重放:Vault 记录已验证的 rollback.json 摘要;在写入新操作前以及读取前都会自动检查磁盘摘要变化,若有外部写入(如终端 pn add),立即重新校验日志并递增本地序列号,避免双写覆盖链头。
  3. GUI 实时刷新:桌面端后台每 1.5 秒调用一次 service.reload_if_changed(),检测到外部变更即触发 Tauri 事件 vault-changed,前端实时刷新列表、统计与当前选中条目。

3. Tauri 后端与前端集成 ​

  • apps/desktop/src-tauri 移除独立 [workspace] 与锁文件,并入根 Cargo workspace。
  • apps/desktop/src-tauri/src/ 拆分为 dto.rs(camelCase DTO 与 { code, message } 错误结构)、clipboard.rs(macOS pbcopy + 代次防竞态自动清空)、cli_installer.rs、commands.rs 与 lib.rs。
  • 新增接口:set_item_archived、set_item_favorite、security_audit、copy_secret、clear_clipboard、stage_import_file、cli_install_status、install_cli、uninstall_cli。
  • 前端通过 apps/desktop/.env.production 与 getApiMode() 让桌面发布版默认走 TauriPassnoApi,而浏览器 npm run dev 与 Vitest 单元测试继续保留 MockPassnoApi。

4. pn CLI 随应用打包与诊断增强 ​

  • 通过 apps/desktop/src-tauri/tauri.bundle.conf.json 的 bundle.externalBin: ["binaries/pn"] 将 pn 打入 passno.app/Contents/MacOS/pn。
  • 首次创建保险库后的引导页与"设置"弹窗提供一键 安装命令行工具(默认无需管理员权限软链到 ~/.local/bin/pn,同时可选通过 macOS 管理员授权链接到 /usr/local/bin/pn)。
  • 修复 pn 在非交互式终端下未解锁且未传 --password-stdin 时返回退出码 3(Locked)。
  • pn doctor 检查 PATH 上的 pn 是否通过软链指向 .app/Contents/MacOS/ 应用包内,帮助发现系统上残留的旧开发构建。

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