Appearance
集成工作线交付说明(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 PMRshared-credentials.json域名等价匹配计算missing_totp_where_supported与security_audit)。DefaultImporterBridge→passno-import(随分支合并自动生效)。
2. 桌面端与 CLI 共用保险库及并发安全
GUI 与 pn CLI 默认共用同一个数据目录(~/Library/Application Support/passno,支持 PASSNO_HOME 覆盖):
- 排他文件锁(
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。 - 变更检测与重放:
Vault记录已验证的rollback.json摘要;在写入新操作前以及读取前都会自动检查磁盘摘要变化,若有外部写入(如终端pn add),立即重新校验日志并递增本地序列号,避免双写覆盖链头。 - 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(macOSpbcopy+ 代次防竞态自动清空)、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/应用包内,帮助发现系统上残留的旧开发构建。