botrun-horse 2.29.2 → 2.30.0

package/botrun-c/pnpm-workspace.yaml

@@ -0,0 +1,6 @@
+packages:
+  - 'api'
+  - 'web'
+  - 'ui'
+  # MCP Servers 已全面改用 Skills (v5.1201)，moved to bak/
+  # - 'botrun-mcp-servers/*'

package/botrun-c/prompts/BOTRUN-1.md

@@ -0,0 +1,13 @@
+. 我們想要支援 google drive 可以直接問答
+. 為了要支援這件事情，我希望可以讓使用者可以右上角選擇輸入 google drive 網址
+. 一旦輸入 google drive 網址之後
+. 我們先假設該 google drive 已經分享權限給本案的 service account
+. 因此，本案系統應該會可以得到權限去看是否有變更檔案
+. 如果沒有變更檔案就直接用本地快取
+. 如果有變更檔案就重新抓取 google drive 上面最新的變更覆蓋本地快取
+. 所有的抓取都要使用最新的 google drive .mjs 相關 api
+. 所有的抓取都請撰寫本案的相關 mjs api
+. 我希望可以透過本案用 claude agent sdk 採用 agentic ai 方式問答 google drive
+. 所以碰到各種格式請你都設法轉化為 ai 友善的格式可以問答這樣
+. 要可以支援本案的使用者技能 skills (google drive folder 上面可以放相對路徑正確就要能支援)
+. 你先打分 1 to 10 給我三種替代方案讓我選

package/botrun-c/prompts/BOTRUN-2.md

@@ -0,0 +1,70 @@
+. 我們要能支援多個 google drive folder 不是只有一個
+. 所以要能切換
+. 使用者可以在右上角切換任意 google drive folder url
+. 右上角要能記憶，選單要能記憶曾經切換過的網址最新的 10 個網址
+. 手機友善，手機也要能用
+. 支援所有公開資料夾（google drive public folder)
+. 支援 zip 檔案 path (google drive zip file path) 下載之後解壓縮
+. 支援需要權限的（分享給 google service account, google drive folder)
+. 支援多個 google drive 資料夾，多選的做法
+. 也支援刪除 google drive 資料夾 crud 會對應本地的修改 crud folders
+. 你基於方案 C 再次更多完整, 細化給我更完整的設計三個替代方案打分 1 to 10 
+
+ 方案 C：混合架構（API 層 + Skill 層）⭐ 推薦
+
+  | 評估項目   | 分數 | 說明                         |
+  |------------|------|------------------------------|
+  | 架構一致性 | 8    | API 處理同步，Skill 處理問答 |
+  | 開發複雜度 | 7    | 需前後端配合                 |
+  | 維護成本   | 7    | 分離關注點，各司其職         |
+  | 效能       | 9    | API 快取 + Skill 問答        |
+  | 快取機制   | 10   | API 層集中管理快取、變更偵測 |
+  | 前端整合   | 10   | 右上角可直接輸入網址         |
+  | 總分       | 8.5  |                              |
+
+  實作方式：
+  api/src/
+  ├── routes/gdrive.ts         # 新 API endpoint
+  ├── services/
+  │   ├── gdrive-sync.mjs      # Google Drive API 整合
+  │   ├── gdrive-cache.mjs     # 快取 + 變更偵測
+  │   └── gdrive-converter.mjs # 格式轉換
+
+  .claude/skills/Google Drive技能/
+  ├── SKILL.md                 # 問答導引
+  └── scripts/
+      └── gdrive-query.mjs     # 查詢同步後的本地快取
+
+  web/components/
+  └── gdrive-input.tsx         # 右上角輸入元件
+
+  架構流程：
+  ┌─────────────────────────────────────────────────────────┐
+  │ 前端：右上角輸入 Google Drive URL                        │
+  │         ↓                                               │
+  │ API：POST /api/gdrive/sync                              │
+  │         ↓                                               │
+  │ Service：                                               │
+  │   1. 解析網址 → 取得 folder/file ID                     │
+  │   2. 用 Service Account 認證                            │
+  │   3. 檢查 modifiedTime 是否有變更                        │
+  │   4. 有變更 → 下載到 /mnt/data/{userId}/gdrive-cache/   │
+  │   5. 轉換格式（PDF→文字、DOCX→Markdown 等）              │
+  │         ↓                                               │
+  │ Skill：使用者問答時                                      │
+  │   1. 偵測 Google Drive 相關問題                          │
+  │   2. 讀取本地快取的 AI 友善格式                          │
+  │   3. 支援 Skills 相對路徑                                │
+  └─────────────────────────────────────────────────────────┘
+
+  ---
+  📋 總結比較
+
+  | 方案          | 總分 | 優勢                          | 劣勢                  |
+  |---------------|------|-------------------------------|-----------------------|
+  | A. 純 Skill   | 7.3  | 架構簡單、維護容易            | 無法前端 UI、效能較差 |
+  | B. MCP Server | 6.8  | 效能好、工具完整              | 開發複雜、維護負擔重  |
+  | C. 混合架構   | 8.5  | UI 完整、快取集中、分離關注點 | 需前後端配合          |
+
+  ---
+  請選擇您偏好的方案（A/B/C），我將開始詳細規劃實作步驟。

package/botrun-c/prompts/BOTRUN-3.md

@@ -0,0 +1,139 @@
+. 請基於這個方案進行 coding
+. coding bdd tdd solid dry 原則都要吻合
+. sh/server.sh sh/client.sh 可以看日誌
+. 請使用 playwright mcp 驗證測試所有細節
+. 務必做一點點就測試一點點，才有信心逐步做完
+. 務必把設計文件先放到 ./design/google-drive/
+. 請仔細先寫出設計文件細部設計（閱讀本案程式碼之後）
+. 然後基於設計文件 coding 測試到好
+
+  方案 C2：持久快取架構（Persistent Cache）⭐ 推薦
+
+  核心理念：完整的快取管理、變更追蹤、CRUD 同步
+
+  ┌─────────────────────────────────────────────────────────────────┐
+  │                        架構示意圖                                │
+  ├─────────────────────────────────────────────────────────────────┤
+  │  ┌────────────┐   ┌──────────────┐   ┌────────────────────────┐│
+  │  │  前端 UI   │──▶│   API 層     │──▶│    Google Drive API   ││
+  │  │ 多選選單   │   │  CRUD 管理   │   │  Service Account 認證  ││
+  │  │ 記憶10網址 │   │  變更偵測    │   │  公開資料夾支援        ││
+  │  └────────────┘   └──────────────┘   └────────────────────────┘│
+  │        │                 │                                      │
+  │        ▼                 ▼                                      │
+  │  ┌────────────┐   ┌──────────────────────────────────────────┐ │
+  │  │ Firestore  │   │         本地持久快取                      │ │
+  │  │ 使用者設定 │   │  /mnt/data/{userId}/gdrive-cache/        │ │
+  │  │ - folders  │   │  ├── {folderId}/                         │ │
+  │  │ - history  │   │  │   ├── .metadata.json (modifiedTime)   │ │
+  │  │ - selected │   │  │   ├── doc.md (轉換後)                 │ │
+  │  └────────────┘   │  │   └── original/ (原始檔)              │ │
+  │                   │  └── .index.json (全域索引)              │ │
+  │                   └──────────────────────────────────────────┘ │
+  │                              │                                  │
+  │                              ▼                                  │
+  │                   ┌──────────────────────────────────────────┐ │
+  │                   │         Skill 問答層                      │ │
+  │                   │  - 讀取 .index.json 定位檔案             │ │
+  │                   │  - 支援相對路徑查詢                       │ │
+  │                   │  - 多資料夾交叉搜尋                       │ │
+  │                   └──────────────────────────────────────────┘ │
+  └─────────────────────────────────────────────────────────────────┘
+
+  | 評估項目   | 分數 | 說明                  |
+  |------------|------|-----------------------|
+  | 架構一致性 | 8    | 需 Firestore 儲存設定 |
+  | 開發複雜度 | 6    | 中等複雜度            |
+  | 維護成本   | 7    | 需管理快取生命週期    |
+  | 效能       | 9    | 增量同步，快速回應    |
+  | 快取機制   | 10   | 完整變更追蹤          |
+  | 多資料夾   | 10   | 完整 CRUD 支援        |
+  | 手機友善   | 9    | 底部抽屜式選單        |
+  | CRUD 同步  | 9    | 雙向變更偵測          |
+  | 總分       | 8.5  |                       |
+
+  檔案結構：
+  api/src/
+  ├── routes/
+  │   └── gdrive.ts                 # RESTful API
+  │       # GET    /api/gdrive/folders      - 列出已加入的資料夾
+  │       # POST   /api/gdrive/folders      - 新增資料夾
+  │       # DELETE /api/gdrive/folders/:id  - 移除資料夾
+  │       # POST   /api/gdrive/sync         - 同步選定資料夾
+  │       # GET    /api/gdrive/history      - 最近 10 個網址
+  │
+  └── services/
+      ├── gdrive-client.mjs         # Google Drive API 封裝
+      │   # - 公開資料夾存取
+      │   # - Service Account 認證
+      │   # - 檔案列表 & 下載
+      │
+      ├── gdrive-cache-manager.mjs  # 快取管理
+      │   # - modifiedTime 變更偵測
+      │   # - 增量同步邏輯
+      │   # - 快取清理策略
+      │
+      ├── gdrive-converter.mjs      # 格式轉換
+      │   # - PDF → Markdown (pdf-to-text)
+      │   # - DOCX → Markdown (mammoth)
+      │   # - XLSX → CSV/JSON
+      │   # - ZIP → 解壓縮
+      │   # - 圖片 → 保留原檔 + 描述
+      │
+      └── gdrive-index.mjs          # 索引管理
+          # - 建立 .index.json
+          # - 相對路徑映射
+          # - 全文搜尋索引
+
+  web/
+  ├── components/
+  │   ├── gdrive-selector.tsx       # 右上角選單（桌面）
+  │   ├── gdrive-drawer.tsx         # 底部抽屜（手機）
+  │   ├── gdrive-folder-list.tsx    # 資料夾列表
+  │   └── gdrive-add-dialog.tsx     # 新增資料夾對話框
+  │
+  ├── hooks/
+  │   ├── useGdriveFolders.ts       # 資料夾狀態管理
+  │   └── useGdriveSync.ts          # 同步狀態
+  │
+  └── stores/
+      └── gdrive-store.ts           # Zustand 狀態
+
+  .claude/skills/Google Drive技能/
+  ├── SKILL.md                      # 問答導引
+  └── scripts/
+      ├── gdrive-search.mjs         # 搜尋快取內容
+      ├── gdrive-list.mjs           # 列出檔案結構
+      └── gdrive-read.mjs           # 讀取特定檔案
+
+  API 設計：
+  // POST /api/gdrive/folders
+  {
+    url: "https://drive.google.com/drive/folders/xxx",
+    type: "public" | "service-account",
+    alias?: "專案文件"  // 選填別名
+  }
+
+  // GET /api/gdrive/folders
+  {
+    folders: [
+      {
+        id: "xxx",
+        url: "...",
+        alias: "專案文件",
+        type: "public",
+        lastSync: "2025-12-21T10:00:00Z",
+        fileCount: 42,
+        totalSize: "128MB",
+        selected: true  // 目前是否選中
+      }
+    ],
+    history: ["url1", "url2", ...] // 最近 10 個
+  }
+
+  // POST /api/gdrive/sync
+  {
+    folderIds: ["xxx", "yyy"],  // 支援多選
+    force: false                // 強制重新同步
+  }
+