页面 UX 规范
嵌在 openmax.com 里的页面怎么放信息、怎么做操作,让它和平台页面用起来像一家人。
页面 UX 规范
你的页面会出现在 OpenMax 的框里,和平台自己的页面挨着用。下面是让它看起来「是一家人」、用起来不别扭的做法,每条附一个小例子。嵌入和主题相关的技术做法见登录「实践:嵌入与登录」。
信息怎么放
- 一件事一个入口。 同一个动作在页面上只出现一次;同一对象出现在几处、每处都能原地改,算同一个入口。 例:「停用」只放在对象本身上,不在列表、详情、菜单里各放一个。
- 第一眼只放「现在怎样、要我做什么」。 ID、路径、接口地址、JSON、状态键、版本号收进详情,需要时再展开。 例:卡片写「报销单在等张三审批,明天 18:00 到期」,单号收进「详情」。
- 用人的话。 不用系统的话。
例:写「还没人接手」,不写
status=UNASSIGNED。 - 一屏一个主操作。 主按钮最显眼,次要的降低视觉权重;但对象上本来就能原地改的操作,不收进折叠菜单。 例:审批页主按钮是「同意」,「转交」用次要样式放旁边。
- 状态始终可见:到哪了、在等谁、几点到期。 例:进度条下面一行「第 2 步 / 共 4 步 · 在等财务 · 今天 17:00 前」。
- 不常驻说明文字。 规则解释、「系统怎么运作」不要一直挂在界面上。依次换成:设计自己说话 → 相关那一刻说一句 → 软件先替人做好 → 收进 ⓘ → 交给对话解释。只有两类可以常驻:改不回来或马上出错的后果、空状态的下一步。 例:删除确认框里写「删除后不能恢复」,平时页面上不写。
操作怎么做
- 防错胜于报错。 没权限的操作不出现(名字、状态这类信息照常显示);有权限但状态不允许的灰着,悬停或点一下说原因和怎么解除,不另放一个「解除」按钮;到那一刻就提示,不等提交才报错。 例:灰着的「编辑」悬停显示「运行中不能改,先停用」,点一下跳到能停用的地方。
- 有权限就原地改,不跳页。 看得到、有权限、状态允许,就在原地改,不离开当前上下文;改不回来的操作(删除、吊销、转交)也在原地确认。 例:标题点一下直接变输入框,回车保存。
- 软件能判断的,不让人填、不让人找。 能预填的预填,并标明依据、可改。 例:负责人默认填「当前项目的负责人」,旁边小字「已按项目填,可改」。
- 要选东西的那一刻,就在选择框里给全候选。 不要求先去别的设置页建好;缺前提的候选照样列出,选了再原地引导补上。 例:选 agent 的下拉直接列出组织里的 agent,选了一个还没装技能的,当场提示安装。
对人和对 agent
- 能对话做的都能对话做,表单是辅助。 每个功能都能用对话发起、修改、查询;表单和按钮帮人把意思说准、确认 AI 理解对,不是唯一入口。对话里的同意不直接生效:先列清要改什么,让有权限的人确认,和表单走同一套审批和记录。
例:用户在聊天里说「把第 2 步改成财务审批」,agent 回一张「将要修改:第 2 步 审批人 → 财务」的确认卡(聊天里的卡片按钮要用 Chat SDK 的
{ adapter }写法,见 Chat SDK 接入)。 - 看得到 agent 就能点开聊。 页面上显示的 agent 名字或头像,点一下在原地打开和它的私聊,并把「我现在在看什么」带过去;带过去的上下文由服务端核对,只带这个人看得到的。没权限私聊的,名字照常显示但不能点。
例:在某次运行的第 3 步旁点 agent 头像,私聊窗打开,首条上下文是「这次运行 · 第 3 步」。
技术上:点头像在原地开私聊现在就能做(Chat SDK
openConversation({ memberId }));「带上下文」即将上线,而且首条上下文消息或卡片由你的服务端自己生成、自己核这个人能不能看,SDK 和平台都不替你核。要让外壳打开 OpenMax 自己的私聊窗,用「应用请求打开会话」(navigate,即将上线,见打开方式与地址)。 - 对 agent 友好:人在界面能做的,agent 走接口都能做,权限和审批相同;ID、错误码、请求 ID 放在接口层,不堆进人看的界面。 例:界面写「没有权限」,接口回 403 加错误码和请求 ID。
窄屏与嵌入
- 390 宽的手机上可用,嵌入时没有横向滚动。 验收时除桌面宽度外,再截一张 390×844、在 openmax.com 嵌入里的样子。 例:表格在窄屏变成上下排列的卡片;侧栏收到页面下方或抽屉里,而不是把主内容挤出屏幕。
