botrun-horse 2.29.2 → 2.30.0

package/botrun-c/.dockerignore

@@ -0,0 +1,131 @@
+# Node.js（全域排除）
+**/node_modules/
+node_modules/
+npm-debug.log
+yarn-error.log
+pnpm-debug.log
+.pnpm-store/
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# Git
+.git/
+.gitignore
+.gitattributes
+
+# CI/CD
+.github/
+
+# Documentation
+*.md
+!README.md
+!CLAUDE.md
+docs/
+bak/
+
+# Logs
+logs/
+*.log
+
+# Testing
+coverage/
+.nyc_output/
+**/__tests__/
+**/*.test.ts
+**/*.test.tsx
+**/*.spec.ts
+**/*.spec.tsx
+
+# Editor
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Build artifacts（全域排除）
+**/dist/
+dist/
+build/
+out/
+*.tgz
+
+# Backup
+bak/
+
+# Development directories (開發工具和臨時檔案，不應包含在 Docker image 中)
+dev/              # 開發工具，約 60MB
+tmp/              # 臨時檔案，約 60MB
+prototypes/       # 原型專案，約 247MB (包含 node_modules)
+.gemini-clipboard/  # 剪貼簿圖片，約 1MB
+users/            # 使用者資料目錄（本地測試用）
+admin/            # 管理腳本（非執行期需要）
+runtime-scripts/  # 執行期腳本（若不需要可排除）
+
+# Development scripts (除了 sh/env-detect.sh 是必要的)
+# sh/
+
+# API projects (local development/testing data - should NOT be deployed)
+api/projects/
+
+# User data directory (should NOT be deployed - production uses GCS mount, saves ~200MB)
+data/
+
+# Upload directory (should NOT be deployed - production uses GCS)
+uploads/
+
+# Test files
+tests/
+
+# Web frontend (NEEDED for unified deployment - do NOT exclude)
+# web/
+
+# Web build cache and output (exclude to reduce upload size and prevent cache invalidation)
+web/.next/
+web/.turbo/
+web/.vercel/
+web/next-env.d.ts
+web/firebase-debug.log
+web/out/
+
+# TypeScript
+*.tsbuildinfo
+**/*.tsbuildinfo
+
+# Logs（全域排除）
+logs/
+*.log
+
+# MCP Servers - 排除 node_modules 和編譯產物（Dockerfile 會自己建置）
+botrun-mcp-servers/**/node_modules/
+botrun-mcp-servers/**/dist/
+botrun-mcp-servers/**/*.log
+botrun-mcp-servers/**/.DS_Store
+
+# Skills - 排除 node_modules 和編譯產物（保留 SKILL.md 和程式碼）
+.claude/skills/**/node_modules/
+.claude/skills/**/dist/
+.claude/skills/**/*.log
+.claude/skills/**/.DS_Store
+
+# Test media files (audio, video) - 測試用的媒體檔案，不應包含在 Docker image
+*.mp3
+*.wav
+*.m4a
+*.aac
+*.ogg
+*.flac
+*.webm
+*.opus
+*.mp4
+*.mov
+*.avi
+*.mkv
+*.wmv

package/botrun-c/.dockeroptimize

@@ -0,0 +1,13 @@
+# Docker 映像優化腳本
+# 在 final stage 執行，刪除不必要的檔案以減小映像大小
+
+# 刪除 Claude Agent SDK 中不需要的檔案
+rm -rf /app/node_modules/@anthropic-ai/claude-agent-sdk/vendor/claude-code-jetbrains-plugin
+rm -rf /app/node_modules/@anthropic-ai/claude-agent-sdk/cli.js
+
+# 刪除 Sharp 原始檔案（如果你的靜態前端不需要動態處理圖片）
+# rm -rf /app/node_modules/@img
+
+# 清理 npm cache 和臨時檔案
+rm -rf /root/.npm
+rm -rf /tmp/*

package/botrun-c/.firebase/hosting.b3V0.cache

@@ -0,0 +1,30 @@
+index.txt,1761754918659,fa891ad26bba5fd8de3e79ca356d6230bade8ea9f29150ebf0b91e8070e5818d
+index.html,1761754918659,4887333a89ca50501fe56975ed358586ba75b3ff8531264daf95e9af4cd7777b
+404.html,1761754918659,d7bfcb684d6176fd2c89a279299c18ebe3e8d032a17781ed598414482e83aa28
+_next/static/xjgf6ZNdXTuQabs8hip8n/_ssgManifest.js,1761754918657,02dbc1aeab6ef0a6ff2ff9a1643158cf9bb38929945eaa343a3627dee9ba6778
+_next/static/xjgf6ZNdXTuQabs8hip8n/_buildManifest.js,1761754918658,a1d6ce5a18ef57054d2eb797becaafbc41676f1463cd97a4c8494a4771af4a58
+_next/static/media/e4af272ccee01ff0-s.p.woff2,1761754918659,28d3c49d99e0f60c3d54343c8188ada21c804877b2b1fd9acc1695bf6b47ef22
+_next/static/media/df0a9ae256c0569c-s.woff2,1761754918658,bbf2b69affb52c37fbd41b4c75ae7fc2f2421b70be2218dbe876cef0fcdc18a9
+_next/static/media/c5fe6dc8356a8c31-s.woff2,1761754918659,1a0e14609112860ada68bcd117557d881c437c49a652fc25f03478d32db23261
+_next/static/media/ba9851c3c22cd980-s.woff2,1761754918658,60bcc7eca099398d9118a54458d766e098397b9b59a1788046e101bc7797906b
+_next/static/media/8e9860b6e62d6359-s.woff2,1761754918658,865e90fb09b8be8261d53d6a40c80daa87669020b3d5fa186cb66c1944efca21
+_next/static/media/21350d82a1f187e9-s.woff2,1761754918658,a30747ba3d635d16cfc52331d3364bcbb1024d1d1bfe0e830e6329ef1e7dda23
+_next/static/media/19cfc7226ec3afaa-s.woff2,1761754918658,9158a62c685560cf2e28de5854b559863dc9dbda0bf98277ab1ed711bddd8a77
+_next/static/css/786754ab60d23fb1.css,1761754918654,b9f9ec767459c00a3dea08df5eedbcf363ed0c4febf40e2652713db21337cb05
+_next/static/chunks/webpack-e7cad3ae9fb1141e.js,1761754918655,8a4bebeb7f10eb78f14d1b0d379c80867a0e55ef9d0b8fd7aec1fba410c31c30
+_next/static/chunks/polyfills-42372ed130431b0a.js,1761754918657,67dee1c02c6a6700d63b5c1898cf2df618101a68a395db469192763d24925a23
+_next/static/chunks/main-c7238946be43b608.js,1761754918657,7e0449dc8a877acea667aef7f271a619c211b9f8910d7c1497c6896215a8c695
+_next/static/chunks/main-app-4897dd7f629eecb4.js,1761754918656,36b5cfe4cfb066d82c084d85279a87ff022956d9599cd5613994504fa3aada21
+_next/static/chunks/framework-00a8ba1a63cfdc9e.js,1761754918655,aeb3fa38e1f12bf9e53c0b361d77ea9d6cfb4f61ac21adf8a537249897952a28
+_next/static/chunks/fd9d1056-66408495c002d330.js,1761754918656,0469b536a9beb87a0ab84d3b3ccc70976e30fdd17dd2349bb56296a5651fba5f
+_next/static/chunks/b1644e8c-82f40f46515a9ac4.js,1761754918655,97c2761906462721262e1356a6e2956027d2a9cdcadd4125f3b588dfbb7a1ef0
+_next/static/chunks/498-8d108853e060d017.js,1761754918656,47a11de3d3d7c6f8a1f054c14c728d837dab5cf00be25d188e1fb8c89de0fd7c
+_next/static/chunks/479-5e780cd13c7b787d.js,1761754918656,9b927fc14097eb9a7be61e0f28026420b953bc4cfaed82d23f413c3a02dac55b
+_next/static/chunks/281-b0d1894b4fab09e1.js,1761754918657,412eace762bc3cceb25ac34e59dc48a47e71c34847de4ba6a46c3169cbec9969
+_next/static/chunks/261b60bd-6c21e547ce137f76.js,1761754918654,ef84313e2e013551c8d18f311d1d11df065c21f3cc17339112aaf56cae032d04
+_next/static/chunks/117-7c6bfb3e4083e578.js,1761754918657,ea402debb508850760df4dce4e47998957257253489c7d2601390cdc2c20a20c
+_next/static/chunks/pages/_error-28b803cb2479b966.js,1761754918656,4aceb828d82ae3033dbde9b5f1e496fcaa7eccc0834add39a212e0ada1d38af1
+_next/static/chunks/pages/_app-15e2daefa259f0b5.js,1761754918657,37e6a033ed035f11e73b22db4f7db0e6c57a00782844a34bc40c99fc76f8abda
+_next/static/chunks/app/page-e36aacb6fd761a6f.js,1761754918655,0f91578e6b10d097cff320f9ace0b47e3fef2286da2b6775a29c89f1d4755e7c
+_next/static/chunks/app/layout-8c5016584c3d4640.js,1761754918655,996004490eecc7d273ae56192e8fcfc272c2d6a81b72a5ec3f5b11b7068eaa9c
+_next/static/chunks/app/_not-found/page-e6a651cc5ac898f8.js,1761754918655,4a86c29d990cb5ddd68a6e611a6f72c418af5a37066c9f13a2d48e8cd3ad22ef

package/botrun-c/.firebaserc

@@ -0,0 +1,5 @@
+{
+  "projects": {
+    "default": "botrun-c"
+  }
+}

package/botrun-c/.gcloudignore

@@ -0,0 +1,56 @@
+# GCP Cloud Run deployment ignore file
+# This file specifies files that are *not* uploaded to Google Cloud
+
+.gcloudignore
+.git
+.gitignore
+
+# Node.js
+node_modules/
+npm-debug.log
+
+# Environment
+.env
+.env.*
+!.env.example
+
+# Documentation
+*.md
+!README.md
+docs/
+
+# Logs
+logs/
+*.log
+
+# Backup
+bak/
+
+# Development
+sh/
+.vscode/
+.idea/
+
+# Web frontend (NEEDED for unified deployment - do NOT exclude)
+# web/
+
+# Testing
+coverage/
+__tests__/
+
+# Build artifacts (we use tsx in production)
+dist/
+build/
+
+# OS
+.DS_Store
+
+# iOS build files
+mobile-ios/ios-build/
+mobile-ios/*.png
+
+# Web build artifacts
+web/.version
+web/scripts/
+web/.next/
+web/out/

package/botrun-c/.ruby-version

@@ -0,0 +1 @@
+3.3.0

package/botrun-c/CHANGELOG.md

@@ -0,0 +1,224 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [5.1224.1540] - 2025-12-24
+
+### Added (server 端)
+- **音訊轉錄三階段 Fallback 機制**：新增 [Spot VM Whisper](https://github.com/botrun/whisper-gcp-spot-vm) 作為第二階段容錯
+  - 階段 1: NCHC Whisper (retry 3 次)
+  - 階段 2: Spot VM Whisper (retry 3 次) - 新增，使用 Google Spot VM 降低成本
+  - 階段 3: Cloud Run Whisper (retry 3 次)
+  - 每階段失敗時發送 Webhook 告警通知
+  - 支援 OpenCC 簡體轉台灣繁體中文用語 (cn → twp)
+  - 詳細技術說明：[Spot VM Whisper 架構文件](https://docs.google.com/presentation/d/1ABl1-lUhfwBqID0nlAyh8l9moxEN6tMz/edit?slide=id.p1#slide=id.p1)
+
+
+## [5.1218.1734] - 2025-12-18
+
+### Added
+- **分享技能功能**：可以在技能中建立分享連結，其他人可以透過此連結將技能匯入到自己的技能集
+
+## [1.6.4] - 2025-12-18
+
+### Fixed (iOS)
+- **移除測試按鈕**：在檔案上傳的按鈕，移除測試錄音的按鈕
+
+## [5.1216.1629] - 2025-12-16
+
+### Added (server 端)
+- **音訊轉錄 Fallback 機制**：NCHC Whisper → Cloud Run Whisper 雙重容錯
+  - 每個服務各支援 3 次重試（指數退避 + Jitter）
+  - NCHC 失敗後自動切換到 Cloud Run Whisper
+  - 加入詳細 debug 訊息，方便追蹤問題
+- **Cloud Run Whisper 整合**：使用 [whisper-cpp-tw](https://github.com/botrun/whisper-cpp-tw) 部署在 Google Cloud Run (Taiwan)
+  - 自動將簡體中文轉換為台灣繁體用語 (OpenCC: cn → twp)
+
+## [1.6.3] - 2025-12-12
+
+### Added
+- **響應式圖片檢視器（Dialog 版本）**：使用 shadcn/ui Dialog 實作全螢幕圖片預覽
+  - 支援縮放、平移、雙擊重置功能 (react-zoom-pan-pinch)
+  - 響應式按鈕配置：桌面版右上角並排顯示下載與關閉按鈕，手機版關閉按鈕置於右上角、下載按鈕置於底部中央
+  - 按鈕尺寸符合 Apple HIG 標準 (48x48px)
+  - 支援 ESC 鍵關閉（Radix UI 內建）
+  - 整合 Capacitor Share API，iOS/Android 可直接儲存圖片
+- **前端自動重試機制**：間歇性連線錯誤透明處理，提升使用體驗
+- **部署工具強化**：新增 `--new` 選項支援自訂端點部署
+
+### Changed
+- **UI 優化**：
+  - 重構選單佈局（右上角選單順序調整與左下角上傳按鈕簡化）
+  - 技能孵化器 icon 改為榔頭 (Hammer)
+  - 波特人孵化器更名為指揮家孵化器
+  - AI 回應文字改為純黑色（覆寫 prose 預設灰色）
+
+### Fixed
+- **全形標點符號顯示修復**：全形逗號（，）現在可以正常顯示
+  - 暫時停用全形轉半形功能，避免中文標點符號被錯誤轉換
+- **孵化技能修復**：修正 SKILL.md 使用錯誤環境變數導致腳本找不到
+- **HTML 生成技能修復**：修正路徑不一致導致預覽失敗
+- **轉錄錯誤 UI 排版修復**：小螢幕上按鈕不再被截斷，X 按鈕不再與文字重疊
+  - 使用 Tailwind responsive utilities 實現響應式按鈕排版（手機垂直堆疊，桌面水平排列）
+- **圖片展示修復**：移除測試用草莓圖片，修正 `toolUses is not defined` 錯誤
+
+## [1.6.2] - 2025-12-10
+
+### Fixed
+- **M4A 錄音分段失敗修復**：FFmpeg 動態匹配輸入格式，支援 M4A/MP3/WebM 等格式
+- **轉錄狀態顯示恢復**：琥珀色背景雙行文字設計，顯示上傳與轉錄進度
+
+### Changed
+- **動態 MIME 偵測**：使用 file-type 套件從二進位內容偵測真實檔案格式
+- **測試工具強化**：新增 Android/iOS 真實錄音測試按鈕
+
+## [1.6.1] - 2025-12-09
+
+### Changed
+- **錄音下載功能改進**（iOS/Android）
+  - 改用系統分享面板，使用者可選擇儲存位置或分享到其他 App
+  - 取消分享不再顯示錯誤訊息
+
+## [5.1209.1523] - 2025-12-09
+
+### Improved
+- **音訊分段轉錄效能優化**：Server 端
+  - 加入 Retry 機制的 Jitter（防止 Thundering Herd 問題）
+  - 實作錯誤分類：5xx 伺服器錯誤重試，4xx 客戶端錯誤立即失敗
+  - 支援網路錯誤重試（fetch failed, timeout, ECONNRESET, ETIMEDOUT）
+  - 指數退避時間：1s, 2s, 4s + 隨機 Jitter (0-1000ms)
+  - 成功率從 96% 提升至 100%（120 個並發片段零失敗）
+
+## [1.6.0] - 2025-12-09
+
+### Added
+- **圖片直接顯示**：生成的圖片現在直接顯示在對話中，手機 app 不再需要自己找 URL 貼到瀏覽器
+  - 支援點擊放大查看
+  - 支援下載儲存
+  - 支援多輪迭代修改圖片（可以要求調整細節）
+- **孵化技能系統**：可以在對話中建立、修改、刪除自訂技能
+  - 支援完整的技能 CRUD 操作
+  - 自動載入新建立的技能，無需重啟
+- **HTML 生成技能**：可以生成多檔案 HTML 專案（支援 CSS、JS）
+- **互動卡片技能**：在對話中嵌入可互動的 HTML 卡片
+- **永久記憶功能**：記憶/回憶技能，可永久儲存重要資訊
+- **網路搜尋強化**：支援多關鍵字平行搜尋，智慧拆解複雜問題
+
+### Changed
+- **複製功能大幅改進**：
+  - 複製按鈕現在同時複製純文字和 HTML 格式
+  - 純文字自動移除 Markdown 符號（**、*、# 等）
+  - 貼到 Word 等應用時會保留格式（粗體、斜體、標題等）
+- **UI 優化**：
+  - Email 發送成功提示 0.8 秒後自動消失
+  - 簡化錄音介面，移除冗餘的狀態提示
+  - 工具結果顯示從 "MCP Response" 更名為 "Tool Response"
+- **語音功能整合**：語音轉文字完成後自動啟動會議記錄技能進行文字整理
+
+### Fixed
+- 修正圖片生成技能路徑與 Session 迭代問題
+- 修正連續工具呼叫結果被覆蓋問題
+- 修正 HTML 預覽 404 問題
+- 修正記憶/回憶技能安全性漏洞
+- 修正技能環境變數路徑展開失敗問題（現在首輪即可成功執行）
+
+### Security
+- 啟用 Read 工具並強化 Read/Write 路徑安全驗證
+- HTML 預覽改用 Token-based 公開連結（支援 O(1) 定位）
+- 修補 CVE-2025-55182 及 10 項安全漏洞
+- 強化技能路徑驗證機制，防止路徑穿越攻擊
+
+## [1.5.0] - 2025-12-04
+
+### Added
+- 統一附件系統，支援貼上/拖放/點選上傳檔案 (Web有拖放功能, iOS/Android沒有拖放)
+- Admin CLI 新增批次建立使用者功能 (`batch provision`)
+- Admin CLI 新增延長訂閱功能 (`subscription extend`)
+- 網路搜尋技能，取代原有 MCP web-search
+- PDF 技能 v2.0 智慧決策樹版本（支援壓縮/切割/轉文字）
+- 長錄音上傳測試工具與文件
+
+### Changed
+- 全面遷移 MCP Servers 至 Skills 架構
+- Skills 使用 symlink 減少 Docker 映像檔大小（節省 ~71MB）
+- GET /api/skills 端點根據平台（Web/iOS/Android）區分回傳技能列表
+- 全站字體縮小 10%（144% → 130%）
+- AI 頭像改為黃色並縮小字體 5%
+
+### Fixed
+- 修正 Bash 工具相對路徑遍歷攻擊漏洞
+- 修正 PreToolUse Hook bashAllowedScriptPaths undefined 錯誤
+- 修正 OpenCC「報名表→報名錶」誤判問題
+- 修正 Docker 建置 Capawesome Registry 連線超時問題
+
+### Security
+- 實作 Bash 工具 5 層安全驗證機制
+- 新增 PreToolUse Hook 路徑安全驗證
+
+### Removed
+- 移除 timestamp-proof 技能
+- 隱藏「+」下拉選單中的技能列表顯示
+
+## [1.4.2] - 2025-11-27
+### Updated - iOS & Android
+- 預設 API URL 改成 app.botrun.ai
+
+### Updated - iOS
+- iOS 使用 @capawesome/capacitor-app-update 套件來偵測有沒有更新 (原本的邏輯還是會留著)
+
+### Fixed - Chat
+- 修正對話閒置過久導致無法繼續的問題 (Claude Code process exited)。
+- 實作自動重試機制：當 Session 失效時，自動開啟新對話並重送訊息。
+- **已知限制**：自動重試後會失去該次對話的短期記憶 (Context)。
+- 詳情請參考文件：[Claude Agent Session Persistence](docs/claude-agent-session-persistence.md)
+
+## [1.4.1] - 2025-11-25
+### Fixed - iOS & Android
+- capawesome 有 LiveUpdate enable 的設定，目前的程式沒有去讀取，改成會讀取
+- 關閉 capawesome LiveUpdate 的功能，一直無法掌握它的更新時機
+
+## [5.1125.1614] - 2025-11-25
+
+### Updated - iOS & Android
+- 送訊息的時候，如果 api連不到，不會出現 api url 的 錯誤訊息，會比較人性化一點
+- 對話時，ios, android 不會自動 focus text input
+
+## [1.4.0] - 2025-11-24
+
+### Added - iOS & Android
+- 支援 Capawesome Live Update，實現 OTA 更新功能
+
+## [1.3.9] - 2025-11-20
+
+### Added - Android
+- Android 版本更新檢測功能，可偵測 Google Play 是否有新版本
+- 版本更新提示導向 Google Play Store
+- 右上角選單，會顯示自己的頭像與 email
+
+## [1.3.2] - 2025-11-20
+
+### Fixed - iOS
+- iTunes API 加上 timestamp 參數，防止快取導致版本檢測錯誤
+
+## [1.3.0] - 2025-11-19
+
+### Added - iOS
+- App 版本更新檢測功能，啟動時自動檢查是否有新版本
+- 版本更新提示移至右側選單，提升使用者體驗
+- 選單紅點提示功能，每次重新開啟 app 時顯示更新通知
+
+## [1.2.2] - 2025-11-19
+
+### Fixed - iOS
+- 修正 API URL 讀取問題，確保 mobile app 正確連接後端服務
+
+---
+
+[Unreleased]: https://github.com/botrun/botrun-c/compare/v1.3.0...HEAD
+[1.3.0]: https://github.com/botrun/botrun-c/compare/v1.2.2...v1.3.0
+[1.2.2]: https://github.com/botrun/botrun-c/releases/tag/v1.2.2