botrun-horse 2.29.2 → 2.30.0

package/botrun-c/PLAN.md

@@ -0,0 +1,131 @@
+# 功能規劃：統一附件系統（Unified Attachment System）
+
+> 分支：`feature/clipboard-paste-image`
+> 狀態：方案 B 確認，詳細設計完成
+> 更新：統一所有上傳入口
+
+---
+
+## 核心需求
+
+### 功能需求
+1. **貼上 (Paste)**：Cmd/Ctrl+V 貼上截圖或圖片
+2. **拖放 (Drag & Drop)**：拖曳檔案到輸入區
+3. **點選上傳**：點擊迴紋針按鈕選擇檔案
+4. **分次累積**：可分次新增多個附件，最多 20 個
+5. **統一預覽**：圖片顯示縮圖，非圖片顯示檔案圖示
+6. **延遲上傳**：送出時才批次上傳
+
+### 限制
+| 項目 | 值 |
+|------|-----|
+| 附件數量上限 | 20 個 |
+| 單檔大小上限 | 350MB（沿用 systemLimits） |
+| 支援檔案類型 | 所有類型（圖片有縮圖預覽） |
+
+---
+
+## 架構設計
+
+### 新增檔案
+
+| 檔案 | 說明 |
+|------|------|
+| `web/types/attachment.ts` | 附件類型定義 |
+| `web/lib/attachment-utils.ts` | 附件工具函數 |
+| `web/hooks/useAttachments.ts` | 附件狀態管理 Hook |
+| `web/components/attachment-preview.tsx` | 附件預覽元件 |
+| `web/components/drop-zone.tsx` | 拖放區元件 |
+
+### 修改檔案
+
+| 檔案 | 說明 |
+|------|------|
+| `web/components/chat-input.tsx` | 整合統一附件系統 |
+
+---
+
+## UI 設計
+
+### 附件預覽區
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ 📎 附件 (3/20)                                    [清除全部] │
+├─────────────────────────────────────────────────────────────┤
+│ ┌─────────┐ ┌─────────┐ ┌─────────┐                        │
+│ │  🖼️     │ │  📄     │ │  📎     │                        │
+│ │ [縮圖]  │ │  PDF    │ │  ZIP    │                        │
+│ │   ✕    │ │   ✕    │ │   ✕    │                        │
+│ └─────────┘ └─────────┘ └─────────┘                        │
+│  photo.png   doc.pdf    archive.zip                         │
+│  2.5 MB      1.2 MB     15.3 MB                            │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### 拖放視覺回饋
+
+```
+┌ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┐
+│                    📥 放開以新增附件                        │
+└ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┘
+```
+
+### 檔案類型圖示
+
+| 類型 | 圖示 | 預覽 |
+|------|------|------|
+| 圖片 | 🖼️ | 縮圖 |
+| 影片 | 🎬 | 縮圖 |
+| 音訊 | 🎵 | 圖示 |
+| PDF | 📄 | 圖示 |
+| 其他 | 📎 | 圖示 |
+
+---
+
+## 實作順序
+
+### Phase 1: 基礎架構（約 80 行）
+1. `web/types/attachment.ts`
+2. `web/lib/attachment-utils.ts`
+
+### Phase 2: 狀態管理（約 120 行）
+3. `web/hooks/useAttachments.ts`
+
+### Phase 3: UI 元件（約 150 行）
+4. `web/components/attachment-preview.tsx`
+5. `web/components/drop-zone.tsx`
+
+### Phase 4: 整合（約 100 行修改）
+6. `web/components/chat-input.tsx`
+
+**總計：約 450 行程式碼**
+
+---
+
+## 測試案例
+
+### 功能測試
+
+| 測試案例 | 預期結果 |
+|----------|----------|
+| Cmd+V 貼上截圖 | 顯示在附件預覽區 |
+| Cmd+V 貼上文字 | 正常貼入 textarea |
+| 拖放單個圖片 | 顯示縮圖預覽 |
+| 拖放多個檔案 | 批次新增到預覽區 |
+| 拖放 PDF | 顯示 PDF 圖示 |
+| 點選上傳檔案 | 顯示在預覽區 |
+| 分次貼上 3 張圖 | 累積顯示 3 張 |
+| 刪除單一附件 | 從預覽區移除 |
+| 清除全部 | 清空所有附件 |
+| 送出訊息 | 批次上傳後發送 |
+
+### 邊界測試
+
+| 測試案例 | 預期結果 |
+|----------|----------|
+| 新增第 21 個附件 | 顯示「已達上限」錯誤 |
+| 上傳 400MB 檔案 | 顯示「超過限制」錯誤 |
+| 網路中斷時上傳 | 顯示錯誤狀態，可重試 |
+| 只有附件沒有文字 | 可以送出 |
+| 只有文字沒有附件 | 可以送出 |

package/botrun-c/README.md

@@ -0,0 +1,129 @@
+# 波特人 (Botrun) - AI Agent Platform
+
+> 讓 AI 成為你的智慧助理，用自然語言完成各種任務
+
+---
+
+## 最新更新 (2026/01/24 ~ 01/30)
+
+### GitHub 技能上線！
+
+現在你可以直接用中文請波特人幫你操作 GitHub 倉庫了！
+
+#### 怎麼用？
+
+**第一步：連結你的 GitHub**
+1. 點右上角選單 → 設定 → GitHub
+2. 點「連結 GitHub」按鈕，授權波特人存取你的倉庫
+
+**第二步：用自然語言操作**
+
+| 你想做的事 | 這樣說就好 |
+|-----------|-----------|
+| 下載倉庫到波特人 | `clone owner/repo-name` |
+| 搜尋程式碼 | `在 xxx repo 搜尋 yyy` |
+| 查看檔案 | `讀取 xxx repo 的 README.md` |
+| 建立分支 | `在 xxx repo 建立 feature/新功能 分支` |
+| 提交變更 | `把變更 commit 到 xxx repo` |
+| 推送到遠端 | `push xxx repo` |
+
+#### 範例對話
+
+```
+👤 你：clone botrun/timeless-bowen
+
+🤖 波特人：好的！我來幫您複製 botrun/timeless-bowen 倉庫...
+    ✅ 複製完成！
+    - 倉庫名稱：botrun/timeless-bowen
+    - 本地路徑：/mnt/data/.../github/botrun_timeless-bowen
+    - 當前分支：main
+```
+
+```
+👤 你：什麼是零幻覺四部曲
+
+🤖 波特人：讓我在 botrun/timeless-bowen 倉庫中搜尋...
+    [搜尋多個檔案]
+
+    根據搜尋結果，「零幻覺四部曲」是...
+    1. 真實性驗證
+    2. 來源引證
+    3. 人工審核
+    4. 穩定輸出
+```
+
+```
+👤 你：在 xxx repo 找所有 .md 檔案提到 API 的地方
+
+🤖 波特人：好的，讓我搜尋所有 Markdown 檔案...
+    [使用 Grep 工具搜尋]
+
+    找到 5 個檔案包含 "API"：
+    - README.md (第 23, 45 行)
+    - docs/guide.md (第 12 行)
+    ...
+```
+
+#### 小提醒
+
+- 第一次使用前要先「連結 GitHub」
+- 搜尋前要先「clone」倉庫（波特人會自動提醒你）
+- 支援公開和私有倉庫（需要授權）
+
+---
+
+### 其他修復
+
+| 日期 | 修復內容 |
+|------|----------|
+| 01/30 | 修復 Clone 在雲端環境失敗的問題（GCS FUSE chmod 錯誤） |
+| 01/29 | 修復用自然語言搜尋 GitHub 內容時跑去網路搜尋的問題 |
+| 01/28 | 修復 GitHub 連結時 OAuth 失效的問題 |
+| 01/27 | 修復 GitHub Skills 腳本認證機制 |
+| 01/26 | 新增 GitHub 技能，支援完整 Git 操作 |
+
+---
+
+## 功能一覽
+
+### 核心功能
+
+| 功能 | 說明 | 怎麼用 |
+|------|------|--------|
+| 語音轉文字 | 錄音後自動轉成文字 | 點麥克風錄音 |
+| 會議記錄 | 整理會議錄音成重點 | 上傳錄音檔 |
+| PDF 閱讀 | 讀取 PDF 內容並回答問題 | 上傳 PDF 檔案 |
+| 圖片生成 | 根據描述生成圖片 | 說「畫一張...」 |
+| 網路搜尋 | 搜尋最新資訊 | 說「搜尋...」 |
+| GitHub 操作 | Clone、搜尋、Commit、Push | 見上方說明 |
+
+### 進階功能
+
+| 功能 | 說明 |
+|------|------|
+| 自訂技能 | 建立你專屬的 AI 技能 |
+| 記憶功能 | 讓 AI 記住重要資訊 |
+| HTML 生成 | 生成網頁並預覽 |
+| Google Drive | 連結並搜尋 Google Drive 資料夾 |
+
+---
+
+## 支援平台
+
+- **網頁版**：https://app.botrun.ai
+- **iOS App**：App Store 搜尋「波特人」
+- **Android App**：Google Play 搜尋「波特人」
+
+---
+
+## 開發相關
+
+詳細開發指南請參考：
+- [本地開發指南](LOCAL-DEVELOPMENT-GUIDE.md)
+- [變更日誌](CHANGELOG.md)
+
+---
+
+## 聯絡我們
+
+有問題或建議？歡迎聯絡我們！