skill
تقويم Lark
تقويم فيشو: لإدارة مواعيد التقويم وغرف الاجتماعات. يتيح عرض/البحث عن المواعيد، إنشاء/تحديث المواعيد، إدارة الحضور، الاستعلام عن أوقات الانشغال واقتراح الفترات الزمنية، وحجز غرف الاجتماعات. يستخدم عندما يحتاج المستخدم إلى عرض جدول المواعيد، إنشاء/تعديل الاجتماعات، أو الاستعلام عن/حجز غرف الاجتماعات. لا يشمل: الاستعلام عن سجلات اجتماعات الفيديو السابقة (تدار عبر lark-meeting)، أو مهام قائمة المهام (تدار عبر lark-task).
نبذة
# calendar (v4)
قبل البدء، يرجى قراءة [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md) (المصادقة، معالجة الأذونات).
**هام جدا — في أي عملية تتضمن حجز مواعيد/غرف اجتماعات، تعديل أوقات، أو البحث عن غرف اجتماعات، يجب أولا قراءة [`references/lark-calendar-schedule-meeting.md`](references/lark-calendar-schedule-meeting.md). يمكن تجاوز هذه الخطوة والانتقال مباشرة إلى [`references/lark-calendar-update.md`](references/lark-calendar-update.md) فقط عند تعديل حقول (تغيير العنوان/الوصف) أو إضافة/حذف مشاركين (دون المساس بالوقت أو غرف الاجتماعات).**
## الهوية
اختر الهوية بناء على **ملكية التقويم**:
- عرض/إدارة تقويم المستخدم المسجل نفسه ← `--as user` (افتراضي، لمعظم السيناريوهات). - عرض/إدارة التقويم الذي أنشأه/يمتلكه ال bot نفسه ← `--as bot`
**تعيين ضمائر المحادثة**: "أنا" = المستخدم المسجل، "أنت" = التطبيق (bot)؛ الضمائر المستخدمة كقيم للحقول (مثل المشاركين، مالك الاجتماع) لا تؤثر في تحديد الهوية، على سبيل المثال: "أنت تنشئ تقويما، وتدعوني، ومالك الاجتماع هو أنا" ← يتم الإنشاء بواسطة `--as bot`، والمستخدم المسجل هو مجرد مشارك ومالك للاجتماع.
```bash # تقويم المستخدم نفسه ← user lark-cli calendar +agenda --as user # تقويم أنشأه ال bot أو شارك فيه ← bot lark-cli calendar +agenda --as bot ```
## Shortcuts
| Shortcut | الوصف | |----------|------| | `+agenda` | عرض جدول الأعمال (افتراضيا اليوم) | | [`+meeting`](references/lark-calendar-meeting.md) | الحصول على معلومات اجتماع الفيديو المرتبطة (meeting_id، meeting_note) عبر معرف حدث التقويم. لا يتوفر meeting_id إلا إذا كان الحدث قد استضاف اجتماع فيديو. **ملاحظة**: للحصول على رابط اجتماع الفيديو، استخدم أمر `+get`. | | [`+create`](references/lark-calendar-create.md) | إنشاء حدث تقويم ودعوة المشاركين (توقيت ISO 8601) | | [`+update`](references/lark-calendar-update.md) | تحديث حقول حدث موجود، أو إضافة/إزالة مشاركين وغرف اجتماعات بشكل مستقل؛ يجب تمرير `--apply-to` للأحداث المتكررة/الاستثناءات (انظر [إرشادات عمليات الأحداث المتكررة](references/lark-calendar-recurring.md) لمزيد من التفاصيل) | | `+delete` | حذف حدث تقويم؛ يجب تمرير `--apply-to` للأحداث المتكررة/الاستثناءات (انظر [إرشادات عمليات الأحداث المتكررة](references/lark-calendar-recurring.md) لمزيد من التفاصيل) | | `+freebusy` | الاستعلام عن حالة الانشغال/الفراغ/RSVP للتقويم الرئيسي والفترات الزمنية المتاحة. (**إذا كنت بحاجة إلى حجز/اقتراح فترات زمنية**، استخدم `+suggestion` — فهو يوصي بناء على ساعات العمل، فترات الانشغال، وأوقات الراحة.) | | [`+room-find`](references/lark-calendar-room-find.md) | البحث عن غرف اجتماعات متاحة لكتلة زمنية **محددة** أو أكثر (يمنع الاستدعاء المباشر عند عدم وجود وقت محدد، يجب استخدام `+suggestion` أولا) | | [`+rsvp`](references/lark-calendar-rsvp.md) | الرد على حدث التقويم (قبول/رفض/معلق) | | [`+join-event`](references/lark-calendar-join-event.md) | الانضمام إلى حدث تقويم باستخدام رمز المشاركة (رابط مشاركة/رمز QR/بطاقة مشاركة/بطاقة RSVP) | | [`+suggestion`](references/lark-calendar-suggestion.md) | التوصية بخطط كتل زمنية متاحة متعددة بناء على وقت غير محدد أو نطاق زمني | | [`+transfer`](references/lark-calendar-transfer.md) | نقل منظم الحدث إلى مستخدم أو روبوت آخر؛ لا يمكن التراجع عنه، يتطلب `--yes` | | [`+list-attendees`](references/lark-calendar-list-attendees.md) | سرد المشاركين وغرف الاجتماعات في الحدث (يدعم التصفية حسب `--type`: user / resource / chat / third_party) |
### `+get` — تفاصيل حدث واحد
الحصول على تفاصيل **حدث واحد** عبر `calendar_id` + `event_id`.
```bash # إذا لم يتم تمرير calendar_id، يتم استخدام primary افتراضيا lark-cli calendar +get --calendar-id <calendar_id> --event-id <event_id> ```
يتم استخدام حقل `description` واحد لوصف الحدث، ويتم التعامل معه كنص منسق **Markdown**. عند قراءة الحدث، ترجع `description` نص Markdown المنسق (إذا كان هناك وصف نصي عادي فقط، فسيرجع هذا النص العادي)؛ عند إنشاء/تحديث الحدث، يتم تمرير Markdown أيضا عبر `--description`.
> لا ترجع `+get` المشاركين وغرف الاجتماعات. للحصول على منظور المشاركين (المستخدمين / غرف الاجتماعات / المجموعات / رسائل البريد الإلكتروني للجهات الخارجية)، يرجى استدعاء [`+list-attendees`](references/lark-calendar-list-attendees.md).
### `+search-event` — البحث عن الأحداث حسب الكلمات الرئيسية، النطاق الزمني، والمشاركين
ترجع فقط الحقول الأساسية (`event_id`/`summary`/`start`/`end` وما إلى ذلك)، للحصول على التفاصيل يرجى استخدام `+get`.
```bash # query حسب الكلمات الرئيسية (اختياري) # start/end حسب النطاق الزمني (ISO 8601 أو YYYY-MM-DD) (اختياري) # attendee-ids حسب المشاركين (تحديد تلقائي لبادئة ou_ للمستخدمين / oc_ للمحادثات الجماعية / omm_ لغرف الاجتماعات) (اختياري) # page-token مؤشر ترقيم الصفحات، يستخدم للمتابعة إلى الصفحة التالية (اختياري) # page-size عدد العناصر في كل صفحة، الافتراضي 30 (اختياري) lark-cli calendar +search-event --query "اجتماع أسبوعي" --start 2026-04-20 --end 2026-04-27 --attendee-ids "ou_user1,oc_chat1,omm_room1" --page-token <page_token> --page-size 30 ```
دلالة القيم المتعددة ل `--attendee-ids`: **داخل نفس النوع تكون OR (اتحاد)** — سيتم إرجاع الحدث إذا تطابق مع أي معرف من نفس النوع في القائمة.
- `--attendee-ids "ou_A,ou_B"` = الأحداث التي يحضرها A **أو** B (**ليس** A و B معا).
### `+delete` — حذف حدث
```bash # إذا لم يتم تمرير calendar_id، يتم استخدام primary افتراضيا lark-cli calendar +delete --calendar-id <calendar_id> --event-id <event_id> --notify=true ```
### `+agenda` — عرض جدول الأعمال القريب
يستعلم افتراضيا عن اليوم الحالي. يجب تنظيم النتائج في شكل جدول زمني سهل القراءة، مجمعة حسب التاريخ ومرتبة تصاعديا حسب وقت البدء.
```bash # start/end نطاق زمني (ISO 8601 / YYYY-MM-DD / Unix ثوان)، كلاهما اختياري؛ الافتراضي هو اليوم الحالي # calendar-id معرف التقويم (الافتراضي primary) اختياري lark-cli calendar +agenda --start 2026-03-10 --end 2026-03-17 --calendar-id <calendar_id> ```
ملاحظة: - يتم تصفية الأحداث الملغاة تلقائيا؛ إذا لم تكن هناك أحداث، يتم الإبلاغ مباشرة ب "الجدول الزمني فارغ". - إذا تجاوز النطاق الزمني 40 يوما، فسيتم تقسيم الاستعلام تلقائيا ودمج النتائج.
### `+freebusy` — الاستعلام عن فترات الانشغال/الفراغ في التقويم الرئيسي / الأحداث / الفراغ المشترك
يتولى `+freebusy` أربعة منظورات: الفئات الحسابية الهندسية (`busy` / `free` / `common_free`) يتم دمجها تلقائيا؛ الفئات ذات الأبعاد الحدثية (`raw_busy`) تحتفظ بكل حدث أصلي + `rsvp_status`.
```bash # start/end نطاق زمني (ISO 8601 / YYYY-MM-DD / Unix ثوان)، كلاهما اختياري؛ الافتراضي هو اليوم الحالي # user-id معرف المستخدم المستهدف open_id، يمكن تكراره أو فصله بفاصلات؛ الافتراضي هو المستخدم المسجل حاليا، يجب تمرير واحد على الأقل بشكل صريح لهوية ال bot # type منظور من أربعة خيارات (الافتراضي busy): # busy فترات الانشغال المدمجة لكل مستخدم (للعثور على فترات الفراغ، أو رؤية فترات الانشغال) # raw_busy كتل الأحداث الأصلية لكل مستخدم + rsvp_status (لحساب الاجتماعات، ورؤية rsvp لكل اجتماع) # free فترات الفراغ لكل مستخدم ضمن النافذة الزمنية (يمكن التصفية باستخدام --min-duration) # common_free فترات الفراغ المشتركة لجميع المستخدمين (يمكن التصفية باستخدام --min-duration) # min-duration يسري فقط على free / common_free؛ بتنسيق Go duration، مثل 30m، 1h، 90m
# الاستعلام عن فترات الانشغال (إزالة التكرارات ودمج الفترات المتجاورة/المتداخلة) lark-cli calendar +freebusy --start 2026-03-11 --end 2026-03-11 --user-id ou_a,ou_b --type busy
# رؤية عدد اجتماعات الآخرين، بداية ونهاية كل اجتماع + rsvp (لا يتم دمج الفترات المتجاورة/المتداخلة، مع حالة rsvp) lark-cli calendar +freebusy --start 2026-03-11 --end 2026-03-11 --user-id ou_a,ou_b --type raw_busy
# الاستعلام عن فترات فراغ المستخدم lark-cli calendar +freebusy --start 2026-03-11 --end 2026-03-11 --user-id ou_a,ou_b --type free
# فترات الفراغ المشتركة لعدة أشخاص (موصى بها كبديل للدمج اليدوي) lark-cli calendar +freebusy --start 2026-03-11T09:00:00+08:00 --end 2026-03-11T18:00:00+08:00 --user-id ou_a,ou_b --type common_free --min-duration 30m ```
نصائح الاستخدام: - **`+freebusy` مناسب فقط للاستعلام عن حقيقة فترات الانشغال/الفراغ**. إذا كان الهدف هو "**التوصية** بفترة زمنية مناسبة لاجتماع" (لشخص واحد أو عدة أشخاص)، فيجب استخدام [`+suggestion`](references/lark-calendar-suggestion.md) أولا — فهو يوصي بناء على **ساعات العمل، فترات الانشغال، وفترات الراحة**، بينما `+freebusy` يجيب فقط على "ما هي الفترات المتاحة" ولا يحدد ما إذا كانت هذه الفترة مناسبة لجدولة اجتماع. - **الفراغ المشترك لعدة أشخاص**: إذا كنت تريد فقط "ما هي الفترات المشتركة غير المشغولة" ← `--type common_free [--min-duration <dur>]`؛ إذا كنت تريد "فترات الاجتماع الموصى بها" ← استخدم `+suggestion`.
## توجيه الشروط المسبقة
> **أولا، تحديد ما إذا كان الحدث متكررا**: إذا كان الكائن المراد معالجته حدثا متكررا، فيجب أولا قراءة [إرشادات عمليات الأحداث المتكررة](references/lark-calendar-recu
التثبيت
شغل هذا الأمر
npx skills add larksuite/cliيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add larksuite/cli`، أو استنسخ المستودع وانسخ مجلد `skills/lark-calendar` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة تقويم Lark؟
تقويم فيشو: لإدارة مواعيد التقويم وغرف الاجتماعات. يتيح عرض/البحث عن المواعيد، إنشاء/تحديث المواعيد، إدارة الحضور، الاستعلام عن أوقات الانشغال واقتراح الفترات الزمنية، وحجز غرف الاجتماعات. يستخدم عندما يحتاج المستخدم إلى عرض جدول المواعيد، إنشاء/تعديل الاجتماعات، أو الاستعلام عن/حجز غرف الاجتماعات. لا يشمل: الاستعلام عن سجلات اجتماعات الفيديو السابقة (تدار عبر lark-meeting)، أو مهام قائمة المهام (تدار عبر lark-task).
كيف أثبت تقويم 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
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى