botrun-horse 2.31.0 → 2.35.0

package/botrun-c/Gemfile.lock

@@ -1,233 +0,0 @@
-GEM
-  remote: https://rubygems.org/
-  specs:
-    CFPropertyList (3.0.8)
-    addressable (2.8.7)
-      public_suffix (>= 2.0.2, < 7.0)
-    artifactory (3.0.17)
-    atomos (0.1.3)
-    aws-eventstream (1.4.0)
-    aws-partitions (1.1182.0)
-    aws-sdk-core (3.237.0)
-      aws-eventstream (~> 1, >= 1.3.0)
-      aws-partitions (~> 1, >= 1.992.0)
-      aws-sigv4 (~> 1.9)
-      base64
-      bigdecimal
-      jmespath (~> 1, >= 1.6.1)
-      logger
-    aws-sdk-kms (1.117.0)
-      aws-sdk-core (~> 3, >= 3.234.0)
-      aws-sigv4 (~> 1.5)
-    aws-sdk-s3 (1.203.1)
-      aws-sdk-core (~> 3, >= 3.234.0)
-      aws-sdk-kms (~> 1)
-      aws-sigv4 (~> 1.5)
-    aws-sigv4 (1.12.1)
-      aws-eventstream (~> 1, >= 1.0.2)
-    babosa (1.0.4)
-    base64 (0.3.0)
-    bigdecimal (3.3.1)
-    claide (1.1.0)
-    colored (1.2)
-    colored2 (3.1.2)
-    commander (4.6.0)
-      highline (~> 2.0.0)
-    declarative (0.0.20)
-    digest-crc (0.7.0)
-      rake (>= 12.0.0, < 14.0.0)
-    domain_name (0.6.20240107)
-    dotenv (2.8.1)
-    emoji_regex (3.2.3)
-    excon (0.112.0)
-    faraday (1.10.4)
-      faraday-em_http (~> 1.0)
-      faraday-em_synchrony (~> 1.0)
-      faraday-excon (~> 1.1)
-      faraday-httpclient (~> 1.0)
-      faraday-multipart (~> 1.0)
-      faraday-net_http (~> 1.0)
-      faraday-net_http_persistent (~> 1.0)
-      faraday-patron (~> 1.0)
-      faraday-rack (~> 1.0)
-      faraday-retry (~> 1.0)
-      ruby2_keywords (>= 0.0.4)
-    faraday-cookie_jar (0.0.8)
-      faraday (>= 0.8.0)
-      http-cookie (>= 1.0.0)
-    faraday-em_http (1.0.0)
-    faraday-em_synchrony (1.0.1)
-    faraday-excon (1.1.0)
-    faraday-httpclient (1.0.1)
-    faraday-multipart (1.1.1)
-      multipart-post (~> 2.0)
-    faraday-net_http (1.0.2)
-    faraday-net_http_persistent (1.2.0)
-    faraday-patron (1.0.0)
-    faraday-rack (1.0.0)
-    faraday-retry (1.0.3)
-    faraday_middleware (1.2.1)
-      faraday (~> 1.0)
-    fastimage (2.4.0)
-    fastlane (2.228.0)
-      CFPropertyList (>= 2.3, < 4.0.0)
-      addressable (>= 2.8, < 3.0.0)
-      artifactory (~> 3.0)
-      aws-sdk-s3 (~> 1.0)
-      babosa (>= 1.0.3, < 2.0.0)
-      bundler (>= 1.12.0, < 3.0.0)
-      colored (~> 1.2)
-      commander (~> 4.6)
-      dotenv (>= 2.1.1, < 3.0.0)
-      emoji_regex (>= 0.1, < 4.0)
-      excon (>= 0.71.0, < 1.0.0)
-      faraday (~> 1.0)
-      faraday-cookie_jar (~> 0.0.6)
-      faraday_middleware (~> 1.0)
-      fastimage (>= 2.1.0, < 3.0.0)
-      fastlane-sirp (>= 1.0.0)
-      gh_inspector (>= 1.1.2, < 2.0.0)
-      google-apis-androidpublisher_v3 (~> 0.3)
-      google-apis-playcustomapp_v1 (~> 0.1)
-      google-cloud-env (>= 1.6.0, < 2.0.0)
-      google-cloud-storage (~> 1.31)
-      highline (~> 2.0)
-      http-cookie (~> 1.0.5)
-      json (< 3.0.0)
-      jwt (>= 2.1.0, < 3)
-      mini_magick (>= 4.9.4, < 5.0.0)
-      multipart-post (>= 2.0.0, < 3.0.0)
-      naturally (~> 2.2)
-      optparse (>= 0.1.1, < 1.0.0)
-      plist (>= 3.1.0, < 4.0.0)
-      rubyzip (>= 2.0.0, < 3.0.0)
-      security (= 0.1.5)
-      simctl (~> 1.6.3)
-      terminal-notifier (>= 2.0.0, < 3.0.0)
-      terminal-table (~> 3)
-      tty-screen (>= 0.6.3, < 1.0.0)
-      tty-spinner (>= 0.8.0, < 1.0.0)
-      word_wrap (~> 1.0.0)
-      xcodeproj (>= 1.13.0, < 2.0.0)
-      xcpretty (~> 0.4.1)
-      xcpretty-travis-formatter (>= 0.0.3, < 2.0.0)
-    fastlane-plugin-firebase_app_distribution (0.10.1)
-      google-apis-firebaseappdistribution_v1 (~> 0.3.0)
-      google-apis-firebaseappdistribution_v1alpha (~> 0.2.0)
-    fastlane-sirp (1.0.0)
-      sysrandom (~> 1.0)
-    gh_inspector (1.1.3)
-    google-apis-androidpublisher_v3 (0.54.0)
-      google-apis-core (>= 0.11.0, < 2.a)
-    google-apis-core (0.11.3)
-      addressable (~> 2.5, >= 2.5.1)
-      googleauth (>= 0.16.2, < 2.a)
-      httpclient (>= 2.8.1, < 3.a)
-      mini_mime (~> 1.0)
-      representable (~> 3.0)
-      retriable (>= 2.0, < 4.a)
-      rexml
-    google-apis-firebaseappdistribution_v1 (0.3.0)
-      google-apis-core (>= 0.11.0, < 2.a)
-    google-apis-firebaseappdistribution_v1alpha (0.2.0)
-      google-apis-core (>= 0.11.0, < 2.a)
-    google-apis-iamcredentials_v1 (0.17.0)
-      google-apis-core (>= 0.11.0, < 2.a)
-    google-apis-playcustomapp_v1 (0.13.0)
-      google-apis-core (>= 0.11.0, < 2.a)
-    google-apis-storage_v1 (0.31.0)
-      google-apis-core (>= 0.11.0, < 2.a)
-    google-cloud-core (1.8.0)
-      google-cloud-env (>= 1.0, < 3.a)
-      google-cloud-errors (~> 1.0)
-    google-cloud-env (1.6.0)
-      faraday (>= 0.17.3, < 3.0)
-    google-cloud-errors (1.5.0)
-    google-cloud-storage (1.47.0)
-      addressable (~> 2.8)
-      digest-crc (~> 0.4)
-      google-apis-iamcredentials_v1 (~> 0.1)
-      google-apis-storage_v1 (~> 0.31.0)
-      google-cloud-core (~> 1.6)
-      googleauth (>= 0.16.2, < 2.a)
-      mini_mime (~> 1.0)
-    googleauth (1.8.1)
-      faraday (>= 0.17.3, < 3.a)
-      jwt (>= 1.4, < 3.0)
-      multi_json (~> 1.11)
-      os (>= 0.9, < 2.0)
-      signet (>= 0.16, < 2.a)
-    highline (2.0.3)
-    http-cookie (1.0.8)
-      domain_name (~> 0.5)
-    httpclient (2.9.0)
-      mutex_m
-    jmespath (1.6.2)
-    json (2.16.0)
-    jwt (2.10.2)
-      base64
-    logger (1.7.0)
-    mini_magick (4.13.2)
-    mini_mime (1.1.5)
-    multi_json (1.17.0)
-    multipart-post (2.4.1)
-    mutex_m (0.3.0)
-    nanaimo (0.4.0)
-    naturally (2.3.0)
-    optparse (0.8.0)
-    os (1.1.4)
-    plist (3.7.2)
-    public_suffix (6.0.2)
-    rake (13.3.1)
-    representable (3.2.0)
-      declarative (< 0.1.0)
-      trailblazer-option (>= 0.1.1, < 0.2.0)
-      uber (< 0.2.0)
-    retriable (3.1.2)
-    rexml (3.4.4)
-    rouge (3.28.0)
-    ruby2_keywords (0.0.5)
-    rubyzip (2.4.1)
-    security (0.1.5)
-    signet (0.21.0)
-      addressable (~> 2.8)
-      faraday (>= 0.17.5, < 3.a)
-      jwt (>= 1.5, < 4.0)
-      multi_json (~> 1.10)
-    simctl (1.6.10)
-      CFPropertyList
-      naturally
-    sysrandom (1.0.5)
-    terminal-notifier (2.0.0)
-    terminal-table (3.0.2)
-      unicode-display_width (>= 1.1.1, < 3)
-    trailblazer-option (0.1.2)
-    tty-cursor (0.7.1)
-    tty-screen (0.8.2)
-    tty-spinner (0.9.3)
-      tty-cursor (~> 0.7)
-    uber (0.1.0)
-    unicode-display_width (2.6.0)
-    word_wrap (1.0.0)
-    xcodeproj (1.27.0)
-      CFPropertyList (>= 2.3.3, < 4.0)
-      atomos (~> 0.1.3)
-      claide (>= 1.0.2, < 2.0)
-      colored2 (~> 3.1)
-      nanaimo (~> 0.4.0)
-      rexml (>= 3.3.6, < 4.0)
-    xcpretty (0.4.1)
-      rouge (~> 3.28.0)
-    xcpretty-travis-formatter (1.0.1)
-      xcpretty (~> 0.2, >= 0.0.7)
-
-PLATFORMS
-  arm64-darwin-25
-  ruby
-
-DEPENDENCIES
-  fastlane
-  fastlane-plugin-firebase_app_distribution
-
-BUNDLED WITH
-   2.7.2

package/botrun-c/LOCAL-DEVELOPMENT-GUIDE.md

@@ -1,393 +0,0 @@
-# 🚀 本機開發環境啟動指南
-
-**建立日期**：2025-11-06
-**適用範圍**：Botrun-C 完整開發環境（Web + API）
-
----
-
-## 📋 前置需求
-
-### 必備工具
-- ✅ **Node.js 18+** (建議使用 20 LTS)
-- ✅ **npm** 或 **pnpm**
-- ✅ **Google Cloud SDK** (gcloud CLI)
-- ✅ **Firebase 帳號** (已設定專案)
-
-### 選用工具
-- **Visual Studio Code** + Extensions
-  - ESLint
-  - Prettier
-  - TypeScript
-
----
-
-## 🏗️ 專案架構
-
-```
-botrun-c/
-├── web/              # Next.js 16 前端（Port 3000）
-├── api/              # Hono 後端 API（Port 8000）
-├── mobile-ios/       # Capacitor iOS 專案
-├── mobile-android/   # Capacitor Android 專案（待建立）
-├── botrun-mcp-servers/  # MCP Servers（PDF、搜尋等）
-└── data/            # 本地使用者資料（開發用）
-```
-
----
-
-## 📦 步驟 1：安裝依賴
-
-### 1.1 安裝根目錄依賴（如果使用 pnpm workspace）
-
-```bash
-cd /home/bigcookie/github/botrun-c
-npm install
-```
-
-### 1.2 安裝 Web 前端依賴
-
-```bash
-cd web
-npm install
-```
-
-### 1.3 安裝 API 後端依賴
-
-```bash
-cd ../api
-npm install
-```
-
----
-
-## 🔐 步驟 2：設定環境變數
-
-### 2.1 Web 前端環境變數
-
-**檢查現有配置**：
-```bash
-cd web
-ls -la .env*
-```
-
-你已經有 `.env.development`，裡面包含 Firebase 配置。
-
-**建立 `.env.local`**（設定 API URL）：
-```bash
-cat > .env.local <<EOF
-# API Server URL
-NEXT_PUBLIC_API_URL=http://localhost:8000
-EOF
-```
-
-**驗證配置**：
-```bash
-cat .env.development
-cat .env.local
-```
-
-### 2.2 API 後端環境變數
-
-**建立 `.env`**：
-```bash
-cd ../api
-cat > .env <<EOF
-# Server Configuration
-PORT=8000
-
-# Vertex AI Configuration
-CLAUDE_CODE_USE_VERTEX=1
-GOOGLE_CLOUD_PROJECT=scoop-386004
-GOOGLE_CLOUD_REGION=asia-northeast1
-GOOGLE_CLOUD_LOCATION=asia-northeast1
-
-# GCS Configuration (開發用)
-GCS_BUCKET=scoop-386004-user-data
-GCS_FILE_TTL=3600
-
-# Development Mode
-NODE_ENV=development
-EOF
-```
-
-**⚠️ 不要設定 ANTHROPIC_API_KEY**：專案強制使用 Vertex AI（台灣法規要求）
-
----
-
-## 🔑 步驟 3：設定 Google Cloud 認證
-
-### 3.1 檢查 gcloud 認證狀態
-
-```bash
-gcloud auth list
-gcloud config get-value project
-```
-
-### 3.2 如果尚未登入
-
-```bash
-# 登入 Google Cloud
-gcloud auth login
-
-# 設定預設專案
-gcloud config set project scoop-386004
-
-# 設定 Application Default Credentials（重要！）
-gcloud auth application-default login
-```
-
-### 3.3 驗證認證
-
-```bash
-# 測試 Vertex AI 存取
-gcloud services list --enabled | grep aiplatform
-```
-
----
-
-## 🔥 步驟 4：設定 Firebase Admin SDK（選用）
-
-如果需要完整功能（檔案上傳、使用者驗證），需要 Firebase Admin SDK。
-
-### 4.1 下載 Service Account Key
-
-1. 前往 [Firebase Console](https://console.firebase.google.com)
-2. 選擇專案 **confidential-botrun-c9e39**
-3. **專案設定** → **服務帳戶**
-4. **產生新的私密金鑰** → 下載 JSON
-
-### 4.2 放置 Service Account Key
-
-```bash
-cd api
-mkdir -p keys
-mv ~/Downloads/confidential-botrun-c9e39-*.json keys/firebase-admin-key.json
-```
-
-### 4.3 驗證檔案存在
-
-```bash
-ls -la keys/firebase-admin-key.json
-```
-
-**⚠️ 注意**：此檔案已加入 `.gitignore`，不會被提交到 Git。
-
----
-
-## 🚀 步驟 5：啟動服務
-
-### 5.1 啟動 API 服務（Terminal 1）
-
-```bash
-cd api
-npm run dev
-```
-
-**預期輸出**：
-```
-✅ [Firebase] Initialized with service account.
-✅ [Version] Loaded: 5.1103.1823
-🚀 Server is running on http://localhost:8000
-```
-
-**常見錯誤排除**：
-- **Port 8000 already in use**：改 `.env` 中的 `PORT=8001`
-- **Firebase error**：確認 `keys/firebase-admin-key.json` 存在
-- **Vertex AI error**：確認 `gcloud auth application-default login` 已執行
-
-### 5.2 啟動 Web 前端（Terminal 2）
-
-```bash
-cd web
-npm run dev
-```
-
-**預期輸出**：
-```
-▲ Next.js 16.0.1 (turbo)
-- Local:        http://localhost:3000
-- Network:      http://192.168.x.x:3000
-
-✓ Ready in 2.3s
-```
-
----
-
-## 🧪 步驟 6：驗證功能
-
-### 6.1 開啟瀏覽器
-
-```bash
-open http://localhost:3000
-```
-
-### 6.2 測試清單
-
-- [ ] **首頁載入正常**
-- [ ] **Firebase 登入**：點擊「Sign in with Google」
-- [ ] **Chat 功能**：送出訊息並取得回應
-- [ ] **錄音功能**：點擊麥克風按鈕測試
-- [ ] **檔案上傳**：測試上傳 PDF 檔案
-
-### 6.3 檢查 API 日誌
-
-回到 Terminal 1 查看 API 日誌，確認請求正常：
-```
-📡 [Chat] New chat request from user: user@example.com
-✅ [Chat] Response sent successfully
-```
-
----
-
-## 🐛 常見問題排解
-
-### Q1: Web 無法連線到 API
-
-**檢查**：
-```bash
-# 確認 API 正在運行
-curl http://localhost:8000/health
-
-# 確認 .env.local 設定正確
-cat web/.env.local
-```
-
-**解決**：
-- 確保 API 服務已啟動（Terminal 1）
-- 確認 `NEXT_PUBLIC_API_URL=http://localhost:8000`
-
-### Q2: Firebase Auth 失敗
-
-**檢查**：
-```bash
-cat web/.env.development | grep FIREBASE
-```
-
-**解決**：
-- 確認 Firebase 配置正確
-- 確認 Firebase Console 已啟用 Google Sign-In
-- 確認瀏覽器允許彈出視窗
-
-### Q3: Vertex AI 錯誤
-
-**錯誤訊息**：`401 Unauthorized` 或 `403 Forbidden`
-
-**解決**：
-```bash
-# 重新登入 Application Default Credentials
-gcloud auth application-default login
-
-# 確認專案正確
-gcloud config get-value project
-
-# 確認 Vertex AI API 已啟用
-gcloud services enable aiplatform.googleapis.com
-```
-
-### Q4: 檔案上傳失敗
-
-**檢查**：
-```bash
-# 確認 data/ 目錄存在且可寫入
-ls -la data/
-mkdir -p data
-
-# 測試 GCS 存取（如果使用 GCS）
-gsutil ls gs://scoop-386004-user-data/
-```
-
-### Q5: 錄音功能無法使用
-
-**瀏覽器要求**：
-- 必須使用 **HTTPS** 或 **localhost**
-- 必須授予麥克風權限
-
-**解決**：
-- 確認瀏覽器顯示「允許使用麥克風」提示
-- 檢查瀏覽器設定 → 隱私權 → 麥克風
-
----
-
-## 🔄 開發工作流程
-
-### 日常開發
-
-1. **早上啟動**：
-   ```bash
-   # Terminal 1
-   cd api && npm run dev
-
-   # Terminal 2
-   cd web && npm run dev
-   ```
-
-2. **修改程式碼**：
-   - Next.js 會自動熱更新（Hot Reload）
-   - API 使用 `tsx watch` 會自動重啟
-
-3. **晚上關閉**：
-   - 兩個 Terminal 都按 `Ctrl + C`
-
-### 測試新功能
-
-```bash
-# 清除快取重新開始
-cd web
-rm -rf .next
-npm run dev
-```
-
-### 檢查型別錯誤
-
-```bash
-# Web 型別檢查
-cd web
-npx tsc --noEmit
-
-# API 型別檢查
-cd api
-npm run type-check
-```
-
----
-
-## 📊 效能優化建議
-
-### Next.js Turbopack（已啟用）
-
-- ✅ 建置速度提升 **10 倍**
-- ✅ 熱更新速度更快
-
-### 開發模式下停用的功能
-
-為了加快開發速度，以下功能在 `next.config.js` 中已停用：
-- ❌ TypeScript 型別檢查（`ignoreBuildErrors: true`）
-- ❌ ESLint 檢查（`ignoreDuringBuilds: true`）
-- ❌ Console 移除
-
-**建議**：定期執行 `npx tsc --noEmit` 確保沒有型別錯誤。
-
----
-
-## 🎯 下一步
-
-完成本機開發環境設定後，你可以：
-
-1. ✅ **開始 Capacitor 整合**（參考 `TODO-CAPACITOR-INTEGRATION.md`）
-2. ✅ **測試現有功能**（Chat、錄音、檔案上傳）
-3. ✅ **準備 mobile-ios 和 mobile-android**
-
----
-
-## 📚 參考文件
-
-- [Next.js 16 文件](https://nextjs.org/docs)
-- [Hono 文件](https://hono.dev/)
-- [Vertex AI 文件](https://cloud.google.com/vertex-ai/docs)
-- [Firebase 文件](https://firebase.google.com/docs)
-- [Claude Agent SDK](https://github.com/anthropics/claude-agent-sdk)
-
----
-
-**最後更新**：2025-11-06
-**維護者**：Botrun Team