@astro-minimax/cli 提供一套完整的命令行工具，用于博客项目管理和 AI 内容处理。本文介绍所有可用命令及其用法。
安装
CLI 工具作为开发依赖自动安装：
pnpm add -D @astro-minimax/cli安装后可通过 astro-minimax 命令使用，也可以通过 pnpm run 快捷脚本调用。
创建新博客
npx @astro-minimax/cli init my-blog生成包含完整配置、示例文章和 AI 工具链的博客项目。
文章管理
创建文章
pnpm run post:new -- "文章标题"
pnpm run post:new -- "English Title" --lang=en
pnpm run post:new -- "教程" --category="教程/前端"自动创建带 frontmatter 的 Markdown 文件，放在对应语言目录下。
列出文章
pnpm run post:list按日期降序显示所有文章（包含子目录），区分已发布和草稿。
文章统计
pnpm run post:stats显示中文/英文文章数量统计。
AI 内容处理
需要配置环境变量：
# .env
AI_API_KEY=your-api-key
AI_BASE_URL=https://api.openai.com # 可选
AI_MODEL=gpt-4o-mini # 可选处理文章
pnpm run ai:process # 处理所有文章（摘要+SEO）
pnpm run ai:process -- --force # 强制重新处理
pnpm run ai:process -- --slug=zh/my-post # 处理指定文章
pnpm run ai:process -- --lang=zh # 只处理中文文章
pnpm run ai:process -- --recent=5 # 处理最近 5 篇
pnpm run ai:process -- --dry-run # 预览模式生成摘要
pnpm run ai:summary生成 SEO 元数据
pnpm run ai:seoAI 质量评估
pnpm run ai:eval # 评估本地服务
pnpm run ai:eval -- --url=https://your-blog.com # 评估生产环境
pnpm run ai:eval -- --category=no_answer # 评估特定分类
pnpm run ai:eval -- --verbose # 详细输出评估基于 datas/eval/gold-set.json 黄金测试集，自动检查：
- 回答非空
- 主题覆盖率
- 禁止声明未出现
- Markdown 链接存在性
- 回答模式匹配
评估报告保存到 datas/eval/report.json。
作者画像
完整构建
pnpm run profile:build依次执行：上下文构建 → 风格分析 → 画像报告生成。
分步构建
pnpm run profile:context # 构建作者上下文（聚合文章数据）
pnpm run profile:voice # 构建表达风格画像（纯本地分析）
pnpm run profile:report # 生成画像报告（可选 AI 增强）生成的数据文件用于 AI 聊天功能，帮助 AI 以作者风格回答问题。
数据管理
查看状态
pnpm run data:status显示所有数据文件的状态、处理数量和最后更新时间。
清理缓存
pnpm run data:clear清除 AI 生成的摘要、SEO 数据、作者画像等缓存文件。不会删除评估报告。
命令速查表
| 快捷脚本 | 等效命令 |
|---|---|
pnpm run post:new -- "标题" | astro-minimax post new "标题" |
pnpm run post:list | astro-minimax post list |
pnpm run post:stats | astro-minimax post stats |
pnpm run ai:process | astro-minimax ai process |
pnpm run ai:eval | astro-minimax ai eval |
pnpm run profile:build | astro-minimax profile build |
pnpm run data:status | astro-minimax data status |
pnpm run data:clear | astro-minimax data clear |
评论区
文明评论，共建和谐社区