docs: điền mục Plugin & MCP khuyên dùng bằng AgentHub
Mục 3 đang để trống "Chưa cập nhật". Thêm AgentHub: lợi ích, cách hoạt động, chức năng chính (lane, chạy agent trong trình duyệt, analytics, trình xem cấu hình, CLI), hai đường cài kèm cảnh báo chỉ được chọn một — cài từ cả hai marketplace sẽ chạy hai bộ hook và đếm đôi token/cost — và bảng yêu cầu trước khi cài, trong đó tmux là thứ README cũ chưa bao giờ nhắc.
This commit is contained in:
@@ -43,6 +43,56 @@ Tài liệu này tổng hợp các công cụ, cấu hình và phương pháp gi
|
|||||||
|
|
||||||
## 3. Các Plugin & MCP Khuyên Dùng
|
## 3. Các Plugin & MCP Khuyên Dùng
|
||||||
|
|
||||||
|
### [AgentHub](https://git.smartgift.io.vn/Smartgift-AI/AgentHub) — dashboard nội bộ theo dõi & điều khiển agent
|
||||||
|
|
||||||
|
* **Lợi ích:** Thấy được agent đang làm gì theo thời gian thực — session, tool call, token, chi phí, cây subagent, transcript — thay vì đoán qua terminal. Chạy nhiều lane song song và biết lane nào đang ở bước nào.
|
||||||
|
* **Cách hoạt động:** Hook của Claude Code POST mọi tool call lên server Express + SQLite chạy local, UI React cập nhật qua WebSocket. Toàn bộ dữ liệu nằm trên máy bạn.
|
||||||
|
* **Chức năng chính:**
|
||||||
|
* **Lane** — mỗi thư mục làm việc là một lane, sống sót qua restart, đi qua pipeline stage và hiển thị tiến độ (stage khai báo bằng `agenthub stage`, còn stage suy luận từ tool stream chỉ hiện màu amber, không bao giờ là "done").
|
||||||
|
* **Chạy Claude Code / Codex ngay trong trình duyệt** — terminal thật (tmux + PTY, xterm.js), tương tác đầy đủ, resume được, attach lại được từ terminal máy.
|
||||||
|
* **Analytics & chi phí** theo model, alert + webhook, import lịch sử session (kể cả từ máy khác qua SSH).
|
||||||
|
* **Trình xem cấu hình Claude Code + Codex** — plugin, skill, subagent, slash command, MCP, hook, memory… xem hết, sửa được các file dạng text.
|
||||||
|
* **CLI `agenthub`** cho toàn bộ bề mặt trên, cộng ship pipeline (`/agenthub:ship-full`, `/agenthub:ship-quick`).
|
||||||
|
|
||||||
|
**Cài đặt** — không cần clone. Đã đăng ký marketplace `sg` ở [mục 4](#4-cac-skills-nen-cai) rồi thì chỉ một lệnh:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
claude plugin install agenthub@sg
|
||||||
|
```
|
||||||
|
|
||||||
|
Chưa dùng marketplace `sg` thì cài từ marketplace riêng của AgentHub:
|
||||||
|
|
||||||
|
```
|
||||||
|
/plugin marketplace add https://git.smartgift.io.vn/Smartgift-AI/AgentHub.git
|
||||||
|
/plugin install agenthub@agenthub
|
||||||
|
```
|
||||||
|
|
||||||
|
> [!IMPORTANT]
|
||||||
|
> **Chỉ chọn MỘT trong hai đường.** Cài dashboard từ cả `sg` lẫn marketplace riêng của AgentHub sẽ chạy **hai bộ hook ingestion song song** — mỗi event vào database hai lần, token và cost bị đếm đôi.
|
||||||
|
|
||||||
|
Lần session-start kế tiếp sẽ tự cài hook, boot server, đưa CLI `agenthub` vào PATH (chạy nền). Sau đó dùng `/agenthub-doctor` để kiểm tra, `/agenthub-open` để build UI và lấy URL, `/agenthub-update` để cập nhật.
|
||||||
|
|
||||||
|
**Yêu cầu trước khi cài:**
|
||||||
|
|
||||||
|
| Cần | Vì sao |
|
||||||
|
|---|---|
|
||||||
|
| Node >= 22.5 | Bản cài qua plugin dùng `node:sqlite` (không có `better-sqlite3` native) |
|
||||||
|
| git | Mọi thao tác lane (worktree, đọc branch/status) |
|
||||||
|
| **tmux** | **Bắt buộc** nếu muốn chạy agent từ trình duyệt hoặc dùng `agenthub lanes shell` — dashboard gọi thẳng binary `tmux`, không có bản dự phòng |
|
||||||
|
| `gh` (tùy chọn) | Chỉ cần cho `agenthub lanes ci status` và các bước mở PR |
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo apt install git tmux # Ubuntu / Debian
|
||||||
|
brew install git tmux # macOS
|
||||||
|
tmux -V # xác nhận: tmux 3.x
|
||||||
|
```
|
||||||
|
|
||||||
|
Windows không có tmux native — chạy AgentHub trong WSL2 và cài tmux ở trong đó. Thiếu tmux thì dashboard vẫn chạy bình thường, chỉ riêng nút **Start Run** và `agenthub lanes shell` là lỗi.
|
||||||
|
|
||||||
|
> Hướng dẫn đầy đủ: [README.vi.md](https://git.smartgift.io.vn/Smartgift-AI/AgentHub/src/branch/main/README.vi.md) · [INSTALL.md](https://git.smartgift.io.vn/Smartgift-AI/AgentHub/src/branch/main/INSTALL.md) · [docs/PLUGINS.md](https://git.smartgift.io.vn/Smartgift-AI/AgentHub/src/branch/main/docs/PLUGINS.md)
|
||||||
|
|
||||||
|
### MCP
|
||||||
|
|
||||||
*Chưa cập nhật*
|
*Chưa cập nhật*
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|||||||
Reference in New Issue
Block a user