Skip to content

桌面端应用开发文档(macOS / Tauri v2) ​

分支:feat/desktop · 目录:apps/desktop · 最后更新:2026-11-16(UTC+8)

Contract change requests ​

docs/dev/api.md 当前的 15 个方法签名已完整镜像在 apps/desktop/src/api/types.ts 中;在实现「安全检查」和「剪贴板自动清空」时发现以下两项需要协调者评估的接口补充(前端已在 PassnoApi 中定义为可选方法,不影响现有核心对接):

  1. security_audit() -> SecurityAudit

    • 原因:ItemSummary 不含密码字段,前端无法安全地自行判断哪些条目属于弱密码或密码重复使用,Stats 目前只返回数量统计。
    • 建议数据结构:
      rust
      pub struct ReusedPasswordGroup { pub item_ids: Vec<String>, pub count: u32 }
      pub struct SecurityAudit {
          pub weak_item_ids: Vec<String>,
          pub reused_groups: Vec<ReusedPasswordGroup>,
          pub missing_totp_item_ids: Vec<String>,
      }
    • 当前处理:MockPassnoApi 已实现该方法;TauriPassnoApi 调用 invoke('security_audit')。
  2. copy_secret(value: String, clear_after_seconds: u64) 与 clear_clipboard()

    • 原因:桌面端在 Tauri 模式下要求通过 Rust 侧在设定秒数后清空剪贴板,避免纯前端定时器在后台/锁屏时失效。
    • 当前处理:apps/desktop/src-tauri/src/lib.rs 已通过 ClipboardBackend trait 提供 macOS 原生 pbcopy 定时清空实现(用递增 generation 计数防止误清用户新复制的内容),(2026-11-16:已接入真实后端并保留在 Tauri 壳层。)
  3. 回收站条目列表接口 (list_trashed)(桌面 UI 回收站视图所需):

    • 当前后端 passno-service::Service::list_items 默认过滤 !item.trashed,且 ItemFilter 尚无 trashed_only / include_trashed 字段,Tauri 命令表也尚未暴露回收站查询命令;但桌面设置页「回收站」需要展示已软删除条目并调用 restore_item(id)。
    • (2026-11-16:已实现,Tauri 命令 list_trashed,回收站页面可恢复和彻底删除。)原建议:新增 Tauri 命令 list_trashed() -> Vec<ItemSummary>(或在 ItemFilter 增加 trashedOnly?: boolean)。当前前端在 PassnoApi 提供可选 listTrashed?():MockPassnoApi 已完整支持回收站列表与恢复,TauriPassnoApi 尝试调用 list_trashed 并在命令缺失时优雅降级为提示文案。

1. 已实现内容 ​

桌面端位于 apps/desktop/,严格遵循 docs/ui/style.md 的浅色/深色语义令牌与简洁交互规范:

1.1 前端(React + TypeScript + Tailwind CSS + Radix UI + TanStack Virtual) ​

  • 设计令牌与字体(src/index.css、tailwind.config.ts)
    • 完整映射 --bg、--surface、--surface-muted、--nav-active、--brand(#2F6A5C)、--accent 与 --control(都等于品牌色,2026-11-17 统一配色)、--ink(提示条)等浅色与深色变量,支持跟随系统或手动切换。
    • 本地打包 @fontsource/inter 与 @fontsource/jetbrains-mono(OFL 许可),满足零外网请求的严格 CSP;数字启用 tabular-nums,动效限制在 150–200ms 且仅作用于 transform / opacity,尊重 prefers-reduced-motion。
  • 国际化(src/i18n/zh.ts)
    • 全部界面文案集中放在单一文件中,便于后续扩展英文或其他语言。
  • 服务接口与双后端切换(src/api/)
    • types.ts:与 docs/dev/api.md 一一对应的 TypeScript 类型与 PassnoApi 接口。
    • mock.ts:MockPassnoApi,默认预置 60 条覆盖全部 10 种 ItemKind 的合成测试数据、2 个保险库(个人、家庭)、弱密码与重复密码样例、RFC 6238 TOTP 动态验证码、模拟 latency 为 0 ms,并维护小写搜索索引(10,000 条检索 < 30 ms)。
    • tauri.ts:TauriPassnoApi,通过 invoke('<snake_case_method>', ...) 调用 Tauri 命令并将错误规范化为 PassnoServiceError。
    • index.ts:通过环境变量 VITE_PASSNO_API=mock|tauri 切换后端,默认 mock。
  • 错误处理集中化(src/utils/errors.ts)
    • normalizeServiceError 与 formatServiceError 统一解析 Tauri IPC { code, message } 错误(含嵌套结构与字符串错误),把后端全部 12 种 ServiceErrorCode 与常见英文 detail 映射成明确中文提示,不再把英文内部错误直接暴露到界面上。
  • 主要界面(v0.2 日常优先精简,docs/ui/style.md ## 常用 vs 不常用)
    • 首次设置(FirstRunScreen.tsx):创建主密码(实时强度条、空值/过短/不一致即时内联报错且输入即清除)→ 展示 Secret Key 与应急套件(移除不常用的 CLI 安装卡,仅保留复制、保存 .md 与确认继续)→ 安静空状态(EmptyVaultView.tsx:保险库已就绪 + 唯一强调按钮 + 新建条目 + 次要文字链 从其他密码管理器导入 跳转至设置导入页)。
    • 解锁页(UnlockScreen.tsx):空密码/错密码/无效 Secret Key 内联中文报错与红框标注(输入修改即清除)、SecretKeyMissing 自动展开 Secret Key 输入框;演示模式提供测试密码 passno123 快捷填入与「体验首次设置流程」重置入口。
    • 主窗口与条目页(TopBar.tsx、ItemsPage.tsx、ItemDetailPanel.tsx):没有 Logo 行和占位页签(导入在设置里);主窗口三栏贴边(2026-11-17):顶栏兼作 Mac 标题栏(tauri.conf.json 的 titleBarStyle: Overlay + hiddenTitle,data-tauri-drag-region 拖动,权限 core:window:allow-start-dragging),条目页放搜索(⌘F)、+ 新建、锁定、菜单(设置 / 安全检查 / 生成器 / 命令面板 ⌘K / 主题 / 锁定);左侧栏 ItemsSidebar.tsx 放全部、收藏、类型、保险库、安全检查、显示已归档、回收站;解锁和首次设置页用 WindowDragStrip 拖动窗口;右侧详情面板的字段整行可点:悬停或聚焦时隐藏字段才取明文显示(移开即藏,30 秒清出内存),点击复制;另展示 passwordHistoryCount 修改次数与 TOTP 倒计时。
    • 安全检查(SecurityPage.tsx):通过条目页状态指示或头像菜单进入,顶设 ← 返回条目,按弱密码、重复密码、缺少 2FA 分类排查并一键直达条目修复。
    • 分栏设置页(SettingsPage.tsx):替代过长弹窗,拆分为 通用(主题、快捷键)、安全与解锁(自动锁定、剪贴板清空、安全检查入口)、导入与导出(导入向导与库路径)、回收站(列表与恢复)、命令行工具(CLI 安装与检测)、关于 六大分区。
    • 新建 / 编辑、生成器、导入向导、命令面板:保留 ItemFormModal.tsx、GeneratorModal.tsx、ImportWizardModal.tsx 与 CommandPalette.tsx,后者新增直达设置与回收站动作,所有非主屏视图均支持 Esc 返回。

1.2 Tauri v2 壳层(apps/desktop/src-tauri) ​

  • Cargo.toml 包含空 [workspace] 表,目前不依赖尚未合并的 passno-service crate,可独立编译。
  • tauri.conf.json:Bundle ID com.virtever.passno,产品名 passno,配置了严格 CSP(禁止外部脚本与远端连接)。
  • capabilities/default.json:仅授予最小核心权限(core:event:default、core:window:allow-set-title)。
  • src/lib.rs:注册全部 15 个 docs/dev/api.md 命令存根(统一返回 { code: "NotInitialized", message: "..." }),以及带 ClipboardBackend trait 抽象的 copy_secret / clear_clipboard。

2. 如何运行与测试 ​

浏览器预览(使用 Mock 数据) ​

bash
cd apps/desktop
npm install
npm run dev
# 访问 http://localhost:1420
# 演示解锁密码:passno123
# 访问 http://localhost:1420/?firstRun=1 可直接体验首次设置流程

Tauri 桌面端开发模式 ​

bash
cd apps/desktop
# Tauri 原生窗口自动识别 __TAURI_INTERNALS__ 并走真实 passno-service(也可显式指定 VITE_PASSNO_API=mock)
npm run tauri dev

测试、静态检查与构建 ​

bash
cd apps/desktop
npm test          # Vitest + Testing Library(关键流程 + 万条检索 <30ms 基准 + RFC6238 TOTP)
npm run lint      # ESLint + 项目自己的 CSS 规则(scripts/lint-css.mjs)+ tsc -b --noEmit
npm run build     # 前端生产构建(.env.production 默认 VITE_PASSNO_API=tauri)

# Tauri 后端已并入根 Cargo workspace,可从仓库根目录统一检查:
cargo fmt --all -- --check
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace

# 一键构建并安装 macOS 发布版 passno.app(含内置 pn CLI):
./scripts/build-mac.sh

项目自己的 lint 规则(apps/desktop/scripts/lint-css.mjs,CI 的 desktop-web 会跑):踩过一次的界面坑写成规则,不靠记忆。加规则就往 RULES 里加一个对象。

规则防什么
no-transform-in-keyframes@keyframes 里不许写 transform,改用独立的 translate / scale / rotate 属性。弹窗用 Tailwind 的 -translate-x-1/2 -translate-y-1/2 居中,这本身就是 transform;动画里再写 transform 会在动画期间覆盖居中,弹窗先出现在右下方再跳回来(2026-11-16 打开密码生成器时闪屏就是这个原因,修复见 19fada8)
reduced-motion-covers-animationsindex.css 中定义的每一个 .animate-* 类都必须在 @media (prefers-reduced-motion: reduce) 块内显式归零,防止新增动效后忘记照顾系统减弱动态效果设置
no-transition-all禁止在 .css 或 .tsx 中使用 transition-all / transition: all,必须显式列出需要过渡的特定属性,避免大列表与详情切换产生无谓重绘与布局抖动

tauri build -- --debug 验证记录 ​

  • 2026-11-16 在当前远程无头 SSH 会话中执行 npm run tauri build -- --debug:
    • 前端构建、Rust 编译以及 passno.app 打包均成功;
    • 默认同时触发的 DMG 打包脚本 bundle_dmg.sh 会调用 osascript 操作 Finder 布局窗口,在锁屏/无 GUI 会话中会阻塞等待 Finder 响应。
  • 改用仅打 .app 包的命令:
    bash
    cd apps/desktop
    npm run tauri build -- --debug --bundles app
    成功产出 apps/desktop/src-tauri/target/debug/bundle/macos/passno.app(30.04 MiB,未签名调试包)。

3. 设计决策与取舍 ​

  1. 默认启动进入解锁页,兼顾首次设置可测性:在模拟模式下默认预置已初始化但锁定的 60 条保险库(测试密码 passno123),让开发者与验收者开箱即可检验列表、搜索、详情、TOTP 与安全页;同时通过解锁页链接、设置菜单或 ?firstRun=1 可一键重置到未初始化状态,完整走通首次设置与三卡片空状态。
  2. 模拟模式下「归档 / 收藏」的更新方式:docs/dev/api.md 的 update_item(id, draft) 中的 ItemDraft 未包含 archived 字段,因此在 MockPassnoApi 中额外提供了 toggleArchive / toggleFavorite 辅助方法以保证列表上下文菜单交互闭环;正式接入核心时建议在 passno-service 增加或扩展相应参数。
  3. 无外部依赖的 TOTP 与密码生成:浏览器预览侧的 cryptoHelpers.ts 用纯 TypeScript 实现 RFC 6238 HMAC-SHA1 与基于 crypto.getRandomValues 的无偏采样,仅用于 mock 演示;在 tauri 模式下完全交由 Rust 核心(passno-gen、passno-totp)处理。
  4. 未在当前远程会话生成截图:本机未安装独立的 Playwright Chromium,且规则禁止使用无头模式或改动共享前台 Chrome profile,因此暂未生成 docs/dev/img/ 截图,留待桌面解锁后人工或用 agent-desktop 补充。

4. 已知差距与 v0.2 待办 ​

  • 已于集成阶段完成:src-tauri 已接入根 workspace 与 LocalPassnoService,生产构建默认走 VITE_PASSNO_API=tauri;归档/收藏持久化、security_audit、stage_import_file、系统剪贴板自动清空、vault-changed 外部更改实时刷新以及"安装命令行工具 (pn)"引导均已接通。
  • 原生文件选择对话框:当前导入向导支持拖放、文件选择暂存及路径输入,后续可按需接入 tauri-plugin-dialog。
  • v0.2 界面功能:Touch ID / Apple Watch 解锁引导、菜单栏托盘与一键撤销授权、Agent 审批系统置顶小窗、共享成员与审计日志管理页面、docs/dev/img/ 界面截图补全。

锁屏或远程时验证真实界面:IPC 测试桥 ​

经 ssh 远程、或者屏幕锁着的时候,原生窗口截不了图,无障碍树也读不到。这时用 apps/desktop/src-tauri/examples/ipc_bridge.rs 验证真实界面加真实后端。

原理:

  • 用 Tauri 的模拟运行时(tauri::test)加载和正式 App 同一份命令表(register()),参数名转换走的也是同一条分发路径。
  • 在 127.0.0.1 上提供打包好的前端(apps/desktop/dist),把前端的 invoke 经 HTTP 转发过来。
  • 这样前端、命令层、核心库都是真的,只有 WebView 和 Rust 之间的传输换成了 HTTP。

用法:

sh
cd apps/desktop && VITE_PASSNO_API=tauri npm run build && cd -
PASSNO_HOME=/tmp/passno-e2e cargo run -p passno-desktop --example ipc_bridge -- 5198
# 用 agent-browser 打开 http://127.0.0.1:5198/ ,逐步读屏、操作、读回核对

注意:

  • 一定要设置 PASSNO_HOME 指向临时目录,不要用真实保险库。
  • 界面里"安装 / 移除命令行工具"的按钮作用在真实的 ~/.local/bin/pn 上,测试时别点。
  • 测试桥没有鉴权,只用于开发,不随 App 发布。

2026-11-16 用它做过一次完整验收,全部通过:

  • 首次设置:建保险库、显示 Secret Key;
  • 导入 1pux(29 条);
  • 详情面板显示密码、TOTP;
  • 生成器(易记短语);
  • 在界面新建条目,CLI 能看到;
  • CLI 新增条目,界面锁定后重新解锁能看到。

待改进: 输错主密码时,界面上没有明确的错误文字。(已于 2026-11-16 v0.2 UI 精简中通过 utils/errors.ts 与 UnlockScreen/FirstRunScreen 内联提示修复,并在 Vitest 与 Playwright headless Chromium mock 构建视觉检查中验证;待用户本人对新版界面的视觉质感、留白密度与按钮层级做最终主观验收。)

v0.2 真实后台能力整合(integrate1,2026-11-16) ​

此前回收站“等待后端”的说明已过时:现在已接 daemon 的列表、恢复、永久删除和清空。

  • 设置 → 安全与解锁:Touch ID 启用 / 停用、空闲超时和最长会话时间,保存后从 daemon 读回。锁定页仅在已录入且策略允许时显示「用 Touch ID 解锁」,仍保留主密码输入。
  • 设置 → 浏览器插件:点击后安装当前 bundle 的 Chrome native manifest,显示内置扩展 目录和未打包加载步骤。不会替用户开启开发者模式或更改 Chrome 密码保存偏好。
  • 详情:附件列表、原生选择文件添加 / 导出、确认删除;仅元数据附件显示不可导出。 历史密码默认只显示次数,展开才读元数据,本人点击才读取明文;30 秒、失焦、切换条目和锁定时清除。
  • 回收站:恢复保持原逻辑;永久删除和清空都要明确确认,不提供不可兑现的撤销。
  • vault-locked 推送立即撤下详情、编辑器、生成器、导入和命令面板;异步数据响应按会话代次丢弃,避免锁定后旧响应重新填回界面。
  • TOTP 每秒显示刷新不再延长 daemon 空闲计时,有独立回归测试。

无人在场的真实界面测试 ​

examples/ipc_bridge.rs 现在通过真实事件订阅转发 vault-locked / vault-changed, 不再把事件当空操作。桥只接受明确位于临时目录的 PASSNO_HOME,仍是开发测试工具,不打包。

bash
npm ci --prefix apps/desktop
npm run build --prefix apps/desktop
npm ci --prefix apps/extension
npm run build --prefix apps/extension
cd apps/extension
npx playwright test daemon.spec.ts

测试自动建立临时 daemon、临时保险库与隔离 Chromium。Touch ID 使用 fake provider, 原生文件选择器在测试中只替换为合成文件路径,其余都经过真实前端、Tauri 命令表和 daemon。 截图和更完整验证记录见 integrate1。

integrate1:订阅连续性 ​

vault-locked / vault-changed 订阅不随筛选和条目选择重建,通过 ref 取当前视图。 异步注册完成后核对 daemon 状态,补偿注册前的锁定。正式 watcher 和 IPC 测试桥共用 watch_daemon_events:daemon 断线立即通知锁定,重连后先订阅再核对状态,不由 watcher 自动启动 daemon。 取消 Touch ID 后保留重试和主密码入口;只有 daemon 策略不再允许时才隐藏按钮。

v0.2 首次恢复与存放位置(integrate2) ​

首次启动在创建表单之前调用发现:恢复包优先,其次 iCloud Drive 文件夹。找到保险库时 显示名称、来源和恢复材料状态;无结果且无警告才直接显示创建表单。来源不可用不会被 当作“没有保险库”。创建表单也保留“从其他位置恢复”入口,可输入 Folder、Git、S3/R2、 WebDAV 地址,或粘贴 v0.2 应急套件。恢复包包含 Secret Key 时只问主密码,否则询问 Secret Key / 应急套件。成功才进入主界面,密码与凭据不进入 localStorage。

设置新增“存放位置”:主位置与备份分别显示最近成功时间和错误,立即同步、添加/更改 位置、移除备份;下方“设备”显示当前和已移除设备。移除设备需要确认,当前设备不能 自我移除。移除备份只停止同步并清除其恢复凭据,保留远端文件。

StorageSection 每 5 秒读回元数据以反映后台完成状态,不刷新 daemon 的活动计时。

iCloud 备份(2026-11-16) ​

用户要求像钱包 App 那样“随时备份到 iCloud”。Tauri 命令 icloud_available(src-tauri/src/icloud.rs)调用 NSFileManager.URLForUbiquityContainerIdentifier("iCloud.com.virtever.passno"):只有签了 iCloud 权限、登录了 iCloud 的 App 才拿得到容器,第一次调用还会建好 ~/Library/Mobile Documents/iCloud~com~virtever~passno,passnod 往里同步。App 每次启动都在后台调用一次。PASSNO_ICLOUD_ROOT(测试和 IPC 测试桥)视为可用。

  • 首次创建:可用时显示“备份到 iCloud(推荐)”,默认勾选;创建成功后发 sync configure(主位置 = iCloud),在应急套件页显示结果。备份失败不影响保险库本身,提示去设置里重试。
  • 设置 → 存放位置:还没有任何位置且 iCloud 可用时,主按钮是一键“备份到 iCloud”,“添加存放位置”退为次要按钮;iCloud 不可用时位置表单里不出现 iCloud 选项。
  • 之后的“随时备份”沿用已有调度:修改后 0.5 秒、解锁、唤醒、启动时同步。
  • 测试:src/test/icloud-backup.test.tsx。
  • 2026-11-17 在签名发布版上实测发现的问题(已修):
    • 应急套件页被跳过:创建保险库后 passnod 发“保险库已变化”,App 重新读状态(已初始化、已解锁)就直接进了条目页,Secret Key 和“iCloud 备份失败”的提示都没显示。现在首次设置一直留在屏幕上,直到在应急套件页点“继续使用 passno”(App.tsx 的 firstRunOpen,测试在 session-events.test.tsx)。
    • iCloud 备份失败:passnod 没有钥匙串权限,见 release.md “passnod 是辅助 App”。
    • 报错只剩一句笼统的话:passnod 给很多失败写了具体的中文说明(“iCloud 文件还在下载,请稍后重试。”),界面却只按错误类别显示“本地文件读写失败”“发生内部错误”。现在中文界面直接显示后台的中文说明;只有本人才能做的操作被拒绝时显示 PolicyDenied,等确认超时显示 Timeout,不再都算“内部错误”(utils/errors.ts、src-tauri/src/dto.rs,测试 errors.test.ts)。
    • “重新开始”和改主密码都要等本人确认,IPC 读超时从 30 秒放宽到 90 秒(和批准 agent 一样)。
    • 首次设置的占位文字写“至少 10 个字符”,实际校验和报错是 8 个,统一为 8。 发现头的创建时间不是最后更新时间,因此当前首次恢复页显示恢复材料状态,不编造 “2 小时前更新”;最后成功同步时间只在本设备有可靠记录时显示。

验证使用 scripts/sync-e2e.mjs:两台临时 daemon + 生产前端 + 真实 IPC 命令表 + 隔离 Playwright Chromium;完整运行命令与截图路径见 integrate2。

desktopi18n:双语界面(2026-11-16,UTC+8) ​

桌面端 src/i18n 提供结构化 zh / en 词典和带类型的 t(key, values)。 设置 → 通用可选跟随系统、简体中文、English;英文系统使用英文,其余语言回退中文。 切换即时生效、保留当前页面,偏好仅保存在本机 localStorage,不包含保险库数据。 条目标题、用户自定义字段、远端名称等用户数据不翻译;新建字段默认标签采用当前语言。 错误按稳定错误码翻译,不再显示后端原始诊断(避免混合语言和敏感路径泄露)。

扩展采用 Chrome 标准 _locales/{zh_CN,en}/messages.json,源码在 src/_locales, 构建时复制到包根目录;default_locale=zh_CN。弹窗、填充菜单、保存提示和通行密钥窗口 都通过 chrome.i18n.getMessage 查词;浏览器预览使用同一份词典。 因此最小必要改动也包括扩展 manifest、静态通行密钥页面与构建时复制资源,未改填充协议。

Vitest 检查两种语言的递归键集合、插值参数,以及桌面/扩展 JSX 中硬编码的可见文字、 占位文字和无障碍标签。语言选择、系统 languagechange、错误翻译有独立回归测试。

参考项目(仅研究机制,独立实现,无 GPL/AGPL 代码):

  • i18next(MIT):语言变体归一化与显式回退。
  • Tauri plugins-workspace(MIT / Apache-2.0):分离检查、验签下载、安装的 API;核对本机实际 crate 源码。

Contract changes ​

本节语言部分不改变服务、CLI 或保险库格式。扩展仅新增标准 locale 资源与 manifest 声明。

需要用户本人 ​

最终查看中英文界面排版与译文是否符合习惯;本轮所有浏览器验证使用隔离 Chromium 与合成数据, 不启动安装版 App、不触发 Touch ID、真实钥匙串或签名授权。

主动更新 ​

设置 → 关于从 Rust package metadata 读取运行版本。检查使用 release 工作线配置的 https://passno.virtever.com/updates/latest.json,不允许前端传入任意 endpoint 或公钥。 Tauri 命令依次为 update_status、check_update、download_update、 install_update_and_restart;只有最后一步明确点击后才替换文件和重启。 下载调用 updater 的独立 download(验签成功才返回字节),保留 release 的 requireSignedVersion 约束。前端仅收到版本、发布说明、进度和固定错误,不收更新包。

状态包括检查中、已最新、发现更新、下载/验证、待安装、安装/重启与可重试失败。 后端互斥预订防止重复操作,安装失败保留已验证的下载供重试。无静默安装、无启动时联网。 模拟预览使用 MockUpdateClient,不会安装/重启任何真实 App。

cargo test -p passno-desktop updates::tests --lib 通过临时本机 HTTP 服务测试真实 updater 的更新清单解析、204 无更新、坏清单、错误签名拒绝;安装动作在 UI 测试中注入 fake。 生产网络地址和验签不会被测试覆盖。真实签名包替换与重启需发布线产物及用户最终验收。

Contract changes:新增上述四个 Tauri 命令和 update-progress 事件,无新增 agent/MCP 能力, 无 updater 前端通配权限,不改变发布清单格式。

设备名称 ​

桌面设备列表的当前设备默认显示 scutil --get ComputerName,失败/空值回退 sysctl -n hw.model,最后回退系统名称。命令由 ComputerNameSource 抽象,测试注入假名称; 不调用安全存储、生物识别或系统设置写入。创建/恢复后的当前设备同样显示该默认名称。

设置 → 存放位置 → 设备提供重命名:去首尾空白、1–80 Unicode 字符、禁止控制字符, 仅允许已知且未移除的设备。保存后重新读取列表。名称通过临时文件原子替换保存在 PASSNO_HOME/local/desktop-device-names.json,不修改设备 ID、权限、密钥或撤销状态。

Contract changes:Tauri 新增 rename_device({id,name}) -> void,前端对应 PassnoApi.renameDevice?;sync_command(devices) 在返回前合并本机显示名称。

范围决定与缺口:本工作线严格不修改核心签名成员日志;名称是本机显示别名,不会跨设备同步, 底层原始恢复设备记录仍由 sync 工作线管理。若需其他设备也看到改名,协调者需要单独设计 签名设备元数据更新协议,不应借“重新添加设备”冒充改名以改变成员身份语义。

验证包括 ComputerName/型号回退、名称持久化、空白/超长/控制字符拒绝、未知/已移除设备拒绝, 以及英文界面保存后读回并确认成员 ID 与撤销状态未变化。

验收与复现命令(desktopi18n) ​

bash
# 以下两个截图脚本都自行创建/清理隔离浏览器;没有原生授权路径。
node apps/desktop/src/test/desktopi18n.e2e.mjs
npm run build --prefix apps/extension
node apps/desktop/src/test/extensioni18n.e2e.mjs

npm run lint --prefix apps/desktop
npm test --prefix apps/desktop
npm run build --prefix apps/desktop
npm run lint --prefix apps/extension
npm test --prefix apps/extension
PASSNO_SHOTS_DIR=/Volumes/Code/github/passno-wt/shots/desktopi18n/extension \
  npm run test:e2e --prefix apps/extension -- autofill.spec.ts
PASSNO_SHOTS_DIR=/Volumes/Code/github/passno-wt/shots/desktopi18n/daemon \
  npm run test:e2e --prefix apps/extension -- daemon.spec.ts passkey.spec.ts
cargo fmt --all -- --check
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace

截图在 /Volumes/Code/github/passno-wt/shots/desktopi18n/:桌面 14 张、扩展 10 张双语图, 另有真实 daemon/fake nmhost E2E 图。扩展双语截图使用构建后的页面、实际 locale 文件和 模拟消息传输;已有 E2E 则加载真实扩展与临时 native manifest,所有秘密均为合成样本。

macOS Chromium 的 UI 语言可能与 Playwright locale / --lang 不同(实测扩展仍使用英文); 现有 E2E 对 UI 文案接受对应中英文译文,不放松填充、隔离或保存行为断言。 桌面真实 IPC 测试页显式设中文,以保留已有中文断言。截图路径可通过环境变量覆盖, 避免写入别的工作线目录。额外改动仅限这几个测试中的语言/输出路径。

新增本地更新签名 fixture 只含测试公钥、签名与合成字节;生成后测试私钥已删除。 测试覆盖合法签名下载和版本替换拒绝,不使用 release 私钥,不调用 install。 IPC 测试桥没有 updater 插件配置,检查更新返回明确不可用,不启动真实安装。

需要本人:看双语布局;正式签名、公证产物可用后验收一次真实更新与重启。 Touch ID、钥匙串授权和 Developer ID 授权仍由最终验收统一处理,本工作线未触发。

解锁输错后清空(2026-11-16) ​

和 iOS 一致:主密码输错(WrongPassword)时清空密码框并重新聚焦,方便直接重输;缺 Secret Key 时保留已输入的密码。测试见 src/test/flows.test.tsx。

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

  • 左侧导航 Agent 下面一项“活动记录 / Activity”(src/components/ActivitySection.tsx,事件转文字在 src/utils/activity.ts,加新事件类型只加一项)。Tauri 命令 activity(参数 filter 可省略),调用 IpcPassnoClient::activity,返回 ActivityView;前端是 PassnoApi.activity(filter?)。IPC 测试桥不用另加路由。
  • 顶部是校验结果:“记录完整,已校验 N 台设备”,或逐台写出出问题的设备和第一个问题的白话说明。列表从新到旧,每条一句话 + 操作、时长、在哪批准 + agent 写的用途;未同步的挂“未同步”,被移除设备移除后写的挂“移除后写入”。时长文字和审批弹窗、授权时长设置共用一份(src/utils/approval.ts)。
  • 打开时读一次,vault-changed / vault-locked 时重读,不轮询;每次最多 200 条,满了显示“显示更多”。锁定时提示解锁后再看。
  • 测试:src/test/activity-section.test.tsx。数据从哪来、能发现什么见 docs/dev/activity.md。

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