Anydocs Documents
CLI 命令

build - 构建站点

生成静态 reader 站点以及搜索和 AI 产物。

`build` 用来把文档项目打包成可部署站点。它通常发生在内容已经通过 `preview` 检查之后,用来产出静态 reader 页面、搜索索引和 AI 读取产物。

基本命令

npx @anydocs/cli build ./my-docs

如果需要覆盖默认输出目录:

npx @anydocs/cli build ./my-docs --output ./build

build 会产出什么

  • `index.html` 和 `/<lang>/<slug>/index.html` 等 reader 页面
  • `search-index.<lang>.json`
  • `llms.txt`、`llms-full.txt`
  • `mcp/` 目录中的机器可读产物

默认输出目录是项目下的 `dist/`。

公开边界

`build` 只会提升 `published` 页面。`draft` 和 `in_review` 不会进入静态站点、搜索索引或 AI 产物。

交付顺序建议

先在 Studio 或通过 MCP 完成内容编辑和状态切换,再用 `preview` 做读者视角确认,最后执行 `build`,把输出目录交给静态托管平台或你的部署流程。

兼容参数

`--watch` 仍然保留为兼容参数,不是常规发布流程的必需项。