Improve Docs Ux
Archived on 2025-06-08 · roadmap: web-nextjs-builtin-suite
Archived: 2025-06-08 · roadmap-id:
web-nextjs-builtin-suite
Why
apps/docs 有两个关键功能不可用，以及 UI 设计专题缺乏可落地的实践内容：
-
Search 不可用（中文内容无法搜索）：
/api/search/route.ts的 Orama 配置language: 'english'，导致中文文档内容无法被正确分词和索引。随着 docs 内容越来越多（changelog、ui-design、cli 等），搜索是最高频的导航方式，不可用等于 docs 无从发现。 -
AI Chat 不可用：
/api/chat/route.ts使用 OpenRouter + burn.hair 代理，但模型名称（anthropic/claude-3.5-sonnet）和 burn.hair 支持的模型 ID 可能不匹配；同时缺少OPENROUTER_MODEL环境变量配置说明，实现 LLM 无法正确调试。 -
UI 设计专题缺实践内容：
research/index.mdx定义了调研框架，但执行 LLM 从未按框架执行素材搜集和深度调研。缺少可落地的实践教程（当前只有理论）。用户最需要的是：看了就能照着做、能应用到当前项目和 web-nextjs 模板的操作指南。
Capabilities
New Capabilities
docs-search-fix：Search 支持中英文混合，中文文档可被正确搜索docs-chat-fix：AI Chat 可用，模型配置正确，错误边界清晰ui-design-research-execution：执行 LLM 按研究框架完成素材搜集调研，产出 findings + 实践教程
Modified Capabilities
ui-design-docs：新增research/findings.mdx（调研产物）和tutorial.mdx（实践教程）
Non-goals
- 不做 Fumadocs 双语 i18n 路由重构（独立 change：
add-docs-i18n） - 不改 search UI 组件（Fumadocs 内建，仅修 API 层）
- 不实现 自建搜索索引（继续用 Fumadocs + Orama，修语言配置即可）
- 不做 chat 功能的 RAG 升级（当前 flexsearch 方案继续使用）
- 不实现 用户反馈、chat 历史持久化