botrun-horse 2.29.2 → 2.30.0

package/botrun-c/.claude/skills//347/266/262/350/267/257/346/220/234/345/260/213/346/212/200/350/203/275/SKILL.md

@@ -0,0 +1,156 @@
+---
+name: 網路搜尋技能
+description: 網路搜尋服務。當使用者需要「上網搜尋」、「查詢最新資訊」、「搜尋網頁」、「找資料」、「查新聞」、「看天氣」時使用。支援多關鍵字平行搜尋，大幅提升效率。(v5.1206.1300)
+allowed-tools: Bash
+---
+
+# 🔍 網路搜尋技能
+
+## 觸發條件
+- 使用者說「上網搜尋」、「幫我查」、「搜尋」、「找資料」
+- 需要最新資訊（新聞、天氣、股價、時事等）
+- 需要驗證網路上的資訊
+- 使用者問「現在」、「最新」、「今天」相關問題
+
+---
+
+## ⚡ 問題複雜度判斷與搜尋策略
+
+根據問題複雜度，選擇適當的搜尋策略：
+
+### 🟢 簡單問題（1 個關鍵字）
+**特徵**：單一明確的查詢，不需要比較或綜合多方資訊
+
+**範例**：
+- 「今天台北天氣如何？」
+- 「台積電現在股價多少？」
+- 「最新的 iPhone 是哪一款？」
+
+**執行**：
+```bash
+node $OFFICIAL_SKILLS_DIR/網路搜尋技能/scripts/search.mjs "台北天氣"
+```
+
+---
+
+### 🟡 中等問題（2-3 個關鍵字平行搜尋）
+**特徵**：需要比較多個項目，或從不同角度了解同一主題
+
+**範例**：
+- 「台積電跟三星的晶片技術比較」→ 拆成 2 個搜尋
+- 「北部這週末適合去哪玩？」→ 拆成 3 個搜尋（天氣 + 景點 + 活動）
+
+**執行**：
+```bash
+# 範例：比較台積電和三星
+node $OFFICIAL_SKILLS_DIR/網路搜尋技能/scripts/search.mjs "台積電 2nm 製程進度" "三星 GAA 技術現況"
+
+# 範例：週末規劃
+node $OFFICIAL_SKILLS_DIR/網路搜尋技能/scripts/search.mjs "北部週末天氣" "北部熱門景點推薦" "台北週末活動"
+```
+
+---
+
+### 🔴 複雜問題（4-5 個關鍵字平行搜尋）
+**特徵**：需要全面分析、多維度比較、或深入研究某主題
+
+**範例**：
+- 「2024年AI產業趨勢分析報告」→ 拆成 5 個子問題
+- 「想了解電動車市場，該買特斯拉還是其他品牌？」→ 拆成 5 個搜尋
+
+**拆解方法**：
+1. 先識別問題的核心面向
+2. 每個面向設計一個精準的搜尋關鍵字
+3. 一次平行執行所有搜尋
+
+**執行**：
+```bash
+# 範例：AI 產業分析
+node $OFFICIAL_SKILLS_DIR/網路搜尋技能/scripts/search.mjs \
+  "2024 AI 產業市場規模" \
+  "ChatGPT Claude 競爭分析" \
+  "AI 晶片需求趨勢" \
+  "企業 AI 應用案例" \
+  "AI 法規政策最新發展"
+
+# 範例：電動車購買決策
+node $OFFICIAL_SKILLS_DIR/網路搜尋技能/scripts/search.mjs \
+  "特斯拉 Model 3 優缺點" \
+  "BYD 電動車台灣評價" \
+  "電動車充電站分佈" \
+  "電動車補助政策 2024" \
+  "電動車保養費用比較"
+```
+
+---
+
+## 📋 問題拆解指引
+
+**拆解原則**：
+1. **MECE**：子問題互不重疊，合起來涵蓋完整
+2. **具體**：每個關鍵字要明確，避免太籠統
+3. **可搜尋**：使用網路上容易找到的詞彙
+
+**常見拆解模式**：
+
+| 問題類型 | 拆解維度 | 範例 |
+|----------|----------|------|
+| 比較型 | A vs B vs C | 「iPhone vs Samsung vs Pixel」 |
+| 決策型 | 優點、缺點、價格、評價 | 「產品優點」「產品缺點」「使用者評價」 |
+| 分析型 | 現狀、趨勢、影響、預測 | 「市場現狀」「發展趨勢」「未來預測」 |
+| 規劃型 | 時間、地點、預算、活動 | 「天氣」「景點」「交通」「餐廳」 |
+
+---
+
+## 進階選項
+
+```bash
+# 限制搜尋深度（預設 3 次）
+node $OFFICIAL_SKILLS_DIR/網路搜尋技能/scripts/search.mjs "關鍵字" --max-uses 5
+
+# 限制只搜尋特定網域
+node $OFFICIAL_SKILLS_DIR/網路搜尋技能/scripts/search.mjs "關鍵字" --allowed-domains "gov.tw,edu.tw"
+
+# 排除特定網域
+node $OFFICIAL_SKILLS_DIR/網路搜尋技能/scripts/search.mjs "關鍵字" --blocked-domains "example.com"
+```
+
+---
+
+## 輸出格式
+
+腳本會輸出 Markdown 格式的搜尋結果：
+
+```markdown
+🔍 開始平行搜尋 3 個關鍵字...
+
+  ✓ [1/3] 關鍵字1
+  ✓ [2/3] 關鍵字2
+  ✓ [3/3] 關鍵字3
+
+⏱️  完成！耗時 2.5 秒
+
+═══════════════════════════════════════════════
+📊 搜尋結果
+═══════════════════════════════════════════════
+
+### 🔎 關鍵字1
+{搜尋結果摘要}
+
+**引用來源：**
+1. [標題](URL)
+2. [標題](URL)
+
+────────────────────────────────────────────────
+
+### 🔎 關鍵字2
+...
+```
+
+---
+
+## ⚠️ 注意事項
+- **效能提示**：多個搜尋請一次呼叫，不要分開呼叫
+- 最多支援 10 個關鍵字平行搜尋
+- 搜尋結果已經是繁體中文，不需要再翻譯
+- 搜尋使用台灣端點（asia-east1），結果偏向台灣地區

package/botrun-c/.claude/skills//347/266/262/350/267/257/346/220/234/345/260/213/346/212/200/350/203/275/scripts/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "scripts",
+  "version": "1.0.0",
+  "description": "",
+  "main": "search.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "type": "commonjs",
+  "dependencies": {
+    "@anthropic-ai/vertex-sdk": "^0.14.0"
+  }
+}

package/botrun-c/.claude/skills//347/266/262/350/267/257/346/220/234/345/260/213/346/212/200/350/203/275/scripts/search.js

@@ -0,0 +1,139 @@
+#!/usr/bin/env npx tsx
+"use strict";
+/**
+ * 網路搜尋腳本 - 使用 Vertex AI + Brave Search
+ *
+ * Usage:
+ *   npx tsx search.ts "查詢關鍵字"
+ *   npx tsx search.ts "關鍵字" --max-uses 3
+ *   npx tsx search.ts "關鍵字" --allowed-domains "gov.tw,edu.tw"
+ *   npx tsx search.ts "關鍵字" --blocked-domains "example.com"
+ *
+ * 環境變數：
+ *   GOOGLE_CLOUD_PROJECT - GCP 專案 ID（預設：botrun-c）
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const vertex_sdk_1 = __importDefault(require("@anthropic-ai/vertex-sdk"));
+// 解析命令列參數
+const args = process.argv.slice(2);
+const query = args[0];
+if (!query || query.startsWith('--')) {
+    console.error('❌ 請提供搜尋關鍵字');
+    console.error('');
+    console.error('Usage: npx tsx search.ts "關鍵字" [options]');
+    console.error('');
+    console.error('Options:');
+    console.error('  --max-uses <number>        限制搜尋次數（預設 5）');
+    console.error('  --allowed-domains <list>   只搜尋特定網域（逗號分隔）');
+    console.error('  --blocked-domains <list>   排除特定網域（逗號分隔）');
+    console.error('');
+    console.error('Examples:');
+    console.error('  npx tsx search.ts "台灣天氣"');
+    console.error('  npx tsx search.ts "政府公告" --allowed-domains "gov.tw"');
+    process.exit(1);
+}
+const options = {
+    maxUses: 5,
+};
+for (let i = 1; i < args.length; i += 2) {
+    const flag = args[i];
+    const value = args[i + 1];
+    if (!value) {
+        console.error(`❌ 選項 ${flag} 需要一個值`);
+        process.exit(1);
+    }
+    switch (flag) {
+        case '--max-uses':
+            options.maxUses = parseInt(value, 10);
+            if (isNaN(options.maxUses) || options.maxUses < 1) {
+                console.error('❌ --max-uses 必須是正整數');
+                process.exit(1);
+            }
+            break;
+        case '--allowed-domains':
+            options.allowedDomains = value.split(',').map((d) => d.trim());
+            break;
+        case '--blocked-domains':
+            options.blockedDomains = value.split(',').map((d) => d.trim());
+            break;
+        default:
+            console.error(`❌ 未知選項: ${flag}`);
+            process.exit(1);
+    }
+}
+async function search() {
+    const projectId = process.env.GOOGLE_CLOUD_PROJECT || 'botrun-c';
+    const region = 'asia-east1'; // 台灣端點
+    const client = new vertex_sdk_1.default({
+        projectId,
+        region,
+    });
+    // 建立 web_search tool 配置
+    const toolConfig = {
+        type: 'web_search_20250305',
+        name: 'web_search',
+        max_uses: options.maxUses,
+    };
+    if (options.allowedDomains && options.allowedDomains.length > 0) {
+        toolConfig.allowed_domains = options.allowedDomains;
+    }
+    if (options.blockedDomains && options.blockedDomains.length > 0) {
+        toolConfig.blocked_domains = options.blockedDomains;
+    }
+    try {
+        // 呼叫 API 時需要加入 beta header 才能使用 web_search
+        const response = await client.messages.create({
+            model: 'claude-haiku-4-5@20251001',
+            max_tokens: 4096,
+            tools: [toolConfig],
+            messages: [
+                {
+                    role: 'user',
+                    content: `請使用 web search 搜尋以下內容，並用繁體中文總結搜尋結果：${query}`,
+                },
+            ],
+        }, {
+            headers: {
+                'anthropic-beta': 'web-search-2025-03-05',
+            },
+        });
+        // 提取文字回應
+        const textBlocks = response.content.filter((b) => b.type === 'text');
+        const result = textBlocks.map((b) => b.text).join('\n');
+        const citations = [];
+        for (const block of response.content) {
+            if (block.type === 'text' && block.citations) {
+                citations.push(...block.citations);
+            }
+        }
+        // 輸出 Markdown 格式
+        console.log(`## 搜尋結果：${query}\n`);
+        console.log(result);
+        if (citations.length > 0) {
+            console.log('\n### 引用來源\n');
+            citations.forEach((c, i) => {
+                const title = c.title || '來源';
+                const citedText = c.cited_text ? ` - "${c.cited_text}"` : '';
+                console.log(`${i + 1}. [${title}](${c.url})${citedText}`);
+            });
+        }
+        // 輸出 token 使用量（debug 用）
+        if (process.env.DEBUG) {
+            console.log('\n---');
+            console.log(`Token 使用量: 輸入 ${response.usage.input_tokens}, 輸出 ${response.usage.output_tokens}`);
+        }
+    }
+    catch (error) {
+        console.error(`\n❌ 搜尋失敗：${error.message}`);
+        if (error.message.includes('authentication')) {
+            console.error('\n提示：請確認已設定 Google Cloud 認證');
+            console.error('  gcloud auth application-default login');
+        }
+        process.exit(1);
+    }
+}
+// 執行搜尋
+search();

package/botrun-c/.claude/skills//347/266/262/350/267/257/346/220/234/345/260/213/346/212/200/350/203/275/scripts/search.mjs

@@ -0,0 +1,272 @@
+#!/usr/bin/env node
+/**
+ * 網路搜尋腳本 - 支援多關鍵字平行搜尋
+ *
+ * 使用方式：
+ *   # 單一關鍵字（簡單問題）
+ *   node search.mjs "台灣天氣"
+ *
+ *   # 多關鍵字平行搜尋（中等/複雜問題）
+ *   node search.mjs "關鍵字1" "關鍵字2" "關鍵字3"
+ *
+ *   # 進階選項
+ *   node search.mjs "關鍵字" --max-uses 3
+ *   node search.mjs "關鍵字" --allowed-domains "gov.tw,edu.tw"
+ *
+ * 環境變數：
+ *   GOOGLE_CLOUD_PROJECT - GCP 專案 ID（預設：botrun-c）
+ */
+
+import Anthropic from '@anthropic-ai/vertex-sdk';
+
+// ============ 常數 ============
+const MAX_CONCURRENT = 5;        // 最大並行數（避免 rate limit）
+const MAX_QUERIES = 10;          // 單次最多關鍵字數
+
+// ============ Semaphore 併發控制 ============
+class Semaphore {
+  constructor(max) {
+    this.max = max;
+    this.count = 0;
+    this.queue = [];
+  }
+
+  async acquire() {
+    if (this.count < this.max) {
+      this.count++;
+      return;
+    }
+    await new Promise(resolve => this.queue.push(resolve));
+    this.count++;
+  }
+
+  release() {
+    this.count--;
+    if (this.queue.length > 0) {
+      const next = this.queue.shift();
+      next();
+    }
+  }
+}
+
+// ============ 參數解析 ============
+function parseArgs() {
+  const args = process.argv.slice(2);
+  const queries = [];
+  const options = {
+    maxUses: 3,  // 每個搜尋的 max_uses（降低以加速）
+    allowedDomains: null,
+    blockedDomains: null,
+  };
+
+  let i = 0;
+  while (i < args.length) {
+    const arg = args[i];
+
+    if (arg.startsWith('--')) {
+      const value = args[i + 1];
+      if (!value) {
+        console.error(`❌ 選項 ${arg} 需要一個值`);
+        process.exit(1);
+      }
+
+      switch (arg) {
+        case '--max-uses':
+          options.maxUses = parseInt(value, 10);
+          if (isNaN(options.maxUses) || options.maxUses < 1) {
+            console.error('❌ --max-uses 必須是正整數');
+            process.exit(1);
+          }
+          break;
+        case '--allowed-domains':
+          options.allowedDomains = value.split(',').map(d => d.trim());
+          break;
+        case '--blocked-domains':
+          options.blockedDomains = value.split(',').map(d => d.trim());
+          break;
+        default:
+          console.error(`❌ 未知選項: ${arg}`);
+          process.exit(1);
+      }
+      i += 2;
+    } else {
+      queries.push(arg);
+      i++;
+    }
+  }
+
+  if (queries.length === 0) {
+    console.error('❌ 請提供搜尋關鍵字');
+    console.error('');
+    console.error('Usage: node search.mjs "關鍵字1" ["關鍵字2" ...] [options]');
+    console.error('');
+    console.error('Examples:');
+    console.error('  node search.mjs "台灣天氣"                    # 簡單問題');
+    console.error('  node search.mjs "台積電股價" "鴻海股價"       # 中等問題');
+    console.error('  node search.mjs "AI趨勢" "半導體" "電動車"    # 複雜問題');
+    process.exit(1);
+  }
+
+  if (queries.length > MAX_QUERIES) {
+    console.error(`❌ 最多支援 ${MAX_QUERIES} 個關鍵字，目前有 ${queries.length} 個`);
+    process.exit(1);
+  }
+
+  return { queries, options };
+}
+
+// ============ 單一搜尋 ============
+async function searchSingle(query, options, client) {
+  const toolConfig = {
+    type: 'web_search_20250305',
+    name: 'web_search',
+    max_uses: options.maxUses,
+  };
+
+  if (options.allowedDomains) {
+    toolConfig.allowed_domains = options.allowedDomains;
+  }
+  if (options.blockedDomains) {
+    toolConfig.blocked_domains = options.blockedDomains;
+  }
+
+  try {
+    const response = await client.messages.create({
+      model: 'claude-haiku-4-5@20251001',
+      max_tokens: 2048,
+      tools: [toolConfig],
+      messages: [
+        {
+          role: 'user',
+          content: `請使用 web search 搜尋以下內容，並用繁體中文總結搜尋結果（簡潔扼要，200字內）：${query}`,
+        },
+      ],
+    }, {
+      headers: {
+        'anthropic-beta': 'web-search-2025-03-05',
+      },
+    });
+
+    // 提取文字回應
+    const textBlocks = response.content.filter(b => b.type === 'text');
+    const result = textBlocks.map(b => b.text).join('\n');
+
+    // 提取引用
+    const citations = [];
+    for (const block of response.content) {
+      if (block.type === 'text' && block.citations) {
+        citations.push(...block.citations);
+      }
+    }
+
+    return {
+      query,
+      success: true,
+      result,
+      citations,
+      tokens: {
+        input: response.usage.input_tokens,
+        output: response.usage.output_tokens,
+      },
+    };
+  } catch (error) {
+    return {
+      query,
+      success: false,
+      error: error.message,
+    };
+  }
+}
+
+// ============ 平行搜尋（帶併發控制） ============
+async function parallelSearch(queries, options) {
+  const projectId = process.env.GOOGLE_CLOUD_PROJECT || 'botrun-c';
+  const region = 'asia-east1';
+
+  const client = new Anthropic({
+    projectId,
+    region,
+  });
+
+  const semaphore = new Semaphore(MAX_CONCURRENT);
+  const startTime = Date.now();
+
+  console.log(`\n🔍 開始平行搜尋 ${queries.length} 個關鍵字...\n`);
+
+  const tasks = queries.map(async (query, index) => {
+    await semaphore.acquire();
+    try {
+      const result = await searchSingle(query, options, client);
+      console.log(`  ✓ [${index + 1}/${queries.length}] ${query}`);
+      return result;
+    } finally {
+      semaphore.release();
+    }
+  });
+
+  const results = await Promise.all(tasks);
+  const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
+
+  console.log(`\n⏱️  完成！耗時 ${elapsed} 秒\n`);
+
+  return results;
+}
+
+// ============ 格式化輸出 ============
+function formatResults(results) {
+  const successful = results.filter(r => r.success);
+  const failed = results.filter(r => !r.success);
+
+  console.log('═'.repeat(60));
+  console.log('📊 搜尋結果');
+  console.log('═'.repeat(60));
+
+  for (const r of successful) {
+    console.log(`\n### 🔎 ${r.query}\n`);
+    console.log(r.result);
+
+    if (r.citations && r.citations.length > 0) {
+      console.log('\n**引用來源：**');
+      // 去重複 URL
+      const uniqueCitations = [...new Map(r.citations.map(c => [c.url, c])).values()];
+      uniqueCitations.slice(0, 3).forEach((c, i) => {
+        const title = c.title || '來源';
+        console.log(`${i + 1}. [${title}](${c.url})`);
+      });
+    }
+    console.log('\n' + '─'.repeat(60));
+  }
+
+  if (failed.length > 0) {
+    console.log('\n⚠️ 以下搜尋失敗：');
+    for (const r of failed) {
+      console.log(`  - ${r.query}: ${r.error}`);
+    }
+  }
+
+  // Token 統計
+  if (process.env.DEBUG) {
+    const totalInput = successful.reduce((sum, r) => sum + (r.tokens?.input || 0), 0);
+    const totalOutput = successful.reduce((sum, r) => sum + (r.tokens?.output || 0), 0);
+    console.log(`\n📈 Token 使用量: 輸入 ${totalInput}, 輸出 ${totalOutput}`);
+  }
+}
+
+// ============ 主程式 ============
+async function main() {
+  const { queries, options } = parseArgs();
+
+  try {
+    const results = await parallelSearch(queries, options);
+    formatResults(results);
+  } catch (error) {
+    console.error(`\n❌ 搜尋失敗：${error.message}`);
+    if (error.message.includes('authentication')) {
+      console.error('\n提示：請確認已設定 Google Cloud 認證');
+      console.error('  gcloud auth application-default login');
+    }
+    process.exit(1);
+  }
+}
+
+main();