عن المشروع

OpenCLI هي أداة سطر أوامر تعمل كجسر بين المواقع الإلكترونية وجلسات المتصفح وتطبيقات Electron والأدوات المحلية، لتوفير واجهات حتمية (deterministic) لكل من البشر ووكلاء الذكاء الاصطناعي. توفر ثلاث واجهات أتمتة رئيسية: محولات مدمجة للمواقع الشهيرة، تحكم وكلاء الذكاء الاصطناعي في المتصفح، ومركز CLI للأدوات المحلية. **القدرات الأساسية** 1. **المحولات المدمجة**: يأتي OpenCLI مع محولات لأكثر من 100 موقع بما في ذلك Bilibili وZhihu وXiaohongshu وReddit وHackerNews وTwitter/X وLinkedIn وAmazon وUpwork وMidjourney وغيرها الكثير. كل محول يعرض أوامر خاصة بالموقع مثل `opencli bilibili hot` أو `opencli twitter trending` أو `opencli hackernews top`. 2. **تحكم وكلاء الذكاء الاصطناعي في المتصفح**: قم بتثبيت مهارة `opencli-browser` في وكلاء الذكاء الاصطناعي (مثل Claude Code وCursor) للسماح لهم بالتنقل والنقر والكتابة وملء النماذج واستخراج البيانات وفحص أي صفحة عبر جلسة Chrome المسجلة لديك. يستخدم الوكيل لقطات DOM منظمة بدلاً من لقطات الشاشة للتفاعل الموثوق. 3. **مركز CLI**: تمرير موحد للأدوات الموجودة في سطر الأوامر مثل `gh` و`docker` و`vercel` و`wrangler` و`obsidian` و`longbridge` و`lark-cli` و`ntn` (Notion) و`dws` (DingTalk) و`wecom-cli` و`tg` و`discord` و`wx`. سجل أدوات مخصصة باستخدام `opencli external register`. 4. **محولات تطبيقات سطح المكتب**: تحكم في تطبيقات Electron مثل Cursor وTrae CN وCodex وAntigravity وتطبيق ChatGPT وChatWise وQoder وDiscord وDoubao وTrae SOLO عبر بروتوكول Chrome DevTools. **التثبيت** يتطلب OpenCLI Node.js >= 20.18.1. قم بالتثبيت عبر npm (`npm install -g @jackwener/opencli`) أو استخدم تطبيق سطح المكتب OpenCLIApp لنظامي macOS/Windows. امتداد Chrome (Browser Bridge) يربط OpenCLI بمتصفحك، وهو متاح من متجر Chrome الإلكتروني أو عبر التثبيت اليدوي. **أساسيات أتمتة المتصفح** يوفر أمر `opencli browser` أساسيات لأتمتة المتصفح: `open` و`state` و`click` و`type` و`fill` و`select` و`keys` و`wait` و`get` و`find` و`extract` و`frames` و`screenshot` و`scroll` و`back` و`eval` و`network` و`tab list` و`tab new` و`tab select` و`tab close` و`init` و`verify` و`close`. تتم إدارة الجلسات بأسماء جلسات صريحة، ويمكن استهداف علامات التبويب بشكل فردي. **تطوير المحولات** اكتب محولات جديدة من البداية إلى النهاية باستخدام مهارة `opencli-adapter-author`. تتضمن سير العمل استطلاع الموقع، اكتشاف نقاط النهاية، اختيار المصادقة (PUBLIC/COOKIE/INTERCEPT/UI/LOCAL)، فك تشفير الحقول، والتحقق. تستمر معرفة الموقع محليًا لإعادة استخدامها عبر المحولات. **دعم التنزيل** قم بتنزيل الصور ومقاطع الفيديو والمقالات من المنصات المدعومة بما في ذلك Xiaohongshu وBilibili وTwitter وDouban وPixiv و1688 وXiaoyuzhou (الصوت والنصوص) وZhihu (مقالات Markdown) وWeixin (مقالات WeChat). يتطلب تنزيل الفيديو `yt-dlp`. **تنسيقات الإخراج** تدعم جميع الأوامر `--format` مع `table` (الافتراضي) و`json` و`yaml` و`md` و`csv` للتوجيه إلى jq أو نماذج اللغة الكبيرة أو جداول البيانات. **الإضافات** قم بتوسيع OpenCLI بإضافات المجتمع عبر `opencli plugin install github:user/repo`. تشمل الإضافات المتاحة GitHub Trending، ومجمّع الاتجاهات متعدد المنصات، ومقالات Juejin الساخنة، وVK wall/feed/search، وناشر مقالات X. **الإعدادات** تتحكم متغيرات البيئة في اختيار الملف الشخصي، وموضع النافذة (المقدمة/الخلفية)، واستمرار الجلسة، والمهلات، ونقاط نهاية CDP، وتسجيل الدخول المفصل. تتبع رموز الخروج معيار Unix `sysexits.h` لتكامل CI/البرامج النصية. **الترخيص**: Apache-2.0