botrun-horse 2.29.2 → 2.30.0

package/botrun-c/.claude/skills//345/233/236/346/206/266/346/212/200/350/203/275/SKILL.md

@@ -0,0 +1,123 @@
+---
+name: 回憶技能
+description: 當使用者輸入本技能的完整名稱（「回憶技能」），即代表要求 AI 載入並啟動本技能。當使用者說「回憶」、「曾經」、「還記得」、「之前說過」、「最近」、「想想」、「記起來」、「有印象嗎」時使用。(v1.0.3)
+allowed-tools: Bash
+---
+
+## ⚠️ 重要：必須執行腳本
+
+**你必須使用 Bash 工具執行 recall.mjs 腳本來搜尋記憶。絕對不要自己猜測或編造記憶內容。**
+
+當使用者詢問任何關於過去的事情時，你必須：
+1. 從使用者問題中提取搜尋關鍵字
+2. 使用 Bash 工具執行 `node /home/nodejs/.claude/skills/回憶技能/scripts/recall.mjs` 腳本
+3. 根據腳本輸出的搜尋結果回答使用者
+
+## 觸發條件
+- 使用者說「回憶技能」（明確觸發）
+- 使用者說「回憶」、「還記得嗎」、「之前說過」
+- 使用者說「曾經」、「以前」、「那時候」
+- 使用者說「最近」、「這幾天」、「上週」
+- 使用者說「想想」、「記起來」、「有印象嗎」
+- 使用者問關於特定人物或事件的問題
+- 使用者問「我的 X 是什麼？」這類問題
+
+## 使用方式（必須執行）
+
+```bash
+node /home/nodejs/.claude/skills/回憶技能/scripts/recall.mjs \
+  --query "搜尋關鍵字" \
+  --topic "主題(可選)" \
+  --limit 20
+```
+
+## 參數說明
+
+| 參數 | 必要 | 說明 |
+|------|------|------|
+| `--query` | ✅ | 搜尋關鍵字 |
+| `--topic` | ❌ | 限定主題 (person/event/idea/emotion/todo/general) |
+| `--limit` | ❌ | 最大結果數 (預設: 20) |
+
+> 🔐 **安全性**：使用者 ID 由系統自動從環境變數 `USER_ID` 讀取，無需手動指定。
+
+## 時間分層
+
+搜尋結果會自動依時間分層顯示：
+
+| 層級 | 符號 | 時間範圍 | 優先級 |
+|------|------|----------|--------|
+| Hot | 🔥 | 今天 | 最高 |
+| Warm | 🌡️ | 近 14 天 | 中 |
+| Cold | ❄️ | 14 天以上 | 較低 |
+
+## 範例
+
+### 範例 1: 搜尋特定人物
+使用者：「小明最近說了什麼？」
+
+```bash
+node /home/nodejs/.claude/skills/回憶技能/scripts/recall.mjs \
+  --query "小明" \
+  --topic "person" \
+  --limit 10
+```
+
+### 範例 2: 全域搜尋
+使用者：「我們曾經討論過日本嗎？」
+
+```bash
+node /home/nodejs/.claude/skills/回憶技能/scripts/recall.mjs \
+  --query "日本"
+```
+
+### 範例 3: 搜尋事件
+使用者：「最近有什麼聚餐活動？」
+
+```bash
+node /home/nodejs/.claude/skills/回憶技能/scripts/recall.mjs \
+  --query "聚餐" \
+  --topic "event"
+```
+
+### 範例 4: 搜尋想法
+使用者：「我們之前討論過什麼專案？」
+
+```bash
+node /home/nodejs/.claude/skills/回憶技能/scripts/recall.mjs \
+  --query "專案" \
+  --topic "idea"
+```
+
+## 輸出格式
+
+```
+🔍 搜尋「小明」 [主題: person]...
+
+🔥 Hot (今天):
+  [10:30] [person] 小明說他12/15要去日本玩 ⭐
+
+🌡️ Warm (近兩週):
+  [12-04 14:00] [person] 小明分享日本攻略連結
+  [12-03 09:00] [person] 小明問大家要不要一起去
+
+❄️ Cold (更早):
+  [11-20 16:00] [person] 小明第一次提到想去日本
+
+──────────────────────────────────────────────────
+📊 共找到 4 筆，顯示 4 筆
+📈 分佈: 🔥 1 | 🌡️ 2 | ❄️ 1
+```
+
+## 搜尋策略
+
+1. **時間優先**：最新的記憶排最前面
+2. **主題過濾**：如指定 topic，只搜尋該目錄
+3. **動態分層**：根據時間戳判斷 hot/warm/cold
+4. **重要標記**：重要性 ≥ 8 的記憶會標示 ⭐
+
+## 注意事項
+
+- 搜尋使用 `rg` (ripgrep)，支援正規表達式
+- 搜尋不區分大小寫
+- 如果記憶庫尚未建立，會提示使用「記憶技能」先建立記憶

package/botrun-c/.claude/skills//345/233/236/346/206/266/346/212/200/350/203/275/scripts/recall.mjs

@@ -0,0 +1,339 @@
+#!/usr/bin/env node
+/**
+ * 回憶技能 - 讀取腳本
+ *
+ * Usage:
+ *   node recall.mjs --user-id "ID" --query "關鍵字" [--topic "person"] [--limit 20]
+ *
+ * 特點：
+ *   - rg 極速搜尋
+ *   - 時間優先（新的在前）
+ *   - 動態 hot/warm/cold 分層（不遷移資料）
+ */
+
+import { execSync } from 'child_process';
+import { existsSync } from 'fs';
+import { join } from 'path';
+
+// ============ 常數 ============
+const HOT_DAYS = 0; // 今天 = hot
+const WARM_DAYS = 14; // 14 天內 = warm
+const VALID_TOPICS = ['person', 'event', 'idea', 'emotion', 'todo', 'general'];
+
+// ============ 參數解析 ============
+function parseArgs() {
+  const args = process.argv.slice(2);
+  const opts = { limit: 20 };
+
+  // 🔐 安全性：強制從環境變數讀取 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 'query':
+          opts.query = val;
+          break;
+        case 'topic':
+          opts.topic = val.toLowerCase();
+          break;
+        case 'limit':
+          opts.limit = parseInt(val);
+          if (isNaN(opts.limit) || opts.limit < 1) {
+            console.error('❌ --limit 必須是正整數');
+            process.exit(1);
+          }
+          break;
+        default:
+          console.error(`❌ 未知選項: ${arg}`);
+          process.exit(1);
+      }
+    }
+  }
+
+  // 驗證必要參數
+  if (!opts.query) {
+    console.error('❌ 缺少必要參數: --query');
+    printUsage();
+    process.exit(1);
+  }
+
+  // 驗證 topic（如果有提供）
+  if (opts.topic && !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 recall.mjs --query "關鍵字" [選項]
+
+必要參數:
+  --query     搜尋關鍵字
+
+選項:
+  --topic     限定主題 (${VALID_TOPICS.join('/')})
+  --limit     最大結果數 (預設: 20)
+
+環境變數:
+  USER_ID     使用者 ID（由系統自動設定）
+
+範例:
+  node recall.mjs --query "小明"
+  node recall.mjs --query "日本" --topic "person" --limit 10
+`);
+}
+
+// ============ 時間分層判斷 ============
+function getTier(timestamp) {
+  const now = new Date();
+  const then = new Date(timestamp);
+
+  // 重置時間到當天開始，以便正確計算天數差
+  const nowDate = new Date(now.getFullYear(), now.getMonth(), now.getDate());
+  const thenDate = new Date(then.getFullYear(), then.getMonth(), then.getDate());
+
+  const diffMs = nowDate - thenDate;
+  const diffDays = Math.floor(diffMs / (1000 * 60 * 60 * 24));
+
+  if (diffDays <= HOT_DAYS) return 'hot';
+  if (diffDays <= WARM_DAYS) return 'warm';
+  return 'cold';
+}
+
+function getTierEmoji(tier) {
+  switch (tier) {
+    case 'hot':
+      return '🔥';
+    case 'warm':
+      return '🌡️';
+    case 'cold':
+      return '❄️';
+    default:
+      return '📝';
+  }
+}
+
+function getTierName(tier) {
+  switch (tier) {
+    case 'hot':
+      return 'Hot (今天)';
+    case 'warm':
+      return 'Warm (近兩週)';
+    case 'cold':
+      return 'Cold (更早)';
+    default:
+      return tier;
+  }
+}
+
+// ============ rg 搜尋 ============
+function search(opts) {
+  // 使用環境變數 MEMORY_BASE_DIR，預設為 /mnt/data（Cloud Run）
+  const baseDir = process.env.MEMORY_BASE_DIR || '/mnt/data';
+
+  // 路徑簡化為 {userId}/memory，與 remember.mjs 一致
+  const memoryRoot = join(baseDir, opts.userId, 'memory');
+
+  if (!existsSync(memoryRoot)) {
+    return { results: [], searchPath: memoryRoot, exists: false };
+  }
+
+  // 決定搜尋路徑
+  const searchPath = opts.topic ? join(memoryRoot, opts.topic) : memoryRoot;
+
+  if (!existsSync(searchPath)) {
+    return { results: [], searchPath, exists: false };
+  }
+
+  try {
+    // 逸出 query 中的特殊字元（用於 shell）
+    const escapedQuery = opts.query.replace(/['"\\]/g, '\\$&');
+
+    // rg 搜尋：
+    // -i: 忽略大小寫
+    // --no-heading: 不分檔案顯示
+    // -N: 不顯示行號
+    // --glob "*.jsonl": 只搜尋 jsonl 檔案
+    const rgCmd = `rg -i "${escapedQuery}" "${searchPath}" --no-heading -N --glob "*.jsonl" 2>/dev/null || true`;
+
+    const output = execSync(rgCmd, {
+      encoding: 'utf-8',
+      maxBuffer: 10 * 1024 * 1024,
+    });
+
+    if (!output.trim()) {
+      return { results: [], searchPath, exists: true };
+    }
+
+    // 解析每行 JSON
+    const results = [];
+    const lines = output.trim().split('\n');
+
+    for (const line of lines) {
+      // rg 輸出格式可能是: filepath:json 或直接 json
+      // 找到第一個 { 的位置
+      const jsonStart = line.indexOf('{');
+      if (jsonStart === -1) continue;
+
+      try {
+        const jsonStr = line.slice(jsonStart);
+        const record = JSON.parse(jsonStr);
+
+        // 從檔案路徑提取 topic（如果沒有指定）
+        if (!opts.topic && jsonStart > 0) {
+          const pathPart = line.slice(0, jsonStart - 1);
+          const topicMatch = pathPart.match(/\/memory\/([^/]+)\//);
+          if (topicMatch) {
+            record._topic = topicMatch[1];
+          }
+        } else {
+          record._topic = opts.topic;
+        }
+
+        results.push(record);
+      } catch {
+        // 忽略解析失敗的行
+        continue;
+      }
+    }
+
+    return { results, searchPath, exists: true };
+  } catch (err) {
+    console.error('❌ 搜尋錯誤:', err.message);
+    return { results: [], searchPath, exists: true, error: err.message };
+  }
+}
+
+// ============ 格式化輸出 ============
+function formatResults(results, limit, query) {
+  if (results.length === 0) {
+    console.log(`\n📭 找不到與「${query}」相關的記憶`);
+    return;
+  }
+
+  // 按時間倒序排列（最新的在前）
+  results.sort((a, b) => new Date(b.t) - new Date(a.t));
+
+  // 截斷到 limit
+  const truncated = results.slice(0, limit);
+
+  // 按 tier 分組
+  const grouped = { hot: [], warm: [], cold: [] };
+  truncated.forEach((r) => {
+    const tier = getTier(r.t);
+    grouped[tier].push(r);
+  });
+
+  // 輸出
+  let hasOutput = false;
+
+  for (const tier of ['hot', 'warm', 'cold']) {
+    if (grouped[tier].length > 0) {
+      hasOutput = true;
+      console.log(`\n${getTierEmoji(tier)} ${getTierName(tier)}:`);
+
+      grouped[tier].forEach((r) => {
+        const time = new Date(r.t);
+        let timeStr;
+
+        if (tier === 'hot') {
+          // 今天只顯示時間
+          timeStr = time.toLocaleTimeString('zh-TW', {
+            hour: '2-digit',
+            minute: '2-digit',
+          });
+        } else {
+          // 其他顯示日期+時間
+          timeStr =
+            time.toLocaleDateString('zh-TW', {
+              month: '2-digit',
+              day: '2-digit',
+            }) +
+            ' ' +
+            time.toLocaleTimeString('zh-TW', {
+              hour: '2-digit',
+              minute: '2-digit',
+            });
+        }
+
+        // 組合輸出行
+        const topicTag = r._topic ? `[${r._topic}]` : '';
+        const priorityTag = r.p >= 8 ? ' ⭐' : '';
+        console.log(`  [${timeStr}] ${topicTag} ${r.c}${priorityTag}`);
+      });
+    }
+  }
+
+  if (!hasOutput) {
+    console.log(`\n📭 找不到與「${query}」相關的記憶`);
+  }
+
+  // 統計資訊
+  console.log(`\n${'─'.repeat(50)}`);
+  console.log(`📊 共找到 ${results.length} 筆，顯示 ${truncated.length} 筆`);
+
+  // 顯示各層級統計
+  const tierCounts = {
+    hot: grouped.hot.length,
+    warm: grouped.warm.length,
+    cold: grouped.cold.length,
+  };
+  const tierStats = Object.entries(tierCounts)
+    .filter(([, count]) => count > 0)
+    .map(([tier, count]) => `${getTierEmoji(tier)} ${count}`)
+    .join(' | ');
+
+  if (tierStats) {
+    console.log(`📈 分佈: ${tierStats}`);
+  }
+}
+
+// ============ 主程式 ============
+function main() {
+  const opts = parseArgs();
+
+  // 顯示搜尋資訊
+  const topicInfo = opts.topic ? ` [主題: ${opts.topic}]` : '';
+  console.log(`🔍 搜尋「${opts.query}」${topicInfo}...`);
+
+  const { results, searchPath, exists, error } = search(opts);
+
+  if (!exists) {
+    console.log(`\n📭 記憶庫尚未建立: ${searchPath}`);
+    return;
+  }
+
+  if (error) {
+    console.log(`\n⚠️ 搜尋時發生錯誤: ${error}`);
+    return;
+  }
+
+  formatResults(results, opts.limit, opts.query);
+}
+
+main();

package/botrun-c/.claude/skills//345/234/226/347/211/207/347/224/237/346/210/220/346/212/200/350/203/275/SKILL.md

@@ -0,0 +1,156 @@
+---
+name: 圖片生成技能
+description: 當使用者需要「生成圖片」、「畫一張圖」、「製作圖像」時使用。
+allowed-tools: Bash
+---
+
+# 圖片生成技能
+
+## 觸發條件
+- 使用者說「生成圖片」、「畫圖」、「製作圖像」
+- 使用者描述想要的圖片內容
+- 需要 AI 生成圖片或插圖
+- 使用者要求修改之前生成的圖片
+
+## 執行方式
+
+### 首次生成
+
+執行以下腳本進行圖片生成：
+
+```bash
+node $OFFICIAL_SKILLS_DIR/圖片生成技能/scripts/generate-image.mjs "圖片描述"
+```
+
+### 迭代修改（多輪對話）
+
+當使用者想要修改之前生成的圖片時，使用 `--session` 參數：
+
+```bash
+node $OFFICIAL_SKILLS_DIR/圖片生成技能/scripts/generate-image.mjs "修改描述" --session <session-id>
+```
+
+**重要：**
+- Session ID 會在首次生成時輸出，請記住並在後續修改時使用
+- Session 有效期為 30 分鐘
+- SDK 會自動管理 Thought Signatures，確保圖片上下文正確傳遞
+
+## 參數說明
+
+| 參數 | 說明 | 預設值 |
+|------|------|--------|
+| --aspect, -a | 長寬比 (1:1, 16:9, 9:16, 21:9 等) | 1:1 |
+| --style, -s | 藝術風格 (photorealistic, anime, oil painting 等) | 無 |
+| --negative, -n | 要避免的元素 | 無 |
+| --temperature, -t | 創意程度 (0-2) | 1.0 |
+| --count, -c | 生成數量 (1-4) | 1 |
+| --session | Session ID（用於多輪迭代修改） | 無 |
+
+## 使用範例
+
+### 基本使用
+
+```bash
+# 生成圖片
+node $OFFICIAL_SKILLS_DIR/圖片生成技能/scripts/generate-image.mjs "A serene Japanese garden with cherry blossoms"
+
+# 指定長寬比
+node $OFFICIAL_SKILLS_DIR/圖片生成技能/scripts/generate-image.mjs "Mountain landscape" --aspect 16:9
+
+# 指定風格
+node $OFFICIAL_SKILLS_DIR/圖片生成技能/scripts/generate-image.mjs "Portrait of a cat" --style "oil painting"
+
+# 完整參數
+node $OFFICIAL_SKILLS_DIR/圖片生成技能/scripts/generate-image.mjs "A futuristic city" \
+  --aspect 21:9 \
+  --style "cyberpunk" \
+  --negative "blurry, low quality" \
+  --temperature 1.5
+```
+
+### 多輪迭代修改
+
+```bash
+# 1. 首次生成（會輸出 Session ID）
+node $OFFICIAL_SKILLS_DIR/圖片生成技能/scripts/generate-image.mjs "一隻可愛的橘貓"
+
+# 輸出會包含：Session ID: abc123-def456-...
+
+# 2. 修改圖片（使用相同 Session ID）
+node $OFFICIAL_SKILLS_DIR/圖片生成技能/scripts/generate-image.mjs "把背景改成海邊" --session abc123-def456-...
+
+# 3. 繼續修改
+node $OFFICIAL_SKILLS_DIR/圖片生成技能/scripts/generate-image.mjs "加上太陽眼鏡" --session abc123-def456-...
+```
+
+## 輸出格式
+
+腳本會輸出 Markdown 格式的結果：
+
+```markdown
+## 圖片生成結果
+
+**統計資訊：**
+- 生成數量: 1
+- 長寬比: 16:9
+- 風格: cyberpunk
+- 模式: 多輪迭代（如適用）
+
+### 圖片 1
+
+![Generated Image 1](https://storage.googleapis.com/...)
+
+- GCS URI: gs://bucket/path/file.png
+- 有效期限: 2024-12-08T00:00:00.000Z
+
+---
+**迭代資訊：**
+- Session ID: `abc123-def456-...`
+- 如需修改此圖片，請使用 `--session` 參數
+```
+
+## 技術特性
+- **模型**: Gemini 3 Pro Image (Vertex AI 全域端點)
+- **解析度**: 固定 1K（確保穩定性）
+- **儲存**: 自動上傳到 GCS
+- **URL**: 7 天有效的 Signed URL
+- **多輪對話**: 支援 Thought Signatures 自動管理
+- **Session TTL**: 30 分鐘
+
+## 架構設計
+
+技能腳本採用 SOLID 原則重構：
+
+```
+scripts/
+├── constants.mjs          # 常數定義
+├── utils.mjs              # 通用工具函式
+├── image-session-manager.mjs  # Session 管理
+├── gemini-image-client.mjs    # Gemini API 客戶端
+├── gcs-uploader.mjs       # GCS 上傳器
+├── output-formatter.mjs   # 輸出格式化
+└── generate-image.mjs     # 主程式入口
+```
+
+## 環境需求
+- GOOGLE_CLOUD_PROJECT（預設: botrun-c）
+- GCS_BUCKET（可選，無則回傳 base64）
+- USER_ID（用於 GCS 路徑）
+- SESSION_DIR（可選，預設 /tmp/image-sessions）
+- Google Cloud 認證（gcloud auth）
+
+## 範例對話
+
+**使用者**：「幫我畫一張櫻花樹下的日式庭園」
+
+**執行**：
+```bash
+node $OFFICIAL_SKILLS_DIR/圖片生成技能/scripts/generate-image.mjs "A serene Japanese garden with cherry blossoms, traditional stone lantern, koi pond reflection" --style "photorealistic" --aspect 16:9
+```
+
+**使用者**：「把天空改成日落」
+
+**執行**（使用上一次的 Session ID）：
+```bash
+node $OFFICIAL_SKILLS_DIR/圖片生成技能/scripts/generate-image.mjs "把天空改成日落" --session <上一次輸出的 session-id>
+```