文档站说明
内容权威源、Mermaid 与预览方式
内容到页面
已证实：docs-site/ 是已初始化的 Fumadocs / Next.js 工程，beautiful-mermaid 已安装并注册。组件采用 Fumadocs 官方 Beautiful Mermaid 接法，调用 renderMermaidSVG，使用 var(--color-fd-background) 与 var(--color-fd-foreground)、transparent: true；失败回退到 CodeBlock + Pre。
权威与投影
设计正文只在 docs/*.md 修改。HANDOFF/ 维护交接，specs/ 维护验收，IMPORT 维护导入范围；App 页只保留摘要并链接这些记录。
npm run docs:sync 从六份权威正文生成 MDX，去掉一级标题、添加元信息，将 Mermaid 围栏转换为显式 <Mermaid chart={…} />，并转换链接。站内设计页链接到 /docs/；HANDOFF、specs、源码链接到仓库 main 上的原文件。本地未合并的新内容需在仓库查看，远端链接可见性取决于提交状态与访问权限。
不依赖裸 Mermaid 围栏自动渲染；没有额外接入 remark Mermaid。npm run docs:check 可检查投影是否过期，并逐图调用实际渲染器，失败返回非零。
预览与构建
cd docs-site
npm ci
npm run docs:sync
npm run docs:check
npm run types:check
npm run dev -- --port 3000
# http://localhost:3000/docs
npm run build导航顺序：入门 → 系统架构 → Monorepo 布局 → 交付闭环 → 文档站说明 → AI Video Editor。为兼容已有链接，文档站说明仍使用 fumadocs-plan 路由。
已证实（2026-11-06）：npm run docs:check 通过（六页投影、导航与八张图 SVG 渲染），npm run types:check 和 npm run build 通过。构建生成 24 个静态页面；仍有未配置 metadataBase 与忽略仓库外锁文件的提示。未验证：搜索体验、全站外链、桌面/移动端及深浅色视觉验收。站点构建通过不代表 App 宿主加载或交付能力通过。
.source/、.next/、node_modules 和日志是生成物，不提交；不读取或写入 Vibe 运行目录，不部署。未知：后续部署地址与对外访问策略。