مقدمة

ابدأ باستخدام AicippY.

AicippY هو وكيل ترميز بالذكاء الاصطناعي مفتوح المصدر. يتوفر كواجهة terminal، وتطبيق لسطح المكتب، أو إضافة لبيئة تطوير متكاملة (IDE).

واجهة AicippY في terminal مع سمة aicippy-code

لنبدأ.

المتطلبات

لاستخدام AicippY في terminal، ستحتاج إلى:

محاكي terminal حديث مثل:
- WezTerm متعدد المنصات
- Alacritty متعدد المنصات
- Ghostty على Linux وmacOS
- Kitty على Linux وmacOS
مفاتيح API لمزوّدي نماذج اللغة (LLM) الذين تريد استخدامهم.

التثبيت

أسهل طريقة لتثبيت AicippY هي عبر سكربت التثبيت.

curl -fsSL https://code.aicippy.com/install | bash

يمكنك أيضا تثبيته عبر الأوامر التالية:

باستخدام Node.js
- npm
- Bun
- pnpm
- Yarn
Terminal window
npm install -g aicippy-code
Terminal window
bun install -g aicippy-code
Terminal window
pnpm install -g aicippy-code
Terminal window
yarn global add aicippy-code
باستخدام Homebrew على macOS وLinux
Terminal window
```
bun run --cwd packages/aicippy-code script/build.ts --install
```
نوصي باستخدام tap الخاص بـ AicippY للحصول على أحدث الإصدارات. صيغة brew install aicippy-code الرسمية تُدار بواسطة فريق Homebrew ويتم تحديثها بوتيرة أقل.

باستخدام Paru على Arch Linux

sudo pacman -S aicippy-code           # Arch Linux (Stable)
paru -S aicippy-code-bin              # Arch Linux (Latest from AUR)

Windows

باستخدام Chocolatey
Terminal window
```
choco install aicippy-code
```
باستخدام Scoop
Terminal window
```
scoop install aicippy-code
```
باستخدام NPM
Terminal window
```
npm install -g aicippy-code
```

باستخدام Mise

mise use -g github:ajaitech/aicippy-code

باستخدام Docker

docker run -it --rm ghcr.io/aivibe/aicippy-code

دعم تثبيت AicippY على Windows باستخدام Bun قيد العمل حاليا.

يمكنك أيضا تنزيل الملف التنفيذي من صفحة Releases.

الإعداد

مع AicippY يمكنك استخدام أي مزود LLM عبر إعداد مفاتيح API الخاصة به.

إذا كنت جديدا على استخدام مزوّدي LLM، فنوصي باستخدام AicippY Zen. إنها قائمة منتقاة من النماذج تم اختبارها والتحقق منها بواسطة فريق AicippY.

شغّل الأمر /connect في واجهة TUI، واختر aicippy-code، ثم انتقل إلى code.aicippy.com/auth.
```
/connect
```
سجّل الدخول، وأضف تفاصيل الدفع، ثم انسخ مفتاح API.
الصق مفتاح API.
```
┌ API key
│
│
└ enter
```

بدلا من ذلك يمكنك اختيار أحد المزوّدين الآخرين. اعرف المزيد.

التهيئة

بعد أن قمت بإعداد مزوّد، يمكنك الانتقال إلى المشروع الذي تريد العمل عليه.

cd /path/to/project

ثم شغّل AicippY.

aicippy-code

بعد ذلك، هيّئ AicippY للمشروع عبر تشغيل الأمر التالي.

/init

سيجعل هذا AicippY يحلل مشروعك ويُنشئ ملف AGENTS.md في جذر المشروع.

يساعد هذا AicippY على فهم بنية المشروع وأنماط الترميز المستخدمة.

الاستخدام

أصبحت الآن جاهزا لاستخدام AicippY للعمل على مشروعك. لا تتردد في سؤاله أي شيء!

إذا كنت جديدا على استخدام وكيل ترميز بالذكاء الاصطناعي، فإليك بعض الأمثلة التي قد تساعد.

اطرح أسئلة

يمكنك أن تطلب من AicippY شرح قاعدة الشيفرة لك.

How is authentication handled in @packages/functions/src/api/index.ts

يفيد هذا عندما تكون هناك أجزاء من قاعدة الشيفرة لم تعمل عليها.

أضف ميزات

يمكنك أن تطلب من AicippY إضافة ميزات جديدة إلى مشروعك، لكننا نوصي أولا بطلب إنشاء خطة.

أنشئ خطة

لدى AicippY وضع Plan يعطل قدرته على إجراء التغييرات، ويقترح بدلا من ذلك كيف سينفّذ الميزة.

انتقل إليه باستخدام مفتاح Tab. سترى مؤشرا لذلك في الزاوية السفلية اليمنى.
```
<TAB>
```
الآن لنصف ما نريده أن يفعله.
```
When a user deletes a note, we'd like to flag it as deleted in the database.
Then create a screen that shows all the recently deleted notes.
From this screen, the user can undelete a note or permanently delete it.
```
احرص على تزويد AicippY بتفاصيل كافية ليفهم ما تريد. يساعد أن تتحدث إليه كما لو كنت تتحدث إلى مطور مبتدئ ضمن فريقك.

أعطِ AicippY سياقا وأمثلة كافية لمساعدته على فهم ما تريد.
حسّن الخطة

بعد أن يقدم لك خطة، يمكنك إعطاؤه ملاحظات أو إضافة تفاصيل أكثر.
```
We'd like to design this new screen using a design I've used before.
[Image #1] Take a look at this image and use it as a reference.
```
اسحب الصور وأفلِتها داخل terminal لإضافتها إلى الطلب.

يستطيع AicippY فحص أي صور تزوده بها وإضافتها إلى الطلب. يمكنك فعل ذلك عبر سحب الصورة وإفلاتها داخل terminal.
ابنِ الميزة

عندما تشعر بالارتياح للخطة، عد إلى وضع Build بالضغط على مفتاح Tab مرة أخرى.
```
<TAB>
```
ثم اطلب منه تنفيذ التغييرات.
```
Sounds good! Go ahead and make the changes.
```

نفّذ تغييرات

للتغييرات الأبسط، يمكنك أن تطلب من AicippY تنفيذها مباشرة دون الحاجة لمراجعة خطة أولا.

We need to add authentication to the /settings route. Take a look at how this is
handled in the /notes route in @packages/functions/src/notes.ts and implement
the same logic in @packages/functions/src/settings.ts

تأكد من تقديم قدر مناسب من التفاصيل لكي يجري AicippY التغييرات الصحيحة.

تراجع عن التغييرات

لنفترض أنك طلبت من AicippY إجراء بعض التغييرات.

Can you refactor the function in @packages/functions/src/api/index.ts?

لكن تتضح لك لاحقا أنها ليست ما تريده. يمكنك التراجع عن التغييرات باستخدام الأمر /undo.

/undo

سيقوم AicippY الآن بعكس التغييرات التي أُجريت ويعرض رسالتك الأصلية مجددا.

Can you refactor the function in @packages/functions/src/api/index.ts?

من هنا يمكنك تعديل الطلب وطلب المحاولة مرة أخرى.

أو يمكنك إعادة تنفيذ التغييرات باستخدام الأمر /redo.

/redo

المشاركة

يمكن مشاركة المحادثات التي تجريها مع AicippY مع فريقك.

/share

سيقوم هذا بإنشاء رابط للمحادثة الحالية ونسخه إلى الحافظة.

إليك مثالا لمحادثة مع AicippY.

التخصيص

وهذا كل شيء! أصبحت الآن محترفا في استخدام AicippY.

لتجعله مناسبا لك، نوصي بـ اختيار سمة، وتخصيص اختصارات لوحة المفاتيح، وإعداد منسقات الشيفرة، وإنشاء أوامر مخصصة، أو التجربة مع إعدادات AicippY.