botrun-horse 2.29.2 → 2.30.0

package/botrun-c/api/test-billing.ts

@@ -0,0 +1,81 @@
+/**
+ * 測試 BillingService 功能
+ */
+import { Firestore } from '@google-cloud/firestore';
+import { BillingService } from './src/billing/index.js';
+
+async function testBilling() {
+  console.log('🧪 開始測試 BillingService...\n');
+
+  // 初始化 Firestore
+  const firestore = new Firestore({
+    projectId: process.env.GOOGLE_CLOUD_PROJECT ||
+              process.env.GCP_PROJECT ||
+              process.env.FIREBASE_PROJECT_ID,
+  });
+
+  // 初始化 BillingService
+  const billingService = new BillingService(firestore);
+  console.log('✅ BillingService 初始化成功\n');
+
+  // 測試 1: 記錄一筆測試資料
+  console.log('📝 測試 1: 記錄測試資料...');
+  try {
+    await billingService.recordUsage({
+      userId: 'test-user-123',
+      timestamp: new Date(),
+      endpoint: 'chat',
+      model: 'claude-haiku-4-5',
+      inputTokens: 100,
+      outputTokens: 50,
+      costUSD: 0.001,
+      conversationId: 'test-conv-123',
+      planType: 'pro',
+    });
+    console.log('✅ 測試資料記錄成功\n');
+  } catch (error) {
+    console.error('❌ 記錄失敗:', error);
+    process.exit(1);
+  }
+
+  // 測試 2: 查詢最近 7 天
+  console.log('📊 測試 2: 查詢最近 7 天...');
+  try {
+    const records = await billingService.getUserUsage('test-user-123', 7);
+    console.log(`✅ 找到 ${records.length} 筆記錄`);
+    if (records.length > 0) {
+      console.log('   最新一筆:', {
+        endpoint: records[0].endpoint,
+        model: records[0].model,
+        totalTokens: records[0].inputTokens + records[0].outputTokens,
+        costUSD: records[0].costUSD,
+      });
+    }
+    console.log('');
+  } catch (error) {
+    console.error('❌ 查詢失敗:', error);
+    process.exit(1);
+  }
+
+  // 測試 3: 查詢本月統計
+  console.log('📈 測試 3: 查詢本月統計...');
+  try {
+    const now = new Date();
+    const yearMonth = now.toISOString().substring(0, 7); // '2025-11'
+    const stats = await billingService.getMonthlyStats('test-user-123', yearMonth);
+    console.log(`✅ 本月統計 (${yearMonth}):`);
+    console.log(`   總 tokens: ${stats.totalTokens}`);
+    console.log(`   總成本: $${stats.costUSD}`);
+    console.log(`   模型分布:`, Object.fromEntries(stats.byModel));
+    console.log(`   端點分布:`, Object.fromEntries(stats.byEndpoint));
+    console.log('');
+  } catch (error) {
+    console.error('❌ 統計查詢失敗:', error);
+    process.exit(1);
+  }
+
+  console.log('🎉 所有測試通過！');
+  process.exit(0);
+}
+
+testBilling();

package/botrun-c/api/test-chat-upload.sh

@@ -0,0 +1,162 @@
+#!/bin/bash
+
+################################################################################
+# 測試完整的上傳 + Chat 多模態閱讀流程
+#
+# 模擬使用者行為：
+# 1. 上傳圖片
+# 2. 傳送自然語言訊息請求多模態解析
+################################################################################
+
+set -e
+
+# 顏色輸出
+GREEN='\033[0;32m'
+RED='\033[0;31m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+log_info() {
+  echo -e "${CYAN}ℹ️  $1${NC}"
+}
+
+log_success() {
+  echo -e "${GREEN}✅ $1${NC}"
+}
+
+log_error() {
+  echo -e "${RED}❌ $1${NC}"
+}
+
+log_section() {
+  echo ""
+  echo -e "${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+  echo -e "${CYAN}$1${NC}"
+  echo -e "${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+  echo ""
+}
+
+# 配置
+API_URL="http://localhost:8080"
+TEST_IMAGE="$1"
+
+if [ -z "$TEST_IMAGE" ]; then
+  log_error "請提供測試圖片路徑"
+  echo "用法: $0 /path/to/image.png"
+  exit 1
+fi
+
+if [ ! -f "$TEST_IMAGE" ]; then
+  log_error "測試圖片不存在: $TEST_IMAGE"
+  exit 1
+fi
+
+log_section "🧪 完整上傳 + Chat 多模態測試"
+
+# Step 1: 檢查 API Server
+log_info "Step 1/3: 檢查 API Server..."
+if ! curl -s "$API_URL/api/health" > /dev/null; then
+  log_error "API Server 未運行！請先執行: sh/server.sh"
+  exit 1
+fi
+log_success "API Server 運行中"
+echo ""
+
+# Step 2: 上傳檔案
+log_info "Step 2/3: 上傳測試圖片..."
+FILENAME=$(basename "$TEST_IMAGE")
+log_info "檔案: $FILENAME"
+
+UPLOAD_RESPONSE=$(curl -s -X POST "$API_URL/api/upload/direct" \
+  -H "Authorization: Bearer dummy-token-for-skip-auth" \
+  -F "file=@$TEST_IMAGE" \
+  -F "projectId=default")
+
+log_info "上傳回應:"
+echo "$UPLOAD_RESPONSE" | jq .
+
+if ! echo "$UPLOAD_RESPONSE" | jq -e '.success == true' > /dev/null; then
+  log_error "上傳失敗"
+  exit 1
+fi
+
+DISPLAY_PATH=$(echo "$UPLOAD_RESPONSE" | jq -r '.displayPath')
+log_success "上傳成功，displayPath: $DISPLAY_PATH"
+echo ""
+
+# Step 3: 傳送 Chat 訊息請求多模態解析
+log_info "Step 3/3: 傳送 Chat 請求..."
+
+# 組合使用者訊息（模擬前端行為）
+USER_MESSAGE="📄 ${FILENAME} - uploads/${FILENAME}
+
+請幫我多模態解析這張圖片的內容，包括文字、圖表、圖像等所有視覺元素。"
+
+log_info "使用者訊息:"
+echo "---"
+echo "$USER_MESSAGE"
+echo "---"
+echo ""
+
+# 建立 Chat 請求
+CHAT_REQUEST=$(cat <<EOF
+{
+  "messages": [
+    {
+      "role": "user",
+      "content": "$USER_MESSAGE"
+    }
+  ]
+}
+EOF
+)
+
+log_info "傳送 Chat 請求到 $API_URL/api/chat..."
+echo ""
+
+# 使用 curl 傳送請求並即時顯示 SSE 回應
+curl -N -X POST "$API_URL/api/chat" \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer dummy-token-for-skip-auth" \
+  -d "$CHAT_REQUEST" | while IFS= read -r line; do
+    # 移除 "data: " 前綴
+    if [[ "$line" == data:* ]]; then
+      json_data="${line#data: }"
+
+      # 解析並顯示
+      event_type=$(echo "$json_data" | jq -r '.type // empty' 2>/dev/null)
+
+      case "$event_type" in
+        "tool_use_start")
+          tool_name=$(echo "$json_data" | jq -r '.data.name // empty')
+          echo -e "${YELLOW}🔧 使用工具: $tool_name${NC}"
+          ;;
+        "tool_use_input")
+          tool_input=$(echo "$json_data" | jq -r '.data.input // empty')
+          echo -e "${CYAN}📥 工具輸入: $tool_input${NC}"
+          ;;
+        "tool_use_result")
+          echo -e "${GREEN}✅ 工具執行完成${NC}"
+          ;;
+        "text_delta")
+          text=$(echo "$json_data" | jq -r '.data.text // empty')
+          echo -n "$text"
+          ;;
+        "message_complete")
+          echo ""
+          echo ""
+          echo -e "${GREEN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+          echo -e "${GREEN}✅ Chat 回應完成${NC}"
+          echo -e "${GREEN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+          ;;
+        "error")
+          error_msg=$(echo "$json_data" | jq -r '.error // empty')
+          echo -e "${RED}❌ 錯誤: $error_msg${NC}"
+          ;;
+      esac
+    fi
+done
+
+echo ""
+log_success "測試完成"

package/botrun-c/api/test-nchc-whisper.ts

@@ -0,0 +1,87 @@
+#!/usr/bin/env tsx
+/**
+ * 測試國網中心 Whisper 轉錄功能
+ *
+ * 使用方式：
+ *   tsx test-nchc-whisper.ts <audio-file-path>
+ *
+ * 範例：
+ *   tsx test-nchc-whisper.ts /path/to/recording.webm
+ */
+import 'dotenv/config';
+import { transcribeWithNchcWhisper, NCHC_WHISPER_MODELS, NCHC_WHISPER_AVAILABLE } from './src/services/nchc-whisper.js';
+import { readFile } from 'fs/promises';
+import { basename } from 'path';
+
+async function main() {
+  console.log('🎤 國網中心 Whisper 轉錄測試\n');
+
+  // 檢查環境變數
+  if (!NCHC_WHISPER_AVAILABLE) {
+    console.error('❌ 錯誤：未設定 TAIDE_API_KEY 環境變數');
+    console.error('   請在 .env 檔案中設定：');
+    console.error('   TAIDE_API_KEY=sk-your-taide-api-key-here');
+    process.exit(1);
+  }
+
+  // 檢查命令列參數
+  const audioFilePath = process.argv[2];
+  if (!audioFilePath) {
+    console.error('❌ 錯誤：請提供音訊檔案路徑');
+    console.error('\n使用方式：');
+    console.error('  tsx test-nchc-whisper.ts <audio-file-path>');
+    console.error('\n範例：');
+    console.error('  tsx test-nchc-whisper.ts /path/to/recording.webm');
+    process.exit(1);
+  }
+
+  try {
+    // 讀取音訊檔案
+    console.log(`📂 讀取檔案：${audioFilePath}`);
+    const fileBuffer = await readFile(audioFilePath);
+    const fileName = basename(audioFilePath);
+
+    // 建立 File 物件
+    const blob = new Blob([fileBuffer], { type: 'audio/webm' });
+    const audioFile = new File([blob], fileName, { type: 'audio/webm' }) as any;
+
+    console.log(`📊 檔案資訊：`);
+    console.log(`   - 名稱：${fileName}`);
+    console.log(`   - 大小：${(fileBuffer.length / 1024).toFixed(2)} KB`);
+    console.log(`   - 類型：audio/webm`);
+    console.log();
+
+    // 測試所有模型
+    for (const [modelKey, modelName] of Object.entries(NCHC_WHISPER_MODELS)) {
+      console.log(`\n🔄 測試模型：${modelName}`);
+      console.log(`${'='.repeat(60)}`);
+
+      try {
+        const startTime = Date.now();
+        const transcription = await transcribeWithNchcWhisper(audioFile, modelName);
+        const duration = ((Date.now() - startTime) / 1000).toFixed(2);
+
+        console.log(`✅ 轉錄成功！耗時：${duration} 秒`);
+        console.log(`\n📝 轉錄結果：`);
+        console.log(`${'-'.repeat(60)}`);
+        console.log(transcription);
+        console.log(`${'-'.repeat(60)}`);
+      } catch (error) {
+        console.error(`❌ ${modelName} 轉錄失敗：`);
+        console.error(error instanceof Error ? error.message : String(error));
+      }
+    }
+
+    console.log(`\n✅ 測試完成！`);
+  } catch (error) {
+    console.error('\n❌ 測試失敗：');
+    console.error(error instanceof Error ? error.message : String(error));
+    if (error instanceof Error && error.stack) {
+      console.error('\n錯誤堆疊：');
+      console.error(error.stack);
+    }
+    process.exit(1);
+  }
+}
+
+main();

package/botrun-c/api/test-skills-loading.js

@@ -0,0 +1,77 @@
+/**
+ * 測試 Skills 載入功能
+ *
+ * 用法：
+ *   SKIP_AUTH=1 node test-skills-loading.js
+ */
+
+import { join } from 'path';
+import { existsSync, readFileSync, readdirSync } from 'fs';
+
+const isLocal = !process.env.CLOUD_RUN_SERVICE && !process.env.K_SERVICE;
+const userId = 'test-user';
+
+console.log('🔍 ========== Skills 載入測試 ==========');
+console.log(`🌍 Environment: ${isLocal ? 'LOCAL' : 'CLOUD_RUN'}`);
+console.log(`👤 User ID: ${userId}`);
+console.log('');
+
+// 官方 skills 路徑
+const officialSkillsDir = join(process.env.HOME || '/home/nodejs', '.claude', 'skills');
+console.log(`📁 Official skills path: ${officialSkillsDir}`);
+console.log(`   Exists: ${existsSync(officialSkillsDir) ? '✅ YES' : '❌ NO'}`);
+
+if (existsSync(officialSkillsDir)) {
+  const officialSkills = readdirSync(officialSkillsDir, { withFileTypes: true })
+    .filter(f => f.isDirectory());
+  console.log(`   Skills count: ${officialSkills.length}`);
+  officialSkills.forEach(skill => {
+    console.log(`     - ${skill.name}`);
+  });
+}
+console.log('');
+
+// 使用者 skills 路徑
+const userSkillsDir = isLocal
+  ? join(process.cwd(), '../data', userId, '.claude', 'skills')
+  : `/mnt/data/${userId}/.claude/skills`;
+
+console.log(`📁 User skills path: ${userSkillsDir}`);
+console.log(`   Exists: ${existsSync(userSkillsDir) ? '✅ YES' : '❌ NO'}`);
+
+if (existsSync(userSkillsDir)) {
+  const userSkills = readdirSync(userSkillsDir, { withFileTypes: true })
+    .filter(f => f.isDirectory());
+  console.log(`   Skills count: ${userSkills.length}`);
+  userSkills.forEach(skill => {
+    const skillPath = join(userSkillsDir, skill.name, 'SKILL.md');
+    const exists = existsSync(skillPath);
+    console.log(`     ${exists ? '✅' : '❌'} ${skill.name}`);
+
+    if (exists) {
+      try {
+        const content = readFileSync(skillPath, 'utf-8');
+        // 解析 frontmatter
+        const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
+        if (frontmatterMatch) {
+          const frontmatter = frontmatterMatch[1];
+          const nameMatch = frontmatter.match(/name:\s*(.+)/);
+          const descMatch = frontmatter.match(/description:\s*(.+)/);
+
+          if (nameMatch) {
+            console.log(`        Name: ${nameMatch[1]}`);
+          }
+          if (descMatch) {
+            console.log(`        Desc: ${descMatch[1]}`);
+          }
+        }
+        console.log(`        Size: ${content.length} bytes`);
+      } catch (error) {
+        console.log(`        ⚠️ Cannot read: ${error.message}`);
+      }
+    }
+  });
+}
+
+console.log('');
+console.log('✅ 測試完成');

package/botrun-c/api/test-skills-symlink.js

@@ -0,0 +1,118 @@
+/**
+ * 測試使用者 Skills 符號連結功能
+ *
+ * 用法：
+ *   node test-skills-symlink.js
+ */
+
+import { join } from 'path';
+import { existsSync, readdirSync, lstatSync, readlinkSync } from 'fs';
+import { mkdir, symlink, unlink } from 'fs/promises';
+
+const isLocal = !process.env.CLOUD_RUN_SERVICE && !process.env.K_SERVICE;
+const userId = 'test-user';
+
+console.log('🔍 ========== Skills Symlink 測試 ==========');
+console.log(`🌍 Environment: ${isLocal ? 'LOCAL' : 'CLOUD_RUN'}`);
+console.log(`👤 User ID: ${userId}`);
+console.log('');
+
+// 設定路徑
+const userDataRoot = isLocal
+  ? join(process.cwd(), '..', 'data', userId)
+  : `/mnt/data/${userId}`;
+
+const workingDir = join(userDataRoot, 'projects', 'default');
+const userSkillsSource = join(userDataRoot, '.claude', 'skills');
+
+const projectSkillsTarget = join(workingDir, '.claude', 'skills');
+
+console.log('📁 路徑配置：');
+console.log(`   Working Dir: ${workingDir}`);
+console.log(`   Skills Source: ${userSkillsSource}`);
+console.log(`   Skills Target: ${projectSkillsTarget}`);
+console.log('');
+
+// 檢查來源是否存在
+console.log('🔍 檢查來源目錄：');
+const sourceExists = existsSync(userSkillsSource);
+console.log(`   ${sourceExists ? '✅' : '❌'} ${userSkillsSource}`);
+
+if (sourceExists) {
+  const skills = readdirSync(userSkillsSource, { withFileTypes: true })
+    .filter(f => f.isDirectory());
+  console.log(`   Skills count: ${skills.length}`);
+  skills.forEach(skill => {
+    console.log(`     - ${skill.name}`);
+  });
+}
+console.log('');
+
+// 建立符號連結
+console.log('🔗 建立符號連結...');
+
+async function setupSymlink() {
+  try {
+    // 建立 .claude 目錄
+    await mkdir(join(workingDir, '.claude'), { recursive: true });
+    console.log('✅ Created .claude directory');
+
+    // 如果目標已存在，先刪除
+    if (existsSync(projectSkillsTarget)) {
+      const stats = lstatSync(projectSkillsTarget);
+      if (stats.isSymbolicLink()) {
+        const linkTarget = readlinkSync(projectSkillsTarget);
+        console.log(`   Existing symlink found: ${projectSkillsTarget} -> ${linkTarget}`);
+      }
+      await unlink(projectSkillsTarget);
+      console.log('✅ Removed existing symlink/directory');
+    }
+
+    // 建立符號連結
+    if (sourceExists) {
+      await symlink(userSkillsSource, projectSkillsTarget, 'dir');
+      console.log('✅ Symlink created successfully');
+    } else {
+      console.log('⚠️  Source directory does not exist, skipping symlink creation');
+      return;
+    }
+
+    // 驗證符號連結
+    console.log('');
+    console.log('🔍 驗證符號連結：');
+    const targetExists = existsSync(projectSkillsTarget);
+    console.log(`   ${targetExists ? '✅' : '❌'} Target exists: ${projectSkillsTarget}`);
+
+    if (targetExists) {
+      const stats = lstatSync(projectSkillsTarget);
+      console.log(`   Is symlink: ${stats.isSymbolicLink() ? '✅ YES' : '❌ NO'}`);
+
+      if (stats.isSymbolicLink()) {
+        const linkTarget = readlinkSync(projectSkillsTarget);
+        console.log(`   Links to: ${linkTarget}`);
+        console.log(`   Matches source: ${linkTarget === userSkillsSource ? '✅ YES' : '❌ NO'}`);
+      }
+
+      // 列出符號連結中的 skills
+      const skills = readdirSync(projectSkillsTarget, { withFileTypes: true })
+        .filter(f => f.isDirectory());
+      console.log(`   Skills count: ${skills.length}`);
+      skills.forEach(skill => {
+        console.log(`     - ${skill.name}`);
+      });
+    }
+  } catch (error) {
+    console.error('❌ Error:', error.message);
+  }
+}
+
+await setupSymlink();
+
+console.log('');
+console.log('✅ 測試完成');
+console.log('');
+console.log('📝 settingSources 配置說明：');
+console.log('   settingSources: [\'user\', \'project\']');
+console.log('   - \'user\': 從 ~/.claude/skills/ 載入官方 skills');
+console.log(`   - 'project': 從 ${projectSkillsTarget} 載入使用者 skills`);
+console.log('   - 符號連結確保使用者 skills 能被 SDK 正確載入');

package/botrun-c/api/test-upload-multimodal.sh

@@ -0,0 +1,167 @@
+#!/bin/bash
+
+################################################################################
+# 測試上傳和多模態閱讀功能
+#
+# 驗證：
+# 1. 檔案上傳到正確的 uploads/ 目錄
+# 2. multimodal-reader 能正確讀取檔案
+# 3. 本地開發和生產環境路徑一致
+################################################################################
+
+set -e
+
+# 顏色輸出
+GREEN='\033[0;32m'
+RED='\033[0;31m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+log_info() {
+  echo -e "${CYAN}ℹ️  $1${NC}"
+}
+
+log_success() {
+  echo -e "${GREEN}✅ $1${NC}"
+}
+
+log_error() {
+  echo -e "${RED}❌ $1${NC}"
+}
+
+log_section() {
+  echo ""
+  echo -e "${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+  echo -e "${CYAN}$1${NC}"
+  echo -e "${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+  echo ""
+}
+
+# 配置
+PROJECT_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+API_URL="http://localhost:8080"
+TEST_USER="test-user"
+TEST_IMAGE="$1"  # 從參數讀取測試圖片路徑
+
+if [ -z "$TEST_IMAGE" ]; then
+  log_error "請提供測試圖片路徑"
+  echo "用法: $0 /path/to/image.png"
+  exit 1
+fi
+
+if [ ! -f "$TEST_IMAGE" ]; then
+  log_error "測試圖片不存在: $TEST_IMAGE"
+  exit 1
+fi
+
+log_section "🧪 上傳和多模態閱讀測試"
+
+# Step 1: 檢查 API Server 是否運行
+log_info "Step 1/5: 檢查 API Server..."
+if ! curl -s "$API_URL/api/health" > /dev/null; then
+  log_error "API Server 未運行！請先執行: sh/server.sh"
+  exit 1
+fi
+log_success "API Server 運行中"
+
+# Step 2: 上傳檔案
+log_info "Step 2/5: 上傳測試圖片..."
+FILENAME=$(basename "$TEST_IMAGE")
+log_info "檔案名稱: $FILENAME"
+
+UPLOAD_RESPONSE=$(curl -s -X POST "$API_URL/api/upload/direct" \
+  -H "Authorization: Bearer dummy-token-for-skip-auth" \
+  -F "file=@$TEST_IMAGE" \
+  -F "projectId=default")
+
+echo "$UPLOAD_RESPONSE" | jq .
+
+# 檢查上傳是否成功
+if ! echo "$UPLOAD_RESPONSE" | jq -e '.success == true' > /dev/null; then
+  log_error "上傳失敗"
+  exit 1
+fi
+
+DISPLAY_PATH=$(echo "$UPLOAD_RESPONSE" | jq -r '.displayPath')
+log_success "上傳成功"
+log_info "displayPath: $DISPLAY_PATH"
+
+# Step 3: 驗證檔案實際位置
+log_info "Step 3/5: 驗證檔案位置..."
+EXPECTED_PATH="${PROJECT_ROOT}/api/data/${TEST_USER}/projects/default/uploads/${FILENAME}"
+log_info "預期路徑: $EXPECTED_PATH"
+
+if [ ! -f "$EXPECTED_PATH" ]; then
+  log_error "檔案不在預期位置！"
+  log_info "檢查實際位置..."
+  find "${PROJECT_ROOT}/api/data/${TEST_USER}" -name "$FILENAME" -type f
+  exit 1
+fi
+log_success "檔案位置正確: uploads/$FILENAME"
+
+# Step 4: 測試 multimodal-reader 直接呼叫
+log_info "Step 4/5: 測試 multimodal-reader..."
+
+# 檢查 MCP Server 是否存在
+MCP_SERVER="${PROJECT_ROOT}/botrun-mcp-servers/multimodal-reader/dist/index.js"
+if [ ! -f "$MCP_SERVER" ]; then
+  log_error "MCP Server 不存在: $MCP_SERVER"
+  exit 1
+fi
+
+# 測試路徑（相對於工作目錄）
+WORK_DIR="${PROJECT_ROOT}/api/data/${TEST_USER}/projects/default"
+TEST_PATH="uploads/${FILENAME}"
+
+log_info "工作目錄: $WORK_DIR"
+log_info "測試路徑: $TEST_PATH"
+
+# 建立測試輸入
+TEST_INPUT=$(cat <<EOF
+{
+  "jsonrpc": "2.0",
+  "id": 1,
+  "method": "tools/call",
+  "params": {
+    "name": "read_multimodal",
+    "arguments": {
+      "filePaths": "$TEST_PATH",
+      "prompt": "請簡述這張圖片的內容"
+    }
+  }
+}
+EOF
+)
+
+log_info "MCP 輸入:"
+echo "$TEST_INPUT" | jq .
+
+# 執行 MCP Server（設定工作目錄）
+cd "$WORK_DIR"
+MCP_RESPONSE=$(echo "$TEST_INPUT" | node "$MCP_SERVER" 2>&1 | tail -1)
+
+log_info "MCP 回應:"
+echo "$MCP_RESPONSE" | jq . 2>/dev/null || echo "$MCP_RESPONSE"
+
+# 檢查是否成功
+if echo "$MCP_RESPONSE" | jq -e '.result.content' > /dev/null 2>&1; then
+  log_success "multimodal-reader 成功讀取檔案"
+else
+  log_error "multimodal-reader 執行失敗"
+  exit 1
+fi
+
+# Step 5: 清理測試檔案（選擇性）
+log_info "Step 5/5: 測試完成"
+log_info "測試檔案保留在: $EXPECTED_PATH"
+echo ""
+log_success "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+log_success "✅ 所有測試通過！"
+log_success "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+log_info "驗證結果："
+log_info "  1. ✅ 檔案上傳到正確的 uploads/ 目錄"
+log_info "  2. ✅ displayPath 回傳正確（檔名）"
+log_info "  3. ✅ multimodal-reader 能正確讀取 uploads/檔名"
+log_info "  4. ✅ 路徑結構統一（本地與生產環境一致）"