botrun-horse 2.30.0 → 2.34.0

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

@@ -1,103 +0,0 @@
-#!/usr/bin/env node
-// ============================================================================
-// generate-image.mjs - 圖片生成技能主程式（重構版）
-// 支援多輪對話迭代（Thought Signatures 由 SDK 自動管理）
-//
-// Usage:
-//   node generate-image.mjs "prompt" [options]
-//   node generate-image.mjs "修改描述" --session <session-id>
-//
-// 環境變數:
-//   GOOGLE_CLOUD_PROJECT, GCS_BUCKET, USER_ID
-// ============================================================================
-
-import { parseArgs, validateParams, log } from './utils.mjs';
-import { generateImage, initializeClient, isClientAvailable } from './gemini-image-client.mjs';
-import { uploadImages } from './gcs-uploader.mjs';
-import { formatFullOutput, output, outputError, outputUsage } from './output-formatter.mjs';
-import { cleanupExpiredSessions, loadSession } from './image-session-manager.mjs';
-
-// ============================================================================
-// 主程式
-// ============================================================================
-
-async function main() {
-  // 初始化客戶端
-  initializeClient();
-
-  // 背景清理過期 sessions（不等待）
-  cleanupExpiredSessions().catch(() => {});
-
-  // 解析參數
-  const args = process.argv.slice(2);
-
-  if (args.length === 0) {
-    outputUsage();
-    process.exit(1);
-  }
-
-  const params = parseArgs(args);
-
-  // 驗證參數
-  try {
-    validateParams(params);
-  } catch (error) {
-    outputError(error.message);
-    process.exit(1);
-  }
-
-  // 檢查客戶端
-  if (!isClientAvailable()) {
-    outputError('Vertex AI 未初始化，請檢查 Google Cloud 認證');
-    process.exit(1);
-  }
-
-  // 檢查是否為多輪對話
-  const isMultiTurn = !!params.session;
-  if (isMultiTurn) {
-    const existingSession = await loadSession(params.session);
-    if (!existingSession) {
-      log(`警告: Session ${params.session} 不存在或已過期，將建立新 session`);
-    }
-  }
-
-  try {
-    // 生成圖片
-    const result = await generateImage({
-      prompt: params.prompt,
-      sessionId: params.session,
-      aspectRatio: params.aspectRatio,
-      numberOfImages: params.count,
-      temperature: params.temperature,
-      negativePrompt: params.negativePrompt,
-      style: params.style,
-    });
-
-    // 上傳到 GCS
-    const uploadedImages = await uploadImages(result.images, {
-      prompt: params.prompt.substring(0, 500),
-      aspectRatio: params.aspectRatio,
-      style: params.style,
-      sessionId: result.sessionId,
-    });
-
-    // 格式化並輸出結果
-    const formattedOutput = formatFullOutput({
-      images: uploadedImages,
-      textResponse: result.textResponse,
-      sessionId: result.sessionId,
-      aspectRatio: params.aspectRatio,
-      style: params.style,
-      isMultiTurn,
-    });
-
-    output(formattedOutput);
-
-  } catch (error) {
-    outputError(error.message);
-    log('詳細錯誤:', error);
-    process.exit(1);
-  }
-}
-
-main();

package/botrun-c/.claude/skills//345/234/226/347/211/207/347/224/237/346/210/220/346/212/200/350/203/275/scripts/image-session-manager.mjs

@@ -1,219 +0,0 @@
-// ============================================================================
-// image-session-manager.mjs - Gemini Chat Session 管理器
-// 遵循 SOLID 原則：
-// - 單一職責：只負責 session 的儲存和讀取
-// - 開放封閉：可擴展儲存後端（檔案、Redis 等）
-// ============================================================================
-
-import { promises as fs } from 'fs';
-import { join, dirname } from 'path';
-import { SESSION_DIR, SESSION_TTL_MS } from './constants.mjs';
-import { log, generateSessionId } from './utils.mjs';
-
-/**
- * Session 資料結構
- * @typedef {Object} ImageSession
- * @property {string} id - Session ID
- * @property {Array} history - Gemini Chat 歷史（含 Thought Signatures）
- * @property {number} createdAt - 建立時間戳
- * @property {number} lastUsedAt - 最後使用時間戳
- * @property {Object} metadata - 額外資訊
- */
-
-/**
- * 確保 session 目錄存在
- */
-async function ensureSessionDir() {
-  try {
-    await fs.mkdir(SESSION_DIR, { recursive: true });
-  } catch (error) {
-    if (error.code !== 'EEXIST') {
-      throw error;
-    }
-  }
-}
-
-/**
- * 取得 session 檔案路徑
- * @param {string} sessionId - Session ID
- * @returns {string} 檔案路徑
- */
-function getSessionPath(sessionId) {
-  // 安全性：只允許 UUID 格式
-  const safeId = sessionId.replace(/[^a-zA-Z0-9-]/g, '');
-  return join(SESSION_DIR, `${safeId}.json`);
-}
-
-/**
- * 建立新的 session
- * @param {Object} options - 選項
- * @param {string} [options.id] - 自訂 session ID
- * @param {Object} [options.metadata] - 額外資訊
- * @returns {Promise<ImageSession>} 新建立的 session
- */
-export async function createSession(options = {}) {
-  await ensureSessionDir();
-
-  const session = {
-    id: options.id || generateSessionId(),
-    history: [],
-    createdAt: Date.now(),
-    lastUsedAt: Date.now(),
-    metadata: options.metadata || {},
-  };
-
-  await saveSession(session);
-  log(`建立新 session: ${session.id}`);
-
-  return session;
-}
-
-/**
- * 儲存 session
- * @param {ImageSession} session - Session 資料
- * @returns {Promise<void>}
- */
-export async function saveSession(session) {
-  await ensureSessionDir();
-
-  const path = getSessionPath(session.id);
-  session.lastUsedAt = Date.now();
-
-  await fs.writeFile(path, JSON.stringify(session, null, 2), 'utf-8');
-  log(`儲存 session: ${session.id}`);
-}
-
-/**
- * 讀取 session
- * @param {string} sessionId - Session ID
- * @returns {Promise<ImageSession|null>} Session 資料，不存在或過期則返回 null
- */
-export async function loadSession(sessionId) {
-  if (!sessionId) {
-    return null;
-  }
-
-  try {
-    const path = getSessionPath(sessionId);
-    const data = await fs.readFile(path, 'utf-8');
-    const session = JSON.parse(data);
-
-    // 檢查 TTL
-    const age = Date.now() - session.lastUsedAt;
-    if (age > SESSION_TTL_MS) {
-      log(`Session ${sessionId} 已過期 (${Math.round(age / 60000)} 分鐘)`);
-      await deleteSession(sessionId);
-      return null;
-    }
-
-    log(`載入 session: ${sessionId} (歷史記錄: ${session.history.length} 筆)`);
-    return session;
-  } catch (error) {
-    if (error.code === 'ENOENT') {
-      log(`Session ${sessionId} 不存在`);
-      return null;
-    }
-    throw error;
-  }
-}
-
-/**
- * 更新 session 歷史
- * @param {string} sessionId - Session ID
- * @param {Object} userMessage - 使用者訊息
- * @param {Object} modelResponse - 模型回應（含 Thought Signature）
- * @returns {Promise<ImageSession>} 更新後的 session
- */
-export async function updateSessionHistory(sessionId, userMessage, modelResponse) {
-  let session = await loadSession(sessionId);
-
-  if (!session) {
-    session = await createSession({ id: sessionId });
-  }
-
-  // 添加使用者訊息
-  session.history.push({
-    role: 'user',
-    parts: [{ text: userMessage }],
-  });
-
-  // 添加模型回應（包含完整的 parts，可能含 Thought Signature）
-  session.history.push({
-    role: 'model',
-    parts: modelResponse.parts || [{ text: modelResponse.text || '' }],
-  });
-
-  await saveSession(session);
-  return session;
-}
-
-/**
- * 刪除 session
- * @param {string} sessionId - Session ID
- * @returns {Promise<boolean>} 是否成功刪除
- */
-export async function deleteSession(sessionId) {
-  try {
-    const path = getSessionPath(sessionId);
-    await fs.unlink(path);
-    log(`刪除 session: ${sessionId}`);
-    return true;
-  } catch (error) {
-    if (error.code === 'ENOENT') {
-      return false;
-    }
-    throw error;
-  }
-}
-
-/**
- * 清理過期的 sessions
- * @returns {Promise<number>} 清理的 session 數量
- */
-export async function cleanupExpiredSessions() {
-  await ensureSessionDir();
-
-  let cleanedCount = 0;
-
-  try {
-    const files = await fs.readdir(SESSION_DIR);
-
-    for (const file of files) {
-      if (!file.endsWith('.json')) continue;
-
-      try {
-        const path = join(SESSION_DIR, file);
-        const data = await fs.readFile(path, 'utf-8');
-        const session = JSON.parse(data);
-
-        const age = Date.now() - session.lastUsedAt;
-        if (age > SESSION_TTL_MS) {
-          await fs.unlink(path);
-          cleanedCount++;
-        }
-      } catch (e) {
-        // 忽略單一檔案錯誤
-      }
-    }
-  } catch (error) {
-    if (error.code !== 'ENOENT') {
-      log('清理過期 sessions 失敗:', error.message);
-    }
-  }
-
-  if (cleanedCount > 0) {
-    log(`清理了 ${cleanedCount} 個過期 sessions`);
-  }
-
-  return cleanedCount;
-}
-
-/**
- * 取得 session 歷史（用於傳遞給 Gemini Chat）
- * @param {string} sessionId - Session ID
- * @returns {Promise<Array>} 對話歷史陣列
- */
-export async function getSessionHistory(sessionId) {
-  const session = await loadSession(sessionId);
-  return session?.history || [];
-}

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

@@ -1,209 +0,0 @@
-// ============================================================================
-// output-formatter.mjs - 輸出格式化器
-// 遵循 SOLID 原則：
-// - 單一職責：只負責格式化輸出
-// - 開放封閉：可擴展其他輸出格式
-// ============================================================================
-
-/**
- * 生成統計資訊區塊
- * @param {Object} params - 參數
- * @param {number} params.imageCount - 圖片數量
- * @param {string} params.aspectRatio - 長寬比
- * @param {string} [params.style] - 藝術風格
- * @param {string} [params.sessionId] - Session ID
- * @param {boolean} [params.isMultiTurn] - 是否為多輪對話
- * @returns {string}
- */
-export function formatStatistics(params) {
-  const { imageCount, aspectRatio, style, sessionId, isMultiTurn } = params;
-
-  const lines = [
-    '## 圖片生成結果\n',
-    '**統計資訊：**',
-    `- 生成數量: ${imageCount}`,
-    `- 長寬比: ${aspectRatio}`,
-  ];
-
-  if (style) {
-    lines.push(`- 風格: ${style}`);
-  }
-
-  if (isMultiTurn) {
-    lines.push('- 模式: 多輪迭代');
-  }
-
-  lines.push('');
-
-  return lines.join('\n');
-}
-
-/**
- * 格式化單張圖片結果
- * @param {Object} params - 參數
- * @param {number} params.index - 圖片索引（從 0 開始）
- * @param {Object} params.image - 圖片資訊
- * @param {boolean} params.image.success - 是否成功
- * @param {string} [params.image.imageUrl] - 圖片 URL
- * @param {string} [params.image.gcsUri] - GCS URI
- * @param {string} [params.image.expiresAt] - 過期時間
- * @param {string} [params.image.error] - 錯誤訊息
- * @returns {string}
- */
-export function formatImageResult(params) {
-  const { index, image } = params;
-  const imageNumber = index + 1;
-
-  const lines = [`### 圖片 ${imageNumber}\n`];
-
-  if (image.success) {
-    // 只有 HTTPS URL 才顯示圖片（Markdown 格式）
-    if (image.imageUrl?.startsWith('https://')) {
-      lines.push(`![Generated Image ${imageNumber}](${image.imageUrl})\n`);
-    }
-
-    if (image.gcsUri) {
-      lines.push(`- GCS URI: ${image.gcsUri}`);
-    }
-
-    if (image.expiresAt) {
-      lines.push(`- 有效期限: ${image.expiresAt}`);
-    }
-
-    if (image.imageUrl?.startsWith('data:')) {
-      lines.push('- 格式: Base64 (GCS 未設定)');
-    }
-  } else {
-    lines.push(`錯誤: ${image.error}`);
-  }
-
-  lines.push('');
-
-  return lines.join('\n');
-}
-
-/**
- * 格式化模型文字回應
- * @param {string} textResponse - 模型回應文字
- * @returns {string}
- */
-export function formatTextResponse(textResponse) {
-  if (!textResponse) {
-    return '';
-  }
-
-  return `**模型回應：**\n${textResponse}\n`;
-}
-
-/**
- * 格式化 Session 資訊（用於後續迭代）
- * @param {string} sessionId - Session ID
- * @returns {string}
- */
-export function formatSessionInfo(sessionId) {
-  if (!sessionId) {
-    return '';
-  }
-
-  return [
-    '',
-    '---',
-    '**迭代資訊：**',
-    `- Session ID: \`${sessionId}\``,
-    '- 如需修改此圖片，請使用 `--session` 參數',
-    '',
-    '範例：',
-    '```bash',
-    `node $HOME/.claude/skills/圖片生成技能/scripts/generate-image.mjs "修改描述" --session ${sessionId}`,
-    '```',
-    '',
-  ].join('\n');
-}
-
-/**
- * 格式化完整輸出
- * @param {Object} params - 參數
- * @param {Array} params.images - 上傳結果陣列
- * @param {string} params.textResponse - 模型回應
- * @param {string} params.sessionId - Session ID
- * @param {string} params.aspectRatio - 長寬比
- * @param {string} [params.style] - 藝術風格
- * @param {boolean} [params.isMultiTurn] - 是否為多輪對話
- * @returns {string}
- */
-export function formatFullOutput(params) {
-  const {
-    images,
-    textResponse,
-    sessionId,
-    aspectRatio,
-    style,
-    isMultiTurn = false,
-  } = params;
-
-  const parts = [];
-
-  // 統計資訊
-  parts.push(
-    formatStatistics({
-      imageCount: images.length,
-      aspectRatio,
-      style,
-      sessionId,
-      isMultiTurn,
-    })
-  );
-
-  // 每張圖片結果
-  for (let i = 0; i < images.length; i++) {
-    parts.push(formatImageResult({ index: i, image: images[i] }));
-  }
-
-  // 模型回應
-  if (textResponse) {
-    parts.push(formatTextResponse(textResponse));
-  }
-
-  // Session 資訊（用於後續迭代）
-  parts.push(formatSessionInfo(sessionId));
-
-  return parts.join('');
-}
-
-/**
- * 輸出到 stdout
- * @param {string} content - 輸出內容
- */
-export function output(content) {
-  console.log(content);
-}
-
-/**
- * 輸出錯誤訊息
- * @param {string} message - 錯誤訊息
- */
-export function outputError(message) {
-  console.error(`\n圖片生成失敗：${message}`);
-}
-
-/**
- * 輸出使用說明
- */
-export function outputUsage() {
-  console.error('請提供圖片描述');
-  console.error('');
-  console.error('Usage: node generate-image.mjs "prompt" [options]');
-  console.error('');
-  console.error('Options:');
-  console.error('  --aspect, -a    長寬比 (1:1, 16:9, 9:16, 21:9 等)');
-  console.error('  --style, -s     藝術風格 (photorealistic, anime, oil painting)');
-  console.error('  --negative, -n  要避免的元素');
-  console.error('  --temperature, -t  創意程度 (0-2)');
-  console.error('  --count, -c     生成數量 (1-4)');
-  console.error('  --session       Session ID（用於多輪迭代）');
-  console.error('');
-  console.error('Examples:');
-  console.error('  node generate-image.mjs "A serene Japanese garden"');
-  console.error('  node generate-image.mjs "Mountain" --aspect 16:9 --style "oil painting"');
-  console.error('  node generate-image.mjs "加上彩虹" --session abc123');
-}

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

@@ -1,20 +0,0 @@
-{
-  "name": "image-generator-scripts",
-  "version": "1.0.0",
-  "description": "圖片生成技能腳本",
-  "type": "module",
-  "main": "generate-image.mjs",
-  "scripts": {
-    "test": "echo 'Requires GOOGLE_CLOUD_PROJECT and GCS_BUCKET'"
-  },
-  "keywords": ["image-generation", "gemini", "vertex-ai", "gcs"],
-  "author": "Botrun",
-  "license": "MIT",
-  "dependencies": {
-    "@google-cloud/storage": "^7.15.0",
-    "@google/genai": "^1.30.0"
-  },
-  "overrides": {
-    "glob": "^11.0.0"
-  }
-}

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

@@ -1,115 +0,0 @@
-// ============================================================================
-// utils.mjs - 通用工具函式
-// 遵循 SOLID 原則：單一職責 - 只負責通用工具
-// ============================================================================
-
-import { randomUUID } from 'crypto';
-
-/**
- * 日誌輸出（輸出到 stderr，避免污染 stdout）
- * @param {...any} args - 日誌內容
- */
-export function log(...args) {
-  console.error('[Image-Generator]', ...args);
-}
-
-/**
- * 生成唯一的 Session ID
- * @returns {string} UUID 格式的 session ID
- */
-export function generateSessionId() {
-  return randomUUID();
-}
-
-/**
- * 生成唯一的檔案名稱
- * @param {number} index - 圖片索引
- * @returns {string} 唯一檔案名稱
- */
-export function generateFilename(index = 0) {
-  const timestamp = Date.now();
-  const uuid = randomUUID().substring(0, 8);
-  return `generated-${timestamp}-${uuid}-${index}.png`;
-}
-
-/**
- * 解析命令列參數
- * @param {string[]} args - 命令列參數陣列
- * @returns {Object} 解析後的參數物件
- */
-export function parseArgs(args) {
-  const result = {
-    prompt: null,
-    aspectRatio: '1:1',
-    style: null,
-    negativePrompt: null,
-    temperature: 1.0,
-    count: 1,
-    session: null, // 新增：session ID 用於多輪對話
-  };
-
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-
-    if (arg === '--aspect' || arg === '-a') {
-      result.aspectRatio = args[++i];
-    } else if (arg === '--style' || arg === '-s') {
-      result.style = args[++i];
-    } else if (arg === '--negative' || arg === '-n') {
-      result.negativePrompt = args[++i];
-    } else if (arg === '--temperature' || arg === '-t') {
-      result.temperature = parseFloat(args[++i]);
-    } else if (arg === '--count' || arg === '-c') {
-      result.count = parseInt(args[++i], 10);
-    } else if (arg === '--session') {
-      result.session = args[++i];
-    } else if (!arg.startsWith('-') && !result.prompt) {
-      result.prompt = arg;
-    }
-  }
-
-  return result;
-}
-
-/**
- * 建構完整的 prompt（包含風格和負面提示）
- * @param {string} basePrompt - 基礎 prompt
- * @param {Object} options - 選項
- * @param {string} [options.style] - 藝術風格
- * @param {string} [options.negativePrompt] - 負面提示
- * @returns {string} 完整的 prompt
- */
-export function buildFullPrompt(basePrompt, options = {}) {
-  const { style, negativePrompt } = options;
-
-  let fullPrompt = basePrompt;
-
-  if (style) {
-    fullPrompt = `${style} style: ${fullPrompt}`;
-  }
-
-  if (negativePrompt) {
-    fullPrompt = `${fullPrompt}. Avoid: ${negativePrompt}`;
-  }
-
-  return fullPrompt;
-}
-
-/**
- * 驗證參數有效性
- * @param {Object} params - 參數物件
- * @throws {Error} 如果參數無效
- */
-export function validateParams(params) {
-  if (!params.prompt) {
-    throw new Error('請提供圖片描述');
-  }
-
-  if (params.temperature < 0 || params.temperature > 2) {
-    throw new Error('temperature 必須在 0 到 2 之間');
-  }
-
-  if (params.count < 1 || params.count > 4) {
-    throw new Error('count 必須在 1 到 4 之間');
-  }
-}