README.ar.md - CodeWhale

README.ar.md

1	<!-- source: README.md sha256:604da19bff2c -->
2	<div align="center">
3
4	<picture>
5	<source media="(prefers-color-scheme: dark)" srcset="brand/wordmark-inverted.svg">
6	<img src="brand/wordmark.svg" alt="Codewhale" width="320">
7	</picture>
8
9	وكيل البرمجة مفتوح المصدر الذي يعمل مع أي نموذج.
10
11	يقرأ Codewhale مشروعك ويعدّل الملفات ويشغّل الأوامر ويتحقق من عمله بنفسه — في طرفيتك،
12	باستخدام نموذج مستضاف أو محلي تختاره.
13
14	[![CI](https://github.com/codewhale-hq/CodeWhale/actions/workflows/ci.yml/badge.svg)](https://github.com/codewhale-hq/CodeWhale/actions/workflows/ci.yml)
15	[![crates.io](https://img.shields.io/crates/v/codewhale-cli?label=crates.io)](https://crates.io/crates/codewhale-cli)
16	[![npm](https://img.shields.io/npm/v/codewhale?label=npm)](https://www.npmjs.com/package/codewhale)
17	[![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
18	[![Discord](https://img.shields.io/badge/Discord-join-5865F2?logo=discord&logoColor=white)](https://discord.gg/37gfS3ksug)
19
20	[الموقع](https://codewhale.net) · [التوثيق](docs/README.md) · [سجل التغييرات](CHANGELOG.md) · [المساهمة](CONTRIBUTING.md)
21
22	[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)
23
24	<img src="web/public/codewhale-tui-8ba2bbf.png" alt="جلسة Codewhale في الطرفية" width="760">
25
26	<sub>لقطة حقيقية للطرفية من تثبيت جديد — دون مخرجات مُعدّة مسبقًا.</sub>
27
28	</div>
29
30	## التثبيت
31
32	macOS وLinux:
33
34	```bash
35	curl -fsSL https://codewhale.net/install.sh \| sh
36	```
37
38	ينزّل المثبّت ملفات ثنائية متحقَّقًا من مجموع اختبارها إلى `~/.local/bin`. إذا ظهرت
39	بعد ذلك رسالة "command not found" عند تشغيل `codewhale`، فشغّل سطر PATH الواحد الذي
40	يطبعه المثبّت، أو راجع [إضافته إلى PATH](docs/INSTALL.md#put-it-on-your-path).
41	يمكنك الترقية في أي وقت بالأمر `codewhale update`.
42
43	<details>
44	<summary><b>Windows وnpm وCargo وطرق أخرى</b></summary>
45
46	```bash
47	winget install HunterBown.CodeWhale # Windows x64 (or Scoop, or the installer from GitHub Releases)
48	npm install -g codewhale # wraps the same release binaries
49	cargo install codewhale-cli --locked # build from crates.io
50	```
51
52	تغطي [دليل التثبيت](docs/INSTALL.md) طرق Docker وNix وHomebrew على Linux
53	وAndroid/Termux والتنزيل اليدوي مع التحقق من مجموع الاختبار ومرآة CNB الاختيارية.
54	اختر طريقة واحدة: تتنازع عدة عمليات تثبيت على جهاز واحد على `PATH`.
55
56	</details>
57
58	## البدء السريع
59
60	1. افتح مشروعك. شغّل `codewhale` في المجلد الذي تريد العمل عليه.
61	2. اربط نموذجًا. شغّل `/provider` (أو اضغط `F3`) لإضافة مفتاح مستضاف أو اختيار
62	بيئة تشغيل محلية. إذا كان Ollama يعمل بالفعل مع نموذج محادثة، ينتقل Codewhale إليه
63	من تلقاء نفسه. استخدم `/model` لتغيير النموذج.
64	3. أعطه مهمة محددة.
65
66	```text
67	Fix the failing tests and explain what changed.
68	```
69
70	تعمل المهمة نفسها دون واجهة من سكربت أو من مهمة CI:
71
72	```bash
73	codewhale exec "fix the failing tests and explain what changed"
74	```
75
76	شغّل `/help` لعرض الأوامر واختصارات لوحة المفاتيح.
77
78	## طرق التشغيل
79
80	يتعامل كل عميل مع Codewhale Runtime المحلي نفسه، لذا تتصرف الجلسات والأدوات
81	والأذونات بالطريقة نفسها في كل مكان.
82
83	\| الأمر \| ما يفعله \|
84	\| --- \| --- \|
85	\| `codewhale` \| واجهة الطرفية التفاعلية \|
86	\| `codewhale exec "…"` \| دورة واحدة دون واجهة من سكربت أو CI، مع بث JSON \|
87	\| `codewhale web` \| [عميل المتصفح المحلي](docs/WEB.md) المضمَّن على `127.0.0.1` \|
88	\| `codewhale review --pr N` \| [مراجعة pull request](docs/GITHUB_ACTION.md) استشارية؛ والنشر اختياري \|
89	\| Runtime API \| [واجهة HTTP محلية](docs/RUNTIME_API.md) للخيوط والأحداث والموافقات \|
90
91	يجري تطوير تطبيق سطح مكتب أصلي (GPUI) ليكون عميل المنتج المسجَّل الدخول؛ راجع
92	[صفحة المنتج](https://codewhale.net/en/product) لمعرفة حالة الإتاحة. ويتصل
93	[امتداد VS Code](https://marketplace.visualstudio.com/items?itemName=HengQuWorld.brotherwhale-vscode)
94	الذي يصونه المجتمع بـ Runtime نفسه من شريط جانبي ([المصدر](https://github.com/HengQuWorld/CodeWhale-VSCode)).
95
96	## ما الذي يفعله
97
98	- أي نموذج دون ارتهان. أكثر من 40 مسار مزوّد مدمجًا — Anthropic وDeepSeek
99	وGoogle وMistral وMoonshot وOpenAI وOpenRouter وxAI وغيرها — إضافة إلى أي نقطة
100	نهاية متوافقة مع OpenAI ونماذج محلية عبر Ollama أو vLLM أو SGLang.
101	[المزوّدون](docs/PROVIDERS.md)
102	- تبقى السيطرة بيدك. يستكشف وضع Plan دون تغيير أي شيء؛ ويُجري Work وOperate
103	تغييرات. تحدد أوضاع الموافقة متى يحتاج استدعاء الأداة إلى موافقتك، ويستعيد `/undo`
104	و`/restore` تغييرات مساحة العمل، ويسرد `/receipts` كل ملف وأمر وموافقة في الجلسة.
105	[الأوضاع](docs/MODES.md) · [الإيصالات](docs/RECEIPTS.md)
106	- مصمَّم للأعمال الطويلة. حدّد `/goal` دائمًا، وفوّض الأعمال المحدودة إلى
107	[الوكلاء الفرعيين](docs/SUBAGENTS.md)، وشغّل [فرق وكلاء](docs/FLEET.md) خاضعة
108	للإشراف مع فحص قبل الإنفاق، أو اكتبها كسكربتات في
109	[سير عمل](docs/WORKFLOW_AUTHORING.md) مضمَّنة في المستودع.
110	- وسّع ما تستخدمه أصلًا. اربط [خوادم MCP](docs/MCP.md)، وثبّت
111	[المهارات](docs/SKILLS.md) و[الإضافات](docs/PLUGINS.md)، وشغّل
112	[الخطافات](docs/HOOKS.md) عند أحداث الجلسة والأدوات، وحمّل
113	[إضافات Claude Code](docs/CLAUDE_PLUGIN_COMPAT.md) الموجودة.
114	- Computer Use. تضيف إضافة مضمَّنة أدوات لمراقبة التطبيقات الأخرى وتشغيلها.
115	راجع صلاحيات وصولها وفعّلها قبل الاستخدام.
116	[الدليل](crates/tui/plugins/computer-use/README.md)
117
118	## الأوضاع والأذونات
119
120	\| \| طريقة الاختيار \| الخيارات \|
121	\| --- \| --- \| --- \|
122	\| Mode — ما يفعله الوكيل \| `Tab` أو `/mode` \| Plan (استكشاف دون تغييرات) · Work (تعديل وتشغيل) · Operate (قيادة هدف عبر خطوات مخططة ومتحقق منها) \|
123	\| Posture — متى يسأل أولًا \| `Shift+Tab` \| Ask · Auto-Review · Full Access \|
124
125	يلتزم Full Access أيضًا بحدود السياسة الصارمة.
126	يشرح [دليل الأوضاع والأذونات](docs/MODES.md) كل خيار.
127
128	## الأمان
129
130	يعمل Codewhale على جهازك بالصلاحيات التي تمنحها له. تحدّ أوضاع الموافقة وقواعد
131	المستودع مما يجوز للوكيل فعله، وتعمل الأوامر داخل صندوق حماية لنظام التشغيل حيثما
132	كان مدعومًا (Seatbelt على macOS؛ وbubblewrap على Linux اختياري). يعرض
133	`/preview-request` الطلب المحجوب بياناته الحساسة (redacted) كما هو تمامًا قبل إرسال أي شيء.
134	تبقى أسعار النماذج غير المعروفة غير معروفة بدل أن تُعرض على أنها مجانية.
135
136	راجع [ترتيب التفويض](docs/AUTHORIZATION_ORDER.md) و[صندوق الحماية](docs/SANDBOX.md)
137	و[القياس عن بُعد](docs/TELEMETRY.md) — أعداد الاستخدام مفعّلة افتراضيًا، ويوقفها
138	الأمر `codewhale config set telemetry false`.
139
140	## التوثيق
141
142	\| ابدأ من هنا \| تعمّق أكثر \|
143	\| --- \| --- \|
144	\| [التثبيت](docs/INSTALL.md) \| [الإعدادات](docs/CONFIGURATION.md) \|
145	\| [المزوّدون والنماذج المحلية](docs/PROVIDERS.md) \| [البنية](docs/ARCHITECTURE.md) \|
146	\| [الأوضاع والأذونات](docs/MODES.md) \| [Runtime API](docs/RUNTIME_API.md) \|
147	\| [اختصارات لوحة المفاتيح](docs/KEYBINDINGS.md) \| [تأليف الإضافات](docs/PLUGIN_AUTHORING.md) \|
148	\| [مراجعة PR على GitHub](docs/GITHUB_ACTION.md) \| [كل التوثيق](docs/README.md) \|
149
150	## المجتمع
151
152	نرحّب ببلاغات الأخطاء وأفكار الميزات وطلبات pull request — سواء كنت تستخدم
153	Codewhale منذ أشهر أو تجربه للمرة الأولى. إذا كان هناك مزوّد مفقود أو سير عمل
154	غير مريح، فـ[افتح issue](https://github.com/codewhale-hq/CodeWhale/issues/new/choose)
155	أو [أرسل pull request](CONTRIBUTING.md). المساهمات الأولى مرحَّب بها، ويحتفظ
156	المساهمون بفضل العمل الذي يُقبل. و[بنية المستودع](CONTRIBUTING.md#project-structure)
157	مكان جيد للبدء.
158
159	انضم إلى [Discord](https://discord.gg/37gfS3ksug)، أو أضف Hunter على WeChat
160	(`hunterbown`) واطلب الانضمام إلى مجموعة Whale Brothers.
161
162	## التاريخ والترخيص
163
164	بدأ Codewhale باسم `deepseek-tui` ولا يزال يقرأ إعدادات ذلك المشروع وجلساته. وهو
165	الآن محايد تجاه المزوّدين ويُصان باستقلال، وغير تابع لأي مزوّد نماذج. شكرًا
166	لـ[كل المساهمين](docs/CONTRIBUTORS.md) ولمجتمعات المصادر المفتوحة التي ساعدت في نموه.
167
168	[MIT](LICENSE). الأجزاء المقتبسة من مشاريع مفتوحة المصدر أخرى مسجَّلة في
169	[إشعارات الأطراف الثالثة](docs/THIRD_PARTY_NOTICES.md).
170

170 lines MARKDOWN