常见问题
直截了当的回答。

vagejs 是一款用来搭建网站的免费、开源静态网站生成器。你把页面写成简单的文本文件，它就会把它们变成一个快速的网站，并且已经内置了对搜索引擎和 AI 友好的文件。src/pages 文件夹里的每个 .md 文件都会成为一个页面，每次构建都会替你生成网站地图、robots.txt 和 llms.txt。我们用 Google 的 Lighthouse 工具测试了一个全新的网站，它在每个类别都拿到 100 分，发送给访客的 JavaScript 为 0 KB。

免费。它以 MIT 许可证发布，所以个人网站和商业网站都可以免费使用。代码在 GitHub 上，软件包在 npm 上，所以在依赖它之前，你可以看清它到底做了什么。用 npm create vagejs@latest my-site 创建新网站，或者用 npm install --save-dev vagejs 把它加入现有项目。托管是另一笔费用，小网站通常也是免费的。

会一点终端操作会有帮助。写页面只需要纯文本，而 Claude Code 这样的 AI 编程助手可以替你搭建和更新网站。创建网站时，如果在你的电脑上找到 Claude Code、Codex 或 Gemini CLI，它会提出帮你启动；如果你不用编程工具，也可以选择浏览器编辑器。编辑器为每个页面提供一个表单、一个按你网站设计显示的实时预览，并在每次保存后列出 vage check 发现的问题。

典型的 CMS 每次有人访问时都要运行数据库和服务器代码。vagejs 会提前构建好普通页面，所以没有需要保护或更新的数据库。它也没有在线管理后台；你的内容存放在文本文件里，一个本地编辑器让你在自己电脑的浏览器里修改它们。运行 npm run dev 时，编辑器位于你网站本地地址的 /_vage/edit/，而且它永远不会成为构建出的网站的一部分。没有管理后台、数据库和插件，攻击者能下手的地方就少得多。

它会处理好技术层面的事情：网站地图、页面摘要、结构化数据、速度和失效链接检查。排名仍然取决于你的内容，以及其他网站是否链接到你，任何工具都无法保证排名。发布之前，npx vage check 会读取每个页面，报告缺少页面摘要、标题重复和失效链接等问题，每次部署遇到这些错误都会停止。在我们的 Lighthouse 测试中，一个全新网站的 SEO 得分为 100，在模拟的慢速手机网络下，主要内容在 0.8 s 内显示出来。

它会生成 llms.txt，一份写给 AI 工具看的网站简明指南，并让你选择哪些 AI 爬虫可以访问。至于 AI 助手会不会提到你的网站，则由那个助手决定。在 vage.config.ts 中，aiTraining 设置管理为训练而收集页面的爬虫，比如 GPTBot 和 ClaudeBot；aiSearch 管理 AI 搜索爬虫，比如 OAI-SearchBot 和 PerplexityBot。请记住，llms.txt 是一项提议中的约定，而不是搜索引擎标准：有些 AI 工具会读取它，但它不会改变你在 Google 上的排名。

指向你没有批准的网站的链接，以及对访客隐藏的链接，都会让构建停止。vage verify 会把你的线上网站和你的文件进行对比，所以被注入的链接、脚本或页面很快就会暴露出来。已批准的网站列在 links.lock.json 中，npx vage links approve example.com 会先询问你，然后才添加一个网站。vage verify 还会以 Googlebot 的身份抓取每个页面，因为被入侵的网站常常只向搜索引擎显示垃圾内容；新网站还包含一项每日运行的 GitHub Actions 检查，失败时会给你发邮件。

任何能提供文件的地方。GitHub Pages、Cloudflare（Workers 或 Pages）和 Netlify 都内置了一条命令发布，其他任何静态托管平台（比如 Vercel）都可以直接提供 dist 文件夹。在这三个平台上，npx vage deploy 会先运行 vage check 和 vage build，向你展示计划，在做任何改动前先征求你的同意，并且只有在线上网站有响应时才报告成功。在其他托管平台上，把构建命令设为 npm run build，输出文件夹设为 dist，并使用 Node.js 22.12 或更高版本。

通常不花钱。vagejs 网站就是一个装满文件的文件夹，Cloudflare、Netlify 和 GitHub Pages 都在免费套餐的额度内托管静态网站。没有需要付费的数据库或服务器代码，文件也很小：一个全新网站的首页只需下载 1.7 KB，共 2 个请求，四个页面的初始网站构建只要 0.5 s。免费套餐及其额度由各托管平台决定，而且可能会变，所以上线前请先查看你的托管平台当前的套餐。

能。每个网站都包含 Claude Code、Codex、Cursor、Copilot 和其他 AI 助手会读取的说明，而且每条命令都能用 JSON 作答。发布和添加新的外部链接仍然需要你批准。新网站自带 AGENTS.md 和 CLAUDE.md，npx vage info --json 会列出每条命令、选项和设置，以及尚未实现的功能，这样 AI 助手就不会承诺它们。npx vage mcp 还会运行一个 MCP 服务器，提供只读工具来检查网站，并列出网站的页面和外部链接。

vagejs 还很年轻（0.x），本网站就运行在它上面。它构建出的网站是纯 HTML，所以稳定程度和你的托管平台一样。升级前请先阅读更新日志，因为 0.x 版本可能会改变行为。升级时运行 npm install vagejs@latest，再运行 npm run check，确认你的网站仍然通过检查。你还可以在 vage.config.ts 中固定规则包的版本，这样 AI 爬虫名称等服务商信息只会在你决定时才改变。

Node.js 22.12 或更高版本。然后运行 npm create vagejs@latest my-site，按照它打印出的三个步骤操作即可。你可以用 node --version 查看版本。这条命令会创建一个 my-site 文件夹，里面有示例页面、一个布局、设置和 AGENTS.md，然后提出帮你安装所有依赖，并在浏览器中打开网站。vagejs 可以在 macOS、Windows 和 Linux 上运行；以后要再次启动网站，在那个文件夹里运行 npm start 即可。