docs: refactor spec (#334)

* docs: update RICH head img * docs: Intention * docs: Role * docs: Conversation * docs: Hybrid UI
ant-design · Dec 10, 2024 · a6fb0b8 · a6fb0b8
1 parent 4dfe300
commit a6fb0b8
Show file tree

Hide file tree

Showing 48 changed files with 1,366 additions and 1,050 deletions.
diff --git a/docs/spec/authentic-consistent.en-US.md b/docs/spec/authentic-consistent.en-US.md
@@ -12,37 +12,10 @@ title: 真实一致
 
 为了增加角色的可信度和真实感，角色的视觉表达以及性格等特征需要在不同的场景中保持一致。具体来说，角色的行为模式和语言风格都应该符合我们对角色的基础背景设定。在与用户的互动中，不同的对话环境下，保持角色前后的一致性，避免用户产生跳出感，从而持续获得符合预期的互动体验。
 
-:::tips
-
-### 性格特征一致
-
-强调角色的内心世界和外在行为之间的一致性。行为、反应、决策和情感表达应与其性格描述相吻合，无论是平静的日常互动还是紧张的情节发展，角色性格特征都应保持一致，以增强角色的可信度和深度。
-
-:::
-
-:::tips
-
-### 视觉表达一致
-
-角色的外观设计、服装选择、动作表现和表情变化在不同场景和时间点上保持连贯和一致。这包括色彩、图形、姿态和风格等元素，确保角色形象的统一性，使观众能够轻松识别并记住角色。
-
-:::
-
-:::tips
-
-### 语言风格一致
-
-角色的说话方式、用词选择、语气和表达习惯应与其性格、背景和情感状态相匹配。无论是在正式场合还是非正式交流中，角色的语言表达都应保持一致，以增强角色的个性和真实感。
-
-:::
-
-:::tips
-
-### 行为模式一致
-
-在不同情境下的行为反应和处理方式具有连贯性和可预测性。角色的行为模式应与其性格特征、背景故事和当前情境相协调，确保角色在故事发展中的每一个决策和行动都显得合理和自然。
-
-:::
+- **性格特征一致** 强调角色的内心世界和外在行为之间的一致性。行为、反应、决策和情感表达应与其性格描述相吻合，无论是平静的日常互动还是紧张的情节发展，角色性格特征都应保持一致，以增强角色的可信度和深度。
+- **视觉表达一致** 角色的外观设计、服装选择、动作表现和表情变化在不同场景和时间点上保持连贯和一致。这包括色彩、图形、姿态和风格等元素，确保角色形象的统一性，使观众能够轻松识别并记住角色。
+- **语言风格一致** 角色的说话方式、用词选择、语气和表达习惯应与其性格、背景和情感状态相匹配。无论是在正式场合还是非正式交流中，角色的语言表达都应保持一致，以增强角色的个性和真实感。
+- **行为模式一致** 在不同情境下的行为反应和处理方式具有连贯性和可预测性。角色的行为模式应与其性格特征、背景故事和当前情境相协调，确保角色在故事发展中的每一个决策和行动都显得合理和自然。
 
 ## 适用场景
 
@@ -59,23 +32,14 @@ title: 真实一致
 
 ### 1、为角色赋予独特且符合其背景的性格特征、行为模式、语言风格
 
-**性格特征、行为模式、语言风格**的设定，都源于角色的故事背景。我们可以为角色设定详细而富有逻辑的角色背景，从而让用户感受到角色的深度和立体感。例如：
-
-- **基本属性：** 姓名、性别、年龄、昵称等。
-- **职业：** 如律师、医生、客服等。
-- **背景故事：** 出生环境、成长经历、教育经历、家庭情况等。
+**性格特征、行为模式、语言风格**的设定，都源于角色的故事背景，我们可以为角色设定详细而富有逻辑的角色背景，能让用户在了解角色时，感受到角色的深度和立体感。如一些“基本属性”，姓名、性别、年龄、昵称等，还可以为角色指定一个“职业”，如律师、医生、客服等，也可以为角色赋予一个背景故事，出生环境、成长经历、教育经历、家庭情况等。
 
 在背景故事的基础上，可以分别对**性格特征、行为模式、语言风格**进行更详细的剖析和设定，从而保证角色由内到外都有一致的体验。
 
 ![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*0MTlRYAWlCQAAAAAAAAAAAAADgCCAQ/fmt.webp)
 
 ### 2、为角色设计统一且符合其背景特征的形象和视觉表达
 
-为角色设计统一且符合其背景特征的形象，能让用户捕捉并强化对角色的符号记忆，形成统一的印象。可以从以下方面详细设计角色的外在形象：
-
-- **形象类型**
-- **外貌特征**
-- **声音音色**
-- **行为动作**
+为角色设计统一且符合其背景特征的形象，能让用户捕捉并强化对角色的符号记忆，形成统一的印象。可以从形象类型、外貌特征、声音音色和行为动作等方面，详细设计角色的外在形象。
 
 ![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*Ao8DSZhMfIAAAAAAAAAAAAAADgCCAQ/original)
diff --git a/docs/spec/authentic-consistent.zh-CN.md b/docs/spec/authentic-consistent.zh-CN.md
@@ -12,37 +12,10 @@ title: 真实一致
 
 为了增加角色的可信度和真实感，角色的视觉表达以及性格等特征需要在不同的场景中保持一致。具体来说，角色的行为模式和语言风格都应该符合我们对角色的基础背景设定。在与用户的互动中，不同的对话环境下，保持角色前后的一致性，避免用户产生跳出感，从而持续获得符合预期的互动体验。
 
-:::tips
-
-### 性格特征一致
-
-强调角色的内心世界和外在行为之间的一致性。行为、反应、决策和情感表达应与其性格描述相吻合，无论是平静的日常互动还是紧张的情节发展，角色性格特征都应保持一致，以增强角色的可信度和深度。
-
-:::
-
-:::tips
-
-### 视觉表达一致
-
-角色的外观设计、服装选择、动作表现和表情变化在不同场景和时间点上保持连贯和一致。这包括色彩、图形、姿态和风格等元素，确保角色形象的统一性，使观众能够轻松识别并记住角色。
-
-:::
-
-:::tips
-
-### 语言风格一致
-
-角色的说话方式、用词选择、语气和表达习惯应与其性格、背景和情感状态相匹配。无论是在正式场合还是非正式交流中，角色的语言表达都应保持一致，以增强角色的个性和真实感。
-
-:::
-
-:::tips
-
-### 行为模式一致
-
-在不同情境下的行为反应和处理方式具有连贯性和可预测性。角色的行为模式应与其性格特征、背景故事和当前情境相协调，确保角色在故事发展中的每一个决策和行动都显得合理和自然。
-
-:::
+- **性格特征一致** 强调角色的内心世界和外在行为之间的一致性。行为、反应、决策和情感表达应与其性格描述相吻合，无论是平静的日常互动还是紧张的情节发展，角色性格特征都应保持一致，以增强角色的可信度和深度。
+- **视觉表达一致** 角色的外观设计、服装选择、动作表现和表情变化在不同场景和时间点上保持连贯和一致。这包括色彩、图形、姿态和风格等元素，确保角色形象的统一性，使观众能够轻松识别并记住角色。
+- **语言风格一致** 角色的说话方式、用词选择、语气和表达习惯应与其性格、背景和情感状态相匹配。无论是在正式场合还是非正式交流中，角色的语言表达都应保持一致，以增强角色的个性和真实感。
+- **行为模式一致** 在不同情境下的行为反应和处理方式具有连贯性和可预测性。角色的行为模式应与其性格特征、背景故事和当前情境相协调，确保角色在故事发展中的每一个决策和行动都显得合理和自然。
 
 ## 适用场景
 
@@ -59,23 +32,14 @@ title: 真实一致
 
 ### 1、为角色赋予独特且符合其背景的性格特征、行为模式、语言风格
 
-**性格特征、行为模式、语言风格**的设定，都源于角色的故事背景。我们可以为角色设定详细而富有逻辑的角色背景，从而让用户感受到角色的深度和立体感。例如：
-
-- **基本属性：** 姓名、性别、年龄、昵称等。
-- **职业：** 如律师、医生、客服等。
-- **背景故事：** 出生环境、成长经历、教育经历、家庭情况等。
+**性格特征、行为模式、语言风格**的设定，都源于角色的故事背景，我们可以为角色设定详细而富有逻辑的角色背景，能让用户在了解角色时，感受到角色的深度和立体感。如一些“基本属性”，姓名、性别、年龄、昵称等，还可以为角色指定一个“职业”，如律师、医生、客服等，也可以为角色赋予一个背景故事，出生环境、成长经历、教育经历、家庭情况等。
 
 在背景故事的基础上，可以分别对**性格特征、行为模式、语言风格**进行更详细的剖析和设定，从而保证角色由内到外都有一致的体验。
 
 ![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*0MTlRYAWlCQAAAAAAAAAAAAADgCCAQ/fmt.webp)
 
 ### 2、为角色设计统一且符合其背景特征的形象和视觉表达
 
-为角色设计统一且符合其背景特征的形象，能让用户捕捉并强化对角色的符号记忆，形成统一的印象。可以从以下方面详细设计角色的外在形象：
-
-- **形象类型**
-- **外貌特征**
-- **声音音色**
-- **行为动作**
+为角色设计统一且符合其背景特征的形象，能让用户捕捉并强化对角色的符号记忆，形成统一的印象。可以从形象类型、外貌特征、声音音色和行为动作等方面，详细设计角色的外在形象。
 
 ![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*Ao8DSZhMfIAAAAAAAAAAAAAADgCCAQ/original)
diff --git a/docs/spec/confirm-generation-process.en-US.md b/docs/spec/confirm-generation-process.en-US.md
@@ -20,46 +20,60 @@ title: 确认｜生成过程
 
 ### 动画加载
 
-系统接收到用户请求后立即触发的状态反馈。轻量的动画效果既能让用户知道系统已开始处理，又不会带来视觉干扰。动画要即时触发、简洁克制，让用户感知到明确的响应。
+<ImagePreview>
+<img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*RR6eTbVD-tIAAAAAAAAAAAAADgCCAQ/fmt.webp">
+</ImagePreview>
 
-![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*w5T-R6Q2tM0AAAAAAAAAAAAADgCCAQ/fmt.webp)
+系统接收到用户请求后立即触发的状态反馈。轻量的动画效果既能让用户知道系统已开始处理，又不会带来视觉干扰。动画要即时触发、简洁克制，让用户感知到明确的响应。
 
 ### 流式输出
 
-AI 处理文本内容时的实时反馈形式。默认使用打字机光标效果，让用户能感知生成节奏；但在模型响应速度非常快时，应直接展示完整内容。保持输出内容的可读性，让用户能实时阅读已生成部分。
+<ImagePreview>
+<img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*w5T-R6Q2tM0AAAAAAAAAAAAADgCCAQ/fmt.webp">
+</ImagePreview>
 
-![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*w5T-R6Q2tM0AAAAAAAAAAAAADgCCAQ/fmt.webp)
+AI 处理文本内容时的实时反馈形式。默认使用打字机光标效果，让用户能感知生成节奏；但在模型响应速度非常快时，应直接展示完整内容。保持输出内容的可读性，让用户能实时阅读已生成部分。
 
 ### 进度展示
 
-用于异步生成场景下的状态反馈。通过进度百分比或处理阶段提示，展示当前任务进展。对于耗时较长的任务，提供预估完成时间，帮助用户建立等待预期。
+<ImagePreview>
+<img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*nbk_Q4EfmR0AAAAAAAAAAAAADgCCAQ/fmt.webp">
+</ImagePreview>
 
-![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*nbk_Q4EfmR0AAAAAAAAAAAAADgCCAQ/fmt.webp)
+用于异步生成场景下的状态反馈。通过进度百分比或处理阶段提示，展示当前任务进展。对于耗时较长的任务，提供预估完成时间，帮助用户建立等待预期。
 
 ## 异常状态展示
 
 ### 生成失败
 
-当请求处理失败时，及时展示失败原因和可采取的措施。失败提示要醒目但不刺激，文案简洁明确，并提供如重试等后续操作建议。
+<ImagePreview>
+<img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*jSdGT4NGzy0AAAAAAAAAAAAADgCCAQ/fmt.webp">
+</ImagePreview>
 
-![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*jSdGT4NGzy0AAAAAAAAAAAAADgCCAQ/fmt.webp)
+当请求处理失败时，及时展示失败原因和可采取的措施。失败提示要醒目但不刺激，文案简洁明确，并提供如重试等后续操作建议。
 
 ### 生成终止
 
-包括用户主动中断和系统自动终止的情况。终止后保留已生成内容，清晰提示当前状态。对于系统终止，需说明原因并给出建议。
+<ImagePreview>
+<img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*Ul_rR5Ix1XAAAAAAAAAAAAAADgCCAQ/fmt.webp">
+</ImagePreview>
 
-![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*Ul_rR5Ix1XAAAAAAAAAAAAAADgCCAQ/fmt.webp)
+包括用户主动中断和系统自动终止的情况。终止后保留已生成内容，清晰提示当前状态。对于系统终止，需说明原因并给出建议。
 
 ## 思考过程展现
 
 ### 展示思考阶段
 
-方便用户理解 AI 的处理流程和进展。在耗时较长的场景（如深度搜索），展示完整的处理步骤；耗时较短时仅展示当前思考状态。
+<ImagePreview>
+<img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*QOdOQpy-io8AAAAAAAAAAAAADgCCAQ/fmt.webp">
+</ImagePreview>
 
-![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*QOdOQpy-io8AAAAAAAAAAAAADgCCAQ/fmt.webp)
+方便用户理解 AI 的处理流程和进展。在耗时较长的场景（如深度搜索），展示完整的处理步骤；耗时较短时仅展示当前思考状态。
 
 ### 展示思考细节
 
-通过可展开/收起的形式呈现 AI 推理的具体步骤和依据。在设计时需要满足用户查看决策过程细节，同时避免信息过载。
+<ImagePreview>
+<img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*DtBxSYxd7WcAAAAAAAAAAAAADgCCAQ/fmt.webp">
+</ImagePreview>
 
-![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*DtBxSYxd7WcAAAAAAAAAAAAADgCCAQ/fmt.webp)
+通过可展开/收起的形式呈现 AI 推理的具体步骤和依据。在设计时需要满足用户查看决策过程细节，同时避免信息过载。
diff --git a/docs/spec/confirm-generation-process.zh-CN.md b/docs/spec/confirm-generation-process.zh-CN.md
@@ -20,46 +20,60 @@ title: 确认｜生成过程
 
 ### 动画加载
 
-系统接收到用户请求后立即触发的状态反馈。轻量的动画效果既能让用户知道系统已开始处理，又不会带来视觉干扰。动画要即时触发、简洁克制，让用户感知到明确的响应。
+<ImagePreview>
+<img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*RR6eTbVD-tIAAAAAAAAAAAAADgCCAQ/fmt.webp">
+</ImagePreview>
 
-![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*w5T-R6Q2tM0AAAAAAAAAAAAADgCCAQ/fmt.webp)
+系统接收到用户请求后立即触发的状态反馈。轻量的动画效果既能让用户知道系统已开始处理，又不会带来视觉干扰。动画要即时触发、简洁克制，让用户感知到明确的响应。
 
 ### 流式输出
 
-AI 处理文本内容时的实时反馈形式。默认使用打字机光标效果，让用户能感知生成节奏；但在模型响应速度非常快时，应直接展示完整内容。保持输出内容的可读性，让用户能实时阅读已生成部分。
+<ImagePreview>
+<img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*w5T-R6Q2tM0AAAAAAAAAAAAADgCCAQ/fmt.webp">
+</ImagePreview>
 
-![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*w5T-R6Q2tM0AAAAAAAAAAAAADgCCAQ/fmt.webp)
+AI 处理文本内容时的实时反馈形式。默认使用打字机光标效果，让用户能感知生成节奏；但在模型响应速度非常快时，应直接展示完整内容。保持输出内容的可读性，让用户能实时阅读已生成部分。
 
 ### 进度展示
 
-用于异步生成场景下的状态反馈。通过进度百分比或处理阶段提示，展示当前任务进展。对于耗时较长的任务，提供预估完成时间，帮助用户建立等待预期。
+<ImagePreview>
+<img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*nbk_Q4EfmR0AAAAAAAAAAAAADgCCAQ/fmt.webp">
+</ImagePreview>
 
-![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*nbk_Q4EfmR0AAAAAAAAAAAAADgCCAQ/fmt.webp)
+用于异步生成场景下的状态反馈。通过进度百分比或处理阶段提示，展示当前任务进展。对于耗时较长的任务，提供预估完成时间，帮助用户建立等待预期。
 
 ## 异常状态展示
 
 ### 生成失败
 
-当请求处理失败时，及时展示失败原因和可采取的措施。失败提示要醒目但不刺激，文案简洁明确，并提供如重试等后续操作建议。
+<ImagePreview>
+<img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*jSdGT4NGzy0AAAAAAAAAAAAADgCCAQ/fmt.webp">
+</ImagePreview>
 
-![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*jSdGT4NGzy0AAAAAAAAAAAAADgCCAQ/fmt.webp)
+当请求处理失败时，及时展示失败原因和可采取的措施。失败提示要醒目但不刺激，文案简洁明确，并提供如重试等后续操作建议。
 
 ### 生成终止
 
-包括用户主动中断和系统自动终止的情况。终止后保留已生成内容，清晰提示当前状态。对于系统终止，需说明原因并给出建议。
+<ImagePreview>
+<img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*Ul_rR5Ix1XAAAAAAAAAAAAAADgCCAQ/fmt.webp">
+</ImagePreview>
 
-![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*Ul_rR5Ix1XAAAAAAAAAAAAAADgCCAQ/fmt.webp)
+包括用户主动中断和系统自动终止的情况。终止后保留已生成内容，清晰提示当前状态。对于系统终止，需说明原因并给出建议。
 
 ## 思考过程展现
 
 ### 展示思考阶段
 
-方便用户理解 AI 的处理流程和进展。在耗时较长的场景（如深度搜索），展示完整的处理步骤；耗时较短时仅展示当前思考状态。
+<ImagePreview>
+<img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*QOdOQpy-io8AAAAAAAAAAAAADgCCAQ/fmt.webp">
+</ImagePreview>
 
-![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*QOdOQpy-io8AAAAAAAAAAAAADgCCAQ/fmt.webp)
+方便用户理解 AI 的处理流程和进展。在耗时较长的场景（如深度搜索），展示完整的处理步骤；耗时较短时仅展示当前思考状态。
 
 ### 展示思考细节
 
-通过可展开/收起的形式呈现 AI 推理的具体步骤和依据。在设计时需要满足用户查看决策过程细节，同时避免信息过载。
+<ImagePreview>
+<img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*DtBxSYxd7WcAAAAAAAAAAAAADgCCAQ/fmt.webp">
+</ImagePreview>
 
-![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*DtBxSYxd7WcAAAAAAAAAAAAADgCCAQ/fmt.webp)
+通过可展开/收起的形式呈现 AI 推理的具体步骤和依据。在设计时需要满足用户查看决策过程细节，同时避免信息过载。