Skip to content

iOS 工作线(feat/ios) ​

日期:2026-11-16(新加坡时间)。承接 agy 的 1d6b7d7 与 SwiftUI / AutoFill 实现;本轮在 feat/ios 合入 main 的 data、daemon、sync、extension、release 和 integrate1,计划同步见 docs/plan.md。

实现与边界 ​

  • passno-ffi:UniFFI 包装 passno-service,主密码 + Secret Key / AUK 解锁、脱敏列表与详情、搜索、本人显示与复制、创建/修改、生成器、TOTP、登录匹配、系统 credential identities、通行密钥注册与签名。
  • apps/ios:SwiftUI App、共享 PassnoKit、独立 AutoFill Credential Provider .appex;XcodeGen 声明依赖,App Group group.com.virtever.passno 共享保险库,独立进程各自解锁。主 App 回到前台重载日志。
  • Face ID 通过 VaultUnlocker 注入。真机仅允许 Secure Enclave P-256 ECIES 包裹 AUK,失败不降级;biometryCurrentSet,重启 / 14 天 / 录入变化要求主密码。模拟器仅用于合成数据,编译条件隔离模拟 AUK 存储,仍使用 LocalAuthentication 的真实系统提示与模拟器匹配面容事件。
  • Swift 的共享钥匙串保存 Secret Key,FFI 正式构造器只缓存到内存,不在 App Group 写明文 Secret Key。iCloud 备份在新建保险库时默认打开(有 iCloud 时显示“备份到 iCloud(推荐)”开关,2026-11-16 用户要求像钱包 App 那样随时备份到 iCloud),设置里也能随时打开;模拟器不能证明真实 iCloud 同步成功。模拟器上测试要用 scripts/build-ios.sh 构建(临时签名,带钥匙串权限;不签名时写不进恢复包,开启会失败),并用 SIMCTL_CHILD_PASSNO_ICLOUD_ROOT=<文件夹> xcrun simctl launch booted com.virtever.passno 启动,用一个文件夹代替 iCloud。PassnoApp.entitlements 已带 iCloud 容器权限(容器、App Group 已在开发者账号里建好)。
  • AutoFill 请求每次重新锁定并核验用户,不能因扩展进程被系统复用而沿用前一次授权。支持密码、iOS 18 验证码、通行密钥;iOS 26.2 增加系统生成/保存密码回调,旧系统可在提供方列表内生成并保存。
  • 手机批准由 PhoneApprovalClient / PhoneApproveView 实现配对、Bonjour 发现、加密 TCP 与逐次批准,见 phone-approve。旧 UnlockApprovalService 保留兼容占位,不作为新页面的数据源;CloudKit relay 尚未配置时明确拒绝。

构建 ​

需要 Xcode(当前使用的 SDK 包含 iOS 26.2 密码生成 API)、Rust、XcodeGen、phone。设备构建的 Team 为 QKPMA8N9LJ;本工作线只运行模拟器。

sh
rustup target add aarch64-apple-ios aarch64-apple-ios-sim
scripts/build-ios.sh
# 仅 Swift 改动时
scripts/build-ios.sh --skip-xcframework --test
# 只构建,不启动模拟器
scripts/build-ios.sh --no-launch
python3 apps/ios/tests/check_security.py

XCFramework 包含 arm64 iOS device 与 arm64 iOS Simulator。脚本通过 phone 启动、安装、打开和读屏,默认 sim:iPhone 17 Pro;模拟器使用 ad-hoc 签名保留 App Group 权限,不请求 Apple 私钥。--test 只跑 XCTest 单元测试,没有写死 UI 流程。

sh
export PHONE_SESSION=passno-ios
export PHONE_TARGET='sim:iPhone 17 Pro'
phone settings faceid enroll
phone open com.virtever.passno --relaunch --launch-args --passno-test-home --launch-args /tmp/passno-ios-acceptance
phone snapshot -i
# 出现 Face ID 提示后才执行
phone settings faceid match
phone snapshot -i

--passno-test-home 与快速 KDF 测试环境变量仅 Debug + Simulator 生效且限定 /tmp/passno- 前缀,共享给扩展;不会访问 Mac 的真实保险库。UI 操作每一步读屏、判断、单个操作、读回;结束 phone close。

Contract changes ​

合并后的接口归属:

  • passno-vault:完整沿用 main 的实现,包括 init_returning_auk、open_returning_auk、open_with_auk、read_header_locked、open_with_auk_locked;保留多设备成员验证、纪元轮换、签名公共头和 blob 存储,不保留 iOS 工作线重复实现。
  • passno-service:AUK 初始化/导出/打开、Secret Key store 访问,以及 get_model_item、all_active_model_items、upsert_model_field、create_login_with_passkey,供原生提供方使用。
  • passno-ffi:保留通行密钥和系统 credential identities;补齐 main 新增的 CardNumber、CardType、Gender 字段类型,往返转换不降级。原生服务通过 main 的 set_unlocked_vault 安装会话。
  • passno-crypto::passkey:RustCrypto P-256 / SHA-256 加 CBOR 编码的 WebAuthn ES256 原语。私钥 PKCS#8 放入加密条目的 concealed 字段,详见设计第 13 节。不能暴露到 CLI / MCP / agent IPC。
  • docs/design.md 第 13 节:iOS 选型、通行密钥持久化和原生进程的安全边界;docs/dev/api.md 记录 FFI 为本人界面专用接口。

研究来源与许可 ​

只研究宽松许可或明确允许依赖的项目,没有复制 GPL/AGPL 密码管理器代码。

  • Tauri 的 iOS XcodeGen 模板(MIT / Apache-2.0):核对 mobile entry point、Rust 静态库构建阶段和 XcodeGen 生成方式。
  • XcodeGen ProjectSpec(MIT):研究 app-extension target、embed 依赖、宿主单元测试;用于可复现项目生成。
  • RustCrypto elliptic-curves(MIT / Apache-2.0):依赖 P-256 签名与 PKCS#8,不自行实现曲线算法;UniFFI(MPL-2.0)只作为依赖使用。

需要用户本人 ​

  • 真机 Secure Enclave、iCloud 钥匙串跨设备同步、真实 App Group / AutoFill provisioning 与设备签名验收。本次不连接真机。
  • iOS App 的最终主观观感和可访问性验收。
  • 发布 App Store / TestFlight 不在本工作线,未上传、推送或合并。

验收记录 ​

本次均为 iPhone 17 Pro 模拟器、合成账号;没有连接真机、读取真实保险库、推送或合并。

验收项结果 / 证据
首次建库、主密码/Secret Key、Face ID已逐步操作,Face ID 用 phone settings faceid enroll / match;解锁后读回条目
列表、搜索、详情、复制、创建/编辑、生成器已验证;Safari 生成条目在主 App 搜索可见,编辑后有成功反馈;复制显示 30 秒清除提示
Files 导入 Mac 保险库本工作树的 pn 在 /tmp 创建合成库,仅打包加密 vault/,经 Safari 下载、Files 解压、文件夹选择器导入,输入该库凭据后看到 Imported from Mac
系统 AutoFill / 密码 / TOTPSettings 开启 Passno;Safari 表单经 QuickType 填入用户名、密码、6 位验证码,服务端只回显三项 true
通行密钥Safari 注册、登录均完成;python-fido2 校验 origin、挑战、UV,断言签名通过(authenticate verified / signature: true);本机登录走系统“来自 Passno 的更多内容”后选择通行密钥,未把通行密钥自动建议列为已验证
生成密码保存提供方列表的 Create & Generate Login → Save & Fill,Safari 已填入,主 App 读回保存条目;26.2 系统专用生成/保存回调已编译,HTML 规则有 Rust 回归,未单独观察 Safari 调用该新回调
构建与测试XCFramework device + simulator arm64、App + .appex 均构建;4 个 XCTest 单元测试通过;7 个安全静态检查通过;无签名 iOS Release(generic device)编译通过;工作区 fmt/clippy(warnings denied)与 66 个 Rust 测试通过;桌面 lint、11 个测试、生产构建通过

以下截图为本次续接的实际读回(均在 docs/dev/img/):

agy 留下的 ios-firstrun.png、ios-unlock.png、ios-items-list.png、ios-item-detail.png、ios-generator.png、ios-security.png、ios-settings.png、ios-settings-autofill.png、ios-safari-autofill.png、ios-safari-filled.png、ios-autofill-save-passkey.png、ios-safari-passkey-save.png、ios-safari-passkey-registered.png 保留作早期界面记录,不作为当前服务端验签证据。

安全回归(本次续接) ​

已复现并修复:真机明文 AUK 降级、保存失败仍完成 AutoFill 请求、FFI 默认落地明文 Secret Key、导入覆盖无确认、编辑时丢失未显示字段/多网址/标签。静态安全检查防止重新引入前两类与绕过 phone 的启动脚本;Rust 测试验证正常 FFI 构造器不写 Secret Key、导入拒绝重叠路径和符号链接并保留原库、跨 RP 签名被拒。

目录导入只复制加密 vault,不复制 Mac secret-key 文件;必须在 iOS 输入该库的主密码和 Secret Key。复制先完成暂存,再切换目录;切换失败尝试恢复旧目录。源文件夹应为已暂停写入的备份副本,不把正在同步的目录视为一致快照。

钥匙串账号按 vault_id:member_id 隔离,避免导入库/单元测试覆盖另一个库的 Secret Key。LA domain state 按 App / 扩展分别比较;首次扩展解锁依赖共享 SE 密钥的 biometryCurrentSet ACL,不能拿宿主的 opaque state 与扩展直接比较。LA 状态读取使用 iOS 18 起的 domainState.biometry.stateHash。注册先等待系统凭据索引更新,再调用完成回调,避免扩展被挂起而丢失 QuickType 索引。单元测试通过 CredentialIndexing 注入空实现,不改模拟器正在使用的系统索引。

技术验证与选型 ​

在 agy 已实现的原生垂直切片上补做 Tauri 对照,没有重写原生 App。apps/ios/spike/build.sh 把本工作树的桌面 React 前端复制到隔离目录,用明确的 mock API 构建;Tauri mobile entry point 只承载该 UI。脚本把真实 Swift AutoFill 扩展和 PassnoKit 加进 Tauri 生成的 XcodeGen 工程并嵌入 .appex。它证明壳和扩展可一起打包,不把 mock 前端宣称为真实保险库集成。

当前 Tauri CLI 的 ios build --target aarch64-sim 报 Xcode Simulator SDK 27.2 is not installed,但 xcodebuild -showsdks 可见该 SDK、已有 iPhone 17 Pro 运行时可以构建原生 App。因此脚本显式构建同一 Rust mobile 静态库,再用生成的 Xcode 工程和指定模拟器构建,避免修改系统 SDK。运行需要 CocoaPods、PyYAML 与 XcodeGen;依赖安装和前端构建均在隔离副本中,不修改桌面源码。

sh
apps/ios/spike/build.sh
PHONE_SESSION=passno-ios phone install "$PWD/target/ios-spike-derived/Build/Products/debug-iphonesimulator/PassnoSpike.app"
PHONE_SESSION=passno-ios phone open com.virtever.passno.spike
# 演示界面:填入演示密码 → 解锁

Rust 静态库需带 tauri/custom-protocol,否则 UI 资源不会内嵌、启动只显示加载错误。

指标Tauri v2 + React + Swift 扩展SwiftUI + UniFFI
可复现扩展嵌入已构建,PassnoSpike.app/PlugIns/PassnoAutoFill.appex已构建,Passno.app/PlugIns/PassnoAutoFill.appex
本机 Debug arm64 模拟器包体积(du,含符号,非商店下载大小)94 MB32 MB
冷启动命令墙钟(单次,含 phone 桥接)1.08 秒;首帧读回仍黑屏,随后读回 React 页面1.53 秒;首次截图已显示解锁页
UI复用桌面 UI,实测顶栏和搜索入口在 402pt 宽度挤压,需处理键盘与桌面快捷键假设原生导航/文件选择/Face ID,颜色/圆角/分组行遵循 style.md
工程成本React + Tauri mobile + Swift extension + 两份桥接;当前 CLI 需绕过 SDK 检测一份 Swift 共享模块 + UniFFI;App 与扩展共用数据接口
选择保留验证脚本,不作为产品入口采用

字体暂用 iOS 系统字体及系统等宽字体,优先原生可读性;未把桌面 WOFF 直接塞入 UIKit。此差异需用户视觉验收。冷启动以 /usr/bin/time -p env PHONE_SESSION=passno-ios phone open <bundle-id> --relaunch 观察;不是同等优化等级的产品基准,也不等同于 style.md 的纯 App 800ms 启动指标。该性能目标尚需 Release / Instruments 专项测量。

靶场 ​

sh
python3 -m venv target/ios-harness-venv
target/ios-harness-venv/bin/pip install -r apps/ios/tests/autofill-harness/requirements.txt
target/ios-harness-venv/bin/python apps/ios/tests/autofill-harness/server.py
# 仅监听 127.0.0.1:8766,模拟器 Safari 访问 localhost
PHONE_SESSION=passno-ios phone open http://localhost:8766

靶场只用合成账号;密码/TOTP 表单只显示是否填入,不回显内容。通行密钥使用 Yubico python-fido2(BSD-2-Clause)服务器,挑战一次性消费,校验 localhost origin、RP、UV 与断言签名,服务器不保存私钥。重启靶场会清除注册公钥记录,需要重新注册。

生成器的系统回调使用核心 generate_from_rules 解析 HTML passwordrules,无字段规则才使用 PMR 域名规则。WebAuthn 输出 UP / UV / BE / BS;实测清除 BS 后系统在返回 Safari 前拒绝注册,恢复 BE/BS 才可用。这是 Apple 提供方的兼容性限制(Apple 开发者论坛记录),不代表本分支已完成跨设备备份;RP 看到的 BS 与实际同步状态存在语义差异,正式发布前需协调同步工作线处理。

已知边界与后续接入 ​

  • (2026-11-16 更新)iCloud 同步和“从 iCloud 恢复”已接入(VaultSync、RestoreView,模拟器上实测过两台“手机”之间恢复和双向同步)。手机批准 Mac 解锁和 agent 请求走 Bonjour 加 TCP,已实现并在模拟器上测过(见 phone-approve);不在同一网络时的 CloudKit / APNs 推送还没做。
  • 真机签名、SE 不可导出和录入变化失效、iCloud 钥匙串、其他 App 的 AutoFill 及 Release 启动性能仍需设备/发布阶段验证。
  • 通行密钥 BE/BS 兼容性与同步语义的差异见上文,正式发布前必须协调,不把模拟器成功等同于生产安全审核完成。

最终脚本读回:scripts/build-ios.sh --skip-xcframework 已完整执行 boot → install → open → snapshot;随后在最终安装包用模拟器已录入面容完成 Face ID 解锁,确认条目和 TOTP/通行密钥详情,结束时锁回保险库。测试网页服务仅为本次验收启动,收尾时关闭。

main 合并验收(2026-11-16 08:51,新加坡时间) ​

  • 在 feat/ios 合入 main b894355,passno-vault 与该提交完全一致;不重复实现 AUK 或头文件读取函数。
  • cargo fmt --all、cargo clippy --workspace --all-targets -- -D warnings、cargo test --workspace 全部通过。
  • scripts/build-ios.sh --test 重建 XCFramework / Swift 绑定,模拟器四项 PassnoKitTests 全部通过,App / AutoFill 构建、安装和启动成功;安全检查脚本七项通过。
  • 经 phone 在 iPhone 17 Pro 模拟器独立合成库逐步验证建库、锁定、系统 Face ID 提示、settings faceid match 后解锁、再次锁定,并关闭会话。未操作任何真机。
  • 新增 crates/passno-ffi/tests/sync_compatibility.rs:新设备登记、同步签名验证、通行密钥签名与 identities、AUK 导出/跨纪元打开、错误 AUK 和已撤销设备拒绝;同时验证附件在轮换前可跨设备读取。
  • 附件跨纪元回归已修复(2026-11-16,fix/blob-epoch):核心在签名附件引用中记录加密 epoch,复用历史纪元密钥记录解密;无 epoch 的旧引用使用已知密钥认证回退。sync_compatibility.rs 现断言轮换后重新打开可读旧附件,并继续验证已撤销设备无法用缓存 AUK 解锁;三设备同步、连续轮换、旧格式和篡改回归见 核心文档。

iosstyle:中英文与外观统一(2026-11-16) ​

本工作线只修改 apps/ios/、本页和 docs/ui/style.md;不改协调者的计划表,不推送或合并。

实现与设计决定 ​

  • Resources/Localizable.xcstrings 是 App、AutoFill 和 PassnoKit 的共同文案来源,开发语言及无匹配语言时的回退为 zh-Hans,另提供 en。跟随 iOS 语言偏好;两个宿主声明支持的语言,并分别打包 Face ID 的 InfoPlist.xcstrings。
  • L10n 从 PassnoKit bundle 查找资源,避免扩展误从主 App bundle 取词。格式参数统一 %@,不把动态拼好的文本当翻译键;错误按 FFI 类型翻译,不直接显示可能含路径或输入内容的 Rust 诊断。
  • 保留英文存储字段名和类型标识,只翻译已知默认字段的显示名;用户自己命名的字段、标题、网址不翻译。没有修改保险库格式、加密或 agent 接口。
  • 导航保留「条目 / 生成器 / 设置」,安全检查移到「设置 → 安全与解锁」,移除未接入的手机批准预览卡片。导入独立分节,存储路径折叠。
  • 主题沿用桌面浅色背景、单一品牌深青色(2026-11-17 起不再用嫩绿,头像统一中性灰,提示条用 ink)、圆角卡片及胶囊按钮;外观跟随系统,不强制深色。深色品牌/警告/危险文字提亮,新增 onControl 防止深色模式的白底白字。
  • iOS 字体继续用原生系统字体/等宽字体,通过 ScaledMetric 跟随 Dynamic Type,字号对齐桌面层级。不能把 .SFUI-* 私有字体名交给 Font.custom,会回退成衬线字体;此问题已加入检查。大字表单改为纵向排版,减少窄标签换行。

研究来源 ​

  • XcodeGen ProjectSpec(MIT):核对开发语言、资源目录及构建脚本配置。
  • Swift Foundation Bundle(Apache-2.0 with Runtime Library Exception):研究按类定位 framework bundle、语言资源查找的边界。只借鉴组织方式,没有复制实现。

Contract changes ​

无 Rust、CLI、IPC、保险库格式变更;新增 Swift 内部展示层 L10n、主题字体 modifier 和颜色令牌。VaultCategoryFilter.rawValue 不变,界面改用 label。

验证入口 ​

sh
python3 apps/ios/tests/check_localization.py
python3 apps/ios/tests/check_security.py
scripts/build-ios.sh --test

本地化检查加入 PassnoKit 构建阶段,覆盖未翻译的 UI 字面量、缺失词条/语言、占位参数和语言打包声明。XCTest 另检查实际编译后的资源、错误映射与两种外观的关键对比度。后续逐屏模拟器验收与截图记录在本节补充。

第二步细化:生成器字符集与网站规则移入「高级选项」,长度滑块实时更新;独立生成器的主操作为「复制」,按钮短暂显示「已复制」。新建/编辑的验证码和自定义字段折叠到「更多选项」,错误在表单内显示;确认密码不一致会给出中文/英文提示。条目筛选只常驻常用类型及收藏,其余收进「更多类型」。AutoFill 采用同一背景、品牌色、原生分组列表和搜索,补充无账号/无验证码的空状态。中文 Safari 自动填充已通过:本地靶场返回 username_filled=true、password_filled=true(此合成条目未配置 TOTP,因此 otp_filled=false)。

iosstyle 最终验收(2026-11-16 09:29,新加坡时间) ​

  • 已提交功能:251 个共享文案键及两份 Face ID 权限目录;中文/英文 App 和真实 AutoFill 扩展;原生浅色、系统深色、胶囊操作、紧凑表单、低频设置和折叠选项。未新增依赖或改动 Rust 接口。
  • scripts/build-ios.sh --test --no-launch:重建双平台 XCFramework、App 和 AutoFill,7 项 XCTest 通过。最后的按钮最小高度/表单条件调整另经 --skip-xcframework --no-launch 编译通过;最终安装包经 phone install 安装后重新逐屏验证。--no-launch 用于避免测试脚本自动打开已有模拟器保险库,手工启动始终带明确的临时路径。
  • cargo fmt --all、cargo clippy --workspace --all-targets -- -D warnings、cargo test --workspace 通过,共 160 项 Rust 测试通过。桌面 npm run lint、npm test(19 项)、npm run build 通过。工作树最初未安装 npm 依赖,先执行 npm ci --ignore-scripts,没有改动桌面源码或 lockfile。
  • check_localization.py 4 项、check_security.py 7 项均通过。Xcode 只有无 AppIntents 依赖的 metadata 提示;桌面 Vite 有原有的大 chunk 提示,不影响产物。
  • UI 完全经 phone / agent-device:建库 → 新建合成条目 → 列表/详情 → 生成器复制(读回 “Copied”)→ 设置 → 安全 → 锁定;错误主密码读回中文错误;App 与扩展的 Face ID 均由模拟器匹配事件完成。
  • 在系统设置里真实切换过 English 和简体中文,未用 App 内预览假冒扩展。Safari → 密码自动填充 → Passno → 模拟 Face ID → 实际账号列表 → 填充,中文路径的靶场返回用户名和密码两项 true。本轮没有重跑通行密钥/TOTP 专项(其原有实现未改,之前记录保留)。
  • 深色列表/详情与 AutoFill 已截图;英文 accessibility-medium 表单经截图确认标签纵向布局、输入与生成按钮仍可用。未宣称完成全套 VoiceOver 审核:系统扩展窗口有时无法由 agent-device 取得无障碍树,这些步骤按实际截图和单次坐标点击读回完成。

截图目录:/Volumes/Code/github/passno-wt/shots/iosstyle/。全部使用合成账号,不含真实保险库数据。

页面简体中文English
条目zh-Hans-items.pngen-items.png
详情zh-Hans-detail.pngen-detail.png
生成器zh-Hans-generator.pngen-generator.png
设置zh-Hans-settings.pngen-settings.png
Safari 真实 AutoFill 列表zh-Hans-autofill.pngen-autofill.png

补充:zh-Hans-empty.png、zh-Hans-unlock-error.png、zh-Hans-fill-verified.png、en-items-dark.png、en-detail-dark.png、en-autofill-dark.png、en-form-accessibility.png。

复现时先构建,再指定测试目录(首次运行会进入建库,使用自行选择的合成主密码):

sh
scripts/build-ios.sh --test --no-launch
PHONE_SESSION=ios-iosstyle phone boot
PHONE_SESSION=ios-iosstyle phone install com.virtever.passno "$PWD/target/ios-derived/Build/Products/Debug-iphonesimulator/Passno.app"
PHONE_SESSION=ios-iosstyle phone open com.virtever.passno --relaunch \
  --launch-args --passno-test-home --launch-args /tmp/passno-iosstyle-review
PHONE_SESSION=ios-iosstyle phone snapshot -i
# 其余操作仍按读屏、单次操作、读回进行,不写固定 UI 流程脚本。
PHONE_SESSION=ios-iosstyle phone close

收尾:测试库 /tmp/passno-iosstyle-20261116 已锁定;模拟器已恢复仅简体中文、浅色、默认 large 字号;ios-iosstyle 会话已关闭,本地 8766 靶场停止。保留合成测试库供协调者核对,没有访问 Mac 真实保险库,没有触碰安装中的 App/CLI,没有推送或合并 main。

iosstyle 需要用户本人 / 已知缺口 ​

  • 本工作线的本地化、风格和要求的十张截图已完成,没有等用户批准的开发步骤。
  • 用户最终看一眼中英界面、字体和单手操作效果;建议在真机用 VoiceOver / 更大字号复核。iOS 保留系统字体,没有打包桌面 Inter / JetBrains Mono。
  • 真机 Face ID / Secure Enclave、钥匙串与 iCloud、正式签名和 AutoFill provisioning 仍沿用上文的在场验收边界;本轮不连接真机、不上传 TestFlight。
  • 原有同步/恢复 UI、手机批准 Mac 解锁和通行密钥备份语义等功能缺口属于其他工作线,本次不把它们包装成已完成。

2026-11-16 回归测试(模拟器 iPhone 17 Pro) ​

scripts/build-ios.sh --test --no-launch 的 7 项 XCTest 全部通过。之后在模拟器上用临时目录逐屏走了一遍:

  • 首次启动时,模拟器钥匙串里有之前测试留下的恢复包,所以先显示“恢复保险库”,符合设计。点“改为创建新的保险库”继续;
  • 建库后出现应急套件,点“开始使用”;
  • 新建条目,用生成器生成密码并采用;
  • 锁定,先输错一次密码,提示“主密码或 Secret Key 不正确”,再用正确密码解锁,条目还在。

发现并修好: 解锁失败后,输错的密码还留在框里,得手动删掉才能重输。现在输错后会清空密码框并重新聚焦;键盘上的“前往”键也能直接解锁。改动在 UnlockView.unlock(),已在模拟器上复测。

条目交给 agent(2026-11-16) ​

和 Mac 一样,iPhone 的条目详情里也有“允许 agent 使用”和“每次使用都要我确认”两个开关(共享条目不显示)。走的是 FFI 的 set_item_agent_access,改完会触发同步,Mac 上的 agent 就能看到。模拟器实测:打开开关后,第二个开关才出现;返回列表再打开,设置仍在。 2026-11-17 起,打开“每次使用都要我确认”后下面多两行菜单“免确认时长”(5 分钟 / 15 分钟 / 1 小时)和“免确认次数”(1 / 3 / 5 / 10 次),走 FFI 的 set_item_confirm_limit,选了立即显示,保存失败就重新读回;iPhone 批准页对设了限额的敏感请求只有一个“批准(5 分钟内或 3 次内不再问)”按钮,仍要面容 ID;活动记录写“5 分钟内或 3 次内”。单元测试见 PassnoKitTests/ActivityLogTests.swift,模拟器上的界面待人工看(见 plan.md 第 15 项)。

设置 → 活动记录(2026-11-16) ​

  • 设置 → 安全与解锁 → 活动记录(PassnoApp/ActivityLogView.swift):顶部校验结论,下面按“今天 / 昨天 / 日期”分组,每条“时间 · 设备名”、一句话、agent 的用途,带“未同步”“移除后写入”标签;下拉刷新;加载、空、出错、锁定都在同一个列表里显示,不闪。
  • PassnoKit:ActivityLog.swift(解析 activity_json,单条认不出时只这一条显示英文摘要)、ActivityText.swift(规则表,转成中文句子和校验结论)、ActivityLogModel.swift(页面状态和分组)、AgentApprovalText.swift(时长和操作文字,批准页和活动记录共用)。
  • 记录点:主密码解锁 .masterPassword、面容 ID 解锁 .faceId、从 iCloud 恢复后 .recovery;锁定按钮 .manual,切到后台自动锁定 .appBackground,前台闲置 .idle(都经 lock_with_reason,锁之前发布未发布的记录)。PassnoSession 通过 VaultLockRecorder 协议记录,App 用 ActivityLockRecorder,AutoFill 扩展用 UnrecordedLockRecorder(填充是主人自己的使用,不记);apps/ios/tests/check_security.py 有检查防止扩展漏掉这一点。
  • 本机在成员日志里没有设备名时显示“本机”;其他设备上看到的是设备 id 缩写(已知限制:首台设备和未起名的设备没有名字)。
  • 测试:PassnoKitTests/ActivityLogTests.swift(解析、各种批准方式的句子、解锁/锁定、未知类型、校验结论、锁定原因经假的记录器检查;一个用例走真实 Rust 日志)。

构建产物不进 Launchpad(2026-11-16) ​

带 .app 的构建产物一律放在 *.noindex 目录里(target/ios-derived.noindex、target/bundle.noindex、target/release-artifacts.noindex),否则 macOS 会登记它们,Launchpad 和 Spotlight 里出现一排打不开的 “Passno”(Apple 芯片的 Mac 会把 iOS 构建也列出来)。自己跑 xcodebuild build/test 时也要带 -derivedDataPath target/<名字>.noindex,不要用 Xcode 默认的 DerivedData。tools/ci/check-noindex-builds.sh(在 scripts/check-all.sh 里)检查脚本和文档里的每条 xcodebuild。

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