README 加上 web 控制台圖文使用說明

摘要:
補四張控制台實際截圖(Bot 管理首頁、新增 Bot 表單、PM2 分頁、log 檢視),
並照畫面逐步說明新增 bot 的流程。

影響:
docs/ 只進版控、不進 npm 包(package.json files 白名單未含 docs)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-08-04 16:31:14 +08:00
co-authored by Claude Fable 5
parent 313e651887
commit e7d3f43a52
5 changed files with 25 additions and 0 deletions
+25
View File
@@ -45,6 +45,31 @@ telegram-codex-bot start # 先做環境檢查(codex/登入/pm2/git),再
| 🤖 Bot 管理 | 新增/編輯(token、目錄用原生視窗選、沙盒、模型/推理強度/速度下拉、逾時)、啟動/停止/重啟、log、刪除 |
| 📊 PM2 | 整台機器所有 pm2 程序:狀態、監聽 port(可點)、CPU、記憶體、out/err log、啟停/重啟/刪除 |
### 圖文使用說明
**① Bot 管理首頁** — 每個 bot 一列:狀態、工作目錄、沙盒與模型設定、遮罩後的 token。
右側按鈕:▶ 啟動 / ⏹ 停止、🔄 重啟、📄 log、✏️ 編輯、🗑 刪除。上方橫幅提醒群組使用要先關 Group Privacy。
![Bot 管理首頁](docs/01-bots.png)
**② 新增 Bot** — 按右上「➕ 新增 Bot」:
1. **名稱**:也是 pm2 程序名,建立後不可改
2. **Token**:貼上 BotFather 給的 token,儲存時自動打 Telegram 驗證,無效會警告
3. **工作目錄**:按「📂 瀏覽…」會在這台機器桌面跳出原生資料夾視窗,選完自動帶入
4. **模型 / 推理強度 / 速度**:下拉選單,預設值自動帶你機器上 codex 的全域設定;清單讀自本機 codex 模型快取,換模型時強度選項會連動(如 ultra 只有支援的模型才出現)
5. 勾「建立後立即啟動」→ 儲存,bot 就上線了
![新增 Bot 表單](docs/02-create.png)
**③ PM2 分頁** — 整台機器所有 pm2 程序。Port 可直接點開對應網頁,右側可啟停/重啟/刪除任何程序。
![PM2 分頁](docs/03-pm2.png)
**④ Log 檢視** — 點任一程序的「📄 out」/「⚠ err」,下方展開尾端 200 行,可勾自動更新(5s)。
![Log 檢視](docs/04-log.png)
- 兩個分頁每 5 秒自動更新
- Bot 設定存於 `~/.tgcodex/bots/<名稱>/tgcodex.config.json`,bot 掛 pm2 的程序名 = bot 名稱
- 預設只綁 `127.0.0.1`。這個介面能控制 pm2 且存有 token,**不要裸露到外網**;