Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: refactor spec #334

Merged
merged 6 commits into from
Dec 10, 2024
Merged

docs: refactor spec #334

merged 6 commits into from
Dec 10, 2024

Conversation

YumoImer
Copy link
Collaborator

@YumoImer YumoImer commented Dec 10, 2024

Summary by CodeRabbit

  • 新特性

    • 更新了多个文档的标题和顺序,以提高可读性和结构。
    • 增加了图像预览,增强了用户交互的视觉体验。
    • 扩展了关于角色设计、意图设计和欢迎提示组件的描述,强调用户体验的重要性。
  • 文档改进

    • 多处内容进行了重组和精简,以提高理解和流畅性。
    • 细化了与AI交互的场景示例,提供了更清晰的指导和说明。

Copy link
Contributor

coderabbitai bot commented Dec 10, 2024

📝 Walkthrough

Walkthrough

此次拉取请求对多个文档进行了结构和内容上的修改,主要集中在增强角色设计原则、用户交互和错误处理的清晰度与一致性。文档标题、顺序和部分内容进行了更新,增加了图像预览以改善视觉呈现,并对相关内容进行了重组,确保信息传达更加流畅和易于理解。

Changes

文件路径 更改摘要
docs/spec/authentic-consistent.en-US.md 更新标题为“🎭 Role 角色设计”,顺序改为2,增加了多个章节标题,删除了提示格式,改为加粗标题,优化了角色一致性的定义和适用场景的描述。
docs/spec/authentic-consistent.zh-CN.md 更新标题为“真实一致”,顺序改为1,优化了角色一致性相关内容的格式,增加了清晰的描述和结构。
docs/spec/confirm-generation-process.en-US.md 更新标题,顺序改为5,多个部分添加了图像预览以增强用户理解,保留了文本描述。
docs/spec/confirm-generation-process.zh-CN.md 添加图像预览以改进视觉呈现,内容结构进行了调整,确保信息传达一致。
docs/spec/confirm.en-US.md 更新标题为“确认”,顺序改为4,增加了关于确认类型的详细描述,添加了图像以支持内容。
docs/spec/confirm.zh-CN.md 内容进行了扩展,增加了图像预览,详细描述了确认类型和用户交互的相关内容。
docs/spec/conversation-design.en-US.md 进行了语法调整和清晰度提升,确保内容更易读。
docs/spec/conversation-design.zh-CN.md 进行了文本结构调整和语法修正,提升了可读性。
docs/spec/define-intention-type.en-US.md 重新组织了意图分类的描述,提升了内容清晰度。
docs/spec/define-intention-type.zh-CN.md 进行了文本修改以增强一致性和可读性。
docs/spec/end.en-US.md 更新标题为“💭 Conversation 会话设计”,顺序改为6,添加了图像预览,优化了内容结构。
docs/spec/end.zh-CN.md 更新标题和顺序,增加了图像预览以提升视觉效果,内容进行了重组。
docs/spec/error.en-US.md 更新标题为“💭 Conversation 会话设计”,顺序改为5,扩展了错误处理的类型和解决方案。
docs/spec/error.zh-CN.md 更新标题,内容进行了扩展,强调了错误处理的策略和用户指导。
docs/spec/expression-user-input.en-US.md 更新标题为“表达|用户输入”,顺序改为3,添加了图像预览以增强视觉呈现。
docs/spec/expression-user-input.zh-CN.md 更新标题和顺序,增加了图像预览以支持文本描述。
docs/spec/expression-user-send.en-US.md 添加了图像预览以改善用户发送内容的可视化表示。
docs/spec/expression-user-send.zh-CN.md 增强了用户发送内容的视觉展示,添加了图像预览。
docs/spec/feedback-result-application.en-US.md 更新标题为“反馈|结果应用”,增加了图像预览以增强功能展示。
docs/spec/feedback-result-application.zh-CN.md 更新标题和顺序,增加了图像预览以支持内容描述。
docs/spec/feedback-result-display.en-US.md 更新标题为“结果展示”,顺序改为8,添加了图像预览以标准化展示方式。
docs/spec/feedback-result-display.zh-CN.md 更新标题和顺序,增加了图像预览以增强视觉一致性。
docs/spec/follow-up.en-US.md 更新标题为“💭 Conversation 会话设计”,顺序改为2,内容进行了优化以提高可读性。
docs/spec/follow-up.zh-CN.md 更新标题和顺序,内容进行了调整以增强清晰度。
docs/spec/guide-intention-expression.en-US.md 更新标题为“❤️ Intention 意图设计”,顺序改为3,内容进行了语法和结构上的优化。
docs/spec/guide-intention-expression.zh-CN.md 更新标题和顺序,进行了文本修正以提升可读性。
docs/spec/hint.en-US.md 更新标题为“提示”,添加了图像预览以增强视觉效果,内容进行了组织和优化。
docs/spec/hint.zh-CN.md 更新标题,内容进行了调整以提升结构和可读性。
docs/spec/human-touch.en-US.md 更新标题为“有情感”,顺序改为3,内容进行了结构和语言上的优化。
docs/spec/human-touch.zh-CN.md 更新标题为“有情感的设计”,内容进行了重组和语言优化。
docs/spec/hybrid-ui-design.en-US.md 更新内容以增强对Hybrid UI概念的理解,提供了更详细的用户行为变化描述。
docs/spec/hybrid-ui-design.zh-CN.md 更新内容以提升对Hybrid UI概念的理解,强调设计师在UI设计中的角色。
docs/spec/intention-introduce.en-US.md 进行了文本修改以提高可读性,优化了意图设计的介绍部分。
docs/spec/intention-introduce.zh-CN.md 更新标题和内容以增强清晰度和可读性。
docs/spec/introduce.en-US.md 更新内容以反映RICH设计范式的演变,增强了对人机交互的理解。
docs/spec/introduce.zh-CN.md 更新内容以增强对RICH设计范式的理解,强调其在AI产品设计中的重要性。
docs/spec/provide-intention-expectation.en-US.md 更新标题为“提供意图预期”,内容进行了优化以增强清晰度。
docs/spec/provide-intention-expectation.zh-CN.md 更新标题和内容以提升流畅性和可读性。
docs/spec/role-design.en-US.md 进行了文本重组以提高可读性,优化了角色设计的描述。
docs/spec/role-design.zh-CN.md 更新内容以增强角色设计的清晰度和一致性。
docs/spec/smooth-natural.en-US.md 更新内容以增强对自然交互原则的描述,提升了可读性。
docs/spec/smooth-natural.zh-CN.md 更新内容以增强对自然交互原则的理解,提供了更多示例。
docs/spec/start.en-US.md 更新内容以提升用户体验,优化了问候语的结构。
docs/spec/start.zh-CN.md 更新内容以增强用户体验,优化了问候语的表达。
docs/spec/wake-up-ai-icon.en-US.md 更新标题为“唤醒|AI 标识”,内容进行了优化以增强用户理解。
docs/spec/wake-up-ai-icon.zh-CN.md 更新标题和内容以提升对AI标识的理解。
docs/spec/wake-up-welcome-message.en-US.md 更新标题为“唤醒|欢迎提示”,内容进行了重组以提升用户体验。
docs/spec/wake-up-welcome-message.zh-CN.md 更新标题和内容以增强用户体验和理解。

Possibly related PRs

  • chore: update doc img #246: 此PR涉及对docs/spec/authentic-consistent.en-US.mddocs/spec/authentic-consistent.zh-CN.md文件的更新,直接与主PR的角色设计原则一致性相关。
  • docs: Improve document syntax #331: 此PR更新了XProvider组件的文档,尽管与角色设计无直接关系,但有助于提升AI应用中的用户体验,符合主PR的目标。

Poem

在兔子洞里欢快跳,
新文档如花般绽放,
角色一致更清晰,
用户体验更美好。
感谢每一份努力,
AI世界更精彩! 🐇✨


Thank you for using CodeRabbit. We offer it for free to the OSS community and would appreciate your support in helping us grow. If you find it useful, would you consider giving us a shout-out on your favorite social media?

❤️ Share
🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Generate unit testing code for this file.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
    • @coderabbitai generate unit testing code for this file.
    • @coderabbitai modularize this function.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read src/utils.ts and generate unit testing code.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
    • @coderabbitai help me debug CodeRabbit configuration file.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (Invoked using PR comments)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai full review to do a full review from scratch and review all the files again.
  • @coderabbitai summary to regenerate the summary of the PR.
  • @coderabbitai generate docstrings to generate docstrings for this PR. (Experiment)
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
  • @coderabbitai help to get help.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Documentation and Community

  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

Copy link

github-actions bot commented Dec 10, 2024

Preview is ready

@YumoImer YumoImer requested a review from a team December 10, 2024 17:11
Copy link

codecov bot commented Dec 10, 2024

Bundle Report

Bundle size has no change ✅

Copy link

codecov bot commented Dec 10, 2024

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 91.36%. Comparing base (4dfe300) to head (fef5f45).

Additional details and impacted files
@@           Coverage Diff           @@
##             main     #334   +/-   ##
=======================================
  Coverage   91.36%   91.36%           
=======================================
  Files          66       66           
  Lines        1447     1447           
  Branches      368      382   +14     
=======================================
  Hits         1322     1322           
  Misses        125      125           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 16

🧹 Outside diff range and nitpick comments (58)
docs/spec/provide-intention-expectation.en-US.md (1)

9-9: 建议为图片添加替代文本

为了提高文档的可访问性,建议为图片添加描述性的 alt 文本。

-![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*X2-8QrjSVdEAAAAAAAAAAAAADgCCAQ/fmt.webp)
+![AI意图设计示意图](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*X2-8QrjSVdEAAAAAAAAAAAAADgCCAQ/fmt.webp)
🧰 Tools
🪛 Markdownlint (0.35.0)

9-9: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/start.zh-CN.md (2)

13-13: 建议修正语言用法

在"设定正确的期望"这个短语中,建议按照中文语法规范修改。

-首要任务是迅速设定正确的期望
+首要任务是迅速设定正确地期望
🧰 Tools
🪛 LanguageTool

[uncategorized] ~13-~13: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:正确"地"期望
Context: ...I 能为他们做些什么,而不是给他们一种正在接受教程的感觉。首要任务是迅速设定正确的期望,引导用户发现 AI 的功能,并将对话的主动权交还给用户。 ## HOW ...

(wb4)


19-21: 建议完善图片预览组件的可访问性

ImagePreview 组件中的图片缺少替代文本,建议添加以提高可访问性。

<ImagePreview>
-<img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*MOx0TraEUzoAAAAAAAAAAAAADgCCAQ/fmt.webp">
+<img class="preview-img no-padding" alt="AI交互核心目标示意图" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*MOx0TraEUzoAAAAAAAAAAAAADgCCAQ/fmt.webp">
</ImagePreview>
🧰 Tools
🪛 Markdownlint (0.35.0)

20-20: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/start.en-US.md (1)

19-21: 建议为英文版本的图片添加英文替代文本

为确保国际化文档的可访问性,建议为英文版本的图片添加英文替代文本。

<ImagePreview>
-<img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*MOx0TraEUzoAAAAAAAAAAAAADgCCAQ/fmt.webp">
+<img class="preview-img no-padding" alt="AI Interaction Core Goals Diagram" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*MOx0TraEUzoAAAAAAAAAAAAADgCCAQ/fmt.webp">
</ImagePreview>
🧰 Tools
🪛 Markdownlint (0.35.0)

20-20: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/guide-intention-expression.en-US.md (2)

8-8: 需要为图片添加 alt 文本以提高可访问性

建议为所有图片添加描述性的替代文本,这样可以:

  • 帮助使用屏幕阅读器的用户理解图片内容
  • 当图片加载失败时提供备用显示内容
  • 提高文档的 SEO 友好度

示例修改如下:

- ![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*pNdBQ6XZy0YAAAAAAAAAAAAADgCCAQ/fmt.webp)
+ ![意图表达示意图](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*pNdBQ6XZy0YAAAAAAAAAAAAADgCCAQ/fmt.webp)

Also applies to: 15-15, 27-27, 34-34


13-13: 建议修正语言表达中的语法问题

根据中文语法规则,动词的修饰语应使用"地"而不是"的":

- 准确的引导
+ 准确地引导
- 自然的引导
+ 自然地引导
- 具体的会话
+ 具体地会话

Also applies to: 25-25

🧰 Tools
🪛 LanguageTool

[uncategorized] ~13-~13: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:自然"地"引导
Context: ...位。为了准确的引导用户将这些关键信息表达清楚,我们需要在交互过程中有意识的、自然的引导用户进行对应信息的表达。 ![](https://mdn.alipayob...

(wb4)

docs/spec/define-intention-type.en-US.md (1)

13-13: 建议优化用词选择

在描述目标实现时,建议使用更准确的措辞:

- 通过简单的操作即可完成用户的目标
+ 通过简单的操作即可实现用户的目标
🧰 Tools
🪛 LanguageTool

[uncategorized] ~13-~13: 与‘目标’‘理想’搭配的动词不应该是‘完成’,您可以使用‘"实现"’与之搭配。
Context: ...,通过对话的方式,能更加高效洞察与满足意图;而意图清晰的用户,通过简单的操作即可完成用户的目标,例如点击按钮或者图标等。 - **从用户与系统间交互目的,可分为咨询...

(s32)

docs/spec/define-intention-type.zh-CN.md (2)

Line range hint 1-24: 需要为所有图片添加替代文本以提高可访问性

为了确保文档对所有用户都是可访问的,包括使用屏幕阅读器的用户,建议为所有图片添加有意义的替代文本(alt text)。

示例修改:

- ![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*Hl54SK43ZcEAAAAAAAAAAAAADgCCAQ/fmt.webp)
+ ![意图设计概览图](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*Hl54SK43ZcEAAAAAAAAAAAAADgCCAQ/fmt.webp)
🧰 Tools
🪛 LanguageTool

[uncategorized] ~13-~13: 与‘目标’‘理想’搭配的动词不应该是‘完成’,您可以使用‘"实现"’与之搭配。
Context: ...,通过对话的方式,能更加高效洞察与满足意图;而意图清晰的用户,通过简单的操作即可完成用户的目标,例如点击按钮或者图标等。 - **从用户与系统间交互目的,可分为咨询...

(s32)

🪛 Markdownlint (0.35.0)

9-9: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


18-18: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


26-26: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


13-14: 建议优化表述方式,提高文档可读性

当前的表述有些冗长,建议精简和重组句子结构以提高可读性。

建议修改为:

- 从用户意图清晰度,可分为意图清晰与意图模糊。通常来说意图模糊,通过对话的方式,能更加高效洞察与满足意图;而意图清晰的用户,通过简单的操作即可完成用户的目标,例如点击按钮或者图标等。
+ 从用户意图清晰度来看,可分为:
+ - 意图清晰:用户可通过简单的界面操作(如点击按钮、图标)实现目标
+ - 意图模糊:通过对话方式更能高效地理解和满足用户需求
🧰 Tools
🪛 LanguageTool

[uncategorized] ~13-~13: 与‘目标’‘理想’搭配的动词不应该是‘完成’,您可以使用‘"实现"’与之搭配。
Context: ...,通过对话的方式,能更加高效洞察与满足意图;而意图清晰的用户,通过简单的操作即可完成用户的目标,例如点击按钮或者图标等。 - **从用户与系统间交互目的,可分为咨询...

(s32)

docs/spec/intention-introduce.en-US.md (2)

11-11: 建议优化开篇段落的表述

当前段落略显冗长,可以通过调整句式使表达更加清晰。

建议修改为:

- 在简介篇中我们提到在蚂蚁内部 AI 产品实践中,经常冒出诸多的体验困惑,其中最关键的都聚焦在设计的「模糊前期」,比如:什么时候应该使用会话的方式?如何让 AI 理解用户的意图?等等。
+ 在蚂蚁内部的 AI 产品实践中,我们发现最关键的体验困惑往往出现在设计的「模糊前期」,主要包括:
+ - 何时应该使用会话方式?
+ - 如何让 AI 准确理解用户意图?

23-23: 建议修改用词,提高准确性

根据语言工具的建议,"完成目标"的表述可以更准确。

建议修改为:

- 它能帮助 AI 更准确地回应用户需求,更高效完成用户目标。
+ 它能帮助 AI 更准确地回应用户需求,更高效地实现用户目标。
🧰 Tools
🪛 LanguageTool

[uncategorized] ~23-~23: 与‘目标’‘理想’搭配的动词不应该是‘完成’,您可以使用‘"实现"’与之搭配。
Context: ...因此,准确识别这些隐含意图至关重要。它能帮助 AI 更准确地回应用户需求,更高效完成用户目标。 ![](https://mdn.alipayobjects.com...

(s32)

docs/spec/intention-introduce.zh-CN.md (2)

27-29: 建议优化段落结构,增强可读性

当前段落包含多个重要观点,建议通过结构化呈现使内容更易理解。

建议修改为:

- 换句话说用户目标的实现已从 GUI 时代的繁琐界面操作转变为 AGI 时代 AI 对复杂意图的理解。这大大降低了用户的学习成本,提升了产品体验。然而我们在蚂蚁内部的AI实践中发现,并非所有意图都适合会话式交互,有时简单点击在某些场景下比多轮对话更为高效。
+ 从 GUI 到 AGI 时代的转变带来了以下变化:
+ 1. 用户目标实现方式:从繁琐的界面操作转向 AI 对复杂意图的理解
+ 2. 用户体验提升:降低了学习成本,提升了产品体验
+ 
+ 然而,我们的实践表明:并非所有场景都适合会话式交互,某些情况下,简单的点击操作反而更高效。

Line range hint 1-39: 需要统一添加图片替代文本

所有图片都缺少替代文本(alt text),这影响了文档的可访问性。

建议为所有图片添加描述性的替代文本,例如:

- ![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*DY3oSowUuI8AAAAAAAAAAAAADgCCAQ/fmt.webp)
+ ![意图设计介绍概览图](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*DY3oSowUuI8AAAAAAAAAAAAADgCCAQ/fmt.webp)
🧰 Tools
🪛 Markdownlint (0.35.0)

9-9: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


19-19: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


25-25: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


31-31: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


33-33: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


39-39: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

🪛 LanguageTool

[uncategorized] ~23-~23: 与‘目标’‘理想’搭配的动词不应该是‘完成’,您可以使用‘"实现"’与之搭配。
Context: ...因此,准确识别这些隐含意图至关重要。它能帮助 AI 更准确地回应用户需求,更高效完成用户目标。 ![](https://mdn.alipayobjects.com...

(s32)

docs/spec/smooth-natural.en-US.md (3)

13-13: 语法建议:助词使用需要调整

根据中文语法规则,建议进行以下修改:

  1. "语言表达的自然流畅" 改为 "语言表达得自然流畅"
  2. "生硬的表达" 改为 "生硬地表达"
🧰 Tools
🪛 LanguageTool

[uncategorized] ~13-~13: 1.动词被副词修饰时,助词应该用‘得’;2.省略宾语时,助词应该用‘的’;可能造成歧义。您的意思是不是:表达"得"自然流畅
Context: ... 如何定义 角色在与用户互动时展现出人类交流的流畅性和真实性。这涉及到语言表达的自然流畅,使用贴近人类日常对话的词汇和语法,避免机械和生硬的表达。同时,角色的行...

(wb4)


[uncategorized] ~13-~13: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:生硬"地"表达
Context: ...性。这涉及到语言表达的自然流畅,使用贴近人类日常对话的词汇和语法,避免机械和生硬的表达。同时,角色的行为反应也应自然合理,能够根据用户的输入做出恰当的、符合情境的...

(wb4)


24-27: 建议:标点符号使用不一致

部分条目末尾缺少句号,建议统一添加句号以保持格式一致。

- - **智能助手与语音交互:** 集成到智能音箱和手机应用中的AI Agent,需要能够通过语音命令进行交互,这要求Agent能够理解和处理自然语言语音指令
+ - **智能助手与语音交互:** 集成到智能音箱和手机应用中的AI Agent,需要能够通过语音命令进行交互,这要求Agent能够理解和处理自然语言语音指令。

Line range hint 1-43: 建议:为图片添加替代文本

为了提高文档的可访问性,建议为所有图片添加描述性的替代文本。

- ![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*_efXTZnDktkAAAAAAAAAAAAADgCCAQ/fmt.webp)
+ ![自然交互原则概览图](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*_efXTZnDktkAAAAAAAAAAAAADgCCAQ/fmt.webp)
🧰 Tools
🪛 Markdownlint (0.35.0)

37-37: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


43-43: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

🪛 LanguageTool

[uncategorized] ~13-~13: 1.动词被副词修饰时,助词应该用‘得’;2.省略宾语时,助词应该用‘的’;可能造成歧义。您的意思是不是:表达"得"自然流畅
Context: ... 如何定义 角色在与用户互动时展现出人类交流的流畅性和真实性。这涉及到语言表达的自然流畅,使用贴近人类日常对话的词汇和语法,避免机械和生硬的表达。同时,角色的行...

(wb4)


[uncategorized] ~13-~13: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:生硬"地"表达
Context: ...性。这涉及到语言表达的自然流畅,使用贴近人类日常对话的词汇和语法,避免机械和生硬的表达。同时,角色的行为反应也应自然合理,能够根据用户的输入做出恰当的、符合情境的...

(wb4)

docs/spec/hint.en-US.md (3)

21-23: 建议:ImagePreview 组件需要添加 alt 属性

为了提高可访问性,建议在 ImagePreview 组件中的图片标签添加 alt 属性。

<ImagePreview>
- <img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*XqX4TYFQhUcAAAAAAAAAAAAADgCCAQ/fmt.webp">
+ <img class="preview-img no-padding" alt="避免固定指令示例" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*XqX4TYFQhUcAAAAAAAAAAAAADgCCAQ/fmt.webp">
</ImagePreview>
🧰 Tools
🪛 Markdownlint (0.35.0)

22-22: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


15-15: 建议:优化段落结构

这段文字较长,建议适当分段以提高可读性。可以在介绍核心优势后添加段落分隔。


41-41: 建议:调整表述方式

"生硬的关键词短语" 的表述可以更加自然,建议修改为 "机械化的关键词短语" 或 "固定的关键词短语"。

docs/spec/hint.zh-CN.md (3)

21-23: 建议为图片添加替代文本以提高可访问性

为了确保文档对所有用户都是可访问的,建议为所有图片添加描述性的替代文本。这对使用屏幕阅读器的用户尤其重要。

- <img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*XqX4TYFQhUcAAAAAAAAAAAAADgCCAQ/fmt.webp">
+ <img class="preview-img no-padding" alt="不要让用户发出固定指令的示例图" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*XqX4TYFQhUcAAAAAAAAAAAAADgCCAQ/fmt.webp">
🧰 Tools
🪛 Markdownlint (0.35.0)

22-22: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


37-39: 统一使用 ImagePreview 组件

为保持文档的一致性,建议统一使用 ImagePreview 组件来展示图片,并添加适当的替代文本。

<ImagePreview>
- <img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*VeYtSZONca4AAAAAAAAAAAAADgCCAQ/fmt.webp">
+ <img class="preview-img no-padding" alt="给提示而不是命令的示例图" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*VeYtSZONca4AAAAAAAAAAAAADgCCAQ/fmt.webp">
</ImagePreview>
🧰 Tools
🪛 Markdownlint (0.35.0)

38-38: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


49-51: 补充图片说明文本

建议为未找到匹配项的示例图添加清晰的替代文本,以帮助用户理解图片内容。

<ImagePreview>
- <img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*GJCKQ4nRYdIAAAAAAAAAAAAADgCCAQ/fmt.webp">
+ <img class="preview-img no-padding" alt="未找到匹配项时的建议示例" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*GJCKQ4nRYdIAAAAAAAAAAAAADgCCAQ/fmt.webp">
</ImagePreview>
🧰 Tools
🪛 Markdownlint (0.35.0)

50-50: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/authentic-consistent.zh-CN.md (2)

15-18: 优化列表格式和内容展示

建议在每个要点之间添加适当的空行,以提高可读性。同时,建议统一列表项的句式结构。

- - **性格特征一致** 强调角色的内心世界和外在行为之间的一致性。行为、反应、决策和情感表达应与其性格描述相吻合,无论是平静的日常互动还是紧张的情节发展,角色性格特征都应保持一致,以增强角色的可信度和深度。
- - **视觉表达一致** 角色的外观设计、服装选择、动作表现和表情变化在不同场景和时间点上保持连贯和一致。这包括色彩、图形、姿态和风格等元素,确保角色形象的统一性,使观众能够轻松识别并记住角色。

+ - **性格特征一致:** 强调角色的内心世界和外在行为之间的一致性。行为、反应、决策和情感表达应与其性格描述相吻合,无论是平静的日常互动还是紧张的情节发展,角色性格特征都应保持一致,以增强角色的可信度和深度。

+ - **视觉表达一致:** 角色的外观设计、服装选择、动作表现和表情变化在不同场景和时间点上保持连贯和一致。这包括色彩、图形、姿态和风格等元素,确保角色形象的统一性,使观众能够轻松识别并记住角色。

43-45: 补充图片无障碍支持

为了提高文档的可访问性,建议为图片添加合适的替代文本描述。

- ![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*Ao8DSZhMfIAAAAAAAAAAAAAADgCCAQ/original)
+ ![角色形象设计示例](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*Ao8DSZhMfIAAAAAAAAAAAAAADgCCAQ/original)
🧰 Tools
🪛 Markdownlint (0.35.0)

45-45: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/authentic-consistent.en-US.md (1)

Line range hint 1-45: 检查英文文档内容

当前文件内容与中文版本完全相同。建议更新为对应的英文翻译版本,以便英语用户阅读和理解。

🧰 Tools
🪛 Markdownlint (0.35.0)

39-39: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


45-45: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/role-design.en-US.md (1)

8-8: 建议为所有图片添加替代文本(alt text)以提高可访问性

为了确保文档对使用屏幕阅读器的用户友好,建议为所有图片添加描述性的替代文本。

示例修改格式:

-![](https://mdn.alipayobjects.com/...)
+![角色设计概览图](https://mdn.alipayobjects.com/...)

Also applies to: 19-19, 23-23, 29-29, 35-35, 41-41, 47-47, 55-55

docs/spec/follow-up.zh-CN.md (3)

13-13: 建议优化用词表达

建议将"完成既定的任务目标"修改为"实现既定的任务目标",以符合中文表达习惯。

-若用户所提供的信息不足以支撑 AI 完成既定的任务目标
+若用户所提供的信息不足以支撑 AI 实现既定的任务目标
🧰 Tools
🪛 LanguageTool

[uncategorized] ~13-~13: 与‘目标’‘理想’搭配的动词不应该是‘完成’,您可以使用‘"实现"’与之搭配。
Context: ...WHAT 概述 在 AI 对话交互过程中,若用户所提供的信息不足以支撑 AI 完成既定的任务目标,AI 必须采取主动措施,通过精心设计的询问来引导用户提供额外的槽...

(s32)


19-19: 建议修正语法表达

建议将"具体的询问"修改为"具体地询问",以符合中文副词修饰动词的语法规则。

-AI 应构建清晰、具体的询问
+AI 应构建清晰、具体地询问
🧰 Tools
🪛 LanguageTool

[uncategorized] ~19-~19: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:具体"地"询问
Context: ...。 2. 构建有效询问: 基于识别出的信息缺口,AI 应构建清晰、具体的询问,直接引导用户补充所需信息。 3. 保持对话连贯性: 在请求额外信...

(wb4)


25-27: 建议统一图片展示组件的使用方式

文档中部分图片使用了 <ImagePreview> 组件包装,而其他图片则直接使用 Markdown 语法。建议统一使用 <ImagePreview> 组件来展示图片,以保持一致的视觉体验。

Also applies to: 37-39, 49-51, 66-68

🧰 Tools
🪛 Markdownlint (0.35.0)

26-26: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/follow-up.en-US.md (1)

13-13: 优化语言表述

建议将"完成"改为"实现",使表述更加准确。

- 若用户所提供的信息不足以支撑 AI 完成既定的任务目标
+ 若用户所提供的信息不足以支撑 AI 实现既定的任务目标
🧰 Tools
🪛 LanguageTool

[uncategorized] ~13-~13: 与‘目标’‘理想’搭配的动词不应该是‘完成’,您可以使用‘"实现"’与之搭配。
Context: ...WHAT 概述 在 AI 对话交互过程中,若用户所提供的信息不足以支撑 AI 完成既定的任务目标,AI 必须采取主动措施,通过精心设计的询问来引导用户提供额外的槽...

(s32)

docs/spec/feedback-result-application.zh-CN.md (1)

73-73: 移除多余的空行标签

建议移除末尾不必要的 <br/> 标签。

- <br/>
docs/spec/feedback-result-application.en-US.md (1)

Line range hint 1-73: 需要将内容翻译为英文

当前文件虽然是英文版本(.en-US.md),但内容仍为中文。建议将所有内容翻译成英文,以确保国际用户可以正确理解文档内容。

需要我协助进行内容翻译吗?我可以帮助生成英文版本的内容。

🧰 Tools
🪛 LanguageTool

[uncategorized] ~35-~35: 您的意思是""过度"体验"?
Context: ...生成请求,支持多个版本结果的切换对比。新生成的内容要在界面中平滑切换,保持良好的过渡体验。 ### 反馈 <img class="...

(DU3_DU4)

🪛 Markdownlint (0.35.0)

24-24: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


32-32: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


40-40: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


44-44: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


52-52: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


60-60: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


68-68: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/human-touch.zh-CN.md (1)

26-26: 建议优化语言表达

为提高文档的可读性,建议修改以下用词:

  • "耐心的陪伴" 改为 "耐心地陪伴"
  • "敏感的支持" 改为 "敏感地支持"
🧰 Tools
🪛 LanguageTool

[uncategorized] ~26-~26: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:耐心"地"陪伴
Context: ...。 - 特殊关怀及服务: 面向老年人的设计,情感化的角色能提供温馨、耐心的陪伴,减轻孤独感,满足情感需求。 针对有特殊需求的用户(如残障人士),情感化设计...

(wb4)


[uncategorized] ~26-~26: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:敏感"地"支持
Context: ...足情感需求。 针对有特殊需求的用户(如残障人士),情感化设计能提供更加贴心、敏感的支持,增强自主生活能力。面对紧急服务与危机应对,如灾害警报、医疗急救指导,情感化...

(wb4)

docs/spec/human-touch.en-US.md (2)

Line range hint 1-1: 需要为图片添加替代文本以提高可访问性

建议为文档中的所有图片添加描述性的替代文本,这对于使用屏幕阅读器的用户来说至关重要。

示例修改:

-![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*y-DHRIdTUp8AAAAAAAAAAAAADgCCAQ/fmt.webp)
+![AI角色情感化设计概览图](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*y-DHRIdTUp8AAAAAAAAAAAAADgCCAQ/fmt.webp)
🧰 Tools
🪛 Markdownlint (0.35.0)

38-38: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


44-44: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

🪛 LanguageTool

[uncategorized] ~26-~26: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:耐心"地"陪伴
Context: ...。 - 特殊关怀及服务: 面向老年人的设计,情感化的角色能提供温馨、耐心的陪伴,减轻孤独感,满足情感需求。 针对有特殊需求的用户(如残障人士),情感化设计...

(wb4)


[uncategorized] ~26-~26: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:敏感"地"支持
Context: ...足情感需求。 针对有特殊需求的用户(如残障人士),情感化设计能提供更加贴心、敏感的支持,增强自主生活能力。面对紧急服务与危机应对,如灾害警报、医疗急救指导,情感化...

(wb4)


13-18: 建议优化列表格式以提高可读性

当前的内容结构可以通过更清晰的列表格式来改进。

建议修改为:

-情感的适应性 角色能够敏感地识别并响应用户的情绪变化,通过适当的语言和行为,展示出对用户情感状态的同理心和关切。情感表达上可以包含一定程度的复杂性,如矛盾感或微妙的情绪变化,使角色更加丰满和真实。
+### 情感的适应性
+
+角色能够敏感地识别并响应用户的情绪变化,通过适当的语言和行为,展示出对用户情感状态的同理心和关切。情感表达上可以包含一定程度的复杂性,如:
+- 矛盾感的展现
+- 微妙的情绪变化
+- 真实的情感互动
docs/spec/wake-up-welcome-message.en-US.md (2)

21-23: 建议为所有图片预览添加描述性的替代文本

为了提高文档的可访问性,建议为所有的图片预览组件添加有意义的替代文本。

示例修改:

 <ImagePreview>
-<img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*_MGXTpIAO8wAAAAAAAAAAAAADgCCAQ/fmt.webp">
+<img 
+  class="preview-img no-padding" 
+  src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*_MGXTpIAO8wAAAAAAAAAAAAADgCCAQ/fmt.webp"
+  alt="AI欢迎组件示例:展示了简洁的欢迎界面设计"
+>
 </ImagePreview>

Also applies to: 31-33, 46-48, 50-52, 58-60, 62-64, 70-72, 74-76, 82-84, 90-92

🧰 Tools
🪛 Markdownlint (0.35.0)

22-22: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


15-15: 建议优化文案表述

当前文案中的标点符号和空格使用不够规范。

建议修改为:

-欢迎&提示组件适用于【唤醒AI阶段】,让首次接触 AI产品的用户快速理解AI能做什么,可以清晰传达给用户AI可实现的意图范围和预期功能。
+欢迎与提示组件适用于「唤醒 AI 阶段」,让首次接触 AI 产品的用户快速理解 AI 能做什么,可以清晰地传达给用户 AI 可实现的意图范围和预期功能。
🧰 Tools
🪛 LanguageTool

[uncategorized] ~15-~15: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:合适"地"欢迎
Context: ...快速理解AI能做什么,可以清晰传达给用户AI可实现的意图范围和预期功能。使用合适的欢迎推荐组件,可以有效降低用户学习成本,让用户能够在短时间内对 AI 的各项能力...

(wb4)

docs/spec/end.en-US.md (1)

23-23: 建议修改语言表达

"进一步的帮助"应改为"进一步地帮助",以符合中文语法规范。

-AI 应主动询问用户是否需要进一步的帮助
+AI 应主动询问用户是否需要进一步地帮助
🧰 Tools
🪛 LanguageTool

[uncategorized] ~23-~23: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:进一步"地"帮助
Context: ...确认对话的结束,使用户感到满意和被尊重。此外,AI 应主动询问用户是否需要进一步的帮助或有其他问题,以确保用户在对话结束时感到被充分照顾。 #### 组件构成 ...

(wb4)

docs/spec/hybrid-ui-design.en-US.md (2)

44-44: 建议修改语言表达

"正确的表达意图"应改为"正确地表达意图",以符合中文语法规范。

-设计目标是让用户知道如何快捷且正确的表达意图
+设计目标是让用户知道如何快捷且正确地表达意图
🧰 Tools
🪛 LanguageTool

[uncategorized] ~44-~44: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:正确"地"表达
Context: ...表达阶段:用户向 AI 准确表达意图。* 设计目标是让用户知道如何快捷且正确的表达意图、并看清自己发送的内容。相关资产有 [用户输入](/docs/spec/...

(wb4)


53-53: 建议优化下载链接的表达方式

文件版本号建议使用更规范的格式。

-[🌟AntDesignX_UI KIT_20241122版.sketch]
+[🌟AntDesignX UI Kit (2024.11.22版).sketch]
🧰 Tools
🪛 LanguageTool

[uncategorized] ~53-~53: 数词与名词之间一般应存在量词,可能缺少量词。
Context: ...,包括组件、典型模板等。可点击下载 :[🌟AntDesignX_UI KIT_20241122版.sketch](/~https://github.com/user-attachm...

(wa5)

docs/spec/hybrid-ui-design.zh-CN.md (2)

53-53: 建议优化下载链接的展示方式

当前的下载链接包含了版本号和文件格式,建议采用更简洁的展示方式。

建议修改为:

-提供设计资产包,包括组件、典型模板等。可点击下载 :[🌟AntDesignX_UI KIT_20241122版.sketch](/~https://github.com/user-attachments/files/17931379/AntDesignX_UI.KIT_20241122.sketch.zip)
+提供设计资产包,包括组件、典型模板等。[📥 下载设计资产包](/~https://github.com/user-attachments/files/17931379/AntDesignX_UI.KIT_20241122.sketch.zip)
🧰 Tools
🪛 LanguageTool

[uncategorized] ~53-~53: 数词与名词之间一般应存在量词,可能缺少量词。
Context: ...,包括组件、典型模板等。可点击下载 :[🌟AntDesignX_UI KIT_20241122版.sketch](/~https://github.com/user-attachm...

(wa5)


43-46: 建议优化阶段说明的格式

为提高可读性,建议对阶段说明部分进行格式优化。

建议修改为:

-1. **唤醒阶段:用户要了解 AI 产品的能力与用法。** 设计目标是吸引用户,让首次接触的用户快速理解 AI 能做什么,告知用户 AI 可实现的意图范围和预期。相关资产有 [欢迎&提示](/docs/spec/wake-up-welcome-message-cn)。
-2. **表达阶段:用户向 AI 准确表达意图。** 设计目标是让用户知道如何快捷且正确的表达意图、并看清自己发送的内容。相关资产有 [用户输入](/docs/spec/expression-user-input-cn)、[用户发送](/docs/spec/expression-user-send-cn)。
-3. **确认阶段:用户等待 AI 完成任务。** 设计目标是让用户知道该任务的AI执行运转情况。相关资产有 [生成过程](/docs/spec/confirm-generation-process-cn)。
-4. **反馈阶段:用户核查 AI 完成结果并应用。** 设计目标是让用户清晰看到并信任AI任务完成的情况、并快速应用AI生成结果。相关资产有 [结果展示](/docs/spec/feedback-result-display-cn)、[结果应用](/docs/spec/feedback-result-application-cn)。
+### 1. 唤醒阶段
+**目标:** 用户要了解 AI 产品的能力与用法
+- 设计重点:吸引用户,让首次接触的用户快速理解 AI 能做什么
+- 相关资产:[欢迎&提示](/docs/spec/wake-up-welcome-message-cn)
+
+### 2. 表达阶段
+**目标:** 用户向 AI 准确表达意图
+- 设计重点:帮助用户快捷且正确地表达意图
+- 相关资产:[用户输入](/docs/spec/expression-user-input-cn)、[用户发送](/docs/spec/expression-user-send-cn)
+
+### 3. 确认阶段
+**目标:** 用户等待 AI 完成任务
+- 设计重点:展示 AI 任务执行状态
+- 相关资产:[生成过程](/docs/spec/confirm-generation-process-cn)
+
+### 4. 反馈阶段
+**目标:** 用户核查 AI 完成结果并应用
+- 设计重点:清晰展示结果并建立信任
+- 相关资产:[结果展示](/docs/spec/feedback-result-display-cn)、[结果应用](/docs/spec/feedback-result-application-cn)
🧰 Tools
🪛 LanguageTool

[uncategorized] ~44-~44: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:正确"地"表达
Context: ...表达阶段:用户向 AI 准确表达意图。* 设计目标是让用户知道如何快捷且正确的表达意图、并看清自己发送的内容。相关资产有 [用户输入](/docs/spec/...

(wb4)

docs/spec/wake-up-ai-icon.zh-CN.md (2)

15-15: 建议优化表达方式

当前表达存在用词不当的问题。

建议修改为:

-产品界面中使用代表 AI 的图像标识,可吸引用户关注并开启新探索。
+产品界面中使用代表 AI 的图像标识,可引起用户注意并激发探索兴趣。
🧰 Tools
🪛 LanguageTool

[uncategorized] ~15-~15: ‘关注’不应该与‘吸引’搭配,您可以使用‘"引起"’与之搭配。
Context: ...其他图标区分开来。 ## 设计目标 产品界面中使用代表 AI 的图像标识,可吸引用户关注并开启新探索。人工智能视觉符号应具高辨识度,能在众多的图像中迅速吸引用户...

(s32)


35-35: 建议修正语法用词

当前句子中"凭借着"的用法不够准确。

建议修改为:

-这些 AI 助手凭借着其便捷、明显的入口位置,不断吸引着用户主动去打开并加以使用
+这些 AI 助手凭借其便捷、明显的入口位置,不断吸引用户主动打开并使用
🧰 Tools
🪛 LanguageTool

[uncategorized] ~35-~35: 介词后不能接 “着” ,请删除 “着” :"凭借"。
Context: ...多 AI 助手入口搭载于各类浏览器之上,常被固定在浏览器拓展栏,这些 AI 助手凭借着其便捷、明显的入口位置,不断吸引着用户主动去打开并加以使用,为生活和工作带来极大...

(wb2)

docs/spec/expression-user-send.en-US.md (1)

Line range hint 1-113: 需要将文档内容翻译为英文

当前文件虽然是 en-US 语言版本,但内容仍然是中文。建议将所有内容翻译成英文,以确保国际用户可以使用。

🧰 Tools
🪛 Markdownlint (0.35.0)

24-24: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


32-32: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


40-40: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


44-44: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


48-48: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


52-52: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


60-60: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


64-64: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


74-74: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


84-84: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


92-92: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


100-100: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


108-108: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/confirm.en-US.md (2)

Line range hint 1-101: 文档标题与内容语言不一致

文档的 group title 使用了中英文混合("💭 Conversation 会话设计"),而内容完全是中文。建议:

  1. 将 group title 统一为英文
  2. 将所有内容翻译为英文
-  title: 💭 Conversation 会话设计
+  title: 💭 Conversation Design
🧰 Tools
🪛 LanguageTool

[uncategorized] ~101-~101: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:不必要"地"确认
Context: ...高度准确性的场景,从而简化了交互流程,提高用户体验的效率和流畅性。通过减少不必要的确认环节,用户可以更快捷地完成操作,同时保持了操作的安全性和准确性。

(wb4)

🪛 Markdownlint (0.35.0)

46-46: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


60-60: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


71-71: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


76-76: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


84-84: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


93-93: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


98-98: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


57-101: 建议优化章节编号格式

当前使用的编号格式(如"1.")不够规范。建议使用空格分隔编号和标题。

-### 1.针对用户输入的参数做隐性确认
+### 1. 针对用户输入的参数做隐性确认
🧰 Tools
🪛 LanguageTool

[uncategorized] ~101-~101: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:不必要"地"确认
Context: ...高度准确性的场景,从而简化了交互流程,提高用户体验的效率和流畅性。通过减少不必要的确认环节,用户可以更快捷地完成操作,同时保持了操作的安全性和准确性。

(wb4)

🪛 Markdownlint (0.35.0)

60-60: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


71-71: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


76-76: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


84-84: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


93-93: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


98-98: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/confirm.zh-CN.md (1)

101-101: 优化语言表述

建议修改措辞以提高清晰度和准确性。

-在用户输入明确且系统能够以高置信度识别用户意图的情况下,可以省略确认步骤。
+在用户输入明确且系统能够以高置信度识别用户意图的情况下,可以省略确认步骤。这种设计可以简化用户操作流程,提升交互效率。
🧰 Tools
🪛 LanguageTool

[uncategorized] ~101-~101: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:不必要"地"确认
Context: ...高度准确性的场景,从而简化了交互流程,提高用户体验的效率和流畅性。通过减少不必要的确认环节,用户可以更快捷地完成操作,同时保持了操作的安全性和准确性。

(wb4)

docs/spec/expression-user-input.en-US.md (1)

Line range hint 1-132: 英文版文档需要翻译

当前文件(expression-user-input.en-US.md)包含的是中文内容,但文件名表明这应该是英文版本的文档。建议将所有内容翻译成英文,以保持文档的语言一致性。

🧰 Tools
🪛 Markdownlint (0.35.0)

26-26: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


36-36: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


44-44: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


47-47: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


57-57: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


65-65: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


68-68: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


76-76: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


79-79: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


91-91: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


99-99: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


107-107: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


111-111: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


119-119: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


127-127: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/error.zh-CN.md (2)

39-39: 需要为图片添加替代文本以提高可访问性

为了确保文档对所有用户都是可访问的,包括使用屏幕阅读器的用户,建议为所有图片添加有意义的替代文本(alt text)。

示例修改:

-<img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*CqISQJfdzqoAAAAAAAAAAAAADgCCAQ/fmt.webp">
+<img class="preview-img no-padding" alt="引导用户重新表述的示例界面" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*CqISQJfdzqoAAAAAAAAAAAAADgCCAQ/fmt.webp">

Also applies to: 46-46, 51-51, 62-62, 67-67, 80-80, 89-89, 97-97, 105-105, 119-119, 132-132

🧰 Tools
🪛 Markdownlint (0.35.0)

39-39: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


130-130: 标题层级结构需要调整

文档中的标题层级结构不一致。"组件总结"使用了 h5 标题(#####),但它是直接跟在 h3 标题之后的。建议调整为 h4 标题以保持层级的连续性。

-##### 组件总结
+#### 组件总结
🧰 Tools
🪛 Markdownlint (0.35.0)

130-130: Expected: h4; Actual: h5
Heading levels should only increment by one level at a time

(MD001, heading-increment)

docs/spec/introduce.zh-CN.md (1)

5-5: 需要为图片添加替代文本以提高可访问性

为了确保文档对所有用户都是可访问的,建议为所有图片添加有意义的替代文本(alt text)。这对于使用屏幕阅读器的用户尤为重要。

示例修改:

-![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*31g-RpB6F6UAAAAAAAAAAAAADgCCAQ/fmt.webp)
+![RICH设计范式概览图](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*31g-RpB6F6UAAAAAAAAAAAAADgCCAQ/fmt.webp)
🧰 Tools
🪛 Markdownlint (0.35.0)

5-5: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/introduce.en-US.md (1)

5-5: 需要为图片添加 alt 文本以提高可访问性

建议为所有图片添加有意义的替代文本,以支持屏幕阅读器用户。例如:

-![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*31g-RpB6F6UAAAAAAAAAAAAADgCCAQ/fmt.webp)
+![RICH 设计范式概览](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*31g-RpB6F6UAAAAAAAAAAAAADgCCAQ/fmt.webp)
🧰 Tools
🪛 Markdownlint (0.35.0)

5-5: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/conversation-design.zh-CN.md (1)

45-45: 建议优化语言表述

建议修改以下表述使其更加准确:

  • "不准确性" 建议改为 "不准确"
  • "专门的支持" 建议改为 "专门地支持"
  • "有效的沟通" 建议改为 "有效地沟通"
🧰 Tools
🪛 LanguageTool

[uncategorized] ~45-~45: 您的意思是“"不"全”?
Context: ...战,例如意图识别的不准确性可能导致错误回复,以及槽位信息的缺失可能需要多轮对话来补全信息。对话交互的核心目标是解决用户问题并提高效率,任何对话交互设计都应遵循这一...

(BU)

docs/spec/confirm-generation-process.en-US.md (1)

23-25: 需要为所有预览图片添加替代文本

建议为所有 <ImagePreview> 组件中的图片添加 alt 属性,以提高可访问性。例如:

<ImagePreview>
-<img class="preview-img no-padding" src="...">
+<img class="preview-img no-padding" alt="动画加载示例" src="...">
</ImagePreview>

Also applies to: 31-33, 39-41, 49-51, 57-59, 67-69, 75-77

🧰 Tools
🪛 Markdownlint (0.35.0)

24-24: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/smooth-natural.zh-CN.md (3)

13-17: 建议优化语言表达的语法

为提高文档的语言准确性,建议进行以下修改:

  1. 将"语言表达的自然流畅"改为"语言表达得自然流畅"
  2. 将"避免机械和生硬的表达"改为"避免机械和生硬地表达"
-这涉及到语言表达的自然流畅,使用贴近人类日常对话的词汇和语法,避免机械和生硬的表达。
+这涉及到语言表达得自然流畅,使用贴近人类日常对话的词汇和语法,避免机械和生硬地表达。
🧰 Tools
🪛 LanguageTool

[uncategorized] ~13-~13: 1.动词被副词修饰时,助词应该用‘得’;2.省略宾语时,助词应该用‘的’;可能造成歧义。您的意思是不是:表达"得"自然流畅
Context: ... 如何定义 角色在与用户互动时展现出人类交流的流畅性和真实性。这涉及到语言表达的自然流畅,使用贴近人类日常对话的词汇和语法,避免机械和生硬的表达。同时,角色的行...

(wb4)


[uncategorized] ~13-~13: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:生硬"地"表达
Context: ...性。这涉及到语言表达的自然流畅,使用贴近人类日常对话的词汇和语法,避免机械和生硬的表达。同时,角色的行为反应也应自然合理,能够根据用户的输入做出恰当的、符合情境的...

(wb4)


23-23: 修复 Markdown 格式问题

在 Markdown 中,星号 () 是特殊字符,用于格式化文本。建议使用转义字符来显示 "724"。

-提供7*24的在线服务
+提供7\*24的在线服务

37-37: 添加图片替代文本以提高可访问性

为了提高文档的可访问性,建议为所有图片添加替代文本(alt text)。

-![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*PfxLQ5SAGsQAAAAAAAAAAAAADgCCAQ/fmt.webp)
+![为AI角色赋予丰富且逻辑清晰的自然语言示例图](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*PfxLQ5SAGsQAAAAAAAAAAAAADgCCAQ/fmt.webp)

-![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*N8GtRp43ZM0AAAAAAAAAAAAADgCCAQ/fmt.webp)
+![提供真实对话参考示例图](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*N8GtRp43ZM0AAAAAAAAAAAAADgCCAQ/fmt.webp)

Also applies to: 43-43

🧰 Tools
🪛 Markdownlint (0.35.0)

37-37: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL

📥 Commits

Reviewing files that changed from the base of the PR and between 4dfe300 and fef5f45.

📒 Files selected for processing (48)
  • docs/spec/authentic-consistent.en-US.md (2 hunks)
  • docs/spec/authentic-consistent.zh-CN.md (2 hunks)
  • docs/spec/confirm-generation-process.en-US.md (1 hunks)
  • docs/spec/confirm-generation-process.zh-CN.md (1 hunks)
  • docs/spec/confirm.en-US.md (2 hunks)
  • docs/spec/confirm.zh-CN.md (2 hunks)
  • docs/spec/conversation-design.en-US.md (2 hunks)
  • docs/spec/conversation-design.zh-CN.md (2 hunks)
  • docs/spec/define-intention-type.en-US.md (1 hunks)
  • docs/spec/define-intention-type.zh-CN.md (1 hunks)
  • docs/spec/end.en-US.md (1 hunks)
  • docs/spec/end.zh-CN.md (1 hunks)
  • docs/spec/error.en-US.md (1 hunks)
  • docs/spec/error.zh-CN.md (1 hunks)
  • docs/spec/expression-user-input.en-US.md (2 hunks)
  • docs/spec/expression-user-input.zh-CN.md (2 hunks)
  • docs/spec/expression-user-send.en-US.md (1 hunks)
  • docs/spec/expression-user-send.zh-CN.md (1 hunks)
  • docs/spec/feedback-result-application.en-US.md (1 hunks)
  • docs/spec/feedback-result-application.zh-CN.md (1 hunks)
  • docs/spec/feedback-result-display.en-US.md (1 hunks)
  • docs/spec/feedback-result-display.zh-CN.md (1 hunks)
  • docs/spec/follow-up.en-US.md (2 hunks)
  • docs/spec/follow-up.zh-CN.md (2 hunks)
  • docs/spec/guide-intention-expression.en-US.md (1 hunks)
  • docs/spec/guide-intention-expression.zh-CN.md (1 hunks)
  • docs/spec/hint.en-US.md (1 hunks)
  • docs/spec/hint.zh-CN.md (1 hunks)
  • docs/spec/human-touch.en-US.md (1 hunks)
  • docs/spec/human-touch.zh-CN.md (1 hunks)
  • docs/spec/hybrid-ui-design.en-US.md (1 hunks)
  • docs/spec/hybrid-ui-design.zh-CN.md (1 hunks)
  • docs/spec/intention-introduce.en-US.md (1 hunks)
  • docs/spec/intention-introduce.zh-CN.md (1 hunks)
  • docs/spec/introduce.en-US.md (1 hunks)
  • docs/spec/introduce.zh-CN.md (1 hunks)
  • docs/spec/provide-intention-expectation.en-US.md (1 hunks)
  • docs/spec/provide-intention-expectation.zh-CN.md (1 hunks)
  • docs/spec/role-design.en-US.md (1 hunks)
  • docs/spec/role-design.zh-CN.md (1 hunks)
  • docs/spec/smooth-natural.en-US.md (1 hunks)
  • docs/spec/smooth-natural.zh-CN.md (1 hunks)
  • docs/spec/start.en-US.md (1 hunks)
  • docs/spec/start.zh-CN.md (1 hunks)
  • docs/spec/wake-up-ai-icon.en-US.md (1 hunks)
  • docs/spec/wake-up-ai-icon.zh-CN.md (1 hunks)
  • docs/spec/wake-up-welcome-message.en-US.md (1 hunks)
  • docs/spec/wake-up-welcome-message.zh-CN.md (1 hunks)
✅ Files skipped from review due to trivial changes (1)
  • docs/spec/provide-intention-expectation.zh-CN.md
🧰 Additional context used
🪛 LanguageTool
docs/spec/conversation-design.zh-CN.md

[uncategorized] ~45-~45: 您的意思是“"不"全”?
Context: ...战,例如意图识别的不准确性可能导致错误回复,以及槽位信息的缺失可能需要多轮对话来补全信息。对话交互的核心目标是解决用户问题并提高效率,任何对话交互设计都应遵循这一...

(BU)


[uncategorized] ~75-~75: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:专门"地"支持
Context: ...gePreview> 对话主体应具备针对性,针对特定的决策问题和决策者提供专门的支持。这意味着 AI 需要能够根据用户的具体需求,提供定制化的信息和建议,以增强...

(wb4)


[uncategorized] ~81-~81: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:有效"地"沟通
Context: ...p) 在对话设计中,使用的话术要易于用户记忆、理解及清晰表意,从而实现更加有效的沟通。 #### 1.任务相关性 <img c...

(wb4)

docs/spec/start.zh-CN.md

[uncategorized] ~13-~13: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:正确"地"期望
Context: ...I 能为他们做些什么,而不是给他们一种正在接受教程的感觉。首要任务是迅速设定正确的期望,引导用户发现 AI 的功能,并将对话的主动权交还给用户。 ## HOW ...

(wb4)

docs/spec/intention-introduce.zh-CN.md

[uncategorized] ~23-~23: 与‘目标’‘理想’搭配的动词不应该是‘完成’,您可以使用‘"实现"’与之搭配。
Context: ...因此,准确识别这些隐含意图至关重要。它能帮助 AI 更准确地回应用户需求,更高效完成用户目标。 ![](https://mdn.alipayobjects.com...

(s32)

docs/spec/smooth-natural.en-US.md

[uncategorized] ~13-~13: 1.动词被副词修饰时,助词应该用‘得’;2.省略宾语时,助词应该用‘的’;可能造成歧义。您的意思是不是:表达"得"自然流畅
Context: ... 如何定义 角色在与用户互动时展现出人类交流的流畅性和真实性。这涉及到语言表达的自然流畅,使用贴近人类日常对话的词汇和语法,避免机械和生硬的表达。同时,角色的行...

(wb4)


[uncategorized] ~13-~13: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:生硬"地"表达
Context: ...性。这涉及到语言表达的自然流畅,使用贴近人类日常对话的词汇和语法,避免机械和生硬的表达。同时,角色的行为反应也应自然合理,能够根据用户的输入做出恰当的、符合情境的...

(wb4)

docs/spec/feedback-result-application.zh-CN.md

[uncategorized] ~35-~35: 您的意思是""过度"体验"?
Context: ...生成请求,支持多个版本结果的切换对比。新生成的内容要在界面中平滑切换,保持良好的过渡体验。 ### 反馈 <img class="...

(DU3_DU4)

docs/spec/hybrid-ui-design.zh-CN.md

[uncategorized] ~44-~44: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:正确"地"表达
Context: ...表达阶段:用户向 AI 准确表达意图。* 设计目标是让用户知道如何快捷且正确的表达意图、并看清自己发送的内容。相关资产有 [用户输入](/docs/spec/...

(wb4)


[uncategorized] ~53-~53: 数词与名词之间一般应存在量词,可能缺少量词。
Context: ...,包括组件、典型模板等。可点击下载 :[🌟AntDesignX_UI KIT_20241122版.sketch](/~https://github.com/user-attachm...

(wa5)

docs/spec/feedback-result-display.zh-CN.md

[uncategorized] ~27-~27: 数量词修饰并列短语,可能产生歧义
Context: ...> 作为最基础的展示形式,需要处理好单行文本、多行文本和结构化文本(如列表、标题段落等)的呈现。通过合理的间距、字号和段落划分,提升长文本的...

(s5)


[uncategorized] ~29-~29: “片”不能与“内容”搭配,可改为:""图篇"内容"
Context: ...性。对重点内容可使用高亮、加粗等样式突出,但需控制使用频率避免干扰。 ### 图片内容 <img class="preview-i...

(wa5)


[uncategorized] ~43-~43: “门”不能与“容器”搭配,请更换量词。
Context: ...AQ/fmt.webp"> 为展示代码片段设计专门容器。使用等宽字体,支持代码语法高亮以增强可读性。提供代码复制功能,方便用户使用...

(wa5)

docs/spec/define-intention-type.en-US.md

[uncategorized] ~13-~13: 与‘目标’‘理想’搭配的动词不应该是‘完成’,您可以使用‘"实现"’与之搭配。
Context: ...,通过对话的方式,能更加高效洞察与满足意图;而意图清晰的用户,通过简单的操作即可完成用户的目标,例如点击按钮或者图标等。 - **从用户与系统间交互目的,可分为咨询...

(s32)

docs/spec/start.en-US.md

[uncategorized] ~13-~13: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:正确"地"期望
Context: ...I 能为他们做些什么,而不是给他们一种正在接受教程的感觉。首要任务是迅速设定正确的期望,引导用户发现 AI 的功能,并将对话的主动权交还给用户。 ## HOW ...

(wb4)

docs/spec/define-intention-type.zh-CN.md

[uncategorized] ~13-~13: 与‘目标’‘理想’搭配的动词不应该是‘完成’,您可以使用‘"实现"’与之搭配。
Context: ...,通过对话的方式,能更加高效洞察与满足意图;而意图清晰的用户,通过简单的操作即可完成用户的目标,例如点击按钮或者图标等。 - **从用户与系统间交互目的,可分为咨询...

(s32)

docs/spec/wake-up-ai-icon.zh-CN.md

[uncategorized] ~15-~15: ‘关注’不应该与‘吸引’搭配,您可以使用‘"引起"’与之搭配。
Context: ...其他图标区分开来。 ## 设计目标 产品界面中使用代表 AI 的图像标识,可吸引用户关注并开启新探索。人工智能视觉符号应具高辨识度,能在众多的图像中迅速吸引用户...

(s32)


[uncategorized] ~35-~35: 介词后不能接 “着” ,请删除 “着” :"凭借"。
Context: ...多 AI 助手入口搭载于各类浏览器之上,常被固定在浏览器拓展栏,这些 AI 助手凭借着其便捷、明显的入口位置,不断吸引着用户主动去打开并加以使用,为生活和工作带来极大...

(wb2)

docs/spec/follow-up.zh-CN.md

[uncategorized] ~13-~13: 与‘目标’‘理想’搭配的动词不应该是‘完成’,您可以使用‘"实现"’与之搭配。
Context: ...WHAT 概述 在 AI 对话交互过程中,若用户所提供的信息不足以支撑 AI 完成既定的任务目标,AI 必须采取主动措施,通过精心设计的询问来引导用户提供额外的槽...

(s32)


[uncategorized] ~19-~19: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:具体"地"询问
Context: ...。 2. 构建有效询问: 基于识别出的信息缺口,AI 应构建清晰、具体的询问,直接引导用户补充所需信息。 3. 保持对话连贯性: 在请求额外信...

(wb4)

docs/spec/human-touch.zh-CN.md

[uncategorized] ~26-~26: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:耐心"地"陪伴
Context: ...。 - 特殊关怀及服务: 面向老年人的设计,情感化的角色能提供温馨、耐心的陪伴,减轻孤独感,满足情感需求。 针对有特殊需求的用户(如残障人士),情感化设计...

(wb4)


[uncategorized] ~26-~26: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:敏感"地"支持
Context: ...足情感需求。 针对有特殊需求的用户(如残障人士),情感化设计能提供更加贴心、敏感的支持,增强自主生活能力。面对紧急服务与危机应对,如灾害警报、医疗急救指导,情感化...

(wb4)

docs/spec/wake-up-welcome-message.zh-CN.md

[uncategorized] ~15-~15: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:合适"地"欢迎
Context: ...快速理解AI能做什么,可以清晰传达给用户AI可实现的意图范围和预期功能。使用合适的欢迎推荐组件,可以有效降低用户学习成本,让用户能够在短时间内对 AI 的各项能力...

(wb4)


[uncategorized] ~66-~66: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:清晰"地"欢迎
Context: ...ADgCCAQ/fmt.webp"> 简明清晰的欢迎介绍,推荐提示功能显示主标题和辅助解释,让用户更易理解,文案可自定义。 #...

(wb4)

docs/spec/intention-introduce.en-US.md

[uncategorized] ~23-~23: 与‘目标’‘理想’搭配的动词不应该是‘完成’,您可以使用‘"实现"’与之搭配。
Context: ...因此,准确识别这些隐含意图至关重要。它能帮助 AI 更准确地回应用户需求,更高效完成用户目标。 ![](https://mdn.alipayobjects.com...

(s32)

docs/spec/wake-up-ai-icon.en-US.md

[uncategorized] ~15-~15: ‘关注’不应该与‘吸引’搭配,您可以使用‘"引起"’与之搭配。
Context: ...其他图标区分开来。 ## 设计目标 产品界面中使用代表 AI 的图像标识,可吸引用户关注并开启新探索。人工智能视觉符号应具高辨识度,能在众多的图像中迅速吸引用户...

(s32)


[uncategorized] ~35-~35: 介词后不能接 “着” ,请删除 “着” :"凭借"。
Context: ...多 AI 助手入口搭载于各类浏览器之上,常被固定在浏览器拓展栏,这些 AI 助手凭借着其便捷、明显的入口位置,不断吸引着用户主动去打开并加以使用,为生活和工作带来极大...

(wb2)

docs/spec/feedback-result-display.en-US.md

[uncategorized] ~27-~27: 数量词修饰并列短语,可能产生歧义
Context: ...> 作为最基础的展示形式,需要处理好单行文本、多行文本和结构化文本(如列表、标题段落等)的呈现。通过合理的间距、字号和段落划分,提升长文本的...

(s5)


[uncategorized] ~29-~29: “片”不能与“内容”搭配,可改为:""图篇"内容"
Context: ...性。对重点内容可使用高亮、加粗等样式突出,但需控制使用频率避免干扰。 ### 图片内容 <img class="preview-i...

(wa5)


[uncategorized] ~43-~43: “门”不能与“容器”搭配,请更换量词。
Context: ...AQ/fmt.webp"> 为展示代码片段设计专门容器。使用等宽字体,支持代码语法高亮以增强可读性。提供代码复制功能,方便用户使用...

(wa5)

docs/spec/hybrid-ui-design.en-US.md

[uncategorized] ~44-~44: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:正确"地"表达
Context: ...表达阶段:用户向 AI 准确表达意图。* 设计目标是让用户知道如何快捷且正确的表达意图、并看清自己发送的内容。相关资产有 [用户输入](/docs/spec/...

(wb4)


[uncategorized] ~53-~53: 数词与名词之间一般应存在量词,可能缺少量词。
Context: ...,包括组件、典型模板等。可点击下载 :[🌟AntDesignX_UI KIT_20241122版.sketch](/~https://github.com/user-attachm...

(wa5)

docs/spec/smooth-natural.zh-CN.md

[uncategorized] ~13-~13: 1.动词被副词修饰时,助词应该用‘得’;2.省略宾语时,助词应该用‘的’;可能造成歧义。您的意思是不是:表达"得"自然流畅
Context: ... 如何定义 角色在与用户互动时展现出人类交流的流畅性和真实性。这涉及到语言表达的自然流畅,使用贴近人类日常对话的词汇和语法,避免机械和生硬的表达。同时,角色的行...

(wb4)


[uncategorized] ~13-~13: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:生硬"地"表达
Context: ...性。这涉及到语言表达的自然流畅,使用贴近人类日常对话的词汇和语法,避免机械和生硬的表达。同时,角色的行为反应也应自然合理,能够根据用户的输入做出恰当的、符合情境的...

(wb4)

docs/spec/guide-intention-expression.en-US.md

[uncategorized] ~13-~13: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:自然"地"引导
Context: ...位。为了准确的引导用户将这些关键信息表达清楚,我们需要在交互过程中有意识的、自然的引导用户进行对应信息的表达。 ![](https://mdn.alipayob...

(wb4)


[uncategorized] ~25-~25: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:具体"地"会话
Context: ...移或回复兜底话术策略,确保用户得到合理引导或回应。 槽位设计的规则后续将在具体的会话设计篇目中有相关的具体应用,大家按需查阅。 ![](https://mdn...

(wb4)

docs/spec/human-touch.en-US.md

[uncategorized] ~26-~26: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:耐心"地"陪伴
Context: ...。 - 特殊关怀及服务: 面向老年人的设计,情感化的角色能提供温馨、耐心的陪伴,减轻孤独感,满足情感需求。 针对有特殊需求的用户(如残障人士),情感化设计...

(wb4)


[uncategorized] ~26-~26: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:敏感"地"支持
Context: ...足情感需求。 针对有特殊需求的用户(如残障人士),情感化设计能提供更加贴心、敏感的支持,增强自主生活能力。面对紧急服务与危机应对,如灾害警报、医疗急救指导,情感化...

(wb4)

docs/spec/feedback-result-application.en-US.md

[uncategorized] ~35-~35: 您的意思是""过度"体验"?
Context: ...生成请求,支持多个版本结果的切换对比。新生成的内容要在界面中平滑切换,保持良好的过渡体验。 ### 反馈 <img class="...

(DU3_DU4)

docs/spec/confirm.zh-CN.md

[uncategorized] ~101-~101: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:不必要"地"确认
Context: ...高度准确性的场景,从而简化了交互流程,提高用户体验的效率和流畅性。通过减少不必要的确认环节,用户可以更快捷地完成操作,同时保持了操作的安全性和准确性。

(wb4)

docs/spec/guide-intention-expression.zh-CN.md

[uncategorized] ~13-~13: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:自然"地"引导
Context: ...位。为了准确的引导用户将这些关键信息表达清楚,我们需要在交互过程中有意识的、自然的引导用户进行对应信息的表达。 ![](https://mdn.alipayob...

(wb4)


[uncategorized] ~25-~25: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:具体"地"会话
Context: ...移或回复兜底话术策略,确保用户得到合理引导或回应。 槽位设计的规则后续将在具体的会话设计篇目中有相关的具体应用,大家按需查阅。 ![](https://mdn...

(wb4)

docs/spec/error.en-US.md

[uncategorized] ~57-~57: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:正确"地"输入
Context: ...用户快速识别并选择最符合其需求的选项。 2. 提供示例:通过示例展示正确的输入格式或期望的答案类型,帮助用户更准确地表达他们的请求。 3. *预测需求...

(wb4)


[uncategorized] ~70-~70: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:连续"地"挫败
Context: ...Q/fmt.webp"> 为了避免用户经历连续的挫败感,AI 应在两次尝试理解用户意图失败后,主动结束对话。在这种情况下,提供不...

(wb4)


[uncategorized] ~75-~75: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:诚实"地"沟通
Context: ...决方案或建议用户寻求其他帮助渠道。 4. 保持透明和诚实:通过透明和诚实的沟通,系统可以维护用户的信任,并为未来的交互留下积极的印象。 5. **收集反馈...

(wb4)


[uncategorized] ~127-~127: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:进一步"地"帮助
Context: ...或建议。 4. 引导用户:如果问题无法立即解决,应指导用户如何寻求进一步的帮助或联系技术支持。 5. 记录和分析:系统应自动记录错误详情,以便进行...

(wb4)

docs/spec/end.en-US.md

[uncategorized] ~23-~23: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:进一步"地"帮助
Context: ...确认对话的结束,使用户感到满意和被尊重。此外,AI 应主动询问用户是否需要进一步的帮助或有其他问题,以确保用户在对话结束时感到被充分照顾。 #### 组件构成 ...

(wb4)


[uncategorized] ~57-~57: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:可行"地"替代
Context: ...对话将会终止。在这种情况下,关键的做法是坦诚地承认 AI 能力的不足,并提供可行的替代方案或引导用户通过其他途径实现目标。此外,这也是收集反馈和数据的宝贵机会,用...

(wb4)

docs/spec/error.zh-CN.md

[uncategorized] ~57-~57: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:正确"地"输入
Context: ...用户快速识别并选择最符合其需求的选项。 2. 提供示例:通过示例展示正确的输入格式或期望的答案类型,帮助用户更准确地表达他们的请求。 3. *预测需求...

(wb4)


[uncategorized] ~70-~70: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:连续"地"挫败
Context: ...Q/fmt.webp"> 为了避免用户经历连续的挫败感,AI 应在两次尝试理解用户意图失败后,主动结束对话。在这种情况下,提供不...

(wb4)


[uncategorized] ~75-~75: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:诚实"地"沟通
Context: ...决方案或建议用户寻求其他帮助渠道。 4. 保持透明和诚实:通过透明和诚实的沟通,系统可以维护用户的信任,并为未来的交互留下积极的印象。 5. **收集反馈...

(wb4)


[uncategorized] ~127-~127: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:进一步"地"帮助
Context: ...或建议。 4. 引导用户:如果问题无法立即解决,应指导用户如何寻求进一步的帮助或联系技术支持。 5. 记录和分析:系统应自动记录错误详情,以便进行...

(wb4)

docs/spec/confirm.en-US.md

[uncategorized] ~101-~101: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:不必要"地"确认
Context: ...高度准确性的场景,从而简化了交互流程,提高用户体验的效率和流畅性。通过减少不必要的确认环节,用户可以更快捷地完成操作,同时保持了操作的安全性和准确性。

(wb4)

docs/spec/wake-up-welcome-message.en-US.md

[uncategorized] ~15-~15: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:合适"地"欢迎
Context: ...快速理解AI能做什么,可以清晰传达给用户AI可实现的意图范围和预期功能。使用合适的欢迎推荐组件,可以有效降低用户学习成本,让用户能够在短时间内对 AI 的各项能力...

(wb4)


[uncategorized] ~66-~66: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:清晰"地"欢迎
Context: ...ADgCCAQ/fmt.webp"> 简明清晰的欢迎介绍,推荐提示功能显示主标题和辅助解释,让用户更易理解,文案可自定义。 #...

(wb4)

docs/spec/end.zh-CN.md

[uncategorized] ~23-~23: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:进一步"地"帮助
Context: ...确认对话的结束,使用户感到满意和被尊重。此外,AI 应主动询问用户是否需要进一步的帮助或有其他问题,以确保用户在对话结束时感到被充分照顾。 #### 组件构成 ...

(wb4)


[uncategorized] ~57-~57: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:可行"地"替代
Context: ...对话将会终止。在这种情况下,关键的做法是坦诚地承认 AI 能力的不足,并提供可行的替代方案或引导用户通过其他途径实现目标。此外,这也是收集反馈和数据的宝贵机会,用...

(wb4)

docs/spec/follow-up.en-US.md

[uncategorized] ~13-~13: 与‘目标’‘理想’搭配的动词不应该是‘完成’,您可以使用‘"实现"’与之搭配。
Context: ...WHAT 概述 在 AI 对话交互过程中,若用户所提供的信息不足以支撑 AI 完成既定的任务目标,AI 必须采取主动措施,通过精心设计的询问来引导用户提供额外的槽...

(s32)


[uncategorized] ~19-~19: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:具体"地"询问
Context: ...。 2. 构建有效询问: 基于识别出的信息缺口,AI 应构建清晰、具体的询问,直接引导用户补充所需信息。 3. 保持对话连贯性: 在请求额外信...

(wb4)

docs/spec/conversation-design.en-US.md

[uncategorized] ~45-~45: 您的意思是“"不"全”?
Context: ...战,例如意图识别的不准确性可能导致错误回复,以及槽位信息的缺失可能需要多轮对话来补全信息。对话交互的核心目标是解决用户问题并提高效率,任何对话交互设计都应遵循这一...

(BU)


[uncategorized] ~75-~75: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:专门"地"支持
Context: ...gePreview> 对话主体应具备针对性,针对特定的决策问题和决策者提供专门的支持。这意味着 AI 需要能够根据用户的具体需求,提供定制化的信息和建议,以增强...

(wb4)


[uncategorized] ~81-~81: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:有效"地"沟通
Context: ...p) 在对话设计中,使用的话术要易于用户记忆、理解及清晰表意,从而实现更加有效的沟通。 #### 1.任务相关性 <img c...

(wb4)

🪛 Markdownlint (0.35.0)
docs/spec/conversation-design.zh-CN.md

39-39: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


49-49: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


56-56: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


64-64: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


72-72: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


79-79: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


86-86: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


94-94: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


102-102: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


110-110: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


118-118: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


125-125: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


132-132: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


140-140: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


148-148: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


156-156: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/introduce.en-US.md

5-5: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/introduce.zh-CN.md

5-5: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/start.zh-CN.md

20-20: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/intention-introduce.zh-CN.md

19-19: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


25-25: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


31-31: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


33-33: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/smooth-natural.en-US.md

37-37: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/feedback-result-application.zh-CN.md

24-24: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


32-32: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


40-40: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


44-44: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


52-52: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


60-60: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


68-68: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/hybrid-ui-design.zh-CN.md

19-19: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


25-25: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


37-37: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


41-41: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/authentic-consistent.zh-CN.md

39-39: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/role-design.en-US.md

19-19: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


23-23: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


29-29: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


35-35: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


41-41: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


47-47: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/feedback-result-display.zh-CN.md

24-24: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


32-32: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


40-40: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


48-48: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


56-56: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


66-66: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


74-74: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/define-intention-type.en-US.md

18-18: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/expression-user-send.zh-CN.md

24-24: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


32-32: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


40-40: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


44-44: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


48-48: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


52-52: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


60-60: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


64-64: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


74-74: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


84-84: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


92-92: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


100-100: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


108-108: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/start.en-US.md

20-20: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/define-intention-type.zh-CN.md

18-18: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/expression-user-input.en-US.md

26-26: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


36-36: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


44-44: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


47-47: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


57-57: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


65-65: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


68-68: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


76-76: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


79-79: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


91-91: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


99-99: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


107-107: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


111-111: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


119-119: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


127-127: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/wake-up-ai-icon.zh-CN.md

23-23: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


32-32: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


40-40: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


48-48: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


56-56: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


66-66: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


74-74: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


82-82: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


90-90: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


98-98: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/follow-up.zh-CN.md

26-26: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


33-33: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


38-38: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


45-45: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


50-50: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


67-67: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/human-touch.zh-CN.md

38-38: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/hint.zh-CN.md

22-22: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


33-33: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


38-38: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


45-45: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


50-50: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/wake-up-welcome-message.zh-CN.md

22-22: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


32-32: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


47-47: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


51-51: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


59-59: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


63-63: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


71-71: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


75-75: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


83-83: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


91-91: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/intention-introduce.en-US.md

19-19: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


25-25: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


31-31: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


33-33: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/expression-user-input.zh-CN.md

26-26: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


36-36: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


44-44: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


47-47: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


57-57: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


65-65: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


68-68: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


76-76: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


79-79: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


91-91: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


99-99: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


107-107: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


111-111: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


119-119: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


127-127: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/wake-up-ai-icon.en-US.md

23-23: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


32-32: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


40-40: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


48-48: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


56-56: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


66-66: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


74-74: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


82-82: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


90-90: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


98-98: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/feedback-result-display.en-US.md

24-24: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


32-32: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


40-40: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


48-48: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


56-56: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


66-66: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


74-74: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/hybrid-ui-design.en-US.md

19-19: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


25-25: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


37-37: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


41-41: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/role-design.zh-CN.md

19-19: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


23-23: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


29-29: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


35-35: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


41-41: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


47-47: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/smooth-natural.zh-CN.md

37-37: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/guide-intention-expression.en-US.md

15-15: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


27-27: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/hint.en-US.md

22-22: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


33-33: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


38-38: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


45-45: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


50-50: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/expression-user-send.en-US.md

24-24: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


32-32: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


40-40: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


44-44: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


48-48: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


52-52: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


60-60: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


64-64: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


74-74: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


84-84: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


92-92: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


100-100: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


108-108: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/authentic-consistent.en-US.md

39-39: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/human-touch.en-US.md

38-38: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/feedback-result-application.en-US.md

24-24: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


32-32: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


40-40: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


44-44: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


52-52: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


60-60: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


68-68: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/confirm.zh-CN.md

20-20: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


32-32: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


46-46: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


60-60: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


71-71: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


76-76: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


84-84: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


93-93: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


98-98: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/guide-intention-expression.zh-CN.md

15-15: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


27-27: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/error.en-US.md

130-130: Expected: h4; Actual: h5
Heading levels should only increment by one level at a time

(MD001, heading-increment)


39-39: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


46-46: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


51-51: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


62-62: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


67-67: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


80-80: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


89-89: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


97-97: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


105-105: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


119-119: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


132-132: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/end.en-US.md

20-20: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


27-27: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


36-36: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


46-46: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


53-53: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


62-62: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


70-70: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


77-77: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


86-86: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/error.zh-CN.md

130-130: Expected: h4; Actual: h5
Heading levels should only increment by one level at a time

(MD001, heading-increment)


39-39: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


46-46: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


51-51: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


62-62: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


67-67: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


80-80: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


89-89: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


97-97: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


105-105: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


119-119: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


132-132: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/confirm.en-US.md

20-20: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


32-32: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


46-46: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


60-60: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


71-71: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


76-76: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


84-84: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


93-93: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


98-98: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/wake-up-welcome-message.en-US.md

22-22: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


32-32: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


47-47: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


51-51: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


59-59: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


63-63: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


71-71: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


75-75: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


83-83: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


91-91: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/end.zh-CN.md

20-20: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


27-27: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


36-36: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


46-46: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


53-53: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


62-62: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


70-70: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


77-77: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


86-86: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/follow-up.en-US.md

26-26: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


33-33: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


38-38: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


45-45: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


50-50: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


67-67: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/confirm-generation-process.en-US.md

24-24: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


32-32: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


40-40: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


50-50: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


58-58: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


68-68: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


76-76: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/confirm-generation-process.zh-CN.md

24-24: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


32-32: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


40-40: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


50-50: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


58-58: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


68-68: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


76-76: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/conversation-design.en-US.md

39-39: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


49-49: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


56-56: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


64-64: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


72-72: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


79-79: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


86-86: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


94-94: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


102-102: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


110-110: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


118-118: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


125-125: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


132-132: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


140-140: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


148-148: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


156-156: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

🔇 Additional comments (17)
docs/spec/provide-intention-expectation.en-US.md (1)

Line range hint 1-8: 标题和顺序的修改提升了文档的结构性

文档标题从"❤️ Intention 意图设计"更改为"提供意图预期",顺序从1调整为2,这些改动使文档结构更加清晰和有序。

🧰 Tools
🪛 Markdownlint (0.35.0)

9-9: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


17-17: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/start.zh-CN.md (1)

11-13: 标题格式统一化改进

将"WHAT|概述"改为"WHAT 概述"使文档格式更加统一,提升了可读性。

🧰 Tools
🪛 LanguageTool

[uncategorized] ~13-~13: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:正确"地"期望
Context: ...I 能为他们做些什么,而不是给他们一种正在接受教程的感觉。首要任务是迅速设定正确的期望,引导用户发现 AI 的功能,并将对话的主动权交还给用户。 ## HOW ...

(wb4)

docs/spec/guide-intention-expression.zh-CN.md (2)

8-8: 需要为图片添加 alt 文本以提高可访问性

请参考英文版本中的相同修改建议。

Also applies to: 15-15, 27-27, 34-34


13-13: 建议修正语言表达中的语法问题

请参考英文版本中的相同修改建议。

Also applies to: 25-25

🧰 Tools
🪛 LanguageTool

[uncategorized] ~13-~13: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:自然"地"引导
Context: ...位。为了准确的引导用户将这些关键信息表达清楚,我们需要在交互过程中有意识的、自然的引导用户进行对应信息的表达。 ![](https://mdn.alipayob...

(wb4)

docs/spec/define-intention-type.en-US.md (1)

8-8: 需要为图片添加 alt 文本以提高可访问性

请参考之前文件中的相同修改建议。

Also applies to: 18-18, 26-26, 32-32, 36-36, 40-40

docs/spec/role-design.zh-CN.md (1)

8-55: 内容结构清晰,与英文版本保持一致

文档结构完整,内容翻译准确,很好地保持了中英文版本的一致性。

🧰 Tools
🪛 Markdownlint (0.35.0)

9-9: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


19-19: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


23-23: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


29-29: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


35-35: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


41-41: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


47-47: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


55-55: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/feedback-result-display.zh-CN.md (1)

Line range hint 1-79: 文档结构清晰,内容组织合理

文档整体结构层次分明,各个部分的说明详实,使用 ImagePreview 组件展示图片的方式统一且专业。

🧰 Tools
🪛 LanguageTool

[uncategorized] ~27-~27: 数量词修饰并列短语,可能产生歧义
Context: ...> 作为最基础的展示形式,需要处理好单行文本、多行文本和结构化文本(如列表、标题段落等)的呈现。通过合理的间距、字号和段落划分,提升长文本的...

(s5)


[uncategorized] ~29-~29: “片”不能与“内容”搭配,可改为:""图篇"内容"
Context: ...性。对重点内容可使用高亮、加粗等样式突出,但需控制使用频率避免干扰。 ### 图片内容 <img class="preview-i...

(wa5)


[uncategorized] ~43-~43: “门”不能与“容器”搭配,请更换量词。
Context: ...AQ/fmt.webp"> 为展示代码片段设计专门容器。使用等宽字体,支持代码语法高亮以增强可读性。提供代码复制功能,方便用户使用...

(wa5)

🪛 Markdownlint (0.35.0)

24-24: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


32-32: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


40-40: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


48-48: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


56-56: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


66-66: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


74-74: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/human-touch.zh-CN.md (1)

13-42: 文档内容丰富,结构清晰

文档详细阐述了情感化设计的各个方面,包括定义、适用场景和最佳案例,内容组织合理,表达准确。特别是在描述适用场景时,针对不同领域的特点进行了细致的说明。

🧰 Tools
🪛 Markdownlint (0.35.0)

38-38: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

🪛 LanguageTool

[uncategorized] ~26-~26: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:耐心"地"陪伴
Context: ...。 - 特殊关怀及服务: 面向老年人的设计,情感化的角色能提供温馨、耐心的陪伴,减轻孤独感,满足情感需求。 针对有特殊需求的用户(如残障人士),情感化设计...

(wb4)


[uncategorized] ~26-~26: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:敏感"地"支持
Context: ...足情感需求。 针对有特殊需求的用户(如残障人士),情感化设计能提供更加贴心、敏感的支持,增强自主生活能力。面对紧急服务与危机应对,如灾害警报、医疗急救指导,情感化...

(wb4)

docs/spec/wake-up-welcome-message.zh-CN.md (1)

Line range hint 1-96: 文件内容与英文版本相同,需要应用相同的改进建议

请参考英文版本(wake-up-welcome-message.en-US.md)的修改建议,对中文版本进行相同的优化。

🧰 Tools
🪛 Markdownlint (0.35.0)

9-9: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


22-22: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


32-32: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


47-47: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


51-51: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


59-59: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


63-63: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


71-71: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


75-75: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


83-83: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


91-91: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

🪛 LanguageTool

[uncategorized] ~15-~15: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:合适"地"欢迎
Context: ...快速理解AI能做什么,可以清晰传达给用户AI可实现的意图范围和预期功能。使用合适的欢迎推荐组件,可以有效降低用户学习成本,让用户能够在短时间内对 AI 的各项能力...

(wb4)


[uncategorized] ~66-~66: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:清晰"地"欢迎
Context: ...ADgCCAQ/fmt.webp"> 简明清晰的欢迎介绍,推荐提示功能显示主标题和辅助解释,让用户更易理解,文案可自定义。 #...

(wb4)

docs/spec/end.zh-CN.md (1)

Line range hint 1-93: 文档内容与英文版本一致,建议复用之前的修改建议

该文件与英文版本内容完全一致,建议应用相同的改进建议。

🧰 Tools
🪛 LanguageTool

[uncategorized] ~23-~23: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:进一步"地"帮助
Context: ...确认对话的结束,使用户感到满意和被尊重。此外,AI 应主动询问用户是否需要进一步的帮助或有其他问题,以确保用户在对话结束时感到被充分照顾。 #### 组件构成 ...

(wb4)


[uncategorized] ~57-~57: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:可行"地"替代
Context: ...对话将会终止。在这种情况下,关键的做法是坦诚地承认 AI 能力的不足,并提供可行的替代方案或引导用户通过其他途径实现目标。此外,这也是收集反馈和数据的宝贵机会,用...

(wb4)

🪛 Markdownlint (0.35.0)

20-20: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


27-27: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


36-36: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


46-46: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


53-53: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


62-62: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


70-70: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


77-77: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


86-86: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/expression-user-send.zh-CN.md (1)

Line range hint 1-113: 文档结构清晰,内容完整

文档结构层次分明,各个部分的说明详尽,很好地覆盖了用户交互的各个方面。内容的组织方式有助于读者理解。

🧰 Tools
🪛 Markdownlint (0.35.0)

24-24: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


32-32: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


40-40: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


44-44: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


48-48: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


52-52: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


60-60: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


64-64: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


74-74: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


84-84: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


92-92: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


100-100: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


108-108: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/error.en-US.md (1)

Line range hint 1-132: 跳过重复内容的审查

此文件与中文版本 error.zh-CN.md 内容相同,相关改进建议已在中文版本的审查中提出。

🧰 Tools
🪛 LanguageTool

[uncategorized] ~57-~57: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:正确"地"输入
Context: ...用户快速识别并选择最符合其需求的选项。 2. 提供示例:通过示例展示正确的输入格式或期望的答案类型,帮助用户更准确地表达他们的请求。 3. *预测需求...

(wb4)


[uncategorized] ~70-~70: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:连续"地"挫败
Context: ...Q/fmt.webp"> 为了避免用户经历连续的挫败感,AI 应在两次尝试理解用户意图失败后,主动结束对话。在这种情况下,提供不...

(wb4)


[uncategorized] ~75-~75: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:诚实"地"沟通
Context: ...决方案或建议用户寻求其他帮助渠道。 4. 保持透明和诚实:通过透明和诚实的沟通,系统可以维护用户的信任,并为未来的交互留下积极的印象。 5. **收集反馈...

(wb4)


[uncategorized] ~127-~127: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:进一步"地"帮助
Context: ...或建议。 4. 引导用户:如果问题无法立即解决,应指导用户如何寻求进一步的帮助或联系技术支持。 5. 记录和分析:系统应自动记录错误详情,以便进行...

(wb4)

🪛 Markdownlint (0.35.0)

130-130: Expected: h4; Actual: h5
Heading levels should only increment by one level at a time

(MD001, heading-increment)


39-39: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


46-46: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


51-51: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


62-62: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


67-67: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


80-80: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


89-89: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


97-97: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


105-105: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


119-119: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


132-132: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/introduce.en-US.md (1)

Line range hint 1-159: 文档结构清晰,内容完整

文档很好地介绍了 RICH 设计范式的概念、背景和应用,层次分明,案例丰富。

🧰 Tools
🪛 Markdownlint (0.35.0)

5-5: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/conversation-design.zh-CN.md (1)

Line range hint 1-172: 文档结构完整,内容详实

文档很好地阐述了对话设计的原则和最佳实践,分类清晰,示例丰富。

🧰 Tools
🪛 LanguageTool

[uncategorized] ~45-~45: 您的意思是“"不"全”?
Context: ...战,例如意图识别的不准确性可能导致错误回复,以及槽位信息的缺失可能需要多轮对话来补全信息。对话交互的核心目标是解决用户问题并提高效率,任何对话交互设计都应遵循这一...

(BU)


[uncategorized] ~75-~75: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:专门"地"支持
Context: ...gePreview> 对话主体应具备针对性,针对特定的决策问题和决策者提供专门的支持。这意味着 AI 需要能够根据用户的具体需求,提供定制化的信息和建议,以增强...

(wb4)


[uncategorized] ~81-~81: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:有效"地"沟通
Context: ...p) 在对话设计中,使用的话术要易于用户记忆、理解及清晰表意,从而实现更加有效的沟通。 #### 1.任务相关性 <img c...

(wb4)

🪛 Markdownlint (0.35.0)

39-39: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


49-49: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


56-56: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


64-64: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


72-72: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


79-79: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


86-86: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


94-94: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


102-102: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


110-110: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


118-118: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


125-125: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


132-132: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


140-140: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


148-148: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


156-156: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/confirm-generation-process.en-US.md (1)

Line range hint 1-79: 文档结构清晰,内容完整

文档很好地说明了 AI 处理过程中的各种状态展示和反馈机制,对提升用户体验很有帮助。

🧰 Tools
🪛 Markdownlint (0.35.0)

24-24: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


32-32: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


40-40: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


50-50: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


58-58: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


68-68: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


76-76: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/confirm-generation-process.zh-CN.md (1)

Line range hint 1-79: 文档结构清晰,内容组织合理

文档层次分明,各个部分的说明详尽且易于理解。

🧰 Tools
🪛 Markdownlint (0.35.0)

24-24: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


32-32: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


40-40: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


50-50: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


58-58: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


68-68: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


76-76: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

docs/spec/smooth-natural.zh-CN.md (1)

Line range hint 1-43: 文档结构清晰,内容完整

文档整体结构合理,各个部分衔接自然,内容详实。成功地阐述了 AI 角色设计中的自然交互原则。

🧰 Tools
🪛 Markdownlint (0.35.0)

37-37: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


43-43: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

🪛 LanguageTool

[uncategorized] ~13-~13: 1.动词被副词修饰时,助词应该用‘得’;2.省略宾语时,助词应该用‘的’;可能造成歧义。您的意思是不是:表达"得"自然流畅
Context: ... 如何定义 角色在与用户互动时展现出人类交流的流畅性和真实性。这涉及到语言表达的自然流畅,使用贴近人类日常对话的词汇和语法,避免机械和生硬的表达。同时,角色的行...

(wb4)


[uncategorized] ~13-~13: 动词的修饰一般为‘形容词(副词)+地+动词’。您的意思是否是:生硬"地"表达
Context: ...性。这涉及到语言表达的自然流畅,使用贴近人类日常对话的词汇和语法,避免机械和生硬的表达。同时,角色的行为反应也应自然合理,能够根据用户的输入做出恰当的、符合情境的...

(wb4)


在对话中,语言往往存在多种解释,通常依赖上下文来消除歧义。当上下文信息不足以明确含义时,应主动向用户请求额外的信息以澄清问题。
<ImagePreview>
<img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*D2ntT7HfxeIAAAAAAAAAAAAADgCCAQ/fmt.webp">
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🛠️ Refactor suggestion

建议为所有图片添加 alt 文本以提高可访问性

为了确保文档对所有用户都是可访问的,包括使用屏幕阅读器的用户,建议为所有图片添加描述性的替代文本。

示例修改:

- <img class="preview-img no-padding" src="...">
+ <img class="preview-img no-padding" alt="消歧场景示例图" src="...">

Also applies to: 38-38, 50-50, 67-67

🧰 Tools
🪛 Markdownlint (0.35.0)

26-26: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

@@ -20,38 +20,54 @@ title: 反馈|结果应用

### 复制

最常用的内容应用方式。点击后立即将 AI 生成的内容复制到剪切板,同时图标切换为完成状态给予反馈。复制范围包括文本、代码等可复制内容,要保证格式完整性。
<ImagePreview>
<img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*QOSfTLjK1kEAAAAAAAAAAAAADgCCAQ/fmt.webp">
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🛠️ Refactor suggestion

为所有图片预览添加 alt 文本

为提升文档的可访问性,建议为所有图片预览添加合适的替代文本。

示例修改:

- <img class="preview-img no-padding" src="...">
+ <img class="preview-img no-padding" alt="复制功能界面预览" src="...">

对其他图片预览也进行类似修改,确保每个图片都有相应的描述性文本。

Also applies to: 32-32, 40-40, 44-44, 52-52, 60-60, 68-68

🧰 Tools
🪛 Markdownlint (0.35.0)

24-24: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

Comment on lines +23 to +74
<ImagePreview>
<img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*c_8JTrMpRJ8AAAAAAAAAAAAADgCCAQ/fmt.webp">
</ImagePreview>

![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*c_8JTrMpRJ8AAAAAAAAAAAAADgCCAQ/fmt.webp)
作为最基础的展示形式,需要处理好单行文本、多行文本和结构化文本(如列表、标题段落等)的呈现。通过合理的间距、字号和段落划分,提升长文本的可读性。对重点内容可使用高亮、加粗等样式突出,但需控制使用频率避免干扰。

### 图片内容

展示 AI 生成或处理的图片结果。默认以合适尺寸展示,支持预览大图和缩放细节。多图场景需注意排版美观,加载时提供占位图以避免布局跳动。
<ImagePreview>
<img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*S8ljSJ-V6YIAAAAAAAAAAAAADgCCAQ/fmt.webp">
</ImagePreview>

![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*S8ljSJ-V6YIAAAAAAAAAAAAADgCCAQ/fmt.webp)
展示 AI 生成或处理的图片结果。默认以合适尺寸展示,支持预览大图和缩放细节。多图场景需注意排版美观,加载时提供占位图以避免布局跳动。

### 代码内容

为展示代码片段设计专门容器。使用等宽字体,支持代码语法高亮以增强可读性。提供代码复制功能,方便用户使用。代码过长时支持横向滚动,保持代码格式完整性。
<ImagePreview>
<img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*io9ISYEQJ_sAAAAAAAAAAAAADgCCAQ/fmt.webp">
</ImagePreview>

![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*io9ISYEQJ_sAAAAAAAAAAAAADgCCAQ/fmt.webp)
为展示代码片段设计专门容器。使用等宽字体,支持代码语法高亮以增强可读性。提供代码复制功能,方便用户使用。代码过长时支持横向滚动,保持代码格式完整性。

### 交互卡片

用于特定场景下需要用户操作的结构化内容,如表单填写、参数调整等。卡片内可包含按钮、输入框等交互元素,操作需提供明确的反馈。
<ImagePreview>
<img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*5TshRpA9w_4AAAAAAAAAAAAADgCCAQ/fmt.webp">
</ImagePreview>

![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*5TshRpA9w_4AAAAAAAAAAAAADgCCAQ/fmt.webp)
用于特定场景下需要用户操作的结构化内容,如表单填写、参数调整等。卡片内可包含按钮、输入框等交互元素,操作需提供明确的反馈。

### 其他

用于展示表格、数学公式等特殊格式内容。可以与普通文本内容混合展示,保持整体视觉一致性。特殊内容的展示需考虑性能和兼容性,必要时提供降级方案。

![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*-MuHQo41bPYAAAAAAAAAAAAADgCCAQ/fmt.webp)
<ImagePreview>
<img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*-MuHQo41bPYAAAAAAAAAAAAADgCCAQ/fmt.webp">
</ImagePreview>

---
用于展示表格、数学公式等特殊格式内容。可以与普通文本内容混合展示,保持整体视觉一致性。特殊内容的展示需考虑性能和兼容性,必要时提供降级方案。

## 内容组织

### 内容折叠

针对超过一屏的长内容,提供折叠功能以提升浏览效率。默认展示预览内容,用户可根据需要展开查看完整信息。折叠状态需有明确提示,展开/收起过程动画需流畅。
<ImagePreview>
<img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*VhKkQ78jX0MAAAAAAAAAAAAADgCCAQ/fmt.webp">
</ImagePreview>

![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*VhKkQ78jX0MAAAAAAAAAAAAADgCCAQ/fmt.webp)
针对超过一屏的长内容,提供折叠功能以提升浏览效率。默认展示预览内容,用户可根据需要展开查看完整信息。折叠状态需有明确提示,展开/收起过程动画需流畅。

### 内容参考来源展示

<ImagePreview>
<img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*L5sWQ6w_qjoAAAAAAAAAAAAADgCCAQ/fmt.webp">
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🛠️ Refactor suggestion

建议为所有图片添加 alt 文本以提升可访问性

为了确保文档对使用屏幕阅读器的用户友好,建议为所有 <img> 标签添加描述性的 alt 属性。

示例修改:

- <img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*c_8JTrMpRJ8AAAAAAAAAAAAADgCCAQ/fmt.webp">
+ <img class="preview-img no-padding" alt="文本内容展示示例" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*c_8JTrMpRJ8AAAAAAAAAAAAADgCCAQ/fmt.webp">

Committable suggestion skipped: line range outside the PR's diff.

🧰 Tools
🪛 LanguageTool

[uncategorized] ~27-~27: 数量词修饰并列短语,可能产生歧义
Context: ...> 作为最基础的展示形式,需要处理好单行文本、多行文本和结构化文本(如列表、标题段落等)的呈现。通过合理的间距、字号和段落划分,提升长文本的...

(s5)


[uncategorized] ~29-~29: “片”不能与“内容”搭配,可改为:""图篇"内容"
Context: ...性。对重点内容可使用高亮、加粗等样式突出,但需控制使用频率避免干扰。 ### 图片内容 <img class="preview-i...

(wa5)


[uncategorized] ~43-~43: “门”不能与“容器”搭配,请更换量词。
Context: ...AQ/fmt.webp"> 为展示代码片段设计专门容器。使用等宽字体,支持代码语法高亮以增强可读性。提供代码复制功能,方便用户使用...

(wa5)

🪛 Markdownlint (0.35.0)

24-24: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


32-32: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


40-40: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


48-48: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


56-56: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


66-66: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


74-74: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

Comment on lines +23 to +74
<ImagePreview>
<img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*c_8JTrMpRJ8AAAAAAAAAAAAADgCCAQ/fmt.webp">
</ImagePreview>

![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*c_8JTrMpRJ8AAAAAAAAAAAAADgCCAQ/fmt.webp)
作为最基础的展示形式,需要处理好单行文本、多行文本和结构化文本(如列表、标题段落等)的呈现。通过合理的间距、字号和段落划分,提升长文本的可读性。对重点内容可使用高亮、加粗等样式突出,但需控制使用频率避免干扰。

### 图片内容

展示 AI 生成或处理的图片结果。默认以合适尺寸展示,支持预览大图和缩放细节。多图场景需注意排版美观,加载时提供占位图以避免布局跳动。
<ImagePreview>
<img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*S8ljSJ-V6YIAAAAAAAAAAAAADgCCAQ/fmt.webp">
</ImagePreview>

![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*S8ljSJ-V6YIAAAAAAAAAAAAADgCCAQ/fmt.webp)
展示 AI 生成或处理的图片结果。默认以合适尺寸展示,支持预览大图和缩放细节。多图场景需注意排版美观,加载时提供占位图以避免布局跳动。

### 代码内容

为展示代码片段设计专门容器。使用等宽字体,支持代码语法高亮以增强可读性。提供代码复制功能,方便用户使用。代码过长时支持横向滚动,保持代码格式完整性。
<ImagePreview>
<img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*io9ISYEQJ_sAAAAAAAAAAAAADgCCAQ/fmt.webp">
</ImagePreview>

![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*io9ISYEQJ_sAAAAAAAAAAAAADgCCAQ/fmt.webp)
为展示代码片段设计专门容器。使用等宽字体,支持代码语法高亮以增强可读性。提供代码复制功能,方便用户使用。代码过长时支持横向滚动,保持代码格式完整性。

### 交互卡片

用于特定场景下需要用户操作的结构化内容,如表单填写、参数调整等。卡片内可包含按钮、输入框等交互元素,操作需提供明确的反馈。
<ImagePreview>
<img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*5TshRpA9w_4AAAAAAAAAAAAADgCCAQ/fmt.webp">
</ImagePreview>

![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*5TshRpA9w_4AAAAAAAAAAAAADgCCAQ/fmt.webp)
用于特定场景下需要用户操作的结构化内容,如表单填写、参数调整等。卡片内可包含按钮、输入框等交互元素,操作需提供明确的反馈。

### 其他

用于展示表格、数学公式等特殊格式内容。可以与普通文本内容混合展示,保持整体视觉一致性。特殊内容的展示需考虑性能和兼容性,必要时提供降级方案。

![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*-MuHQo41bPYAAAAAAAAAAAAADgCCAQ/fmt.webp)
<ImagePreview>
<img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*-MuHQo41bPYAAAAAAAAAAAAADgCCAQ/fmt.webp">
</ImagePreview>

---
用于展示表格、数学公式等特殊格式内容。可以与普通文本内容混合展示,保持整体视觉一致性。特殊内容的展示需考虑性能和兼容性,必要时提供降级方案。

## 内容组织

### 内容折叠

针对超过一屏的长内容,提供折叠功能以提升浏览效率。默认展示预览内容,用户可根据需要展开查看完整信息。折叠状态需有明确提示,展开/收起过程动画需流畅。
<ImagePreview>
<img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*VhKkQ78jX0MAAAAAAAAAAAAADgCCAQ/fmt.webp">
</ImagePreview>

![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*VhKkQ78jX0MAAAAAAAAAAAAADgCCAQ/fmt.webp)
针对超过一屏的长内容,提供折叠功能以提升浏览效率。默认展示预览内容,用户可根据需要展开查看完整信息。折叠状态需有明确提示,展开/收起过程动画需流畅。

### 内容参考来源展示

<ImagePreview>
<img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*L5sWQ6w_qjoAAAAAAAAAAAAADgCCAQ/fmt.webp">
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🛠️ Refactor suggestion

建议为所有图片添加 alt 文本以提升可访问性

英文版文档同样需要为所有 <img> 标签添加描述性的 alt 属性,建议使用英文描述。

示例修改:

- <img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*c_8JTrMpRJ8AAAAAAAAAAAAADgCCAQ/fmt.webp">
+ <img class="preview-img no-padding" alt="Text content display example" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*c_8JTrMpRJ8AAAAAAAAAAAAADgCCAQ/fmt.webp">

Committable suggestion skipped: line range outside the PR's diff.

🧰 Tools
🪛 LanguageTool

[uncategorized] ~27-~27: 数量词修饰并列短语,可能产生歧义
Context: ...> 作为最基础的展示形式,需要处理好单行文本、多行文本和结构化文本(如列表、标题段落等)的呈现。通过合理的间距、字号和段落划分,提升长文本的...

(s5)


[uncategorized] ~29-~29: “片”不能与“内容”搭配,可改为:""图篇"内容"
Context: ...性。对重点内容可使用高亮、加粗等样式突出,但需控制使用频率避免干扰。 ### 图片内容 <img class="preview-i...

(wa5)


[uncategorized] ~43-~43: “门”不能与“容器”搭配,请更换量词。
Context: ...AQ/fmt.webp"> 为展示代码片段设计专门容器。使用等宽字体,支持代码语法高亮以增强可读性。提供代码复制功能,方便用户使用...

(wa5)

🪛 Markdownlint (0.35.0)

24-24: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


32-32: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


40-40: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


48-48: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


56-56: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


66-66: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


74-74: null
Images should have alternate text (alt text)

(MD045, no-alt-text)


细腻的**情感适应性**使虚拟陪伴类 AI 能感知并响应用户情绪,建立情感纽带,给予适时的支持与反馈;**互动的个性化**确保体验贴合每位用户的独特性,增强归属感与真实感;**丰富的语言表达**使互动生动多彩,促进深层次沟通。三者结合,极大提升 AI 质量,满足用户情感需求,构建更加亲密和谐的人机交互环境
细腻的**情感适应性**使虚拟陪伴类 AI 能感知并响应用户情绪,建立情感纽带,给予适时的支持与反馈;**互动的个性化**确保体验贴合每位用户的独特性,增强归属感与真实感;**丰富的语言表达**则让交流生动多彩,促进深层次沟通,使互动既智慧又充满人性温度。**情感的适应性、互动的个性化、丰富的语言表达**这三点共同作用,极大提升了 AI 的质量,满足用户情感与心理需求,构建了更加亲密和谐的人机交互环境

![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*n-oTTJjH_fIAAAAAAAAAAAAADgCCAQ/fmt.webp)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🛠️ Refactor suggestion

建议为图片添加 alt 文本

为提升文档的可访问性,建议为文档中的图片添加 alt 属性。

示例修改:

- ![](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*n-oTTJjH_fIAAAAAAAAAAAAADgCCAQ/fmt.webp)
+ ![情感适应性与互动个性化示例](https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*n-oTTJjH_fIAAAAAAAAAAAAADgCCAQ/fmt.webp)

Also applies to: 44-44

🧰 Tools
🪛 Markdownlint (0.35.0)

38-38: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

@@ -12,7 +12,7 @@

## 设计目标

当用户有明确诉求时,需借助不同形式的输入交互来向 AI 精准表达意图,以此提升 AI 对用户意图传达的理解程度,进而给出准确回应。**输入组件**在表达阶段发挥着重要作用,借助多种形式(如文字描述、图片上传、语音输入等)的输入组件,为用户与 AI 的交互增添了更多可能性与灵活性,让用户能够以自然、便捷且正确地完成输入内容并发送。
当用户有明确诉求时,需借助不同形式的输入交互来向 AI 精准表达意图,以此提升 AI 对用户意图传达的理解程度,进而给出准确回应。输入组件在表达阶段发挥着重要作用,借助多种形式(如文字描述、图片伤处、语音输入等)的输入组件,为用户与 AI 的交互增添了更多可能性与灵活性,让用户能够以自然、便捷且正确地完成输入内容并发送。
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue

修正文字错误

文本中存在一处错别字。

-借助多种形式(如文字描述、图片伤处、语音输入等)的输入组件
+借助多种形式(如文字描述、图片上传、语音输入等)的输入组件
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
当用户有明确诉求时,需借助不同形式的输入交互来向 AI 精准表达意图,以此提升 AI 对用户意图传达的理解程度,进而给出准确回应。【输入组件】在表达阶段发挥着重要作用,借助多种形式(如文字描述、图片伤处、语音输入等)的输入组件,为用户与 AI 的交互增添了更多可能性与灵活性,让用户能够以自然、便捷且正确地完成输入内容并发送。
当用户有明确诉求时,需借助不同形式的输入交互来向 AI 精准表达意图,以此提升 AI 对用户意图传达的理解程度,进而给出准确回应。【输入组件】在表达阶段发挥着重要作用,借助多种形式(如文字描述、图片上传、语音输入等)的输入组件,为用户与 AI 的交互增添了更多可能性与灵活性,让用户能够以自然、便捷且正确地完成输入内容并发送。

Comment on lines +167 to +172
| **唤醒** | 开始 | [Link](/docs/spec/start-cn) |
| **识别** | 追问 | [Link](docs/spec/follow-up-cn) |
| | 提示 | [Link](docs/spec/hint-cn) |
| **确认** | 确认 | [Link](docs/spec/confirm-cn) |
| | 错误 | [Link](docs/spec/error-cn) |
| **反馈** | 结束 | [Link](docs/spec/end-cn) |
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codebase verification

⚠️ Potential issue

文档链接需要更新

表格中的链接需要进行以下修正:

  • 所有链接都应该指向 .zh-CN.md 结尾的文件
  • 缺少的 "/" 需要添加
  • 链接路径需要更新为正确的格式

正确的链接应该是:

  • /docs/spec/start.zh-CN/docs/spec/start.zh-CN.md
  • /docs/spec/follow-up.zh-CN/docs/spec/follow-up.zh-CN.md
  • /docs/spec/hint.zh-CN/docs/spec/hint.zh-CN.md
  • /docs/spec/confirm.zh-CN/docs/spec/confirm.zh-CN.md
  • /docs/spec/error.zh-CN/docs/spec/error.zh-CN.md
  • /docs/spec/end.zh-CN/docs/spec/end.zh-CN.md
🔗 Analysis chain

需要验证文档链接的正确性

请检查表格中的链接是否正确,特别是:

  • "docs/spec/follow-up-cn" 缺少开头的 "/"
  • 其他链接路径的正确性

Let me search for similar files to see if there might be a different naming pattern or location for these documentation files.

🏁 Scripts executed

The following scripts were executed for the analysis:

Script:

#!/bin/bash
# 验证文档链接是否存在
for link in "/docs/spec/start-cn" "/docs/spec/follow-up-cn" "/docs/spec/hint-cn" "/docs/spec/confirm-cn" "/docs/spec/error-cn" "/docs/spec/end-cn"; do
  if [ -f ".${link}.md" ] || [ -f ".${link}/index.md" ]; then
    echo "✓ Found: $link"
  else
    echo "✗ Missing: $link"
  fi
done

Length of output: 1811


Script:

#!/bin/bash
# Search for similar documentation files
fd -e md -e mdx . docs/spec/

Length of output: 1756

Comment on lines +23 to +25
<ImagePreview>
<img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*RR6eTbVD-tIAAAAAAAAAAAAADgCCAQ/fmt.webp">
</ImagePreview>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🛠️ Refactor suggestion

建议为所有图片添加 alt 文本以提高可访问性

为了确保文档的可访问性,建议为所有 <img> 标签添加 alt 属性,描述图片内容。这对使用屏幕阅读器的用户尤为重要。

示例修改:

- <img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*RR6eTbVD-tIAAAAAAAAAAAAADgCCAQ/fmt.webp">
+ <img class="preview-img no-padding" alt="动画加载示例" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*RR6eTbVD-tIAAAAAAAAAAAAADgCCAQ/fmt.webp">

Also applies to: 31-33, 39-41, 49-51, 57-59, 67-69, 75-77

🧰 Tools
🪛 Markdownlint (0.35.0)

24-24: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

Comment on lines +55 to +57
<ImagePreview>
<img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*_SoFRY_Rm30AAAAAAAAAAAAADgCCAQ/fmt.webp">
</ImagePreview>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🛠️ Refactor suggestion

建议为所有图片添加 alt 文本

为了提高文档的可访问性,建议为所有 <ImagePreview> 组件中的图片添加描述性的 alt 属性。

示例修改:

- <img class="preview-img no-padding" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*_SoFRY_Rm30AAAAAAAAAAAAADgCCAQ/fmt.webp">
+ <img class="preview-img no-padding" alt="AI 提供真实信息示例" src="https://mdn.alipayobjects.com/huamei_iwk9zp/afts/img/A*_SoFRY_Rm30AAAAAAAAAAAAADgCCAQ/fmt.webp">

Also applies to: 63-65, 71-73, 85-87, 93-95, 101-103, 109-111, 117-119, 131-133, 139-141, 147-149, 155-157

🧰 Tools
🪛 Markdownlint (0.35.0)

56-56: null
Images should have alternate text (alt text)

(MD045, no-alt-text)

Comment on lines +167 to +172
| **唤醒** | 开始 | [Link](/docs/spec/start) |
| **识别** | 追问 | [Link](docs/spec/follow-up) |
| | 提示 | [Link](docs/spec/hint) |
| **确认** | 确认 | [Link](docs/spec/confirm) |
| | 错误 | [Link](docs/spec/error) |
| **反馈** | 结束 | [Link](docs/spec/end) |
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue

需要修正文档链接路径

表格中的链接路径存在问题,需要统一格式并确保正确性。

建议修改如下:

- |   **识别**   |     追问     | [Link](docs/spec/follow-up) |
- |              |     提示     |   [Link](docs/spec/hint)    |
- |   **确认**   |     确认     |  [Link](docs/spec/confirm)  |
- |              |     错误     |   [Link](docs/spec/error)   |
- |   **反馈**   |     结束     |    [Link](docs/spec/end)    |
+ |   **识别**   |     追问     | [Link](/docs/spec/follow-up) |
+ |              |     提示     |   [Link](/docs/spec/hint)    |
+ |   **确认**   |     确认     |  [Link](/docs/spec/confirm)  |
+ |              |     错误     |   [Link](/docs/spec/error)   |
+ |   **反馈**   |     结束     |    [Link](/docs/spec/end)    |
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
| **唤醒** | 开始 | [Link](/docs/spec/start) |
| **识别** | 追问 | [Link](docs/spec/follow-up) |
| | 提示 | [Link](docs/spec/hint) |
| **确认** | 确认 | [Link](docs/spec/confirm) |
| | 错误 | [Link](docs/spec/error) |
| **反馈** | 结束 | [Link](docs/spec/end) |
| **唤醒** | 开始 | [Link](/docs/spec/start) |
| **识别** | 追问 | [Link](/docs/spec/follow-up) |
| | 提示 | [Link](/docs/spec/hint) |
| **确认** | 确认 | [Link](/docs/spec/confirm) |
| | 错误 | [Link](/docs/spec/error) |
| **反馈** | 结束 | [Link](/docs/spec/end) |

Copy link

size-limit report 📦

Path Size
dist/antdx.min.js 40.66 KB

@YumoImer YumoImer merged commit a6fb0b8 into main Dec 10, 2024
15 checks passed
@YumoImer YumoImer deleted the refactor/docs-spec branch December 10, 2024 17:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants