@optima-chat/optima-agent 0.4.28 → 0.4.29

package/.claude/settings.local.json

@@ -70,7 +70,8 @@
       "Bash(commerce homepage create-featured:*)",
       "Bash(commerce homepage create-collection-products:*)",
       "Bash(commerce homepage create-banner:*)",
-      "Bash(xargs -I {} sh -c 'echo \"\"\"\"=== {} ===\"\"\"\"; head -3 /Users/verypro/optima-agent/.claude/skills/{}/SKILL.md | grep \"\"\"\"name:\"\"\"\"')"
+      "Bash(xargs -I {} sh -c 'echo \"\"\"\"=== {} ===\"\"\"\"; head -3 /Users/verypro/optima-agent/.claude/skills/{}/SKILL.md | grep \"\"\"\"name:\"\"\"\"')",
+      "Bash(ls:*)"
     ],
     "deny": [],
     "ask": []

package/.claude/skills/product/SKILL.md

@@ -58,9 +58,9 @@ done
 # 1. 查找目标商品
 commerce product list --query "T恤" --limit 50
 
-# 2. 批量更新价格和促销标签
-commerce product update --id prod_123 --price 79 --tags "featured,sale"
-commerce product update --id prod_456 --price 79 --tags "featured,sale"
+# 2. 批量更新价格和促销标签（设置原价显示折扣）
+commerce product update --id prod_123 --price 79 --original-price 99 --tags "featured,sale"
+commerce product update --id prod_456 --price 79 --original-price 99 --tags "featured,sale"
 ```
 
 ### 场景5：商品图片更新
@@ -73,6 +73,18 @@ commerce upload image --path ./new-photo.jpg  # 获得 media_new
 commerce product add-images --id prod_123 --media-id media_new
 ```
 
+### 场景6：创建促销商品
+**任务**: 创建带折扣显示的商品（显示划线价）
+```bash
+# 创建促销商品：售价79，原价99（显示划线价）
+commerce product create \
+  --title "夏日特惠T恤" \
+  --price 79 \
+  --original-price 99 \
+  --stock 100 \
+  --tags "sale"
+```
+
 ### 场景决策表
 
 | 用户需求 | 推荐命令 | 关键注意点 |
@@ -81,6 +93,7 @@ commerce product add-images --id prod_123 --media-id media_new
 | 多规格商品 | `product create` + `variant create` | 主商品设置基础价格，变体设置差异价 |
 | 批量上架 | 脚本循环 `product create` | 复用共享图片的media_id，避免重复上传 |
 | 更新价格 | `product update --price` | 如有变体，需逐个更新变体价格 |
+| 促销商品 | `product create --original-price` | `--original-price` 必须大于 `--price` |
 | 促销标签 | `product update --tags` | 用逗号分隔，保留原有标签 |
 | 图片更新 | `upload` + `add-images` | 先上传再关联，不要直接删除旧图 |
 
@@ -184,9 +197,12 @@ commerce product create --title "T恤" --price 99 --stock 50  # 确保真实有5
 
 当用户说：
 - "创建XX商品，价格YY" → `commerce product create --title XX --price YY`
+- "创建XX商品，售价YY，原价ZZ" → `commerce product create --title XX --price YY --original-price ZZ`
+- "创建促销商品，价格79，划线价99" → `commerce product create --title XX --price 79 --original-price 99`
 - "上传商品图片" → `commerce upload image --path ./photo.jpg`
 - "添加商品变体" → `commerce variant create --product-id XX --sku YY`
 - "更新商品价格" → `commerce product update --id XX --price YY`
+- "设置商品原价/划线价" → `commerce product update --id XX --original-price YY`
 - "给商品打标签" → `commerce product update --id XX --tags "featured,new"`
 - "设置商品重量和尺寸" → `commerce product update --id XX --weight 0.5 --length 10 --width 8 --height 5`
 - "查看所有商品" → `commerce product list`

package/dist/src/hooks-loader.d.ts

@@ -2,5 +2,5 @@ import type { HooksConfig } from "./types.js";
 /**
  * 从 skills 目录加载所有 skill 的 hooks
  */
-export declare function loadSkillHooks(skillsDir: string, cwd: string): HooksConfig;
+export declare function loadSkillHooks(skillsDir: string, cwd: string, getSessionId: () => string | undefined): HooksConfig;
 //# sourceMappingURL=hooks-loader.d.ts.map

package/dist/src/hooks-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks-loader.d.ts","sourceRoot":"","sources":["../../src/hooks-loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,YAAY,CAAC;AAuF5D;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,CA+D1E"}
+{"version":3,"file":"hooks-loader.d.ts","sourceRoot":"","sources":["../../src/hooks-loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,YAAY,CAAC;AAwL5D;;GAEG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,MAAM,GAAG,SAAS,GACrC,WAAW,CAiFb"}

package/dist/src/hooks-loader.js

@@ -1,7 +1,8 @@
-import { readFileSync, readdirSync, existsSync } from "fs";
-import { join } from "path";
+import { readFileSync, readdirSync, existsSync, writeFileSync, mkdirSync } from "fs";
+import { join, dirname } from "path";
 import yaml from "js-yaml";
 import { execSync } from "child_process";
+import { YamlValidator, formatValidationErrors, formatValidationWarning } from "./validation/index.js";
 /**
  * 从 SKILL.md 提取 YAML frontmatter
  */
@@ -20,10 +21,12 @@ function extractYamlFrontmatter(content) {
 /**
  * 执行 shell 命令并返回结果
  */
-function executeCommand(command, cwd, skillDir) {
+function executeCommand(command, cwd, skillDir, sessionId) {
     try {
-        // 替换 ${CLAUDE_PLUGIN_ROOT} 为实际的 skill 目录
-        const expandedCommand = command.replace(/\$\{CLAUDE_PLUGIN_ROOT\}/g, skillDir);
+        // 替换环境变量
+        const expandedCommand = command
+            .replace(/\$\{CLAUDE_PLUGIN_ROOT\}/g, skillDir)
+            .replace(/\$\{SESSION_ID\}/g, sessionId || 'default');
         const result = execSync(expandedCommand, {
             cwd,
             encoding: "utf-8",
@@ -39,14 +42,101 @@ function executeCommand(command, cwd, skillDir) {
 /**
  * 转换 skill hooks 为 SDK hooks 格式
  */
-function convertSkillHooksToSdkHooks(skillHooks, skillDir, cwd) {
+function convertSkillHooksToSdkHooks(skillHooks, skillDir, cwd, getSessionId, hookType) {
     return skillHooks.map((hookConfig) => ({
         matcher: hookConfig.matcher,
         hooks: hookConfig.hooks.map((hook) => {
             // SDK HookCallback 签名: (input, toolUseID, options) => Promise<HookJSONOutput>
             return async (input, toolUseID, options) => {
+                // PreToolUse: 拦截并重定向 planning 文件操作
+                if (hookType === "PreToolUse" && input.tool_name && input.tool_input) {
+                    const toolName = input.tool_name;
+                    const toolInput = input.tool_input;
+                    // 处理文件操作工具的路径重定向
+                    if ((toolName === "Write" || toolName === "Read" || toolName === "Edit") && toolInput.file_path) {
+                        const filePath = toolInput.file_path;
+                        if (filePath.includes(".planning/default/")) {
+                            const sessionId = getSessionId() || "default";
+                            const updatedPath = filePath.replace(".planning/default/", `.planning/${sessionId}/`);
+                            console.log(`[hooks-loader] Intercepting and redirecting: ${filePath} -> ${updatedPath}`);
+                            // 手动执行文件操作并 return，不要继续到 command 部分
+                            try {
+                                console.log(`[hooks-loader] Inside try block, toolName=${toolName}`);
+                                if (toolName === "Write") {
+                                    console.log(`[hooks-loader] Handling Write operation`);
+                                    // 创建目录
+                                    const dir = dirname(updatedPath);
+                                    if (!existsSync(dir)) {
+                                        mkdirSync(dir, { recursive: true });
+                                    }
+                                    // 写入文件
+                                    writeFileSync(updatedPath, toolInput.content || "", "utf-8");
+                                    console.log(`[hooks-loader] File written to ${updatedPath}`);
+                                    // Block 原始工具执行
+                                    return {
+                                        decision: "block",
+                                        systemMessage: `File written to session-specific directory`,
+                                    };
+                                }
+                                else if (toolName === "Read") {
+                                    // 读取文件
+                                    if (existsSync(updatedPath)) {
+                                        const content = readFileSync(updatedPath, "utf-8");
+                                        console.log(`[hooks-loader] File read from ${updatedPath}`);
+                                        // Block 原始工具，返回文件内容
+                                        return {
+                                            decision: "block",
+                                            systemMessage: `File content:\n\n${content}`,
+                                        };
+                                    }
+                                    else {
+                                        return {
+                                            decision: "block",
+                                            systemMessage: `File not found: ${updatedPath}`,
+                                        };
+                                    }
+                                }
+                                else if (toolName === "Edit") {
+                                    // Edit 需要读取、修改、写入
+                                    if (existsSync(updatedPath)) {
+                                        let content = readFileSync(updatedPath, "utf-8");
+                                        // 执行替换
+                                        if (toolInput.old_string && toolInput.new_string) {
+                                            if (toolInput.replace_all) {
+                                                content = content.split(toolInput.old_string).join(toolInput.new_string);
+                                            }
+                                            else {
+                                                content = content.replace(toolInput.old_string, toolInput.new_string);
+                                            }
+                                            writeFileSync(updatedPath, content, "utf-8");
+                                            console.log(`[hooks-loader] File edited at ${updatedPath}`);
+                                        }
+                                        return {
+                                            decision: "block",
+                                            systemMessage: `File edited successfully`,
+                                        };
+                                    }
+                                    else {
+                                        return {
+                                            decision: "block",
+                                            systemMessage: `File not found: ${updatedPath}`,
+                                        };
+                                    }
+                                }
+                            }
+                            catch (error) {
+                                console.error(`[hooks-loader] Error:`, error);
+                                return {
+                                    decision: "block",
+                                    systemMessage: `Error: ${error.message}`,
+                                };
+                            }
+                        }
+                    }
+                }
                 if (hook.type === "command") {
-                    const result = executeCommand(hook.command, cwd, skillDir);
+                    const sessionId = getSessionId();
+                    const result = executeCommand(hook.command, cwd, skillDir, sessionId);
                     // 如果有输出，作为系统消息返回
                     if (result) {
                         return {
@@ -63,7 +153,7 @@ function convertSkillHooksToSdkHooks(skillHooks, skillDir, cwd) {
 /**
  * 从 skills 目录加载所有 skill 的 hooks
  */
-export function loadSkillHooks(skillsDir, cwd) {
+export function loadSkillHooks(skillsDir, cwd, getSessionId) {
     const hooks = {};
     if (!existsSync(skillsDir)) {
         return hooks;
@@ -79,6 +169,20 @@ export function loadSkillHooks(skillsDir, cwd) {
         }
         try {
             const content = readFileSync(skillMdPath, "utf-8");
+            // 验证配置文件
+            const validator = new YamlValidator();
+            const validationResult = validator.validate(content, skillMdPath);
+            // 显示错误
+            if (!validationResult.valid) {
+                console.error(formatValidationErrors(validationResult.errors));
+                continue;
+            }
+            // 显示警告
+            if (validationResult.warnings && validationResult.warnings.length > 0) {
+                for (const warning of validationResult.warnings) {
+                    console.warn(formatValidationWarning(warning));
+                }
+            }
             const frontmatter = extractYamlFrontmatter(content);
             if (!frontmatter?.hooks) {
                 continue;
@@ -86,19 +190,19 @@ export function loadSkillHooks(skillsDir, cwd) {
             // 转换各个 hook 事件
             if (frontmatter.hooks.SessionStart) {
                 hooks.SessionStart = hooks.SessionStart || [];
-                hooks.SessionStart.push(...convertSkillHooksToSdkHooks(frontmatter.hooks.SessionStart, skillDir, cwd));
+                hooks.SessionStart.push(...convertSkillHooksToSdkHooks(frontmatter.hooks.SessionStart, skillDir, cwd, getSessionId, "SessionStart"));
             }
             if (frontmatter.hooks.PreToolUse) {
                 hooks.PreToolUse = hooks.PreToolUse || [];
-                hooks.PreToolUse.push(...convertSkillHooksToSdkHooks(frontmatter.hooks.PreToolUse, skillDir, cwd));
+                hooks.PreToolUse.push(...convertSkillHooksToSdkHooks(frontmatter.hooks.PreToolUse, skillDir, cwd, getSessionId, "PreToolUse"));
             }
             if (frontmatter.hooks.PostToolUse) {
                 hooks.PostToolUse = hooks.PostToolUse || [];
-                hooks.PostToolUse.push(...convertSkillHooksToSdkHooks(frontmatter.hooks.PostToolUse, skillDir, cwd));
+                hooks.PostToolUse.push(...convertSkillHooksToSdkHooks(frontmatter.hooks.PostToolUse, skillDir, cwd, getSessionId, "PostToolUse"));
             }
             if (frontmatter.hooks.Stop) {
                 hooks.Stop = hooks.Stop || [];
-                hooks.Stop.push(...convertSkillHooksToSdkHooks(frontmatter.hooks.Stop, skillDir, cwd));
+                hooks.Stop.push(...convertSkillHooksToSdkHooks(frontmatter.hooks.Stop, skillDir, cwd, getSessionId, "Stop"));
             }
             console.log(`[hooks-loader] Loaded hooks from skill: ${skillName}`);
         }

package/dist/src/hooks-loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks-loader.js","sourceRoot":"","sources":["../../src/hooks-loader.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hooks-loader.js","sourceRoot":"","sources":["../../src/hooks-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACrF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,IAAI,MAAM,SAAS,CAAC;AAE3B,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAoBvG;;GAEG;AACH,SAAS,sBAAsB,CAAC,OAAe;IAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACrD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAyB,CAAC;IACrD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,OAAe,EAAE,GAAW,EAAE,QAAgB,EAAE,SAAkB;IACxF,IAAI,CAAC;QACH,SAAS;QACT,MAAM,eAAe,GAAG,OAAO;aAC5B,OAAO,CAAC,2BAA2B,EAAE,QAAQ,CAAC;aAC9C,OAAO,CAAC,mBAAmB,EAAE,SAAS,IAAI,SAAS,CAAC,CAAC;QAExD,MAAM,MAAM,GAAG,QAAQ,CAAC,eAAe,EAAE;YACvC,GAAG;YACH,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,iBAAiB;QACjB,OAAO,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;IAC7C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,2BAA2B,CAClC,UAA6B,EAC7B,QAAgB,EAChB,GAAW,EACX,YAAsC,EACtC,QAAgE;IAEhE,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QACrC,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACnC,8EAA8E;YAC9E,OAAO,KAAK,EAAE,KAAU,EAAE,SAA6B,EAAE,OAAgC,EAAE,EAAE;gBAC3F,mCAAmC;gBACnC,IAAI,QAAQ,KAAK,YAAY,IAAI,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;oBACrE,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC;oBACjC,MAAM,SAAS,GAAG,KAAK,CAAC,UAAU,CAAC;oBAEnC,iBAAiB;oBACjB,IAAI,CAAC,QAAQ,KAAK,OAAO,IAAI,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,MAAM,CAAC,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;wBAChG,MAAM,QAAQ,GAAG,SAAS,CAAC,SAAmB,CAAC;wBAE/C,IAAI,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC;4BAC5C,MAAM,SAAS,GAAG,YAAY,EAAE,IAAI,SAAS,CAAC;4BAC9C,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,oBAAoB,EAAE,aAAa,SAAS,GAAG,CAAC,CAAC;4BAEtF,OAAO,CAAC,GAAG,CAAC,gDAAgD,QAAQ,OAAO,WAAW,EAAE,CAAC,CAAC;4BAE1F,oCAAoC;4BACpC,IAAI,CAAC;gCACH,OAAO,CAAC,GAAG,CAAC,6CAA6C,QAAQ,EAAE,CAAC,CAAC;gCAErE,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;oCACzB,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;oCAEvD,OAAO;oCACP,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;oCACjC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;wCACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;oCACtC,CAAC;oCACD,OAAO;oCACP,aAAa,CAAC,WAAW,EAAE,SAAS,CAAC,OAAO,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;oCAC7D,OAAO,CAAC,GAAG,CAAC,kCAAkC,WAAW,EAAE,CAAC,CAAC;oCAE7D,eAAe;oCACf,OAAO;wCACL,QAAQ,EAAE,OAAO;wCACjB,aAAa,EAAE,4CAA4C;qCAC5D,CAAC;gCACJ,CAAC;qCAAM,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;oCAC/B,OAAO;oCACP,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;wCAC5B,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;wCACnD,OAAO,CAAC,GAAG,CAAC,iCAAiC,WAAW,EAAE,CAAC,CAAC;wCAE5D,oBAAoB;wCACpB,OAAO;4CACL,QAAQ,EAAE,OAAO;4CACjB,aAAa,EAAE,oBAAoB,OAAO,EAAE;yCAC7C,CAAC;oCACJ,CAAC;yCAAM,CAAC;wCACN,OAAO;4CACL,QAAQ,EAAE,OAAO;4CACjB,aAAa,EAAE,mBAAmB,WAAW,EAAE;yCAChD,CAAC;oCACJ,CAAC;gCACH,CAAC;qCAAM,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;oCAC/B,kBAAkB;oCAClB,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;wCAC5B,IAAI,OAAO,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;wCAEjD,OAAO;wCACP,IAAI,SAAS,CAAC,UAAU,IAAI,SAAS,CAAC,UAAU,EAAE,CAAC;4CACjD,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC;gDAC1B,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;4CAC3E,CAAC;iDAAM,CAAC;gDACN,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC;4CACxE,CAAC;4CACD,aAAa,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;4CAC7C,OAAO,CAAC,GAAG,CAAC,iCAAiC,WAAW,EAAE,CAAC,CAAC;wCAC9D,CAAC;wCAED,OAAO;4CACL,QAAQ,EAAE,OAAO;4CACjB,aAAa,EAAE,0BAA0B;yCAC1C,CAAC;oCACJ,CAAC;yCAAM,CAAC;wCACN,OAAO;4CACL,QAAQ,EAAE,OAAO;4CACjB,aAAa,EAAE,mBAAmB,WAAW,EAAE;yCAChD,CAAC;oCACJ,CAAC;gCACH,CAAC;4BACH,CAAC;4BAAC,OAAO,KAAU,EAAE,CAAC;gCACpB,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC;gCAC9C,OAAO;oCACL,QAAQ,EAAE,OAAO;oCACjB,aAAa,EAAE,UAAU,KAAK,CAAC,OAAO,EAAE;iCACzC,CAAC;4BACJ,CAAC;wBACH,CAAC;oBACH,CAAC;gBACH,CAAC;gBAED,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;oBAC5B,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;oBACjC,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;oBAEtE,iBAAiB;oBACjB,IAAI,MAAM,EAAE,CAAC;wBACX,OAAO;4BACL,QAAQ,EAAE,IAAI;4BACd,aAAa,EAAE,MAAM;yBACtB,CAAC;oBACJ,CAAC;gBACH,CAAC;gBAED,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YAC5B,CAAC,CAAC;QACJ,CAAC,CAAC;KACH,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,SAAiB,EACjB,GAAW,EACX,YAAsC;IAEtC,MAAM,KAAK,GAAgB,EAAE,CAAC;IAE9B,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,SAAS,GAAG,WAAW,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SAC9D,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;SACxC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAEhC,KAAK,MAAM,SAAS,IAAI,SAAS,EAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAC5C,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAE/C,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC7B,SAAS;QACX,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAEnD,SAAS;YACT,MAAM,SAAS,GAAG,IAAI,aAAa,EAAE,CAAC;YACtC,MAAM,gBAAgB,GAAG,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YAElE,OAAO;YACP,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;gBAC5B,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;gBAC/D,SAAS;YACX,CAAC;YAED,OAAO;YACP,IAAI,gBAAgB,CAAC,QAAQ,IAAI,gBAAgB,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtE,KAAK,MAAM,OAAO,IAAI,gBAAgB,CAAC,QAAQ,EAAE,CAAC;oBAChD,OAAO,CAAC,IAAI,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,CAAC;gBACjD,CAAC;YACH,CAAC;YAED,MAAM,WAAW,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;YAEpD,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,CAAC;gBACxB,SAAS;YACX,CAAC;YAED,eAAe;YACf,IAAI,WAAW,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;gBACnC,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC;gBAC9C,KAAK,CAAC,YAAY,CAAC,IAAI,CACrB,GAAG,2BAA2B,CAAC,WAAW,CAAC,KAAK,CAAC,YAAY,EAAE,QAAQ,EAAE,GAAG,EAAE,YAAY,EAAE,cAAc,CAAC,CAC5G,CAAC;YACJ,CAAC;YAED,IAAI,WAAW,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;gBACjC,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC;gBAC1C,KAAK,CAAC,UAAU,CAAC,IAAI,CACnB,GAAG,2BAA2B,CAAC,WAAW,CAAC,KAAK,CAAC,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,YAAY,EAAE,YAAY,CAAC,CACxG,CAAC;YACJ,CAAC;YAED,IAAI,WAAW,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;gBAClC,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC;gBAC5C,KAAK,CAAC,WAAW,CAAC,IAAI,CACpB,GAAG,2BAA2B,CAAC,WAAW,CAAC,KAAK,CAAC,WAAW,EAAE,QAAQ,EAAE,GAAG,EAAE,YAAY,EAAE,aAAa,CAAC,CAC1G,CAAC;YACJ,CAAC;YAED,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;gBAC3B,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;gBAC9B,KAAK,CAAC,IAAI,CAAC,IAAI,CACb,GAAG,2BAA2B,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,CAAC,CAC5F,CAAC;YACJ,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,2CAA2C,SAAS,EAAE,CAAC,CAAC;QACtE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,4CAA4C,SAAS,GAAG,EAAE,KAAK,CAAC,CAAC;QACjF,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/src/validation/error-formatter.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 错误消息格式化工具
+ */
+import type { ValidationError } from "./types.js";
+/**
+ * 格式化单个验证错误为用户友好的消息
+ */
+export declare function formatValidationError(error: ValidationError): string;
+/**
+ * 格式化多个验证错误
+ */
+export declare function formatValidationErrors(errors: ValidationError[]): string;
+/**
+ * 格式化验证警告
+ */
+export declare function formatValidationWarning(warning: ValidationError): string;
+/**
+ * 创建代码片段显示（带行号）
+ */
+export declare function createCodeSnippet(content: string, errorLine: number, contextLines?: number): string;
+//# sourceMappingURL=error-formatter.d.ts.map

package/dist/src/validation/error-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-formatter.d.ts","sourceRoot":"","sources":["../../../src/validation/error-formatter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAuDpE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,CAOxE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAgBxE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,YAAY,GAAE,MAAU,GACvB,MAAM,CAoBR"}

package/dist/src/validation/error-formatter.js

@@ -0,0 +1,98 @@
+/**
+ * 格式化单个验证错误为用户友好的消息
+ */
+export function formatValidationError(error) {
+    const parts = [];
+    // 错误标题
+    const errorType = {
+        syntax: "语法错误",
+        schema: "配置错误",
+        semantic: "语义错误",
+    }[error.type];
+    parts.push(`\n❌ ${errorType} (${error.filePath})`);
+    parts.push("");
+    // 错误位置
+    if (error.line !== undefined) {
+        const location = error.column !== undefined ? `第 ${error.line} 行，第 ${error.column} 列` : `第 ${error.line} 行`;
+        parts.push(`位置: ${location}`);
+    }
+    // 问题字段
+    if (error.path && error.path.length > 0) {
+        parts.push(`字段: ${error.path.join(".")}`);
+    }
+    // 错误消息
+    parts.push("");
+    parts.push(`问题: ${error.message}`);
+    // 详细描述
+    if (error.details) {
+        parts.push("");
+        parts.push(error.details);
+    }
+    // 修复建议
+    if (error.suggestions.length > 0) {
+        parts.push("");
+        parts.push("修复建议:");
+        error.suggestions.forEach((suggestion) => {
+            parts.push(`  • ${suggestion}`);
+        });
+    }
+    // 示例配置
+    if (error.examplePath) {
+        parts.push("");
+        parts.push(`参考示例: ${error.examplePath}`);
+    }
+    // 文档链接
+    if (error.docUrl) {
+        parts.push(`相关文档: ${error.docUrl}`);
+    }
+    return parts.join("\n");
+}
+/**
+ * 格式化多个验证错误
+ */
+export function formatValidationErrors(errors) {
+    if (errors.length === 0) {
+        return "";
+    }
+    const formatted = errors.map((error) => formatValidationError(error));
+    return formatted.join("\n\n" + "─".repeat(60) + "\n");
+}
+/**
+ * 格式化验证警告
+ */
+export function formatValidationWarning(warning) {
+    const parts = [];
+    parts.push(`\n⚠️  警告 (${warning.filePath})`);
+    parts.push("");
+    parts.push(warning.message);
+    if (warning.suggestions.length > 0) {
+        parts.push("");
+        parts.push("建议:");
+        warning.suggestions.forEach((suggestion) => {
+            parts.push(`  • ${suggestion}`);
+        });
+    }
+    return parts.join("\n");
+}
+/**
+ * 创建代码片段显示（带行号）
+ */
+export function createCodeSnippet(content, errorLine, contextLines = 2) {
+    const lines = content.split("\n");
+    const startLine = Math.max(0, errorLine - contextLines - 1);
+    const endLine = Math.min(lines.length - 1, errorLine + contextLines - 1);
+    const snippet = [];
+    for (let i = startLine; i <= endLine; i++) {
+        const lineNum = i + 1;
+        const isErrorLine = lineNum === errorLine;
+        const prefix = isErrorLine ? ">" : " ";
+        const lineNumStr = String(lineNum).padStart(4);
+        snippet.push(`${prefix} ${lineNumStr} | ${lines[i]}`);
+        if (isErrorLine) {
+            // 添加指示符
+            snippet.push("       " + " ".repeat(lines[i].length) + "^");
+        }
+    }
+    return snippet.join("\n");
+}
+//# sourceMappingURL=error-formatter.js.map

package/dist/src/validation/error-formatter.js.map

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

package/dist/src/validation/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 配置验证模块
+ */
+export * from "./types.js";
+export * from "./schema.js";
+export * from "./yaml-validator.js";
+export * from "./json-validator.js";
+export * from "./error-formatter.js";
+export * from "./suggestions.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/validation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/validation/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC"}

package/dist/src/validation/index.js

@@ -0,0 +1,10 @@
+/**
+ * 配置验证模块
+ */
+export * from "./types.js";
+export * from "./schema.js";
+export * from "./yaml-validator.js";
+export * from "./json-validator.js";
+export * from "./error-formatter.js";
+export * from "./suggestions.js";
+//# sourceMappingURL=index.js.map

package/dist/src/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/validation/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC"}

package/dist/src/validation/json-validator.d.ts

@@ -0,0 +1,25 @@
+import type { Validator, ValidationResult } from "./types.js";
+import { type OptimaConfig } from "./schema.js";
+export declare class JsonValidator implements Validator<OptimaConfig> {
+    /**
+     * 解析 JSON 内容
+     */
+    private parseJson;
+    /**
+     * 从 JSON 错误中提取位置信息
+     */
+    private extractErrorPosition;
+    /**
+     * 将字符位置转换为行号和列号
+     */
+    private positionToLineColumn;
+    /**
+     * 验证 JSON 配置
+     */
+    validate(content: string, filePath: string): ValidationResult;
+    /**
+     * 解析配置（验证成功后调用）
+     */
+    parse(content: string): OptimaConfig | null;
+}
+//# sourceMappingURL=json-validator.d.ts.map

package/dist/src/validation/json-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-validator.d.ts","sourceRoot":"","sources":["../../../src/validation/json-validator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAmB,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC/E,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAOpE,qBAAa,aAAc,YAAW,SAAS,CAAC,YAAY,CAAC;IAC3D;;OAEG;IACH,OAAO,CAAC,SAAS;IAUjB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAS5B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAQ5B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB;IAyH7D;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;CAY5C"}

package/dist/src/validation/json-validator.js

@@ -0,0 +1,173 @@
+/**
+ * JSON 配置验证器
+ */
+import { ZodError } from "zod";
+import { OptimaConfigSchema } from "./schema.js";
+import { generateSuggestionsFromZodError, generateJsonSyntaxSuggestions, generateOptimaConfigSuggestions, } from "./suggestions.js";
+export class JsonValidator {
+    /**
+     * 解析 JSON 内容
+     */
+    parseJson(content) {
+        try {
+            const data = JSON.parse(content);
+            return { data };
+        }
+        catch (error) {
+            const position = this.extractErrorPosition(error);
+            return { data: null, error: error, position };
+        }
+    }
+    /**
+     * 从 JSON 错误中提取位置信息
+     */
+    extractErrorPosition(error) {
+        // JSON.parse 错误通常包含 "at position X"
+        const match = error.message.match(/position (\d+)/);
+        if (match) {
+            return parseInt(match[1], 10);
+        }
+        return undefined;
+    }
+    /**
+     * 将字符位置转换为行号和列号
+     */
+    positionToLineColumn(content, position) {
+        const lines = content.substring(0, position).split("\n");
+        return {
+            line: lines.length,
+            column: lines[lines.length - 1].length + 1,
+        };
+    }
+    /**
+     * 验证 JSON 配置
+     */
+    validate(content, filePath) {
+        const errors = [];
+        const warnings = [];
+        // 1. 检查是否为空
+        if (!content.trim()) {
+            errors.push({
+                type: "syntax",
+                filePath,
+                message: "配置文件为空",
+                suggestions: [
+                    "添加配置内容",
+                    "如果不需要配置，可以删除该文件",
+                    "最小配置示例: {}",
+                ],
+            });
+            return { valid: false, errors, warnings };
+        }
+        // 2. 解析 JSON
+        const { data, error: jsonError, position } = this.parseJson(content);
+        if (jsonError) {
+            let line;
+            let column;
+            if (position !== undefined) {
+                const loc = this.positionToLineColumn(content, position);
+                line = loc.line;
+                column = loc.column;
+            }
+            errors.push({
+                type: "syntax",
+                filePath,
+                message: "JSON 语法错误",
+                details: jsonError.message,
+                line,
+                column,
+                suggestions: generateJsonSyntaxSuggestions(jsonError.message),
+            });
+            return { valid: false, errors, warnings };
+        }
+        // 3. 检查是否为对象
+        if (typeof data !== "object" || data === null || Array.isArray(data)) {
+            errors.push({
+                type: "schema",
+                filePath,
+                message: "配置文件必须是一个 JSON 对象",
+                suggestions: ["配置应该用大括号 {} 包裹", "示例: { \"model\": \"...\", \"theme\": \"dark\" }"],
+            });
+            return { valid: false, errors, warnings };
+        }
+        // 4. 使用 Zod 验证 schema
+        try {
+            OptimaConfigSchema.parse(data);
+        }
+        catch (error) {
+            if (error instanceof ZodError) {
+                for (const issue of error.issues) {
+                    const zodSuggestions = generateSuggestionsFromZodError(error);
+                    const optimaSuggestions = generateOptimaConfigSuggestions(issue.path.map(String));
+                    errors.push({
+                        type: "schema",
+                        filePath,
+                        message: issue.message,
+                        path: issue.path.map(String),
+                        suggestions: [...zodSuggestions, ...optimaSuggestions],
+                    });
+                }
+            }
+            else {
+                errors.push({
+                    type: "schema",
+                    filePath,
+                    message: "未知的验证错误",
+                    details: String(error),
+                    suggestions: ["请检查配置文件格式"],
+                });
+            }
+            return { valid: false, errors, warnings };
+        }
+        // 5. 语义检查和警告
+        // 检查未知字段
+        const knownFields = ["model", "theme", "ui", "server"];
+        const unknownFields = Object.keys(data).filter((key) => !knownFields.includes(key));
+        if (unknownFields.length > 0) {
+            warnings.push({
+                type: "semantic",
+                filePath,
+                message: `发现未知字段: ${unknownFields.join(", ")}`,
+                suggestions: [
+                    "这些字段会被忽略",
+                    "检查是否拼写错误",
+                    `已知字段: ${knownFields.join(", ")}`,
+                ],
+            });
+        }
+        // 检查服务器配置
+        if (data.server?.port) {
+            const commonPorts = [3000, 8080, 8000, 5000];
+            if (!commonPorts.includes(data.server.port)) {
+                warnings.push({
+                    type: "semantic",
+                    filePath,
+                    message: `使用非常见端口: ${data.server.port}`,
+                    path: ["server", "port"],
+                    suggestions: ["确保该端口未被占用", `常用端口: ${commonPorts.join(", ")}`],
+                });
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+    /**
+     * 解析配置（验证成功后调用）
+     */
+    parse(content) {
+        const { data, error } = this.parseJson(content);
+        if (error) {
+            return null;
+        }
+        try {
+            return OptimaConfigSchema.parse(data);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=json-validator.js.map