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

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

install

source · Clone the upstream repo

git clone https://github.com/ECNU-ICALK/AutoSkill

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/ECNU-ICALK/AutoSkill "$T" && mkdir -p ~/.claude/skills && cp -r "$T/SkillBank/ConvSkill/Persian/پیاده-سازی-کالبک-پیشرفت-pyrogram-با-مدیریت-خطا" ~/.claude/skills/ecnu-icalk-autoskill-pyrogram && rm -rf "$T"

manifest: SkillBank/ConvSkill/Persian/پیاده-سازی-کالبک-پیشرفت-pyrogram-با-مدیریت-خطا/SKILL.md

source content

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

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

MESSAGE_NOT_MODIFIED

MESSAGE_TOO_LONG

جلوگیری شود.

Prompt

Role & Objective

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

Operational Rules & Constraints

جلوگیری از خطای MESSAGE_NOT_MODIFIED:
- همیشه قبل از ویرایش پیام (
```
msg.edit
```
  )، مقدار درصد فعلی را با مقدار قبلی مقایسه کنید.
- فقط در صورتی که درصد جدید با درصد قبلی متفاوت باشد، پیام را ویرایش کنید.
- برای این کار از یک متغیر سراسری (global) استفاده کنید (مثلاً
```
prev_perc
```
  با مقدار اولیه -1).
تفکیک وضعیت دانلود و آپلود:
- برای عملیات دانلود و آپلود از متغیرهای سراسری جداگانه استفاده کنید (مثلاً
```
download_prev_perc
```
  و
```
upload_prev_perc
```
  ) تا در صورت اجرای همزمان، تداخل در نمایش پیشرفت رخ ندهد.
مدیریت طول پیام (MESSAGE_TOO_LONG):
- متن پیام پیشرفت را کوتاه و مختصر نگه دارید.
- از ایجاد نوارهای پیشرفت بسیار طولانی (مثلاً رشته‌های طولانی از کاراکترهای
```
#
```
  و
```
.
```
  ) خودداری کنید تا از محدودیت کاراکتری پیام در تلگرام تجاوز نکنید.
امضای تابع کالبک:
- تابع کالبک باید با امضای
```
async def callback(current, total, msg):
```
  تعریف شود.
اعتبارسنجی فایل قبل از ارسال:
- قبل از استفاده از متدهایی مانند
```
send_video
```
  یا
```
send_document
```
  ، حتماً بررسی کنید که فایل در مسیر مشخص وجود دارد (
```
os.path.exists
```
  ) تا از خطای
```
NoneType
```
  یا ارسال فایل نامعتبر جلوگیری شود.

Anti-Patterns

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

Triggers

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