skill

فعالية Lark

الاستماع/الاشتراك/استهلاك أحداث Lark/Feishu في الوقت الفعلي: بث الأحداث ك NDJSON عبر `lark-cli event consume <EventKey>` (يغطي رسائل/تفاعلات/تغييرات الدردشة الفورية، تغييرات حالة الموافقات، تحديثات المهام، بدء/الانضمام/انتهاء اجتماعات VC، الدقائق المنشأة، تحديثات السبورة البيضاء، إشعارات تعليقات مستندات Drive، إلخ). يستخدم لروبوتات Lark، معالجة الرسائل في الوقت الفعلي، المشتركين طويلي الأمد، معالجات webhook/push المتدفقة. يدعم التشغيل المحدود ب `--max-events` / `--timeout` وجاهزية stderr...

larksuite477,619+ تثبيتموثوق

نبذة

# أحداث 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

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

خطوات التثبيت

ثبت باستخدام `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 مجانية؟

نعم، يمكنك استخدامها مجانا.

أصول ذات صلة

مختارات أخرى في إنشاء المحتوى.

كل بدائل فعالية Lark ←
skillclaude_appclaude_codeclaude_api
git clone https://github.com/anthropics/skills && cp -r skills/skills/docx ~/.claude/skills/
ملف Docx
استخدم هذه المهارة كلما أراد المستخدم إنشاء مستندات Word (ملفات ‎.docx) أو قراءتها أو تعديلها أو معالجتها، أو قوالب Word (ملفات ‎.dotx). تشمل المحفزات…★ 4.8 · 2,500+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
إعداد مهارات مات بوكوك
قم بتهيئة هذا المستودع لمهارات الهندسة: إعداد متتبع المشكلات الخاص به، ومفردات تصنيف الفرز، وتخطيط مستندات النطاق. يتم تشغيله مرة واحدة قبل الاستخدام…1,076,003+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
الشواء مع المستندات
مقابلة مكثفة لصقل خطة أو تصميم، والتي تنشئ أيضا وثائق (ADR's ومسردا) أثناء تقدمنا.1,062,214+
skillclaude_appclaude_codeclaude_api
npx skills add heygen-com/hyperframes
Hyperframes الأساسية
عقد تركيب HyperFrames — أنشئ مشروعا واحدا قابلا للتقديم. استخدمه لهيكل التركيب، وسمات التوقيت `data-*`، و`class="clip"`، والمسارات، والتركيبات الفرعية…876,697+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
بحث
ابحث في سؤال مقابل مصادر أولية موثوقة للغاية وقم بتوثيق النتائج كملف Markdown في المستودع. استخدم هذا عندما يرغب المستخدم في البحث عن موضوع، أو جمع حق…756,925+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
نمذجة النطاق
لبناء وصقل النموذج النطاقي للمشروع. يستخدم عند مناقشة مصطلحات قاعدة الكود، أو كتابة أو تعديل ملف GLOSSARY.md، أو تسجيل أو تعديل ADR.747,767+

افحص قبل التثبيت

شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.

المزيد في إنشاء المحتوى