czon 0.1.0 → 0.1.1

package/.zen/src/zh-Hans/f119cbaf7645c713b1e0fa67abdc1070766c80f94eec9e42108bfa37ef85db43.md

@@ -0,0 +1,24 @@
+---
+'title': '测试 KaTeX'
+'summary':
+  '该文档是一个关于 KaTeX 的测试示例，展示了如何在文档中嵌入数学公式。它包含一个行内公式示例（E =
+  mc²）和一个块级公式示例（定积分公式），用于演示 KaTeX 在渲染数学表达式方面的应用。'
+'tags':
+  - 'KaTeX'
+  - '数学公式'
+  - '行内公式'
+  - '块级公式'
+  - '测试'
+  - '文档示例'
+'inferred_lang': 'zh-Hans'
+---
+
+# 测试 KaTeX
+
+这是一个行内公式测试： $E = mc^2 $ 。
+
+这是一个块级公式测试：
+
+$$
+\int_a^b f(x) \, dx = F(b) - F(a)
+$$

package/.zen/src/zh-Hant/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md

@@ -0,0 +1,123 @@
+---
+'title': 'Mermaid 圖表測試文件'
+'summary': '該文件是一個測試檔案，用於驗證 ZEN 中的 Mermaid 圖表渲染功能。它包含了多種 Mermaid
+  圖表類型的範例，如流程圖、序列圖、甘特圖、類別圖、狀態圖和圓餅圖，並包括一個錯誤語法測試以檢查錯誤訊息顯示。文件旨在展示 Mermaid 整合在 ZEN
+  中的正常工作狀態。'
+'tags':
+  - 'Mermaid'
+  - '圖表測試'
+  - 'ZEN'
+  - '流程圖'
+  - '序列圖'
+  - '甘特圖'
+  - '類別圖'
+  - '狀態圖'
+'inferred_date': '2024-01-01'
+'inferred_lang': 'zh-Hant'
+---
+
+# Mermaid 圖表測試
+
+這是一個測試檔案，用於驗證 ZEN 中的 Mermaid 圖表渲染功能。
+
+## 流程圖範例
+
+```mermaid
+graph TD
+    A[開始] --> B{是否繼續?}
+    B -->|是| C[執行操作]
+    B -->|否| D[結束]
+    C --> E[檢查結果]
+    E --> F{是否成功?}
+    F -->|是| G[完成]
+    F -->|否| H[重試]
+    H --> C
+    G --> D
+```
+
+## 序列圖範例
+
+```mermaid
+sequenceDiagram
+    participant User
+    participant System
+    participant Database
+
+    User->>System: 提交請求
+    System->>Database: 查詢資料
+    Database-->>System: 返回結果
+    System-->>User: 顯示結果
+```
+
+## 甘特圖範例
+
+```mermaid
+gantt
+    title 專案時間表
+    dateFormat  YYYY-MM-DD
+    section 設計
+    需求分析     :done,    des1, 2024-01-01, 7d
+    原型設計     :active,  des2, 2024-01-08, 5d
+    詳細設計     :         des3, after des2, 5d
+    section 開發
+    前端開發     :         dev1, after des3, 10d
+    後端開發     :         dev2, after des3, 15d
+    section 測試
+    單元測試     :         test1, after dev1, 5d
+    整合測試     :         test2, after dev2, 5d
+```
+
+## 類別圖範例
+
+```mermaid
+classDiagram
+    class Animal {
+        +String name
+        +int age
+        +void eat()
+        +void sleep()
+    }
+    class Dog {
+        +void bark()
+    }
+    class Cat {
+        +void meow()
+    }
+
+    Animal <|-- Dog
+    Animal <|-- Cat
+```
+
+## 狀態圖範例
+
+```mermaid
+stateDiagram-v2
+    [*] --> Idle
+    Idle --> Processing : 開始處理
+    Processing --> Success : 處理成功
+    Processing --> Error : 處理失敗
+    Success --> [*]
+    Error --> [*]
+```
+
+## 圓餅圖範例
+
+```mermaid
+pie title 瀏覽器使用率
+    "Chrome" : 65.2
+    "Firefox" : 15.3
+    "Safari" : 12.5
+    "Edge" : 5.2
+    "其他" : 1.8
+```
+
+## 錯誤語法測試（應該顯示錯誤訊息）
+
+```mermaid
+graph TD
+    A --> B
+    // 這裡缺少箭頭定義
+    C --> D
+```
+
+這個測試檔案包含了多種 Mermaid 圖表類型，用於驗證 ZEN 的 Mermaid 整合是否正常工作。

package/.zen/src/zh-Hant/579c3a203225b8b7aead541f42381de0619d8bc1d451d0d9c3267dbc74205503.md

@@ -0,0 +1,81 @@
+---
+'title': 'KaTeX 公式顯示效果測試'
+'summary':
+  "該文件是一個用於測試KaTeX公式顯示效果的範例，包含多個行內和區塊級數學公式，如E=mc^2、積分、導數、級數、分段函數、表格、矩陣等\
+  ，旨在驗證公式的正確渲染。"
+'tags':
+  - 'KaTeX'
+  - '公式測試'
+  - '數學公式'
+  - 'LaTeX'
+  - '顯示效果'
+  - '文件範例'
+'inferred_lang': 'zh-Hans'
+---
+
+# KaTeX 公式顯示效果測試
+
+這是一個行內公式測試： $ E = mc^2 $ 。
+
+這是一個區塊級公式測試：
+
+$$
+\int_a^b f(x) \, dx = F(b) - F(a)
+$$
+
+這是另一個區塊級公式測試：
+
+$$
+\frac{d}{dx}e^x = e^x
+$$
+
+這是一個複雜的公式測試：
+
+$$
+\sum_{n=1}^{\infty} \frac{1}{n^2} = \frac{\pi^2}{6}
+$$
+
+帶有 cases 的公式測試：
+
+$$
+f(x) =
+\begin{cases}
+x^2 & \text{if } x \geq 0 \\
+-x & \text{if } x < 0
+\end{cases}
+$$
+
+表格公式:
+
+$$
+\begin{array}{c|c|c}
+a & b & c \\
+\hline
+1 & 2 & 3 \\
+4 & 5 & 6 \\
+\end{array}
+$$
+
+矩陣公式:
+
+$$
+\begin{pmatrix}
+1 & 2 \\
+3 & 4
+\end{pmatrix}
+$$
+
+含有 text 的公式測試：
+
+$$
+E = mc^2 \quad \text{where } m \text{ is mass and
+    } c \text{ is the speed of light}
+$$
+
+廣義凱利公式：
+
+$$
+f^* = \argmax_f \sum_{i \in X} P_i \ln (1 + f \cdot R_i)
+$$
+
+請確保以上公式均能正確顯示。

package/.zen/src/zh-Hant/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md

@@ -0,0 +1,70 @@
+---
+'title': 'ZEN - 極簡主義 Markdown + AI 靜態網站建構器'
+'summary': 'ZEN 是一個結合 AI 的靜態網站生成器，專注於簡化文件寫作和建構過程。它允許用戶使用 Markdown 在 git 管理的資料夾中建立靜態 HTML 網站，無需複雜配置，所有設定隱藏在 .zen 目錄下。核心功能包括智慧分類導航（透過 AI 分析內容生成網站地圖）、自動增量翻譯（支援多語言版本，用戶可用母語寫作，AI 處理翻譯），以及最小化打擾的寫作體驗。工具依賴 Node.js、OpenAI API Key 和 Git，透過命令列快速建構，支援指定語言參數如 zh-Hans 和 en-US。'
+'tags':
+  - '靜態網站生成器'
+  - 'Markdown'
+  - 'AI'
+  - '多語言翻譯'
+  - '極簡主義'
+  - '文件工具'
+  - 'ZEN'
+'inferred_lang': 'zh-Hans'
+---
+
+# ZEN - 極簡主義 Markdown + AI 靜態網站建構器
+
+[> 網站示範](https://zen.zccz14.com/)
+
+## 基本功能
+
+1. 📃 **靜態網站生成**：將任意一個包含 Markdown 的 git 資料夾建構成一個靜態 HTML 網站。
+2. 🧭 **智慧分類導航**：使用 AI 進行內容分析，生成網站地圖和導航，原始檔案的位置不敏感。
+3. 🌍 **自動增量翻譯**：使用 AI 進行增量翻譯，讓用戶使用母語編寫 Markdown，但用戶可以是多語言的。
+
+為什麼又搞了個 Markdown 靜態網站生成器？我重新思考了 AI 時代下，文件工具可以如何更好地服務於寫作者：
+
+- 回歸內容：最小化打擾，專注寫作
+
+  讓文件回歸本質，讓寫作回歸寧靜。
+
+  其一，我不想做圖書管理員。我有時想寫下一些內容，但我可能還沒有想好它的標題，還沒有形成特別的組織。我希望 LLM 會自動幫我生成標題、做摘要、分類、導航等整理工作。
+
+  其二，我的書房必須打掃乾淨。我不想要配置複雜的建構工具，折騰複雜的文件配置，不喜歡複雜的結構。每次我看到 Docusaurus、VuePress、Astro 這些工具的配置檔案和專案結構，我就頭疼。現在，ZEN 選擇將所有的配置都隱藏到 .zen 目錄下，掃到角落裡，用戶只需要專注於寫作內容，其他的交給 ZEN 來處理。其他的目錄都是您的寫作空間，您可以隨意組織您的 Markdown 檔案。
+
+- 回歸母語：用母語寫作，流暢建構多語言版本
+
+  人生苦短，我懶得翻譯。人在使用母語時，才是最能發揮自身思考深度的。但同時與世界保持連接又是必要的，我不想放棄多語言的交流。於是我希望有一個工具，能讓我用母語寫作，同時又能讓更多人看到我的內容。現在的 i18n 需要自己翻譯不說，還得自己維護內容更新，太麻煩了。我選擇使用 LLM 來幫我做翻譯，省下了我很多時間，並且可以一鍵完成多國語言翻譯。
+
+## 快速開始
+
+前提:
+
+- 已安裝 [Node.js](https://nodejs.org/)（建議版本 18 及以上，需要有 npx 命令）
+- 已取得 [OpenAI API Key](https://platform.openai.com/account/api-keys)，或者 OPENAI 相容的 API Key
+- 已安裝 Git（用於從 Git 列出 Markdown 檔案，忽略 .gitignore 規則過濾的檔案）
+
+首先，工作在一個已經被 git 管理的資料夾中：
+
+配置環境變數
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # 必須：請替換為您的 OpenAI API Key
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # 可選，預設使用 OpenAI 官方 API
+export OPENAI_MODEL="gpt-3.5-turbo"  # 可選，預設使用 gpt-3.5-turbo 模型
+```
+
+建構網站，支援多語言翻譯。使用目前目錄作為來源目錄，輸出到 `.zen/dist` 目錄。
+
+- 可以透過多次使用 `--lang` 參數指定需要生成的語言版本（例如 `--lang zh-Hans --lang en-US`）。
+- 不需要配置來源語言，ZEN 會自動偵測。
+
+```bash
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**檢視更多參數或幫助**：
+
+```bash
+npx zengen@latest
+```

package/.zen/src/zh-Hant/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md

@@ -0,0 +1,74 @@
+---
+'title': 'ZEN - 極簡主義 Markdown + AI 靜態網站建構器'
+'summary':
+  'ZEN 是一個結合 AI 功能的靜態網站生成器，旨在簡化文件寫作和網站建構過程。它允許使用者專注於用母語編寫 Markdown
+  內容，自動處理標題生成、分類導航和增量翻譯，支援多語言版本，無需複雜配置。工具基於 Node.js 和 OpenAI
+  API，透過命令列快速建構網站，適合追求高效和簡潔的寫作者。'
+'tags':
+  - '靜態網站生成器'
+  - 'Markdown'
+  - 'AI'
+  - '極簡主義'
+  - '多語言翻譯'
+  - 'Node.js'
+  - 'OpenAI'
+'inferred_lang': 'zh-Hans'
+---
+
+# ZEN - 極簡主義 Markdown + AI 靜態網站建構器
+
+[> 網站示範](https://zccz14.github.io/ZEN/)
+
+## 基本功能
+
+1. 📃 **靜態網站生成**：將任意一個包含 Markdown 的 git 資料夾建構成一個靜態 HTML 網站。
+2. 🧭 **智慧分類導航**：使用 AI 進行內容分析，生成網站地圖和導航，原始檔案的位置不敏感。
+3. 🌍 **自動增量翻譯**：使用 AI 進行增量翻譯，讓使用者使用母語編寫 Markdown，但使用者可以是多語言的。
+
+為什麼又搞了個 Markdown 靜態網站生成器？我重新思考了 AI 時代下，文件工具可以如何更好地服務於寫作者：
+
+- 回歸內容：最小化打擾，專注寫作
+
+  讓文件回歸本質，讓寫作回歸寧靜。
+
+  其一，我不想當圖書管理員。我有時想寫下一些內容，但我可能還沒想好它的標題，還沒有形成特別的組織。我希望 LLM 會自動幫我生成標題、做摘要、分類、導航等整理工作。
+
+  其二，我的書房必須打掃乾淨。我不想要配置複雜的建構工具，折騰複雜的文件配置，不喜歡複雜的結構。每次我看到 Docusaurus、VuePress、Astro 這些工具的配置檔案和專案結構，我就頭疼。現在，ZEN 選擇將所有的配置都隱藏到 .zen 目錄下，掃到角落裡，使用者只需要專注於寫作內容，其他的交給 ZEN 來處理。其他的目錄都是您的寫作空間，您可以隨意組織您的 Markdown 檔案。
+
+- 回歸母語：用母語寫作，流暢建構多語言版本
+
+  人生苦短，我懶得翻譯。人在使用母語時，才是最能發揮自身思考深度的。但同時與世界保持連接又是必要的，我不想放棄多語言的交流。於是我希望有一個工具，能讓我用母語寫作，同時又能讓更多人看到我的內容。現在的 i18n 需要自己翻譯不說，還得自己維護內容更新，太麻煩了。我選擇使用 LLM 來幫我做翻譯，省下了我很多時間，並且可以一鍵完成多國語言翻譯。
+
+## 快速開始
+
+前提:
+
+- 已安裝 [Node.js](https://nodejs.org/)（建議版本 18 及以上，需要有 npx 命令）
+- 已取得 [OpenAI API Key](https://platform.openai.com/account/api-keys)，或者 OPENAI 相容的 API Key
+- 已安裝 Git（用於從 Git 列出 Markdown 檔案，忽略 .gitignore 規則過濾的檔案）
+
+首先，工作在一個已經被 git 管理的資料夾中：
+
+配置環境變數
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # 必須：請替換為您的 OpenAI API Key
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # 可選，預設使用 OpenAI 官方 API
+export OPENAI_MODEL="gpt-3.5-turbo"  # 可選，預設使用 gpt-3.5-turbo 模型
+```
+
+建構網站，支援多語言翻譯。使用當前目錄作為來源目錄，輸出到 `.zen/dist` 目錄。
+
+- 可以透過多次使用 `--lang` 參數指定需要生成的語言版本（例如 `--lang zh-Hans --lang en-US`）。
+- 可以透過 `--base-url` 參數指定網站的基礎 URL 前綴（例如 GitHub Pages 上的儲存庫名稱）。
+- 不需要配置來源語言，ZEN 會自動偵測。
+
+```bash
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**檢視更多參數或幫助**：
+
+```bash
+npx zengen@latest
+```

package/.zen/src/zh-Hant/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md

@@ -0,0 +1,71 @@
+---
+'title': 'ZEN - 極簡主義 Markdown + AI 靜態網站建構器'
+'summary': 'ZEN 是一個結合 AI 功能的靜態網站生成器，專為 Markdown 文件設計。它允許使用者將包含 Markdown 檔案的 Git 資料夾轉換為靜態 HTML 網站，無需複雜配置，所有設定隱藏在 .zen 目錄中。核心功能包括智慧分類導航（使用 AI 分析內容生成網站地圖）、自動增量翻譯（支援多語言版本，使用者可用母語寫作，AI 處理翻譯），以及最小化打擾的寫作體驗。快速開始指南要求安裝 Node.js、取得 OpenAI API Key 和 Git，透過命令列建構網站，支援指定語言和基礎 URL。'
+'tags':
+  - '靜態網站生成器'
+  - 'Markdown'
+  - 'AI'
+  - '多語言翻譯'
+  - '極簡主義'
+  - '文件工具'
+  - 'Git'
+'inferred_lang': 'zh-Hant'
+---
+
+# ZEN - 極簡主義 Markdown + AI 靜態網站建構器
+
+[> 網站示範](https://zen.zccz14.com/)
+
+## 基本功能
+
+1. 📃 **靜態網站生成**：將任意一個包含 Markdown 的 git 資料夾建構成一個靜態 HTML 網站。
+2. 🧭 **智慧分類導航**：使用 AI 進行內容分析，生成網站地圖和導航，原始檔案的位置不敏感。
+3. 🌍 **自動增量翻譯**：使用 AI 進行增量翻譯，讓使用者使用母語編寫 Markdown，但是使用者可以是多語言的。
+
+為什麼又搞了個 Markdown 靜態網站生成器？我重新思考了 AI 時代下，文件工具可以如何更好地服務於寫作者：
+
+- 回歸內容：最小化打擾，專注寫作
+
+  讓文件回歸本質，讓寫作回歸寧靜。
+
+  其一，我不想做圖書管理員。我有時想寫下一些內容，但我可能還沒有想好它的標題，還沒有形成特別的組織。我希望 LLM 會自動幫我生成標題、做摘要、分類、導航等整理工作。
+
+  其二，我的書房必須打掃乾淨。我不想要配置複雜的建構工具，折騰複雜的文件配置，不喜歡複雜的結構。每次我看到 Docusaurus、VuePress、Astro 這些工具的配置檔案和專案結構，我就頭疼。現在，ZEN 選擇將所有的配置都隱藏到 .zen 目錄下，掃到角落裡，使用者只需要專注於寫作內容，其他的交給 ZEN 來處理。其他的目錄都是您的寫作空間，您可以隨意組織您的 Markdown 檔案。
+
+- 回歸母語：用母語寫作，流暢建構多語言版本
+
+  人生苦短，我懶得翻譯。人在使用母語時，才是最能發揮自身思考深度的。但同時與世界保持連接又是必要的，我不想放棄多語言的交流。於是我希望有一個工具，能讓我用母語寫作，同時又能讓更多人看到我的內容。現在的 i18n 需要自己翻譯不說，還得自己維護內容更新，太麻煩了。我選擇使用 LLM 來幫我做翻譯，省下了我很多時間，並且可以一鍵完成多國語言翻譯。
+
+## 快速開始
+
+前提:
+
+- 已安裝 [Node.js](https://nodejs.org/)（建議版本 18 及以上，需要有 npx 命令）
+- 已取得 [OpenAI API Key](https://platform.openai.com/account/api-keys)，或者 OPENAI 相容的 API Key
+- 已安裝 Git（用於從 Git 列出 Markdown 檔案，忽略 .gitignore 規則過濾的檔案）
+
+首先，工作在一個已經被 git 管理的資料夾中：
+
+配置環境變數
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # 必須：請替換為您的 OpenAI API Key
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # 可選，預設使用 OpenAI 官方 API
+export OPENAI_MODEL="gpt-3.5-turbo"  # 可選，預設使用 gpt-3.5-turbo 模型
+```
+
+建構網站，支援多語言翻譯。使用當前目錄作為來源目錄，輸出到 `.zen/dist` 目錄。
+
+- 可以透過多次使用 `--lang` 參數指定需要生成的語言版本（例如 `--lang zh-Hans --lang en-US`）。
+- 可以透過 `--base-url` 參數指定網站的基礎 URL 前綴（例如 GitHub Pages 上的儲存庫名稱）。
+- 不需要配置來源語言，ZEN 會自動偵測。
+
+```bash
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**查看更多參數或幫助**：
+
+```bash
+npx zengen@latest
+```

package/.zen/src/zh-Hant/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md

@@ -0,0 +1,31 @@
+---
+'title': 'ZEN文件日期聲明使用技巧'
+'summary': '本文檔介紹了ZEN工具中在正文中直接聲明日期的使用技巧，與傳統Markdown透過YAML
+  Frontmatter聲明日期的方式對比，強調了ZEN的自動識別和智能處理功能，提升了使用者體驗，並適用於日記、部落格等需要時間線的內容類型。'
+'tags':
+  - 'ZEN'
+  - '日期聲明'
+  - 'Markdown'
+  - 'AI處理'
+  - '時間線'
+  - '使用者體驗'
+  - '文件管理'
+'inferred_date': '2026-01-08'
+'inferred_lang': 'zh-Hans'
+---
+
+# 使用技巧
+
+## 在正文中聲明日期
+
+正文中可以使用「今天是 2026 年 1 月 8 日」這樣的日期聲明（格式風格自由），ZEN 會自動識別並處理。
+
+傳統 Markdown 文件是透過 YAML Frontmatter 聲明日期，需要記住對應的欄位，否則會導致日期無法正確識別。
+
+ZEN 支援在正文中直接聲明日期，避免了忘記填寫 Frontmatter 欄位的問題。
+
+AI 會自動擷取並推斷正文中的日期資訊，並將其作為文件的建立日期進行處理。
+
+這種方式更加靈活和智能，提升了使用者體驗。
+
+順帶一提，具有日期的文件，可以生成時間線檢視，方便瀏覽和管理。特別適合日記、部落格等需要時間線的內容類型。

package/README.md

@@ -0,0 +1,56 @@
+# ZEN - 极简主义 Markdown + AI 静态站点构建器
+
+[> Website Demo](https://zen.zccz14.com/)
+
+## 基本功能
+
+1. 📃 **静态站点生成**：将任意一个包含 Markdown 的 git 文件夹构建成一个静态 HTML 站点。
+2. 🧭 **智能分类导航**：使用 AI 进行内容分析，生成站点地图和导航，源文件的位置不敏感。
+3. 🌍 **自动增量翻译**：使用 AI 进行增量翻译，让用户使用母语编写 Markdown，但是用户可以是多语言的。
+
+为什么又搞了个 Markdown 静态站点生成器？我重新思考了 AI 时代下，文档工具可以如何更好地服务于写作者：
+
+- 回归内容：最小化打扰，专注写作
+
+  让文档回归本质，让写作回归宁静。
+
+  其一，我不想做图书管理员。我有时想写下一些内容，但我可能还没有想好它的标题，还没有形成特别的组织。我希望 LLM 会自动帮我生成标题、做摘要、分类、导航等整理工作。
+
+  其二，我的书房必须打扫干净。我不想要配置复杂的构建工具，折腾复杂的文档配置，不喜欢复杂的结构。每次我看到 Docusaurus、VuePress、Astro 这些工具的配置文件和项目结构，我就头疼。现在，ZEN 选择将所有的配置都隐藏到 .zen 目录下，扫到角落里，用户只需要专注于写作内容，其他的交给 ZEN 来处理。其他的目录都是您的写作空间，您可以随意组织您的 Markdown 文件。
+
+- 回归母语：用母语写作，丝滑构建多语言版本
+
+  人生苦短，我懒得翻译。人在使用母语时，才是最能发挥自身思考深度的。但同时与世界保持连接又是必要的，我不想放弃多语言的交流。于是我希望有一个工具，能让我用母语写作，同时又能让更多人看到我的内容。现在的 i18n 需要自己翻译不说，还得自己维护内容更新，太麻烦了。我选择使用 LLM 来帮我做翻译，省下了我很多时间，并且可以一键完成多国语言翻译。
+
+## 快速开始
+
+前提:
+
+- 已安装 [Node.js](https://nodejs.org/)（建议版本 18 及以上，需要有 npx 命令）
+- 已获取 [OpenAI API Key](https://platform.openai.com/account/api-keys)，或者 OPENAI 兼容的 API Key
+- 已安装 Git（用于从 Git 列出 Markdown 文件，忽略 .gitignore 规则过滤的文件）
+
+首先，工作在一个已经被 git 管理的文件夹中：
+
+配置环境变量
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # 必须：请替换为您的 OpenAI API Key
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # 可选，默认使用 OpenAI 官方 API
+export OPENAI_MODEL="gpt-3.5-turbo"  # 可选，默认使用 gpt-3.5-turbo 模型
+```
+
+构建站点，支持多语言翻译。使用当前目录作为源目录，输出到 `.zen/dist` 目录。
+
+- 可以通过多次使用 `--lang` 参数指定需要生成的语言版本（例如 `--lang zh-Hans --lang en-US`）。
+- 不需要配置源语言，ZEN 会自动检测。
+
+```bash
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**查看更多参数或帮助**：
+
+```bash
+npx zengen@latest
+```