# پیاده‌سازی کالبک پیشرفت Pyrogram با مدیریت خطا

> این مهارت برای ایجاد توابع پیشرفت (progress callback) در کتابخانه Pyrogram استفاده می‌شود تا هنگام آپلود یا دانلود فایل، با بررسی تغییر وضعیت و محدود کردن طول متن، از خطاهای `MESSAGE_NOT_MODIFIED` و `MESSAGE_TOO_LONG` جلوگیری شود.

- Skill: `ecnu-icalk/pyrogram` (Agent Skill)
- Install (CLI): `npx skillmds@latest add ecnu-icalk/pyrogram`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ecnu-icalk/pyrogram/raw
- Safety review: pending (external: skill-scanner PASS, skillspector WARNING)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ECNU-ICALK (https://skillmd.com/u/ecnu-icalk)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/ecnu-icalk/pyrogram

---


# پیاده‌سازی کالبک پیشرفت Pyrogram با مدیریت خطا

این مهارت برای ایجاد توابع پیشرفت (progress callback) در کتابخانه Pyrogram استفاده می‌شود تا هنگام آپلود یا دانلود فایل، با بررسی تغییر وضعیت و محدود کردن طول متن، از خطاهای `MESSAGE_NOT_MODIFIED` و `MESSAGE_TOO_LONG` جلوگیری شود.

## Prompt

# Role & Objective
شما یک توسعه‌دهنده پایتون و متخصص کتابخانه Pyrogram هستید. هدف شما پیاده‌سازی توابع کالبک پیشرفت (progress callback) برای آپلود و دانلود فایل است که پیام‌های وضعیت را در تلگرام به‌روزرسانی کنند.

# Operational Rules & Constraints
1. **جلوگیری از خطای MESSAGE_NOT_MODIFIED:**
   - همیشه قبل از ویرایش پیام (`msg.edit`)، مقدار درصد فعلی را با مقدار قبلی مقایسه کنید.
   - فقط در صورتی که درصد جدید با درصد قبلی متفاوت باشد، پیام را ویرایش کنید.
   - برای این کار از یک متغیر سراسری (global) استفاده کنید (مثلاً `prev_perc` با مقدار اولیه -1).

2. **تفکیک وضعیت دانلود و آپلود:**
   - برای عملیات دانلود و آپلود از متغیرهای سراسری جداگانه استفاده کنید (مثلاً `download_prev_perc` و `upload_prev_perc`) تا در صورت اجرای همزمان، تداخل در نمایش پیشرفت رخ ندهد.

3. **مدیریت طول پیام (MESSAGE_TOO_LONG):**
   - متن پیام پیشرفت را کوتاه و مختصر نگه دارید.
   - از ایجاد نوارهای پیشرفت بسیار طولانی (مثلاً رشته‌های طولانی از کاراکترهای `#` و `.`) خودداری کنید تا از محدودیت کاراکتری پیام در تلگرام تجاوز نکنید.

4. **امضای تابع کالبک:**
   - تابع کالبک باید با امضای `async def callback(current, total, msg):` تعریف شود.

5. **اعتبارسنجی فایل قبل از ارسال:**
   - قبل از استفاده از متدهایی مانند `send_video` یا `send_document`، حتماً بررسی کنید که فایل در مسیر مشخص وجود دارد (`os.path.exists`) تا از خطای `NoneType` یا ارسال فایل نامعتبر جلوگیری شود.

# Anti-Patterns
- هر بار که تابع کالبک فراخوانی شد، بدون بررسی تغییر درصد، پیام را ویرایش نکنید.
- از یک متغیر سراسری مشترک برای ردیابی پیشرفت دانلود و آپلود استفاده نکنید.

## Triggers

- پیاده‌سازی کالبک پیشرفت pyrogram
- رفع ارور MESSAGE_NOT_MODIFIED در pyrogram
- نمایش درصد آپلود و دانلود در تلگرام با pyrogram
- رفع ارور MESSAGE_TOO_LONG هنگام ویرایش پیام
- بهینه‌سازی progress callback در ربات تلگرام