botrun-horse 2.30.0 → 2.34.0

package/botrun-c/dev/mcp-token-calculator/optimization-proposals.ts

@@ -1,316 +0,0 @@
-/**
- * MCP Tool Definitions 優化方案比較
- *
- * 目標：將 web_search (1,934 tokens) 和 read_multimodal (647 tokens) 濃縮至原本的 1/10
- */
-
-// ============================================================================
-// 方案 A：極簡版 (Ultra-Minimal)
-// ============================================================================
-
-const PROPOSAL_A = {
-  web_search: {
-    name: 'web_search',
-    description: 'Search web using Brave Search via Claude Haiku 4.5 (Taiwan). Supports domain filtering and localization.',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        queries: {
-          type: ['string', 'array'],
-          description: 'Search query or array of queries',
-          items: { type: 'string' },
-        },
-        max_uses: {
-          type: 'number',
-          description: 'Max searches per conversation',
-        },
-        allowed_domains: {
-          type: 'array',
-          items: { type: 'string' },
-          description: 'Whitelist domains (e.g., ["gov.tw", "edu.tw"])',
-        },
-        blocked_domains: {
-          type: 'array',
-          items: { type: 'string' },
-          description: 'Blacklist domains',
-        },
-        user_location: {
-          type: 'object',
-          properties: {
-            type: { type: 'string', enum: ['approximate'] },
-            city: { type: 'string' },
-            region: { type: 'string' },
-            country: { type: 'string' },
-            timezone: { type: 'string' },
-          },
-          description: 'Localize results (e.g., {city:"Taipei",country:"TW"})',
-        },
-      },
-      required: ['queries'],
-    },
-  },
-
-  read_multimodal: {
-    name: 'read_multimodal',
-    description: 'Read PDF/images/video/audio via Claude Haiku 4.5 (Taiwan). Max 30 files, supports wildcards.',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        filePaths: {
-          type: ['string', 'array'],
-          description: 'File path(s). Supports: PDF, PNG, JPG, WebP, MP4, MOV, WebM, MP3, WAV, AAC, etc.',
-          items: { type: 'string' },
-        },
-        prompt: {
-          type: 'string',
-          description: 'Question or analysis instruction',
-        },
-      },
-      required: ['filePaths'],
-    },
-  },
-};
-
-// ============================================================================
-// 方案 B：精簡實用版 (Balanced Practical)
-// ============================================================================
-
-const PROPOSAL_B = {
-  web_search: {
-    name: 'web_search',
-    description: 'Web search (Brave + Claude Haiku 4.5, Taiwan endpoint). Returns TC summary + citations.',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        queries: {
-          type: ['string', 'array'],
-          description: 'Query string or array. Ex: "台灣新聞" or ["新聞","天氣","股市"]',
-          items: { type: 'string' },
-        },
-        max_uses: {
-          type: 'number',
-          description: 'Limit searches per conversation. Ex: 3',
-        },
-        allowed_domains: {
-          type: 'array',
-          items: { type: 'string' },
-          description: 'Whitelist. Ex: ["gov.tw","edu.tw"] for official sites only',
-        },
-        blocked_domains: {
-          type: 'array',
-          items: { type: 'string' },
-          description: 'Blacklist. Ex: ["spam.com"]',
-        },
-        user_location: {
-          type: 'object',
-          properties: {
-            type: { type: 'string', enum: ['approximate'] },
-            city: { type: 'string' },
-            region: { type: 'string' },
-            country: { type: 'string' },
-            timezone: { type: 'string' },
-          },
-          description: 'Localize. Ex: {type:"approximate",city:"Taipei",country:"TW",timezone:"Asia/Taipei"}',
-        },
-      },
-      required: ['queries'],
-    },
-  },
-
-  read_multimodal: {
-    name: 'read_multimodal',
-    description: 'Multimodal reader (Claude Haiku 4.5, Taiwan). Doc: PDF/TXT. Image: PNG/JPG/WebP. Video: MP4/MOV/WebM. Audio: MP3/WAV/AAC. Max 30 files, glob support.',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        filePaths: {
-          type: ['string', 'array'],
-          description: 'Path(s). String or array. Wildcards OK. Ex: "*.pdf" or ["doc.pdf","video.mp4"]',
-          items: { type: 'string' },
-        },
-        prompt: {
-          type: 'string',
-          description: 'Optional. Question to ask about the content.',
-        },
-      },
-      required: ['filePaths'],
-    },
-  },
-};
-
-// ============================================================================
-// 方案 C：關鍵字版 (Keyword-Optimized)
-// ============================================================================
-
-const PROPOSAL_C = {
-  web_search: {
-    name: 'web_search',
-    description: 'Brave search via Claude Haiku 4.5 TW. TC output.',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        queries: {
-          type: ['string', 'array'],
-          description: 'Query(s)',
-          items: { type: 'string' },
-        },
-        max_uses: { type: 'number', description: 'Max searches' },
-        allowed_domains: {
-          type: 'array',
-          items: { type: 'string' },
-          description: 'Whitelist (gov.tw, edu.tw...)',
-        },
-        blocked_domains: {
-          type: 'array',
-          items: { type: 'string' },
-          description: 'Blacklist',
-        },
-        user_location: {
-          type: 'object',
-          properties: {
-            type: { type: 'string', enum: ['approximate'] },
-            city: { type: 'string' },
-            region: { type: 'string' },
-            country: { type: 'string' },
-            timezone: { type: 'string' },
-          },
-          description: 'Geo context',
-        },
-      },
-      required: ['queries'],
-    },
-  },
-
-  read_multimodal: {
-    name: 'read_multimodal',
-    description: 'Read media via Claude Haiku 4.5 TW. PDF/img/video/audio. Max 30.',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        filePaths: {
-          type: ['string', 'array'],
-          description: 'Path(s). Glob OK.',
-          items: { type: 'string' },
-        },
-        prompt: { type: 'string', description: 'Question' },
-      },
-      required: ['filePaths'],
-    },
-  },
-};
-
-// ============================================================================
-// Token 計算
-// ============================================================================
-
-import { encoding_for_model } from 'tiktoken';
-
-const encoder = encoding_for_model('gpt-4');
-
-function countTokens(obj: any): number {
-  const json = JSON.stringify(obj, null, 2);
-  const tokens = encoder.encode(json);
-  return tokens.length;
-}
-
-function analyzeProposal(name: string, proposal: any) {
-  const webSearchTokens = countTokens(proposal.web_search);
-  const readMultimodalTokens = countTokens(proposal.read_multimodal);
-  const totalTokens = webSearchTokens + readMultimodalTokens;
-
-  console.log(`\n${'='.repeat(80)}`);
-  console.log(`${name}`);
-  console.log(`${'='.repeat(80)}`);
-  console.log(`web_search:        ${webSearchTokens.toString().padStart(4)} tokens (原: 1,934 tokens, 減少 ${1934 - webSearchTokens} tokens, ${(((1934 - webSearchTokens) / 1934) * 100).toFixed(1)}%)`);
-  console.log(`read_multimodal:   ${readMultimodalTokens.toString().padStart(4)} tokens (原: 647 tokens, 減少 ${647 - readMultimodalTokens} tokens, ${(((647 - readMultimodalTokens) / 647) * 100).toFixed(1)}%)`);
-  console.log(`合計:              ${totalTokens.toString().padStart(4)} tokens (原: 2,581 tokens, 減少 ${2581 - totalTokens} tokens, ${(((2581 - totalTokens) / 2581) * 100).toFixed(1)}%)`);
-
-  return {
-    webSearchTokens,
-    readMultimodalTokens,
-    totalTokens,
-    reduction: ((2581 - totalTokens) / 2581) * 100,
-  };
-}
-
-// ============================================================================
-// 主程式
-// ============================================================================
-
-console.log('\n' + '█'.repeat(80));
-console.log('📊 MCP Tool Definitions 優化方案比較');
-console.log('█'.repeat(80));
-console.log('\n目標：將 web_search (1,934 tokens) 和 read_multimodal (647 tokens) 濃縮至 1/10');
-
-const resultA = analyzeProposal('方案 A：極簡版 (Ultra-Minimal)', PROPOSAL_A);
-const resultB = analyzeProposal('方案 B：精簡實用版 (Balanced Practical)', PROPOSAL_B);
-const resultC = analyzeProposal('方案 C：關鍵字版 (Keyword-Optimized)', PROPOSAL_C);
-
-console.log(`\n${'='.repeat(80)}`);
-console.log('📊 總結比較');
-console.log(`${'='.repeat(80)}`);
-console.log('\n| 方案 | web_search | read_multimodal | 合計 | 減少比例 |');
-console.log('|------|----------:|----------------:|-----:|---------:|');
-console.log(`| 原版 |     1,934 |             647 | 2,581|     0.0% |`);
-console.log(`| A 極簡 |     ${resultA.webSearchTokens.toString().padStart(5)} |             ${resultA.readMultimodalTokens.toString().padStart(3)} | ${resultA.totalTokens.toString().padStart(5)}|   ${resultA.reduction.toFixed(1)}% |`);
-console.log(`| B 平衡 |     ${resultB.webSearchTokens.toString().padStart(5)} |             ${resultB.readMultimodalTokens.toString().padStart(3)} | ${resultB.totalTokens.toString().padStart(5)}|   ${resultB.reduction.toFixed(1)}% |`);
-console.log(`| C 關鍵字 |     ${resultC.webSearchTokens.toString().padStart(5)} |             ${resultC.readMultimodalTokens.toString().padStart(3)} | ${resultC.totalTokens.toString().padStart(5)}|   ${resultC.reduction.toFixed(1)}% |`);
-
-console.log(`\n${'='.repeat(80)}`);
-console.log('🎯 方案評分與建議 (1-10 分)');
-console.log(`${'='.repeat(80)}`);
-
-console.log('\n【方案 A：極簡版】');
-console.log('✅ 優點：');
-console.log('   - Token 節省最多');
-console.log('   - 使用英文，國際化較佳');
-console.log('   - Schema 仍然完整，Claude 可理解');
-console.log('❌ 缺點：');
-console.log('   - 範例較少，使用者需要更多學習成本');
-console.log('   - 中文使用者可能不習慣英文描述');
-console.log('   - 缺少使用情境說明');
-console.log('📊 評分：');
-console.log('   - Token 效率: 9/10');
-console.log('   - 可用性: 6/10');
-console.log('   - 維護性: 8/10');
-console.log('   - 綜合評分: 7.5/10');
-
-console.log('\n【方案 B：精簡實用版】');
-console.log('✅ 優點：');
-console.log('   - 平衡 token 節省與可用性');
-console.log('   - 保留關鍵範例');
-console.log('   - 使用縮寫但仍清晰 (Ex: TC = Traditional Chinese)');
-console.log('❌ 缺點：');
-console.log('   - 仍使用英文，中文使用者可能需要適應');
-console.log('   - 範例較簡化，複雜情境可能需要查文件');
-console.log('📊 評分：');
-console.log('   - Token 效率: 8/10');
-console.log('   - 可用性: 8/10');
-console.log('   - 維護性: 9/10');
-console.log('   - 綜合評分: 8.5/10 ⭐ 推薦');
-
-console.log('\n【方案 C：關鍵字版】');
-console.log('✅ 優點：');
-console.log('   - Token 節省最激進');
-console.log('   - 極度精簡，適合 API 呼叫');
-console.log('   - Schema 結構完整');
-console.log('❌ 缺點：');
-console.log('   - 可讀性較差，使用門檻高');
-console.log('   - 缺少範例，使用者容易犯錯');
-console.log('   - 縮寫過多 (TW, TC, Geo) 需要額外解釋');
-console.log('📊 評分：');
-console.log('   - Token 效率: 10/10');
-console.log('   - 可用性: 5/10');
-console.log('   - 維護性: 6/10');
-console.log('   - 綜合評分: 7/10');
-
-console.log(`\n${'='.repeat(80)}`);
-console.log('💡 最終建議');
-console.log(`${'='.repeat(80)}`);
-console.log('\n如果你的優先級是：');
-console.log('1️⃣  【省最多 Token】→ 選擇方案 C (減少 87.3%)');
-console.log('2️⃣  【平衡效率與可用性】→ 選擇方案 B (減少 84.9%) ⭐ 推薦');
-console.log('3️⃣  【保持可讀性】→ 選擇方案 A (減少 82.4%)');
-console.log('\n建議：採用方案 B，可以在 token 效率和使用體驗之間取得最佳平衡。');
-
-encoder.free();