Appearance
passno 界面规范(2026-11-16)
用户要求: 风格参照 reference-style.png,但要更简洁、易用、流畅。
参考图是第三方的设计稿("Payvora"),只借它的风格:浅色、大量留白、柔和圆角、胶囊形导航。它的品牌、文案和具体布局不照搬。它的“深绿品牌色配嫩绿主按钮、黑色控件”2026-11-17 起不再沿用,见下面“配色”。
1. 风格要点(从参考图提炼)
- 背景近白,内容放在白色大圆角卡片里。分隔靠细边框和留白,几乎不用阴影。
- 顶部导航是一排文字,当前项用浅灰胶囊底色标出。
- 页面大标题很大、字距收紧,上面一行小字面包屑。条目页例外:日常主视图把空间全给条目,不放大标题和面包屑,筛选在左侧栏(2026-11-17)。
- 一个页面只有一个主按钮(品牌深青色),次要按钮是白底细边框的胶囊。
- 选项用"卡片式单选"(参考图里的 CSV / XLSX / PDF);复选框、开关、滑块、选中的单选用品牌色。
- 列表行高宽松,左边圆形头像(缩写字母,统一中性灰底),右边
⋯更多操作(只在悬停、选中或键盘聚焦时出现)。 - 状态用小胶囊标签;只有需要注意的状态(弱密码、已归档)才加颜色。
2. 设计令牌
配色(用户 2026-11-17 要求统一,“优雅、适合密码软件”)
- 只有一个品牌色:深青
#2F6A5C(深色模式#5AA894)。主按钮、选中的复选框 / 开关 / 滑块 / 单选、链接、成功提示(“✓ 已复制”、强度条)、焦点环都用它。安静、可信,像银行和钥匙串,不像促销。 - 其余一律中性灰。 头像统一浅灰底灰字;收藏的星是中性色(不再用橙色,免得和“需要注意”混淆);网址用正文颜色和正文字体;图标默认
--text-3。 - 颜色只表达含义: 琥珀色 = 需要注意(弱密码、安全检查计数、即将过期),红色 = 危险(删除、泄露)。不为装饰用颜色。
- 提示条(toast)用反色墨色
--ink,“撤销”用同色加下划线,不再是嫩绿字。 - 2026-11-17 之前有三种绿(深绿品牌、嫩绿按钮、Material 绿的“成功”)加黑色控件,头像七种粉彩色,深色模式下刺眼,看着杂乱。Mac App、浏览器插件、iPhone App 同一套值(
index.css、extension/src/shared/styles.css、PassnoKit/Theme.swift)。 - lint:
npm run lint的colors-from-tokens规则拦组件里的十六进制 /rgb()颜色和 Tailwind 自带色板类(bg-blue-500、text-white…),颜色只能来自令牌;二维码这类确实要固定颜色的地方写lint-allow-color并说明原因。
色值从参考图取样:弹窗部分没被遮罩压暗,是准确值;背后页面的颜色是按遮罩系数(约 0.71)换算回来的,可能有几个色阶的偏差。
css
:root {
/* 背景与表面 */
--bg: #FAFAF9; /* 窗口背景 */
--surface: #FFFFFF; /* 卡片、弹窗 */
--surface-muted: #F7F7F6; /* 卡片内的分组底色(参考图的 Columns 区域) */
--nav-active: #F1F2F2; /* 顶部导航当前项的胶囊底色 */
--border: #ECEDEC;
--border-strong: #DADCDB;
/* 文字 */
--text: #111214;
--text-2: #6B6F6E; /* 说明文字 */
--text-3: #9A9D9C; /* 占位符、次要元信息 */
/* 品牌与操作:同一个深青色 */
--brand: #2F6A5C; /* logo、链接、焦点环 */
--brand-soft: #E8F1EE;
--accent: var(--brand); /* 每页唯一的主按钮 */
--accent-hover: #285A4E;
--on-accent: #FFFFFF; /* 主按钮、选中控件上的文字和勾 */
--control: var(--brand); /* 复选框、开关、滑块、选中的单选 */
--ink: #1D1F21; --on-ink: #F6F6F5; /* 提示条(反色) */
/* 状态 */
--ok: var(--brand); --ok-soft: var(--brand-soft);
--warn: #B45309; --warn-soft: #FDF3E7; /* 弱密码、即将过期 */
--danger: #C62828; --danger-soft:#FDECEC; /* 泄露、拒绝 */
/* 形状 */
--r-modal: 24px; --r-card: 20px; --r-input: 12px; --r-pill: 999px;
--shadow-modal: 0 24px 48px -12px rgb(17 18 20 / 0.18);
--scrim: rgb(17 18 20 / 0.30);
}- 深色模式: 同一套语义名字,
--bg #0F1011、--surface #17181A、--border #26282A、--text #F2F3F3;品牌色提亮为#5AA894,主按钮上的字变深色#0B1A16(对比度 6.4),--ink变浅色。跟随系统设置。 - 字体:
- 用 Inter(OFL 许可,随应用打包);中文回退到系统字体:PingFang SC、Microsoft YaHei UI、Noto Sans CJK SC。
- 数字用等宽数字(
font-variant-numeric: tabular-nums)。密码、TOTP、密钥这类值用等宽字体(JetBrains Mono,OFL)。
- 字号:
| 用途 | 字号 / 行高 / 字重 |
|---|---|
| 页面标题 | 32 / 40,600,字距 -0.02em |
| 区块标题 | 18 / 26,600 |
| 正文 | 14 / 20,400 |
| 说明 | 13 / 18,400,用 --text-2 |
| 统计数字 | 24 / 30,600 |
- 间距: 4 的倍数。卡片内边距 24,页面左右边距 40,列表行高 56。
3. 简洁、易用的规则
- 主界面只留日常高频操作。 顶部栏只保留品牌标志(点击回到条目列表)、全局搜索/命令面板(
⌘K)、锁定按钮与账户/设置菜单;未实现的功能(如共享、Agent)不放占位页签。安全检查由条目页标题旁的一枚克制指示器、命令面板和设置入口进入;设置作为独立分节页面从头像菜单或⌘K打开。 - 一页只放一个主按钮。 条目页是"新建",弹窗里是确认动作。其余都用次要按钮或
⋯菜单。 - 渐进展开。 默认只显示最常用的字段,高级选项折叠起来,比如生成器的字符集细节、条目的自定义分区。
- 不用二次确认弹窗,用撤销。 删除或归档后,底部弹一条"已删除 · 撤销",保留 8 秒。真正不可逆的操作(移除共享成员、轮换密钥)才弹确认。
- 全键盘可用:
| 快捷键 | 动作 |
|---|---|
⌘K / Ctrl+K | 命令面板:搜索、跳转、执行 |
⌘N | 新建 |
⌘C | 复制密码 |
⌘⇧C | 复制用户名 |
⌘⌥C | 复制 TOTP |
⌘L | 锁定 |
↑ ↓ / Enter / Esc | 在列表中选择、打开、关闭 |
- 空状态要安静。 空保险库首页只放一句引导语和唯一的主按钮“新建条目”,外加一行不抢眼的文字链接“从其他密码管理器导入”(跳到 设置 → 导入与导出)。导入一辈子只用一两次,不在首页堆导入卡片(2026-11-16 用户要求)。
- 措辞平实。 例如说"这个密码在 3 个网站重复使用",而不是"检测到凭据复用风险"。
- 表单要紧凑:用分组行。 字段标签在左、输入框在右,没有边框,行与行之间只用细线分隔,一组字段放进一张圆角卡片(
components/ui/FormRows.tsx的FormGroup/FormRow)。不要上面一行标签、下面一个大输入框那样一层层叠。多行内容用自动增高的文本框(AutoGrowTextarea),从一行起步。行内按钮(比如“生成”)做成行里的小胶囊。标签控制在 6 个字以内,补充说明放进占位文字。2026-11-16 新建条目弹窗按这条改完,高度从约 630px 降到 486px,不用滚动了。
常用 vs 不常用
界面元素按使用频率分层:日常查密码、复制、编辑的高频动作留在主视野;低频配置、迁移、排障收进分节「设置」页,并全部保留在 ⌘K 命令面板中两步直达。
| 界面 / 元素 | 使用频率 | 原位置 | 调整后位置 | 理由 |
|---|---|---|---|---|
| 顶栏「共享」「Agent」页签 | 不可用(功能尚未上线) | 顶栏主导航 | 移除 | 零死链、零占位 UI,避免把未做完的说明页暴露成一级入口 |
| 顶栏「安全」页签 | 低频(定期巡检) | 顶栏主导航 | 移出顶栏;改为条目页标题旁克制的安全指示器 + ⌘K + 设置 → 安全与解锁 | 日常打开 App 95% 是查/填密码,顶栏无多余页签更安静;安全问题通过一枚轻量指示器提醒并一键直达「安全检查」页(左上角提供「← 返回条目」) |
| 顶栏「条目」页签 | 高频(唯一日常主视图) | 顶栏主导航 | 保留为默认主视图,Logo 点击即返回条目 | 只剩一个日常主视图时无需单独 Tab 栏,释放顶部空间 |
顶栏 ⌘K、锁定 🔒、头像菜单 | 高频 | 顶栏右侧 | 保留在顶栏右侧 | 随时呼出命令面板、锁库或进入设置 |
| 空保险库三张大卡片(1Password / Apple 密码导入 / 新建第一个条目) | 一次性 / 低频(导入)+ 高频(新建) | 空保险库首页整页 | 移除三卡片;改为居中的平静空状态:短句 + 单一「新建条目」主按钮 + 安静文字链接「从其他密码管理器导入」 | 导入不是日常功能,不该用三张大卡片占据首次进入的首页视觉 |
条目页右上角 [ 导入 ] 按钮 | 一次性 / 低频 | 条目页头部操作栏 | 移出主工具栏;放入 设置 → 导入与导出 与 ⌘K | 每页只留一个核心动作,条目页只保留主按钮「+ 新建」 |
| 条目页四张统计卡片(全部条目 / 弱密码 / 重复使用 / 缺少 2FA) | 低频(周期检查) | 条目页顶部网格 | 移除;合并为标题旁一枚克制的安全提示胶囊(如「N 项安全建议 →」或「状态良好」) | 四张大数字卡片挤占列表首屏,且总条数可直接在「全部」筛选胶囊看到 |
| 类型筛选胶囊(原来平铺 7 类 + 计数) | 高频(登录/卡片/笔记)+ 低频(Wi-Fi/证件等) | 列表卡片顶部全铺 | 紧凑化:常驻「全部 / 登录 / 银行卡 / 安全笔记」,其余收进「更多类型 ▾」 | 减少视觉噪音与折行,常用分类一眼直达 |
| 收藏 / 归档 / 保险库 / 回收站筛选 | 中频(收藏/保险库)+ 低频(归档/回收站) | 平铺多颗按钮 + 下拉 | 收藏、保险库(多库时)、显示已归档、回收站都在左侧栏;「显示已归档」与「打开回收站」收进「视图 ▾」菜单 | 既能单手切换常用筛选,又不把低频的归档/回收站堆在主栏 |
| 详情面板(字段复制 / 明文显示 / TOTP / 密码历史次数) | 高频 | 右侧滑入详情面板 | 保留;字段整行悬停显示、点击复制(2026-11-17,照 Apple 密码 App),明文按需加载、移开即藏、30s 清出内存,底部显示密码历史修改次数(不含明文) | 核心高频路径,少一层按钮 |
| 列表行的“2FA”绿色小标签 | 无需操作 | 每个开了验证码的登录行 | 移除(2026-11-17) | 每行一个绿标签很吵;验证码在详情最上面 |
| 顶栏菜单里的安全检查、命令面板、切换主题、锁定 | 重复入口 | 顶栏 ⚙ 菜单 | 移除,菜单只剩“生成密码”“设置 ⌘,”(2026-11-17) | 锁定有自己的按钮,安全检查在左侧栏,主题在设置,⌘K 仍可打开命令面板 |
| 解锁页的保险库文件路径、锁形图标块 | 几乎没人看 | 解锁卡片顶部 | 移除,路径只留在标题的悬停提示里(2026-11-17) | 对多数人没意义,还显得像技术工具 |
| 字段标签后的“· 分组名”(如“恢复代码 · 恢复”) | 无 | 详情字段标签 | 移除(2026-11-17) | 读起来像重复 |
| 设置页副标题、导航顺序 | — | 设置页 | 去掉副标题;导航改为 通用、安全与解锁、存放位置、共享、导入与导出、浏览器插件、Agent、命令行工具、活动记录、回收站、关于,每项图标不同(2026-11-17) | 常用的在前;原来“共享”排第一、存放位置和插件同一个图标 |
| 条目详情里的 agent 开关(允许 agent 使用 / 每次确认) | 低频(设一次很少再改) | 详情字段下方直接展开 | 折叠到详情底部,只显示一行“agent 使用 · 已允许 · 每次确认”,点开才显示开关(2026-11-17) | 不挤占字段的位置,状态仍一眼可见 |
| 首次设置第 2 步中的命令行工具安装 | 低频(开发者可选) | 首次设置应急套件页 | 从首次设置移除;保留在 设置 → 命令行工具 | 首次设置聚焦主密码与 Secret Key 备份,避免拉长关键引导 |
| 首次设置确认密码不一致 / 解锁页错误提示 | 关键校验路径 | 首次设置与解锁页 | 保留并补齐:输入框红框 + 清晰中文内联提示,后端 {code, message} 统一映射中文 | 解决输错主密码时报错不够明确的问题 |
| 新建 / 编辑条目弹窗 | 高频(基础字段)+ 低频(标签/分组/自定义字段) | 弹窗表单 | 保留基础字段与内嵌密码生成器,标签与自定义字段维持折叠渐进展开 | 保持表单轻量 |
| 密码生成器弹窗 | 中高频 | 从条目表单或 ⌘K 打开 | 保留;网站规则折叠,预留强度条高度防止打开跳动 | 即调即看、零跳动 |
| 设置界面(原长弹窗) | 低频 | 头像菜单打开的单一长弹窗 | 升级为分节设置页:通用 / 安全与解锁 / 导入与导出 / 回收站 / 命令行工具 / 关于 | 承载所有低频功能(含导入、回收站与 CLI 安装),结构清晰且避免弹窗套弹窗 |
| 软删除回收站 | 低频(误删找回) | 原仅支持 8 秒撤销 Toast | 保留 8 秒撤销 Toast,并在 设置 → 回收站、条目「视图 ▾」菜单和 ⌘K 提供完整回收站恢复页 | 误删超过 8 秒后仍可安全找回 |
命令面板 (⌘K) | 高频(键盘用户) | 全局快捷键 | 保留并扩展:搜索条目 + 新建 / 生成器 / 导入 / 安全检查 / 回收站 / 设置 / 主题 / 锁定 | 让所有移入设置的功能依然两键直达 |
每个界面的检查清单(用户 2026-11-16 要求,做或改任何界面都要过一遍)
不要异想天开。做之前和做完之后,逐条回答,汇报里写明查了哪些:
- 会不会闪屏? 逐帧想:初始渲染、数据还没到、数据到了、出错、关闭。不能先显示空状态再跳成内容(数据没到时保持原样或留出同样高度),弹窗打开不能跳位置(见
no-transform-in-keyframes),异步内容要预留高度,切换不能出现白屏或一闪而过的旧内容。 - 用户怎么交互? 第一眼该点哪;键盘能不能完成(Tab、Enter、Esc、方向键);点错了怎么撤回;忙的时候按钮是否禁用、有无进度提示;出错时在哪里看到什么话。
- 用户看到的是什么? 每种状态各看一遍:加载中、空、少量数据、很多数据、长文本、出错、锁定。文字是否平实,有没有把内部格式(JSON、错误码、ID)直接露给用户。
- 有没有多余的元素? 每个按钮、标签、提示都要问“每天会用吗、删掉会不会更好”;不常用的进设置或 ⌘K。
- 是否优雅? 对齐、留白、字号层级统一;同类操作样式一致;一屏只有一个主按钮。
- 切换是否丝滑? 页面、标签、弹窗之间的切换用 150–200 ms 的淡入/缩放,只动 opacity 和 transform;状态切换不能整块重新挂载导致闪烁;尊重“减弱动态效果”。
- 鼠标悬停、滑动、点击是否丝滑? 悬停有反馈且不改变布局;点击立即有反应(按下态、禁用态);长列表滚动不卡(虚拟列表),滚动时不重排。
能自动检查的就写成 lint 或测试(例如 no-transform-in-keyframes、翻译检查)。
4. 流畅的指标(要写进测试或基准)
| 场景 | 目标 |
|---|---|
| 冷启动到解锁界面 | < 800 ms |
| 解锁(指纹通过后)到列表可见 | < 300 ms |
| 搜索每次按键到结果更新 | < 30 ms(1 万条目,本地索引) |
| 打开条目详情 | < 50 ms,不出现转圈 |
| 列表滚动 | 60 fps(虚拟列表,10 万条也不卡) |
| 动效 | 150–200 ms ease-out;只动 opacity 和 transform;尊重 prefers-reduced-motion。用 translate(-50%,-50%) 居中的弹窗,入场动画要用独立的 scale / translate 属性,不能写 transform,否则动画期间会覆盖居中位移,弹窗先出现在偏右下的位置再跳回来(闪屏)。异步加载的内容要预留高度,避免弹窗打开后变高、位置跟着跳。前一条由 npm run lint 的 no-transform-in-keyframes 规则检查 |
- 本地操作不显示加载转圈,用乐观更新。只有同步、导入这类耗时操作才显示进度。
- 详情面板从右侧滑入,列表保持可见,不整页跳转。
5. 主要界面
5.1 主窗口:条目
┌───────────────────────────────────────────────────────────────────────────┐
│ ● ● ● [🔍 搜索标题、网址、用户名…] [+ 新建] 🔒 ⚙ ← 也是标题栏│
├──────────────┬──────────────────────────┬─────────────────────────────────┤
│ ▦ 全部 59 │ (GH) GitHub ⋯ │ (GH) GitHub ★ 编辑 ⋯ ✕ │
│ ☆ 收藏 10 │ alice@example.com │ ─────────────────────────────── │
│ 类型 │ (GO) Google 账号 ⋯ │ 用户名 alice@example.com │
│ 🔑 登录 37 │ (NF) Netflix ⋯ │ 密码 •••••••• 点击复制 │
│ 💳 银行卡 4 │ … │ 验证码 123 456 ◔ 18s [复制] │
│ 📝 安全笔记 3 │ │ 网址 github.com │
│ 保险库(多库时)│ │ › agent 使用 · 未允许 │
│ … │ │ │
│ 🛡 安全检查 21│ │ │
│ 🗄 显示已归档 │ │ │
│ 🗑 回收站 2 │ │ │
└──────────────┴──────────────────────────┴─────────────────────────────────┘- 三栏、贴边、没有页面标题(2026-11-17 用户反馈“上面很多内容都没啥用”,照 Apple 密码 App 和 1Password 8 重排):
- 顶栏就是 Mac 的标题栏(Tauri
titleBarStyle: Overlay),左边让出红黄绿三个按钮,空白处可以拖动窗口、双击缩放;条目页只放搜索框(⌘F聚焦)、「+ 新建」、锁定、菜单。不再有 Logo 行、面包屑、“条目”大标题;⌘K命令面板收进菜单。 - 左侧栏:全部、收藏;类型(登录、银行卡、安全笔记常驻,其余类型有条目才出现);保险库(多库时);底部是安全检查(有建议时橙色数字)、显示已归档、回收站。
- 中间列表,右边详情;没有外框卡片和页面边距,空间全给内容。
- 顶栏就是 Mac 的标题栏(Tauri
- 解锁页、首次设置页没有顶栏,窗口最上面留一条 32px 的拖动条(
WindowDragStrip)。 - 详情里的字段整行就是复制按钮(照 Apple 密码 App):鼠标移上去(或键盘聚焦)隐藏字段才显示明文,移开就藏回去;点一下复制,右侧的「点击复制」变成「✓ 已复制」。不再有单独的眼睛和复制按钮。显示和隐藏只用 CSS
:hover(group-hover:),鼠标移入只负责取一次明文;不能用onMouseLeave切 React 状态:2026-11-17 这样做在 Mac App 的 WebKit 里闪屏、密码一直显示不出来,npm run lint的no-hover-state-toggle规则会拦。空字段(含空的隐藏字段,靠get_item的empty标记)不显示,iPhone 详情同样不显示(FFI 也带empty);值那一行固定一行高,悬停时内容变化不能改变行高,否则行在鼠标下缩起来就会来回闪(同日,导入的银行卡带空的 username / password)。 - 分类切换用参考图的胶囊页签(
All 51,712那种样式),只常驻最常用的「全部 / 登录 / 银行卡 / 安全笔记」,其余收进「更多类型 ▾」。 - 列表头像优先用网站图标;没有图标就用两个字母的缩写,底色取自标题哈希的淡色。
- 详情面板:每个字段旁有复制按钮,点一下就复制,按钮短暂显示"已复制"。TOTP 旁边是一个倒计时圆环,底部显示密码历史修改次数(不含明文)。
- 列表和详情的比例(用户 2026-11-17 定):保留左列表、右详情。没选条目时列表占满;选中后列表宽
clamp(300px, 34%, 400px),详情占其余(最小窗口 920 时约 300 / 540,默认 1180 时约 360 / 730)。两栏撑满窗口高度、各自滚动,整页不滚。有详情时列表行只留头像、标题、副标题和⋯。窄于 768 时只显示详情。切换条目时详情回到顶部。 - 详情的顺序:验证码 → 关键信息 → 其他字段 → 网页表单详情(折叠)→ 网址 → 标签 → 备注 → 附件、历史密码 → agent 使用(折叠成一行)→ 创建、更新时间。低频内容一律在主要字段之后。
- 每种类型先显示它的关键信息(用户 2026-11-17 定):银行卡就是卡号、有效期、安全码、持卡人、密码(PIN);登录是用户名、密码;Wi-Fi 是网络名、密码;API 凭据是密钥(和接口地址);SSH 密钥是私钥(和公钥);身份是姓名(和邮箱、电话);证件是证件号(和到期日)。关键信息按这个固定顺序放在详情最上面的一组里,其他字段另成一组跟在后面。该有却没填的,在这一组最后用一行灰字写“还缺:有效期、安全码 (CVV)”,右边一个“补全”按钮打开编辑;编辑表单把关键字段按同样顺序排在最前,缺的给空输入框,空着不保存。只存了尾号的卡,卡号一行显示
•••• 1234 只存了尾号,“还缺”里写“完整卡号”;隐藏的卡号默认显示•••• 尾号(来自保险库算好的列表副标题,不为它解密)。银行卡的卡类型、卡组织、发卡行写在标题下面一行(“借记卡 · 银联 · 示例银行”),不再单独占一块,也不在字段里重复;保险库名只在有多个保险库时才写。2026-11-17 之前卡片最上面是一块“•••• 2211 信用卡”的概要,用户看不出这是什么,真正要用的卡号、有效期却没地方显示。哪些字段算关键信息由utils/keyFields.ts的KEY_SLOTS一处定义,加类型只加一项。银行卡和证件的隐藏字段不显示“生成”密码按钮。
5.2 密码生成器(弹窗,照参考图的导出弹窗布局)
┌────────────────────────────────────────────┐
│ 生成密码 (✕) │
│ 用于 github.com · 已按该网站规则调整 │
│ │
│ ┌────────────────────────────────────────┐ │
│ │ k7#Rq-vN2p-Lx9!e-Wm4s ↻ [复制] │ │ ← 等宽字体,大号
│ │ ████████████░░ 很强 · 128 位熵 │ │
│ └────────────────────────────────────────┘ │
│ 类型 │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │(●)随机字符│ │( )易记短语│ │( )PIN 码 │ │ ← 卡片式单选
│ └──────────┘ └──────────┘ └──────────┘ │
│ 长度 ──────────●────── 20 │
│ (■) 大写 (■) 数字 (■) 符号 (□) 排除易混字符│
│ ▸ 高级:每类最少个数、自定义字符集 │
│ │
│ [ 取消 ] [ 使用此密码 ] │
└────────────────────────────────────────────┘- 改任何选项,预览立即刷新,不需要点"生成"。
5.3 导入向导(弹窗)
- 第 1 步: 三张卡片式单选:1Password(
.1pux)、Apple 密码(.csv)、其他 CSV。下面是拖放区,旁边有一行小字链接"怎么导出?"。 - 第 2 步: 预览统计,例如"将导入 1,284 条 · 4 个保险库 · 23 个附件",并列出"不会迁移的内容",比如通行密钥。还有两个选项:目标保险库、遇到重复条目怎么办(跳过 / 合并 / 都保留)。
- 第 3 步: 完成报告,有一个"查看降级的字段"链接,主按钮是"开始使用"。
5.4 Agent 审批(系统级小窗,置顶)
┌──────────────────────────────────────────┐
│ (🤖) Claude Code 请求使用一个密钥 │
│ ~/code/github/passno · 终端 glass │
│ │
│ GitHub token → api.github.com │
│ POST /repos/*/issues │ ← 精确到域名、路径和方法
│ agent 看不到密钥的值 │ ← 绿色提示;注入环境变量时变成黄色警告
│ │
│ 允许多久 │
│ (●) 仅这一次 ( ) 本次运行 ( ) 8 小时 │
│ │
│ [ 拒绝 ] [ 允许 · Touch ID ] │
└──────────────────────────────────────────┘- 键盘操作:
Enter允许(会触发 Touch ID),Esc拒绝。 - 没有响应时,60 秒后自动拒绝。
- "Agent" 页面列出所有授权,每条都能撤销,右上角有一个"全部撤销"。
5.5 浏览器扩展:页面内填充菜单
- 小卡片紧贴在输入框下方,宽 320,圆角 16,用同一套颜色和字体。
- 每行显示头像、标题、用户名;
↑↓选择,Enter填充。 - 最底下一行是"生成强密码",只在注册或改密码的表单上出现。
- 提交表单后,在页面右上角弹出一个保存或更新的提示卡片,有"保存"(主按钮)和"不保存"两个选项。
6. 前端技术建议(Tauri + 扩展共用)
- 框架: React + TypeScript + Tailwind(上面的令牌写成 Tailwind 主题)+ Radix UI 基础组件,可以参照 shadcn/ui 的写法。这些都是 MIT,风格也和参考图接近。
- 共用组件: 扩展和桌面端共用一个
ui/组件包。 - 列表和搜索:
- 列表用 TanStack Virtual 做虚拟化。
- 搜索索引放在 Rust 侧,前端只拿当前可见的那一页结果。
- 明文不进前端状态,只有显示或复制的那一刻才向 Rust 要。
- 图标: Lucide(ISC),线宽 1.5,尺寸 18。
iOS 对齐说明(iosstyle,2026-11-16)
- App 与 AutoFill 共用
PassnoTheme和Localizable.xcstrings;中文默认/回退,另有英文,跟随系统语言。条目、生成器、设置为底部导航;安全检查、导入及自动填充配置在设置中。 - 不强制深色;浅色使用上文令牌,深色将品牌文字调为
#8BC6B2、说明文字#9CA0A0、警告#EAB374、危险#F19090。选中控件前景必须用onControl,不可写死白色。 - iPhone 页面边距 16–20pt、卡片圆角 20pt、表单标签默认 92pt;主按钮为品牌深青色胶囊,触控高度至少 44pt。标题使用原生导航栏,其余字号按本规范缩放。
- 字体采用 iOS 系统字体和系统等宽字体,支持 Dynamic Type;辅助功能大字号下表单标签在上、输入在下。动效尊重 Reduce Motion。原生搜索、系统菜单和键盘文案由 iOS 负责。
桌面与 Chrome 扩展双语规范(desktopi18n)
- 文案统一进入 locale 词典,包括按钮、错误、aria-label、占位提示与通行密钥窗口。
- 默认跟随系统/浏览器:支持英文时使用英文,其他未支持语言回退简体中文;桌面设置 → 通用提供手动覆盖。
- 英文允许按钮自然变宽、说明换行,不使用中文长度假设或裁剪主操作文字。
- 用户输入的条目名称、字段名和设备自定义名称不翻译。插值由词典控制顺序,不把用户数据作为翻译键。
- 语言切换保留页面与表单状态;不得通过重载应用使未保存内容丢失。