Tài liệu
Tài liệu tra cứu của aipager: kiến trúc, hook, lệnh, xử lý sự cố, bảo mật.
Bắt đầu ở đây#
Cài đặt bằng agent#
Trang này dành cho một agent lập trình AI (Claude Code, hoặc bất kỳ agent nào dùng được shell) được nhờ cài aipager cho người dùng của nó và thiết lập luôn. Hãy làm theo từng bước. Mọi lệnh ở đây chạy mà không hỏi gì và không bao giờ cần một terminal tương tác.
Tra cứu#
Kiến trúc#
aipager là một chương trình asyncio chạy nền trong một tiến trình duy nhất. Nó nối ba thế giới: chat Telegram của bạn, các tiến trình Claude Code bạn chạy trong dtach, và hệ thống hook của Claude Code. Mọi thứ đi qua một event loop: không có worker pool, không có cơ sở dữ liệu, không có hàng đợi giữa các tiến trình.
Sự kiện hook#
Claude Code chạy các lệnh hook ở những thời điểm cố định trong một việc: một tin nhắn được gửi, một công cụ sắp chạy, một công cụ đã xong, việc kết thúc, và vân vân. aipager gắn hook vào từng thời điểm đó và biến chúng thành hoạt động trên Telegram: thẻ làm việc, yêu cầu cấp quyền, câu trả lời, thông báo và log kiểm tra.
Lệnh và giao diện của bot#
Cách bạn điều khiển aipager từ Telegram. Có bốn cách đưa đầu vào: lệnh slash, nút bàn phím, bảng điều khiển Mini App, và tin nhắn tự do (chữ, file, tin nhắn thoại).
Chế độ làm việc nhóm và nhóm#
Mặc định aipager là một bot riêng: bạn và bot trong một chat riêng, không có ai khác. Chế độ làm việc nhóm mở nó ra cho nhiều người hơn: một nhóm Telegram nơi nhiều lập trình viên cùng điều khiển các phiên, chat riêng của những người khác với bot, hoặc cả hai. Mỗi chat có thành viên riêng, và mỗi thành viên có một vai trò quyết định họ được làm gì ở đó: gửi tin nhắn, trả lời câu hỏi và yêu cầu cấp quyền của Claude, quản lý phiên, hay chỉ xem.
Vận hành#
Mô hình bảo mật#
aipager chạy Claude Code thay mặt bạn và được điều khiển từ Telegram. Từ đó có hai câu hỏi:
Xử lý sự cố#
Các lỗi hay gặp và cách khắc phục. Khi không chắc, hãy chạy:
Báo cáo sự cố#
Khi aipager gặp lỗi, bạn có thể gửi cho nhà phát triển aipager một báo cáo sự cố chỉ với một lần chạm. Bạn thấy toàn bộ báo cáo trước khi có gì được gửi, không có gì rời khỏi máy tính của bạn cho tới khi bạn đồng ý, và một báo cáo không bao giờ chứa chat, tin nhắn, tên, đường dẫn hay token của bạn. Nó chỉ được tạo từ một danh sách trường cố định: phiên bản, số đếm, ngày tháng, câu trả lời có/không, lựa chọn từ các danh sách cố định, vị trí trong mã của chính aipager và tên ap1- của các lỗi, cộng thêm một ghi chú ngắn chỉ khi bạn tự viết.