用途：blodemd 是 Blode.md 的命令行工具，用于从终端脚手架、预览和部署 MDX 文档站点。一次部署会从同一提交发布 HTML 及其面向智能体的孪生文件（llms.txt、llms-full.txt、逐页 .md），使智能体读到的内容与合并内容一致。它不负责撰写文档正文、设计站点，也不为 Blode.md 未托管的站点实现智能体就绪能力。
主要能力：支持认证检查、脚手架、配置校验、本地预览和推送部署；部署后自动生成 /llms.txt、/llms-full.txt、/<page>.md、HTML 页面的 Link 头、/.well-known/skills/index.json、/mcp 服务、X-Llms-Txt 头以及 robots.txt 和 sitemap.xml。
使用方式：先运行 npx blodemd whoami 检查认证；凭据按顺序解析为 --api-key 或 BLODEMD_API_KEY、npx blodemd login 的存储会话、或仪表盘中的 GitHub App。非交互运行需加 -y 和 --json。脚手架：npx blodemd new [directory] --slug <project-slug> --template <minimal|starter> -y。校验：npx blodemd validate [dir] --json。预览：npx blodemd dev --dir <dir> --port 3030 --no-open。部署：npx blodemd push [dir] --project <slug> --json。验证：用 curl 检查线上 llms.txt 和 .md 孪生文件返回 200 与 text/markdown。
适用场景：适合需要同时发布人类可读 HTML 与智能体可读导出的 MDX 文档站点，尤其适合文档位于仓库、希望通过 GitHub App 或 CI 推送保持同步的团队。
限制：push 不打印公开 URL，需从 slug 或 seo.siteUrl 推导；BLODEMD_API_KEY 会覆盖存储会话且部署密钥无用户身份；docs.json 中未列入导航的页面仍会发布并出现在 llms.txt 中，需用 navigation.hidden 或 frontmatter hidden 隐藏；代理到自定义路径时需设置 seo.siteUrl；new 不加 -y 会挂起非交互运行，dev 不加 --no-open 会尝试打开浏览器。