botrun-horse 2.30.0 → 2.34.0

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

@@ -1,123 +0,0 @@
----
-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

@@ -1,339 +0,0 @@
-#!/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

@@ -1,156 +0,0 @@
----
-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>
-```