通过 100+ 个技巧的集合学习 Nuxt！
56.4K

llms
nuxt-llms

为你的 Nuxt 应用程序生成 llms.txt 文档
2.3K 下载
110 颗星
v0.1.0
farnabazfarnabaz
AtinuxAtinux

nuxt-llms-social-card

Nuxt LLMs

npm versionnpm downloadsLicenseNuxt

Nuxt LLMs 为你的 Nuxt 应用程序自动生成 llms.txt markdown 文档。它提供运行时钩子，用于从各种来源（CMS、Nuxt Content 等）收集数据，并以基于文本的格式生成结构化文档。

特性

  • 自动生成 & 预渲染 /llms.txt
  • 启用后生成 & 预渲染 /llms_full.txt
  • 直接从你的 nuxt.config.ts 自定义 sections
  • 通过运行时钩子系统与 Nuxt 模块和你的应用程序集成

快速设置

  1. 安装模块
npm i nuxt-llms
  1. 在你的 nuxt.config.ts 中注册 nuxt-llms
export default defineNuxtConfig({
  modules: ['nuxt-llms']
})
  1. 配置你的应用程序详情
export default defineNuxtConfig({
  modules: ['nuxt-llms'],
  llms: {
    domain: 'https://example.com',
    title: 'My Application',
    description: 'My Application Description',
    sections: [
      {
        title: 'Section 1',
        description: 'Section 1 Description',
        links: [
          {
            title: 'Link 1',
            description: 'Link 1 Description',
            href: '/link-1',
          },
          {
            title: 'Link 2',
            description: 'Link 2 Description',
            href: '/link-2',
          },
        ],
      },
    ],
  },
})

就是这样！你可以访问 /llms.txt 查看生成的文档 ✨

选项

  • domain(必填): 应用程序的域名
  • title: 应用程序的标题，将显示在文档顶部
  • description: 应用程序的描述，将紧随标题之后显示在文档顶部
  • sections: 文档的 sections。Section 由标题、一段或多段描述以及可能的链接列表组成。每个 section 都是一个具有以下属性的对象
    • title(必填): section 的标题
    • description: section 的描述
    • links: section 的链接
      • title(必填): 链接的标题
      • description: 链接的描述
      • href(必填): 链接的 href
  • notes: 文档的 notes。Notes 是一个特殊的 section，始终出现在文档的末尾。Notes 可用于添加有关应用程序或文档本身的任何信息。
  • full: llms_full.txt 配置。设置此选项将启用 llms_full.txt 路由。
    • title: llms_full 文档的标题
    • description: llms_full 文档的描述

文档格式

该模块生成两种不同的文档格式

llms.txt

/llms.txt 路由生成简洁、结构化的文档，遵循 llms.txt 规范。此格式针对人类可读性和 AI 消耗进行了优化。它包括

  • 应用程序标题和描述
  • 带有标题和描述的组织 sections
  • 带有标题、描述和 URL 的链接
  • 可选的 notes section

llms_full.txt

/llms_full.txt 路由提供更详细、自由格式的文档格式。这有助于减少应用程序上的爬虫流量，并为你的用户和 LLMs 提供更详细的文档。

默认情况下，模块不生成 /llms_full.txt 路由，你需要通过在你的 nuxt.config.ts 中设置 full.title 和 full.description 来启用它。

export default defineNuxtConfig({
  llms: {
    domain: 'https://example.com',
    title: 'My Application',
    full: {
      title: 'Full Documentation',
      description: 'Full documentation of the application',
    },
  },
})

使用钩子扩展文档

该模块提供了一个钩子系统，允许你动态扩展两种文档格式。主要有两个钩子

可用钩子

llms:generate(event, options)

每次请求 /llms.txt 时都会调用此钩子。使用此钩子来修改结构化文档，它允许你添加 sections、链接和元数据。

参数

  • event: H3Event - 当前请求事件
  • options: ModuleOptions - 你可以修改的模块选项，用于添加 sections、链接等。

llms:generate:llms_full(event, options, contents)

每次请求 /llms_full.txt 时都会调用此钩子。它允许你添加任何格式的自定义内容 sections。

参数

  • event: H3Event - 当前请求事件
  • options: ModuleOptions - 你可以修改的模块选项，用于添加 sections、链接等。
  • contents: string - 你可以添加或修改的内容 sections 数组

在你的应用程序中使用钩子

在你的 server/plugins 目录中创建一个服务器插件

// server/plugins/llms.ts
export default defineNitroPlugin((nitroApp) => {
  // Method 1: Using the hooks directly
  nitroApp.hooks.hook('llms:generate', (event, options) => {
    // Add a new section to llms.txt
    options.sections.push({
      title: 'API Documentation',
      description: 'REST API endpoints and usage',
      links: [
        {
          title: 'Authentication',
          description: 'API authentication methods',
          href: `${options.domain}/api/auth`
        }
      ]
    })
  })

  // Method 2: Using the helper function
  nitroApp.hooks.hook('llms:generate:full', (event, options, contents) => {
    // Add detailed documentation to llms_full.txt
    contents.push(`## API Authentication

### Bearer Token
To authenticate API requests, include a Bearer token in the Authorization header:

\`\`\`
Authorization: Bearer <your-token>
\`\`\`

### API Keys
For server-to-server communication, use API keys:

\`\`\`
X-API-Key: <your-api-key>
\`\`\`
    `)
  })
})

在 Nuxt 模块中使用钩子

如果你正在开发一个需要扩展 LLMs 文档的 Nuxt 模块

  1. 在你的模块中创建一个服务器插件
// module/runtime/server/plugins/my-module-llms.ts
export default defineNitroPlugin((nitroApp) => {
  nitroApp.hooks.hook('llms:generate', (event, options) => {
    options.sections.push({
      title: 'My Module',
      description: 'Documentation for my module features',
      links: [/* ... */]
    })
  })
})
  1. 在你的模块设置中注册插件
import { defineNuxtModule, addServerPlugin } from '@nuxt/kit'
import { fileURLToPath } from 'url'

export default defineNuxtModule({
  setup(options, nuxt) {
    const runtimeDir = fileURLToPath(new URL('./runtime', import.meta.url))
    addServerPlugin(resolve(runtimeDir, 'server/plugins/my-module-llms'))
  }
})

集成

Nuxt Content

Nuxt Content ^3.2.0 自带对 LLMs 文档的内置支持。你可以将 nuxt-llms 与 @nuxt/content 结合使用，高效地为你的网站编写内容和文档，并毫不费力地生成 LLM 友好的文档。Content 模块使用 nuxt-llms 钩子，并将你的所有内容自动添加到 llms.txt 和 llms_full.txt 文档中。

你只需要安装这两个模块，并将你的内容文件写入 content 目录。

export default defineNuxtConfig({
  modules: ['nuxt-llms', '@nuxt/content'],
  llms: {
    domain: 'https://example.com',
    title: 'My Application',
    description: 'My Application Description',
  },
})

查看 Nuxt Content 文档，了解有关如何编写内容文件的更多信息。

并查看 Nuxt Content llms 文档，了解有关如何使用 nuxt-llms 和 @nuxt/content 自定义 LLMs 内容的更多信息。

💻 开发

  • 克隆仓库
  • 使用 pnpm install 安装依赖
  • 使用 pnpm dev:prepare 准备
  • 使用 pnpm prepack 构建
  • 使用 pnpm dev 尝试 playground
  • 使用 pnpm test 测试

许可证

MIT 许可证

版权所有 (c) NuxtLabs