skill
قاعدة بيانات Lark
عمليات جداول فيشو متعددة الأبعاد (Base): إنشاء الجداول، الحقول، السجلات، طرق العرض، الإحصائيات، الصيغ/البحث (lookup)، النماذج، لوحات المعلومات، وضع التطبيق (صفحات ومكونات BaseApp/AppMode)، دليل مساحة العمل (Workspace)، سير العمل (workflow)، صلاحيات الأدوار، مركز القوالب (تصنيف/قائمة/بحث قوالب الجداول متعددة الأبعاد)؛ يستخدم عند مواجهة روابط Base/جداول متعددة الأبعاد/bitable، BaseApp/AppMode، /base/ أو /app/. لا تستخدم BaseApp مسار lark-apps؛ يتم تحويل استيراد/تصدير الملفات إلى lark-drive، ويتم تحويل المصادقة/الترخيص إلى lark-shared.
نبذة
# Base
Base العادية هي حاوية بيانات تتكون من شجرة موارد Base Block وتكوين على مستوى Base. `folder` و`table` و`docx` و`dashboard` و`workflow` كلها أنواع Block؛ Advanced Permission / Role هي تكوينات على مستوى Base، ولا تنتمي إلى Block. Table هي Block الأساسي الذي يحمل بيانات الأعمال. Workspace هي الحاوية الخارجية التي تنظم Base وBaseApp؛ BaseApp (AppMode) تنظم بيانات Base من خلال Page والمكونات، وليست اسما مستعارا ل Base.
## اختيار الهوية (الأولوية)
عند تشغيل Base، تستخدم `--as user` بشكل تفضيلي؛ تستخدم `--as bot` عندما يطلب المستخدم صراحة تطبيق هوية البوت. في حالة فشل الأذونات، يتم إصلاح نطاق scope أو ACL المورد باستخدام `lark-shared` بالهوية الأصلية؛ لا يتم تبديل الهوية إلا إذا وافق المستخدم صراحة على تغيير المشغل.
## ما يجب فعله قبل الدخول: تحليل الكيان المستهدف
قبل بدء العملية، حدد `base_token` ونوع الكيان المستهدف؛ إذا كان السياق يوفر علامات `<bitable>` / `<base_refer>` ومعرف المورد، فاستخدمها مباشرة. في الحالات الأخرى، اختر نقطة الدخول بناء على الغرض:
1. **URL أو رابط مشاركة:** `lark-cli base +url-resolve --url '<url>' --as user`. يدخل Base URL إلى الوحدة النمطية المقابلة بناء على `resource_type` / `block_type` المعادة وإحداثيات مثل `table_id` و`view_id` و`record_id` و`dashboard_id` و`workflow_id` و`docx_token` و`share_token`. يعيد BaseApp `/app/` URL قيمة `app_token`، ويعيد `workspace_token` و`page_id` إذا كان الرابط يحملهما. نوع الكيان يعتمد على نتيجة التحليل. 2. **عنوان Base أو كلمة مفتاحية:** `lark-cli base +title-resolve --title '<keyword>' --as user`. يتم الحصول على `base_token` مباشرة إذا كانت هناك نتيجة واحدة؛ في حالة وجود عدة مرشحات، يتم التمييز بينها بناء على العنوان والمالك ووقت التحديث، وإذا لم يكن بالإمكان تحديدها بشكل فريد، يطلب من المستخدم الاختيار. ثم يتم تحديد الكيان المستهدف وفقا لنموذج موارد Base Block أدناه. 3. **قائمة مرشحات Base الموجودة:** إذا أراد المستخدم سرد مرشحات Base الموجودة، ويحتاج إلى تصفية/فرز حسب الأبعاد مثل آخر وصول، المالك، المنشئ، الوقت، النوع، فيتم التحويل إلى `lark-cli drive +search --doc-types bitable --as user`. لتحديد Base واحد حسب العنوان/الكلمة المفتاحية، لا يزال يستخدم `+title-resolve`. أوامر قائمة المرشحات الشائعة: - آخر وصول: `lark-cli drive +search --doc-types bitable --sort open_time --opened-since 3m --page-size 20 --as user` - سرد ما أملكه فقط: أضف `--mine`؛ إذا أردت سرد "ما أنشأته"، استخدم `--created-by-me`. - بعد الحصول على URL أو token من المرشحات، استخدم `+url-resolve` أو `+base-get` للدخول إلى أوامر أعمال Base. 4. **BaseApp:** يفضل استخدام URL الحقيقي `/app/`؛ إذا كان `workspace_token` موجودا، يمكن استخدام `+workspace-entity-list --type baseapp` لتحديده. إذا لم يكن أي منهما موجودا، يطلب من المستخدم توفير رابط التطبيق أو Workspace، ولا يتم تخمين `app_token` عالميا بالاسم.
**قراءة Base:** تستخدم `+base-get` لمعلومات Base، ويقرأ دليل الموارد وفقا لنموذج موارد Base Block أدناه.
**كتابة Base:** لإنشاء Base جديد، تستخدم `+base-create --name <base-name> --table-name <table-name> --fields '<field-array>'` لإنشاء Base والجدول الأول والحقول في نفس الوقت؛ `+base-copy` لنسخ Base بالكامل؛ تدار موارد Base الداخلية بشكل موحد وفقا لدورة حياة Block أدناه.
## مركز قوالب Base
مركز القوالب هو مكتبة قوالب Base عامة، وليست Base موجودة في مساحة سحابة المستخدم. عندما يرغب المستخدم في إنشاء Base جديد باستخدام قالب جاهز، ولا يوجد مرساة تشير إلى كائن موجود (لا يوجد Base URL، لا يوجد "جداولي/الجداول التي تم الوصول إليها مؤخرا"، لا يوجد اسم Base محدد موجود)، يمكنه قراءة [lark-base-template-center.md](references/lark-base-template-center.md) للبحث عن قوالب مركز القوالب؛ `+template-categories` يسرد فئات القوالب العامة، `+template-list` يسرد القوالب العامة حسب الفئة، `+template-search` يبحث عن القوالب العامة بكلمات مفتاحية للأعمال.
## نموذج موارد Base Block
```text Base ├── شجرة موارد Base Block │ ├── Table Block │ │ ├── Field schema │ │ ├── Records / CellValue │ │ ├── Views │ │ └── Forms / Questions │ ├── Dashboard Block (حاوية تخطيط) │ │ └── Blocks داخلية للوحة المعلومات (رسوم بيانية، بطاقات مؤشرات، نص) │ ├── Workflow Block │ │ └── تعريف Workflow (العنوان، الحالة، مخطط تنفيذ الخطوات) │ ├── Docx Block → docx_token / lark-doc │ └── Folder Block → Block فرعي └── تكوين على مستوى Base └── Advanced Permission / Roles ```
كل Base Block له `id`، `type`، `name` قابل للتعديل، `parent_id` للمجلد الذي ينتمي إليه، وله ترتيب في نفس الدليل. `+base-block-list` هو نقطة دخول الاكتشاف الموحدة؛ `+base-block-create` لإنشاء Block، `+base-block-rename` لتعديل الاسم، `+base-block-move` لضبط الدليل عبر `--parent-id` وضبط الترتيب عبر `--before-id` / `--after-id`، `+base-block-delete` لحذف Block. يتم التعامل مع المحتوى الخاص بالنوع بواسطة أوامر الوحدة النمطية المقابلة.
عند الإنشاء، إذا كان المحتوى الأولي الخاص بالنوع واضحا بالفعل، يمكن استخدام أمر الإنشاء المقابل مباشرة لإنجاز المهمة مرة واحدة: Table يستخدم `+table-create --fields`، Dashboard يستخدم `+dashboard-create` لتعيين السمة، Workflow يستخدم `+workflow-create --json` لتقديم تعريف كامل؛ Folder وDocx يستخدمان `+base-block-create`.
يستخدم `id` الخاص ب Block مباشرة كإحداثيات الوحدة النمطية المقابلة حسب النوع:
| نوع Block | إحداثيات الوحدة النمطية والمحتوى الداخلي | |---|---| | `table` | `id` هو `table_id`؛ يحتوي داخليا على Field وRecord وView وForm | | `dashboard` | `id` هو `dashboard_id`؛ يحتوي داخليا على مكونات لوحة المعلومات مثل الرسوم البيانية وبطاقات المؤشرات والنصوص | | `workflow` | `id` هو `workflow_id`؛ يحتوي داخليا على العنوان والحالة ومخطط تنفيذ الخطوات | | `docx` | Block يحمل `docx_token` إضافيا؛ يتم التعامل مع النص الأساسي بواسطة `lark-doc` | | `folder` | `id` هو معرف Block الدليل، ويمكن استخدامه أيضا ك `--parent-id`؛ ينظم فقط Blocks الفرعية |
## Table Block (الجوهر)
Table نفسه هو Base Block، وهو أيضا طبقة تخزين البيانات الأساسية ل Base؛ Field وRecord وView وForm هي كائنات داخلية ل Table، وليست Base Block. تبدأ جميع استعلامات بيانات الأعمال والكتابة والربط والإحصاء والتحليل من Table. استخدم `+table-list` أولا لتحديد Table؛ يمكن للقراءة العادية التي تعرف أسماء الحقول والأهداف الدخول مباشرة إلى أوامر Record، ولا يتم إضافة `+field-list` إلا للمهام التي تعتمد على نوع الحقل/ال schema مثل الكتابة أو التصفية أو الربط. يمكن تنفيذ `+field-list` للجداول المتعددة بالتوازي. تتم قراءة وكتابة Record / CellValue الأساسية مباشرة وفقا للمسار أدناه؛ المرجع يحمل فقط التحليلات المتقدمة والبروتوكولات الكاملة وتفاصيل الحدود.
**قراءة Table:** `+table-list` لتحديد الجدول، `+table-get` لقراءة التفاصيل. يستخدم `+table-copy` لنسخ Table بشكل خاص، و`+table-copy-status` لحالة عدم التزامن؛ يتم التعامل مع ال schema والسجلات بواسطة عمليات الكائنات الداخلية أدناه.
تصبح معظم التحديثات تحت Table سارية المفعول عبر مسار غير متزامن، وقد لا تظهر أحدث حالة فورا بعد نجاح استجابة الواجهة. تعطى الأولوية لاستجابة الكتابة الناجحة كنتيجة للعملية؛ عندما يجب على المهمة تأكيد الحالة النهائية، يتم إكمال جميع التغييرات ذات الصلة في هذه الجولة أولا، ثم يتم القراءة والتحقق بشكل موحد، لتجنب القراءة الفورية بعد كل عملية كتابة.
### Field
يحدد Field ال schema للعمود. `field_id` هو معرف عمود ثابت، `name` هو اسم عرض قابل للتعديل؛ Formula وLookup وLink وSelect تنتمي إلى نوع Field أو قدرته.
**قراءة Field:** `+field-list` / `+field-get` / `+field-search-options`. **كتابة Field:** عند إنشاء عدة حقول في Table موجود، تعطى الأولوية لتمرير مصفوفة كائنات الحقول إلى `+field-create --json` مرة واحدة؛ تستخدم `+field-update` / `+field-delete` لتحديث وحذف حقل واحد. تقرأ عمليات الإنشاء والتحديث على التوالي من [field-create](references/lark-base-field-create.md) / [field-update](references/lark-base-field-update.md)، وتستمر وثائق الأوامر في توجيه بروتوكولات Field JSON وFormula وLookup. تستخدم `مكونات الحقول الإضافية` لتوسيع قدرات الحقول الأساسية: يتم تشغيل LLM لإنشاء محتوى بناء على محتوى حقول أخرى في نفس الصف، وكتابته مرة أخرى إلى الحقل المستهدف الموجود؛ حاليا، تم تأكيد دعم الحقل المستهدف للنص، والاختيار الفردي، والأرقام، تقرأ [field-extension](references/lark-base-field-extension.md) قبل التكوين أو التشغيل.
### Record
Record هو صف من البيانات في Table، يحتوي على CellValue لهذه السجل تحت كل Field. `record_id` للنظام هو مفتاح أساسي ثابت وغير فارغ وفريد داخل الجدول، وحقل Table الرئيسي هو مجرد حقل عرض.
#### 1. قراءة السجلات أو الخلايا
- معرفة عدة `record_id`: `+record-get --record-id <id1> --record-id <id2>` - البحث بالكلمات المفتاحية: `+record-search --keyword <text> --search-field <field>`؛ يجب تحديد حقل بحث واحد على الأقل. - القراءات الأخرى: `+record-list`؛ تستخدم `--filter-json` / `--sort-json` للشروط المنظمة والفرز على التوالي.
عندما يكون عدد الصفوف كبيرا ويتطلب دفع المسند من جانب الخادم، يستخدم `--filter-json` شرط tuple؛ أكثر طرق التصفية شيوعا وكتابة نطاق التاريخ الكامل:
```jsonc { "log
التثبيت
شغل هذا الأمر
npx skills add larksuite/cliيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add larksuite/cli`، أو استنسخ المستودع وانسخ مجلد `skills/lark-base` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة قاعدة بيانات Lark؟
عمليات جداول فيشو متعددة الأبعاد (Base): إنشاء الجداول، الحقول، السجلات، طرق العرض، الإحصائيات، الصيغ/البحث (lookup)، النماذج، لوحات المعلومات، وضع التطبيق (صفحات ومكونات BaseApp/AppMode)، دليل مساحة العمل (Workspace)، سير العمل (workflow)، صلاحيات الأدوار، مركز القوالب (تصنيف/قائمة/بحث قوالب الجداول متعددة الأبعاد)؛ يستخدم عند مواجهة روابط Base/جداول متعددة الأبعاد/bitable، BaseApp/AppMode، /base/ أو /app/. لا تستخ…
كيف أثبت قاعدة بيانات 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
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى