English | 简体中文
astro-minima-X — 极简（Minima）为底座，X 代表无限扩展。
astro-minimax 是一个极简、现代化、模块化的 Astro 博客主题。以极简风格为核心，同时提供丰富的可视化组件和功能扩展。支持多语言、AI 聊天、多种搜索方案、Mermaid 图表、Markmap 思维导图等。
- 极简优先 — 简洁的设计，内容为核心
- 模块化可插拔 — 四个独立包，按需组合
- 现代化 — Astro v6、Tailwind v4、TypeScript 严格模式、AI SDK v6
- 内容与系统分离 — 通过 CLI / NPM 包 / GitHub Template 灵活集成
- 类型安全的 Markdown / MDX
- 极致性能（Lighthouse 90+）
- 无障碍支持
- 响应式设计
- SEO 友好
- 明暗主题切换（View Transitions 动画）
- 全文搜索（Pagefind 或 Algolia DocSearch）
- 动态 OG 图片生成
- 多语言支持（中文/英文）
- 分类、标签、系列、归档
- 📊 Mermaid 图表 — 流程图、时序图等
- 🧠 Markmap 思维导图 — 交互式思维导图
- ✏️ Rough.js 手绘图形 — 手绘风格 SVG
- 🖌️ Excalidraw 嵌入 — 白板风格图表
- 📺 Asciinema 终端回放 — 嵌入终端录制
- 🤖 AI 聊天 — 多 Provider 自动故障转移、RAG 增强、流式对话、来源分层防幻觉
- 📖 边读边聊 — 文章页 AI 陪读，自动感知文章上下文
- 🔒 AI 隐私保护 — 自动拒绝敏感个人信息查询
- 🧪 AI 质量评估 — 黄金测试集自动化评估
- 💬 Waline 评论 — 互动评论系统
- 🔔 多渠道通知 — Telegram / Email / Webhook
- 📊 Umami 统计 — 隐私友好的访问分析
- ☕ 赞助打赏 — 支持多种支付方式
npx @astro-minimax/cli init my-blog
cd my-blog && pnpm install && pnpm run dev当前暂不够成熟，但使用 cli 创建的博客目录骨架最清晰简单，无需管理相关依赖，可享受其它包持续迭代的红利
pnpm create astro@latest --template souloss/astro-minimax
cd my-blog && pnpm install && pnpm run devpnpm add @astro-minimax/core # 核心主题（含可视化组件）
pnpm add @astro-minimax/ai # 可选，AI 聊天
pnpm add -D @astro-minimax/cli # 推荐，CLI 工具详见 快速开始指南。
astro-minimax/
├── packages/
│ ├── core/ # @astro-minimax/core — 核心主题（布局、组件、样式、路由、插件、可视化）
│ ├── ai/ # @astro-minimax/ai — AI 集成（RAG、多 Provider、流式对话）
│ ├── notify/ # @astro-minimax/notify — 多渠道通知
│ └── cli/ # @astro-minimax/cli — CLI 工具链（创建、处理、评估）
└── apps/
└── blog/ # 示例博客 / 开发预览站| 类别 | 技术 |
|---|---|
| 主框架 | Astro v6 |
| 样式 | TailwindCSS v4 |
| 搜索 | Pagefind / Algolia DocSearch |
| 评论 | Waline |
| 图表 | Mermaid |
| 思维导图 | Markmap |
| AI | Vercel AI SDK v6 + Cloudflare Workers AI |
| 通知 | Telegram / Email (Resend) / Webhook |
| 统计 | Umami |
| 部署 | Cloudflare Pages / Vercel / Netlify / Docker |
通过 @astro-minimax/cli 提供完整的命令行工具：
# 博客管理
astro-minimax init my-blog # 创建新博客
astro-minimax post new "标题" # 创建新文章
astro-minimax post list # 列出所有文章
# AI 功能（统一入口）
astro-minimax ai process # AI 处理文章（摘要+SEO）
astro-minimax ai eval # AI 对话质量评估
astro-minimax ai profile build # 构建作者画像
astro-minimax ai facts build # 构建事实注册表
astro-minimax ai extensions status # 查看扩展状态
# 数据管理
astro-minimax data status # 查看数据文件状态
astro-minimax data clear # 清理生成的缓存在博客目录中也可以使用 pnpm run 快捷方式：pnpm run ai:process、pnpm run ai:profile:build 等。
| 包 | 版本 | 说明 |
|---|---|---|
@astro-minimax/core |
0.9.3 | 核心主题：布局、组件、样式、路由注入、虚拟模块、可视化 |
@astro-minimax/ai |
0.9.3 | AI 集成：多 Provider 故障转移、RAG 检索、来源分层、隐私保护 |
@astro-minimax/notify |
0.9.3 | 通知系统：Telegram Bot、Email (Resend)、Webhook |
@astro-minimax/cli |
0.9.3 | CLI 工具：博客创建、AI 处理、画像构建、质量评估 |
基于 AstroPaper 二次开发。
MIT License - Copyright © 2026
由 Souloss 用心打造。