Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

9.5 KB
Raw Blame

Cindy iOS 原生界面规范

本规范整理自任务顶部、任务详情和搜索的产品走查,适用于 iOS 27 体验目标下的新增与改造界面。它是 DESIGN.md 的平台补充,不是 Apple 官方规范,也不代表全部存量页面已完成迁移。实现应以项目已安装的公开原生 API 为准,版本名称不构成增加原生依赖的理由。

1. 原生行为与 Cindy 内容

  • 容器:导航、sheet 的呈现、拖拽、收起、安全区和键盘协调优先交给系统。不要用自绘圆角、假把手和 JS 位移动画冒充原生 sheet。
  • 控件:分组表单优先使用原生 Form / Section 或原生分组 List;输入、按钮、开关、选择器优先用现有原生组件。原生外壳包着手工卡片,只能称为“原生外壳”,不能称为整页原生化。
  • 内容:消息、Markdown、代码、业务图标和复杂数据可继续由 React Native 渲染。不要为原生化替换用户已熟悉的业务图标;远程桌面和文件保留现有 Monitor / Folder。
  • 系统管理的圆角、材质、字体和反馈遵循系统;不要强制覆盖成桌面几何或自行重画系统阴影。此范围只覆盖真实系统组件,自绘内容继续遵守 Mobile token 和双模式规范。系统导航符号可由原生控件提供,不扩展成任意混用图标库。
  • Android 保留平台实现与同等业务能力;不能为统一代码而退回 iOS 自绘外壳。存量复杂面板可以分阶段迁移,但新增 iOS 面板不再默认走 SheetSurface。

2. 顶部导航

  • 设置页与其他普通页面统一使用系统默认转场,不因入口位于左侧抽屉而反转方向。从首页抽屉进入设置、设备管理或插件页面时,抽屉退场(含遮罩淡出)与系统页面转场同步开始,不先等抽屉关完,也不额外叠加整页淡入。搜索与账号面板仍等待抽屉关闭回调,避免浮层重叠及键盘焦点丢失。实现见 apps/mobile/app/_layout.tsx 与 HomeSurface。
  • 首页与任务页导航内容的垂直位置保持一致;安全区只计入一次。对齐的是返回按钮、标题和操作的实际中心,不是容器外框高度。
  • 任务顶部整体透明,与中部内容保持连续背景,不另铺一条不一致的底色。
  • 标题只显示任务名称,不叠 Harness 图标或第二排元信息;完整信息进入任务详情。长标题截断,不挤压两侧操作。
  • 标题可有少量玻璃质感的药丸背景,但它是非交互标签,不应有按钮式强调、按压效果或交互语义。唯一的例外是双击标题直接打开重命名(单击无动作):它不加按压效果与读屏按钮语义,读屏用户经任务详情重命名;不能重命名的任务不响应双击。
  • 右侧保留远程桌面、文件、更多的组合操作;更多直接打开任务详情,不再先弹一层菜单。
  • 消息上滑到顶部时逐渐变模糊,控制项始终清晰。渐变应覆盖完整过渡区,避免突然出现一条重度模糊带。
  • 本轮任务顶部的参考调校为模糊强度 55、连续渐隐蒙版;标题与输入框上方状态胶囊统一使用强度 20 的浅磨砂和 surfaceTranslucent 半透明底色。它们是局部实现参数,不是所有页面的通用 token。当前蒙版是固定强度模糊的渐隐,不应称为可变模糊半径。

3. 面板与材质

  • 任务详情默认中等高度,允许上拉展开、下拉关闭;不要默认占满屏幕。
  • 可直接下拉关闭的任务详情和搜索不放右上角关闭按钮。需要显式取消、保存或防丢输入的编辑流程另按其语义设计,不把此规则扩展到所有弹窗;同时保留无障碍可用的关闭途径。
  • 保留系统 sheet 的玻璃材质。内部不要铺满不透明白底削弱玻璃感,也不要把每个内容块做成玻璃按钮。
  • 分组之间必须有清晰间隔,组内分隔线由统一分组组件管理。确有必要的自定义数据区域使用语义背景与轻量层次,避免卡片紧贴、重叠和多层边框。
  • 面板底部的确定/取消在软键盘弹起时必须完整可见;系统对内嵌内容的键盘避让不足时,按实际遮挡高度补齐,不用固定高度猜测。
  • 短工具按内容决定高度;长详情用可滚动内容和系统展开档位。不要用空 Spacer、固定大高度或多余说明撑大面板。
  • 从详情进入搜索等另一个面板时,等前一个真正关闭后再呈现;不能叠加两个遮罩,或仅依靠任意延迟安排切换。
  • 任务标签:任务选项面板不重复任务标题,左滑所在的行已说明操作对象。标签色块 28pt,沿整行等距排开,每格不小于 44pt 触控;彩色色块不描边,只有白色标签保留细描边以免在浅色面板上消失,这是对 DESIGN.md 标签色球「细描边」在 iOS 原生面板的收窄。末尾的「…」用同尺寸的灰色实心圆。
  • 标签管理页使用原生分组列表,与选项面板同一套材质:「‹ 标签」导航,行内是色块、名称和编辑铅笔,列表下用一行说明提示长按拖动排序,「添加标签」单独成组。编辑页依次是名称输入、两行六列色板、说明和整行主按钮,「删除标签」作为独立的危险操作组放在最后。返回即取消,不再另设「取消」「完成」按钮。

4. 任务详情的信息顺序

  1. 任务名称与必要的来源/用量摘要。
  2. 同组管理操作:重命名、复制任务链接、置顶/取消置顶、归档。
  3. 适用时展示其他任务能力入口,例如分支;保留原有能力条件。
  4. 搜索放在管理操作之后。
  5. 删除作为独立危险操作组。

文件和远程桌面已有常驻入口,不在这里重复。功能不可用时遵循真实业务状态,不为对齐布局伪造入口。

来源显示供应商名称;若绑定订阅账号,同时显示该供应商实际绑定的账号身份,并去除重复内容。不展示内部 provider ID、随机后缀或无助于决策的“未确认使用此套餐”说明;不拿其他账号身份补缺失值,不把未知套餐写成确定事实。

5. 搜索与触控

  • 任务内搜索是一件紧凑工具:原生输入框、清除、命中计数、上一条/下一条即可;仅在需要时出现加载更早消息的入口。
  • 不重复展示命中消息预览,不用说明文字和空白填满半屏。无结果、加载中等真实状态仍要表达清楚。
  • 命中后在原消息位置定位,让用户看上下文;键盘打开时仍应能输入、清除、切换结果及关闭搜索。
  • 按钮整行都可点击,包括文字右侧空白;独立触控目标至少 44×44pt。外观尺寸和热区独立,不能仅把字号或图标放大。
  • SwiftUI 自定义行须在尺寸与内边距确定之后设置完整命中形状;禁用、危险色、按压反馈和无障碍名称必须与实际行为一致。

6. 输入框与附属面板

  • 输入框默认收起为一行;点击后才展开多行编辑与工具栏,不默认占据消息区域。
  • iOS 富文本编辑使用原生 UITextView,保留草稿、引用、长文本折叠、选择与撤销语义。长稿可进入系统大屏编辑,返回后保留原稿。
  • 玻璃用于外层承载,正文必须清晰。录音中的识别文字直接进入编辑器;停止录音不自动发送,保留既有按住与滑动发送交互。
  • 附件面板默认半屏,最近媒体在前,照片/拍照/文件在同一原生分组,模式入口放后面。系统选择器须等附件面板关闭后再打开。
  • 模型面板遵循 统一模型选择器:直接选模型,收藏配置优先,已有任务再展示当前模型与同引擎推荐,随后按来源分组。主列表不提供 Harness 切换栏。
  • 搜索与来源筛选保持可见,搜索跨来源;模型行与设置入口分别有完整点击区域。Harness、推理强度、Fast、收藏与恢复推荐进入单个模型的原生设置页,返回保留搜索条件。
  • 收藏以被控电脑当前账号的已有收藏为真源:手机和桌面远程连接共享该电脑的完整配置副本,新增、编辑、删除等待被控端持久化确认。不同被控电脑相互独立,控制端自己的本机收藏不参与合并。引擎偏好仍按手机登录账号及被控设备隔离;当前任务选中标记只落在模型本体。深度/Fast 沿用既有草稿记忆和远端镜像;旧远端没有删除偏好的协议时,恢复推荐仍沿用桌面兼容快照写法。

7. 验收与迁移

  • 自绘内容的 Light / Dark 都必须实现,系统组件跟随应用主题。不能把“用了 themed 样式”当成两种模式已经目检。
  • 核对长中文/英文标题、大字体、窄屏与 iPad,避免把截图中的单台设备尺寸写成全局固定布局。
  • 实际检查:行右侧空白点击、半屏滚动、上拉展开、下拉关闭、快速重开、详情到搜索切换、软键盘、无结果和多结果导航。
  • 检查增加对比度、减少透明度等系统设置下的可读性;非交互标签不能被读成按钮。不能以保持玻璃感为由覆盖用户的无障碍偏好。
  • 交付分别写清“代码实现”“静态验证”“模拟器目检”“真机验证”。确认运行的是包含改动的源码后再宣称效果生效。
  • 不因文档要求而批量重写所有页面。迁移优先级及当前缺口见 本轮审查;原生配置变动仍遵守 冷更边界。