zengen 0.1.35 → 0.1.36

package/dist/translation-service.js

@@ -0,0 +1,291 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TranslationService = void 0;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const ai_service_1 = require("./ai-service");
+/**
+ * 翻译服务类
+ */
+class TranslationService {
+    constructor(config = {}) {
+        // 从环境变量读取配置
+        const apiKey = process.env.OPENAI_API_KEY || '';
+        const baseUrl = process.env.OPENAI_BASE_URL || 'https://api.openai.com/v1';
+        // 配置优先级：构造函数参数 > 环境变量 > 默认值
+        const model = config.model || process.env.OPENAI_MODEL || 'gpt-3.5-turbo';
+        this.config = {
+            enabled: config.enabled ?? apiKey !== '',
+            apiKey,
+            baseUrl,
+            model,
+            temperature: 0, // 总是设置为 0，翻译不需要随机性
+            maxTokens: config.maxTokens || 2000,
+        };
+        this.aiService = new ai_service_1.AIService();
+        this.translationCachePath = path.join(process.cwd(), '.zen', 'translations.json');
+    }
+    /**
+     * 检查是否启用翻译功能
+     */
+    isEnabled() {
+        const enabled = this.config.enabled && this.config.apiKey !== '';
+        if (!enabled && this.config.enabled) {
+            console.warn('⚠️ Translation is enabled but API key is missing. Please set OPENAI_API_KEY environment variable.');
+        }
+        return enabled;
+    }
+    /**
+     * 加载翻译缓存
+     */
+    async loadTranslationCache() {
+        try {
+            await fs.access(this.translationCachePath);
+            const content = await fs.readFile(this.translationCachePath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch (error) {
+            // 如果文件不存在，返回空数组
+            return [];
+        }
+    }
+    /**
+     * 保存翻译缓存
+     */
+    async saveTranslationCache(cache) {
+        // 确保 .zen 目录存在
+        const zenDir = path.dirname(this.translationCachePath);
+        await fs.mkdir(zenDir, { recursive: true });
+        // 保存文件
+        await fs.writeFile(this.translationCachePath, JSON.stringify(cache, null, 2), 'utf-8');
+    }
+    /**
+     * 获取缓存的翻译
+     */
+    async getCachedTranslation(sourceHash, sourceLang, targetLang) {
+        if (!this.isEnabled()) {
+            return null;
+        }
+        try {
+            const cache = await this.loadTranslationCache();
+            const cachedTranslation = cache.find(item => item.sourceHash === sourceHash &&
+                item.sourceLang === sourceLang &&
+                item.targetLang === targetLang);
+            if (cachedTranslation) {
+                console.log(`📚 Using cached translation for ${sourceHash} (${sourceLang} → ${targetLang})`);
+                return cachedTranslation.translatedContent;
+            }
+        }
+        catch (error) {
+            console.warn(`⚠️ Failed to load translation cache:`, error);
+        }
+        return null;
+    }
+    /**
+     * 缓存翻译结果
+     */
+    async cacheTranslation(sourceHash, sourceLang, targetLang, translatedContent) {
+        if (!this.isEnabled()) {
+            return;
+        }
+        try {
+            const cache = await this.loadTranslationCache();
+            // 查找是否已存在相同翻译
+            const existingIndex = cache.findIndex(item => item.sourceHash === sourceHash &&
+                item.sourceLang === sourceLang &&
+                item.targetLang === targetLang);
+            if (existingIndex >= 0) {
+                // 更新现有缓存
+                cache[existingIndex] = {
+                    sourceHash,
+                    sourceLang,
+                    targetLang,
+                    translatedContent,
+                    lastUpdated: new Date().toISOString(),
+                };
+            }
+            else {
+                // 添加新缓存
+                cache.push({
+                    sourceHash,
+                    sourceLang,
+                    targetLang,
+                    translatedContent,
+                    lastUpdated: new Date().toISOString(),
+                });
+            }
+            await this.saveTranslationCache(cache);
+            console.log(`💾 Cached translation for ${sourceHash} (${sourceLang} → ${targetLang})`);
+        }
+        catch (error) {
+            console.warn(`⚠️ Failed to cache translation:`, error);
+        }
+    }
+    /**
+     * 使用AI翻译内容
+     */
+    async translateWithAI(content, sourceLang, targetLang) {
+        if (!this.isEnabled()) {
+            throw new Error('Translation service is not enabled');
+        }
+        const prompt = `请将以下${sourceLang}文本翻译成${targetLang}。保持Markdown格式不变，只翻译文本内容：
+
+${content}
+
+翻译结果（保持原格式）：`;
+        try {
+            const response = await fetch(`${this.config.baseUrl}/chat/completions`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Authorization': `Bearer ${this.config.apiKey}`,
+                },
+                body: JSON.stringify({
+                    model: this.config.model,
+                    messages: [
+                        {
+                            role: 'system',
+                            content: '你是一个专业的翻译助手，擅长将文档翻译成不同语言，同时保持原有的格式和结构。'
+                        },
+                        {
+                            role: 'user',
+                            content: prompt
+                        }
+                    ],
+                    temperature: this.config.temperature,
+                    max_tokens: this.config.maxTokens,
+                }),
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(`Translation API error: ${response.status} ${errorText}`);
+            }
+            const data = await response.json();
+            const translatedContent = data.choices[0]?.message?.content?.trim() || '';
+            if (!translatedContent) {
+                throw new Error('Empty translation response');
+            }
+            return translatedContent;
+        }
+        catch (error) {
+            console.error(`❌ Translation failed:`, error);
+            throw error;
+        }
+    }
+    /**
+     * 翻译文件
+     */
+    async translateFile(fileInfo, sourceLang, targetLang) {
+        const sourceHash = fileInfo.hash || this.aiService.calculateFileHash(fileInfo.content);
+        // 检查缓存
+        const cachedTranslation = await this.getCachedTranslation(sourceHash, sourceLang, targetLang);
+        if (cachedTranslation) {
+            return cachedTranslation;
+        }
+        // 如果目标语言与源语言相同，直接返回原内容
+        if (sourceLang === targetLang) {
+            console.log(`📝 Skipping translation (same language): ${sourceLang} → ${targetLang}`);
+            await this.cacheTranslation(sourceHash, sourceLang, targetLang, fileInfo.content);
+            return fileInfo.content;
+        }
+        // 使用AI翻译
+        console.log(`🌐 Translating from ${sourceLang} to ${targetLang}...`);
+        const translatedContent = await this.translateWithAI(fileInfo.content, sourceLang, targetLang);
+        // 缓存结果
+        await this.cacheTranslation(sourceHash, sourceLang, targetLang, translatedContent);
+        return translatedContent;
+    }
+    /**
+     * 生成翻译后的文件路径
+     */
+    getTranslatedFilePath(originalPath, targetLang, nativeHash) {
+        const zenSrcDir = path.join(process.cwd(), '.zen', 'src');
+        const langDir = path.join(zenSrcDir, targetLang);
+        const fileName = `${nativeHash}.md`;
+        return path.join(langDir, fileName);
+    }
+    /**
+     * 确保翻译文件存在
+     */
+    async ensureTranslatedFile(fileInfo, sourceLang, targetLang, nativeHash) {
+        const translatedFilePath = this.getTranslatedFilePath(fileInfo.path, targetLang, nativeHash);
+        try {
+            // 检查文件是否已存在
+            await fs.access(translatedFilePath);
+            console.log(`📄 Translation file already exists: ${translatedFilePath}`);
+            // 读取现有内容
+            const existingContent = await fs.readFile(translatedFilePath, 'utf-8');
+            return existingContent;
+        }
+        catch (error) {
+            // 文件不存在，需要翻译
+            console.log(`🔄 Creating translation file: ${translatedFilePath}`);
+            // 翻译内容
+            const translatedContent = await this.translateFile(fileInfo, sourceLang, targetLang);
+            // 确保目录存在
+            const dirPath = path.dirname(translatedFilePath);
+            await fs.mkdir(dirPath, { recursive: true });
+            // 保存翻译文件
+            await fs.writeFile(translatedFilePath, translatedContent, 'utf-8');
+            return translatedContent;
+        }
+    }
+    /**
+     * 清理过期的翻译缓存
+     */
+    async cleanupCache(maxAgeDays = 30) {
+        try {
+            const cache = await this.loadTranslationCache();
+            const cutoffTime = Date.now() - maxAgeDays * 24 * 60 * 60 * 1000;
+            const originalCount = cache.length;
+            // 过滤掉过期的缓存
+            const filteredCache = cache.filter(item => {
+                const itemTime = new Date(item.lastUpdated).getTime();
+                return itemTime >= cutoffTime;
+            });
+            const cleanedCount = originalCount - filteredCache.length;
+            if (cleanedCount > 0) {
+                await this.saveTranslationCache(filteredCache);
+                console.log(`🧹 Cleaned ${cleanedCount} expired translation cache entries`);
+            }
+        }
+        catch (error) {
+            console.warn(`⚠️ Failed to cleanup translation cache:`, error);
+        }
+    }
+}
+exports.TranslationService = TranslationService;
+//# sourceMappingURL=translation-service.js.map

package/dist/translation-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translation-service.js","sourceRoot":"","sources":["../src/translation-service.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -8,10 +8,16 @@ export interface BuildOptions {
     port?: number;
     host?: string;
     baseUrl?: string;
+    langs?: string[];
+}
+export interface ScannedFile {
+    path: string;
+    name: string;
+    ext: string;
+    hash?: string;
 }
 export interface FileInfo {
     path: string;
-    relativePath: string;
     name: string;
     ext: string;
     content: string;
@@ -19,6 +25,20 @@ export interface FileInfo {
     metadata?: {
         title: string;
     };
+    hash?: string;
+    aiMetadata?: AIMetadata;
+}
+export interface AIMetadata {
+    title: string;
+    summary: string;
+    tags: string[];
+    inferred_date?: string;
+    inferred_lang: string;
+    tokens_used?: {
+        prompt: number;
+        completion: number;
+        total: number;
+    };
 }
 export interface NavigationItem {
     title: string;
@@ -29,10 +49,10 @@ export interface TemplateData {
     title: string;
     content: string;
     navigation: NavigationItem[];
-    metadata?: {
-        title: string;
-    };
+    metadata?: AIMetadata;
     currentPath?: string;
+    lang?: string;
+    availableLangs?: string[];
 }
 export interface MarkdownProcessor {
     beforeParse?(content: string, fileInfo: FileInfo): string | Promise<string>;
@@ -48,8 +68,19 @@ export interface ZenConfig {
         targetLangs: string[];
         apiKey?: string;
     };
+    ai?: {
+        enabled?: boolean;
+        model?: string;
+        temperature?: number;
+        maxTokens?: number;
+    };
     processors?: MarkdownProcessor[];
     includePattern?: string;
     excludePattern?: string;
 }
+export interface MultiLangBuildOptions extends BuildOptions {
+    langs: string[];
+    useMetaData?: boolean;
+    filterOrphans?: boolean;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5E,UAAU,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACzE;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE;QACL,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,UAAU,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/docs/advanced-usage.md

@@ -0,0 +1,39 @@
+# 高级用法
+
+深入介绍 ZEN 的高级功能和配置选项。
+
+## 自定义模板
+
+ZEN 支持自定义 HTML 模板：
+
+```bash
+zengen build --src ./docs --out ./dist --template ./custom-template.html
+```
+
+## 配置选项
+
+可以在 `.zenrc` 文件中配置：
+
+```json
+{
+  "srcDir": "./docs",
+  "outDir": "./dist",
+  "template": "./template.html",
+  "baseUrl": "https://example.com",
+  "i18n": {
+    "sourceLang": "zh-Hans",
+    "targetLangs": ["en-US", "ja-JP"]
+  }
+}
+```
+
+## 插件系统
+
+ZEN 支持插件扩展功能：
+
+```typescript
+interface MarkdownProcessor {
+  beforeParse?(content: string, fileInfo: FileInfo): string | Promise<string>;
+  afterParse?(html: string, fileInfo: FileInfo): string | Promise<string>;
+}
+```

package/docs/getting-started.md

@@ -0,0 +1,26 @@
+# 快速开始指南
+
+本文档介绍如何快速开始使用 ZEN 文档生成器。
+
+## 安装
+
+```bash
+npm install -g zengen
+```
+
+## 基本用法
+
+1. 创建文档目录
+2. 编写 Markdown 文件
+3. 运行构建命令
+
+```bash
+zengen build --src ./docs --out ./dist
+```
+
+## 特性
+
+- 极简配置
+- 内置响应式模板
+- AI 辅助元数据提取
+- 多语言支持

package/docs/guides/best-practices.md

@@ -2,95 +2,6 @@
 
 本文档介绍使用 ZEN 构建文档站点的最佳实践。
 
-## 文件组织
-
-### 推荐的文件结构
-
-```
-project/
-├── docs/                    # 文档源文件
-│   ├── index.md            # 首页
-│   ├── getting-started.md  # 入门指南
-│   ├── api/                # API 文档目录
-│   │   ├── overview.md
-│   │   ├── core-api.md
-│   │   └── plugins.md
-│   ├── guides/             # 指南目录
-│   │   ├── installation.md
-│   │   └── configuration.md
-│   └── resources/          # 资源文件
-│       └── images/
-└── package.json
-```
-
-**注意**: ZEN 强制使用当前目录作为源目录，所以应该切换到 `docs/` 目录下运行构建命令：
-
-```bash
-cd docs
-npx zengen build
-```
-
-### 命名约定
-
-- 使用小写字母和连字符：`getting-started.md`
-- 避免特殊字符和空格
-- 主要页面使用简短名称：`index.md`, `api.md`
-- 分类页面使用目录组织
-
-## 写作规范
-
-### Markdown 语法
-
-**推荐:**
-
-````markdown
-# 一级标题
-
-## 二级标题
-
-### 三级标题
-
-使用 **粗体** 和 _斜体_ 强调重要内容。
-
-- 列表项 1
-- 列表项 2
-  - 子列表项
-
-1. 有序列表项 1
-2. 有序列表项 2
-
-> 引用重要的说明或提示。
-
-`行内代码` 用于技术术语。
-
-```javascript
-// 代码块示例
-console.log('Hello ZEN!');
-```
-````
-
-````
-
-**避免:**
-- 过多的标题层级（超过 4 级）
-- 复杂的表格（考虑使用简单列表替代）
-- 过长的行（建议 80-100 字符换行）
-
-### 元数据使用
-
-在每个 Markdown 文件顶部添加 frontmatter：
-
-```yaml
----
-title: 页面标题
-description: 简洁的页面描述
-keywords: [关键词1, 关键词2]
-author: 作者名
-date: 2024-01-01
-last_modified: 2024-01-15
----
-````
-
 ## 多语言管理
 
 ### 翻译策略
@@ -100,30 +11,6 @@ last_modified: 2024-01-15
 3. **术语一致**: 建立术语表保持翻译一致性
 4. **人工校对**: AI 翻译后建议人工校对
 
-### 翻译文件管理
-
-```
-docs/
-├── index.zh-CN.md      # 中文源文件
-├── index.en-US.md      # 英文翻译
-├── api/
-│   ├── overview.zh-CN.md
-│   └── overview.en-US.md
-└── glossary.json       # 术语表
-```
-
-### 配置示例
-
-```json
-{
-  "i18n": {
-    "sourceLang": "zh-CN",
-    "targetLangs": ["en-US", "ja-JP"],
-    "apiKey": "your-openai-api-key"
-  }
-}
-```
-
 ## 性能优化
 
 ### 构建优化