skill
نموذج Lark
Feishu IM: إرسال واستقبال الرسائل وإدارة الدردشات الجماعية. إرسال الرسائل والرد عليها، البحث في سجلات الدردشة، إدارة أعضاء الدردشات الجماعية، تحميل وتنزيل الصور والملفات، إدارة الردود التعبيرية، إرسال رسائل عاجلة داخل التطبيق/عبر الرسائل النصية/عبر المكالمات، إرسال ومعالجة البطاقات التفاعلية (Interactive Card)، والاستماع إلى ردود نداء أزرار البطاقات (card.action.trigger). تستخدم عندما يحتاج المستخدم إلى إرسال رسائل، عرض أو البحث في سجلات الدردشة، تنزيل الملفات من الدردشة، عرض أعضاء المجموعة، البحث عن المجموعات، إنشاء دردشات جماعية أو مجموعات مواضيعية، إدارة البيانات الموسومة، إدارة تثبيت الموجز (إضافة/إزالة/الاستعلام عن المحادثات المثبتة)، إدارة بيانات العلامات، ومعالجة ردود نداء البطاقات.
نبذة
# im (الإصدار 1)
**هام — قبل البدء، يجب قراءة [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md) باستخدام أداة Read، حيث يحتوي على معلومات المصادقة ومعالجة الأذونات.**
## المفاهيم الأساسية
- **Message (رسالة)**: رسالة واحدة في محادثة، يتم تحديدها بواسطة `message_id` (om_xxx). تدعم الأنواع: نص، منشور، صورة، ملف، صوت، فيديو، ملصق، تفاعلي (بطاقة)، مشاركة محادثة، مشاركة مستخدم، دمج إعادة توجيه، إلخ. - **Chat (محادثة)**: محادثة جماعية أو محادثة P2P، يتم تحديدها بواسطة `chat_id` (oc_xxx). - **Thread (سلسلة محادثة)**: سلسلة ردود تحت رسالة، يتم تحديدها بواسطة `thread_id` (om_xxx أو omt_xxx). - **Reaction (تفاعل)**: تفاعل تعبيري (إيموجي) على رسالة. - **Flag (علامة)**: إشارة مرجعية على رسالة أو سلسلة محادثة. - **Feed Shortcut (اختصار الموجز)**: محادثة مثبتة في الشريط الجانبي لموجز المستخدم الحالي، يتم تحديدها بواسطة `feed_card_id` (وهو `oc_xxx` open_chat_id لنوع CHAT). - **Feed Group (مجموعة الموجز)**: علامة تجمع بطاقات الموجز في قائمة الموجز، يتم تحديدها بواسطة `feed_group_id` (ofg_xxx). الأعضاء هم بطاقات موجز، يتم تحديد كل منها بواسطة `feed_id` + `feed_type`. نوعان: `normal` (يتم إدارة الأعضاء بشكل صريح) و `rule` (يتم استنتاج الأعضاء تلقائيا من القواعد).
## علاقات الموارد
``` Chat (oc_xxx) ├── Message (om_xxx) │ ├── Thread (سلسلة ردود) │ ├── Reaction (إيموجي) │ └── Resource (صورة / ملف / فيديو / صوت) └── Member (مستخدم / بوت) ```
## ملاحظات هامة
### AppLink وروابط المشاركة
فضل استخدام الروابط التي ترجعها واجهة سطر الأوامر (CLI): استخدم `chat_app_link` لفتح المحادثات التي تم الانضمام إليها، و`message_app_link` لفتح الرسائل، و`share_link` لدعوة الآخرين إلى المجموعات. إذا كنت تقوم بإنشاء AppLink لمحادثة منضمة يدويا، استخدم `https://<applink_host>/client/chat/open?openChatId=<oc_xxx>`، ولا تستخدم أبدا `chatId=<oc_xxx>` أو `lark://...chat_id=<oc_xxx>`.
### الهوية وتعيين الرمز المميز
- `--as user` تعني **هوية المستخدم** وتستخدم `user_access_token`. يتم تشغيل الاستدعاءات بصفتها المستخدم النهائي المصرح له، لذا تعتمد الأذونات على نطاقات التطبيق ووصول هذا المستخدم الخاص إلى المحادثة/الرسالة/المورد المستهدف. - `--as bot` تعني **هوية البوت** وتستخدم `tenant_access_token`. يتم تشغيل الاستدعاءات بصفتها بوت التطبيق، لذا يعتمد السلوك على عضوية البوت، ورؤية التطبيق، ونطاق التوفر، والنطاقات الخاصة بالبوت. - إذا كانت واجهة برمجة تطبيقات IM تدعم كلا من `user` و `bot`، فإن نوع الرمز المميز يغير هوية المشغل. يمكن أن تنجح نفس واجهة برمجة التطبيقات بهوية واحدة وتفشل بالأخرى لأن حالة المالك/المسؤول، أو عضوية المحادثة، أو حدود المستأجر، أو توفر التطبيق يتم التحقق منها مقابل المتصل الحالي.
### حل اسم المرسل
عند جلب الرسائل (`+chat-messages-list`، `+threads-messages-list`، `+messages-mget`، `+messages-search`)، تعرض واجهة سطر الأوامر (CLI) اسم عرض لكل من مرسلي المستخدمين والبوتات:
- **الاسم المقدم من الخادم**: ترجع واجهات برمجة تطبيقات القراءة `sender_name` (بالإضافة إلى خريطة `sender_i18n_names` الكاملة متعددة اللغات) على كل `sender` رسالة؛ تعرضها واجهة سطر الأوامر (CLI) ك `name` للمرسل للمستخدمين والبوتات على حد سواء. لا يلزم البحث عن اسم ولا إذن إضافي — **لا يوجد نطاق جهات اتصال** ولا `application:bot.basic_info:read`. - **الرجوع إلى المعرف**: عندما لا يوفر الخادم اسما، يتم عرض المرسل بمعرفه ويظل الأمر يخرج 0. لا يوجد رجوع إلى دليل جهات الاتصال.
لا يتم تكرار `sender_name` الخام في الإخراج (قيمته في `name`)؛ يتم الاحتفاظ بخريطة `sender_i18n_names` الكاملة (جميع اللغات) للمستهلكين الذين يحتاجون إلى لغة معينة، جنبا إلى جنب مع `open_bot_id` اختياري (`ou_`) لمرسلي البوتات المتوافقين مع قناة حدث استلام الرسالة. رسائل النظام (`msg_type: system`) ليس لها اسم مرسل — وهذا أمر طبيعي، وليس خطأ.
### إثراء الرسائل الافتراضي (التفاعلات / update_time)
ترفق اختصارات سحب الرسائل الأربعة (`+messages-mget`، `+chat-messages-list`، `+messages-search`، `+threads-messages-list`) تلقائيا كتلة `reactions` و (للرسائل المحررة) `update_time` لكل رسالة مرجعة — لا يلزم إجراء استدعاء `im.reactions.batch_query` منفصل. مرر `--no-reactions` لإلغاء الاشتراك. للحصول على العقد الكامل (شكل الإخراج، متطلبات نطاق `im:message.reactions:read`، وقواعد البيانات "الحقل المفقود ≠ فشل الجلب")، اقرأ [`references/lark-im-message-enrichment.md`](references/lark-im-message-enrichment.md).
### إخراج الرسائل المدمج (`--concise`)
تدعم بعض اختصارات قائمة الرسائل `--concise` لإخراج Markdown مدمج. استخدمه عندما يطلب المستخدم إخراجا موجزا أو نتيجة/ملفا أصغر؛ تحقق من `--help` للتأكد من توفره ولا تجمعه مع `--format` صريح، أو `--json` ممكن، أو `--jq` غير فارغ.
### التنزيل التلقائي للموارد (اختياري) (`--download-resources`)
تقبل `+chat-messages-list` و `+messages-mget` و `+threads-messages-list` الخيار `--download-resources` لحفظ المرفقات المؤهلة في `./lark-im-resources/` وإضافة مصفوفة `resources` إلى كل رسالة. يتم إيقافه افتراضيا؛ الملصقات غير قابلة للتنزيل. يتم الإبلاغ عن المرفق الفاشل على هذا المورد دون إجهاض سحب الرسالة. استخدم [`+messages-resources-download`](references/lark-im-messages-resources-download.md) لمرفق واحد. راجع [`references/lark-im-message-enrichment.md`](references/lark-im-message-enrichment.md) للحصول على عقد الإخراج.
**موارد المجلدات** هي حاويات، لا
التثبيت
شغل هذا الأمر
npx skills add larksuite/cliيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add larksuite/cli`، أو استنسخ المستودع وانسخ مجلد `skills/lark-im` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة نموذج Lark؟
Feishu IM: إرسال واستقبال الرسائل وإدارة الدردشات الجماعية. إرسال الرسائل والرد عليها، البحث في سجلات الدردشة، إدارة أعضاء الدردشات الجماعية، تحميل وتنزيل الصور والملفات، إدارة الردود التعبيرية، إرسال رسائل عاجلة داخل التطبيق/عبر الرسائل النصية/عبر المكالمات، إرسال ومعالجة البطاقات التفاعلية (Interactive Card)، والاستماع إلى ردود نداء أزرار البطاقات (card.action.trigger). تستخدم عندما يحتاج المستخدم إلى إرسال رسائل،…
كيف أثبت نموذج Lark؟
شغل هذا الأمر في الطرفية:
npx skills add larksuite/cliمع أي أدوات ذكاء اصطناعي تعمل نموذج Lark؟
تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.
من طور نموذج Lark؟
طورها larksuite.
هل نموذج Lark مجانية؟
نعم، يمكنك استخدامها مجانا.
npx skills add vercel-labs/skills
npx skills add heygen-com/hyperframes
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى