关于文档的格式修复

[WangLaoShi]

例行检查

• 我已确认目前没有类似 issue
• 我已完整查看过项目 README，以及项目文档
• 我使用了自己的 key，并确认我的 key 是可正常使用的
• 我理解并愿意跟进此 issue，协助测试和提供反馈
• 我理解并认可上述内容，并理解项目维护者精力有限，不遵循规则的 issue 可能会被无视或直接关闭

尝试修复文档当中的一些格式问题.

在阅读文档的过程中，按照链接修复一下文档的格式问题。

[skyzhao1223]

想确认一下这次格式修复的具体范围,避免做偏或与你正在做的 #7534 重复:

1. 是只修文档书写规范 document/README.md,还是包括 content 下所有文档?
2. 是否限定为叙述性文本中的中英混排(如 "介绍RAG模型" → "介绍 RAG 模型"),不动代码块、JSON 示例、表格和链接 URL?
3. 我看到 content/guide/dataset/rag.mdx 等文档有较多中英混排问题,这些也在范围内吗?

如果方便的话给个明确范围,我可以据此整理一份干净的格式修复 PR。谢谢!

[skyzhao1223]

已提交 PR:#7591,先修复了 guide/dataset/rag.mdx(知识库基础原理介绍)的中文排版。

调查结论(供后续参考)

尝试对全部文档跑 textlint --fix 后发现它不可靠,会在部分文档上破坏结构:

• 合并列表项(如 docker_mongo.mdx 的 - A环境 - B环境 - C环境 三行被合并成一行)
• 改写代码块内容(如 loop.mdx 的 JS 数组被重新格式化)
• 删除空行
• 误判 API 参数名大小写(id→ID)、术语连字符(任务-生成任务→任务 - 生成任务)、文件扩展名(.pdf→.PDF)

因此本次 PR 采用安全脚本 + 人工审查:只做中英文间加空格(保护 URL)+ 修复全角标点空格,并保留仓库现有风格的术语连字符(系统配置-成员配置 这类写法不拆)。

修复效果:rag.mdx 的 textlint error 从 98 处降至 4 处(均为术语连字符误报),121 增 121 删、行数不变、无结构破坏。

后续可参照同样方法逐个文档处理。PR 的 CI 需要维护者批准执行,麻烦看一下,谢谢!