Geistdocs 文档站搭建
用 Geistdocs 模板搭一个带 AI 问答和多语言的文档站,产出 MDX 内容、配置和部署步骤。
功能与用途
要给产品做官方文档站,希望开箱就有搜索、AI 问答、多语言和反馈收集,但不想从零配 Next.js 那一套。这个技能用 Vercel 的 Geistdocs 模板初始化项目,带你写 MDX 页面、配置导航与多语言、接入 AI 助手和 llms.txt,最后部署到 Vercel。需要 Node.js 18+、pnpm 和 GitHub 账号。
适用场景
- 产品要上线官方文档站,希望自带 AI 问答和搜索,不想自己拼:产品要上线官方文档站,希望自带 AI 问答和搜索,不想自己拼组件
- 文档要同时出中文和英文版本,一条条手翻太慢:文档要同时出中文和英文版本,一条条手翻太慢
- 希望把整站文档一次性喂给 AI 编程工具,需要 llms.t:希望把整站文档一次性喂给 AI 编程工具,需要 llms.txt 这种端点
- 读者反馈没地方收,想把意见直接变成 GitHub Issue:读者反馈没地方收,想把意见直接变成 GitHub Issue 跟进
适用人群
- 开发者关系工程师
- 开源项目维护者
- 技术文档工程师
使用步骤
- 用 npx @vercel/geistdocs init 生成项目骨架,起好站名并清掉示例内容。
- 在 geistdocs.tsx 里配 Logo、导航、标题、AI 提示词和 GitHub 仓库。
- 把文档写成带 frontmatter 的 MDX 放进 content/docs/,需要多语言就加 .cn.mdx 并跑 pnpm translate。
- 配好环境变量本地预览,确认 AI 问答与 RSS 正常后推到 GitHub,在 Vercel 部署。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 专业
- 版本
- main
- 最近更新
- 2026-09-18
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
使用前准备
- Node.js 18+、pnpm、GitHub 账号,并熟悉 MDX/Next.js/React
- AI 问答需 AI_GATEWAY_API_KEY。
依赖与权限
- AI_GATEWAY_API_KEY
- NEXT_PUBLIC_VERCEL_PROJECT_PRODUCTION_URL
- 读取用户主动提供的内容