Rill UI 方向：内容检索与原生 macOS 工作站¶

更新：2026-09-21。设计基准为 Apple Human Interface Guidelines；Raycast 只用于快捷面板的搜索、键盘操作与内容预览参考。

信息架构¶

语音输入是产品主线，工作流是可复用的辅助配置；用户不需要先理解工作流就能完成语音输入。

主窗口围绕“找回和复用内容”组织，默认进入全部记录。侧栏依次是全部记录、记录集、活动、工作流，底部设置入口打开独立窗口。听写循环仍由字幕浮层、菜单栏与快捷面板承担。

• 全部记录是 RecordStore 的去重视图，选择该入口不隐式选中第一个集合。
• 记录采用导航、列表、详情分栏。列表展示摘要、来源与时间；详情优先展示内容与复制，集合归属与元数据在后。集合策略进入集合设置，采集与投递规则在独立管理入口中。
• 内容区不足 700pt 时在列表与详情之间切换；默认主窗口仍为 960×720，支持调整分栏宽度。
• 活动页突出就绪阻塞、待处理选择、失败恢复和进行中状态；成功运行使用紧凑行，展开后保留完整回执、纠错、隐私预览及失败录音恢复。精确阶段耗时只显示已记录的数据，旧数据的时间区间不推算为精确时间。
• 工作流采用列表与说明详情，展示用途、触发方式、处理步骤、输出和启用状态。外部 TOML 编辑、导入、复制、恢复预设与删除仍沿用原有行为。

单次运行的“执行详情与诊断”按 run ID 查询最近 20 条已清洗事件，失败操作直接展开当前运行的诊断。录音长度来自音频，识别与润色 API 耗时来自单调时钟；未计时、旧记录缺失或未运行的步骤不补估值，失败、取消和回退保留实际消耗的调用时间。

统一搜索与导航¶

主窗口 ⌘F 和工具栏搜索由同一浮层提供，保留 AppKit NSSearchField 桥接与首次/重复聚焦、方向键、回车、Esc 合同。页面不再提供第二套文字搜索框，置顶、来源与类型仍属于页面筛选。

结果依次为记录、记录集、运行历史、工作流、设置、页面。Record 通过现有 RecordStore.query 查询完整可搜索内容，扫描空批次并支持继续加载；运行历史沿用既有浏览服务与隐私预览权限。两类异步查询独立失败，过期查询不能更新新结果，搜索关闭即取消展示。

搜索选中 Record 后调用统一定位动作：进入全部记录、清除冲突筛选、刷新目录、选中记录并聚焦详情。记录被删除时显示不可用状态。快捷面板“在记录中显示”复用同一入口。搜索选中记录不会粘贴。

独立设置窗口¶

原生 Settings scene 提供 App 菜单和 ⌘, 入口。设置与主窗口共享 AppModel、持久化协调和保存失败状态，不创建第二套服务或存储。

设置深链携带具体设置项，映射到分区并定位；打开设置不改变主窗口的记录集、记录选择或活动导航。再次打开保留本次运行中的最后分区。

环境层与视觉规则¶

• 快捷面板保留回车粘贴、复制、置顶、⌘1…9、Esc 逐层关闭。宽度达到 760pt 且预览已打开时左右分栏，窄窗口在下方预览。
• 目标应用名称来自投递控制器同一目标解析路径，目标激活与退出时更新提示；实际投递仍经过现有焦点恢复和身份校验。
• 主窗口复制复用现有 RecordReuseSubject 通道，根据实际复制结果反馈，不调用集合消费投递。
• 使用系统字体、强调色、语义背景和原生选择色。现有 4/8/12/16/20/24pt 间距与 RillRadius 继续复用；卡片用于需要行动的事项。
• 原生控件和转场优先；自定义状态变化不阻塞输入。分别适配减少动态效果、减少透明度和提高对比度；减少透明度时字幕与快捷面板使用不透明系统背景。
• 文案走 UIStrings/L10n 双语表；SF Symbols 复用 RillSystemSymbol。保存和复制反馈以真实结果为准。

应用与菜单栏的图标语言、状态区分和源文件维护见 图标设计。

验证边界¶

模型与查询测试覆盖分页、取消、失效记录、独立设置导航和失败结果；原生 AppKit 测试覆盖焦点。UIRenderEvidenceTests 与 RecordQuickPanelRenderTests 使用临时样例数据导出渲染证据。

自动化与快照不能替代真实 Fn、IME 组合输入、跨应用粘贴、VoiceOver、多显示器和 macOS 14 交互验收。QA 时只保留一个拥有全局输入的 Rill 实例。具体步骤见 release-qa-checklist.md。

参考¶

• Apple Split views
• Apple Settings
• Apple Toolbars
• Raycast Clipboard History