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 需适配多语言 sourceui-design-docs:中文内容迁移到zh/结构,en/为占位
Non-goals
- 不翻译现有英文内容为中文(反之亦然)——各版本独立维护,不做机器翻译
- 不做自动语言检测(用户主动切换)
- 不做 URL 参数语言切换(只用路径前缀
/zh///en/) - 不改搜索 UI 的语言(Fumadocs 内建,跟随系统/浏览器偏好)