بوابة المحتوى
1 دقيقة للقراءة
opencx content gate يتحقق من ملفات المحتوى المحلية لديك ويقارنها مع الملفات البعيدة لاكتشاف أي اختلافات. يجمع بين التحقق المحلي (content check) مع الفرق البعيد في أمر واحد.
الاستخدام
bash
opencx content gate
يتطلب المصادقة عبر OPENCX_API_KEY.
كيف يختلف عن التحقق
content check | content gate | |
|---|---|---|
| التحقق المحلي | نعم | نعم |
| اكتشاف الانجراف البعيد | لا | نعم |
| يتطلب المصادقة | لا | نعم |
| حالة الاستخدام | تطوير محلي، تحقق سريع | خطوط CI، بوابات قبل النشر |
يقوم content check بالتحقق من هيكل الملف، وfrontmatter، واتفاقيات التسمية محليًا. يقوم content gate بنفس التحقق، ثم يجلب الحالة البعيدة ويقارنها لاكتشاف أي اختلافات.
رموز الخروج
| الرمز | المعنى |
|---|---|
| 0 | المحتوى صالح ومتزامن |
| 1 | فشل التحقق أو المحتوى غير متزامن |
إخراج JSON
استخدم --json للحصول على إخراج قابل للقراءة بواسطة الآلة.
bash
opencx content gate --json
مخطط الإخراج:
json
{
"valid": true,
"synced": true,
"check": {
"valid": true,
"errors": [],
"stats": {
"categories": 3,
"articles": 12
}
},
"diff": {
"hasChanges": false
}
}
عند فشل التحقق، يكون synced هو false وdiff هو null:
json
{
"valid": false,
"synced": false,
"check": {
"valid": false,
"errors": [
{ "file": "docs/getting-started/intro.md", "message": "Missing required field: title" }
]
},
"diff": null
}
متى تستخدم Gate مقابل Check
- استخدم
content checkأثناء التطوير المحلي للحصول على ملاحظات سريعة. - استخدم
content gateفي خطوط CI لضمان أن المحتوى صالح ومتزامن قبل النشر. - استخدم
content checkفي سير العمل لطلبات السحب حيث تحتاج فقط إلى التحقق دون مقارنة بعيدة.