skill
فعالية Lark
الاستماع/الاشتراك/استهلاك أحداث Lark/Feishu في الوقت الفعلي: بث الأحداث ك NDJSON عبر `lark-cli event consume <EventKey>` (يغطي رسائل/تفاعلات/تغييرات الدردشة الفورية، تغييرات حالة الموافقات، تحديثات المهام، بدء/الانضمام/انتهاء اجتماعات VC، الدقائق المنشأة، تحديثات السبورة البيضاء، إشعارات تعليقات مستندات Drive، إلخ). يستخدم لروبوتات Lark، معالجة الرسائل في الوقت الفعلي، المشتركين طويلي الأمد، معالجات webhook/push المتدفقة. يدعم التشغيل المحدود ب `--max-events` / `--timeout` وجاهزية stderr...
نبذة
# أحداث Lark
> **متطلب مسبق:** اقرأ [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md) أولا للتعرف على المصادقة، والتبديل بين `--as user/bot`، ومعالجة `Permission denied`، وقواعد الأمان.
## الأوامر الأساسية
| الأمر | الغرض | |------|------| | `lark-cli event list [--json]` | سرد جميع EventKeys القابلة للاشتراك | | `lark-cli event schema <EventKey> [--json]` | إظهار معلمات EventKey ومخطط الإخراج الخاص بها | | `lark-cli event consume <EventKey> [flags]` | استهلاك حظر؛ الأحداث ← stdout NDJSON | | `lark-cli event status [--json] [--fail-on-orphan]` | فحص حالة خادم الناقل المحلي | | `lark-cli event stop [--all] [--force]` | إيقاف خادم الناقل |
## العلامات الشائعة
| العلامة | الوصف | |---|---| | `--param key=value` / `-p` | معلمات العمل (قابلة للتكرار؛ مفصولة بفاصلة للقيم المتعددة). تفشل المفاتيح غير المعروفة مع عرض الأسماء الصالحة المدرجة مباشرة | | `--jq <expr>` | تعبير jq لتصفية / تحويل كل حدث؛ الإخراج الفارغ يتخطى الحدث | | `--max-events N` | الخروج بعد N حدث. الافتراضي 0 = غير محدود | | `--timeout D` | الخروج بعد المدة D (مثل `30s`، `2m`). الافتراضي 0 = لا يوجد مهلة. أيهما يحدث أولا من `--max-events` / `--timeout` يفوز | | `--output-dir <dir>` | كتابة كل حدث كملف (مسارات نسبية فقط؛ يمنع التجاوز) | | `--quiet` | كتم علامات الاستعداد/الخروج وتشخيصات stderr لكل حدث، بما في ذلك تحذيرات الإسقاط. قد يخفي هذا فقدان الأحداث. **يجب ألا تستخدم AI هذا** — فهو يزيل إشارات الاستعداد والسلامة | | `--as user\|bot\|auto` | الهوية للجلسة (انظر lark-shared) |
## أمثلة
```bash # Default: stream every event for the key (no filter, no projection) lark-cli event consume im.message.receive_v1 --as bot
# List every EventKey of one domain (the authoritative, always-current catalog) lark-cli event list --domain vc --json
# Grab one sample event to inspect payload shape lark-cli event consume im.message.receive_v1 --max-events 1 --timeout 30s --as bot
# Run for 10 minutes then auto-exit lark-cli event consume im.message.receive_v1 --timeout 10m --as bot
# Consume multiple EventKeys concurrently (one shape per process, no dispatcher) lark-cli event consume im.message.receive_v1 --as bot > receive.ndjson & lark-cli event consume im.message.reaction.created_v1 --as bot > reaction.ndjson & wait
```
## تدفق الاستدعاء
1. `lark-cli event list --json` ← اختر مفتاحا قانونيا. `--domain <d>` يضيق النطاق إلى مجال واحد؛ المجالات هي `application`, `approval`, `board`, `card`, `drive`, `im`, `minutes`, `task`, `vc`. يفشل المجال غير المعروف مع عرض المجموعة الصالحة في التلميح. 2. `lark-cli event schema <key> --json` ← اقرأ `resolved_output_schema` + `jq_root_path` لتحديد مسارات الحقول 3. `lark-cli event consume <key> [--jq '<expr>']` ← استهلاك
## عقد العملية الفرعية
### علامة الاستعداد
يصدر `event consume` على stderr سطرا ثابتا `[event] ready event_key=<key>`. **يجب أن تحظر العمليات الأصلية على stderr حتى يظهر هذا السطر، ثم تبدأ في قراءة stdout.** لا تعتمد على `sleep`.
### نهاية ملف stdin = خروج سلس
يعامل `event consume` إغلاق stdin كإشارة إيقاف (موصولة لمستدعي العمليات الفرعية للذكاء الاصطناعي). **العمليات المحدودة مستثناة: عندما يتم تعيين `--max-events` أو `--timeout` (> 0)، يتم تجاهل نهاية ملف stdin وتخرج العملية فقط عبر حدها الخاص، أو المهلة، أو SIGTERM.** للعمليات غير المحدودة، سيؤدي `< /dev/null` / `nohup` / `StandardInput=null` الافتراضي ل systemd إلى خروج سلس فوري (stderr `reason: signal`). للحفاظ على عملية غير محدودة قيد التشغيل:
- قم بتغذية stdin بمصدر لا ينتهي أبدا: `< <(tail -f /dev/null)` - أو قم بتشغيلها بشكل محدود: `--max-events N` / `--timeout D`
### رموز الخروج والسبب
عند الخروج، يكون آخر سطر في stderr هو `[event] exited — received N event(s) in Xs (reason: ...)`.
| رمز الخروج | السبب | المشغل | |---|---|---| | 0 | `reason: limit` | تم الوصول إلى `--max-events` | | 0 | `reason: timeout` | تم الوصول إلى `--timeout` | | 0 | `reason: signal` | Ctrl+C / SIGTERM / نهاية ملف stdin (تنطبق نهاية ملف stdin على العمليات غير المحدودة فقط) | | 1 | غلاف خطأ JSON على stderr | فشل عمل Lark API أثناء إعداد ما قبل الاستهلاك (على سبيل المثال إنشاء/حذف اشتراك) | | 2 | غلاف خطأ JSON على stderr (لا يوجد سطر `exited`) | فشل التحقق من الصحة (EventKey غير معروف، `--param` / `--jq` سيء، ناقل آخر متصل بالفعل) | | 3 | غلاف خطأ JSON على stderr | فشل المصادقة (رمز مميز مفقود، نطاقات مفقودة) | | 4 / 5 | غلاف خطأ JSON على stderr | فشل الشبكة / داخلي (بدء تشغيل الناقل، المصافحة، إدخال/إخراج الملفات) |
تصدر أخطاء بدء التشغيل ووقت التشغيل غلاف JSON منظما على stderr: `{"ok":false,"error":{"type","subtype","param","message","hint",...}}` (قد يحمل الغلاف أيضا أشقاء `identity` / `_notice` على المستوى الأعلى). قم بتحليل `error.type` / `error.subtype` للتفرع (على سبيل المثال، `missing_scope` يحمل قائمة `missing_scopes`)، و `error.param` للعثور على العلامة المخالفة، و `error.hint` لإجراء الاسترداد — لا تقم بمطابقة نص الرسالة باستخدام regex.
يجب أن تتعامل المنسقات مع `reason: limit/timeout/signal` (جميعها تخرج برمز 0) على أنها "اكتمال العمل" وغير الصفر على أنها "فشل".
### لا تستخدم `kill -9` أبدا
**تجنب**
التثبيت
شغل هذا الأمر
npx skills add larksuite/cliيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add larksuite/cli`، أو استنسخ المستودع وانسخ مجلد `skills/lark-event` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة فعالية Lark؟
الاستماع/الاشتراك/استهلاك أحداث Lark/Feishu في الوقت الفعلي: بث الأحداث ك NDJSON عبر `lark-cli event consume <EventKey>` (يغطي رسائل/تفاعلات/تغييرات الدردشة الفورية، تغييرات حالة الموافقات، تحديثات المهام، بدء/الانضمام/انتهاء اجتماعات VC، الدقائق المنشأة، تحديثات السبورة البيضاء، إشعارات تعليقات مستندات Drive، إلخ). يستخدم لروبوتات Lark، معالجة الرسائل في الوقت الفعلي، المشتركين طويلي الأمد، معالجات webhook/push الم…
كيف أثبت فعالية Lark؟
شغل هذا الأمر في الطرفية:
npx skills add larksuite/cliمع أي أدوات ذكاء اصطناعي تعمل فعالية Lark؟
تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.
من طور فعالية Lark؟
طورها larksuite.
هل فعالية Lark مجانية؟
نعم، يمكنك استخدامها مجانا.
git clone https://github.com/anthropics/skills && cp -r skills/skills/docx ~/.claude/skills/
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add heygen-com/hyperframes
npx skills add mattpocock/skills
npx skills add mattpocock/skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى