状态：建议稿 v0.2，可调整，沿用已确认的六条设计原则；本页不是已批准的文案库，也不声明已完成本地化验收。已有手册阅读词表，但尚未建立产品最终术语库或翻译资源；真实界面、辅助技术、翻译、输入法、读屏、RTL 排版与复制等运行验收均未执行，文中示例是候选表达。 更新：2026-10-19（UTC），含官方资料核查。 所属章节：视觉与语义基础
1. 以用户能理解的中文写界面
文案直接说明对象、动作、事实和结果。优先使用清楚的短句与自然中文，避免内部技术术语、机械直译、冗长名词串及无信息的客套话。简洁不等于省掉对象、范围、限制或恢复方法。
“保存付款计划”通常优于“执行付款计划保存操作”；“未找到符合条件的合同”优于“没有数据”；“正在校验文件”优于“处理中，请耐心等待哦”。语气平实，不责备用户，不用祝贺掩盖部分失败，也不把无法确认的结果写成确定事实。
2. 术语表维护什么
共同词条记录名称、定义、适用对象、状态或动作类别、同义词处理、禁止混用词、产品差异、各语言对应及负责人。术语来自业务事实，不能由翻译人员或组件开发者凭界面空间临时改写。
以下词义需在使用前明确：
| 词语 | 应回答的问题 | 不能默认等同于 |
|---|---|---|
| 保存 | 保存到哪里，是否已持久化 | 提交、发布或审核通过 |
| 提交 | 交给哪个流程，之后发生什么 | 仅保存在当前设备 |
| 取消 | 停止哪个步骤，是否影响已完成部分 | 撤销全部结果 |
| 撤销 | 恢复哪个动作，期限和限制是什么 | 删除一条审计记录 |
| 撤回 | 从哪个流程阶段退回 | 已发生后果全部逆转 |
| 删除／作废／归档 | 数据、业务效力或可见性分别如何变化 | 三种操作相互替换 |
产品存在不同业务定义时，以范围限定消除冲突，如“撤回审核申请”，不能强迫不同制度共用一个含混术语。通用系统文案负责表达，制度本身仍由产品定义。
2.1 手册阅读词表
本表统一手册中的设计术语，帮助阅读，不是产品业务词典或可直接发布的多语言资源。英文用于检索参考；界面文案仍按对象、真实能力与目标语言审核。发生细节疑问时以所列主档为准。
| 中文术语 | 英文检索词 | 本手册含义及边界 | 主档 |
|---|---|---|---|
| 布局 | Layout | 页面区域如何排列；不规定一次完整任务 | 页面与端到端模板 |
| 页面模板 | Page template / Floorplan | 为一类任务组合区域和组件；不是任意视觉容器 | 页面与端到端模板 |
| 任务链 | Task journey | 用户从进入到结果及返回的跨页面路径 | 端到端任务旅程与验收案例 |
| 解剖 | Anatomy | 组件必需、可选和条件必需的组成区域 | 基础组件与交互契约 |
| 变体 | Variant | 同一任务下明确不同用途的组件形式，不是每个状态的别名 | 基础组件与交互契约 |
| 状态 | State | 当前真实条件，如聚焦、只读、正在读取；不同维度可并存 | 系统状态、权限与恢复 |
| 聚焦 | Focus | 当前输入与键盘操作的目标，不等于已选择或已打开 | 选择组件：值、范围与层级 |
| 选择 | Selection | 用户明确选中的值或范围，不因获得焦点自动改变 | 选择组件：值、范围与层级 |
| 草稿 | Draft | 编辑中的工作内容，可为本地未保存内容或已持久化的草稿；保存状态与业务提交阶段分别表达，允许保留暂时无效的原始输入 | 表单校验、草稿与提交 |
| 接受 | Accept | 将子编辑器或当前编辑层的值交给其调用者；不自动表示远端保存 | 输入组件：文本、结构化编辑与专用输入 |
| 只读 | Read-only | 可以读取但不能编辑；是否可复制仍受输出权限约束 | 权限变化、并发修改与保存冲突 |
| 禁用 | Disabled | 当前操作不可执行；应有可理解的条件或原因，不等于内容不可读 | 操作组件：按钮与动作入口 |
| 受限 | Restricted | 受到读取或操作权限限制；是否能披露存在及原因由产品定义 | 权限变化、并发修改与保存冲突 |
| 未知结果 | Unknown outcome | 请求可能已执行，但没有足以确认结果的证据；不能直接写失败并重试 | 异步执行、结果核查与恢复 |
| 部分成功 | Partial success | 结果中既有明确成功也有未成功或待核实项；范围与逐项结果须可分辨 | 异步执行、结果核查与恢复 |
| 等价路径 | Equivalent path | 使用不同呈现或输入方式完成同一任务、理解相同信息与结果；不只是显示相似卡片 | 平台适配、国际化与输入能力 |
| 模态层 | Modal layer | 打开期间限制对父任务的交互；关闭不自动取消父任务或已发写入 | 浮层组件：对话框、抽屉与提示 |
| 契约 | Contract | 必须共同遵守的输入、状态、行为和结果边界；不是指定实现 API | 规范、设计与实现映射 |
| 文档夹具 | Documentation fixture | 用来检查规则的一组前提、操作和预期；有夹具不代表测试已运行 | 质量基线、门禁与验收证据 |
阅读查询与表格时，D/A/R/S/W/V 是状态审阅缩写而不是 API 字段，完整中文释义见 查询、选择范围与批量执行 第 1.1 节。E 是父选择框当前已解析的可操作范围，见 选择组件：值、范围与层级 的 CHO-CHECK。面向最终用户的文案不用这些内部字母代替对象与事实。
3. 标题、标签与按钮
页面标题回答“我在处理什么”，区块标题说明内容，按钮名称说明将执行的动作。常见结构是“动词＋对象”，例如“新增合同”“导出筛选结果”“重试失败项”。上下文足够明确时可以缩短，但不能让用户在关键时刻猜测对象与范围。
- “确定”只适合上下文非常明确且后果简单的确认，不作为高风险操作的默认按钮。
- “继续”用于下一步仍未执行最终动作的流程；最终动作改为“提交审核”等准确名称。
- “保存并提交”必须确实执行两步，且结果反馈能区分保存成功与提交失败。
- 按钮是否需要省略号取决于平台与既有约定，不在跨平台层强制同一标点。
- 字段标签持久存在；占位文字仅提供输入示例或格式提示，不代替标签、当前值或错误。
- 可访问名称保留可见标签所表达的词语；不要让按钮写“导出”，辅助技术却只读“下载图标”。
提示需要明确它附属于哪个字段、对象或任务。“名称最多 80 个字符”只有在产品确有该限制时才能出现；长度究竟按字符、字素还是字节计算由实现和产品明确，不能文案说一套、服务端算另一套。
4. 状态与结果文案
状态文案只表达已知事实。至少区分尚未开始、处理中、完成、部分成功、失败、取消待确认与结果未知。是否有更多状态由具体流程决定，不用一套状态词覆盖所有产品。
| 情境 | 建议表达示例 | 避免 |
|---|---|---|
| 草稿持久化成功 | 草稿已保存 | 已提交成功 |
| 有明确进度 | 已处理 80／100 项 | 即将完成（没有依据） |
| 部分成功 | 97 项成功，3 项失败。查看失败项 | 操作成功 |
| 请求后断连 | 连接中断，尚未确认提交结果。查看任务状态 | 提交失败，立即重试 |
| 无查询匹配 | 没有符合当前筛选条件的合同。调整筛选 | 暂无数据（不说明范围） |
| 权限受限 | 你没有查看此内容的权限 | 数据不存在（实际并非如此） |
受限信息是否可以披露其存在，由产品安全策略决定。若连对象存在性都受限，采用批准的安全文案，不能为了“解释清楚”泄露对象名、负责人或内容。
5. 错误消息的结构
错误尽可能包括：发生了什么、影响哪个对象、用户能做什么。只有掌握原因才说明原因；未知时避免推测。“结束日期早于开始日期，请调整结束日期”优于“数据格式非法”。
字段错误与字段建立可访问关联；跨字段错误说明关系；页面级错误说明影响范围。多个字段有问题时，提供可定位的摘要与逐项说明，不能只在顶部说“有错误”。更正时不要立即清空其他输入，也不要为了清除错误提示删除用户内容。
面向用户的原因与诊断标识分开。可以提供“错误编号”供支持查询，但不能只显示异常堆栈或内部接口字段；也不能在错误中泄露服务器路径、凭据或受限业务记录。技术详情是否可复制、谁可见由安全规则决定。
恢复动作必须可执行：会话问题可通过重新登录解决时才提示重新登录，有明确申请路径时才显示“申请权限”，能安全重试时才提供重试。无法恢复时直接说明限制和可行路径，不编造“稍后一定恢复”或“系统会自动处理”。
受限富文本编辑、格式化显示与 HTML 源文边界统一见 输入组件：文本、结构化编辑与专用输入 的 B3-RICH；本页继续负责内容语义与文案，不另定义允许格式或净化规则。
6. 说明与帮助的层次
直接呈现当前判断所需的单位、期间、风险、限制和已应用范围。辅助说明就近放置，完整定义可在可访问的说明面板或链接中展开。不要把必要信息全部藏入问号图标或悬浮层。
提示层用于补充，不承担唯一的错误信息或提交后果说明。Web 中由悬浮或焦点触发的额外内容，需要按适用条件满足可关闭、可移入和持续可见等要求。WCAG 2.2 SC 1.4.13 官方说明
7. 多语言是完整消息设计
翻译以完整句子和语义变量为单位，保留译者上下文、对象类型、性别或复数规则需要的信息。不要把“已选择”＋数字＋“项”硬拼成所有语言的通用模板，也不要把状态词翻译成同一个“完成”而失去业务区别。
日期、货币、数量和单位交给明确的本地化格式契约，避免字符串替换。本页只规定消息边界；精度、零值、时区及币种含义统一见 指标、数值与时间格式，不维护第二套数值规则。
语言、区域、时区和币种不是同一设置。使用英文界面不意味着按美国时区统计，选择中文也不意味着所有金额都为人民币。产品应说明这些偏好的作用范围。
RTL 与混合文本
语言和文字方向应分别明确。Web 中基准方向属于文档语义，用适当方向标记表达，布局使用起始／结束逻辑概念，不能只靠文本右对齐模拟 RTL。W3C 结构标记与 RTL 指南
混合自然语言、合同编号、负号、货币符号和括号时，要防止双向排列使符号跑到错误位置。优先用平台支持的方向隔离和结构机制；不能把不可见控制字符随意写入业务原值以修正画面。显示隔离不能改变复制、搜索、导出或审计中的原始标识。W3C 双向文本控制说明
FND-I01：完整消息与方向隔离契约
每条可复用消息记录稳定消息标识、完整句式、变量类型、零／一／多及目标语言其他复数形式、作用对象、权限可见范围、最大真实内容样例和缺翻译回退。变量由类型化格式契约提供，不把货币字符串当普通数值二次舍入，不将时间点与本地日期互转。详细时间、数字与导出规则的唯一主档是 指标、数值与时间格式。
自然语言按目标方向布局；来自业务的姓名、编号和 URL 分别隔离方向，并保留原值用于复制、搜索和导出。可访问名称表达用户看到的同一对象和结果，不能把隐藏的受限名称拼进读屏标签。复数与词序由完整消息资源选择，不能以中文片段拼装“全球通用”消息。缺翻译时回退到明确支持语言并标记待补，不显示资源键或空按钮。
FND-I02：输入、长度与动态语言切换
长度校验的单位必须由产品定义并与服务端一致。展示长度、字素数、Unicode 码点与字节不能互换；YUDS 不设统一 80 字符等业务限额。输入法组合期间不执行破坏性格式化、截断或最终校验；组合结束后按规则校验，错误保留用户原输入及可恢复路径。仅供显示的标点美化不得改变编号、命令、代码或复制原值。
切换界面语言不改变币种、统计时区、原始日期、权限或已提交状态；未提交草稿保留，当前对象 ID 与选择集合不变。当前焦点所在控件消失时转到同一任务中的等效入口并说明，不重新发起网络提交。系统区域偏好只影响已声明的显示规则，业务计算口径仍由产品负责。
| 文档夹具 | 输入与动作 | 正常预期 | 失败注入与判定 |
|---|---|---|---|
| I01 RTL 身份 | 阿拉伯语消息嵌入“CN-001/2026”及“−12.50 USD”；打开详情、复制编号 | 符号不串位；复制严格为原编号；读屏包含对象和币种 | 把控制字符写入业务原值或镜像数字：失败 |
| I02 复数与草稿 | 已选 0、1、2 份对象，切换目标语言；姓名处于组合输入 | 各语言完整消息成立；不丢选集与输入，不触发提交 | 按字符串片段拼接、不支持语言显示空按钮：失败 |
文档示例为输入夹具；是否支持这些语言由产品发布范围决定。真实翻译、输入法、读屏、RTL 排版与复制测试均未执行，不能因有夹具宣称支持。
用户输入内容的翻译建议与界面本地化分开：原文／译文、外部传输、接受／取消和权限竞态的唯一组合主节见 输入组件：文本、结构化编辑与专用输入 的「C1-TRANSLATE 用户输入翻译建议」。本节的语言资源规则不授权发送用户内容，也不证明翻译服务可用。
8. 正反例
合适
“将所选 12 份合同移入归档。归档后仍可在归档列表查看。”按钮写“归档 12 份合同”。前提是产品确有该行为与恢复入口。
不合适
“是否确认对所选数据执行处理？”按钮“是／否”，完成后显示“处理成功”。用户始终不知道改变了什么。
合适
“3 项未导入：2 项缺少合同编号，1 项币种不受支持。下载错误明细。”仅在权限和实际功能允许时提供明细。
不合适
“Oops！发生了些小问题。”同时丢掉输入和失败记录，迫使用户重新开始。
9. 内容验收
逐条检查文案是否准确回答对象、范围、状态、后果与下一步；不要求每句都包含全部要素，但整个任务路径必须明确。
- 用户可见文案不含未经解释的内部名称或生硬的机器直译。
- 保存、提交、撤回、取消、失败及未知结果没有混用。
- 高后果按钮与确认内容一致，部分成功明确计数和范围。
- 标签、错误、帮助在键盘和辅助技术中有关联且不重复干扰。
- 长翻译、复数、动态变量、RTL 与复制结果按拟支持范围验证。
- 受限场景的文案不泄露被保护对象或依据。
本章已有手册阅读词表，但尚未建立产品最终术语库或翻译资源；真实界面、辅助技术及本地化运行验收未执行。文中示例是候选表达，须按产品真实能力采用。