aico-cli 2.0.37 → 2.0.40

package/dist/chunks/simple-config.mjs

@@ -14,7 +14,7 @@ import { join, dirname, basename } from 'pathe';
 import { fileURLToPath } from 'node:url';
 import { EventEmitter } from 'node:events';
 
-const version = "2.0.37";
+const version = "2.0.40";
 
 function displayBanner(subtitle) {
   const defaultSubtitle = "\u4E00\u952E\u914D\u7F6E\u4F60\u7684\u5F00\u53D1\u73AF\u5883";
@@ -4703,7 +4703,7 @@ const DEFAULT_FILE_COPY_CONFIGS = [
     destination: join(CLAUDE_DIR, "personality.md"),
     type: "file",
     options: {
-      mergeStrategy: "merge",
+      mergeStrategy: "copy",
       backupBeforeCopy: true,
       deleteBeforeCopy: true
     }
@@ -4713,7 +4713,7 @@ const DEFAULT_FILE_COPY_CONFIGS = [
     destination: join(CLAUDE_DIR, "language.md"),
     type: "file",
     options: {
-      mergeStrategy: "merge",
+      mergeStrategy: "copy",
       backupBeforeCopy: true,
       deleteBeforeCopy: true
     }
@@ -4723,7 +4723,7 @@ const DEFAULT_FILE_COPY_CONFIGS = [
     destination: join(CLAUDE_DIR, "CLAUDE.md"),
     type: "file",
     options: {
-      mergeStrategy: "merge",
+      mergeStrategy: "copy",
       backupBeforeCopy: true,
       deleteBeforeCopy: true
     }
@@ -4733,7 +4733,7 @@ const DEFAULT_FILE_COPY_CONFIGS = [
     destination: join(CLAUDE_DIR, "settings.json"),
     type: "file",
     options: {
-      mergeStrategy: "merge",
+      mergeStrategy: "copy",
       backupBeforeCopy: true,
       deleteBeforeCopy: true
     }
@@ -4742,10 +4742,7 @@ const DEFAULT_FILE_COPY_CONFIGS = [
 function getFileCopyConfigsForTarget(target = "claude") {
   const targetDir = getTargetDir(target);
   const targetConfig = TARGET_CONFIGS[target];
-  const fileRenames = targetConfig.fileRenames || {};
-  const getDestFileName = (sourceFileName) => {
-    return fileRenames[sourceFileName] || sourceFileName;
-  };
+  const templateSubDir = target;
   return [
     {
       source: "templates/agents",
@@ -4792,7 +4789,7 @@ function getFileCopyConfigsForTarget(target = "claude") {
       destination: join(targetDir, "personality.md"),
       type: "file",
       options: {
-        mergeStrategy: "merge",
+        mergeStrategy: "copy",
         backupBeforeCopy: true,
         deleteBeforeCopy: true
       }
@@ -4802,27 +4799,29 @@ function getFileCopyConfigsForTarget(target = "claude") {
       destination: join(targetDir, "language.md"),
       type: "file",
       options: {
-        mergeStrategy: "merge",
+        mergeStrategy: "copy",
         backupBeforeCopy: true,
         deleteBeforeCopy: true
       }
     },
+    // 使用目标特定的主配置文件 (CLAUDE.md 或 CODEBUDDY.md)
     {
-      source: "templates/CLAUDE.md",
-      destination: join(targetDir, getDestFileName("CLAUDE.md")),
+      source: `templates/${templateSubDir}/${targetConfig.mainConfigFile}`,
+      destination: join(targetDir, targetConfig.mainConfigFile),
       type: "file",
       options: {
-        mergeStrategy: "merge",
+        mergeStrategy: "copy",
         backupBeforeCopy: true,
         deleteBeforeCopy: true
       }
     },
+    // 使用目标特定的 settings.json，直接替换而不是合并
     {
-      source: "templates/settings.json",
+      source: `templates/${templateSubDir}/settings.json`,
       destination: join(targetDir, "settings.json"),
       type: "file",
       options: {
-        mergeStrategy: "merge",
+        mergeStrategy: "copy",
         backupBeforeCopy: true,
         deleteBeforeCopy: true
       }
@@ -5004,6 +5003,12 @@ function mergeSettingsFile(templatePath, targetPath) {
         existingSettings.permissions?.allow
       );
     }
+    if (templateSettings.hooks) {
+      mergedSettings.hooks = templateSettings.hooks;
+    }
+    if (templateSettings.statusLine) {
+      mergedSettings.statusLine = templateSettings.statusLine;
+    }
     writeJsonConfig(targetPath, mergedSettings);
   } catch (error) {
     console.error("\u5408\u5E76\u8BBE\u7F6E\u5931\u8D25", error);
@@ -5099,7 +5104,7 @@ class ConfigInstaller extends AbstractInstaller {
       }
       this.copyConfigFilesWithOptions(options);
       const apiConfig = options.configData?.apiConfig;
-      if (apiConfig) {
+      if (apiConfig && target !== "codebuddy") {
         configureApi(apiConfig, target);
       }
       const targetName = TARGET_CONFIGS[target].dirName;
@@ -5113,29 +5118,19 @@ class ConfigInstaller extends AbstractInstaller {
   }
   /**
    * 使用可配置的文件复制机制
+   * 注意：目标特定的文件（如 settings.json, CODEBUDDY.md）已经在 getFileCopyConfigs 中配置
+   * 不再复制整个 templates 目录，避免覆盖目标特定文件
    */
   copyConfigFilesWithOptions(options) {
     const target = this.getTarget();
-    const targetDir = this.getTargetDirectory();
-    const customConfigs = [
-      ...this.getFileCopyConfigs(),
-      {
-        source: "templates",
-        destination: targetDir,
-        type: "directory",
-        options: {
-          filter: (path) => !path.includes("/backup"),
-          mergeStrategy: "copy"
-        }
-      }
-    ];
+    const configs = this.getFileCopyConfigs();
     if (options.onlyMdFiles) {
-      const filteredConfigs = customConfigs.filter(
+      const filteredConfigs = configs.filter(
         (config) => config.source.endsWith(".md") || config.type === "directory"
       );
       copyConfigFilesWithConfig(filteredConfigs, target);
     } else {
-      copyConfigFilesWithConfig(customConfigs, target);
+      copyConfigFilesWithConfig(configs, target);
     }
   }
   /**
@@ -5144,7 +5139,7 @@ class ConfigInstaller extends AbstractInstaller {
   async applyCompanyConfig(silent = false) {
     try {
       const apiConfig = {
-        url: "http://11.0.166.20:13456",
+        url: "http://11.0.166.23:13456",
         key: "sk-4730d06849b5fea00f551bd60a0902e1"
       };
       const configuredApi = configureApi(apiConfig, this.getTarget());
@@ -5361,7 +5356,7 @@ class ConfigCheckerInstaller extends AbstractInstaller {
       if (!baseUrl) {
         return "none";
       }
-      if (baseUrl.includes("11.0.166.20")) {
+      if (baseUrl.includes("11.0.166.23")) {
         return "company";
       }
       return "personal";
@@ -6017,7 +6012,7 @@ class InstallationComposer {
         configData: {
           ...options.configData,
           apiConfig: {
-            url: "http://11.0.166.20:13456",
+            url: "http://11.0.166.23:13456",
             key: "sk-4730d06849b5fea00f551bd60a0902e1"
           }
         }
@@ -6031,16 +6026,16 @@ class InstallationComposer {
       const configInstaller = new ConfigInstaller(this.context);
       await configInstaller.applyCompanyConfig();
       updateClaudeConfigEnv({
-        ANTHROPIC_BASE_URL: "http://11.0.166.20:13456",
+        ANTHROPIC_BASE_URL: "http://11.0.166.23:13456",
         ANTHROPIC_AUTH_TOKEN: "sk-4730d06849b5fea00f551bd60a0902e1"
       }, "claude");
       await this.installToTarget("codebuddy", companySteps, configOptions, {
-        ANTHROPIC_BASE_URL: "http://11.0.166.20:13456",
+        ANTHROPIC_BASE_URL: "http://11.0.166.23:13456",
         ANTHROPIC_AUTH_TOKEN: "sk-4730d06849b5fea00f551bd60a0902e1"
       });
       this.installCodebuddyCodeSilently();
       this.updateGlobalConfig(true);
-      spinner.succeed("\u516C\u53F8\u914D\u7F6E\u5B89\u88C5\u5B8C\u6210 (claude + codebuddy)");
+      spinner.succeed("\u516C\u53F8\u914D\u7F6E\u5B89\u88C5\u5B8C\u6210");
     } catch (error) {
       spinner.fail("\u516C\u53F8\u914D\u7F6E\u5B89\u88C5\u5931\u8D25");
       throw error;
@@ -6088,7 +6083,7 @@ class InstallationComposer {
       });
       this.installCodebuddyCodeSilently();
       this.updateGlobalConfig(true);
-      spinner.succeed("\u4E2A\u4EBA\u914D\u7F6E\u5B89\u88C5\u5B8C\u6210 (claude + codebuddy)");
+      spinner.succeed("\u4E2A\u4EBA\u914D\u7F6E\u5B89\u88C5\u5B8C\u6210");
     } catch (error) {
       spinner.fail("\u4E2A\u4EBA\u914D\u7F6E\u5B89\u88C5\u5931\u8D25");
       throw error;
@@ -6136,7 +6131,9 @@ class InstallationComposer {
       () => new MCPInstaller(targetContext)
     );
     await targetExecutor.executeBatch(steps, options);
-    updateClaudeConfigEnv(envVars, target);
+    if (target !== "codebuddy") {
+      updateClaudeConfigEnv(envVars, target);
+    }
   }
   /**
    * 配置 CCR 用于个人设置

package/dist/index.d.mts

@@ -113,7 +113,7 @@ interface FileCopyConfig {
 declare const DEFAULT_FILE_COPY_CONFIGS: FileCopyConfig[];
 /**
  * 根据目标生成文件复制配置
- * 支持文件重命名（如 CLAUDE.md -> CODEBUDDY.md）
+ * 使用目标特定的模板目录 (templates/claude 或 templates/codebuddy)
  */
 declare function getFileCopyConfigsForTarget(target?: InstallationTarget): FileCopyConfig[];
 declare function copyConfigFilesWithConfig(configs?: FileCopyConfig[], target?: InstallationTarget): void;
@@ -123,6 +123,7 @@ declare function updateDefaultModel(model: 'opus' | 'sonnet'): void;
 /**
  * Merge settings.json intelligently
  * Preserves user's environment variables and custom configurations
+ * Always uses template's hooks and statusLine to ensure correct paths
  */
 declare function mergeSettingsFile(templatePath: string, targetPath: string): void;
 /**

package/dist/index.d.ts

@@ -113,7 +113,7 @@ interface FileCopyConfig {
 declare const DEFAULT_FILE_COPY_CONFIGS: FileCopyConfig[];
 /**
  * 根据目标生成文件复制配置
- * 支持文件重命名（如 CLAUDE.md -> CODEBUDDY.md）
+ * 使用目标特定的模板目录 (templates/claude 或 templates/codebuddy)
  */
 declare function getFileCopyConfigsForTarget(target?: InstallationTarget): FileCopyConfig[];
 declare function copyConfigFilesWithConfig(configs?: FileCopyConfig[], target?: InstallationTarget): void;
@@ -123,6 +123,7 @@ declare function updateDefaultModel(model: 'opus' | 'sonnet'): void;
 /**
  * Merge settings.json intelligently
  * Preserves user's environment variables and custom configurations
+ * Always uses template's hooks and statusLine to ensure correct paths
  */
 declare function mergeSettingsFile(templatePath: string, targetPath: string): void;
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aico-cli",
-  "version": "2.0.37",
+  "version": "2.0.40",
   "packageManager": "pnpm@9.15.9",
   "description": "AI CLI",
   "repository": {

package/templates/claude/CLAUDE.md

@@ -0,0 +1,2 @@
+@language.md
+@personality.md

package/templates/claude/settings.json

@@ -0,0 +1,98 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-settings.json",
+  "env": {
+    "DISABLE_TELEMETRY": "1",
+    "DISABLE_ERROR_REPORTING": "1",
+    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
+    "ANTHROPIC_BASE_URL": "http://127.0.0.1:3456",
+    "ANTHROPIC_AUTH_TOKEN": "sk-aico-x-ccr"
+  },
+  "includeCoAuthoredBy": false,
+  "permissions": {
+    "allow": [
+      "Bash",
+      "LS",
+      "Read",
+      "Agent",
+      "Write",
+      "Edit",
+      "MultiEdit",
+      "Glob",
+      "Grep",
+      "WebFetch",
+      "WebSearch",
+      "TodoWrite",
+      "NotebookRead",
+      "NotebookEdit",
+      "mcp__intention-coding",
+      "mcp__context7",
+      "mcp__open-websearch",
+      "mcp__chrome-devtools"
+    ],
+    "deny": []
+  },
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx tsx ~/.claude/hooks/scripts/PreToolUse/pre-tool-use.ts",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx tsx ~/.claude/hooks/scripts/PostToolUse/post-tool-use.ts",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx tsx ~/.claude/hooks/scripts/UserPromptSubmit/user-prompt-submit.ts",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "Notification": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx tsx ~/.claude/hooks/scripts/Notification/notification.ts",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx tsx ~/.claude/hooks/scripts/Stop/stop.ts",
+            "timeout": 10
+          }
+        ]
+      }
+    ]
+  },
+  "statusLine": {
+    "type": "command",
+    "command": "~/.claude/ccline/ccline",
+    "padding": 0
+  }
+}

package/templates/codebuddy/CODEBUDDY.md

@@ -0,0 +1,2 @@
+@language.md
+@personality.md

package/templates/codebuddy/settings.json

@@ -0,0 +1,128 @@
+{
+  "sandbox": {
+    "enabled": true,
+    "autoAllowBashIfSandboxed": true,
+    "network": {
+      "allowedDomains": [],
+      "deniedDomains": [],
+      "allowLocalBinding": false,
+      "allowUnixSockets": [],
+      "allowAllUnixSockets": false
+    },
+    "filesystem": {
+      "denyRead": [
+        "~/.ssh",
+        "~/.aws",
+        "~/.gcp"
+      ],
+      "allowWrite": [
+        ".",
+        "/dev/stdout",
+        "/dev/stderr",
+        "/dev/null",
+        "/dev/tty",
+        "/dev/dtracehelper",
+        "/dev/autofs_nowait",
+        "/tmp/codebuddy",
+        "/private/tmp/codebuddy",
+        "~/.npm/_logs",
+        "~/.codebuddy/debug",
+        "~/.codebuddy/statsig"
+      ],
+      "denyWrite": []
+    },
+    "excludedCommands": [],
+    "allowUnsandboxedCommands": true,
+    "enableWeakerNestedSandbox": false
+  },
+  "$schema": "https://json.schemastore.org/claude-code-settings.json",
+  "includeCoAuthoredBy": false,
+  "permissions": {
+    "allow": [
+      "Bash",
+      "LS",
+      "Read",
+      "Agent",
+      "Write",
+      "Edit",
+      "MultiEdit",
+      "Glob",
+      "Grep",
+      "WebFetch",
+      "WebSearch",
+      "TodoWrite",
+      "NotebookRead",
+      "NotebookEdit",
+      "mcp__intention-coding",
+      "mcp__context7",
+      "mcp__open-websearch",
+      "mcp__chrome-devtools"
+    ],
+    "deny": []
+  },
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx tsx ~/.codebuddy/hooks/scripts/PreToolUse/pre-tool-use.ts",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx tsx ~/.codebuddy/hooks/scripts/PostToolUse/post-tool-use.ts",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx tsx ~/.codebuddy/hooks/scripts/UserPromptSubmit/user-prompt-submit.ts",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "Notification": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx tsx ~/.codebuddy/hooks/scripts/Notification/notification.ts",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx tsx ~/.codebuddy/hooks/scripts/Stop/stop.ts",
+            "timeout": 10
+          }
+        ]
+      }
+    ]
+  },
+  "statusLine": {
+    "type": "command",
+    "command": "~/.codebuddy/ccline/ccline",
+    "padding": 0
+  },
+  "enterpriseEndpoint": "https://e.cnpc.com.cn/"
+}

package/templates/settings.json

@@ -38,19 +38,19 @@
         "hooks": [
           {
             "type": "command",
-            "command":  "node -e \"require('child_process').execSync('npx tsx ' + require('path').join(require('os').homedir(), '.claude/hooks/scripts/PreToolUse/pre-tool-use.ts'), {stdio: 'inherit'})\"",
+            "command": "npx tsx ~/.claude/hooks/scripts/PreToolUse/pre-tool-use.ts",
             "timeout": 10
           }
         ]
       }
     ],
-    "PostToolUse":[
+    "PostToolUse": [
       {
         "matcher": "Edit|Write",
         "hooks": [
           {
             "type": "command",
-            "command":  "node -e \"require('child_process').execSync('npx tsx ' + require('path').join(require('os').homedir(), '.claude/hooks/scripts/PostToolUse/post-tool-use.ts'), {stdio: 'inherit'})\"",
+            "command": "npx tsx ~/.claude/hooks/scripts/PostToolUse/post-tool-use.ts",
             "timeout": 10
           }
         ]
@@ -61,7 +61,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node -e \"require('child_process').execSync('npx tsx ' + require('path').join(require('os').homedir(), '.claude/hooks/scripts/UserPromptSubmit/user-prompt-submit.ts'), {stdio: 'inherit'})\"",
+            "command": "npx tsx ~/.claude/hooks/scripts/UserPromptSubmit/user-prompt-submit.ts",
             "timeout": 10
           }
         ]
@@ -72,7 +72,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node -e \"require('child_process').execSync('npx tsx ' + require('path').join(require('os').homedir(), '.claude/hooks/scripts/Notification/notification.ts'), {stdio: 'inherit'})\"",
+            "command": "npx tsx ~/.claude/hooks/scripts/Notification/notification.ts",
             "timeout": 10
           }
         ]
@@ -83,7 +83,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node -e \"require('child_process').execSync('npx tsx ' + require('path').join(require('os').homedir(), '.claude/hooks/scripts/Stop/stop.ts'), {stdio: 'inherit'})\"",
+            "command": "npx tsx ~/.claude/hooks/scripts/Stop/stop.ts",
             "timeout": 10
           }
         ]
@@ -95,4 +95,4 @@
     "command": "~/.claude/ccline/ccline",
     "padding": 0
   }
-}
+}

package/templates/skills/tech-whitepaper/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 五域科技
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/templates/skills/tech-whitepaper/SKILL.md

@@ -0,0 +1,86 @@
+---
+name: tech-whitepaper
+description: 生成专业级技术白皮书的能力技能。适用于需要为软件产品、AI平台、技术解决方案创建高质量技术白皮书的场景。输出纯HTML格式，包含：现代简约设计系统、Mermaid架构图、图片灯箱交互、响应式布局。当用户需要生成技术白皮书、产品文档、技术方案说明书时使用此技能。
+license: Complete terms in LICENSE.txt
+---
+
+# 技术白皮书生成技能
+
+为软件产品生成专业级纯HTML技术白皮书，具备现代简约设计风格、可视化架构图和交互式图片查看功能。
+
+## 核心能力
+
+1. **设计系统**：统一视觉语言，CSS变量驱动，单栏大留白布局
+2. **架构图**：集成Mermaid流程图，自动渲染技术架构
+3. **图片交互**：悬停放大、点击灯箱查看大图
+4. **响应式**：适配桌面和移动端阅读
+
+## 使用流程
+
+### Step 1: 项目分析
+
+在生成白皮书前，必须深入分析项目：
+
+```
+1. 读取项目根目录的 README.md、package.json 等元信息
+2. 扫描源代码结构，识别核心模块和架构模式
+3. 查找已有的图片资源（如 docs/image/、assets/）
+4. 理解技术栈：前端框架、后端服务、数据库、AI能力等
+```
+
+### Step 2: 内容规划
+
+技术白皮书标准章节结构：
+
+1. **产品概述** - 产品定位、核心价值主张
+2. **核心价值/亮点** - 差异化竞争优势（3-6个要点）
+3. **产品组成** - 模块架构、组件说明
+4. **产品生态展望** - 未来规划、扩展能力
+5. **技术架构** - 系统架构图、技术栈详解
+6. **智能体架构**（AI产品）- Agent系统设计
+7. **智能体编排架构**（AI产品）- 工作流引擎
+8. **知识库架构**（AI产品）- RAG/向量/图谱
+9. **智能路由架构**（AI产品）- 模型路由策略
+10. **主要功能** - 功能特性矩阵
+11. **部署场景** - 部署架构、环境要求
+12. **技术支持** - 服务体系、联系方式
+
+### Step 3: 生成白皮书
+
+使用 [HTML模板](assets/whitepaper-template.html) 作为基础，按以下原则定制：
+
+**设计原则**：
+- 以读者为中心，每个元素服务于信息传达
+- 单栏布局 + 大留白 + 无衬线字体
+- 鲜明品牌色 + 简约扁平化图表
+- 杜绝无意义装饰，全文统一视觉语言
+
+**Mermaid图表**：
+- 使用 `<pre class="mermaid">` 标签（非div）
+- 代码从第一列开始，无缩进
+- 简化节点标签，避免特殊字符
+
+**图片处理**：
+- 嵌入项目中所有相关截图
+- 使用 `<figure>` + `<figcaption>` 结构
+- 图片网格用 `.image-grid` 类
+
+**品牌定制**：
+- 替换公司名称、产品名称
+- 更新品牌色（修改CSS变量 `--brand-primary` 等）
+- 添加演示地址、联系方式
+
+### Step 4: 输出验证
+
+生成后检查：
+- [ ] Mermaid图表正确渲染（非代码文本）
+- [ ] 图片悬停有放大效果
+- [ ] 图片点击打开灯箱
+- [ ] 响应式布局在移动端正常
+- [ ] 所有链接可点击
+
+## 资源文件
+
+- **assets/whitepaper-template.html** - 完整HTML模板，包含设计系统和交互脚本
+- **references/design-system.md** - 设计系统详解与定制指南
+- **references/mermaid-patterns.md** - 常用Mermaid架构图模式