Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
139 changes: 139 additions & 0 deletions README.ar.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,139 @@
<!-- source: README.md sha256:4fc19c5f9596 -->
# Codewhale

وكيل برمجة مفتوح المصدر لطرفيّتك — أحضر نموذجك بنفسك.

بدأ Codewhale تجربة أصلية لـ DeepSeek. ومنذ ذلك الحين نما إلى مشروع تقوده
المجتمع: حزمة برمجة واحدة تناسب مجتمعًا دوليًا متناميًا وتدعم أكبر عدد ممكن من
النماذج والمزوّدين — النماذج المفتوحة أولًا، مستضافة أو محلية، بلا امتياز لأحد
على البقية.

أعطه مزوّدًا ونموذجًا ومهمة. يقرأ شفرتك، يعدّل الملفات، يشغّل الأوامر ويراجع
عمله، ثم يتوقف عندما تكتمل المهمة أو يحتاجك. بدّل النموذج أثناء المهمة بـ
`/model`. اعمل تفاعليًا في TUI، أو شغّل `codewhale exec` في السكربتات وCI.
مكتوب بـ Rust، مرخّص بـ MIT، ويعمل على جهازك.

ما يميّزه عن الحزم الأخرى: **أنت تختار النموذج لكل دور، ولا يلزم أن تتطابق.**
يثبّت الـ fleet مزوّدًا ونموذجًا وطبقة استدلال لكل دور — فيقدر نموذج رخيص سريع
أن يوجّه نموذج استدلال مكلفًا، أو يعمل builder على GLM في المهمة نفسها مع
reviewer على Kimi. اكتب أدوارك ودستور constitution خاصًا بك، فتصبح الحزمة لك لا
لنا.

نبحث دائمًا عن مساهمين وسبل للتحسين. إن غاب نموذج أو مزوّد تستخدمه، أو تعطل
شيء، فإخبارنا من أكثر ما يمكنك فعله نفعًا — انظر [المساهمة](#المساهمة).

[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) · [codewhale.net](https://codewhale.net/) · [Docs](docs) · [Changelog](CHANGELOG.md) · [Discord](https://discord.gg/37gfS3ksug)

[![CI](https://github.com/Hmbown/CodeWhale/actions/workflows/ci.yml/badge.svg)](https://github.com/Hmbown/CodeWhale/actions/workflows/ci.yml)
[![crates.io](https://img.shields.io/crates/v/codewhale-cli?label=crates.io)](https://crates.io/crates/codewhale-cli)
[![npm](https://img.shields.io/npm/v/codewhale?label=npm)](https://www.npmjs.com/package/codewhale)
[![Discord](https://img.shields.io/badge/Discord-join%20the%20community-5865F2?logo=discord&logoColor=white)](https://discord.gg/37gfS3ksug)

![Codewhale يعمل في طرفية](assets/screenshot.png)

## التثبيت

```bash
npm install -g codewhale
```

Cargo وDocker وNix وScoop والأرشيفات المبنية مسبقًا وAndroid/Termux ومرآة CNB
لمن لا يصل إلى GitHub مشروحة في
[docs/INSTALL.md](docs/INSTALL.md). قادم من `deepseek-tui`؟ إعدادك وجلساتك
تنتقل معك — انظر [docs/REBRAND.md](docs/REBRAND.md).

## الاستخدام

```bash
codewhale auth set --provider deepseek # or export ANTHROPIC_API_KEY, etc.
codewhale # open the TUI
codewhale exec "fix the failing test" # headless
codewhale web # local browser client on 127.0.0.1
```

في TUI: `/model` يبدّل المزوّد والنموذج معًا، `/fleet` يبني الفريق ويشغّله —
دور واحد في كل مرة، ولكلٍ نموذجه — و`/undo` يرجع آخر دور، و`/restore <N>` يعيد
مساحة العمل إلى لقطة أقدم (`/restore` وحده يسردها). `Tab` يدور Plan / Work /
Operate عندما يكون المحرّر فارغًا — ومع النص يكمّل أوامر الشرطة المائلة وإشارات
`@`. `Shift+Tab` يدور في أي وقت وضع الأذونات Ask / Auto-Review / Full Access.
`!` يشغّل أمر صدفة عبر مسار الموافقة المعتاد.

## ماذا يفعل

- **أي نموذج، أي مزوّد — وأي مزيج منهما.** DeepSeek وClaude وGPT وKimi وGLM وأكثر
من 30 مزوّدًا، إضافة إلى vLLM أو SGLang أو Ollama الخاص بك بلا مفتاح، كلها عبر
زمن تشغيل واحد ومجموعة أدوات واحدة. يتتبع الكتالوج تشكيلة كل مزوّد الحيّة —
يبقى خلفية DeepSeek V4 Pro (الموسومة `DeepSeek-V4-Pro-0813`) قابلة للاستدعاء
باسم `deepseek-v4-pro`، وGrok 4.6 هو الافتراضي المباشر لـ xAI، وOrcaRouter
يوجّه عبر `orcarouter/auto`. يسجّل الدور المحفوظ `provider` و`model` وطبقة
الاستدلال صراحة، فيقدر الـ fleet أن يعبر بائعين عدة في تشغيل واحد، ولا تعتمد
مسار الدور على أي مزوّد صادف أنه نشط. حدود السياق والأسعار تأتي من المسار
الحقيقي، والسعر المجهول يظهر مجهولًا لا 0 $.
- **حزمة تكتبها أنت.** الأدوار ملفات تقرأها وتعدّلها — نموذج ووضعية أدوات
وتعليمات ثابتة لكل دور — تُحفظ في المشروع ليشاركها الفريق، أو بجانب إعداداتك
الشخصية الأخرى لتتبعك بين المستودعات. يسجّل الدستور constitution كيف تريد
الوكيل أن يتصرف عبر كل الجلسات، فتتوافق الحزمة مع ممارستك لا ممارستنا.
- **للقراءة فقط حتى تسمح بالمزيد.** وضع Plan لا يغيّر الملفات، والموافقات تقفل
الأوامر الخطرة. عندما يلفّ صندوق رمل نظام التشغيل أمرًا فعلًا، يصرّح Codewhale:
Seatbelt على macOS إن توفّر، وbubblewrap اختياري على Linux. يُترجم
`constitution.json` في المستودع إلى أقفال كتابة لا يتجاوزها حتى Full Access.
- **عمل يمكنك استئنافه.** يسجّل الـ fleet كل خطوة في دفتر للإلحاق فقط، فيلتقط
`fleet resume` من حيث توقفت.

## التكاملات

- **DeepSeek Harness (dsh) — متصل عبر Codewhale.**
يربط `codewhale integrations dsh connect` تثبيت `@deepseek-ai/dsh` القائم
بمسار مزوّد Codewhale وأذوناتك ومساحة عملك، ويضيف `integrations dsh
install-bundle` حزمة إضافات DSH الاختيارية حتى يحمل `dsh --profile codewhale`
تلك الهوية وحده. يملك Codewhale الأذونات وسلطة دورة الحياة؛ ويُبقي dsh جلساته
وملفاته التعريفية وبيانات اعتماده كما هي. انظر
[docs/INTEGRATIONS_DSH.md](docs/INTEGRATIONS_DSH.md).
- **VS Code.** يفتح هيكل الامتداد الرسمي (`extensions/vscode`) Codewhale في
طرفية مدمجة ويعرض Agent View للقراءة فقط فوق زمن التشغيل المحلي. هذه معاينة
تطوير محلية، وليست إصدار سوق بعد.

## اعرف المزيد

- [docs/PROVIDERS.md](docs/PROVIDERS.md) — كل مسار مزوّد: مستضاف وبوابة ومحلي
- [docs/FLEET.md](docs/FLEET.md) — الأساطيل والدفتر والاستئناف
- [docs/WORKFLOW_EXPERIMENTAL_SEARCH.md](docs/WORKFLOW_EXPERIMENTAL_SEARCH.md) — بحث تجريبي مجمّد ومحايد تجاه المزوّد داخل Workflow
- [docs/CONFIGURATION.md](docs/CONFIGURATION.md) — `config.toml` والخطافات
والدستور constitution
- [docs/AUTHORIZATION_ORDER.md](docs/AUTHORIZATION_ORDER.md) — كيف تتركب
الأوضاع والخطافات وقواعد الأذونات وأرضيات السلامة وقانون المستودع والموافقات
والصندوق الرملي
- [docs/HOOKS.md](docs/HOOKS.md) — أحداث الخطاف الأحد عشر في دورة حياة TUI
وحمولاتها، وأي ثلاثة منها تستطيع توجيه دور (`codewhale exec` وأوامر CLI
الفرعية لا تطلق خطافات)
- [docs/WEB.md](docs/WEB.md) — عميل المتصفح على العروة المحلية فقط وحدّ
المصادقة لمرة واحدة

كل ما تبقّى — الأوضاع واختصارات المفاتيح وتفاصيل الصندوق الرملي وMCP وواجهة
زمن التشغيل والعمارة — يعيش في [docs](docs) وعلى
[codewhale.net](https://codewhale.net/).

## المساهمة

المسائل وطلبات السحب وخطوات إعادة الإنتاج والسجلات وطلبات الميزات كلها عمل
مشروع حقيقي، وأول المساهمات مرحّب بها. عندما يتعذّر دمج طلب سحب كما هو، يحصد
المصونون ما يعمل ويبقى المؤلف منسوبًا — في الالتزام وسجل التغييرات و
[docs/CONTRIBUTORS.md](docs/CONTRIBUTORS.md).

- [المسائل المفتوحة](https://github.com/Hmbown/CodeWhale/issues) — مساهمات أولى
جيدة هنا
- [CONTRIBUTING.md](CONTRIBUTING.md) — إعداد التطوير ومسار طلبات السحب
- [docs/CONTRIBUTORS.md](docs/CONTRIBUTORS.md) — كل من شكّل هذا المشروع
- [اشترِ لي قهوة](https://www.buymeacoffee.com/hmbown)

شكرًا لـ [DeepSeek](https://github.com/deepseek-ai) على النماذج والدعم الذي بدأ
المشروع، ولـ [DataWhale](https://github.com/datawhalechina) 🐋 على الترحيب بنا
في عائلة Whale Brother، ولـ [OpenWarp](https://github.com/zerx-lab/warp) و
[Open Design](https://github.com/nexu-io/open-design) على التعاون في تجربة
الوكيل في الطرفية.

## الرخصة

[MIT](LICENSE). مشروع مجتمعي مستقل، غير مرتبط بأي مزوّد نماذج.

![Codewhale يفتح ثلاثة وكلاء فرعيين scout للقراءة فقط في طرفية](assets/fanout.gif)
158 changes: 158 additions & 0 deletions README.ca.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,158 @@
<!-- source: README.md sha256:4fc19c5f9596 -->
# Codewhale

Un agent de programació de codi obert per al teu terminal — porta el teu propi model.

El Codewhale va començar com una experiència nativa per al DeepSeek. Des d'aleshores
s'ha convertit en un projecte impulsat per la comunitat: un harness de programació
que encaixa amb una comunitat internacional en creixement i admet tants models i
proveïdors com sigui possible — els models oberts primer, allotjats o locals, sense
privilegiar-ne cap.

Dona-li un proveïdor, un model i una tasca. Llegeix el teu codi, edita fitxers,
executa ordres i comprova la seva pròpia feina, i s'atura quan la tasca s'ha acabat
o et necessita. Canvia de model a mig camí amb `/model`. Treballa de forma
interactiva a la TUI, o executa `codewhale exec` en scripts i CI. Està escrit en
Rust, amb llicència MIT, i corre a la teva màquina.

El que no s'assembla als altres harnessos: **tu tries el model de cada rol, i no
cal que coincideixin.** Una fleet fixa un proveïdor, un model i un nivell de
raonament per rol — així un model barat i ràpid pot dirigir-ne un de raonament car,
o un builder GLM pot treballar en la mateixa tasca que un reviewer Kimi. Escriu els
teus propis rols i la teva pròpia constitution, i el harness és teu en lloc de nostre.

Sempre busquem persones que hi contribueixin i maneres de millorar. Si falta un
model o un proveïdor que uses, o alguna cosa es trenca, dir-nos-ho és una de les
coses més útils que pots fer — mira [Contribuir](#contribuir).

[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) · [العربية](README.ar.md) · [codewhale.net](https://codewhale.net/) · [Docs](docs) · [Changelog](CHANGELOG.md) · [Discord](https://discord.gg/37gfS3ksug)

[![CI](https://github.com/Hmbown/CodeWhale/actions/workflows/ci.yml/badge.svg)](https://github.com/Hmbown/CodeWhale/actions/workflows/ci.yml)
[![crates.io](https://img.shields.io/crates/v/codewhale-cli?label=crates.io)](https://crates.io/crates/codewhale-cli)
[![npm](https://img.shields.io/npm/v/codewhale?label=npm)](https://www.npmjs.com/package/codewhale)
[![Discord](https://img.shields.io/badge/Discord-join%20the%20community-5865F2?logo=discord&logoColor=white)](https://discord.gg/37gfS3ksug)

![Codewhale en execució en un terminal](assets/screenshot.png)

## Instal·lació

```bash
npm install -g codewhale
```

Cargo, Docker, Nix, Scoop, arxius precompilats, Android/Termux i un mirall CNB
per a qui no pot arribar a GitHub són a
[docs/INSTALL.md](docs/INSTALL.md). Vens de `deepseek-tui`? La configuració i
les sessions es conserven — mira [docs/REBRAND.md](docs/REBRAND.md).

## Ús

```bash
codewhale auth set --provider deepseek # or export ANTHROPIC_API_KEY, etc.
codewhale # open the TUI
codewhale exec "fix the failing test" # headless
codewhale web # local browser client on 127.0.0.1
```

A la TUI: `/model` canvia proveïdor i model alhora, `/fleet` construeix i
executa l'equip — un rol cada vegada, cadascun amb el seu model —, `/undo`
desfà l'últim torn i `/restore <N>` torna l'espai de treball a una instantània
anterior (`/restore` sol els llista). `Tab` recorre Plan / Work / Operate quan
el compositor és buit — amb text, `Tab` completa ordres slash i mencions `@`.
`Shift+Tab` recorre en qualsevol moment la postura de permís Ask / Auto-Review /
Full Access. `!` executa una ordre de l'intèrpret pel camí d'aprovació habitual.

## Què fa

- **Qualsevol model, qualsevol proveïdor — i qualsevol barreja.** DeepSeek,
Claude, GPT, Kimi, GLM i més de 30 proveïdors, a més del teu vLLM, SGLang o
Ollama sense clau, tot a través d'un sol runtime i un sol conjunt d'eines. El
catàleg segueix la línia en viu de cada proveïdor — el backend V4 Pro de
DeepSeek (etiquetat `DeepSeek-V4-Pro-0813`) continua sent invocable com
`deepseek-v4-pro`, Grok 4.6 és el predeterminat directe de xAI i OrcaRouter
enruta per `orcarouter/auto`. Un rol desat registra explícitament el
`provider`, el `model` i el nivell de raonament, de manera que una fleet pot
abastar diversos proveïdors en una sola execució i la ruta d'un rol no depèn
mai de quin proveïdor passa a estar actiu. Els límits de context i els preus
venen de la ruta real; un preu desconegut es mostra com a desconegut, no com
0 $.
- **Un harness que escrius tu.** Els rols són fitxers que pots llegir i editar
— un model, una postura d'eines i instruccions permanents per rol — guardats
al projecte perquè l'equip els comparteixi, o al costat dels altres ajustos
personals perquè et segueixin entre repositoris. Una constitution registra com
vols que l'agent es comporti a cada sessió, de manera que el harness segueixi
la teva pràctica en lloc de la nostra.
- **Només lectura fins que permetis més.** El mode Plan no pot canviar fitxers,
i les aprovacions tanquen les ordres arriscades. Quan un sandbox del sistema
operatiu envolta de debò una ordre, el Codewhale ho diu: Seatbelt a macOS
quan està disponible, bubblewrap opcional a Linux. El `constitution.json` d'un
repositori es compila en bloquejos d'escriptura que ni tan sols Full Access
pot saltar-se.
- **Feina que pots reprendre.** Una fleet registra cada pas en un llibre major
de només afegir, així que `fleet resume` continua on et vas aturar.

## Integracions

- **DeepSeek Harness (dsh) — connectat a través de Codewhale.**
`codewhale integrations dsh connect` enllaça una instal·lació existent de
`@deepseek-ai/dsh` a la teva ruta de proveïdor, permisos i espai de treball
de Codewhale, i `integrations dsh install-bundle` afegeix el paquet de
connectors DSH opcional perquè `dsh --profile codewhale` porti aquesta
identitat tot sol. El Codewhale té els permisos i l'autoritat del cicle de
vida; el dsh conserva les seves sessions, perfils i credencials intactes.
Mira [docs/INTEGRATIONS_DSH.md](docs/INTEGRATIONS_DSH.md).
- **VS Code.** L'entramat oficial de l'extensió (`extensions/vscode`) obre el
Codewhale en un terminal integrat i exposa una Agent View de només lectura
sobre el runtime local. És una previsualització de desenvolupament local, no
encara una publicació al marketplace.

## Per saber-ne més

- [docs/PROVIDERS.md](docs/PROVIDERS.md) — cada ruta de proveïdor: allotjada,
passarel·la i local
- [docs/FLEET.md](docs/FLEET.md) — les fleets, el llibre major i la represa
- [docs/WORKFLOW_EXPERIMENTAL_SEARCH.md](docs/WORKFLOW_EXPERIMENTAL_SEARCH.md) — cerca experimental congelada i neutral respecte al proveïdor dins de Workflow
- [docs/CONFIGURATION.md](docs/CONFIGURATION.md) — `config.toml`, ganxos i la
constitution
- [docs/AUTHORIZATION_ORDER.md](docs/AUTHORIZATION_ORDER.md) — com es
combinen modes, ganxos, regles de permís, terres de seguretat, llei del
repositori, aprovacions i sandbox
- [docs/HOOKS.md](docs/HOOKS.md) — els onze esdeveniments de ganxo del cicle
de vida de la TUI, les seves càrregues i quins tres poden orientar un torn
(`codewhale exec` i les subordres de la CLI no disparen ganxos)
- [docs/WEB.md](docs/WEB.md) — el client de navegador només en loopback i el
seu límit d'autenticació d'un sol ús

Tota la resta — modes, dreceres, detalls del sandbox, MCP, l'API del runtime
i l'arquitectura — viu a [docs](docs) i a
[codewhale.net](https://codewhale.net/).

## Contribuir

Els issues, els PR, els passos de reproducció, els registres i les peticions
de funcionalitat són feina real de projecte, i les primeres contribucions són
benvingudes. Quan un PR no es pot fusionar tal com està, els mantenidors
recullen el que funciona i l'autor resta acreditat — al commit, al changelog i
a [docs/CONTRIBUTORS.md](docs/CONTRIBUTORS.md).

- [Issues oberts](https://github.com/Hmbown/CodeWhale/issues) — les bones
primeres contribucions són aquí
- [CONTRIBUTING.md](CONTRIBUTING.md) — configuració de desenvolupament i flux
de PR
- [docs/CONTRIBUTORS.md](docs/CONTRIBUTORS.md) — tothom qui ha donat forma a
això
- [Convida'm a un cafè](https://www.buymeacoffee.com/hmbown)

Gràcies a [DeepSeek](https://github.com/deepseek-ai) pels models i el suport
que van iniciar el projecte, a [DataWhale](https://github.com/datawhalechina)
🐋 per acollir-nos a la família Whale Brother, i a
[OpenWarp](https://github.com/zerx-lab/warp) i
[Open Design](https://github.com/nexu-io/open-design) per col·laborar en
l'experiència d'agent al terminal.

## Llicència

[MIT](LICENSE). Projecte comunitari independent, no afiliat a cap proveïdor de
models.

![Codewhale desplegant tres subagents scout de només lectura en un terminal](assets/fanout.gif)
Loading
Loading