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:
2026-09-11 10:46:58 +07:00
parent 33b75aaf47
commit 0b308e3cc7
+50
View File
@@ -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*
--- ---