botrun-horse 2.29.2 → 2.30.0

package/botrun-c/Gemfile.lock

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

@@ -0,0 +1,393 @@
+# 🚀 本機開發環境啟動指南
+
+**建立日期**：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