AgentDock

Add Docs I18n

Archived on 2026-06-08 · roadmap: web-nextjs-builtin-suite

Archived: 2026-06-08 · roadmap-id: web-nextjs-builtin-suite

Why

apps/docs/ 当前是英文为主的单语言文档站,但 AgentDock 的核心用户群(尤其是开发阶段)以中文使用者为主。已有部分文档用中文编写(如 llm-eval/roadmap/ 的中文内容),但没有系统的双语支持:不同文档混用中英文,用户无法按偏好切换语言,缺乏一致性体验。

目标:Fumadocs 双语路由(/zh/docs/... + /en/docs/...)+ 默认中文 + 开发阶段只写中文(英文占位),商用前再补全英文内容。

已有英文内容保留,不删除或降级。

Capabilities

New Capabilities

  • docs-i18n-routing:Fumadocs 双语路由(zh/en),默认 zh,LanguageSelect 切换器

Modified Capabilities

  • docs-search-fix(来自 improve-docs-ux):i18n 后 search route 需适配多语言 source
  • ui-design-docs:中文内容迁移到 zh/ 结构,en/ 为占位

Non-goals

  • 不翻译现有英文内容为中文(反之亦然)——各版本独立维护,不做机器翻译
  • 不做自动语言检测(用户主动切换)
  • 不做 URL 参数语言切换(只用路径前缀 /zh/ / /en/
  • 不改搜索 UI 的语言(Fumadocs 内建,跟随系统/浏览器偏好)

On this page