Nextjs Nextra Starter Distill Zh

Next.js Nextra Starter 蒸馏

使用这个项目内 Skill 来理解、扩展或选择性迁移 nextjs-nextra-starter 的实现。reference 文件是蒸馏后的指南；做结论或改代码前，仍然要读取当前源码，因为仓库可能已经变化。

Reference 路由

• 架构、模块边界、文件职责：读取 references/architecture.md。
• 功能清单、产品能力、实现状态：读取 references/feature-map.md。
• 复用实现模式、改造已有模式：读取 references/implementation-patterns.md。
• 在本仓库继续二次开发：读取 references/extension-guide.md。
• 把模式迁移到其他项目：读取 references/migration-notes.md。

只读取当前任务需要的 reference。跨边界任务可以组合读取，例如新增多语言 landing section 时同时读取实现模式和二开指南。

工作流

1. 先判断用户目标是理解、扩展、迁移还是审查。
2. 读取对应 reference。
3. 按 reference 中的源码路径检查当前实现。
4. 除非用户明确要求替换，否则保留 Nextra、语言、主题和 MDX 的集成点。
5. 当前 auth 流程默认视为前端演示；只有仓库已加入真实后端/session 后才按生产鉴权处理。
6. 涉及运行时行为时，使用最窄有效验证命令，通常是 pnpm lint 或 pnpm build。

注意事项

• 这个 starter 组合了文档站、产品落地页、i18n、主题控制和 UI primitives，不要当成普通 Next.js app 处理。
• src/content/zh 和 src/content/en 是内容源；src/i18n 存放 React 组件复用的 UI 文案。
• _meta.tsx 控制 Nextra 导航和页面级布局行为。
• 一些 client widget 会适配 Nextra 渲染出的 DOM；升级 Nextra 时要重新检查选择器。
• 不要把演示 auth、占位 analytics、静态 metadata 或示例产品文案直接复制到生产环境。