mirror of
https://github.com/anomalyco/opencode.git
synced 2026-02-01 22:48:16 +00:00
134 lines
6.7 KiB
Markdown
134 lines
6.7 KiB
Markdown
<p align="center">
|
|
<a href="https://opencode.ai">
|
|
<picture>
|
|
<source srcset="packages/console/app/src/asset/logo-ornate-dark.svg" media="(prefers-color-scheme: dark)">
|
|
<source srcset="packages/console/app/src/asset/logo-ornate-light.svg" media="(prefers-color-scheme: light)">
|
|
<img src="packages/console/app/src/asset/logo-ornate-light.svg" alt="شعار OpenCode">
|
|
</picture>
|
|
</a>
|
|
</p>
|
|
<p align="center">وكيل برمجة بالذكاء الاصطناعي مفتوح المصدر.</p>
|
|
<p align="center">
|
|
<a href="https://opencode.ai/discord"><img alt="Discord" src="https://img.shields.io/discord/1391832426048651334?style=flat-square&label=discord" /></a>
|
|
<a href="https://www.npmjs.com/package/opencode-ai"><img alt="npm" src="https://img.shields.io/npm/v/opencode-ai?style=flat-square" /></a>
|
|
<a href="https://github.com/anomalyco/opencode/actions/workflows/publish.yml"><img alt="Build status" src="https://img.shields.io/github/actions/workflow/status/anomalyco/opencode/publish.yml?style=flat-square&branch=dev" /></a>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<a href="README.md">English</a> |
|
|
<a href="README.zh.md">简体中文</a> |
|
|
<a href="README.zht.md">繁體中文</a> |
|
|
<a href="README.ko.md">한국어</a> |
|
|
<a href="README.de.md">Deutsch</a> |
|
|
<a href="README.es.md">Español</a> |
|
|
<a href="README.fr.md">Français</a> |
|
|
<a href="README.it.md">Italiano</a> |
|
|
<a href="README.da.md">Dansk</a> |
|
|
<a href="README.ja.md">日本語</a> |
|
|
<a href="README.pl.md">Polski</a> |
|
|
<a href="README.ru.md">Русский</a> |
|
|
<a href="README.ar.md">العربية</a> |
|
|
<a href="README.no.md">Norsk</a> |
|
|
<a href="README.br.md">Português (Brasil)</a>
|
|
</p>
|
|
|
|
[](https://opencode.ai)
|
|
|
|
---
|
|
|
|
### التثبيت
|
|
|
|
```bash
|
|
# YOLO
|
|
curl -fsSL https://opencode.ai/install | bash
|
|
|
|
# مديري الحزم
|
|
npm i -g opencode-ai@latest # او bun/pnpm/yarn
|
|
scoop install opencode # Windows
|
|
choco install opencode # Windows
|
|
brew install anomalyco/tap/opencode # macOS و Linux (موصى به، دائما محدث)
|
|
brew install opencode # macOS و Linux (صيغة brew الرسمية، تحديث اقل)
|
|
paru -S opencode-bin # Arch Linux
|
|
mise use -g opencode # اي نظام
|
|
nix run nixpkgs#opencode # او github:anomalyco/opencode لاحدث فرع dev
|
|
```
|
|
|
|
> [!TIP]
|
|
> احذف الاصدارات الاقدم من 0.1.x قبل التثبيت.
|
|
|
|
### تطبيق سطح المكتب (BETA)
|
|
|
|
يتوفر OpenCode ايضا كتطبيق سطح مكتب. قم بالتنزيل مباشرة من [صفحة الاصدارات](https://github.com/anomalyco/opencode/releases) او من [opencode.ai/download](https://opencode.ai/download).
|
|
|
|
| المنصة | التنزيل |
|
|
| --------------------- | ------------------------------------- |
|
|
| macOS (Apple Silicon) | `opencode-desktop-darwin-aarch64.dmg` |
|
|
| macOS (Intel) | `opencode-desktop-darwin-x64.dmg` |
|
|
| Windows | `opencode-desktop-windows-x64.exe` |
|
|
| Linux | `.deb` او `.rpm` او AppImage |
|
|
|
|
```bash
|
|
# macOS (Homebrew)
|
|
brew install --cask opencode-desktop
|
|
# Windows (Scoop)
|
|
scoop bucket add extras; scoop install extras/opencode-desktop
|
|
```
|
|
|
|
#### مجلد التثبيت
|
|
|
|
يحترم سكربت التثبيت ترتيب الاولوية التالي لمسار التثبيت:
|
|
|
|
1. `$OPENCODE_INSTALL_DIR` - مجلد تثبيت مخصص
|
|
2. `$XDG_BIN_DIR` - مسار متوافق مع مواصفات XDG Base Directory
|
|
3. `$HOME/bin` - مجلد الثنائيات القياسي للمستخدم (ان وجد او امكن انشاؤه)
|
|
4. `$HOME/.opencode/bin` - المسار الافتراضي الاحتياطي
|
|
|
|
```bash
|
|
# امثلة
|
|
OPENCODE_INSTALL_DIR=/usr/local/bin curl -fsSL https://opencode.ai/install | bash
|
|
XDG_BIN_DIR=$HOME/.local/bin curl -fsSL https://opencode.ai/install | bash
|
|
```
|
|
|
|
### Agents
|
|
|
|
يتضمن OpenCode وكيليْن (Agents) مدمجين يمكنك التبديل بينهما باستخدام زر `Tab`.
|
|
|
|
- **build** - الافتراضي، وكيل بصلاحيات كاملة لاعمال التطوير
|
|
- **plan** - وكيل للقراءة فقط للتحليل واستكشاف الكود
|
|
- يرفض تعديل الملفات افتراضيا
|
|
- يطلب الاذن قبل تشغيل اوامر bash
|
|
- مثالي لاستكشاف قواعد كود غير مألوفة او لتخطيط التغييرات
|
|
|
|
بالاضافة الى ذلك يوجد وكيل فرعي **general** للبحث المعقد والمهام متعددة الخطوات.
|
|
يستخدم داخليا ويمكن استدعاؤه بكتابة `@general` في الرسائل.
|
|
|
|
تعرف على المزيد حول [agents](https://opencode.ai/docs/agents).
|
|
|
|
### التوثيق
|
|
|
|
لمزيد من المعلومات حول كيفية ضبط OpenCode، [**راجع التوثيق**](https://opencode.ai/docs).
|
|
|
|
### المساهمة
|
|
|
|
اذا كنت مهتما بالمساهمة في OpenCode، يرجى قراءة [contributing docs](./CONTRIBUTING.md) قبل ارسال pull request.
|
|
|
|
### البناء فوق OpenCode
|
|
|
|
اذا كنت تعمل على مشروع مرتبط بـ OpenCode ويستخدم "opencode" كجزء من اسمه (مثل "opencode-dashboard" او "opencode-mobile")، يرجى اضافة ملاحظة في README توضح انه ليس مبنيا بواسطة فريق OpenCode ولا يرتبط بنا بأي شكل.
|
|
|
|
### FAQ
|
|
|
|
#### ما الفرق عن Claude Code؟
|
|
|
|
هو مشابه جدا لـ Claude Code من حيث القدرات. هذه هي الفروقات الاساسية:
|
|
|
|
- 100% مفتوح المصدر
|
|
- غير مقترن بمزود معين. نوصي بالنماذج التي نوفرها عبر [OpenCode Zen](https://opencode.ai/zen)؛ لكن يمكن استخدام OpenCode مع Claude او OpenAI او Google او حتى نماذج محلية. مع تطور النماذج ستتقلص الفجوات وستنخفض الاسعار، لذا من المهم ان يكون مستقلا عن المزود.
|
|
- دعم LSP جاهز للاستخدام
|
|
- تركيز على TUI. تم بناء OpenCode بواسطة مستخدمي neovim ومنشئي [terminal.shop](https://terminal.shop)؛ وسندفع حدود ما هو ممكن داخل الطرفية.
|
|
- معمارية عميل/خادم. على سبيل المثال، يمكن تشغيل OpenCode على جهازك بينما تقوده عن بعد من تطبيق جوال. هذا يعني ان واجهة TUI هي واحدة فقط من العملاء الممكنين.
|
|
|
|
---
|
|
|
|
**انضم الى مجتمعنا** [Discord](https://discord.gg/opencode) | [X.com](https://x.com/opencode)
|