用途:Geistdocs 是 Vercel 的文档模板,基于 Next.js 16 与 Fumadocs,用于搭建产品文档站点,开箱提供 MDX 写作、AI 聊天、i18n、反馈收集、搜索、GitHub 集成与 RSS,目前为 beta。
主要能力:content/docs/ 下的 MDX 文件自动路由,如 content/docs/my-first-page.mdx 对应 /docs/my-first-page;支持 GFM 表格、任务列表、代码块属性(title、lineNumbers、[!code highlight] 等)与 Mermaid 图表;geistdocs.tsx 根配置可设置 Logo、导航、标题、AI 提示词与建议、GitHub 仓库、翻译语言;内置 Edit on GitHub、反馈组件(自动创建带标签的 GitHub Issue)、i18n 语言路由与 pnpm translate 自动翻译、/rss.xml、追加 .md/.mdx 获取原始 Markdown、/llms.txt 汇总全部文档;Ask AI 使用 openai/gpt-4.1-mini 经 Vercel AI Gateway,支持 search_docs 工具、来源引用、IndexedDB 历史、建议提示、文件/图片上传与 Markdown 渲染,快捷键 ⌘I / Ctrl+I。
使用方式:需 Node.js 18+、pnpm、GitHub 账号,并熟悉 MDX、Next.js、React。执行 npx @vercel/geistdocs init 创建项目,然后 cp .env.example .env.local 并 pnpm dev。环境变量包括 AI_GATEWAY_API_KEY 与 NEXT_PUBLIC_VERCEL_PROJECT_PRODUCTION_URL。部署时推送 GitHub,在 vercel.com/new 导入仓库,框架自动识别为 Next.js,构建命令 pnpm build,输出 .next,并配置上述环境变量。常用命令:pnpm dev、pnpm build、pnpm translate。
限制:资料未提供收费、价格、平台支持范围与效果数据;模板处于 beta,具体稳定性与兼容性暂未提供。