needware-cli 1.2.9 → 1.3.1

package/examples/image-conversion-example.ts

@@ -0,0 +1,350 @@
+/**
+ * 图片转换功能使用示例
+ * 
+ * 这个示例展示如何使用 prompt-parser 中的图片转换功能
+ */
+
+import {
+  convertImageToBase64,
+  convertImagesToBase64,
+  convertRemoteImageToBase64,
+  convertRemoteImagesToBase64,
+  convertImageToBase64Smart,
+  convertImagesToBase64Smart,
+  isImageFile,
+  ImageContentBlock,
+} from '../src/utils/prompt-parser.js';
+
+/**
+ * 示例 1: 单个图片转换
+ */
+async function example1_singleImage() {
+  console.log('示例 1: 转换单个图片文件');
+  console.log('================================\n');
+
+  try {
+    // 转换单个图片
+    const imageBlock = await convertImageToBase64('./path/to/image.jpg');
+
+    console.log('转换结果:');
+    console.log(JSON.stringify(imageBlock, null, 2));
+
+    // 输出格式:
+    // {
+    //   "type": "image",
+    //   "source": {
+    //     "type": "base64",
+    //     "media_type": "image/jpeg",
+    //     "data": "/9j/4AAQSkZJRgABAQAAAQABAAD..."
+    //   }
+    // }
+  } catch (error) {
+    console.error('转换失败:', error);
+  }
+}
+
+/**
+ * 示例 2: 批量图片转换
+ */
+async function example2_multipleImages() {
+  console.log('\n示例 2: 批量转换多个图片');
+  console.log('================================\n');
+
+  try {
+    const imagePaths = [
+      './images/photo1.jpg',
+      './images/photo2.png',
+      './images/diagram.webp',
+    ];
+
+    const imageBlocks = await convertImagesToBase64(imagePaths);
+
+    console.log(`成功转换 ${imageBlocks.length} 个图片`);
+    imageBlocks.forEach((block, index) => {
+      console.log(`\n图片 ${index + 1}:`);
+      console.log(`  类型: ${block.source.media_type}`);
+      console.log(`  数据大小: ${block.source.data.length} 字符`);
+    });
+  } catch (error) {
+    console.error('批量转换失败:', error);
+  }
+}
+
+/**
+ * 示例 3: 检查文件是否为图片
+ */
+function example3_checkImageFile() {
+  console.log('\n示例 3: 检查文件类型');
+  console.log('================================\n');
+
+  const files = [
+    'photo.jpg',
+    'document.pdf',
+    'image.png',
+    'video.mp4',
+    'diagram.webp',
+  ];
+
+  files.forEach((file) => {
+    const isImage = isImageFile(file);
+    console.log(`${file}: ${isImage ? '✓ 是图片' : '✗ 不是图片'}`);
+  });
+}
+
+/**
+ * 示例 4: 创建带图片的消息
+ */
+async function example4_createMessageWithImage() {
+  console.log('\n示例 4: 创建包含图片的消息');
+  console.log('================================\n');
+
+  try {
+    // 转换图片
+    const imageBlock = await convertImageToBase64('./chart.png');
+
+    // 创建包含文本和图片的消息
+    const message = {
+      type: 'user',
+      session_id: 'session-123',
+      message: {
+        role: 'user',
+        content: [
+          {
+            type: 'text',
+            text: '请分析这张图表',
+          },
+          imageBlock,
+        ],
+      },
+      parent_tool_use_id: null,
+    };
+
+    console.log('创建的消息结构:');
+    console.log(JSON.stringify(message, null, 2));
+  } catch (error) {
+    console.error('创建消息失败:', error);
+  }
+}
+
+/**
+ * 示例 5: 混合多个内容类型
+ */
+async function example5_mixedContent() {
+  console.log('\n示例 5: 混合文本和多个图片');
+  console.log('================================\n');
+
+  try {
+    const image1 = await convertImageToBase64('./before.jpg');
+    const image2 = await convertImageToBase64('./after.jpg');
+
+    const message = {
+      type: 'user',
+      session_id: 'session-456',
+      message: {
+        role: 'user',
+        content: [
+          {
+            type: 'text',
+            text: '这是修改前的图片：',
+          },
+          image1,
+          {
+            type: 'text',
+            text: '这是修改后的图片：',
+          },
+          image2,
+          {
+            type: 'text',
+            text: '请比较这两张图片的差异',
+          },
+        ],
+      },
+      parent_tool_use_id: null,
+    };
+
+    console.log('创建的多模态消息:');
+    console.log(
+      JSON.stringify(
+        {
+          ...message,
+          message: {
+            ...message.message,
+            content: message.message.content.map((item) =>
+              item.type === 'image'
+                ? { ...item, source: { ...item.source, data: '[BASE64_DATA]' } }
+                : item
+            ),
+          },
+        },
+        null,
+        2
+      )
+    );
+  } catch (error) {
+    console.error('创建混合内容失败:', error);
+  }
+}
+
+/**
+ * 示例 6: 转换远程URL图片
+ */
+async function example6_remoteImage() {
+  console.log('\n示例 6: 转换远程URL图片');
+  console.log('================================\n');
+
+  try {
+    const imageUrl = 'https://example.com/photo.jpg';
+    const imageBlock = await convertRemoteImageToBase64(imageUrl);
+
+    console.log('远程图片转换成功:');
+    console.log(`  类型: ${imageBlock.source.media_type}`);
+    console.log(`  数据大小: ${imageBlock.source.data.length} 字符`);
+  } catch (error) {
+    console.error('转换远程图片失败:', error);
+  }
+}
+
+/**
+ * 示例 7: 批量转换远程图片
+ */
+async function example7_multipleRemoteImages() {
+  console.log('\n示例 7: 批量转换远程图片');
+  console.log('================================\n');
+
+  try {
+    const imageUrls = [
+      'https://example.com/photo1.jpg',
+      'https://example.com/photo2.png',
+      'https://example.com/diagram.webp',
+    ];
+
+    const imageBlocks = await convertRemoteImagesToBase64(imageUrls);
+
+    console.log(`成功转换 ${imageBlocks.length} 个远程图片`);
+    imageBlocks.forEach((block, index) => {
+      console.log(`\n图片 ${index + 1}:`);
+      console.log(`  类型: ${block.source.media_type}`);
+      console.log(`  数据大小: ${block.source.data.length} 字符`);
+    });
+  } catch (error) {
+    console.error('批量转换远程图片失败:', error);
+  }
+}
+
+/**
+ * 示例 8: 智能转换（自动检测本地或远程）
+ */
+async function example8_smartConversion() {
+  console.log('\n示例 8: 智能转换（混合本地和远程）');
+  console.log('================================\n');
+
+  try {
+    // 混合本地文件和远程URL
+    const imagePaths = [
+      './local-photo.jpg',                         // 本地文件
+      'https://example.com/remote-photo.jpg',      // 远程URL
+      './another-local.png',                       // 本地文件
+      'https://example.com/another-remote.png',    // 远程URL
+    ];
+
+    const imageBlocks = await convertImagesToBase64Smart(imagePaths);
+
+    console.log(`成功转换 ${imageBlocks.length} 个图片（混合本地和远程）`);
+    imageBlocks.forEach((block, index) => {
+      const source = imagePaths[index].startsWith('http') ? '远程' : '本地';
+      console.log(`\n图片 ${index + 1} (${source}):`);
+      console.log(`  路径: ${imagePaths[index]}`);
+      console.log(`  类型: ${block.source.media_type}`);
+      console.log(`  数据大小: ${block.source.data.length} 字符`);
+    });
+  } catch (error) {
+    console.error('智能转换失败:', error);
+  }
+}
+
+/**
+ * 示例 9: 使用远程图片创建消息
+ */
+async function example9_messageWithRemoteImage() {
+  console.log('\n示例 9: 使用远程图片创建消息');
+  console.log('================================\n');
+
+  try {
+    // 从远程URL转换图片
+    const imageBlock = await convertRemoteImageToBase64(
+      'https://example.com/design-mockup.png'
+    );
+
+    // 创建包含远程图片的消息
+    const message = {
+      type: 'user',
+      session_id: 'session-789',
+      message: {
+        role: 'user',
+        content: [
+          {
+            type: 'text',
+            text: '请根据这个设计图一比一还原界面',
+          },
+          imageBlock,
+        ],
+      },
+      parent_tool_use_id: null,
+    };
+
+    console.log('创建的消息包含远程图片:');
+    console.log(
+      JSON.stringify(
+        {
+          ...message,
+          message: {
+            ...message.message,
+            content: message.message.content.map((item) =>
+              item.type === 'image'
+                ? { ...item, source: { ...item.source, data: '[BASE64_DATA]' } }
+                : item
+            ),
+          },
+        },
+        null,
+        2
+      )
+    );
+  } catch (error) {
+    console.error('创建消息失败:', error);
+  }
+}
+
+// 运行所有示例
+async function runAllExamples() {
+  console.log('图片转换功能示例\n');
+  console.log('注意：这些示例需要实际的图片文件或有效的图片URL才能运行');
+  console.log('请根据您的文件路径和URL调整示例中的参数\n');
+
+  // 本地图片示例
+  // example1_singleImage();
+  // example2_multipleImages();
+  example3_checkImageFile();
+  // example4_createMessageWithImage();
+  // example5_mixedContent();
+
+  // 远程图片示例
+  // example6_remoteImage();
+  // example7_multipleRemoteImages();
+  // example8_smartConversion();
+  // example9_messageWithRemoteImage();
+}
+
+// 如果直接运行此文件，执行示例
+if (import.meta.url === `file://${process.argv[1]}`) {
+  runAllExamples().catch(console.error);
+}
+
+export {
+  example1_singleImage,
+  example2_multipleImages,
+  example3_checkImageFile,
+  example4_createMessageWithImage,
+  example5_mixedContent,
+};
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "needware-cli",
-  "version": "1.2.9",
+  "version": "1.3.1",
   "description": "一个功能强大的 Node.js 命令行工具",
   "type": "module",
   "main": "dist/index.js",
@@ -20,7 +20,7 @@
     "lint:fix": "eslint 'src/**/*.ts' --fix",
     "format": "prettier --write 'src/**/*.ts'",
     "prepare": "husky install",
-    "prepublishOnly": "npm run lint && npm test && npm run build",
+    "prepublishOnly": "npm run build",
     "diagnose:container": "bash scripts/fix-container-permissions.sh"
   },
   "keywords": [

package/test-multimodal.sh

@@ -0,0 +1,69 @@
+#!/bin/bash
+
+# 多模态消息测试脚本
+# 用于测试 needware-cli 的多模态消息支持
+
+echo "======================================"
+echo "多模态消息支持测试"
+echo "======================================"
+echo ""
+
+# 检查是否提供了 API Key
+if [ -z "$1" ]; then
+  echo "❌ 错误：请提供 API Key"
+  echo ""
+  echo "使用方法："
+  echo "  ./test-multimodal.sh YOUR_API_KEY [BASE_URL]"
+  echo ""
+  echo "示例："
+  echo "  ./test-multimodal.sh sk-ant-xxx https://api.openai-proxy.org/anthropic"
+  exit 1
+fi
+
+API_KEY="$1"
+BASE_URL="${2:-}"
+
+echo "✓ API Key: ${API_KEY:0:10}..."
+if [ -n "$BASE_URL" ]; then
+  echo "✓ Base URL: $BASE_URL"
+fi
+echo ""
+
+# 编译项目
+echo "📦 编译项目..."
+npm run build
+if [ $? -ne 0 ]; then
+  echo "❌ 编译失败"
+  exit 1
+fi
+echo "✓ 编译成功"
+echo ""
+
+# 测试 1：使用示例文件
+echo "======================================"
+echo "测试 1: 从文件读取多模态消息"
+echo "======================================"
+echo ""
+echo "命令："
+if [ -n "$BASE_URL" ]; then
+  echo "  needware-cli agent examples/multimodal-message-example.json --api-key $API_KEY --base-url $BASE_URL"
+  echo ""
+  node bin/cli.js agent examples/multimodal-message-example.json --api-key "$API_KEY" --base-url "$BASE_URL"
+else
+  echo "  needware-cli agent examples/multimodal-message-example.json --api-key $API_KEY"
+  echo ""
+  node bin/cli.js agent examples/multimodal-message-example.json --api-key "$API_KEY"
+fi
+
+echo ""
+echo "======================================"
+echo "测试完成"
+echo "======================================"
+echo ""
+echo "💡 提示："
+echo "  - 如果看到 Agent 开始处理消息，说明功能正常"
+echo "  - 多模态消息会自动使用交互式模式"
+echo "  - 更多使用示例请查看 EXAMPLES.md"
+echo ""
+
+

package/EXAMPLES.md

@@ -1,241 +0,0 @@
-# Agent 命令使用示例
-
-## 📌 快速开始
-
-### 1. 简单文本字符串
-
-最简单的用法，直接提供文本：
-
-```bash
-needware-cli agent "创建一个待办事项列表应用"
-```
-
-### 2. 从文件读取文本
-
-创建文件 `prompt.txt`:
-```
-创建一个用户登录页面，包含：
-- 用户名输入框
-- 密码输入框
-- 记住我选项
-- 登录按钮
-- 忘记密码链接
-```
-
-使用命令：
-```bash
-needware-cli agent ./prompt.txt
-```
-
----
-
-## 🔧 使用 SDKUserMessage JSON 格式
-
-### 3. 直接使用 JSON 字符串
-
-```bash
-needware-cli agent '{
-  "type": "user",
-  "session_id": "my-session-001",
-  "message": {
-    "role": "user",
-    "content": "创建一个响应式的导航栏组件"
-  },
-  "parent_tool_use_id": null
-}'
-```
-
-**注意：** 
-- `type` 必须是 `"user"`
-- `session_id` 是会话标识符（可以自定义）
-- `message.role` 必须是 `"user"`
-- `parent_tool_use_id` 通常设置为 `null`
-
-### 4. 从 JSON 文件读取
-
-创建文件 `message.json`:
-```json
-{
-  "type": "user",
-  "session_id": "my-session-001",
-  "message": {
-    "role": "user",
-    "content": "创建一个简单的计数器组件，包含增加、减少和重置按钮"
-  },
-  "parent_tool_use_id": null
-}
-```
-
-使用命令：
-```bash
-needware-cli agent ./message.json
-```
-
-### 5. 使用会话 ID 保持上下文
-
-多次执行使用相同的 `session_id`，Agent 会记住之前的对话：
-
-**第一次执行：**
-```bash
-needware-cli agent '{
-  "type": "user",
-  "session_id": "project-login-page",
-  "message": {
-    "role": "user",
-    "content": "创建一个登录页面"
-  },
-  "parent_tool_use_id": null
-}'
-```
-
-**第二次执行（使用相同的 session_id）：**
-```bash
-needware-cli agent '{
-  "type": "user",
-  "session_id": "project-login-page",
-  "message": {
-    "role": "user",
-    "content": "添加表单验证和错误提示"
-  },
-  "parent_tool_use_id": null
-}'
-```
-
----
-
-## 🎯 实际应用场景
-
-### 场景 1: 快速原型开发
-
-```bash
-needware-cli agent "创建一个电商产品卡片组件，显示图片、标题、价格和购买按钮"
-```
-
-### 场景 2: 功能迭代（保持上下文）
-
-使用 JSON 格式，通过 `session_id` 保持上下文：
-
-```bash
-# 步骤 1: 创建基础功能
-needware-cli agent '{
-  "type": "user",
-  "session_id": "dashboard-project",
-  "message": {"role": "user", "content": "创建一个仪表盘页面框架"},
-  "parent_tool_use_id": null
-}'
-
-# 步骤 2: 添加图表
-needware-cli agent '{
-  "type": "user",
-  "session_id": "dashboard-project",
-  "message": {"role": "user", "content": "在仪表盘中添加数据可视化图表"},
-  "parent_tool_use_id": null
-}'
-
-# 步骤 3: 添加筛选功能
-needware-cli agent '{
-  "type": "user",
-  "session_id": "dashboard-project",
-  "message": {"role": "user", "content": "添加日期范围筛选器"},
-  "parent_tool_use_id": null
-}'
-```
-
-### 场景 3: 团队协作（使用文件）
-
-创建 `tasks/feature-auth.json`:
-```json
-{
-  "type": "user",
-  "session_id": "team-auth-feature",
-  "message": {
-    "role": "user",
-    "content": "实现用户认证系统，包括登录、注册、密码重置功能"
-  },
-  "parent_tool_use_id": null
-}
-```
-
-团队成员可以直接使用：
-```bash
-needware-cli agent ./tasks/feature-auth.json --working-dir ./my-project
-```
-
----
-
-## 💡 最佳实践
-
-### 1. 文本字符串适用于：
-- ✅ 快速测试
-- ✅ 简单的一次性任务
-- ✅ 不需要保持上下文的场景
-
-### 2. SDKUserMessage JSON 适用于：
-- ✅ 需要保持会话上下文
-- ✅ 复杂的多步骤任务
-- ✅ 团队协作和版本控制
-- ✅ 自动化脚本和 CI/CD 集成
-
-### 3. 会话管理技巧
-
-使用有意义的 `session_id` 命名：
-```bash
-# 按功能命名
-session_id: "feature-user-auth"
-session_id: "feature-payment"
-
-# 按日期命名
-session_id: "dev-2025-01-15"
-
-# 按开发者命名
-session_id: "john-nav-component"
-```
-
----
-
-## 🔍 调试技巧
-
-查看解析结果（使用你添加的调试日志）：
-```bash
-needware-cli agent '{
-  "type": "user",
-  "session_id": "debug-test",
-  "message": {"role": "user", "content": "测试消息"},
-  "parent_tool_use_id": null
-}'
-```
-
-输出会显示：
-```
-parsedPrompt ************* {
-  prompt: '测试消息',
-  sessionId: 'debug-test',
-  isInteractive: false
-}
-```
-
----
-
-## 📚 更多示例
-
-查看 `examples/` 目录：
-- `examples/sdk-message-example.json` - 标准 SDKUserMessage 示例
-- `examples/prompt.txt` - 文本 prompt 示例
-
----
-
-## ⚙️ 完整命令参数
-
-```bash
-needware-cli agent <prompt> \
-  --working-dir ./my-project \
-  --additional-dirs ./shared,./utils \
-  --api-key sk-xxx \
-  --base-url https://api.anthropic.com
-```
-
-其中 `<prompt>` 可以是：
-1. 文本字符串：`"创建组件"`
-2. 文件路径：`./prompt.txt` 或 `./message.json`
-3. JSON 字符串：`'{"type":"user",...}'`
-

package/examples/sdk-message-example.json

@@ -1,10 +0,0 @@
-{
-  "type": "user",
-  "session_id": "my-session-123",
-  "message": {
-    "role": "user",
-    "content": "创建一个简单的计数器组件，包含增加、减少和重置按钮"
-  },
-  "parent_tool_use_id": null
-}
-