botrun-horse 2.29.2 → 2.30.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

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

@@ -0,0 +1,219 @@
+// ============================================================================
+// 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

@@ -0,0 +1,209 @@
+// ============================================================================
+// 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

@@ -0,0 +1,20 @@
+{
+  "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

@@ -0,0 +1,115 @@
+// ============================================================================
+// 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 之間');
+  }
+}