@astro-minimax/cli 0.8.0 → 0.8.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astro-minimax/cli",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "type": "module",
   "description": "CLI tool for astro-minimax blog — create blogs, manage content, and process data with AI.",
   "author": "Souloss",

package/template/functions/api/chat.ts

@@ -8,10 +8,22 @@ import factRegistry from '../../datas/fact-registry.json';
 
 // Optional: TF-IDF vector index for enhanced search reranking
 // The vector index is created by `astro-minimax ai process` command
-// Using dynamic import in try/catch since the file may not exist yet
+// Lazy-loaded on first request to avoid top-level await issues with Cloudflare Pages
 let vectorIndex: unknown = null;
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-try { vectorIndex = (await import('../../src/data/vectors/index.json' as any)).default; } catch { /* not available */ }
+let vectorIndexLoaded = false;
+
+async function loadVectorIndex(): Promise<unknown> {
+  if (vectorIndexLoaded) return vectorIndex;
+  vectorIndexLoaded = true;
+  try {
+    // Dynamic import for optional file that may not exist
+    const module = await import('../../src/data/vectors/index.json');
+    vectorIndex = module.default;
+  } catch {
+    // File not available, keep vectorIndex as null
+  }
+  return vectorIndex;
+}
 
 interface FunctionEnv extends ChatHandlerEnv {
   CACHE_KV?: KVNamespace;
@@ -20,6 +32,8 @@ interface FunctionEnv extends ChatHandlerEnv {
 }
 
 export const onRequest: PagesFunction<FunctionEnv> = async (context) => {
+  await loadVectorIndex();
+  
   initializeMetadata(
     { summaries: aiSummaries, authorContext, voiceProfile, factRegistry, vectorIndex },
     context.env,

package/template/package.json

@@ -28,9 +28,9 @@
   "dependencies": {
     "@ai-sdk/openai-compatible": "^2.0.35",
     "@ai-sdk/react": "^3.0.118",
-    "@astro-minimax/ai": "^0.8.0",
-    "@astro-minimax/core": "^0.8.0",
-    "@astro-minimax/notify": "^0.8.0",
+    "@astro-minimax/ai": "^0.8.1",
+    "@astro-minimax/core": "^0.8.1",
+    "@astro-minimax/notify": "^0.8.1",
     "@astrojs/mdx": "^5.0.0",
     "@astrojs/preact": "^5.0.0",
     "@astrojs/rss": "^4.0.17",
@@ -57,7 +57,7 @@
     "tailwindcss": "^4.2.1"
   },
   "devDependencies": {
-    "@astro-minimax/cli": "^0.8.0",
+    "@astro-minimax/cli": "^0.8.1",
     "@astrojs/check": "^0.9.7",
     "@cloudflare/workers-types": "^4.20260313.1",
     "@pagefind/default-ui": "^1.4.0",

package/template/src/data/blog/en/alerts-examples.md

@@ -0,0 +1,64 @@
+---
+title: "GitHub Alerts Examples"
+description: "Demonstrate GitHub-style alert boxes with multiple types"
+pubDatetime: 2024-01-06T00:00:00.000Z
+author: "Your Name"
+tags:
+  - tutorial
+category: Tutorial/Features
+---
+
+## What are GitHub Alerts?
+
+GitHub Alerts are GitHub-style alert boxes that can be used to emphasize important information, warnings, or tips.
+
+## Basic Usage
+
+> [!NOTE]
+> This is a regular note for supplementary information.
+
+> [!TIP]
+> This is a tip that can help users use certain features better.
+
+> [!IMPORTANT]
+> This is important information that users should pay special attention to.
+
+> [!WARNING]
+> This is a warning to alert users about potential risks.
+
+> [!CAUTION]
+> This is a danger warning for irreversible operations.
+
+## With Formatting
+
+> [!NOTE]
+> Notes can contain **bold**, *italic*, and `code`.
+
+> [!TIP]
+> Tips can also include lists:
+> - Item 1
+> - Item 2
+> - Item 3
+
+> [!WARNING]
+> Warnings support code blocks:
+> ```bash
+> rm -rf /  # Never run this!
+> ```
+
+## Use Cases
+
+### For Documentation
+
+> [!TIP]
+> Use alerts to highlight key points in your documentation.
+
+### For Tutorials
+
+> [!IMPORTANT]
+> Make sure to save your work before proceeding.
+
+### For API Docs
+
+> [!WARNING]
+> This endpoint is deprecated and will be removed in v2.0.

package/template/src/data/blog/en/code-examples.md

@@ -0,0 +1,99 @@
+---
+title: "Code Highlighting Examples"
+description: "Demonstrate Shiki code highlighting with multiple programming languages and advanced features"
+pubDatetime: 2024-01-05T00:00:00.000Z
+author: "Your Name"
+tags:
+  - tutorial
+  - code
+category: Tutorial/Features
+---
+
+## Basic Code Blocks
+
+### TypeScript
+
+```typescript
+interface User {
+  id: number;
+  name: string;
+  email: string;
+}
+
+async function fetchUser(id: number): Promise<User> {
+  const response = await fetch(`/api/users/${id}`);
+  if (!response.ok) {
+    throw new Error('Failed to fetch user');
+  }
+  return response.json();
+}
+
+// Usage
+const user = await fetchUser(1);
+console.log(user.name);
+```
+
+### Python
+
+```python
+from dataclasses import dataclass
+from typing import Optional
+
+@dataclass
+class User:
+    id: int
+    name: str
+    email: Optional[str] = None
+
+def fetch_user(user_id: int) -> User:
+    """Fetch a user by ID."""
+    # Simulate API call
+    return User(id=user_id, name="John Doe", email="john@example.com")
+
+# Usage
+user = fetch_user(1)
+print(f"User: {user.name}")
+```
+
+## Advanced Features
+
+### Line Numbers
+
+```typescript showLineNumbers
+function fibonacci(n: number): number {
+  if (n <= 1) return n;
+  return fibonacci(n - 1) + fibonacci(n - 2);
+}
+
+// Calculate first 10 Fibonacci numbers
+for (let i = 0; i < 10; i++) {
+  console.log(fibonacci(i));
+}
+```
+
+### Highlight Lines
+
+```typescript {2,5-7}
+function processData(data: unknown) {
+  if (!data) throw new Error('No data provided');  // Highlighted
+  
+  return {
+    success: true,    // Highlighted
+    data: data,       // Highlighted
+    timestamp: Date.now()  // Highlighted
+  };
+}
+```
+
+### Diff Highlighting
+
+```diff
+function calculateTotal(items: Item[]) {
+-  return items.reduce((sum, item) => sum + item.price, 0);
++  const subtotal = items.reduce((sum, item) => sum + item.price, 0);
++  const tax = subtotal * 0.1;
++  return subtotal + tax;
+}
+```
+
+For more code highlighting options, see the [Shiki documentation](https://shiki.style/).

package/template/src/data/blog/en/hello-world.md

@@ -0,0 +1,78 @@
+---
+title: "Hello, World"
+description: "This is my first blog post, powered by the astro-minimax theme."
+pubDatetime: 2026-01-01T00:00:00.000Z
+author: "Your Name"
+# draft: false       # Optional: Set true to hide from production
+# featured: false    # Optional: Set true to feature on homepage
+tags:
+  - getting-started
+category: Tutorial/Getting Started
+# series:            # Optional: Article series configuration
+#   name: "Getting Started Series"
+#   order: 1
+---
+
+## Welcome to My Blog
+
+This is the first post created using the [astro-minimax](https://github.com/souloss/astro-minimax) theme.
+
+### Start Writing
+
+Create `.md` or `.mdx` files in the `src/data/blog/en/` directory to publish new articles.
+
+Each article requires the following frontmatter:
+
+```yaml
+---
+title: "Article Title"
+description: "Article description"
+pubDatetime: 2026-01-01T00:00:00.000Z
+author: "Author Name"
+tags:
+  - tag-name
+category: Category/Subcategory
+---
+```
+
+### Optional Fields
+
+```yaml
+# draft: false         # Set true to hide the article
+# featured: false      # Set true to feature on homepage
+# modDatetime: ...     # Last modified time
+# series:              # Article series configuration
+#   name: "Series Name"
+#   order: 1
+```
+
+### Customize the Theme
+
+Edit `src/config.ts` to customize your blog:
+
+```typescript
+SITE: {
+  title: "My Blog",
+  author: "Your Name",
+  desc: "Blog description",
+  // Feature toggles
+  features: {
+    tags: true,       // Tags page
+    categories: true, // Categories page
+    series: true,     // Series page
+    archives: true,   // Archives page
+    search: true,     // Search page
+  },
+  darkMode: true,     // Dark mode
+}
+```
+
+### Built-in Features
+
+- ✅ **Markdown Extensions** - Math formulas, code highlighting, GitHub Alerts
+- ✅ **Visualization** - Mermaid diagrams, Markmap mind maps
+- ✅ **SEO Optimization** - Auto-generated sitemap, RSS, Open Graph
+- ✅ **Multi-language** - Chinese and English support
+- ✅ **Dark Mode** - Auto-follow system or manual toggle
+
+Happy writing!

package/template/src/data/blog/en/markmap-examples.md

@@ -0,0 +1,100 @@
+---
+title: "Markmap Mind Map Examples"
+description: "Demonstrate Markmap interactive mind map functionality"
+pubDatetime: 2024-01-03T00:00:00.000Z
+author: "Your Name"
+tags:
+  - tutorial
+  - Markmap
+category: Tutorial/Tools
+---
+
+## What is Markmap?
+
+Markmap is a tool that converts Markdown into interactive mind maps, perfect for presenting hierarchical content.
+
+## Basic Usage
+
+```markmap
+# Central Topic
+
+## Branch 1
+### Sub-branch 1-1
+### Sub-branch 1-2
+#### Deeper level
+
+## Branch 2
+### Sub-branch 2-1
+### Sub-branch 2-2
+
+## Branch 3
+### Sub-branch 3-1
+```
+
+## Learning Path Example
+
+```markmap
+# Web Development Learning Path
+
+## Frontend
+### HTML & CSS
+#### Semantic HTML
+#### Flexbox & Grid
+### JavaScript
+#### ES6+ Features
+#### DOM Manipulation
+### Frameworks
+#### Vue.js
+#### React
+#### Angular
+
+## Backend
+### Node.js
+#### Express
+#### NestJS
+### Python
+#### Django
+#### FastAPI
+### Databases
+#### SQL
+#### MongoDB
+
+## DevOps
+### Version Control
+#### Git
+### CI/CD
+#### GitHub Actions
+### Cloud
+#### AWS
+#### Vercel
+```
+
+## Project Architecture
+
+```markmap
+# Project Structure
+
+## Source Code
+### Components
+#### UI Components
+#### Layout Components
+### Pages
+#### Home
+#### About
+### Services
+#### API Service
+#### Auth Service
+
+## Configuration
+### TypeScript
+### ESLint
+### Vite
+
+## Tests
+### Unit Tests
+### E2E Tests
+```
+
+Click on any node to expand or collapse. This interactivity makes mind maps excellent for documentation and presentations.
+
+For more information, visit [Markmap on GitHub](https://github.com/markmap/markmap).

package/template/src/data/blog/en/math-examples.md

@@ -0,0 +1,58 @@
+---
+title: "Math Formula Examples"
+description: "Demonstrate KaTeX math formula rendering with inline and block formulas"
+pubDatetime: 2024-01-04T00:00:00.000Z
+author: "Your Name"
+tags:
+  - tutorial
+  - math
+category: Tutorial/Features
+---
+
+## Inline Formulas
+
+A simple inline formula: $E = mc^2$, Einstein's mass-energy equation.
+
+Pythagorean theorem: The sum of squares of two right-angle sides equals the square of the hypotenuse, i.e., $a^2 + b^2 = c^2$.
+
+## Block Formulas
+
+### Quadratic Formula
+
+$$x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}$$
+
+### Euler's Formula
+
+$$e^{i\pi} + 1 = 0$$
+
+### Gaussian Integral
+
+$$\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}$$
+
+## Complex Examples
+
+### Matrix
+
+$$
+A = \begin{pmatrix}
+a & b \\
+c & d
+\end{pmatrix}
+$$
+
+### Maxwell's Equations
+
+$$
+\begin{aligned}
+\nabla \cdot \mathbf{E} &= \frac{\rho}{\varepsilon_0} \\
+\nabla \cdot \mathbf{B} &= 0 \\
+\nabla \times \mathbf{E} &= -\frac{\partial \mathbf{B}}{\partial t} \\
+\nabla \times \mathbf{B} &= \mu_0 \mathbf{J} + \mu_0 \varepsilon_0 \frac{\partial \mathbf{E}}{\partial t}
+\end{aligned}
+$$
+
+### Schrödinger Equation
+
+$$i\hbar \frac{\partial}{\partial t} \Psi(\mathbf{r}, t) = \hat{H} \Psi(\mathbf{r}, t)$$
+
+For more KaTeX syntax, see the [KaTeX Documentation](https://katex.org/).

package/template/src/data/blog/en/mermaid-examples.md

@@ -0,0 +1,237 @@
+---
+title: "Mermaid Diagram Examples"
+description: "Demonstrate Mermaid flowcharts, sequence diagrams, class diagrams, and 11 diagram types"
+pubDatetime: 2024-01-02T00:00:00.000Z
+author: "Your Name"
+tags:
+  - tutorial
+  - Mermaid
+category: Tutorial/Tools
+---
+
+This article demonstrates how to create various Mermaid diagrams using ` ```mermaid ` code blocks.
+
+---
+
+## 1. Flowchart
+
+### 1.1 Basic Flowchart
+
+```mermaid
+flowchart TD
+    A[Start] --> B{Condition}
+    B -->|Yes| C[Execute A]
+    B -->|No| D[Execute B]
+    C --> E[End]
+    D --> E
+```
+
+### 1.2 Horizontal Flowchart
+
+```mermaid
+flowchart LR
+    A[Request] --> B[Load Balancer]
+    B --> C[Server A]
+    B --> D[Server B]
+    C --> E[(Database)]
+    D --> E
+```
+
+---
+
+## 2. Sequence Diagram
+
+```mermaid
+sequenceDiagram
+    participant User
+    participant Frontend
+    participant Backend
+    participant Database
+    
+    User->>Frontend: Click login
+    Frontend->>Backend: POST /api/login
+    Backend->>Database: Query user
+    Database-->>Backend: Return data
+    Backend-->>Frontend: Return JWT
+    Frontend-->>User: Redirect home
+```
+
+---
+
+## 3. Class Diagram
+
+```mermaid
+classDiagram
+    class Animal {
+        +String name
+        +int age
+        +makeSound()
+    }
+    class Dog {
+        +String breed
+        +bark()
+    }
+    class Cat {
+        +String color
+        +meow()
+    }
+    Animal <|-- Dog
+    Animal <|-- Cat
+```
+
+---
+
+## 4. State Diagram
+
+```mermaid
+stateDiagram-v2
+    [*] --> Pending
+    Pending --> Processing: Start
+    Processing --> Completed: Success
+    Processing --> Cancelled: Failure
+    Completed --> [*]
+    Cancelled --> [*]
+```
+
+---
+
+## 5. ER Diagram
+
+```mermaid
+erDiagram
+    USER ||--o{ ORDER : places
+    USER {
+        int id PK
+        string username
+        string email
+    }
+    ORDER ||--|{ ORDER_ITEM : contains
+    ORDER {
+        int id PK
+        int user_id FK
+        datetime order_date
+        string status
+    }
+    PRODUCT ||--o{ ORDER_ITEM : "included in"
+    PRODUCT {
+        int id PK
+        string name
+        float price
+    }
+    ORDER_ITEM {
+        int id PK
+        int quantity
+        float unit_price
+    }
+```
+
+---
+
+## 6. Gantt Chart
+
+```mermaid
+gantt
+    title Project Timeline
+    dateFormat YYYY-MM-DD
+    section Design
+    Requirements :a1, 2024-01-01, 7d
+    UI Design :a2, after a1, 5d
+    section Development
+    Frontend :b1, after a2, 14d
+    Backend :b2, after a2, 14d
+    section Testing
+    QA Testing :c1, after b1, 7d
+    Deployment :c2, after c1, 3d
+```
+
+---
+
+## 7. Pie Chart
+
+```mermaid
+pie showData
+    title Programming Language Usage
+    "TypeScript" : 35
+    "Python" : 25
+    "Go" : 20
+    "Rust" : 12
+    "Others" : 8
+```
+
+---
+
+## 8. Git Graph
+
+```mermaid
+gitGraph
+    commit id: "Init project"
+    commit id: "Add features"
+    branch develop
+    checkout develop
+    commit id: "WIP"
+    checkout main
+    merge develop id: "v1.0" tag: "v1.0"
+```
+
+---
+
+## 9. User Journey
+
+```mermaid
+journey
+    title Shopping Experience
+    section Browse
+        Open homepage: 5: User
+        Search products: 4: User
+    section Purchase
+        Add to cart: 4: User
+        Checkout: 3: User, System
+    section Receive
+        Confirm delivery: 5: User
+        Rate product: 4: User
+```
+
+---
+
+## 10. Mindmap
+
+```mermaid
+mindmap
+  root((Web Development))
+    Frontend
+      HTML/CSS
+      JavaScript
+        TypeScript
+        Frameworks
+          Vue
+          React
+    Backend
+      Node.js
+      Python
+      Go
+    Database
+      MySQL
+      MongoDB
+      Redis
+```
+
+---
+
+## 11. Custom Styling
+
+```mermaid
+flowchart TD
+    A[Start] --> B[Process]
+    B --> C[End]
+
+    style A fill:#f9f,stroke:#333,stroke-width:2px
+    style B fill:#bbf,stroke:#333,stroke-width:2px
+    style C fill:#bfb,stroke:#333,stroke-width:2px
+```
+
+---
+
+## References
+
+- [Mermaid Documentation](https://mermaid.js.org/)
+- [Mermaid Live Editor](https://mermaid.live/)

package/template/src/data/blog/en/series-example-01.md

@@ -0,0 +1,41 @@
+---
+title: "Article Series Example - Part 1"
+description: "First part of the article series, demonstrating series navigation"
+pubDatetime: 2024-01-07T00:00:00.000Z
+author: "Your Name"
+tags:
+  - tutorial
+  - series
+category: Tutorial/Examples
+series:
+  name: Article Series Example
+  order: 1
+---
+
+## About Article Series
+
+astro-minimax supports **article series** functionality, automatically displaying series navigation at the bottom of articles, including progress, previous and next links.
+
+### Series Configuration
+
+Add a `series` field in frontmatter:
+
+```yaml
+---
+title: "Article Title"
+series:
+  name: "Series Name"
+  order: 1  # Order in the series
+---
+```
+
+### Features
+
+- Automatic series progress bar
+- Shows current article position
+- Auto-generates previous/next navigation
+- Series page aggregates all articles
+
+---
+
+> **Next**: [Article Series Example - Part 2](/en/posts/series-example-02)

package/template/src/data/blog/en/series-example-02.md

@@ -0,0 +1,41 @@
+---
+title: "Article Series Example - Part 2"
+description: "Second part of the article series, continuing the demonstration"
+pubDatetime: 2024-01-08T00:00:00.000Z
+author: "Your Name"
+tags:
+  - tutorial
+  - series
+category: Tutorial/Examples
+series:
+  name: Article Series Example
+  order: 2
+---
+
+## Series Advanced Topics
+
+This is the second part of the series. When readers view this article, they can see:
+
+- Series progress (e.g., 2/2)
+- Link to the previous article
+- Series overview
+
+### Use Cases
+
+Article series are perfect for:
+
+- Multi-chapter tutorials
+- Topic series
+- Progressive learning paths
+- Project development logs
+
+### Best Practices
+
+1. **Consistent Naming**: Use consistent naming patterns within the series
+2. **Appropriate Splitting**: Each article should focus on one topic
+3. **Cross-References**: Reference other parts appropriately
+4. **Completeness**: Ensure articles form a complete knowledge system
+
+---
+
+> **Previous**: [Article Series Example - Part 1](/en/posts/series-example-01)

package/template/src/data/blog/zh/alerts-examples.md

@@ -2,6 +2,7 @@
 title: "GitHub Alerts 示例"
 description: "展示 GitHub 风格的提示框功能，支持多种类型"
 pubDatetime: 2024-01-06T00:00:00.000Z
+author: "Your Name"
 tags:
   - 教程
 category: 教程/功能

package/template/src/data/blog/zh/code-examples.md

@@ -2,6 +2,7 @@
 title: "代码高亮示例"
 description: "展示 Shiki 代码高亮功能，支持多种编程语言和高级特性"
 pubDatetime: 2024-01-05T00:00:00.000Z
+author: "Your Name"
 tags:
   - 教程
   - 代码

package/template/src/data/blog/zh/hello-world.md

@@ -2,9 +2,15 @@
 title: "你好，世界"
 description: "这是我的第一篇博客文章，由 astro-minimax 主题驱动。"
 pubDatetime: 2026-01-01T00:00:00.000Z
+author: "Your Name"
+# draft: false       # Optional: Set true to hide from production
+# featured: false    # Optional: Set true to feature on homepage
 tags:
   - 入门
 category: 教程/入门
+# series:            # Optional: Article series configuration
+#   name: "Getting Started Series"
+#   order: 1
 ---
 
 ## 欢迎来到我的博客
@@ -22,13 +28,51 @@ category: 教程/入门
 title: "文章标题"
 description: "文章描述"
 pubDatetime: 2026-01-01T00:00:00.000Z
+author: "作者名称"
 tags:
   - 标签名
+category: 分类/子分类
 ---
 ```
 
+### 可选字段
+
+```yaml
+# draft: false         # 设为 true 可隐藏文章
+# featured: false      # 设为 true 可在首页突出显示
+# modDatetime: ...     # 最后修改时间
+# series:              # 系列文章配置
+#   name: "系列名称"
+#   order: 1
+```
+
 ### 自定义主题
 
-编辑 `src/config.ts` 来自定义博客标题、功能开关等配置。
+编辑 `src/config.ts` 来自定义博客：
+
+```typescript
+SITE: {
+  title: "我的博客",
+  author: "Your Name",
+  desc: "博客描述",
+  // 功能开关
+  features: {
+    tags: true,       # 标签页
+    categories: true, # 分类页
+    series: true,     # 系列页
+    archives: true,   # 归档页
+    search: true,     # 搜索页
+  },
+  darkMode: true,     # 暗色模式
+}
+```
+
+### 内置功能
+
+- ✅ **Markdown 扩展** - 数学公式、代码高亮、GitHub Alerts
+- ✅ **可视化** - Mermaid 图表、Markmap 思维导图
+- ✅ **SEO 优化** - 自动生成 sitemap、RSS、Open Graph
+- ✅ **多语言** - 支持中英文双语
+- ✅ **暗色模式** - 自动跟随系统或手动切换
 
-祝你写作愉快！
+祝你写作愉快！

package/template/src/data/blog/zh/markmap-examples.md

@@ -2,6 +2,7 @@
 title: "Markmap 思维导图示例"
 description: "展示 Markmap 交互式思维导图功能"
 pubDatetime: 2024-01-03T00:00:00.000Z
+author: "Your Name"
 tags:
   - 教程
   - Markmap

package/template/src/data/blog/zh/math-examples.md

@@ -2,6 +2,7 @@
 title: "数学公式示例"
 description: "展示 KaTeX 数学公式渲染功能，支持行内公式和块级公式"
 pubDatetime: 2024-01-04T00:00:00.000Z
+author: "Your Name"
 tags:
   - 教程
   - 数学

package/template/src/data/blog/zh/mermaid-examples.md

@@ -1,28 +1,45 @@
 ---
 title: "Mermaid 图表示例"
-description: "展示 Mermaid 流程图、时序图、饼图等多种图表功能"
+description: "展示 Mermaid 流程图、时序图、类图、状态图等 11 种图表类型"
 pubDatetime: 2024-01-02T00:00:00.000Z
+author: "Your Name"
 tags:
   - 教程
   - Mermaid
 category: 教程/工具
 ---
 
-## 流程图
+本文展示如何使用 ` ```mermaid ` 代码块语法创建各种 Mermaid 图表。
+
+---
+
+## 一、流程图 (Flowchart)
+
+### 1.1 基本流程图
+
+```mermaid
+flowchart TD
+    A[开始] --> B{条件判断}
+    B -->|是| C[执行操作A]
+    B -->|否| D[执行操作B]
+    C --> E[结束]
+    D --> E
+```
+
+### 1.2 横向流程图
 
 ```mermaid
-graph TD
-    A[开始] --> B{是否登录?}
-    B -->|是| C[进入主页]
-    B -->|否| D[跳转登录页]
-    D --> E[输入用户名密码]
-    E --> F{验证成功?}
-    F -->|是| C
-    F -->|否| G[显示错误]
-    G --> E
+flowchart LR
+    A[用户请求] --> B[负载均衡]
+    B --> C[服务器A]
+    B --> D[服务器B]
+    C --> E[(数据库)]
+    D --> E
 ```
 
-## 时序图
+---
+
+## 二、时序图 (Sequence Diagram)
 
 ```mermaid
 sequenceDiagram
@@ -39,18 +56,79 @@ sequenceDiagram
     前端-->>用户: 跳转到主页
 ```
 
-## 饼图
+---
+
+## 三、类图 (Class Diagram)
 
 ```mermaid
-pie showData
-    title 编程语言使用比例
-    "TypeScript" : 40
-    "Python" : 25
-    "Go" : 20
-    "Rust" : 15
+classDiagram
+    class Animal {
+        +String name
+        +int age
+        +makeSound()
+    }
+    class Dog {
+        +String breed
+        +bark()
+    }
+    class Cat {
+        +String color
+        +meow()
+    }
+    Animal <|-- Dog
+    Animal <|-- Cat
+```
+
+---
+
+## 四、状态图 (State Diagram)
+
+```mermaid
+stateDiagram-v2
+    [*] --> 待处理
+    待处理 --> 处理中: 开始处理
+    处理中 --> 已完成: 处理成功
+    处理中 --> 已取消: 处理失败
+    已完成 --> [*]
+    已取消 --> [*]
+```
+
+---
+
+## 五、实体关系图 (ER Diagram)
+
+```mermaid
+erDiagram
+    USER ||--o{ ORDER : places
+    USER {
+        int id PK
+        string username
+        string email
+    }
+    ORDER ||--|{ ORDER_ITEM : contains
+    ORDER {
+        int id PK
+        int user_id FK
+        datetime order_date
+        string status
+    }
+    PRODUCT ||--o{ ORDER_ITEM : "included in"
+    PRODUCT {
+        int id PK
+        string name
+        float price
+    }
+    ORDER_ITEM {
+        int id PK
+        int order_id FK
+        int product_id FK
+        int quantity
+    }
 ```
 
-## 甘特图
+---
+
+## 六、甘特图 (Gantt Chart)
 
 ```mermaid
 gantt
@@ -67,17 +145,96 @@ gantt
     上线部署 :c2, after c1, 3d
 ```
 
-## 状态图
+---
+
+## 七、饼图 (Pie Chart)
+
+```mermaid
+pie showData
+    title 编程语言使用占比
+    "TypeScript" : 35
+    "Python" : 25
+    "Go" : 20
+    "Rust" : 12
+    "Others" : 8
+```
+
+---
+
+## 八、Git 图 (Git Graph)
+
+```mermaid
+gitGraph
+    commit id: "初始化项目"
+    commit id: "添加基础功能"
+    branch develop
+    checkout develop
+    commit id: "开发中"
+    commit id: "新功能A"
+    checkout main
+    merge develop id: "v1.0 发布" tag: "v1.0"
+    commit id: "后续优化"
+```
+
+---
+
+## 九、用户旅程图 (User Journey)
 
 ```mermaid
-stateDiagram-v2
-    [*] --> 草稿
-    草稿 --> 待审核: 提交
-    待审核 --> 已发布: 审核通过
-    待审核 --> 草稿: 审核拒绝
-    已发布 --> 已下架: 下架
-    已下架 --> 已发布: 重新发布
-    已发布 --> [*]
+journey
+    title 用户购物体验旅程
+    section 浏览商品
+        打开首页: 5: 用户
+        搜索商品: 4: 用户
+    section 购买流程
+        加入购物车: 4: 用户
+        结算付款: 3: 用户, 系统
+    section 收货评价
+        确认收货: 5: 用户
+        评价商品: 4: 用户
 ```
 
-更多 Mermaid 图表类型请参考 [Mermaid 官方文档](https://mermaid.js.org/)。
+---
+
+## 十、思维导图 (Mindmap)
+
+```mermaid
+mindmap
+  root((Web开发))
+    前端
+      HTML/CSS
+      JavaScript
+        TypeScript
+        框架
+          Vue
+          React
+    后端
+      Node.js
+      Python
+      Go
+    数据库
+      MySQL
+      MongoDB
+      Redis
+```
+
+---
+
+## 十一、样式定制
+
+```mermaid
+flowchart TD
+    A[开始] --> B[处理]
+    B --> C[结束]
+
+    style A fill:#f9f,stroke:#333,stroke-width:2px
+    style B fill:#bbf,stroke:#333,stroke-width:2px
+    style C fill:#bfb,stroke:#333,stroke-width:2px
+```
+
+---
+
+## 参考资料
+
+- [Mermaid 官方文档](https://mermaid.js.org/)
+- [Mermaid Live Editor](https://mermaid.live/)

package/template/src/data/blog/zh/series-example-01.md

@@ -0,0 +1,41 @@
+---
+title: "系列文章示例 - 第一部分"
+description: "这是系列文章的第一篇，演示文章系列导航功能"
+pubDatetime: 2024-01-07T00:00:00.000Z
+author: "Your Name"
+tags:
+  - 教程
+  - 系列
+category: 教程/示例
+series:
+  name: 系列文章示例
+  order: 1
+---
+
+## 系列文章说明
+
+astro-minimax 支持**文章系列**功能，可以自动在文章底部显示系列导航，包括当前进度、上一篇和下一篇链接。
+
+### 系列配置
+
+在 frontmatter 中添加 `series` 字段：
+
+```yaml
+---
+title: "文章标题"
+series:
+  name: "系列名称"
+  order: 1  # 文章在系列中的顺序
+---
+```
+
+### 功能特性
+
+- 自动显示系列进度条
+- 显示当前文章在系列中的位置
+- 自动生成上一篇/下一篇导航链接
+- 系列页面聚合所有系列文章
+
+---
+
+> **下一篇**: [系列文章示例 - 第二部分](/zh/posts/series-example-02)

package/template/src/data/blog/zh/series-example-02.md

@@ -0,0 +1,41 @@
+---
+title: "系列文章示例 - 第二部分"
+description: "这是系列文章的第二篇，继续演示文章系列导航功能"
+pubDatetime: 2024-01-08T00:00:00.000Z
+author: "Your Name"
+tags:
+  - 教程
+  - 系列
+category: 教程/示例
+series:
+  name: 系列文章示例
+  order: 2
+---
+
+## 系列文章进阶
+
+这是系列文章的第二部分。当读者阅读时，可以在文章底部看到：
+
+- 系列进度（如 2/2）
+- 上一篇文章的链接
+- 系列概览
+
+### 适用场景
+
+文章系列功能特别适合：
+
+- 多章节教程
+- 主题系列文章
+- 渐进式学习路径
+- 项目开发记录
+
+### 最佳实践
+
+1. **统一命名**：系列内文章标题使用一致的命名模式
+2. **合理分篇**：每篇文章聚焦一个主题
+3. **相互引用**：在文中适当引用其他篇章
+4. **完整性**：确保系列文章形成完整的知识体系
+
+---
+
+> **上一篇**: [系列文章示例 - 第一部分](/zh/posts/series-example-01)