| 1 | <!-- source: README.md sha256:ebf1c69de0dc --> |
| 2 | # Codewhale |
| 3 | |
| 4 | Codewhale وكيل مفتوح المصدر يقرأ مشروعك ويعدّل الملفات ويشغّل الأوامر ويتحقق من عمله باستخدام نموذج مستضاف أو محلي تختاره. ابدأ بمهمة واحدة في الطرفية. وللأعمال الأكبر، وزّع أجزاء العمل على وكلاء بنماذج وأدوار مختلفة. |
| 5 | |
| 6 |  |
| 7 | |
| 8 | *معاينة للطرفية من بنية تطوير للإصدار v0.9.12.* |
| 9 | |
| 10 | [English](README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja-JP.md) · [Tiếng Việt](README.vi.md) · [Bahasa Indonesia](README.id.md) · [한국어](README.ko-KR.md) · [Español](README.es-419.md) · [Português](README.pt-BR.md) · [Русский](README.ru.md) · [Українська](README.uk.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [繁體中文](README.zh-TW.md) · [हिन्दी](README.hi.md) · [Türkçe](README.tr.md) · [Italiano](README.it.md) · [Polski](README.pl.md) · [Català](README.ca.md) |
| 11 | |
| 12 | [](https://github.com/Hmbown/CodeWhale/actions/workflows/ci.yml) |
| 13 | [](https://crates.io/crates/codewhale-cli) |
| 14 | [](https://www.npmjs.com/package/codewhale) |
| 15 | [](https://discord.gg/37gfS3ksug) |
| 16 | |
| 17 | ## التثبيت |
| 18 | |
| 19 | للتثبيت الجديد على macOS أو Linux، استخدم الإصدار الرسمي من GitHub: |
| 20 | |
| 21 | ```bash |
| 22 | curl -fsSL https://codewhale.net/install.sh | sh |
| 23 | "$HOME/.local/bin/codewhale" |
| 24 | ``` |
| 25 | |
| 26 | يختار المثبّت أحدث إصدار منشور. ويصف [سجل التغييرات](CHANGELOG.md) أيضًا النسخة المرشحة غير المنشورة للإصدار التالي؛ ولا تُضمّن هذه التغييرات في التنزيلات المنشورة حتى يصبح الإصدار متاحًا. |
| 27 | |
| 28 | على Windows، نزّل المثبّت أو الأرشيف المناسب من [GitHub Releases](https://github.com/Hmbown/CodeWhale/releases/latest). لتحديث تثبيت مباشر موجود، شغّل `codewhale update`، أو `codewhale update --check` للفحص فقط. يعرض المحدّث مسار الملف التنفيذي ويحتفظ بالبنيات الأحدث. npm وCargo خياران ثانويان؛ راجع [دليل التثبيت](docs/INSTALL.md) للانتقال من تثبيت يديره مدير حزم وإعداد PATH. |
| 29 | |
| 30 | يساعدك Codewhale عند التشغيل الأول على الاتصال بموفّر أو إعداد Codewhale دون اتصال. تتطلب ردود النموذج الاتصال بنموذج مستضاف أو محلي. ويدعم Codewhale أيضًا npm وCargo كخياري تحزيم ثانويين، إلى جانب Docker وNix وScoop وAndroid/Termux ومرآة CNB اختيارية. تتوفر تعليمات انتقال للتثبيتات الحالية التي يديرها مدير حزم. راجع [المساعدة بشأن التثبيت وPATH](docs/INSTALL.md). |
| 31 | |
| 32 | يمكن تفعيل الإكمال بمفتاح Tab بأمر واحد لكل واجهة أوامر — `codewhale completion bash|zsh|fish|powershell|elvish`. راجع [إكمال واجهة الأوامر](docs/INSTALL.md#8-shell-completions). |
| 33 | |
| 34 | ## الاستخدام |
| 35 | |
| 36 | افتح طرفية في مجلد مشروعك وشغّل `codewhale`. اختر موفّرك باستخدام `/provider` ونموذجك باستخدام `/model`. ثم صِف مهمة محددة: |
| 37 | |
| 38 | ```text |
| 39 | Fix the failing tests and explain what changed. |
| 40 | ``` |
| 41 | |
| 42 | أو شغّل مهمة من دون فتح واجهة TUI: |
| 43 | |
| 44 | ```bash |
| 45 | codewhale exec "fix the failing tests and explain what changed" |
| 46 | ``` |
| 47 | |
| 48 | يستطيع Codewhale قراءة مستودعك وتعديل الملفات وتشغيل الأوامر وفحص النتائج ومواصلة العمل نحو هدف. استخدم `/mode plan` للاستكشاف دون تغيير الملفات أو تنفيذ أوامر واجهة الأوامر، و`/mode work` عندما تريد إجراء تغييرات. اضغط `Shift+Tab` لاختيار Ask أو Auto-Review أو Full Access؛ يوضح [دليل الأوضاع والصلاحيات](docs/MODES.md) ما يسمح به كل خيار. |
| 49 | |
| 50 | ## الطرفية والتطبيقات وComputer Use |
| 51 | |
| 52 | تتصل الطرفية والعملاء الرسوميون ببيئة Codewhale Runtime، التي تشغّل الوكيل وأدواته: |
| 53 | |
| 54 | - **الطرفية:** يفتح `codewhale` الواجهة التفاعلية؛ ويشغّل `codewhale exec` مهمة من برنامج نصي أو مهمة CI. |
| 55 | - **المتصفح المحلي:** يفتح `codewhale web` [عميل الويب المحلي](docs/WEB.md) المرفق، والمتصل ببيئة التشغيل نفسها. |
| 56 | - **تطبيق Codewhale لسطح المكتب (GPUI):** تطبيق سطح المكتب الأصلي GPUI هو اتجاه عميل المنتج (قرار بتاريخ 2026-09-14؛ خريطة المراحل في docs/TRANSITION.md ضمن المستودع الخاص codehwhale-gpui). يتوقف تطبيق الويب المستضاف على app.codewhale.net على مراحل؛ ويبقى موقع التسويق وتسجيل الدخول والفوترة والصفحات القانونية وصفحات التنزيل على الويب بشكل دائم. تُدرج معلومات توفره في [صفحة المنتج](https://codewhale.net/en/product). |
| 57 | |
| 58 | **يضيف Computer Use أدوات لمراقبة التطبيقات الأخرى والتفاعل معها.** الإضافة مضمنة في الشيفرة المصدرية الحالية. راجع صلاحيات الوصول التي تطلبها وفعّلها قبل الاستخدام؛ وتظل أذونات نظام التشغيل ومتطلبات المنصة سارية. راجع [دليل Computer Use](crates/tui/plugins/computer-use/README.md) المرفق و[إعداد الإضافات](docs/PLUGINS.md). |
| 59 | |
| 60 | يتصل امتداد CodeWhale لبرنامج VS Code، الذي يصونه المجتمع، ببيئة Runtime المحلية من الشريط الجانبي. ثبّته من [سوق VS Code](https://marketplace.visualstudio.com/items?itemName=HengQuWorld.brotherwhale-vscode)؛ والشيفرة المصدرية على [GitHub](https://github.com/HengQuWorld/CodeWhale-VSCode). |
| 61 | |
| 62 | ## لماذا Codewhale |
| 63 | |
| 64 | - **اختر نماذجك.** اتصل بموفّرين مستضافين أو بنماذج محلية عبر Ollama أو vLLM أو SGLang. استخدم `/provider` لتغيير الموفّر و`/model` لاختيار نموذج. |
| 65 | - **ابقَ مسيطرًا.** افحص الإجراءات المقترحة والتغييرات الناتجة في الملفات. تحدد إعدادات الموافقة متى تلزم المراجعة؛ ويظل Full Access ملتزمًا بالحدود الصارمة للسياسات. يساعدك `/undo` و`/restore` على استعادة مساحة العمل بعد التغييرات. |
| 66 | - **حافظ على تنظيم الأعمال الطويلة.** احفظ الجلسات، وحدد `/goal` دائمًا، وراجع مسارات العمل قبل تشغيلها، ونسّق بين الوكلاء من دون تحويل تعليماتهم الداخلية إلى جزء من محادثتك. |
| 67 | - **وسّع الوكيل الذي لديك بالفعل.** صِل خوادم MCP والمهارات، واضبط الخطافات، واحتفظ بأدوار الوكلاء كملفات مقروءة في مشروعك أو إعداداتك الشخصية. |
| 68 | |
| 69 | شغّل `/help` في واجهة TUI لعرض الأوامر واختصارات لوحة المفاتيح. |
| 70 | |
| 71 | ## الأمان |
| 72 | |
| 73 | يعمل Codewhale على جهازك بصلاحيات الوصول التي تمنحها له. تحد أوضاع الموافقة وقواعد المستودع مما يمكن للوكيل فعله؛ ويضيف عزل نظام التشغيل الاختياري حدًا أقوى للتنفيذ حيثما كان مدعومًا. تظل أسعار النماذج غير المعروفة مسجلة على أنها غير معروفة بدلًا من الإبلاغ عنها كمجانية. |
| 74 | |
| 75 | اقرأ [ترتيب التفويض](docs/AUTHORIZATION_ORDER.md) لمعرفة التسلسل الدقيق للسياسات، و[الإعدادات](docs/CONFIGURATION.md) لمعرفة الضبط المحلي. |
| 76 | |
| 77 | ## الوثائق |
| 78 | |
| 79 | - [الموفّرون والنماذج المحلية](docs/PROVIDERS.md) |
| 80 | - [فرق الوكلاء](docs/FLEET.md) |
| 81 | - [MCP](docs/MCP.md) و[الخطافات](docs/HOOKS.md) و[الإعدادات](docs/CONFIGURATION.md) |
| 82 | - [عميل الويب المحلي](docs/WEB.md) |
| 83 | - [جميع الوثائق](docs) |
| 84 | - [بنية المستودع ودليل المساهمة](CONTRIBUTING.md#project-structure) |
| 85 | |
| 86 | ## انضم إلى المجتمع |
| 87 | |
| 88 | **نرحب بتقارير الأخطاء وأفكار الميزات وطلبات السحب**، سواء كنت تستخدم Codewhale منذ أشهر أو تجربه للمرة الأولى. إذا كان أحد الموفّرين غير متاح، أو كان مسار العمل غير مريح، أو كانت واجهة الطرفية تعيقك، [فافتح issue](https://github.com/Hmbown/CodeWhale/issues/new/choose) أو [أرسل pull request](CONTRIBUTING.md) لنحسّنه معًا. نرحب بالمساهمات الأولى، ويظل كل مساهم منسوبًا إلى العمل الذي يُدمج في المشروع. |
| 89 | |
| 90 | انضم إلى [Discord](https://discord.gg/37gfS3ksug)، أو أضف Hunter على WeChat (`hunterbown`) واطلب الانضمام إلى مجموعة Whale Brothers. |
| 91 | |
| 92 | ## تاريخ المشروع |
| 93 | |
| 94 | بدأ Codewhale باسم `deepseek-tui`، ولا يزال يحافظ على التوافق مع إعداداته وجلساته. وهو الآن محايد تجاه الموفّرين ويُصان بصورة مستقلة ولا ينتمي إلى أي موفّر نماذج. |
| 95 | |
| 96 | شكرًا لكل مساهم ولمجتمعات المصادر المفتوحة التي ساعدت المشروع على النمو. راجع [سجل المساهمين](docs/CONTRIBUTORS.md). |
| 97 | |
| 98 | ## الترخيص |
| 99 | |
| 100 | [MIT](LICENSE). الأجزاء المقتبسة والمعدّلة من مشاريع أخرى مفتوحة المصدر مسجّلة في [إشعارات الجهات الخارجية](docs/THIRD_PARTY_NOTICES.md). |
| 101 |