مستندات
مستندات مرجع aipager: معماری، هوک‌ها، فرمان‌ها، رفع اشکال، امنیت.
از اینجا شروع کنید#
نصب با ایجنت#
این صفحه برای یک ایجنت هوش مصنوعی برنامه‌نویسی است (Claude Code یا هر ایجنتی که shell دارد) که از او خواسته‌اند aipager را برای صاحبش نصب و راه‌اندازی کند. قدم‌به‌قدم دنبالش کنید. همهٔ دستورهای این صفحه بدون هیچ سؤالی اجرا می‌شوند و هیچ‌وقت ترمینال تعاملی لازم ندارند.
مرجع#
معماری#
aipager یک برنامهٔ asyncio تک‌پروسه‌ای است که در پس‌زمینه اجرا می‌شود. سه دنیا را به هم وصل می‌کند: چت تلگرام شما، پروسه‌های Claude Code که زیر dtach اجرا می‌کنید، و سیستم هوک‌های Claude Code. همه‌چیز از یک event loop می‌گذرد: بدون worker pool، بدون پایگاه داده، بدون صف بین پروسه‌ها.
رویدادهای هوک#
Claude Code در لحظه‌های مشخصی از هر کار، دستورهای هوک را اجرا می‌کند: یک پیام فرستاده شد، ابزاری دارد اجرا می‌شود، ابزاری تمام شد، کار تمام شد و غیره. aipager به همهٔ این لحظه‌ها هوک می‌گذارد و آن‌ها را به اتفاق‌هایی در تلگرام تبدیل می‌کند: کارت در حال کار، درخواست‌های اجازه، جواب‌ها، اعلان‌ها و لاگ ممیزی.
فرمان‌ها و رابط ربات#
اینکه aipager را چطور از تلگرام می‌گردانید. چهار راه ورودی: فرمان‌های اسلش، دکمه‌های کیبورد، داشبورد Mini App، و پیام‌های آزاد (متن، فایل، ویس).
استفادهٔ تیمی و گروه#
aipager به‌طور پیش‌فرض یک ربات خصوصی است: شما و ربات در یک چت خصوصی، هیچ‌کس دیگر. استفادهٔ تیمی آن را به روی آدم‌های بیشتری باز می‌کند: یک گروه تلگرام که چند برنامه‌نویس در آن سشن‌ها را می‌گردانند، چت خصوصی آدم‌های دیگر با ربات، یا هر دو. هر چت اعضای خودش را دارد و هر عضو نقشی دارد که تعیین می‌کند آنجا چه کاری می‌تواند بکند: پیام بفرستد، به سؤال‌ها و درخواست‌های اجازهٔ Claude جواب بدهد، سشن‌ها را مدیریت کند، یا فقط نگاه کند.
اجرا و نگهداری#
مدل امنیتی#
aipager از طرف شما Claude Code را اجرا می‌کند و از تلگرام کنترل می‌شود. دو سؤال پیش می‌آید:
رفع مشکل#
مشکل‌های رایج و راه‌حلشان. هر وقت شک داشتید، این را اجرا کنید:
گزارش مشکل#
وقتی aipager به یک باگ می‌خورد، می‌توانید با یک دکمه گزارش مشکل را برای سازندهٔ aipager بفرستید. قبل از اینکه چیزی فرستاده شود کل گزارش را می‌بینید، تا خودتان نگویید چیزی از کامپیوترتان بیرون نمی‌رود، و گزارش هیچ‌وقت چت‌ها، پیام‌ها، اسم‌ها، مسیرها یا توکن‌هایتان را ندارد. گزارش فقط از یک فهرست ثابت فیلد ساخته می‌شود: نسخه‌ها، تعدادها، تاریخ‌ها، جواب‌های بله/نه، گزینه‌هایی از فهرست‌های ثابت، جاهایی در کد خود aipager و اسم‌های ap1- باگ‌هایش، و فقط اگر خودتان بنویسید، یک توضیح کوتاه.