luma-mcp 1.2.8 → 1.3.0

package/README.md

@@ -125,7 +125,7 @@ npx luma-mcp
   "mcpServers": {
     "luma": {
       "command": "node",
-      "args": ["D:\\codes\\Luma_mcp\\build\\index.js"],
+      "args": ["D:\\codes\\luma-mcp\\build\\index.js"],
       "env": {
         "ZHIPU_API_KEY": "your-zhipu-api-key"
       }
@@ -141,7 +141,7 @@ npx luma-mcp
   "mcpServers": {
     "luma": {
       "command": "node",
-      "args": ["D:\\codes\\Luma_mcp\\build\\index.js"],
+      "args": ["D:\\codes\\luma-mcp\\build\\index.js"],
       "env": {
         "MODEL_PROVIDER": "siliconflow",
         "SILICONFLOW_API_KEY": "your-siliconflow-api-key"
@@ -368,35 +368,35 @@ analyze_image({
 
 ### 通用配置
 
-| 变量名            | 必需 | 默认值  | 说明                                           |
-| ----------------- | ---- | ------- | ---------------------------------------------- |
+| 变量名            | 必需 | 默认值  | 说明                                         |
+|-------------------|------|---------|----------------------------------------------|
 | `MODEL_PROVIDER`  | 否   | `zhipu` | 模型提供商：`zhipu`、`siliconflow` 或 `qwen`   |
 | `MODEL_NAME`      | 否   | 见下文  | 模型名称（自动根据提供商选择）                 |
-| `MAX_TOKENS`      | 否   | `16384` | 最大生成 tokens                                |
-| `TEMPERATURE`     | 否   | `0.7`   | 温度参数 (0-1)                                 |
-| `TOP_P`           | 否   | `0.7`   | Top-p 参数 (0-1)                               |
+| `MAX_TOKENS`      | 否   | `16384` | 最大生成 tokens                              |
+| `TEMPERATURE`     | 否   | `0.7`   | 温度参数 (0-1)                               |
+| `TOP_P`           | 否   | `0.7`   | Top-p 参数 (0-1)                             |
 | `ENABLE_THINKING` | 否   | `true`  | 是否启用思考模式（GLM-4.6V 和 Qwen3-VL-Flash） |
 
 ### 智谱 GLM-4.6V 专用
 
-| 变量名          | 必需             | 默认值 | 说明                |
-| --------------- | ---------------- | ------ | ------------------- |
+| 变量名          | 必需           | 默认值 | 说明                |
+|-----------------|----------------|--------|---------------------|
 | `ZHIPU_API_KEY` | 是（使用智谱时） | -      | 智谱 AI 的 API 密钥 |
 
 默认模型：`glm-4.6v`
 
 ### 硅基流动 DeepSeek-OCR 专用
 
-| 变量名                | 必需                 | 默认值 | 说明                |
-| --------------------- | -------------------- | ------ | ------------------- |
+| 变量名                | 必需               | 默认值 | 说明                |
+|-----------------------|--------------------|--------|---------------------|
 | `SILICONFLOW_API_KEY` | 是（使用硅基流动时） | -      | 硅基流动的 API 密钥 |
 
 默认模型：`deepseek-ai/DeepSeek-OCR`
 
 ### 阿里云通义千问 Qwen3-VL-Flash 专用
 
-| 变量名              | 必需             | 默认值 | 说明                  |
-| ------------------- | ---------------- | ------ | --------------------- |
+| 变量名              | 必需           | 默认值 | 说明                  |
+|---------------------|----------------|--------|-----------------------|
 | `DASHSCOPE_API_KEY` | 是（使用千问时） | -      | 阿里云百炼的 API 密钥 |
 
 默认模型：`qwen3-vl-flash`
@@ -542,13 +542,13 @@ data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUA...
 ### 如何选择模型？
 
 | 特性          | GLM-4.6V（智谱） | DeepSeek-OCR（硅基流动） | Qwen3-VL-Flash（阿里云） |
-| ------------- | ---------------- | ------------------------ | ------------------------ |
-| **费用**      | 收费             | **完全免费**             | 收费                     |
-| **中文理解**  | 优秀             | 良好                     | **优秀**                 |
-| **OCR 能力**  | 良好             | **优秀**                 | 优秀                     |
-| **思考模式**  | 支持             | 不支持                   | 支持                     |
-| **速度/成本** | 中等             | 免费                     | **快速/低成本**          |
-| **适用场景**  | 通用图片分析     | OCR、文字识别            | 快速分析、3D 定位        |
+|---------------|----------------|------------------------|------------------------|
+| **费用**      | 收费           | **完全免费**           | 收费                   |
+| **中文理解**  | 优秀           | 良好                   | **优秀**               |
+| **OCR 能力**  | 良好           | **优秀**               | 优秀                   |
+| **思考模式**  | 支持           | 不支持                 | 支持                   |
+| **速度/成本** | 中等           | 免费                   | **快速/低成本**        |
+| **适用场景**  | 通用图片分析   | OCR、文字识别           | 快速分析、3D 定位       |
 
 **推荐**:
 

package/build/config.d.ts

@@ -11,6 +11,7 @@ export interface LumaConfig {
     temperature: number;
     topP: number;
     enableThinking: boolean;
+    baseVisionPrompt?: string;
 }
 /**
  * 从环境变量加载配置

package/build/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,aAAa,GAAG,MAAM,GAAG,YAAY,CAAC;AAE5E,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,UAAU,CA+CvC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,aAAa,GAAG,MAAM,GAAG,YAAY,CAAC;AAE5E,MAAM,WAAW,UAAU;IAC1B,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,OAAO,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,UAAU,CAgDvC"}

package/build/config.js

@@ -15,28 +15,28 @@ export function loadConfig() {
         apiKey = process.env.SILICONFLOW_API_KEY;
         defaultModel = 'deepseek-ai/DeepSeek-OCR';
         if (!apiKey) {
-            throw new Error('SILICONFLOW_API_KEY environment variable is required when using SiliconFlow provider');
+            throw new Error('SILICONFLOW_API_KEY environment variable is required. Please configure it in your MCP settings.');
         }
     }
     else if (provider === 'qwen') {
         apiKey = process.env.DASHSCOPE_API_KEY;
         defaultModel = 'qwen3-vl-flash';
         if (!apiKey) {
-            throw new Error('DASHSCOPE_API_KEY environment variable is required when using Qwen provider');
+            throw new Error('DASHSCOPE_API_KEY environment variable is required. Please configure it in your MCP settings.');
         }
     }
     else if (provider === 'volcengine') {
         apiKey = process.env.VOLCENGINE_API_KEY;
         defaultModel = 'doubao-seed-1-6-flash-250828';
         if (!apiKey) {
-            throw new Error('VOLCENGINE_API_KEY environment variable is required when using Volcengine provider');
+            throw new Error('VOLCENGINE_API_KEY environment variable is required. Please configure it in your MCP settings.');
         }
     }
     else {
         apiKey = process.env.ZHIPU_API_KEY;
         defaultModel = 'glm-4.6v';
         if (!apiKey) {
-            throw new Error('ZHIPU_API_KEY environment variable is required when using Zhipu provider');
+            throw new Error('ZHIPU_API_KEY environment variable is required. Please configure it in your MCP settings.');
         }
     }
     return {
@@ -47,6 +47,7 @@ export function loadConfig() {
         temperature: parseFloat(process.env.TEMPERATURE || '0.7'),
         topP: parseFloat(process.env.TOP_P || '0.7'),
         enableThinking: process.env.ENABLE_THINKING !== 'false',
+        baseVisionPrompt: process.env.BASE_VISION_PROMPT,
     };
 }
 //# sourceMappingURL=config.js.map

package/build/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAcH;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,aAAa;IACb,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,WAAW,EAAE,IAAI,OAAO,CAAkB,CAAC;IAEzF,kBAAkB;IAClB,IAAI,MAA0B,CAAC;IAC/B,IAAI,YAAoB,CAAC;IAEzB,IAAI,QAAQ,KAAK,aAAa,EAAE,CAAC;QAC/B,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;QACzC,YAAY,GAAG,0BAA0B,CAAC;QAE1C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,sFAAsF,CAAC,CAAC;QAC1G,CAAC;IACH,CAAC;SAAM,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;QAC/B,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;QACvC,YAAY,GAAG,gBAAgB,CAAC;QAEhC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;QACjG,CAAC;IACH,CAAC;SAAM,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;QACrC,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;QACxC,YAAY,GAAG,8BAA8B,CAAC;QAE9C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,oFAAoF,CAAC,CAAC;QACxG,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;QACnC,YAAY,GAAG,UAAU,CAAC;QAE1B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAC;QAC9F,CAAC;IACH,CAAC;IAED,OAAO;QACL,QAAQ;QACR,MAAM;QACN,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,YAAY;QAC7C,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,OAAO,EAAE,EAAE,CAAC;QAC1D,WAAW,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,KAAK,CAAC;QACzD,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,KAAK,CAAC;QAC5C,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,OAAO;KACxD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAeH;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,aAAa;IACb,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,WAAW,EAAE,IAAI,OAAO,CAAkB,CAAC;IAEzF,kBAAkB;IAClB,IAAI,MAA0B,CAAC;IAC/B,IAAI,YAAoB,CAAC;IAEzB,IAAI,QAAQ,KAAK,aAAa,EAAE,CAAC;QAC/B,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;QACzC,YAAY,GAAG,0BAA0B,CAAC;QAE1C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,iGAAiG,CAAC,CAAC;QACrH,CAAC;IACH,CAAC;SAAM,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;QAC/B,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;QACvC,YAAY,GAAG,gBAAgB,CAAC;QAEhC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,+FAA+F,CAAC,CAAC;QACnH,CAAC;IACH,CAAC;SAAM,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;QACrC,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;QACxC,YAAY,GAAG,8BAA8B,CAAC;QAE9C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,gGAAgG,CAAC,CAAC;QACpH,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;QACnC,YAAY,GAAG,UAAU,CAAC;QAE1B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,2FAA2F,CAAC,CAAC;QAC/G,CAAC;IACH,CAAC;IAED,OAAO;QACL,QAAQ;QACR,MAAM;QACN,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,YAAY;QAC7C,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,OAAO,EAAE,EAAE,CAAC;QAC1D,WAAW,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,KAAK,CAAC;QACzD,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,KAAK,CAAC;QAC9C,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,OAAO;QACvD,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB;KAC/C,CAAC;AACJ,CAAC"}

package/build/index.js

@@ -16,6 +16,37 @@ import { QwenClient } from "./qwen-client.js";
 import { VolcengineClient } from "./volcengine-client.js";
 import { imageToBase64, validateImageSource } from "./image-processor.js";
 import { withRetry, createSuccessResponse, createErrorResponse, } from "./utils/helpers.js";
+/**
+ * Default base vision prompt used when BASE_VISION_PROMPT is not set.
+ * This acts like a lightweight system prompt for image understanding.
+ *
+ * 设计目标：
+ * - 优先输出基于截图“可见事实”的结构/布局信息
+ * - 尽量减少凭经验猜测实现方式、性能、无障碍等不可见细节
+ */
+const DEFAULT_BASE_VISION_PROMPT = [
+    "你是一个专门帮助开发者理解截图内容的视觉结构分析助手。",
+    "你的首要目标是：基于截图中可见的信息，准确还原页面/界面的结构、布局和主要元素，而不是主观做视觉审美评价或猜测底层实现。",
+    "当用户提到“页面结构”、“页面架构”、“布局”、“组件树”、“还原界面”、“前端/客户端界面”等需求时，请遵循以下原则：",
+    "1. 先进行【事实描述】，只陈述从截图中可以直接观察到的内容（区域划分、布局方式、组件/控件、大致层级关系等）；不要推测不可见的信息，例如具体实现技术（JS/CSS/Canvas）、运行性能、无障碍属性（aria-*）、隐藏的交互状态（hover/focus/点击后的效果等）。",
+    "2. 描述布局时，尽量用有助于还原实现的方式组织信息，例如：顶部导航栏 / 左侧侧边栏 / 主内容区 / 底部栏、单栏/双栏/多栏、是否有固定头部等。",
+    "3. 如用户没有明确要求“设计点评/优化建议”，可以完全不写或只给最多 1～2 条简短、标明为“通用建议”的内容，且要明确说明这些建议无法仅凭截图确认当前是否已经做到。",
+    "4. 任何基于猜测的内容，都要使用“从截图中无法确认，但一般建议……”这样的表述，避免把猜测说成事实。",
+].join("\n");
+/**
+ * Build full prompt by combining base vision prompt and user prompt.
+ */
+function buildFullPrompt(userPrompt, basePrompt) {
+    if (!basePrompt) {
+        return userPrompt;
+    }
+    const trimmedBase = basePrompt.trim();
+    const trimmedUser = userPrompt.trim();
+    if (!trimmedBase) {
+        return trimmedUser;
+    }
+    return `${trimmedBase}\n\n用户任务描述：\n${trimmedUser}`;
+}
 /**
  * 创建 MCP 服务器
  */
@@ -23,6 +54,7 @@ async function createServer() {
     logger.info("Initializing Luma MCP Server");
     // 加载配置
     const config = loadConfig();
+    const baseVisionPrompt = config.baseVisionPrompt ?? DEFAULT_BASE_VISION_PROMPT;
     // 根据配置选择模型客户端
     let visionClient;
     if (config.provider === "siliconflow") {
@@ -56,21 +88,30 @@ async function createServer() {
         await validateImageSource(imageSource);
         // 2. 处理图片（读取或返回URL）
         const imageDataUrl = await imageToBase64(imageSource);
-        // 3. 直接使用原始提示词（不进行包装或增强）
-        const fullPrompt = prompt;
+        // 3. Build full prompt from base vision prompt and user prompt
+        const fullPrompt = buildFullPrompt(prompt, baseVisionPrompt);
         // 4. 调用视觉模型分析图片
         return await visionClient.analyzeImage(imageDataUrl, fullPrompt, config.enableThinking);
     }, 2, // 最多重试2次
     1000 // 初始延补1秒
     );
     // 注册工具 - 使用 McpServer.tool() API
-    server.tool("analyze_image", "图像分析工具：支持三种使用方式：1) 用户粘贴图片时直接调用，无需手动指定路径 2) 指定本地图片路径，如./screenshot.png 3) 指定图片URL，如https://example.com/image.png。AI应根据用户问题生成专业的分析提示词（如用户问'网站布局有什么问题'，应生成'请详细分析这个网站界面的布局问题，包括视觉层次、对齐方式、间距、响应式设计等方面的问题'），然后传递提示词和图片进行调用。", {
+    server.tool("analyze_image", `图像分析工具：
+- 何时调用：当用户提到“看图、看截图、看看这张图片/界面/页面/报错/架构/布局/组件结构/页面结构”等需求，或者在对话中出现图片附件并询问与图片内容相关的问题（包括 UI/前端界面结构、代码截图、日志/报错截图、文档截图、表单、表格等），都应优先调用本工具，而不是只用文本推理。
+- 图片来源：1) 用户粘贴图片时直接调用，无需手动指定路径 2) 指定本地图片路径，如 ./screenshot.png 3) 指定图片 URL，如 https://example.com/image.png。
+- 提示词（prompt）约定：
+  - **不要**在调用本工具前自己构造一大段复杂分析提示词；
+  - 直接把“用户关于图片的原始问题/指令”作为 prompt 传入即可，例如：
+    - “这张图是什么界面？整体结构是什么样的？”
+    - “帮我从前端实现角度拆解这个页面的布局和组件结构”；
+  - Luma 会在服务器内部自动拼接系统级视觉说明和分析模板，调用底层视觉模型完成完整理解；
+  - 你只需要确保 prompt 准确表达用户对这张图想了解的内容，无需重复描述图片细节或编写长篇提示词。`, {
         image_source: z
             .string()
             .describe("要分析的图片来源：支持三种方式 1) 用户粘贴图片时由Claude Desktop自动提供路径 2) 本地文件路径，如./screenshot.png 3) HTTP(S)图片URL，如https://example.com/image.png（支持 PNG、JPG、JPEG、WebP、GIF，最大 10MB）"),
         prompt: z
             .string()
-            .describe("分析提示词：AI根据用户问题生成的专业分析提示词。应该包含具体的分析要求和期望的输出格式。"),
+            .describe("用户关于图片的原始问题或简短指令，例如“这张图是什么界面？”、“帮我分析这个页面的结构和布局”。服务器会在内部补充系统级视觉提示词并构造完整分析指令。"),
     }, async (params) => {
         try {
             // AI应该已经根据用户问题生成了合适的prompt

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;GAGG;AAEH,wCAAwC;AACxC,OAAO,EAAE,uBAAuB,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACpE,uBAAuB,EAAE,CAAC;AAE1B,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EACL,SAAS,EACT,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,KAAK,UAAU,YAAY;IACzB,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAE5C,OAAO;IACP,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAE5B,cAAc;IACd,IAAI,YAA0B,CAAC;IAE/B,IAAI,MAAM,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;QACtC,YAAY,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC;SAAM,IAAI,MAAM,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;QACtC,YAAY,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;SAAM,IAAI,MAAM,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;QAC5C,YAAY,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;SAAM,CAAC;QACN,YAAY,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,2BAA2B,EAAE;QACvC,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,KAAK,EAAE,YAAY,CAAC,YAAY,EAAE;KACnC,CAAC,CAAC;IAEH,uBAAuB;IACvB,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE;SACV;KACF,CACF,CAAC;IAEF,aAAa;IACb,MAAM,gBAAgB,GAAG,SAAS,CAChC,KAAK,EAAE,WAAmB,EAAE,MAAc,EAAE,EAAE;QAC5C,YAAY;QACZ,MAAM,mBAAmB,CAAC,WAAW,CAAC,CAAC;QAEvC,oBAAoB;QACpB,MAAM,YAAY,GAAG,MAAM,aAAa,CAAC,WAAW,CAAC,CAAC;QAEtD,yBAAyB;QACzB,MAAM,UAAU,GAAG,MAAM,CAAC;QAE1B,gBAAgB;QAChB,OAAO,MAAM,YAAY,CAAC,YAAY,CACpC,YAAY,EACZ,UAAU,EACV,MAAM,CAAC,cAAc,CACtB,CAAC;IACJ,CAAC,EACD,CAAC,EAAE,SAAS;IACZ,IAAI,CAAC,SAAS;KACf,CAAC;IAEF,iCAAiC;IACjC,MAAM,CAAC,IAAI,CACT,eAAe,EACf,uNAAuN,EACvN;QACE,YAAY,EAAE,CAAC;aACZ,MAAM,EAAE;aACR,QAAQ,CACP,8JAA8J,CAC/J;QACH,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,QAAQ,CACP,+CAA+C,CAChD;KACJ,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,2BAA2B;YAC3B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;YAE7B,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE;gBAC7B,MAAM,EAAE,MAAM,CAAC,YAAY;gBAC3B,MAAM;aACP,CAAC,CAAC;YAEH,YAAY;YACZ,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;YAEnE,MAAM,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;YACrD,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE;gBACpC,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC,CAAC;YAEH,OAAO,mBAAmB,CACxB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CACzD,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,YAAY,EAAE,CAAC;QACpC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAEhC,MAAM,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;IAC/D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,iCAAiC,EAAE;YAC9C,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,SAAS;AACT,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE;IACxC,MAAM,CAAC,KAAK,CAAC,oBAAoB,EAAE;QACjC,KAAK,EAAE,KAAK,CAAC,OAAO;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK;KACnB,CAAC,CAAC;IACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE;IAC1C,MAAM,CAAC,KAAK,CAAC,qBAAqB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;IACxB,MAAM,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;IACzD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;IACzB,MAAM,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;IAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,IAAI,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,8 +1,13 @@
 {
   "name": "luma-mcp",
-  "version": "1.2.8",
+  "version": "1.3.0",
   "description": "Multi-model vision understanding MCP server. Supports GLM-4.6V (Zhipu), DeepSeek-OCR (SiliconFlow - Free), Qwen3-VL-Flash (Aliyun), and Doubao-Seed-1.6 (Volcengine)",
   "type": "module",
+  "files": [
+    "build/",
+    "package.json",
+    "README.md"
+  ],
   "bin": {
     "luma-mcp": "build/index.js"
   },

package/.env.example

@@ -1,33 +0,0 @@
-# 模型提供商选择：zhipu | siliconflow | qwen | volcengine
-MODEL_PROVIDER=zhipu
-
-# ========== Zhipu AI (推荐 - GLM-4.6V) ==========
-# 获取API Key: https://open.bigmodel.cn/
-ZHIPU_API_KEY=your-zhipu-api-key-here
-MODEL_NAME=glm-4.6v
-
-# ========== SiliconFlow (免费 - DeepSeek-OCR) ==========
-# 获取API Key: https://siliconflow.cn/
-# SILICONFLOW_API_KEY=your-siliconflow-api-key
-# MODEL_NAME=deepseek-ai/DeepSeek-OCR
-
-# ========== 阿里云 Qwen (Qwen3-VL-Flash) ==========
-# 获取API Key: https://dashscope.aliyun.com/
-# DASHSCOPE_API_KEY=your-dashscope-api-key
-# MODEL_NAME=qwen3-vl-flash
-
-# ========== 火山方舟 Volcengine (Doubao-Seed-1.6) ==========
-# 获取API Key: https://console.volcengine.com/ark
-# VOLCENGINE_API_KEY=your-volcengine-api-key
-# MODEL_NAME=doubao-seed-1-6-flash-250828
-# 可选模型:
-# - doubao-seed-1-6-flash-250828 (性价比高，256k上下文)
-# - doubao-seed-1-6-vision-250815 (视觉优化，64k输出)
-# - doubao-seed-1-6-lite-251015 (轻量级)
-# 注意: 使用控制台中的实际模型ID
-
-# ========== 通用参数 ==========
-MAX_TOKENS=16384
-TEMPERATURE=0.7
-TOP_P=0.7
-ENABLE_THINKING=true

package/.github/workflows/release.yml

@@ -1,49 +0,0 @@
-name: Create Release
-
-on:
-  push:
-    tags:
-      - 'v*.*.*'
-
-jobs:
-  release:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-    
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      - name: Extract version from tag
-        id: version
-        run: echo "VERSION=${GITHUB_REF#refs/tags/v}" >> $GITHUB_OUTPUT
-
-      - name: Extract changelog for this version
-        id: changelog
-        run: |
-          VERSION=${{ steps.version.outputs.VERSION }}
-          echo "Extracting changelog for version $VERSION"
-          
-          # Extract changelog content between version headers
-          sed -n "/## \[${VERSION}\]/,/## \[/p" CHANGELOG.md | sed '$d' > release_notes.md
-          
-          # If empty, use a default message
-          if [ ! -s release_notes.md ]; then
-            echo "Release version ${VERSION}" > release_notes.md
-          fi
-          
-          cat release_notes.md
-
-      - name: Create GitHub Release
-        uses: softprops/action-gh-release@v1
-        with:
-          tag_name: v${{ steps.version.outputs.VERSION }}
-          name: Release v${{ steps.version.outputs.VERSION }}
-          body_path: release_notes.md
-          draft: false
-          prerelease: false
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/CHANGELOG.md

@@ -1,261 +0,0 @@
-# Changelog
-
-本项目的所有重大变更都将记录在此文件中。
-
-## [1.2.8] - 2025-12-23
-
-### Fixed
-
-- 🐛 **修复 enableThinking 参数传递**: 修复 index.ts 中未将 enableThinking 参数传递给视觉模型客户端的问题
-- 🔧 **统一 thinking 逻辑**: 所有支持 thinking 的客户端（智谱、千问、火山方舟）现在使用统一的启用逻辑
-- 📝 **完善日志记录**: 千问客户端新增 API 调用日志，与其他客户端保持一致
-
-### Changed
-
-- ♻️ **重构智谱客户端**: 优化 thinking 参数处理逻辑，使代码更清晰易懂
-- ♻️ **重构千问客户端**: 统一 thinking 启用逻辑，默认启用思考模式
-- ✨ **火山方舟 thinking 支持**: 火山方舟 Doubao 模型现在正确支持思考模式
-
-### Technical Details
-
-- `src/index.ts`: 在 analyzeWithRetry 中正确传递 config.enableThinking 参数
-- `src/zhipu-client.ts`: 重构 thinking 逻辑，使用 `if (enableThinking !== false)` 统一判断
-- `src/qwen-client.ts`: 
-  - 统一 thinking 启用逻辑为 `if (enableThinking !== false)`
-  - 新增 logger 导入和 API 调用日志
-  - 添加成功/失败日志记录
-- `src/volcengine-client.ts`: 
-  - 新增 thinking 参数支持到 VolcengineRequest 接口
-  - 实现 thinking 模式启用逻辑
-  - 更新日志记录以反映实际 thinking 状态
-
-### Thinking Mode Support
-
-现在所有支持的模型都正确启用思考模式：
-
-| 模型                  | Thinking 支持 | 实现方式                        | 默认状态 |
-|-----------------------|---------------|---------------------------------|----------|
-| 智谱 GLM-4.6V         | ✅             | `thinking: { type: "enabled" }` | 启用     |
-| 千问 Qwen3-VL         | ✅             | `extra_body.enable_thinking`    | 启用     |
-| 火山方舟 Doubao       | ✅             | `thinking: { type: "enabled" }` | 启用     |
-| 硅基流动 DeepSeek-OCR | ❌             | 不支持                          | N/A      |
-
-用户可通过 `ENABLE_THINKING=false` 环境变量禁用思考模式以提升速度和降低成本。
-
-## [1.2.7] - 2025-12-17
-
-### Added
-
-- 🆕 **火山方舟 Provider**: 新增第四个视觉模型提供商 - 火山方舟 Volcengine
-- 🎯 **Doubao-Seed-1.6 系列**: 支持 flash、vision、lite 多种版本
-- 🔧 **统一配置架构**: 客户端构造函数改为接受 LumaConfig 对象，实现配置集中管理
-- 🖼️ **完整图片格式支持**: 火山方舟支持 base64 数据、URL 链接和本地文件
-
-### Changed
-
-- 🏗️ **架构重构**: 三个现有客户端（Zhipu、SiliconFlow、Qwen）重构为统一配置对象模式
-- 🗃️ **客户端优化**: 移除硬编码默认值，所有配置统一从环境变量读取
-- 📝 **API 格式统一**: 火山方舟客户端改为使用 Chat Completions API 格式，与其他 provider 保持一致
-- 📚 **文档完善**: 更新中英文 README，添加火山方舟配置示例和模型对比
-
-### Technical Details
-
-- `src/config.ts`: 新增 volcengine provider 支持，添加 VOLCENGINE_API_KEY 环境变量
-- `src/volcengine-client.ts`: 新文件，完整实现 VolcengineClient 类，支持 Chat Completions API
-- `src/zhipu-client.ts`: 重构构造函数，移除硬编码参数，支持 LumaConfig
-- `src/siliconflow-client.ts`: 重构构造函数，支持统一配置对象
-- `src/qwen-client.ts`: 重构构造函数，支持统一配置对象
-- `src/index.ts`: 添加 VolcengineClient 导入和实例化逻辑
-- `.env.example`: 添加火山方舟配置示例和说明
-- `README.md` & `docs/README_EN.md`: 新增火山方舟特性说明和配置示例
-
-### Provider Summary
-
-现在支持 4 个视觉模型提供商:
-
-1. **智谱 GLM-4.6V** (默认): 中文理解优秀，16384 tokens
-2. **硅基流动 DeepSeek-OCR**: 免费使用，OCR 能力强
-3. **阿里云 Qwen3-VL-Flash**: 速度快成本低，支持思考模式
-4. **火山方舟 Doubao-Seed-1.6**: 性价比高，256k 上下文，支持多种版本
-
-## [1.2.6] - 2025-12-16
-
-### Changed
-
-- 🚀 **模型升级**: 更新智谱模型从 GLM-4.5V 升级至 GLM-4.6V，性能和理解能力提升
-- 📈 **Token 限制提升**: 默认 maxTokens 从 8192 提升至 16384，支持更详细的分析输出
-- 💡 **思考模式默认开启**: ENABLE_THINKING 默认为 true，提供更准确的分析结果
-- 🧹 **代码清理**: 移除 prompts.ts 提示词模板文件，简化架构
-- 🔧 **TypeScript 优化**: 清理未使用的类型导入，修复 TS6133 警告
-- 📝 **文档完善**: 更新中英文 README，强化三种使用方式说明（粘贴图片、本地路径、URL）
-
-### Technical Details
-
-- `src/config.ts`: 更新默认模型为 glm-4.6v，默认 maxTokens 改为 16384，enableThinking 默认为 true
-- `src/zhipu-client.ts`: 更新模型引用，清理未使用导入
-- `src/siliconflow-client.ts`: 清理未使用的类型导入
-- `src/index.ts`: 简化 prompt 处理逻辑，直接使用原始提示词
-- 删除 `src/prompts.ts`: 移除 buildAnalysisPrompt 函数
-- README 更新: 模型信息、Token 配置、项目结构、思考模式配置
-
-## [1.2.4] - 2025-12-16 (Reverted)
-
-### Note
-
-此版本因代码回滚问题被回退，所有优化内容已整合至 v1.2.6
-
-## [1.2.3] - 2025-11-21
-
-### Changed
-
-- 🧹 **代码清理**: 移除 Claude 特定调试注释和实验性代码
-- 📝 **工具描述优化**: 简化和专业化工具说明，提升 AI 模型调用成功率
-- 🔧 **路径处理通用化**: 重构 @ 前缀路径处理，移除平台特定命名
-
-### Technical Details
-
-- 移除 Claude 资源读取相关的实验性代码
-- 重命名 `stripAtPrefix()` 为 `normalizeImageSourcePath()`
-- 清理所有客户端适配器中的调试日志和注释
-- 统一代码风格和注释规范
-
-## [1.2.2] - 2025-11-20
-
-### Added
-
-- ✨ **@ 路径支持**: 自动处理 Claude Code 的 @ 文件引用前缀，修复第一次调用失败的问题
-- 📝 **智能 Prompt**: 通用请求自动添加详细指引，保证全面分析
-
-### Changed
-
-- 🔧 **Prompt 统一**: 简化为单一通用 prompt，智能处理不同场景
-- ✨ **表述优化**: 融合 Minimax 的经典表述，强调“不遗漏细节”和“完整提取”
-- 📚 **文档更新**: 更新项目结构，添加 qwen-client.ts 和测试文件
-
-### Fixed
-
-- 🐛 **@ 路径问题**: 修复 Claude Code 中 `@folder/image.png` 导致的路径错误
-- 🐛 **编译错误**: 修复 image-processor.ts 中重复声明的变量
-
-### Technical Details
-
-- 新增 `stripAtPrefix()` 函数处理 Claude Code 的文件引用语法
-- 简化 `buildAnalysisPrompt()` 从两套逻辑到单一逻辑
-- 添加智能请求检测，自动补充详细分析指引
-
-## [1.2.1] - 2025-11-18
-
-### Changed
-
-- 📝 **文档优化**: 精简 README，移除冲余配置文件路径说明
-- 📝 **更新日志简化**: 将 README 中的详细更新日志替换为 CHANGELOG.md 链接
-- ✨ **Qwen 测试示例**: 添加 Qwen3-VL-Flash 本地测试命令
-- 💰 **定价信息**: 添加阿里云通义千问定价参考链接
-- 📋 **模型对比**: 更新模型选择表，完善 Qwen3-VL-Flash 信息
-- 🔗 **API Key 获取**: 添加阿里云百炼 API Key 获取指南
-- 📚 **相关链接**: 新增阿里云百炼平台和 Qwen3-VL 文档链接
-- 🐛 **错误信息**: 优化 API 调用失败排查提示，包含阿里云账户
-
-### Fixed
-
-- 🐛 **描述修正**: 修正 package.json 中模型名称为 qwen3-vl-flash
-- 📝 **注释精简**: 简化 prompts.ts 注释头
-
-## [1.2.0] - 2025-11-17
-
-### Added
-
-- 🎉 **第三个视觉模型**: 新增阿里云通义千问 Qwen3-VL-Flash 支持
-- 💡 **思考模式**: Qwen3-VL-Flash 支持深度思考模式（enable_thinking），提升复杂场景分析准确性
-- ⚡ **高性价比**: Flash 版本速度更快、成本更低，适合大量使用
-- 🔌 **OpenAI 兼容**: 使用阿里云百炼的 OpenAI 兼容 API，统一接口设计
-- 🌐 **多地域支持**: 默认使用北京地域，支持新加坡地域配置
-
-### Changed
-
-- ⚙️ 新增 `MODEL_PROVIDER=qwen` 和 `DASHSCOPE_API_KEY` 环境变量配置
-- 📝 更新所有文档（中英文），添加 Qwen3-VL-Flash 配置示例
-- 💰 默认使用 qwen3-vl-flash 模型，兹顾性能与成本
-- 🏗️ 重构客户端构造函数，统一参数传递方式
-
-### Technical Details
-
-- 新增文件:
-  - `src/qwen-client.ts` - 阿里云通义千问 VL API 客户端实现
-- 修改文件:
-  - `src/config.ts` - 添加 'qwen' 提供商支持
-  - `src/zhipu-client.ts` - 重构构造函数，支持独立参数
-  - `src/siliconflow-client.ts` - 重构构造函数，支持独立参数
-  - `src/index.ts` - 添加 Qwen 客户端初始化逻辑
-  - `package.json` - 更新版本至 1.2.0，添加 qwen/aliyun/dashscope 关键词
-
-## [1.1.1] - 2025-11-13
-
-### Added
-
-- 🖼️ **Data URI 支持**: 支持接收 base64 编码的图片数据 (data:image/png;base64,...)
-- 🚀 **为未来做准备**: 当 MCP 客户端支持时，可直接传递用户粘贴的图片
-
-### Changed
-
-- 📝 更新工具描述，说明支持三种输入格式：本地路径、URL、Data URI
-- ✅ 新增 Data URI 格式验证（MIME 类型、大小限制）
-
-## [1.1.0] - 2025-11-13
-
-### Added
-
-- 🎉 **多模型支持**: 新增硅基流动 DeepSeek-OCR 支持
-- 🆓 **免费选项**: DeepSeek-OCR 通过硅基流动提供完全免费的 OCR 服务
-- 📐 **统一接口**: 创建 VisionClient 接口，支持灵活扩展更多视觉模型
-- ⚙️ **灵活配置**: 通过 `MODEL_PROVIDER` 环境变量轻松切换模型
-
-### Changed
-
-- 🔧 环境变量命名优化，支持通用配置（`MODEL_NAME`、`MAX_TOKENS` 等）
-- 📝 更新文档，提供双模型配置说明和选择建议
-- 🏗️ 重构代码结构，提升可维护性
-
-### Technical Details
-
-- 新增文件:
-  - `src/vision-client.ts` - 视觉模型客户端统一接口
-  - `src/siliconflow-client.ts` - 硅基流动 API 客户端实现
-  - `.env.example` - 配置示例文件
-- 修改文件:
-  - `src/config.ts` - 支持多提供商配置
-  - `src/zhipu-client.ts` - 实现 VisionClient 接口
-  - `src/index.ts` - 根据配置动态选择客户端
-  - `README.md` - 完整的双模型使用文档
-
-## [1.0.3] - 2025-11-12
-
-### Features
-
-- 基于智谱 GLM-4.5V 的视觉理解能力
-- 支持本地文件和远程 URL
-- 内置重试机制
-- 思考模式支持
-
----
-
-**模型对比**:
-
-|| 特性 | GLM-4.5V | DeepSeek-OCR | Qwen3-VL-Flash |
-||----------|----------|--------------|----------------|
-|| 提供商 | 智谱清言 | 硅基流动 | 阿里云百炼 |
-|| 费用 | 收费 | **免费** | 收费 |
-|| 中文理解 | 优秀 | 良好 | **优秀** |
-|| OCR 能力 | 良好 | **优秀** | 优秀 |
-|| 思考模式 | ✅ | ❌ | ✅ |
-|| 速度/成本 | 中等 | 免费 | **快/低** |
-|| 综合能力 | 良好 | OCR 专精 | **优秀** |
-|| 3D 定位 | ❌ | ❌ | ✅ |
-
-**推荐使用场景**:
-
-- 需要 OCR/文字识别 → **DeepSeek-OCR** (免费)
-- 需要深度图片理解 → **Qwen3-VL-Flash** 或 **GLM-4.5V**
-- 需要思考模式 → **Qwen3-VL-Flash** 或 **GLM-4.5V**
-- 需要高性价比 → **Qwen3-VL-Flash** (速度快、成本低)
-- 需要 3D 定位/复杂分析 → **Qwen3-VL-Flash**

package/test/test-data-uri.ts

@@ -1,64 +0,0 @@
-/**
- * 测试 Data URI 支持
- */
-
-import { validateImageSource, imageToBase64 } from '../src/image-processor.js';
-
-// 一个有效的 1x1 像素 PNG 图片的 Data URI
-const validDataUri = 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==';
-
-// 无效的 Data URI（不支持的格式）
-const invalidDataUri = 'data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxMDAiIGhlaWdodD0iMTAwIj48Y2lyY2xlIGN4PSI1MCIgY3k9IjUwIiByPSI0MCIgc3R5bGU9ImZpbGw6I2ZmZiIgLz48L3N2Zz4=';
-
-async function testDataUri() {
-  console.log('🧪 测试 Data URI 支持\n');
-
-  // 测试 1: 验证有效的 Data URI
-  try {
-    console.log('测试 1: 验证有效的 PNG Data URI');
-    await validateImageSource(validDataUri);
-    console.log('✅ 通过：有效的 Data URI 验证成功\n');
-  } catch (error) {
-    console.log(`❌ 失败: ${error instanceof Error ? error.message : String(error)}\n`);
-  }
-
-  // 测试 2: 验证无效的 Data URI（不支持的格式）
-  try {
-    console.log('测试 2: 验证不支持的格式 (SVG)');
-    await validateImageSource(invalidDataUri);
-    console.log('❌ 失败：应该抛出错误\n');
-  } catch (error) {
-    console.log(`✅ 通过：正确拒绝不支持的格式 - ${error instanceof Error ? error.message : String(error)}\n`);
-  }
-
-  // 测试 3: Data URI 转换（应该直接返回）
-  try {
-    console.log('测试 3: Data URI 转换');
-    const result = await imageToBase64(validDataUri);
-    if (result === validDataUri) {
-      console.log('✅ 通过：Data URI 正确传递（未修改）\n');
-    } else {
-      console.log('❌ 失败：Data URI 被修改了\n');
-    }
-  } catch (error) {
-    console.log(`❌ 失败: ${error instanceof Error ? error.message : String(error)}\n`);
-  }
-
-  // 测试 4: 大小验证（创建一个超过10MB的Data URI）
-  try {
-    console.log('测试 4: 验证大小限制 (>10MB)');
-    // 创建一个约 15MB 的 base64 字符串（20MB * 3/4 = 15MB）
-    const largeBase64 = 'A'.repeat(20 * 1024 * 1024);
-    const largeDataUri = `data:image/png;base64,${largeBase64}`;
-    await validateImageSource(largeDataUri);
-    console.log('❌ 失败：应该拒绝过大的文件\n');
-  } catch (error) {
-    console.log(`✅ 通过：正确拒绝超大文件 - ${error instanceof Error ? error.message : String(error)}\n`);
-  }
-
-  console.log('==========================================');
-  console.log('✅ Data URI 测试完成！');
-  console.log('==========================================\n');
-}
-
-testDataUri().catch(console.error);

package/test/test-deepseek-raw.ts

@@ -1,100 +0,0 @@
-/**
- * 直接测试 DeepSeek-OCR API（无任何包装）
- */
-
-import axios from 'axios';
-import * as fs from 'fs';
-import * as path from 'path';
-
-async function testDeepSeekOCR(imagePath: string) {
-  console.log('\n🧪 测试 DeepSeek-OCR API（原始调用）\n');
-
-  const apiKey = process.env.SILICONFLOW_API_KEY;
-  
-  if (!apiKey) {
-    console.error('❌ 错误: 需要设置 SILICONFLOW_API_KEY 环境变量');
-    console.error('示例: $env:SILICONFLOW_API_KEY="your-api-key"');
-    process.exit(1);
-  }
-  
-  // 读取图片并转为 base64
-  const imageBuffer = fs.readFileSync(imagePath);
-  const base64Image = imageBuffer.toString('base64');
-  const mimeType = imagePath.endsWith('.png') ? 'image/png' : 'image/jpeg';
-  const imageDataUrl = `data:${mimeType};base64,${base64Image}`;
-
-  console.log(`📸 图片: ${imagePath}`);
-  console.log(`📦 大小: ${(imageBuffer.length / 1024).toFixed(2)} KB\n`);
-
-  // 测试不同的 prompt
-  const prompts = [
-    '识别图片中的所有文字',
-    'OCR',
-    'Extract all text from this image',
-    'What do you see in this image?',
-    '请详细描述这张图片'
-  ];
-
-  for (const prompt of prompts) {
-    console.log(`\n🔍 测试 Prompt: "${prompt}"`);
-    console.log('─'.repeat(50));
-
-    try {
-      const response = await axios.post(
-        'https://api.siliconflow.cn/v1/chat/completions',
-        {
-          model: 'deepseek-ai/DeepSeek-OCR',
-          messages: [
-            {
-              role: 'user',
-              content: [
-                {
-                  type: 'image_url',
-                  image_url: {
-                    url: imageDataUrl,
-                  },
-                },
-                {
-                  type: 'text',
-                  text: prompt,
-                },
-              ],
-            },
-          ],
-          temperature: 0.7,
-          max_tokens: 4096,
-        },
-        {
-          headers: {
-            'Authorization': `Bearer ${apiKey}`,
-            'Content-Type': 'application/json',
-          },
-          timeout: 60000,
-        }
-      );
-
-      const result = response.data.choices[0].message.content;
-      const usage = response.data.usage;
-
-      console.log(`✅ Tokens: ${usage.total_tokens} (prompt: ${usage.prompt_tokens}, completion: ${usage.completion_tokens})`);
-      console.log(`📝 响应长度: ${result?.length || 0} 字符`);
-      
-      if (result && result.trim().length > 0) {
-        console.log('\n📊 结果:');
-        console.log('─'.repeat(50));
-        console.log(result);
-        console.log('─'.repeat(50));
-        console.log('\n✅ 找到有效响应！');
-        break;
-      } else {
-        console.log('❌ 空响应');
-      }
-    } catch (error: any) {
-      console.log(`❌ 错误: ${error.message}`);
-    }
-  }
-}
-
-// 运行测试
-const imagePath = path.join(process.cwd(), 'test.png');
-testDeepSeekOCR(imagePath).catch(console.error);

package/test/test-local.ts

@@ -1,101 +0,0 @@
-/**
- * Luma MCP 本地测试脚本
- * 直接测试图片分析功能，不需要MCP客户端
- */
-
-import { loadConfig } from '../src/config.js';
-import type { VisionClient } from '../src/vision-client.js';
-import { ZhipuClient } from '../src/zhipu-client.js';
-import { SiliconFlowClient } from '../src/siliconflow-client.js';
-import { imageToBase64, validateImageSource } from '../src/image-processor.js';
-import { buildAnalysisPrompt } from '../src/prompts.js';
-import { logger } from '../src/utils/logger.js';
-
-async function testImageAnalysis(imagePath: string, question?: string) {
-  console.log('\n==========================================');
-  console.log('🧪 测试 Luma MCP 图片分析');
-  console.log('==========================================\n');
-
-  try {
-    // 1. 加载配置
-    console.log('📝 加载配置...');
-    const config = loadConfig();
-    console.log(`✅ 配置加载成功: 提供商 ${config.provider}, 模型 ${config.model}\n`);
-
-    // 2. 验证图片
-    console.log('🔍 验证图片来源...');
-    await validateImageSource(imagePath);
-    console.log(`✅ 图片验证通过: ${imagePath}\n`);
-
-    // 3. 处理图片
-    console.log('🖼️  处理图片...');
-    const imageDataUrl = await imageToBase64(imagePath);
-    const isUrl = imagePath.startsWith('http');
-    console.log(`✅ 图片处理完成: ${isUrl ? 'URL' : 'Base64编码'}\n`);
-
-    // 4. 构建提示词
-    console.log('💬 构建提示词...');
-    // DeepSeek-OCR 需要简洁 prompt
-    const prompt = config.provider === 'siliconflow'
-      ? (question || '请详细分析这张图片的内容')
-      : buildAnalysisPrompt(question);
-    console.log(`✅ 提示词: ${question || '通用描述'}\n`);
-
-    // 5. 创建客户端并调用API
-    const client: VisionClient = config.provider === 'siliconflow'
-      ? new SiliconFlowClient(config)
-      : new ZhipuClient(config);
-    
-    const modelName = config.provider === 'siliconflow' ? 'DeepSeek-OCR' : 'GLM-4.5V';
-    console.log(`🤖 调用 ${modelName} API...`);
-    const result = await client.analyzeImage(imageDataUrl, prompt);
-
-    // 6. 显示结果
-    console.log('\n==========================================');
-    console.log('📊 分析结果');
-    console.log('==========================================\n');
-    console.log(result);
-    console.log('\n==========================================');
-    console.log('✅ 测试完成！');
-    console.log('==========================================\n');
-
-  } catch (error) {
-    console.error('\n❌ 测试失败:');
-    console.error(error instanceof Error ? error.message : String(error));
-    process.exit(1);
-  }
-}
-
-// 解析命令行参数
-const args = process.argv.slice(2);
-
-if (args.length === 0) {
-  console.log(`
-使用方法:
-  npm run test:local <图片路径或URL> [问题]
-
-示例:
-  # 分析本地图片
-  npm run test:local ./test.png
-
-  # 分析本地图片并提问
-  npm run test:local ./code-error.png "这段代码为什么报错？"
-
-  # 分析远程图片
-  npm run test:local https://example.com/image.jpg
-
-环境变量:
-  # 使用智谱 GLM-4.5V
-  ZHIPU_API_KEY=your-api-key
-  
-  # 使用硅基流动 DeepSeek-OCR
-  MODEL_PROVIDER=siliconflow
-  SILICONFLOW_API_KEY=your-api-key
-  `);
-  process.exit(1);
-}
-
-const imagePath = args[0];
-const question = args.slice(1).join(' ') || undefined;
-
-testImageAnalysis(imagePath, question);

package/test/test-qwen.ts

@@ -1,88 +0,0 @@
-/**
- * Qwen 客户端测试
- * 测试阿里云通义千问VL视觉理解
- */
-
-import { QwenClient } from '../src/qwen-client.js';
-import { imageToBase64 } from '../src/image-processor.js';
-
-async function testQwen() {
-  const apiKey = process.env.DASHSCOPE_API_KEY;
-  
-  if (!apiKey) {
-    console.error('❌ 错误: 需要设置 DASHSCOPE_API_KEY 环境变量');
-    console.log('设置方法:');
-    console.log('  macOS/Linux: export DASHSCOPE_API_KEY="your-api-key"');
-    console.log('  Windows: $env:DASHSCOPE_API_KEY="your-api-key"');
-    process.exit(1);
-  }
-
-  // 获取图片路径
-  const imagePath = process.argv[2];
-  if (!imagePath) {
-    console.error('❌ 错误: 请提供图片路径');
-    console.log('用法: tsx test/test-qwen.ts <图片路径>');
-    console.log('示例: tsx test/test-qwen.ts ./test.png');
-    process.exit(1);
-  }
-
-  console.log('🚀 开始测试 Qwen3-VL-Flash...\n');
-
-  try {
-    // 1. 初始化客户端
-    console.log('1️⃣ 初始化 Qwen 客户端...');
-    const client = new QwenClient(
-      apiKey,
-      'qwen3-vl-flash',  // 使用高性价比的 Flash 版本
-      4096,
-      0.7
-    );
-    console.log(`✅ 客户端初始化成功: ${client.getModelName()}\n`);
-
-    // 2. 读取图片
-    console.log('2️⃣ 读取图片...');
-    const imageData = await imageToBase64(imagePath);
-    console.log(`✅ 图片读取成功 (${imagePath})\n`);
-
-    // 3. 测试基础分析
-    console.log('3️⃣ 测试基础分析（不启用思考模式）...');
-    const basicResult = await client.analyzeImage(
-      imageData,
-      '请详细分析这张图片的内容',
-      false
-    );
-    console.log('📊 基础分析结果:');
-    console.log(basicResult);
-    console.log('\n');
-
-    // 4. 测试思考模式
-    console.log('4️⃣ 测试思考模式（enable_thinking=true）...');
-    const thinkingResult = await client.analyzeImage(
-      imageData,
-      '请详细分析这张图片的内容，包括所有细节',
-      true  // 启用思考模式
-    );
-    console.log('🧠 思考模式分析结果:');
-    console.log(thinkingResult);
-    console.log('\n');
-
-    // 5. 测试 OCR
-    console.log('5️⃣ 测试 OCR 能力...');
-    const ocrResult = await client.analyzeImage(
-      imageData,
-      '识别图片中的所有文字',
-      false
-    );
-    console.log('📝 OCR 结果:');
-    console.log(ocrResult);
-    console.log('\n');
-
-    console.log('✅ 所有测试完成！');
-
-  } catch (error) {
-    console.error('❌ 测试失败:', error instanceof Error ? error.message : error);
-    process.exit(1);
-  }
-}
-
-testQwen();