变更日志(文档)
文档与运维结构的重要变更记录。
2026-04
- 文档搜索:
createFromSource增加localeMap(zh/en使用英文 Orama stemmer),避免 i18n 双索引初始化时报LANGUAGE_NOT_SUPPORTED;status README 阻塞点说明已同步。 - Lint / 依赖:
eslint-config-next移至 devDependencies;adminpresets、profile-stats、debug-modules与profile、[locale]/u/[shortId]页面做了未使用导入/死代码清理与类型收紧。 - i18n / 运维:
i18n/request.ts兜底改为routing.defaultLocale(不再写死zh);中间件对 sign-in 拦截与双重 locale 前缀的日志仅开发环境输出(生产不再打完整 URL);/u/[username]布局读取 Cookieuser-language-preference,否则用defaultLocale;ESLint 已加入 devDependencies,pnpm lint可执行。 - 稳定性: 文档搜索
GET /api/docs/search在真实故障时返回 500(仅对已知「语言不支持」类错误降级为空hits);status README 阻塞点与英文索引行为一致;架构总览 Web3 行改为NEXT_PUBLIC_WEB3_ENABLED(及可选WEB3_ENABLED);ProfileUnifiedModulesDisplay提醒locale跟随next-intl;文档站 layout 显式传入zh翻译表。 - Fumadocs: 修复
[[...slug]]/page.tsx对 MDX 正文的渲染(使用编译后的page.data.body)。 - 三层架构: 入口(
content/docs/index.mdx)、蓝图(architecture/index+architecture/*)、演进(status/README.mdx+changelog)。 - 语言: 文档 loader 支持
en/zh。