@astro-minimax/cli 提供一套完整的命令行工具，用于博客项目管理和 AI 内容处理。本文介绍所有可用命令及其用法。
安装
在 monorepo / 示例博客里，CLI 已通过 workspace 开发依赖接入；如果你是在自己的项目里单独使用，也可以手动安装：
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 ai:profile:build这是当前保留的标准作者画像构建入口，生成结果会进入运行时知识包，供 AI 聊天使用。
标准构建入口
pnpm run ai:profile:build # 执行保留的作者画像构建流程如果你还需要事实注册表或扩展系统，可以继续使用：
pnpm run ai:facts:build
pnpm run ai:facts:validate
pnpm run ai:extensions:statusAI 事实注册表
AI 从博客内容中提取已验证的事实，注入到提示词中以减少幻觉：
# 构建事实注册表
pnpm run ai:facts:build
# 验证事实
pnpm run ai:facts:validate
# 查看状态
pnpm run ai:facts:status事实注册表位于 datas/rag-facts.json，供 AI 聊天运行时使用。
AI 扩展系统
扩展系统提供自定义上下文段落、语义回退规则等 AI 增强能力：
# 构建扩展
pnpm run ai:extensions:build
# 验证扩展
pnpm run ai:extensions:validate
# 查看扩展状态
pnpm run ai:extensions:status
# 加载扩展
pnpm run ai:extensions:load扩展来源：packages/ai/src/extensions/，提供语音风格提示、语义回退规则等。
Git 钩子
安装钩子
pnpm run hooks:install安装 Husky Git 钩子，支持 pre-commit 自动填充 pubDatetime/modDatetime 字段。
卸载钩子
pnpm run hooks:uninstall查看状态
pnpm run hooks:status检查钩子安装状态和可用性。
数据管理
查看状态
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 ai:profile:build | astro-minimax ai profile build |
pnpm run ai:facts:build | astro-minimax ai facts build |
pnpm run ai:extensions:status | astro-minimax ai extensions status |
pnpm run ai:facts:validate | astro-minimax ai facts validate |
pnpm run ai:facts:status | astro-minimax ai facts status |
pnpm run ai:extensions:build | astro-minimax ai extensions build |
pnpm run hooks:install | astro-minimax hooks install |
pnpm run hooks:uninstall | astro-minimax hooks uninstall |
pnpm run hooks:status | astro-minimax hooks status |
pnpm run data:status | astro-minimax data status |
pnpm run data:clear | astro-minimax data clear |
评论区
文明评论，共建和谐社区