Codewhale وكيل مفتوح المصدر يقرأ مشروعك ويعدّل الملفات ويشغّل الأوامر ويتحقق من عمله باستخدام نموذج مستضاف أو محلي تختاره. ابدأ بمهمة واحدة في الطرفية. وللأعمال الأكبر، وزّع أجزاء العمل على وكلاء بنماذج وأدوار مختلفة.
معاينة للطرفية من بنية تطوير للإصدار v0.9.12.
English · 简体中文 · 日本語 · Tiếng Việt · Bahasa Indonesia · 한국어 · Español · Português · Русский · Українська · Français · Deutsch · 繁體中文 · हिन्दी · Türkçe · Italiano · Polski · Català
للتثبيت الجديد على macOS أو Linux، استخدم الإصدار الرسمي من GitHub:
curl -fsSL https://codewhale.net/install.sh | sh
"$HOME/.local/bin/codewhale"يختار المثبّت أحدث إصدار منشور. ويصف سجل التغييرات أيضًا النسخة المرشحة غير المنشورة للإصدار التالي؛ ولا تُضمّن هذه التغييرات في التنزيلات المنشورة حتى يصبح الإصدار متاحًا.
على Windows، نزّل المثبّت أو الأرشيف المناسب من GitHub Releases. لتحديث تثبيت مباشر موجود، شغّل codewhale update، أو codewhale update --check للفحص فقط. يعرض المحدّث مسار الملف التنفيذي ويحتفظ بالبنيات الأحدث. npm وCargo خياران ثانويان؛ راجع دليل التثبيت للانتقال من تثبيت يديره مدير حزم وإعداد PATH.
يساعدك Codewhale عند التشغيل الأول على الاتصال بموفّر أو إعداد Codewhale دون اتصال. تتطلب ردود النموذج الاتصال بنموذج مستضاف أو محلي. ويدعم Codewhale أيضًا npm وCargo كخياري تحزيم ثانويين، إلى جانب Docker وNix وScoop وAndroid/Termux ومرآة CNB اختيارية. تتوفر تعليمات انتقال للتثبيتات الحالية التي يديرها مدير حزم. راجع المساعدة بشأن التثبيت وPATH.
يمكن تفعيل الإكمال بمفتاح Tab بأمر واحد لكل واجهة أوامر — codewhale completion bash|zsh|fish|powershell|elvish. راجع إكمال واجهة الأوامر.
افتح طرفية في مجلد مشروعك وشغّل codewhale. اختر موفّرك باستخدام /provider ونموذجك باستخدام /model. ثم صِف مهمة محددة:
Fix the failing tests and explain what changed.
أو شغّل مهمة من دون فتح واجهة TUI:
codewhale exec "fix the failing tests and explain what changed"يستطيع Codewhale قراءة مستودعك وتعديل الملفات وتشغيل الأوامر وفحص النتائج ومواصلة العمل نحو هدف. استخدم /mode plan للاستكشاف دون تغيير الملفات أو تنفيذ أوامر واجهة الأوامر، و/mode work عندما تريد إجراء تغييرات. اضغط Shift+Tab لاختيار Ask أو Auto-Review أو Full Access؛ يوضح دليل الأوضاع والصلاحيات ما يسمح به كل خيار.
تتصل الطرفية والعملاء الرسوميون ببيئة Codewhale Runtime، التي تشغّل الوكيل وأدواته:
- الطرفية: يفتح
codewhaleالواجهة التفاعلية؛ ويشغّلcodewhale execمهمة من برنامج نصي أو مهمة CI. - المتصفح المحلي: يفتح
codewhale webعميل الويب المحلي المرفق، والمتصل ببيئة التشغيل نفسها. - تطبيقات Codewhale للويب وسطح المكتب: بيئات عمل رسومية قيد التطوير. تُدرج معلومات توفرها في صفحة المنتج.
يضيف Computer Use أدوات لمراقبة التطبيقات الأخرى والتفاعل معها. الإضافة مضمنة في الشيفرة المصدرية الحالية. راجع صلاحيات الوصول التي تطلبها وفعّلها قبل الاستخدام؛ وتظل أذونات نظام التشغيل ومتطلبات المنصة سارية. راجع دليل Computer Use المرفق وإعداد الإضافات.
يتصل امتداد CodeWhale لبرنامج VS Code، الذي يصونه المجتمع، ببيئة Runtime المحلية من الشريط الجانبي. ثبّته من سوق VS Code؛ والشيفرة المصدرية على GitHub.
- اختر نماذجك. اتصل بموفّرين مستضافين أو بنماذج محلية عبر Ollama أو vLLM أو SGLang. استخدم
/providerلتغيير الموفّر و/modelلاختيار نموذج. - ابقَ مسيطرًا. افحص الإجراءات المقترحة والتغييرات الناتجة في الملفات. تحدد إعدادات الموافقة متى تلزم المراجعة؛ ويظل Full Access ملتزمًا بالحدود الصارمة للسياسات. يساعدك
/undoو/restoreعلى استعادة مساحة العمل بعد التغييرات. - حافظ على تنظيم الأعمال الطويلة. احفظ الجلسات، وحدد
/goalدائمًا، وراجع مسارات العمل قبل تشغيلها، ونسّق بين الوكلاء من دون تحويل تعليماتهم الداخلية إلى جزء من محادثتك. - وسّع الوكيل الذي لديك بالفعل. صِل خوادم MCP والمهارات، واضبط الخطافات، واحتفظ بأدوار الوكلاء كملفات مقروءة في مشروعك أو إعداداتك الشخصية.
شغّل /help في واجهة TUI لعرض الأوامر واختصارات لوحة المفاتيح.
يعمل Codewhale على جهازك بصلاحيات الوصول التي تمنحها له. تحد أوضاع الموافقة وقواعد المستودع مما يمكن للوكيل فعله؛ ويضيف عزل نظام التشغيل الاختياري حدًا أقوى للتنفيذ حيثما كان مدعومًا. تظل أسعار النماذج غير المعروفة مسجلة على أنها غير معروفة بدلًا من الإبلاغ عنها كمجانية.
اقرأ ترتيب التفويض لمعرفة التسلسل الدقيق للسياسات، والإعدادات لمعرفة الضبط المحلي.
- الموفّرون والنماذج المحلية
- فرق الوكلاء
- MCP والخطافات والإعدادات
- عميل الويب المحلي
- جميع الوثائق
- بنية المستودع ودليل المساهمة
نرحب بتقارير الأخطاء وأفكار الميزات وطلبات السحب، سواء كنت تستخدم Codewhale منذ أشهر أو تجربه للمرة الأولى. إذا كان أحد الموفّرين غير متاح، أو كان مسار العمل غير مريح، أو كانت واجهة الطرفية تعيقك، فافتح issue أو أرسل pull request لنحسّنه معًا. نرحب بالمساهمات الأولى، ويظل كل مساهم منسوبًا إلى العمل الذي يُدمج في المشروع.
انضم إلى Discord، أو أضف Hunter على WeChat (hunterbown) واطلب الانضمام إلى مجموعة Whale Brothers.
بدأ Codewhale باسم deepseek-tui، ولا يزال يحافظ على التوافق مع إعداداته وجلساته. وهو الآن محايد تجاه الموفّرين ويُصان بصورة مستقلة ولا ينتمي إلى أي موفّر نماذج.
شكرًا لكل مساهم ولمجتمعات المصادر المفتوحة التي ساعدت المشروع على النمو. راجع سجل المساهمين.
MIT. الأجزاء المقتبسة والمعدّلة من مشاريع أخرى مفتوحة المصدر مسجّلة في إشعارات الجهات الخارجية.