---
title: 快速开始
description: 约 10 分钟完成可验证的 next-ai-ready 基础接入。
canonical_url: https://next-ai-ready.vercel.app/zh/docs/guides/quickstart
url: https://next-ai-ready.vercel.app/zh/docs/guides/quickstart
last_updated: 2026-08-02
updated: 2026-08-02
author: next-ai-ready 团队
summary: 约 10 分钟完成可验证的 next-ai-ready 基础接入。
topics: [quickstart, tutorial, getting-started]
---

# 快速开始

本指南带你从零开始，在约 10 分钟内完成可验证的 AI 可读 Next.js 基础接入。

## 1. 创建项目

**方式 A — 模板（最快）：**

```bash
npm create next-ai-ready my-site
cd my-site
npm install
npx next-ai-ready init
```

脚手架会提供可运行的最小 App Router TypeScript 应用和初始 MDX 内容，但不会预生成 AI-ready 配置或 handler；安装后显式执行 `init` 才会添加这些接线。

**方式 B — 已有 Next.js 项目：**

```bash
npx create-next-app@latest my-site --typescript --app --tailwind
cd my-site
pnpm add next-ai-ready zod@^4
npx next-ai-ready init
```

## 2. 添加内容

创建包含语义元数据的 MDX 页面：

```markdown
---
title: 快速上手
summary: 了解如何使用我们的产品。
---

# 快速上手

欢迎使用我们的产品，以下是开始步骤。
```

## 3. 构建

```bash
npx next-ai-ready build
```

你会看到类似输出：

```text
[next-ai-ready] scanning content
[next-ai-ready] compiling 1 files
[next-ai-ready] loading actions from ./actions/index.mjs
[next-ai-ready] compiled 1 actions
[next-ai-ready] wrote 8 files
[next-ai-ready] build complete — 1 routes, 1 actions, 8 files written
```

## 4. 验证

```bash
npx next-ai-ready doctor --score
```

所有检查应通过。然后启动开发服务器并访问：

- `http://localhost:3000/_ai-ready/llms-txt` — 你的 llms.txt
- `http://localhost:3000/_ai-ready/openapi` — 你的 OpenAPI 规范
- `http://localhost:3000/_ai-ready/tools` — 你的工具清单

## 下一步

- 阅读[知识平面](/zh/docs/concepts/knowledge-plane)了解内容编译
- 阅读[能力平面](/zh/docs/concepts/capability-plane)了解自定义 Action
- 查看 [API 参考](/docs/api-reference/config)了解完整配置选项