[Sepush]

Serves the docs to LLMs and agents (llms.txt), replacing #7502.

The docs are already Markdown: a component page is index.demo-entry.md plus its *.demo.vue files, and a docs page is index.md. So the LLM files are assembled straight from those sources by a build step. The site's own Markdown rendering is not touched.

What is served

Path	Content
/llms.txt	English index
/zh-CN/llms.txt	Chinese index
/llms-full.txt, /zh-CN/llms-full.txt	Every page in one file
/<lang>/<docs|components>/<page>.md	One page, e.g. /en-US/components/button.md

• Page Markdown: the page's Markdown, split with marked's lexer, with the demo block expanded into each demo's title, description and full source (debug demos left out, as on the site). Demos are read with @vue/compiler-sfc; the few site components written in the Markdown are parsed with Vue's template parser and become plain Markdown: <n-alert title> becomes a quote, <n-text code> a code span, linking elements become links, and any other tag keeps only its text. Relative links become absolute, pointing at the .md version of the page, so they still work inside llms.txt and llms-full.txt.
• llms.txt: sections follow the site menu (Introduction, Getting Started, Common Components, Data Input Components, ...), and each link carries the page's first paragraph as its description. The changelog is under ## Optional, and left out of llms-full.txt.
• One source of truth: the menu entries moved from demo/store/menu-options.js to a plain-data demo/store/menu-data.ts, which both the site menu and the build read. Each entry's Markdown source follows the existing file layout.
• Dev and production: build/vite-plugin-llms.ts builds the files on request in the dev server and emits them as static files into site/ in the site build.
• Where people find it: an "LLMs" page under Getting Started explains the files and how to hand them to an agent. The home page links to it under the main buttons, and so does the footer.
• Encoding: naiveui.com serves static files without a charset, so the emitted files start with a UTF-8 byte order mark; without it a browser shows the Chinese as mojibake.
• Copy button: a button next to "Edit on GitHub" in each page title opens a menu: copy the page as Markdown, copy the Markdown link, or view the Markdown.

Also fixes the language switch on the home page, broken since #8245: the home page is now the bare locale (/zh-CN), which the switch didn't match.

Compared with #7502

• No change to how the site renders Markdown (feat: LLM friendly doc #7502 moved it from marked to unified).
• Link descriptions and menu sections in llms.txt.
• Built on the current URLs, without the theme segment (docs: keep the theme out of the site URL #8245).

Tests

• build/llms/tests: Markdown conversion, demo expansion, link resolution, descriptions, that every menu entry of both languages has a source, and the llms.txt structure.
• Dev server: every path returns the right content type, and an unknown .md path falls through to the site.
• Production build: the files are in site/.
• Chromium: the copy menu copies the page and the link and opens the Markdown; the menu group counts are unchanged.

[codecov-commenter]

⚠️ Please install the to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 63.56%. Comparing base (9422a5f) to head (8e39b84).
❗ Your organization needs to install the Codecov GitHub app to enable full functionality.

Additional details and impacted files

@@            Coverage Diff             @@
##             docs    #8246      +/-   ##
==========================================
+ Coverage   63.53%   63.56%   +0.02%     
==========================================
  Files         878      878              
  Lines       27487    27487              
  Branches     8750     8524     -226     
==========================================
+ Hits        17465    17471       +6     
+ Misses       9809     9803       -6     
  Partials      213      213              

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.