skill

مشاركة Lark

يستخدم لمهام إعداد/مصادقة lark-cli: تسجيل الدخول/الحالة/تسجيل الخروج للمصادقة، هوية المستخدم مقابل الروبوت، أذونات نطاق العمل (--domain، بما في ذلك all/docs/drive)، النطاقات المفقودة، إلغاء التفويض، أو التعامل مع _notice JSON.

larksuite457,828+ تثبيتموثوق

نبذة

# قواعد مشاركة lark-cli

القاعدة الأساسية المشتركة لجميع مهارات `lark-*`: الهوية، المصادقة، عقد الإخراج، والعمليات عالية المخاطر.

## المبادئ التوجيهية العامة

1. **تأكيد الاستخدام قبل الاستدعاء**: اقرأ المرجع المقابل أو قم بتشغيل `--help` قبل التنفيذ، لا تخمن الأعلام وتستدعي بشكل أعمى.

2. **الهوية تحدد من تمثل في العملية**: `--as user` يمثل المستخدم نفسه (يمكنه رؤية والتحكم في تقويمه، مساحته السحابية/محرك الأقراص السحابي/التخزين السحابي، وغيرها من الموارد الشخصية)، بينما `--as bot` يمثل التطبيق نفسه، وهي عملية على مستوى التطبيق، ولا يمكنه الوصول إلا إلى موارد البوت الخاصة به. سيؤدي استعلام البوت عن موارد المستخدم إلى إرجاع نجاح فارغ بدلا من خطأ. تأكد من فهم الهوية `identity` قبل البدء. نموذج الهوية وإدارة الأذونات ← [`lark-shared-identity-and-permissions.md`](references/lark-shared-identity-and-permissions.md).

3. **يجب أن تحتوي عناوين URL الخاصة بالتفويض/التكوين على رمز QR**: عندما يخرج الأمر حقول URL مثل `verification_url`، `verification_uri_complete`، `console_url`، وما إلى ذلك، يجب استخدام `lark-cli auth qrcode` لإنشاء وعرض رمز QR في الرد، مع وضع URL أولا ثم رمز QR. الأولوية لإنشاء PNG (`--output`)، واستخدام ASCII (`--ascii`) فقط عندما يطلب المستخدم ذلك صراحة. قم بإعادة توجيه URL كما هو - لا تقم بترميزه أو فك ترميزه، ولا تضف علامات ترقيم، ولا تعيد بناء الاستعلام. يرجى عرض رمز QR والرابط معا للمستخدم.

4. **تحت `--format json` (افتراضي)، استخدم `ok == true` (أو رمز خروج العملية 0) للحكم على النجاح، لا تستخدم `code == 0`**: لا يحتوي غلاف النجاح على حقول `code` / `msg` علوية، ويظهر `code` فقط داخل `error` في غلاف الخطأ. سيؤدي الحكم وفقا لتنسيق OpenAPI القديم `{"code": 0, "msg": "ok"}` إلى الحكم بشكل خاطئ على جميع الاستدعاءات الناجحة على أنها فاشلة - وهذا خطير بشكل خاص عند تغليف أوامر الكتابة. عقد إخراج JSON ← [`lark-shared-output-contract.md`](references/lark-shared-output-contract.md).

## قواعد الأمان

1. **يحظر إخراج المفاتيح السرية** (مثل appSecret، accessToken) كنص عادي إلى الطرفية.

2. **يجب تأكيد نية المستخدم قبل عمليات الكتابة/الحذف**.

3. عندما يدعم الأمر المستهدف `--dry-run`، استخدم `--dry-run` لمعاينة الطلبات الخطيرة.

4. **رمز الخروج 10 هو بوابة تأكيد عالية المخاطر (`risk: "high-risk-write"`)، وليس خطأ**: توقف ← **اطلب تأكيد المستخدم** (اعرض `action`، `risk`، والمعلمات الرئيسية) ← بعد الحصول على **موافقة صريحة من المستخدم**، أضف علامة التأكيد المشار إليها بواسطة `hint` **إلى نهاية argv الأصلي الخاص بك** ثم أعد المحاولة؛ **لا تقم أبدا** بتجاوز ذلك بإضافة علامة التأكيد بصمت ← [`lark-shared-high-risk-approval.md`](references/lark-shared-high-risk-approval.md).

5. **مسارات الملفات تقبل فقط المسارات النسبية**: معلمات المسار مثل `--file`، `--output`، `--output-dir`، `@file` تقبل فقط المسارات النسبية ضمن دليل العمل الحالي (cwd). سيؤدي تمرير مسار مطلق إلى الإبلاغ عن `unsafe file path`. يجب إدخال البيانات (باستخدام `@file`، JSON كبير) عبر stdin أولا لتجنب مشاكل المسار والهروب.

## فهرس تشغيل المرجع القوي

عند استيفاء أي من شروط التشغيل، **يجب قراءة المرجع المقابل قبل تنفيذ الخطوة التالية**. إذا تم استيفاء شروط متعددة، اقرأها بالترتيب الموضح في الجدول، مع قراءة كل مرجع مرة واحدة فقط.

| شرط التشغيل القوي (يجب القراءة عند استيفاء أي شرط) | المرجع | |---|---| | معرفة من أنت (مستخدم/بوت)، الحصول على معلومات تفصيلية عن حقول الهوية الحالية، تشخيص الهوية، منطق اختيار `--as`، استمرارية الهوية، حالة تسجيل الدخول، المصادقة، النطاق، إدارة التفويض والأذونات، `missing_scopes` أو `console_url`، Agent يستعد لبدء أو إكمال `auth login` | [`lark-shared-identity-and-permissions.md`](references/lark-shared-identity-and-permissions.md) | | الحاجة إلى الاعتماد على عقد إخراج JSON للحكم على النجاح/الفشل، قراءة stdout/stderr، أو كتابة نصوص برمجية وتغليف للأوامر | [`lark-shared-output-contract.md`](references/lark-shared-output-contract.md) | | الاستعداد لتنفيذ high-risk-write (عملية عالية المخاطر)، الحكم على مستوى مخاطر الأمر، مواجهة رمز الخروج 10، `confirmation_required`، إعادة المحاولة بعد التأكيد | [`lark-shared-high-risk-approval.md`](references/lark-shared-high-risk-approval.md) | | الاستخدام الأول ل CLI يتطلب تشغيل `lark-cli config init` لإكمال تكوين التطبيق، أو عندما يشير CLI بوضوح إلى `config init --new` | [`lark-shared-config-init.md`](references/lark-shared-config-init.md) | | استفسار المستخدم عن إشعار، تحديث إصدار CLI، أو إخراج يحتوي على `_notice` (تحديث/مهارات متأخرة/تلميحات أوامر مهملة) | [`lark-shared-update-notice.md`](references/lark-shared-update-notice.md) |

التثبيت

شغل هذا الأمر

npx skills add larksuite/cli

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

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

ثبت باستخدام `npx skills add larksuite/cli`، أو استنسخ المستودع وانسخ مجلد `skills/lark-shared` إلى دليل مهارات Claude الخاص بك.

عرض المصدر

أسئلة شائعة

ما هي مهارة مشاركة Lark؟

يستخدم لمهام إعداد/مصادقة lark-cli: تسجيل الدخول/الحالة/تسجيل الخروج للمصادقة، هوية المستخدم مقابل الروبوت، أذونات نطاق العمل (--domain، بما في ذلك all/docs/drive)، النطاقات المفقودة، إلغاء التفويض، أو التعامل مع _notice JSON.

كيف أثبت مشاركة 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
npx skills add mattpocock/skills
الشواء مع المستندات
مقابلة مكثفة لصقل خطة أو تصميم، والتي تنشئ أيضا وثائق (ADR's ومسردا) أثناء تقدمنا.1,062,214+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
إعداد مهارات مات بوكوك
قم بتهيئة هذا المستودع لمهارات الهندسة: إعداد متتبع المشكلات الخاص به، ومفردات تصنيف الفرز، وتخطيط وثائق المجال. يشغل مرة واحدة قبل الاستخدام الأول لم…967,342+
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
نمذجة النطاق
لبناء وصقل النموذج النطاقي للمشروع. يستخدم عند مناقشة مصطلحات قاعدة الكود، أو كتابة أو تعديل ملف GLOSSARY.md، أو تسجيل أو تعديل ADR.747,767+
skillclaude_appclaude_codeclaude_api
npx skills add microsoft/azure-skills
بوابة Azure AI
تهيئة Azure API Management كبوابة للذكاء الاصطناعي لنماذج الذكاء الاصطناعي وأدوات MCP والوكلاء. متى: التخزين المؤقت الدلالي، حد الرمز المميز، سلامة ال…605,853+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
بحث
تحقق من سؤال مقابل مصادر أولية موثوقة للغاية، وسجل النتائج كملف Markdown في المستودع. استخدم هذا عندما يريد المستخدم البحث في موضوع، أو جمع حقائق حول…576,164+

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

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

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