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/scripts/search.ts

@@ -0,0 +1,166 @@
+#!/usr/bin/env npx tsx
+/**
+ * 網路搜尋腳本 - 使用 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）
+ */
+
+import Anthropic from '@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);
+}
+
+// 解析選項
+interface SearchOptions {
+  maxUses: number;
+  allowedDomains?: string[];
+  blockedDomains?: string[];
+}
+
+const options: SearchOptions = {
+  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(): Promise<void> {
+  const projectId = process.env.GOOGLE_CLOUD_PROJECT || 'botrun-c';
+  const region = 'asia-east1'; // 台灣端點
+
+  const client = new Anthropic({
+    projectId,
+    region,
+  });
+
+  // 建立 web_search tool 配置
+  const toolConfig: any = {
+    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: any) => b.text).join('\n');
+
+    // 提取 citations（如果有的話）
+    interface Citation {
+      url: string;
+      title?: string;
+      cited_text?: string;
+    }
+    const citations: Citation[] = [];
+    for (const block of response.content) {
+      if (block.type === 'text' && (block as any).citations) {
+        citations.push(...(block as any).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: any) {
+    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//350/250/230/346/206/266/346/212/200/350/203/275/SKILL.md

@@ -0,0 +1,114 @@
+---
+name: 記憶技能
+description: 當使用者輸入本技能的完整名稱（「記憶技能」），即代表要求 AI 載入並啟動本技能。當使用者說「記住」、「記下來」、「別忘了」、「記憶」、「要記得」、「幫我記」時使用。(v1.0.3)
+allowed-tools: Bash
+---
+
+## ⚠️ 重要：必須執行腳本
+
+**你必須使用 Bash 工具執行 remember.mjs 腳本來儲存記憶。絕對不要只是口頭說「好的我記住了」而不執行腳本。**
+
+當使用者要求記住任何事情時，你必須：
+1. 分析記憶內容（主題、重要性、關鍵字）
+2. 使用 Bash 工具執行 `node /home/nodejs/.claude/skills/記憶技能/scripts/remember.mjs` 腳本
+3. 確認腳本執行成功後才告訴使用者已記住
+
+## 觸發條件
+- 使用者說「記憶技能」（明確觸發）
+- 使用者說「記住」、「記下來」、「別忘了」
+- 使用者說「幫我記」、「要記得」、「記憶」
+- 明確要求保存某些資訊到記憶中
+
+## 使用方式（必須執行）
+
+### Step 1: 分析記憶內容
+
+判斷這個記憶的：
+- **主題** (person/event/idea/emotion/todo/general)
+- **重要性** (1-10)
+- **關鍵字** (提取 2-5 個)
+
+### Step 2: 執行寫入
+
+```bash
+node /home/nodejs/.claude/skills/記憶技能/scripts/remember.mjs \
+  --topic "主題" \
+  --content "記憶內容" \
+  --priority 重要性 \
+  --keywords "關鍵字1,關鍵字2"
+```
+
+> 🔐 **安全性**：使用者 ID 由系統自動從環境變數 `USER_ID` 讀取，無需手動指定。
+
+## 主題分類指引
+
+| 主題 | 代碼 | 何時使用 |
+|------|------|----------|
+| 👥 人物 | `person` | 涉及特定人物的事情、人物特徵、誰說了什麼 |
+| 📅 事件 | `event` | 發生的事件、活動、聚會、重要日期 |
+| 💡 想法 | `idea` | 靈感、點子、討論內容、專案構想 |
+| ❤️ 情感 | `emotion` | 心情、感受、人際關係 |
+| 📋 待辦 | `todo` | 待辦事項、提醒、承諾要做的事 |
+| 📁 一般 | `general` | 其他不易分類的記憶 |
+
+## 重要性判斷
+
+| 分數 | 說明 | 範例 |
+|------|------|------|
+| 8-10 | 涉及日期、承諾、重要決定 | 「小明 12/15 要去日本」 |
+| 5-7 | 一般對話、討論 | 「大家聊到最近的電影」 |
+| 1-4 | 閒聊、不重要的細節 | 「今天天氣不錯」 |
+
+## 範例
+
+### 範例 1: 人物記憶
+使用者：「記住小明說他 12/15 要去日本玩」
+
+```bash
+node /home/nodejs/.claude/skills/記憶技能/scripts/remember.mjs \
+  --topic "person" \
+  --content "小明說他12/15要去日本玩" \
+  --priority 8 \
+  --keywords "小明,日本,旅行,12月"
+```
+
+### 範例 2: 事件記憶
+使用者：「記下來這週六要聚餐」
+
+```bash
+node /home/nodejs/.claude/skills/記憶技能/scripts/remember.mjs \
+  --topic "event" \
+  --content "這週六要聚餐" \
+  --priority 7 \
+  --keywords "聚餐,週六"
+```
+
+### 範例 3: 想法記憶
+使用者：「記住我們討論要做一個 AI 記憶系統」
+
+```bash
+node /home/nodejs/.claude/skills/記憶技能/scripts/remember.mjs \
+  --topic "idea" \
+  --content "討論要做一個AI記憶系統" \
+  --priority 6 \
+  --keywords "AI,記憶系統,專案"
+```
+
+## 儲存結構
+
+記憶會儲存在以下路徑：
+```
+{userId}/memory/{topic}/{YYYY-MM-DD}.jsonl
+```
+
+每條記憶是一行 JSON：
+```json
+{"t":"2025-12-06T10:30:00+08:00","c":"小明說他12/15要去日本玩","p":8,"k":["小明","日本"]}
+```
+
+| 欄位 | 說明 |
+|------|------|
+| `t` | ISO 8601 時間戳 |
+| `c` | 記憶內容 |
+| `p` | 重要性 1-10 |
+| `k` | 關鍵字陣列（可選）|

package/botrun-c/.claude/skills//350/250/230/346/206/266/346/212/200/350/203/275/scripts/remember.mjs

@@ -0,0 +1,159 @@
+#!/usr/bin/env node
+/**
+ * 記憶技能 - 寫入腳本
+ *
+ * Usage:
+ *   node remember.mjs --user-id "ID" --topic "person" --content "內容" [--priority 5] [--keywords "k1,k2"]
+ *
+ * 目錄結構:
+ *   {MEMORY_BASE_DIR}/{userId}/memory/{topic}/{YYYY-MM-DD}.jsonl
+ *
+ * JSONL 格式:
+ *   {"t":"ISO時間","c":"內容","p":優先級,"k":["關鍵字"]}
+ */
+
+import { existsSync, mkdirSync, appendFileSync } from 'fs';
+import { join } from 'path';
+
+// ============ 常數 ============
+const VALID_TOPICS = ['person', 'event', 'idea', 'emotion', 'todo', 'general'];
+
+// ============ 參數解析 ============
+function parseArgs() {
+  const args = process.argv.slice(2);
+  const opts = { priority: 5, keywords: [] };
+
+  // 🔐 安全性：強制從環境變數讀取 USER_ID（不允許使用者輸入）
+  const userId = process.env.USER_ID;
+  if (!userId) {
+    console.error('❌ 環境變數 USER_ID 未設定');
+    console.error('   此腳本必須在 Claude Agent SDK 環境中執行');
+    process.exit(1);
+  }
+  opts.userId = userId;
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+
+    if (arg.startsWith('--')) {
+      const key = arg.replace('--', '');
+      const val = args[++i];
+
+      if (val === undefined) {
+        console.error(`❌ 選項 ${arg} 需要一個值`);
+        process.exit(1);
+      }
+
+      switch (key) {
+        case 'user-id':
+          // 🔐 忽略使用者輸入的 --user-id，強制使用環境變數
+          console.warn('⚠️  忽略 --user-id 參數，使用環境變數 USER_ID');
+          break;
+        case 'topic': opts.topic = val.toLowerCase(); break;
+        case 'content': opts.content = val; break;
+        case 'priority':
+          opts.priority = parseInt(val);
+          if (isNaN(opts.priority) || opts.priority < 1 || opts.priority > 10) {
+            console.error('❌ --priority 必須是 1-10 的整數');
+            process.exit(1);
+          }
+          break;
+        case 'keywords':
+          opts.keywords = val.split(',').map(k => k.trim()).filter(Boolean);
+          break;
+        default:
+          console.error(`❌ 未知選項: ${arg}`);
+          process.exit(1);
+      }
+    }
+  }
+
+  // 驗證必要參數
+  if (!opts.topic) {
+    console.error('❌ 缺少必要參數: --topic');
+    printUsage();
+    process.exit(1);
+  }
+  if (!opts.content) {
+    console.error('❌ 缺少必要參數: --content');
+    printUsage();
+    process.exit(1);
+  }
+
+  // 驗證 topic
+  if (!VALID_TOPICS.includes(opts.topic)) {
+    console.error(`❌ 無效的 topic: ${opts.topic}`);
+    console.error(`   有效值: ${VALID_TOPICS.join(', ')}`);
+    process.exit(1);
+  }
+
+  return opts;
+}
+
+function printUsage() {
+  console.error(`
+Usage: node remember.mjs --topic "TOPIC" --content "內容" [選項]
+
+必要參數:
+  --topic     主題 (${VALID_TOPICS.join('/')})
+  --content   記憶內容
+
+選項:
+  --priority  重要性 1-10 (預設: 5)
+  --keywords  關鍵字，逗號分隔
+
+環境變數:
+  USER_ID     使用者 ID（由系統自動設定）
+
+範例:
+  node remember.mjs --topic "person" --content "小明說要去日本" --priority 8 --keywords "小明,日本"
+`);
+}
+
+// ============ 主程式 ============
+function main() {
+  const opts = parseArgs();
+  const now = new Date();
+  const today = now.toISOString().split('T')[0]; // YYYY-MM-DD
+
+  // 使用環境變數 MEMORY_BASE_DIR，預設為 /mnt/data（Cloud Run）或當前目錄
+  const baseDir = process.env.MEMORY_BASE_DIR || '/mnt/data';
+
+  // 建立目錄: {baseDir}/{userId}/memory/{topic}/
+  // 路徑簡化為 {userId}/memory/{topic}，避免重複
+  const memoryDir = join(baseDir, opts.userId, 'memory', opts.topic);
+
+  if (!existsSync(memoryDir)) {
+    mkdirSync(memoryDir, { recursive: true });
+  }
+
+  // 寫入檔案: {date}.jsonl
+  const filePath = join(memoryDir, `${today}.jsonl`);
+
+  // 建立精簡的 JSON 記錄
+  const record = {
+    t: now.toISOString(),
+    c: opts.content,
+    p: opts.priority,
+  };
+
+  // 只有在有關鍵字時才加入 k 欄位
+  if (opts.keywords.length > 0) {
+    record.k = opts.keywords;
+  }
+
+  // Append 到檔案
+  appendFileSync(filePath, JSON.stringify(record) + '\n');
+
+  // 輸出結果
+  const preview = opts.content.length > 50 ? opts.content.slice(0, 50) + '...' : opts.content;
+  console.log(`✅ 已記住 [${opts.topic}]: ${preview}`);
+  console.log(`📁 儲存於: ${filePath}`);
+  console.log(`⏰ 時間: ${now.toLocaleString('zh-TW')}`);
+  if (opts.keywords.length > 0) {
+    console.log(`🏷️  關鍵字: ${opts.keywords.join(', ')}`);
+  }
+  console.log(`⭐ 重要性: ${opts.priority}/10`);
+}
+
+main();