zengen 0.1.34 → 0.1.36

package/.github/workflows/bump-version.yml

@@ -0,0 +1,112 @@
+name: Bump Version
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version bump type'
+        required: true
+        type: choice
+        options:
+          - major
+          - minor
+          - patch
+        default: 'patch'
+
+jobs:
+  bump-version:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+          persist-credentials: true
+
+      - name: Setup Git
+        run: |
+          git config --global user.name 'github-actions[bot]'
+          git config --global user.email 'github-actions[bot]@users.noreply.github.com'
+
+      - name: Sync with remote
+        run: |
+          git fetch origin
+          git checkout -b bump-version-${{ github.run_id }}
+          git reset --hard origin/main
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '24.x'
+
+      - name: Get current version
+        id: get_version
+        run: |
+          CURRENT_VERSION=$(jq -r '.version' package.json)
+          echo "current_version=$CURRENT_VERSION" >> $GITHUB_OUTPUT
+          echo "Current version: $CURRENT_VERSION"
+
+      - name: Bump version
+        id: bump_version
+        run: |
+          # 解析当前版本号 (支持 semver 格式)
+          CURRENT_VERSION="${{ steps.get_version.outputs.current_version }}"
+          echo "Current version: $CURRENT_VERSION"
+
+          # 使用 npm version 命令来安全地更新版本
+          # 这会自动处理 semver 规则
+          npm version "${{ github.event.inputs.version }}" --no-git-tag-version
+
+          # 获取新版本
+          NEW_VERSION=$(jq -r '.version' package.json)
+          echo "new_version=$NEW_VERSION" >> $GITHUB_OUTPUT
+          echo "New version: $NEW_VERSION"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests
+        run: |
+          npm run test:types
+          npm run test:build
+          npm run test:cli
+
+      - name: Show changed files
+        run: |
+          echo "Changed files:"
+          git status --porcelain
+
+      - name: Create Pull Request
+        uses: peter-evans/create-pull-request@v4
+        with:
+          commit-message: "chore: bump version from ${{ steps.get_version.outputs.current_version }} to ${{ steps.bump_version.outputs.new_version }}"
+          title: "chore: bump version from ${{ steps.get_version.outputs.current_version }} to ${{ steps.bump_version.outputs.new_version }}"
+          body: |
+            This PR was automatically created by the Bump Version workflow.
+
+            ## Changes
+            - Bumped version from **${{ steps.get_version.outputs.current_version }}** to **${{ steps.bump_version.outputs.new_version }}**
+            - Version bump type: **${{ github.event.inputs.version }}**
+
+            ## Test Results
+            - Type checking: ✅ Passed
+            - Build test: ✅ Passed
+            - CLI test: ✅ Passed
+
+            🤖 Generated with [Claude Code](https://claude.com/claude-code)
+
+            Co-Authored-By: Claude <noreply@anthropic.com>
+          branch: bump-version-${{ github.run_id }}
+          base: main
+          labels: |
+            automated-pr
+            version-bump
+            enhancement
+          token: ${{ secrets.GITHUB_TOKEN }}
+          add-paths: |
+            package.json
+            package-lock.json

package/.github/workflows/ci.yml

@@ -11,7 +11,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node-version: [20.x, 22.x, 24.x]
+        node-version: [22.x, 24.x]
 
     steps:
       - name: Checkout repository
@@ -52,7 +52,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: '20.x'
+          node-version: '22.x'
 
       - name: Install dependencies
         run: npm ci

package/.github/workflows/pages.yml

@@ -33,15 +33,9 @@ jobs:
           node-version: '24.x'
           cache: 'npm'
 
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Build zengen
-        run: npm run build
-
       - name: Create documentation site
         run: |
-          npx --no-install zengen build --base-url /ZEN
+          npx zengen@latest build --base-url /ZEN
 
       - name: Setup Pages
         uses: actions/configure-pages@v4

package/.zen/meta.json

@@ -0,0 +1,57 @@
+{
+  "version": "1.0.0",
+  "timestamp": "2026-01-05T00:00:00.000Z",
+  "files": [
+    {
+      "hash": "abc123",
+      "path": "docs/getting-started.md",
+      "metadata": {
+        "title": "快速开始指南",
+        "summary": "本文档介绍如何快速开始使用 ZEN 文档生成器",
+        "tags": ["getting-started", "tutorial", "documentation"],
+        "inferred_date": "2025-12-01",
+        "inferred_lang": "zh-Hans",
+        "tokens_used": {
+          "prompt": 100,
+          "completion": 50,
+          "total": 150
+        }
+      },
+      "lastUpdated": "2026-01-05T00:00:00.000Z"
+    },
+    {
+      "hash": "def456",
+      "path": "docs/advanced-usage.md",
+      "metadata": {
+        "title": "高级用法",
+        "summary": "深入介绍 ZEN 的高级功能和配置选项",
+        "tags": ["advanced", "configuration", "customization"],
+        "inferred_date": "2025-12-15",
+        "inferred_lang": "zh-Hans",
+        "tokens_used": {
+          "prompt": 120,
+          "completion": 60,
+          "total": 180
+        }
+      },
+      "lastUpdated": "2026-01-05T00:00:00.000Z"
+    },
+    {
+      "hash": "ghi789",
+      "path": "docs/deployment.md",
+      "metadata": {
+        "title": "部署指南",
+        "summary": "如何将 ZEN 生成的文档部署到生产环境",
+        "tags": ["deployment", "production", "hosting"],
+        "inferred_date": "2025-12-20",
+        "inferred_lang": "zh-Hans",
+        "tokens_used": {
+          "prompt": 80,
+          "completion": 40,
+          "total": 120
+        }
+      },
+      "lastUpdated": "2026-01-05T00:00:00.000Z"
+    }
+  ]
+}

package/.zen/translations.json

@@ -0,0 +1,51 @@
+[
+  {
+    "sourceHash": "1b798c44a4f353e47296ca83d5905e37e6aba3e90bbd9bc3b3d34fc12059a2ca",
+    "sourceLang": "zh-Hans",
+    "targetLang": "en-US",
+    "translatedContent": "# ZEN - A Minimalist Markdown Documentation Site Builder\n\n> 📖 **Reading Note**: This README is the Chinese version. The English version will be automatically generated by AI translation.\n\n## Project Motivation\n\n### Return to Content\n\nI enjoy contemplation, but I don't want to deal with complex build tools, fiddle with intricate documentation configurations, or navigate complicated structures.\n\n### Return to Native Language\n\nLife is short, I use AI for translation. Stay connected with the world.\n\n## Core Features\n\n1.  **Static Site Generation**\n    *   Builds any folder containing Markdown files into a static HTML site.\n\n2.  **Intelligent Navigation**\n    *   Generates a site map and navigation automatically, without requiring you to maintain the original directory structure of your Markdown source files.\n\n3.  **Incremental i18n Translation**\n    *   Utilizes LLMs for incremental internationalization (i18n) translation. Write your Markdown in your native language, while your audience can be multilingual.\n\n## Design Philosophy\n\n*   **Minimalism**: Minimal configuration, maximum flexibility.\n*   **Content-First**: Focus on writing, not tool configuration.\n*   **AI-Powered**: Leverage AI for translation and content organization.\n*   **Cross-Language**: Supports multilingual content creation and presentation.\n\n## Quick Start\n\n### Recommended Usage\n\n**It is recommended to switch to the directory containing your Markdown files and start building directly with the following command:**\n\n```bash\nnpx zengen build\n```\n\n### Other Usages\n\n1.  **Live Preview (Watch for file changes)**:\n\n```bash\nnpx zengen build --watch\n```\n\n2.  **View more parameters or help**:\n\n```bash\nnpx zengen\n```\n\n**Note**: ZEN enforces using the current directory as the source directory and outputs to the `.zen/dist` directory. Specifying source and output directory parameters is no longer supported.\n\n---\n\n**ZEN** - Return documentation to its essence, return writing to tranquility.",
+    "lastUpdated": "2026-01-05T14:12:28.056Z"
+  },
+  {
+    "sourceHash": "5ec990146b35e00de2630559126ee07f7cdcddeb23b0e8cab3d85b4181353e26",
+    "sourceLang": "zh-Hans",
+    "targetLang": "en-US",
+    "translatedContent": "# Advanced Usage\n\nIn-depth introduction to ZEN's advanced features and configuration options.\n\n## Custom Templates\n\nZEN supports custom HTML templates:\n\n```bash\nzengen build --src ./docs --out ./dist --template ./custom-template.html\n```\n\n## Configuration Options\n\nCan be configured in the `.zenrc` file:\n\n```json\n{\n  \"srcDir\": \"./docs\",\n  \"outDir\": \"./dist\",\n  \"template\": \"./template.html\",\n  \"baseUrl\": \"https://example.com\",\n  \"i18n\": {\n    \"sourceLang\": \"zh-Hans\",\n    \"targetLangs\": [\"en-US\", \"ja-JP\"]\n  }\n}\n```\n\n## Plugin System\n\nZEN supports plugin extensions:\n\n```typescript\ninterface MarkdownProcessor {\n  beforeParse?(content: string, fileInfo: FileInfo): string | Promise<string>;\n  afterParse?(html: string, fileInfo: FileInfo): string | Promise<string>;\n}\n```",
+    "lastUpdated": "2026-01-05T14:12:35.392Z"
+  },
+  {
+    "sourceHash": "d49012f98c4367b34034063400e2f7826bf0615952210c82396920172d468e2c",
+    "sourceLang": "zh-Hans",
+    "targetLang": "en-US",
+    "translatedContent": "# GitHub Pages Deployment Configuration\n\nThis directory contains the GitHub Pages deployment configuration for the ZEN project documentation site.\n\n## Workflow\n\n### `pages.yml`\n\nThis workflow automatically builds the ZEN project documentation site and deploys it to GitHub Pages.\n\n**Triggers:**\n\n- Push to the `main` branch (when changes occur in `demo/src/`, `package.json`, or workflow files)\n- Pull Request targeting the `main` branch\n- Manual trigger\n\n**Workflow Steps:**\n\n1.  **Checkout code**: Check out code from the remote branch to ensure code synchronization.\n2.  **Set up Node.js**: Configure the Node.js 20.x environment.\n3.  **Install dependencies**: Install project dependencies using `npm ci`.\n4.  **Build zengen**: Build the local zengen package.\n5.  **Install zengen**: Install the locally built zengen as a global tool.\n6.  **Test zengen CLI**: Verify the CLI tool functions correctly.\n7.  **Build documentation site**: Build the documentation using `cd demo/src && zengen build`, outputting to the `.zen/dist` directory.\n8.  **Configure Pages**: Set up GitHub Pages.\n9.  **Upload artifact**: Upload the built documentation site as a Pages artifact.\n10. **Deploy to GitHub Pages**: Automatically deploy to GitHub Pages.\n\n## Accessing the Documentation Site\n\nAfter successful deployment, the documentation site will be accessible at the following URL:\n\n```\nhttps://[username].github.io/[repository-name]/\n```\n\n## Custom Configuration\n\n### Custom Domain\n\nIf you need to use a custom domain, you can add a CNAME file after the build step:\n\n```yaml\n# Create CNAME file (if a custom domain is needed)\necho \"docs.example.com\" > docs-dist/CNAME\n```\n\n### Build Options\n\nThe currently used build command:\n\n```bash\ncd demo/src\nzengen build --clean --verbose\n```\n\nAvailable options:\n\n- `--clean`: Clean the output directory before building.\n- `--verbose`: Show verbose output.\n- `--watch`: Watch mode (not suitable for CI/CD).\n- `--template`: Specify a custom template file.\n- `--config`: Specify a configuration file.\n\n### Environment Variables\n\nThe workflow uses the following environment variables:\n\n- `GITHUB_TOKEN`: Automatically provided GitHub token.\n- `NODE_VERSION`: Node.js version (defaults to 20.x).\n\n## Troubleshooting\n\n### Build Failures\n\n1.  **Check Node.js version**: Ensure a supported Node.js version is used.\n2.  **Verify dependency installation**: Ensure `npm ci` executes successfully.\n3.  **Check build output**: Review the verbose output of `zengen build`.\n4.  **CLI output directory issue**: ZEN now enforces output to the `.zen/dist` directory and no longer supports the `--out` parameter.\n\n### Deployment Failures\n\n1.  **Check permissions**: Ensure the workflow has correct write permissions for Pages.\n2.  **Verify artifact**: Ensure the `.zen/dist` directory contains valid HTML files.\n3.  **Review logs**: Check GitHub Actions logs for detailed error messages.\n\n### Documentation Not Updating\n\n1.  **Check triggers**: Ensure files in the `demo/src/` directory were modified.\n2.  **Wait for deployment completion**: GitHub Pages deployment may take a few minutes.\n3.  **Clear browser cache**: The browser might be caching an old version.\n\n## Manual Trigger\n\nDeployment can be manually triggered via the GitHub Actions interface:\n\n1.  Go to the repository's \"Actions\" tab.\n2.  Select the \"Deploy to GitHub Pages\" workflow.\n3.  Click the \"Run workflow\" button.\n4.  Select the branch and run.\n\n## Related Files\n\n- `demo/src/`: Documentation source files (Markdown format).\n- `package.json`: Project configuration and dependencies.\n- `src/cli.ts`: zengen CLI tool implementation.\n- `src/builder.ts`: Documentation builder implementation.",
+    "lastUpdated": "2026-01-05T14:13:01.694Z"
+  },
+  {
+    "sourceHash": "f0c2799126931ccd113a0c45b1e623870b0d4f4f400becf6dd877da8f1011517",
+    "sourceLang": "zh-Hans",
+    "targetLang": "en-US",
+    "translatedContent": "# Quick Start Guide\n\nThis document explains how to quickly get started with the ZEN documentation generator.\n\n## Installation\n\n```bash\nnpm install -g zengen\n```\n\n## Basic Usage\n\n1. Create a documentation directory\n2. Write Markdown files\n3. Run the build command\n\n```bash\nzengen build --src ./docs --out ./dist\n```\n\n## Features\n\n- Minimal configuration\n- Built-in responsive templates\n- AI-assisted metadata extraction\n- Multi-language support",
+    "lastUpdated": "2026-01-05T14:13:05.710Z"
+  },
+  {
+    "sourceHash": "6ad8db715a1b60613fe934fefb29fa981ecad9b63145593accff144d73b44bde",
+    "sourceLang": "zh-Hans",
+    "targetLang": "en-US",
+    "translatedContent": "# Best Practices\n\nThis document introduces best practices for building documentation sites using ZEN.\n\n## Multilingual Management\n\n### Translation Strategy\n\n1. **Primary Language First**: Write the complete documentation in the native language first.\n2. **Incremental Translation**: Only translate modified parts after each update.\n3. **Terminology Consistency**: Create a glossary to maintain translation consistency.\n4. **Manual Review**: It is recommended to manually review AI translations.\n\n## Performance Optimization\n\n### Build Optimization\n\n1. **Incremental Builds**: Use `--watch` mode for development.\n2. **Cache Utilization**: ZEN automatically caches processing results.\n3. **Parallel Processing**: Automatically processes files in parallel on multi-core CPUs.\n\n### Development Workflow\n\n```bash\n# Watch for changes during development\ncd docs\nnpx zengen build --watch\n\n# Start development server\nnpx zengen build --watch --serve\n\n# Production build\nnpx zengen build --clean\n```\n\n## Deployment Strategy\n\n### CI/CD Integration\n\n#### GitHub Actions Example\n\n```yaml\nname: Build and Deploy Documentation\non:\n  push:\n    branches: [main]\n    paths:\n      - 'docs/**'\n      - '.github/workflows/docs.yml'\n\njobs:\n  build:\n    runs-on: ubuntu-latest\n    steps:\n      - name: Checkout repository\n        uses: actions/checkout@v4\n\n      - name: Setup Node.js\n        uses: actions/setup-node@v4\n        with:\n          node-version: '20.x'\n\n      - name: Build documentation\n        run: |\n          cd docs\n          npx zengen build --clean --base-url /my-docs\n\n      - name: Deploy to GitHub Pages\n        uses: peaceiris/actions-gh-pages@v3\n        with:\n          github_token: ${{ secrets.GITHUB_TOKEN }}\n          publish_dir: docs/.zen/dist\n```\n\n#### Custom Deployment Script\n\n```bash\n#!/bin/bash\n# deploy-docs.sh\n\n# Switch to the documentation directory\ncd docs\n\n# Clean and build\nnpx zengen build --clean\n\n# Sync to server\nrsync -avz .zen/dist/ user@server:/var/www/docs/\n\n# Clean cache\nrm -rf .zen/cache\n```\n\n### Cloud Deployment Options\n\n- **GitHub Pages**: Free hosting for documentation.\n- **Vercel**: Automatic deployment of static sites.\n- **Netlify**: Supports form handling and redirects.\n- **AWS S3 + CloudFront**: Enterprise-grade static hosting.\n\n## Maintenance Recommendations\n\n### Regular Updates\n\n1. **Content Review**: Check documentation accuracy monthly.\n2. **Link Checking**: Regularly check for broken links.\n3. **Performance Monitoring**: Monitor page load speed.\n4. **User Feedback**: Collect user feedback to improve documentation.\n\n### Version Control\n\n1. **Document Versioning**: Synchronize with software versions.\n2. **Change Log**: Record documentation update history.\n3. **Rollback Mechanism**: Support quick rollback to previous versions.\n\n## Frequently Asked Questions\n\n### Slow Build Speed\n\n**Solutions:**\n\n- Reduce unnecessary images and resources.\n- Use `--watch` mode for incremental development.\n- Split large documents into multiple smaller files.\n- Disable unnecessary processors.\n\n### Poor Translation Quality\n\n**Solutions:**\n\n- Provide context for AI translation.\n- Create a glossary to improve consistency.\n- Manually review critical content.\n- Adjust translation prompts.\n\n### Complex Navigation Structure\n\n**Solutions:**\n\n- Maintain a flat directory structure.\n- Use clear heading hierarchies.\n- Provide search functionality.\n- Use sidebar navigation appropriately.\n\n### High Memory Usage\n\n**Solutions:**\n\n- Reduce the number of files processed simultaneously.\n- Disable caching (not recommended).\n- Increase system memory.\n- Process large documents in batches.\n\n## Advanced Techniques\n\n### Custom Template Tips\n\n1. **Responsive Design**: Ensure templates display correctly on mobile devices.\n2. **Theme Switching**: Implement dark/light themes.\n3. **Syntax Highlighting**: Integrate highlight.js or other highlighting libraries.\n4. **Search Functionality**: Add client-side search.\n\n### Integrating Other Tools\n\n1. **Image Optimization**: Use sharp or imagemin to optimize images.\n2. **SEO Optimization**: Add meta tags and structured data.\n3. **Analytics Integration**: Integrate Google Analytics or Plausible.\n4. **CDN Acceleration**: Use a CDN to accelerate static resources.\n\n### Monitoring and Logging\n\n1. **Build Logs**: Use `--verbose` to view detailed logs.\n2. **Error Monitoring**: Set up error monitoring and alerts.\n3. **Performance Monitoring**: Monitor build time and resource usage.\n4. **User Analytics**: Analyze documentation usage.",
+    "lastUpdated": "2026-01-05T14:13:35.974Z"
+  },
+  {
+    "sourceHash": "a1580f71c6c6c1ff4a314be72d410a8507af2f087d56360c7f5048d349c21953",
+    "sourceLang": "zh-Hans",
+    "targetLang": "en-US",
+    "translatedContent": "# Configuration Guide\n\nZEN's design philosophy is minimalism, so configuration is very simple.\n\n## Command Line Usage\n\n### Basic Commands\n\n```bash\n# Build documentation (recommended usage)\nnpx zengen build\n\n# Live preview (watch for file changes)\nnpx zengen build --watch\n\n# Start development server (requires --watch)\nnpx zengen build --watch --serve\n\n# Custom port\nnpx zengen build --watch --serve --port 8080\n\n# Clean output directory\nnpx zengen build --clean\n\n# Show verbose logs\nnpx zengen build --verbose\n\n# Set base URL\nnpx zengen build --base-url /my-docs\n\n# View help\nnpx zengen\n```\n\n**Important Notes:**\n\n- ZEN enforces the current directory as the source directory and outputs to the `.zen/dist` directory\n- Specifying source and output directories via command-line arguments is no longer supported\n- When using `--watch` mode, modifying files triggers automatic rebuilds\n\n### Command Line Options\n\n| Option         | Short | Description                             | Default     |\n| -------------- | ----- | --------------------------------------- | ----------- |\n| `--watch`      | `-w`  | Watch for file changes and auto-rebuild | `false`     |\n| `--serve`      | `-s`  | Start dev server (requires `--watch`)   | `false`     |\n| `--port`       | `-p`  | Development server port                 | `3000`      |\n| `--host`       |       | Development server host                 | `localhost` |\n| `--verbose`    | `-v`  | Show verbose logs                       | `false`     |\n| `--clean`      |       | Clean output directory                  | `false`     |\n| `--base-url`   |       | Site base URL                           | None        |\n| `--help`       | `-h`  | Show help information                   | None        |",
+    "lastUpdated": "2026-01-05T14:13:50.036Z"
+  },
+  {
+    "sourceHash": "fdfca9b960d0eaa8b2b96fe988ead7481d2c0b16f66ebc94fb477139b4178cdc",
+    "sourceLang": "zh-Hans",
+    "targetLang": "en-US",
+    "translatedContent": "# ZEN Documentation Site Example\n\nWelcome to the ZEN documentation builder! This is a minimalist Markdown documentation site generator.\n\n## Features\n\n- **Minimal Configuration**: No complex configuration files required\n- **Content-First**: Focus on writing, not tool configuration\n- **Smart Navigation**: Automatically generates site maps and navigation\n- **Multi-Language Support**: Supports incremental i18n translation\n\n## Quick Start\n\n```bash\n# Build documentation using npx (recommended)\nnpx zengen build\n\n# Live preview (watch for file changes)\nnpx zengen build --watch\n\n# View more parameters or help\nnpx zengen\n```\n\n**Note**: ZEN enforces the use of the current directory as the source directory and outputs to the `.zen/dist` directory. Specifying source and output directory parameters is no longer supported.\n\n## Code Examples\n\n```javascript\n// This is a JavaScript example\nconst zen = require('zengen');\n\nasync function buildDocs() {\n  await zen.build({\n    // ZEN now enforces using the current directory as the source\n    // Outputs to the .zen/dist directory\n  });\n}\n```\n\n```python\n# This is a Python example\ndef hello_world():\n    print(\"Hello from ZEN!\")\n```\n\n## Next Steps\n\n1. Read the [API Documentation](./api.md)\n2. Check the [Configuration Guide](./config.md)\n3. Learn about [Best Practices](./best-practices.md)",
+    "lastUpdated": "2026-01-05T14:14:00.234Z"
+  }
+]

package/dist/ai-client.d.ts

@@ -0,0 +1,34 @@
+import { AIMetadata } from './types';
+import { AIService } from './ai-service';
+/**
+ * AI 客户端类 - 使用 fetch 调用 OpenAI 兼容 API
+ */
+export declare class AIClient {
+    private aiService;
+    constructor(aiService: AIService);
+    /**
+     * 调用 AI 模型提取文档 metadata
+     */
+    extractMetadata(content: string, filePath: string): Promise<AIMetadata | null>;
+    /**
+     * 构建提取 metadata 的 prompt
+     */
+    private buildMetadataPrompt;
+    /**
+     * 调用 OpenAI 兼容 API
+     */
+    private callOpenAIAPI;
+    /**
+     * 解析 AI 返回的 metadata
+     */
+    private parseMetadataResponse;
+    /**
+     * 批量处理文件
+     */
+    processFiles(files: Array<{
+        content: string;
+        path: string;
+        hash: string;
+    }>): Promise<Map<string, AIMetadata>>;
+}
+//# sourceMappingURL=ai-client.d.ts.map

package/dist/ai-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-client.d.ts","sourceRoot":"","sources":["../src/ai-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,SAAS,EAAY,MAAM,cAAc,CAAC;AAyBnD;;GAEG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,SAAS,CAAY;gBAEjB,SAAS,EAAE,SAAS;IAIhC;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAsCpF;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAgC3B;;OAEG;YACW,aAAa;IAyC3B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA2B7B;;OAEG;IACG,YAAY,CAChB,KAAK,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,GAC5D,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CAmCpC"}

package/dist/ai-client.js

@@ -0,0 +1,180 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AIClient = void 0;
+/**
+ * AI 客户端类 - 使用 fetch 调用 OpenAI 兼容 API
+ */
+class AIClient {
+    constructor(aiService) {
+        this.aiService = aiService;
+    }
+    /**
+     * 调用 AI 模型提取文档 metadata
+     */
+    async extractMetadata(content, filePath) {
+        const config = this.aiService.getConfig();
+        if (!config.enabled || !config.apiKey) {
+            console.log(`⚠️ AI feature is disabled or API key not configured for: ${filePath}`);
+            return null;
+        }
+        try {
+            console.log(`🤖 Extracting AI metadata for: ${filePath}`);
+            const prompt = this.buildMetadataPrompt(content);
+            const response = await this.callOpenAIAPI(prompt, config);
+            if (!response) {
+                console.warn(`⚠️ Failed to extract metadata for: ${filePath}`);
+                return null;
+            }
+            const metadata = this.parseMetadataResponse(response.choices[0].message.content);
+            // 添加 tokens 使用情况
+            metadata.tokens_used = {
+                prompt: response.usage.prompt_tokens,
+                completion: response.usage.completion_tokens,
+                total: response.usage.total_tokens,
+            };
+            // 打印 tokens 使用情况
+            this.aiService.logTokenUsage(filePath, metadata.tokens_used);
+            return metadata;
+        }
+        catch (error) {
+            console.error(`❌ Failed to extract AI metadata for ${filePath}:`, error);
+            return null;
+        }
+    }
+    /**
+     * 构建提取 metadata 的 prompt
+     */
+    buildMetadataPrompt(content) {
+        // 限制内容长度以避免 token 超限
+        const maxContentLength = 8000;
+        const truncatedContent = content.length > maxContentLength
+            ? content.substring(0, maxContentLength) + '... [内容已截断]'
+            : content;
+        return `请分析以下文档内容，提取以下信息并返回 JSON 格式：
+
+文档内容：
+"""
+${truncatedContent}
+"""
+
+请提取：
+1. title: 文档的标题（简洁明了，不超过 20 个字）
+2. summary: 文档摘要（控制在 100 字以内，概括主要内容）
+3. tags: 关键词列表（3-8 个关键词，使用中文或英文）
+4. inferred_date: 文档中隐含的创建日期（如果有的话，格式：YYYY-MM-DD，没有就留空字符串）
+5. inferred_lang: 文档使用的语言代码（例如：zh-Hans 表示简体中文，en-US 表示美式英语）
+
+请严格按照以下 JSON 格式返回，不要包含任何其他文本：
+{
+  "title": "文档标题",
+  "summary": "文档摘要...",
+  "tags": ["关键词1", "关键词2", "关键词3"],
+  "inferred_date": "2023-01-01",
+  "inferred_lang": "zh-Hans"
+}`;
+    }
+    /**
+     * 调用 OpenAI 兼容 API
+     */
+    async callOpenAIAPI(prompt, config) {
+        try {
+            const response = await fetch(`${config.baseUrl}/chat/completions`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${config.apiKey}`,
+                },
+                body: JSON.stringify({
+                    model: config.model,
+                    messages: [
+                        {
+                            role: 'system',
+                            content: '你是一个专业的文档分析助手，擅长从文档中提取结构化信息。请严格按照要求的 JSON 格式返回结果。',
+                        },
+                        {
+                            role: 'user',
+                            content: prompt,
+                        },
+                    ],
+                    temperature: config.temperature,
+                    max_tokens: config.maxTokens,
+                    response_format: { type: 'json_object' },
+                }),
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                console.error(`❌ OpenAI API error (${response.status}):`, errorText);
+                return null;
+            }
+            const data = await response.json();
+            return data;
+        }
+        catch (error) {
+            console.error('❌ Failed to call OpenAI API:', error);
+            return null;
+        }
+    }
+    /**
+     * 解析 AI 返回的 metadata
+     */
+    parseMetadataResponse(responseContent) {
+        try {
+            const metadata = JSON.parse(responseContent);
+            // 验证和清理数据
+            return {
+                title: metadata.title?.trim() || '未命名文档',
+                summary: metadata.summary?.trim() || '',
+                tags: Array.isArray(metadata.tags)
+                    ? metadata.tags.map((tag) => tag.trim()).filter(Boolean)
+                    : [],
+                inferred_date: metadata.inferred_date?.trim() || undefined,
+                inferred_lang: metadata.inferred_lang?.trim() || 'zh-Hans',
+            };
+        }
+        catch (error) {
+            console.error('❌ Failed to parse AI response:', error, 'Response:', responseContent);
+            // 返回默认值
+            return {
+                title: '解析失败',
+                summary: 'AI 响应解析失败',
+                tags: ['error'],
+                inferred_lang: 'zh-Hans',
+            };
+        }
+    }
+    /**
+     * 批量处理文件
+     */
+    async processFiles(files) {
+        const results = new Map();
+        const config = this.aiService.getConfig();
+        if (!config.enabled || !config.apiKey) {
+            console.log('⚠️ AI feature is disabled or API key not configured');
+            return results;
+        }
+        console.log(`🤖 Processing ${files.length} files with AI...`);
+        for (const file of files) {
+            try {
+                // 检查缓存
+                const cachedMetadata = await this.aiService.getCachedMetadata(file.hash, file.path);
+                if (cachedMetadata) {
+                    results.set(file.path, cachedMetadata);
+                    continue;
+                }
+                // 调用 AI 提取 metadata
+                const metadata = await this.extractMetadata(file.content, file.path);
+                if (metadata) {
+                    results.set(file.path, metadata);
+                    // 缓存结果
+                    await this.aiService.cacheMetadata(file.hash, file.path, metadata);
+                }
+            }
+            catch (error) {
+                console.error(`❌ Failed to process file ${file.path}:`, error);
+            }
+        }
+        return results;
+    }
+}
+exports.AIClient = AIClient;
+//# sourceMappingURL=ai-client.js.map

package/dist/ai-client.js.map

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

package/dist/ai-processor.d.ts

@@ -0,0 +1,51 @@
+import { MarkdownProcessor, FileInfo, ZenConfig } from './types';
+/**
+ * AI 处理器 - 集成到 Markdown 处理流程中
+ */
+export declare class AIProcessor implements MarkdownProcessor {
+    private aiService;
+    private aiClient;
+    private enabled;
+    constructor(config?: ZenConfig);
+    /**
+     * 在解析前处理 - 这里我们提取 AI metadata
+     */
+    beforeParse(content: string, fileInfo: FileInfo): Promise<string>;
+    /**
+     * 在解析后处理 - 这里可以添加 AI 增强的 HTML 内容
+     */
+    afterParse(html: string, fileInfo: FileInfo): Promise<string>;
+    /**
+     * 将 AI metadata 添加到 HTML 中
+     */
+    private enhanceHtmlWithMetadata;
+    /**
+     * 转义 HTML 特殊字符
+     */
+    private escapeHtml;
+    /**
+     * 转义 JSON 字符串
+     */
+    private escapeJson;
+    /**
+     * 记录 metadata 信息
+     */
+    private logMetadata;
+    /**
+     * 批量处理文件
+     */
+    processBatch(files: FileInfo[]): Promise<void>;
+    /**
+     * 清理缓存
+     */
+    cleanupCache(maxAgeDays?: number): Promise<void>;
+    /**
+     * 检查是否启用
+     */
+    isEnabled(): boolean;
+    /**
+     * 获取配置信息
+     */
+    getConfigInfo(): string;
+}
+//# sourceMappingURL=ai-processor.d.ts.map

package/dist/ai-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-processor.d.ts","sourceRoot":"","sources":["../src/ai-processor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAIjE;;GAEG;AACH,qBAAa,WAAY,YAAW,iBAAiB;IACnD,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,OAAO,CAAU;gBAEb,MAAM,GAAE,SAAc;IAsBlC;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;IAoCvE;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;IAenE;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA+C/B;;OAEG;IACH,OAAO,CAAC,UAAU;IASlB;;OAEG;IACH,OAAO,CAAC,UAAU;IASlB;;OAEG;IACH,OAAO,CAAC,WAAW;IAWnB;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAkCpD;;OAEG;IACG,YAAY,CAAC,UAAU,GAAE,MAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1D;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,aAAa,IAAI,MAAM;CASxB"}