Install
npx skills add WeComTeam/wecom-cli -y -gلمن يناسب
استخدم هذه المهارة عندما تريد تشغيل WeCom من الطرفية — رسائل وبريد ومستندات ومهام وتقويم واجتماعات وWeDrive أو جهات اتصال — وتريد أن يشارك البشر وAI Agent نفس سطر الأوامر. ليست لوحة ويب أخرى؛ توصل قدرة المنصة المفتوحة إلى الطرفية لرفع كفاءة المكتب. المستودع الرسمي:
https://github.com/wecomteam/wecom-cli
الشروط المسبقة صريحة: يلزم هذا الجهاز Node.js >= 18 وحساب WeCom؛ المنصات محدودة بـ macOS (x64/arm64) وLinux (x64/arm64) وWindows (x64). بلا حساب أو بإصدار منخفض أو خارج هذه المنصات لا تثبّت بعد. من يريد فقط النقر على WeCom في المتصفح ولا يريد ترك أمر عام هنا لا يبدأ من هنا.
المصدر يقسم تثبيت CLI وتثبيت CLI Skill إلى خطوتين ويكتب أن المهارة مطلوبة. احصل على سطر الأوامر أولاً ثم علّم الوكيل استدعاءه. لا تخترع مثبّتًا لم يظهر ولا تضف مجلد مهارة غير مسمّى. المصدر لا يكتب «البشر وAI Agent» كحصرية بضعة منتجات؛ لا تضيّق العملاء المذكورين بنفسك.
أنهِ أول محاولة في 3 دقائق
أكّد أولاً ثلاثًا: Node.js هو 18 أو أعلى؛ لديك حساب WeCom؛ النظام الحالي ضمن المنصات أعلاه. افتح الصفحة الرسمية وتحقق:
https://github.com/wecomteam/wecom-cli
المسار الرئيسي: ثبّت الـ CLI أولاً ثم مهارة CLI المطلوبة. تثبيت الحزمة يغيّر الأوامر العامة لهذا الجهاز؛ قبل التنفيذ أكّد أنك تريد ترك @wecom/cli هنا:
npm install -g @wecom/cli
بعد ذلك نفّذ تثبيت المهارة الذي يعطيه المصدر (معلّم كمطلوب):
npx skills add WeComTeam/wecom-cli -y -g
لا تقسم هاتين الخطوتين إلى مسارين رئيسيين متوازيين ولا تغيّر المعاملات. المصدر لا يكتب مجلد هبوط المهارة؛ لا تخترع مسارًا.
في المرة الأولى داخل وكيل تحقق فقط؛ لا تنشئ مستندات ولا ترسل بريدًا ولا تغيّر التقويم. إن لم تُضبط بيانات الاعتماد بعد فالإعداد أثر جانبي: مسح QR افتراضيًا أو --manual للكتابة. قبل التنفيذ أكّد أن هذا حساب WeCom الخاص بك وأنك مستعد لإنهاء هذا التفاعل:
wecom-cli auth init
بعد الإعداد افحص التفويض بأمر للقراءة فقط:
wecom-cli auth show
إشارة النجاح: ينتهي الأمر طبيعيًا وترى حالة التفويض الحالية. المصدر لا يعطي أسماء حقول لـ show؛ لا تخترع تنسيق خرج. في المرة الأولى لا تفعل إشعارات بوت ولا كتابة مستندات ولا حجز اجتماعات ولا رفع WeDrive. إن كان الوكيل يردد فقط «init أولاً ثم show» ولم يشغّل show فعلًا فلا تعامل التفويض كنجاح قائم.
حالات استخدام
الحالة 1: التحقق من التفويض فقط. بعد تثبيت CLI والمهارة المطلوبة نفّذ wecom-cli auth show في الطرفية أو في وكيل يستطيع استدعاء الأوامر نفسها. هذا يفحص حالة التفويض للتأكد أن بيانات الاعتماد ما زالت موجودة. قبل التنفيذ أكّد أنك لن تغيّر الإعداد عرضًا؛ إشارة النجاح رؤية حالة التفويض. المصدر لا يكتب رمز خروج لغير المفوّض؛ عند الفشل توقف ولا تخترع أمر إصلاح. لا توسّع هذا الفحص إلى إرسال بريد أو قراءة جهات اتصال؛ تلك الأفعال بلا صياغة أمر مقابلة.
الحالة 2: ضبط بيانات الاعتماد أول مرة. المصدر يكتب أن ضبط بيانات الاعتماد تفاعلي ويُحتاج مرة واحدة، مسح QR افتراضيًا، و--manual للكتابة. الأمر هو wecom-cli auth init. قبل التنفيذ أكّد أنك تريد ترك بيانات اعتماد WeCom على هذا الجهاز وأنك مستعد للمسح أو الكتابة. بعد الضبط شغّل wecom-cli auth show للتحقق. المصدر لا يكتب أمر إلغاء أو خروج؛ لا تخترع خطوة لإزالة بيانات الاعتماد. قدرات العمل — رسائل ومستندات ومهام وتقويم واجتماعات وWeDrive وبريد وجهات اتصال — مكتوبة كأسماء قدرة فقط، مثل إنشاء المستندات وقراءتها والبحث في المستندات وإنشاء التقويم وإدارته وحجز الاجتماعات وجلب معلوماتها وإنشاء المهام ومتابعتها ورفع ملفات WeDrive وجلبها وإرسال البريد وجلبه وجلب أعضاء جهات الاتصال وإشعارات يبدأها البوت؛ عندما تحتاج تلك العمليات عد أولاً إلى المستودع الرسمي ولا تخترع أوامر.
حدود الاستخدام
المنصة ووقت التشغيل وشرط الحساب تتبع المصدر: macOS (x64/arm64) وLinux (x64/arm64) وWindows (x64) وNode.js >= 18 وحساب WeCom. البشر وAI Agent يمكنهما العمل في الطرفية، لكن المصدر لا يسمّي منتج وكيل محدد؛ لا تكتب بضعة عملاء كحصريين.
ترتيب التثبيت هو npm install -g @wecom/cli ثم npx skills add WeComTeam/wecom-cli -y -g المطلوب. لا تخترع سوقًا ثانية ولا متغير skills add غير مكتوب. لا تقرأ «المهارة المطلوبة» كإذن لتجاوز الـ CLI؛ يجب إنهاء الخطوتين بترتيب المصدر.
ضبط بيانات الاعتماد يكتب على هذا الجهاز، مسح QR افتراضيًا، و--manual متاح. المصدر لا يكتب مسار الملف ولا سياسة الانتهاء ولا كيفية الإلغاء. تغطية العمل تشمل الرسائل والبريد والمستندات والمهام والتقويم والاجتماعات وWeDrive وجهات الاتصال بما فيها إشعارات البوت والبحث في المستندات وحجز الاجتماعات ورفع WeDrive، لكن الدليل يتوقف عند وصف القدرة ولا يعطي صياغة تلك الأوامر الفرعية؛ لا تُكمل معاملات أو نطاقات صلاحية أو فوترة غير مكتوبة. في المرة الأولى تحقق من التفويض فقط؛ لا تعامل أفعال المكتب بلا أمر كخطوات قابلة للنسخ أصلًا. لا تخترع مسارات إزالة أو تحديث لم يكتبها الدليل.