界面使用指南

本页说明 Design System 1.2 中用户可见的统一交互。具体按钮名称会随业务模块变化，但位置和语义保持一致。

主题与显示密度

• 工作台当前按衡蓝、香槟金、章红、青律、曜灰、暖橙的固定顺序提供六套主题；主题只改变品牌表达，不改变功能或权限。
• Mode 可选浅色、暗色或跟随系统。
• 四档稳定 ID 依次为 dense、compact、comfortable、spacious，界面显示为紧凑、标准、舒适、宽松；管理端默认使用紧凑。
• 切换主题或密度不会丢失当前页面、查询或工作区。
• 顶栏“外观设置”同时提供浅色、深色、跟随系统以及衡蓝、香槟金、章红、青律。选择只保存 非敏感视觉偏好；浏览器禁止存储时仅在当前页面生效。

导航

• Side Shell：从左侧进入模块；折叠后悬停图标可查看名称。
• Top Shell：从顶部切换一级模块；低频入口进入“更多”。
• 面包屑表达当前位置；页面标题下的局部 Tabs 只切换当前对象内部内容。
• 全局搜索用于跨模块寻找对象，列表关键字只检索当前列表。

工作区 Tabs

在 Managed Tabs 模式中：

• 打开同一案件或客户会聚焦已有 Tab，不重复创建。
• 固定 Tab 可防止被批量关闭。
• 有未保存内容时，关闭前会确认。
• 浏览器刷新后只恢复仍有权限且仍存在的资源。
• 页面局部 Tabs 与工作区 Tabs 不同：前者切换一个对象内部，后者切换多个工作对象。

列表查询

1. 在 Quick Query 输入关键字和最常用条件。
2. 需要更多条件时打开“高级筛选”；按钮数字表示已应用的隐藏条件数。
3. 应用后，在 Applied Summary 查看或移除条件。
4. 经常复用的查询保存为个人视图；有权限时可发布团队视图。
5. 条件非常复杂时进入 Query Studio，并先阅读自然语言摘要再应用。

重置当前条件不会删除 Saved View。结果为空时，优先检查 Applied Summary，而不是重新填写所有条件。

表格

• 点击列头进行支持的排序。
• “列设置”调整显隐和顺序；密度按个人偏好保存。
• 勾选行后，批量操作出现在 Selection Action Bar。
• 行内低频操作进入 More 菜单；危险操作会二次确认。
• 导出前确认范围：当前页、当前查询或已选项。
• 状态同时用文字和视觉标记表达；不要只依据颜色判断。

常见状态

前端隐藏或禁用只改善体验。最终权限由服务器决定，因此共享 URL 后，不同用户看到的内容可能不同。

恢复工作状态与提交支持证据

可分享的站内列表状态应由 URL 表达。固定视图会保存 path 和以问号开头的 queryString，但不会保存密码、Token、Secret、API 路径或外部网址：

/tickets?status=Open&priority=High&pageIndex=2&pageSize=50

如果打开链接后条件不再可用，先检查权限、租户 Feature 和服务端字段目录。不要为了恢复旧视图而手工添加未知参数；固定视图不会冻结服务器权限或查询白名单。

向支持人员报告问题时，提供足够定位的信息，不要复制凭据、完整请求体或敏感业务数据：

页面：/tickets
操作：应用优先级筛选
时间：2026-08-10T09:30:00Z
Trace ID：00-<trace-id>-<span-id>-01
结果：403 / 稳定错误码

• 页面刷新前先记录 Trace ID 和发生时间；
• 对筛选问题附上已应用条件名称，不附敏感值；
• 对视觉问题说明主题、Mode、密度、Shell、视口和 reduced-motion；
• 对并发冲突保留服务端版本与用户操作顺序，不连续盲目重试；
• 支持人员应从服务端日志、Trace 和审计 Envelope 关联详情。