---
title: 如何为 Next.js 添加 llms.txt
description: 为 Next.js App Router 项目添加 llms.txt、全站上下文和逐页 Markdown，并验证生产结果。
canonical_url: https://next-ai-ready.vercel.app/zh/docs/guides/nextjs-llms-txt
url: https://next-ai-ready.vercel.app/zh/docs/guides/nextjs-llms-txt
last_updated: 2026-08-02
updated: 2026-08-02
author: next-ai-ready 团队
summary: 为 Next.js App Router 项目添加 llms.txt、全站上下文和逐页 Markdown，并验证生产结果。
topics: [nextjs, llms.txt, markdown, tutorial]
---

# 如何为 Next.js 添加 llms.txt

最小实现是在 `public/llms.txt` 中手写内容。对于页面少、更新不频繁的网站，这已经足够。
当文件需要与大量页面、摘要、Markdown、结构化数据或 Agent 工具保持同步时，再使用构建集成。

本指南为现有 Next.js App Router 项目添加这些机器接口，不改动现有 UI。

如果项目使用文档框架，请查看专门的 [Nextra 4 指南](./nextra-ai-ready) 或
[Fumadocs 指南](./fumadocs-ai-ready)，其中包含内容目录、插件组合与部署限制。

## 查看生产案例

当前文档站正在运行下方同一套集成：

- [生产 llms.txt](https://next-ai-ready.vercel.app/llms.txt)
- [安装页面的 Markdown](https://next-ai-ready.vercel.app/zh/docs/installation.md)
- [生产 OpenAPI 文档](https://next-ai-ready.vercel.app/openapi.json)
- [生产工具清单](https://next-ai-ready.vercel.app/tools.json)
- [文档站生产源码](https://github.com/mustcanbedo/next-ai-ready/tree/main/examples/docs-site)

生产站还通过了固定版本 Vercel Agent Readability CLI 的全部 25 项检查。该分数只衡量技术
可读性，不代表搜索位置或引用效果。

## 1. 安装

在已有 Next.js App Router 项目中运行：

```bash
pnpm add next-ai-ready zod@^4
pnpm exec next-ai-ready init
```

`init` 会创建显式的 route handler、AI-ready 配置、示例 Action 和 Next.js rewrite 配置，
不会修改现有页面组件。

## 2. 添加 AI 可读内容

创建 `content/about.mdx`：

```markdown
---
title: 关于 Acme
summary: Acme 帮助客服团队查找经过核验的产品答案。
author: Acme 团队
updatedAt: 2026-08-02
questions:
  - q: Acme 提供什么服务？
    a: Acme 帮助客服团队搜索经过核验的产品文档。
---

# 关于 Acme

Acme 为客服团队提供一个可搜索的可信产品答案来源。
```

清晰的标题、摘要、作者、更新时间和直接回答同时服务人类与 AI。不要添加可见页面无法支持
的营销主张或 FAQ 答案。

## 3. 生成机器接口

```bash
pnpm exec next-ai-ready build
pnpm exec next-ai-ready doctor --score
```

构建会生成 discovery 文件和运行时 handler 使用的语义图谱。基础部署会提供：

- `/llms.txt`：简洁的站点发现入口。
- `/llms-full.txt`：合并后的全站上下文。
- `/<page>.md`：干净的逐页内容。
- `/sitemap.md`：供 Agent 使用的页面导航。
- `/openapi.json` 和 `/tools.json`：声明式能力描述。
- `/api/mcp`：按需提供 MCP 资源与工具。

当 `doctor` 没有错误，并且 `llms.txt` 列出预期页面时，基础接入完成。警告表示仍需处理的
可选质量项或生产配置。

## 4. 验证生产站

部署后应检查真实公开响应，而不只检查构建产物：

```bash
pnpm exec next-ai-ready audit https://example.com --version 3
```

同时打开 `https://example.com/llms.txt` 和类似 `https://example.com/about.md` 的真实页面，
确认 canonical URL 指向生产域名，普通浏览器页面仍返回 HTML。

## 后续再添加可调用 Action

`llms.txt` 和 Markdown 首先解决 AI 系统发现、读取内容的问题。可调用 Action 是另一项生产
决策。只有当 Agent 确实需要执行具体操作时再添加，并同时配置鉴权、输入校验和审计日志。

## 它不能保证什么

技术层面的 AI-readiness 不能保证某个 AI 产品一定抓取、收录、排名、引用或推荐页面。这些
端点的价值是为优质源内容提供稳定的机器访问方式，实际访问、检索、引用和业务结果仍需单独衡量。