带错误处理的Pyrogram进度回调实现

ECNU-ICALK2026-10-26查看 181复制 929

此技能用于在Pyrogram库中创建进度回调（progress callback）函数，以便在上传或下载文件时，通过检查状态变化和限制文本长度，避免`MESSAGE_NOT_MODIFIED`和`MESSAGE_TOO_LONG`错误。

📘如何使用这个技能

1
复制技能内容·点击上方「Copy SKILL.md」复制全部内容，或 Download 下载到本地
2
打开你的 AI 客户端·支持 Claude Code、Trae、Cursor、ChatGPT、DeepSeek、Kimi 等任意 AI 助手
3
粘贴为系统提示/知识文件·Claude Code：放入 .claude/skills/ 目录；普通对话：作为首条消息发送并说「请严格按这份技能文档执行」
4
直接提出你的需求·AI 会按技能定义的工作流、格式和约束来处理，无需再解释背景

💡 提示：技能生效后，每次对话只需一句需求，AI 会按 SKILL.md 的流程执行。

SKILL.md2784 chars

---
id: "1d62e9b8-1881-4a18-9936-1b84b23a9b0f"
name: "پیاده‌سازی کالبک پیشرفت Pyrogram با مدیریت خطا"
description: "این مهارت برای ایجاد توابع پیشرفت (progress callback) در کتابخانه Pyrogram استفاده می‌شود تا هنگام آپلود یا دانلود فایل، با بررسی تغییر وضعیت و محدود کردن طول متن، از خطاهای `MESSAGE_NOT_MODIFIED` و `MESSAGE_TOO_LONG` جلوگیری شود."
version: "0.1.0"
tags:
  - "pyrogram"
  - "python"
  - "telegram-bot"
  - "progress-callback"
  - "error-handling"
triggers:
  - "پیاده‌سازی کالبک پیشرفت pyrogram"
  - "رفع ارور MESSAGE_NOT_MODIFIED در pyrogram"
  - "نمایش درصد آپلود و دانلود در تلگرام با pyrogram"
  - "رفع ارور MESSAGE_TOO_LONG هنگام ویرایش پیام"
  - "بهینه‌سازی progress callback در ربات تلگرام"
---

# پیاده‌سازی کالبک پیشرفت 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 در ربات تلگرام

来源：skillsdirectory

带错误处理的Pyrogram进度回调实现

📘如何使用这个技能

评论0