[{"data":1,"prerenderedAt":815},["ShallowReactive",2],{"navigation_docs_zh_cn":3,"-zh-cn-ai-llms":128,"-zh-cn-ai-llms-surround":812},[4,41,77,103],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":40},"入门","i-lucide-rocket","\u002Fzh-cn\u002Fgetting-started","zh-cn\u002F1.getting-started",[10,15,20,25,30,35],{"title":11,"path":12,"stem":13,"icon":14},"介绍","\u002Fzh-cn\u002Fgetting-started\u002Fintroduction","zh-cn\u002F1.getting-started\u002F2.introduction","i-lucide-house",{"title":16,"path":17,"stem":18,"icon":19},"安装","\u002Fzh-cn\u002Fgetting-started\u002Finstallation","zh-cn\u002F1.getting-started\u002F3.installation","i-lucide-download",{"title":21,"path":22,"stem":23,"icon":24},"项目结构","\u002Fzh-cn\u002Fgetting-started\u002Fproject-structure","zh-cn\u002F1.getting-started\u002F4.project-structure","i-lucide-folder-tree",{"title":26,"path":27,"stem":28,"icon":29},"Studio 模块","\u002Fzh-cn\u002Fgetting-started\u002Fstudio","zh-cn\u002F1.getting-started\u002F5.studio","i-lucide-mouse-pointer-2",{"title":31,"path":32,"stem":33,"icon":34},"迁移","\u002Fzh-cn\u002Fgetting-started\u002Fmigration","zh-cn\u002F1.getting-started\u002F6.migration","i-lucide-replace",{"title":36,"path":37,"stem":38,"icon":39},"故障排查","\u002Fzh-cn\u002Fgetting-started\u002Ftroubleshooting","zh-cn\u002F1.getting-started\u002F7.troubleshooting","i-lucide-wrench",false,{"title":42,"icon":43,"path":44,"stem":45,"children":46,"page":40},"核心概念","i-lucide-brain","\u002Fzh-cn\u002Fconcepts","zh-cn\u002F2.concepts",[47,52,57,62,67,72],{"title":48,"path":49,"stem":50,"icon":51},"编辑","\u002Fzh-cn\u002Fconcepts\u002Fedition","zh-cn\u002F2.concepts\u002F2.edition","i-lucide-pencil",{"title":53,"path":54,"stem":55,"icon":56},"配置","\u002Fzh-cn\u002Fconcepts\u002Fconfiguration","zh-cn\u002F2.concepts\u002F3.configuration","i-lucide-settings",{"title":58,"path":59,"stem":60,"icon":61},"主题","\u002Fzh-cn\u002Fconcepts\u002Ftheme","zh-cn\u002F2.concepts\u002F4.theme","i-lucide-paint-roller",{"title":63,"path":64,"stem":65,"icon":66},"自定义","\u002Fzh-cn\u002Fconcepts\u002Fcustomization","zh-cn\u002F2.concepts\u002F5.customization","i-lucide-pen-tool",{"title":68,"path":69,"stem":70,"icon":71},"国际化","\u002Fzh-cn\u002Fconcepts\u002Finternationalization","zh-cn\u002F2.concepts\u002F6.internationalization","i-lucide-globe",{"title":73,"path":74,"stem":75,"icon":76},"Nuxt","\u002Fzh-cn\u002Fconcepts\u002Fnuxt","zh-cn\u002F2.concepts\u002F8.nuxt","i-simple-icons-nuxt",{"title":78,"icon":79,"path":80,"stem":81,"children":82,"page":40},"基础","i-lucide-book-open","\u002Fzh-cn\u002Fessentials","zh-cn\u002F3.essentials",[83,88,93,98],{"title":84,"path":85,"stem":86,"icon":87},"Markdown 语法","\u002Fzh-cn\u002Fessentials\u002Fmarkdown-syntax","zh-cn\u002F3.essentials\u002F1.markdown-syntax","i-lucide-heading-1",{"title":89,"path":90,"stem":91,"icon":92},"代码块","\u002Fzh-cn\u002Fessentials\u002Fcode-blocks","zh-cn\u002F3.essentials\u002F2.code-blocks","i-lucide-code-xml",{"title":94,"path":95,"stem":96,"icon":97},"组件","\u002Fzh-cn\u002Fessentials\u002Fcomponents","zh-cn\u002F3.essentials\u002F3.components","i-lucide-component",{"title":99,"path":100,"stem":101,"icon":102},"图片和嵌入","\u002Fzh-cn\u002Fessentials\u002Fimages-embeds","zh-cn\u002F3.essentials\u002F4.images-embeds","i-lucide-image",{"title":104,"icon":105,"path":106,"stem":107,"children":108,"page":40},"AI","i-lucide-sparkles","\u002Fzh-cn\u002Fai","zh-cn\u002F4.ai",[109,113,118,123],{"title":110,"path":111,"stem":112,"icon":105},"Assistant","\u002Fzh-cn\u002Fai\u002Fassistant","zh-cn\u002F4.ai\u002F1.assistant",{"title":114,"path":115,"stem":116,"icon":117},"MCP Server","\u002Fzh-cn\u002Fai\u002Fmcp","zh-cn\u002F4.ai\u002F2.mcp","i-lucide-cpu",{"title":119,"path":120,"stem":121,"icon":122},"Agent Skills","\u002Fzh-cn\u002Fai\u002Fskills","zh-cn\u002F4.ai\u002F3.skills","i-lucide-wand-sparkles",{"title":124,"path":125,"stem":126,"icon":127},"LLMs 集成","\u002Fzh-cn\u002Fai\u002Fllms","zh-cn\u002F4.ai\u002F4.llms","i-lucide-message-circle-code",{"id":129,"title":124,"body":130,"description":805,"extension":806,"links":807,"meta":808,"navigation":809,"path":125,"seo":810,"stem":126,"__hash__":811},"docs_zh_cn\u002Fzh-cn\u002F4.ai\u002F4.llms.md",{"type":131,"value":132,"toc":791},"minimark",[133,150,157,161,167,212,214,221,385,389,395,399,447,451,453,458,571,574,619,623,626,629,633,640,644,647,668,671,695,698,779,782,787],[134,135,136,137,141,142,145,146,149],"p",{},"Docus 默认集成 ",[138,139,140],"code",{},"nuxt-llms","，为大型语言模型（LLMs）准备内容。所有文档页面都会被注入，并自动生成和预渲染 ",[138,143,144],{},"\u002Fllms.txt"," 与 ",[138,147,148],{},"\u002Fllms-full.txt"," 文件。",[151,152,154,155,149],"note",{"to":153},"https:\u002F\u002Fdocus.dev\u002Fllms.txt","可以查看 Docus 文档自身生成的 ",[138,156,144],{},[158,159,160],"h2",{"id":160},"默认值",[134,162,163,164,166],{},"以下是生成 ",[138,165,144],{}," 文件时使用的默认值：",[168,169,170,181,191,198,205],"ul",{},[171,172,173,176,177,180],"li",{},[138,174,175],{},"domain"," → 基于部署平台计算（或使用 ",[138,178,179],{},"NUXT_SITE_URL"," 环境变量）",[171,182,183,186,187,190],{},[138,184,185],{},"title"," → 从 ",[138,188,189],{},"package.json"," 提取",[171,192,193,186,196,190],{},[138,194,195],{},"description",[138,197,189],{},[171,199,200,186,203,190],{},[138,201,202],{},"full.title",[138,204,189],{},[171,206,207,186,210,190],{},[138,208,209],{},"full.description",[138,211,189],{},[158,213,63],{"id":63},[134,215,216,217,220],{},"你可以在 ",[138,218,219],{},"nuxt.config.ts"," 中覆盖 LLMs 数据：",[222,223,228],"pre",{"className":224,"code":225,"filename":219,"language":226,"meta":227,"style":227},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","export default defineNuxtConfig({\n  llms: {\n    domain: 'https:\u002F\u002Fyour-site.com',\n    title: 'Your Site Name',\n    description: 'A brief description of your site',\n    full: {\n      title: 'Your Site Name',\n      description: 'A brief description of your site',\n    },\n  },\n})\n","ts","",[138,229,230,254,267,288,305,322,332,348,364,370,376],{"__ignoreMap":227},[231,232,235,239,242,246,250],"span",{"class":233,"line":234},"line",1,[231,236,238],{"class":237},"s7zQu","export",[231,240,241],{"class":237}," default",[231,243,245],{"class":244},"s2Zo4"," defineNuxtConfig",[231,247,249],{"class":248},"sTEyZ","(",[231,251,253],{"class":252},"sMK4o","{\n",[231,255,257,261,264],{"class":233,"line":256},2,[231,258,260],{"class":259},"swJcz","  llms",[231,262,263],{"class":252},":",[231,265,266],{"class":252}," {\n",[231,268,270,273,275,278,282,285],{"class":233,"line":269},3,[231,271,272],{"class":259},"    domain",[231,274,263],{"class":252},[231,276,277],{"class":252}," '",[231,279,281],{"class":280},"sfazB","https:\u002F\u002Fyour-site.com",[231,283,284],{"class":252},"'",[231,286,287],{"class":252},",\n",[231,289,291,294,296,298,301,303],{"class":233,"line":290},4,[231,292,293],{"class":259},"    title",[231,295,263],{"class":252},[231,297,277],{"class":252},[231,299,300],{"class":280},"Your Site Name",[231,302,284],{"class":252},[231,304,287],{"class":252},[231,306,308,311,313,315,318,320],{"class":233,"line":307},5,[231,309,310],{"class":259},"    description",[231,312,263],{"class":252},[231,314,277],{"class":252},[231,316,317],{"class":280},"A brief description of your site",[231,319,284],{"class":252},[231,321,287],{"class":252},[231,323,325,328,330],{"class":233,"line":324},6,[231,326,327],{"class":259},"    full",[231,329,263],{"class":252},[231,331,266],{"class":252},[231,333,335,338,340,342,344,346],{"class":233,"line":334},7,[231,336,337],{"class":259},"      title",[231,339,263],{"class":252},[231,341,277],{"class":252},[231,343,300],{"class":280},[231,345,284],{"class":252},[231,347,287],{"class":252},[231,349,351,354,356,358,360,362],{"class":233,"line":350},8,[231,352,353],{"class":259},"      description",[231,355,263],{"class":252},[231,357,277],{"class":252},[231,359,317],{"class":280},[231,361,284],{"class":252},[231,363,287],{"class":252},[231,365,367],{"class":233,"line":366},9,[231,368,369],{"class":252},"    },\n",[231,371,373],{"class":233,"line":372},10,[231,374,375],{"class":252},"  },\n",[231,377,379,382],{"class":233,"line":378},11,[231,380,381],{"class":252},"}",[231,383,384],{"class":248},")\n",[158,386,388],{"id":387},"原始-markdown-访问","原始 Markdown 访问",[134,390,391,392,394],{},"启用 ",[138,393,140],{}," 后，Docus 还会暴露原始 Markdown endpoint，让 AI agents 可以直接获取 LLM-ready 源文件，而无需经过完整渲染流程。这能减少 token 使用量，并提升 AI 工具消费文档时的响应速度。",[396,397,398],"h3",{"id":398},"工作方式",[168,400,401,420,428,434],{},[171,402,403,407,408,411,412,415,416,419],{},[404,405,406],"strong",{},"Endpoint","：",[138,409,410],{},"\u002Fraw\u002F\u003Ccontent-path>.md"," — 使用与页面 URL 相同的路径，移除结尾的 ",[138,413,414],{},"\u002Findex","，并保留 ",[138,417,418],{},".md"," 扩展名",[171,421,422,407,425],{},[404,423,424],{},"Content-Type",[138,426,427],{},"text\u002Fmarkdown; charset=utf-8",[171,429,430,433],{},[404,431,432],{},"自动补充","：如果请求的文档缺少顶级标题或描述，路由会自动把标题和描述追加到 Markdown 正文前面",[171,435,436,407,439,442,443,446],{},[404,437,438],{},"LLMs.txt 集成",[138,440,441],{},"llms.txt"," 中的文档链接会自动重写为 ",[138,444,445],{},"\u002Fraw\u002F...md"," endpoint，让 agents 获取紧凑 Markdown，而不是完整 HTML",[151,448,450],{"to":449},"\u002Fraw\u002Fzh-cn\u002Fai\u002Fllms.md","试着访问本页的原始 Markdown 版本。",[396,452,53],{"id":53},[134,454,216,455,457],{},[138,456,219],{}," 中自定义原始 Markdown 行为：",[222,459,461],{"className":224,"code":460,"filename":219,"language":226,"meta":227,"style":227},"export default defineNuxtConfig({\n  llms: {\n    contentRawMarkdown: {\n      \u002F\u002F Prevent specific page collections from being exposed\n      excludeCollections: ['landing', 'landing_en', 'landing_fr'],\n      \u002F\u002F Keep llms.txt links pointing to rendered pages instead of raw markdown\n      rewriteLLMSTxt: false,\n    },\n  },\n})\n",[138,462,463,475,483,492,498,539,544,557,561,565],{"__ignoreMap":227},[231,464,465,467,469,471,473],{"class":233,"line":234},[231,466,238],{"class":237},[231,468,241],{"class":237},[231,470,245],{"class":244},[231,472,249],{"class":248},[231,474,253],{"class":252},[231,476,477,479,481],{"class":233,"line":256},[231,478,260],{"class":259},[231,480,263],{"class":252},[231,482,266],{"class":252},[231,484,485,488,490],{"class":233,"line":269},[231,486,487],{"class":259},"    contentRawMarkdown",[231,489,263],{"class":252},[231,491,266],{"class":252},[231,493,494],{"class":233,"line":290},[231,495,497],{"class":496},"sHwdD","      \u002F\u002F Prevent specific page collections from being exposed\n",[231,499,500,503,505,508,510,513,515,518,520,523,525,527,529,532,534,537],{"class":233,"line":307},[231,501,502],{"class":259},"      excludeCollections",[231,504,263],{"class":252},[231,506,507],{"class":248}," [",[231,509,284],{"class":252},[231,511,512],{"class":280},"landing",[231,514,284],{"class":252},[231,516,517],{"class":252},",",[231,519,277],{"class":252},[231,521,522],{"class":280},"landing_en",[231,524,284],{"class":252},[231,526,517],{"class":252},[231,528,277],{"class":252},[231,530,531],{"class":280},"landing_fr",[231,533,284],{"class":252},[231,535,536],{"class":248},"]",[231,538,287],{"class":252},[231,540,541],{"class":233,"line":324},[231,542,543],{"class":496},"      \u002F\u002F Keep llms.txt links pointing to rendered pages instead of raw markdown\n",[231,545,546,549,551,555],{"class":233,"line":334},[231,547,548],{"class":259},"      rewriteLLMSTxt",[231,550,263],{"class":252},[231,552,554],{"class":553},"sfNiH"," false",[231,556,287],{"class":252},[231,558,559],{"class":233,"line":350},[231,560,369],{"class":252},[231,562,563],{"class":233,"line":366},[231,564,375],{"class":252},[231,566,567,569],{"class":233,"line":372},[231,568,381],{"class":252},[231,570,384],{"class":248},[134,572,573],{},"要完全禁用原始 Markdown 访问：",[222,575,577],{"className":224,"code":576,"filename":219,"language":226,"meta":227,"style":227},"export default defineNuxtConfig({\n  llms: {\n    contentRawMarkdown: false,\n  },\n})\n",[138,578,579,591,599,609,613],{"__ignoreMap":227},[231,580,581,583,585,587,589],{"class":233,"line":234},[231,582,238],{"class":237},[231,584,241],{"class":237},[231,586,245],{"class":244},[231,588,249],{"class":248},[231,590,253],{"class":252},[231,592,593,595,597],{"class":233,"line":256},[231,594,260],{"class":259},[231,596,263],{"class":252},[231,598,266],{"class":252},[231,600,601,603,605,607],{"class":233,"line":269},[231,602,487],{"class":259},[231,604,263],{"class":252},[231,606,554],{"class":553},[231,608,287],{"class":252},[231,610,611],{"class":233,"line":290},[231,612,375],{"class":252},[231,614,615,617],{"class":233,"line":307},[231,616,381],{"class":252},[231,618,384],{"class":248},[158,620,622],{"id":621},"markdown-重定向","Markdown 重定向",[151,624,625],{},"此功能仅在 Docus 部署到 Vercel 时可用。等 Nitro v3 支持多供应商全局 rewrites 后，它就可以与平台无关。",[134,627,628],{},"部署到 Vercel 时，Docus 会自动配置智能路由，为 AI agents 和 CLI 工具提供 Markdown 内容。",[396,630,632],{"id":631},"为什么","为什么？",[134,634,635,636,639],{},"Claude Code 等 agents 默认使用 ",[138,637,638],{},"Accept: text\u002Fmarkdown"," header，返回原始 Markdown 可以在过程中节省大量数据传输和 token。",[396,641,643],{"id":642},"如何实现","如何实现？",[134,645,646],{},"Docus 通过 HTTP headers 检测来自 AI agents 和命令行工具的请求：",[168,648,649,658],{},[171,650,651,654,655,657],{},[404,652,653],{},"Accept header","：带有 ",[138,656,638],{}," 的请求会自动重定向",[171,659,660,663,664,667],{},[404,661,662],{},"User-agent 检测","：来自 ",[138,665,666],{},"curl"," 这类 agents 的请求会自动重定向",[396,669,670],{"id":670},"重定向规则",[168,672,673,684],{},[171,674,675,407,678,681,682],{},[404,676,677],{},"根路径",[138,679,680],{},"\u002F"," → ",[138,683,144],{},[171,685,686,407,689,681,692],{},[404,687,688],{},"文档页面",[138,690,691],{},"\u002F{path}",[138,693,694],{},"\u002Fraw\u002F{path}.md",[396,696,697],{"id":697},"使用示例",[222,699,703],{"className":700,"code":701,"language":702,"meta":227,"style":227},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","# 从首页获取 llms.txt\ncurl -H \"Accept: text\u002Fmarkdown\" https:\u002F\u002Fdocus.dev\u002F\n\n# 从 locale 首页获取 llms.txt\ncurl -H \"Accept: text\u002Fmarkdown\" https:\u002F\u002Fdocus.dev\u002Fen\n\n# 获取文档页面的原始 Markdown\ncurl -H \"Accept: text\u002Fmarkdown\" https:\u002F\u002Fdocus.dev\u002Fzh-cn\u002Fai\u002Fllms\n","bash",[138,704,705,710,729,735,740,755,759,764],{"__ignoreMap":227},[231,706,707],{"class":233,"line":234},[231,708,709],{"class":496},"# 从首页获取 llms.txt\n",[231,711,712,715,718,721,723,726],{"class":233,"line":256},[231,713,666],{"class":714},"sBMFI",[231,716,717],{"class":280}," -H",[231,719,720],{"class":252}," \"",[231,722,638],{"class":280},[231,724,725],{"class":252},"\"",[231,727,728],{"class":280}," https:\u002F\u002Fdocus.dev\u002F\n",[231,730,731],{"class":233,"line":269},[231,732,734],{"emptyLinePlaceholder":733},true,"\n",[231,736,737],{"class":233,"line":290},[231,738,739],{"class":496},"# 从 locale 首页获取 llms.txt\n",[231,741,742,744,746,748,750,752],{"class":233,"line":307},[231,743,666],{"class":714},[231,745,717],{"class":280},[231,747,720],{"class":252},[231,749,638],{"class":280},[231,751,725],{"class":252},[231,753,754],{"class":280}," https:\u002F\u002Fdocus.dev\u002Fen\n",[231,756,757],{"class":233,"line":324},[231,758,734],{"emptyLinePlaceholder":733},[231,760,761],{"class":233,"line":334},[231,762,763],{"class":496},"# 获取文档页面的原始 Markdown\n",[231,765,766,768,770,772,774,776],{"class":233,"line":350},[231,767,666],{"class":714},[231,769,717],{"class":280},[231,771,720],{"class":252},[231,773,638],{"class":280},[231,775,725],{"class":252},[231,777,778],{"class":280}," https:\u002F\u002Fdocus.dev\u002Fzh-cn\u002Fai\u002Fllms\n",[134,780,781],{},"这些命令都会返回 Markdown 内容，而不是 HTML。",[783,784,786],"tip",{"to":785},"https:\u002F\u002Fgithub.com\u002Fnuxt-content\u002Fnuxt-llms","查看 nuxt-llms 文档，了解该模块的更多信息。",[788,789,790],"style",{},"html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .sfNiH, html code.shiki .sfNiH{--shiki-light:#FF5370;--shiki-default:#FF9CAC;--shiki-dark:#FF9CAC}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}",{"title":227,"searchDepth":256,"depth":256,"links":792},[793,794,795,799],{"id":160,"depth":256,"text":160},{"id":63,"depth":256,"text":63},{"id":387,"depth":256,"text":388,"children":796},[797,798],{"id":398,"depth":269,"text":398},{"id":53,"depth":269,"text":53},{"id":621,"depth":256,"text":622,"children":800},[801,802,803,804],{"id":631,"depth":269,"text":632},{"id":642,"depth":269,"text":643},{"id":670,"depth":269,"text":670},{"id":697,"depth":269,"text":697},"Docus 使用 Nuxt LLMs 模块生成 AI-ready 内容文件","md",null,{},{"icon":127},{"title":124,"description":805},"LOCQem_L915v0IX9sh4_WAM6N0nHXz7w3_RQdnLz85w",[813,807],{"title":119,"path":120,"stem":121,"description":814,"icon":122,"children":-1},"从文档站点发布 agent skills，让 AI 工具可以自动发现并安装。",1781679767363]