mirror of
https://github.com/codewhale-hq/Codewhale.git
synced 2026-11-07 17:09:13 -10:00
docs(readme): move the 18 translations into docs/i18n
The repository root showed 19 README files before the changelog, licence and the agent instructions, so the thing a visitor opens first was also the messiest screen in the repo. The translations now live in `docs/i18n/` and the root keeps one README. The move is mechanical but every relative link changes depth, so the links were rewritten from the committed content by resolving each target against the repo root and restating it from `docs/i18n/`, for markdown links and for the `src`/`srcset` image refs alike. Sibling translation links stay as they are. Both gates follow the files rather than being loosened: - `check-readme-translations.py` lists `docs/i18n/README.*.md`, and its URL comparison strips the one `../` and exempts the language switcher by basename, so the same links are still compared as before. - `check-readme-locales.sh` looks for translations in `docs/i18n` and matches switcher links by basename, so a link pointing outside that directory is caught instead of read as a bare filename. It also no longer dies on an empty match set. - `docs/LOCALIZATION.md` and its zh_hans copy say where a new translation goes. Verification: all 1,206 relative references in the 18 files resolve (0 broken); `check-readme-translations.py` 18 in sync; `check-readme-locales.sh` PASS with 18 linked and 0 orphans; `check-facts.mjs` OK; `npm run check:docs` PASS.
This commit is contained in:
CodeWhale Bot committed
1 parent
bef04895c4
commit
e9eac753cb
23 files changed
+782
-770
No files matched your search
@@ -21,7 +21,7 @@ and the web and MCP calls it made.
|
||||
|
||||
[Website](https://codewhale.net) · [Documentation](docs/README.md) · [Changelog](CHANGELOG.md) · [Contributing](CONTRIBUTING.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) · [Català](README.ca.md)
|
||||
[简体中文](docs/i18n/README.zh-CN.md) · [日本語](docs/i18n/README.ja-JP.md) · [Tiếng Việt](docs/i18n/README.vi.md) · [Bahasa Indonesia](docs/i18n/README.id.md) · [한국어](docs/i18n/README.ko-KR.md) · [Español](docs/i18n/README.es-419.md) · [Português](docs/i18n/README.pt-BR.md) · [Русский](docs/i18n/README.ru.md) · [Українська](docs/i18n/README.uk.md) · [Français](docs/i18n/README.fr.md) · [Deutsch](docs/i18n/README.de.md) · [繁體中文](docs/i18n/README.zh-TW.md) · [हिन्दी](docs/i18n/README.hi.md) · [Türkçe](docs/i18n/README.tr.md) · [Italiano](docs/i18n/README.it.md) · [Polski](docs/i18n/README.pl.md) · [العربية](docs/i18n/README.ar.md) · [Català](docs/i18n/README.ca.md)
|
||||
|
||||
<img src="web/public/codewhale-tui-0102-demo.png" alt="A Codewhale terminal session" width="760">
|
||||
|
||||
|
||||
+20
-20
@@ -6,7 +6,7 @@ Canonical tracking document for every locale Codewhale ships, is actively
|
||||
building, is planning, or has explicitly deferred.
|
||||
|
||||
> **Scope note (2026-07-12):** this matrix covers three surfaces — the TUI
|
||||
> locale packs (`crates/localization/locales/`), the translated READMEs (repo root),
|
||||
> locale packs (`crates/localization/locales/`), the translated READMEs (`docs/i18n/`),
|
||||
> and the website (`web/`). The three ship on different cadences, so a
|
||||
> locale can be **shipped** on one surface and **planned** on another; the
|
||||
> per-surface tables below are the per-surface truth. The website registry
|
||||
@@ -138,24 +138,24 @@ what the `(partial)` badge is honest about.
|
||||
| Locale | File | Status | Parity check |
|
||||
|--------|------|--------|-------------|
|
||||
| English | `README.md` | **shipped** | Canonical source |
|
||||
| Simplified Chinese | `README.zh-CN.md` | **shipped** | `scripts/check-readme-translations.py` (stamp + fences + URLs + sections) |
|
||||
| Japanese | `README.ja-JP.md` | **shipped** | Same |
|
||||
| Vietnamese | `README.vi.md` | **shipped** | Same |
|
||||
| Korean | `README.ko-KR.md` | **shipped** | Same |
|
||||
| Latin American Spanish | `README.es-419.md` | **shipped** | Same |
|
||||
| Brazilian Portuguese | `README.pt-BR.md` | **shipped** | Same |
|
||||
| Russian | `README.ru.md` | **shipped** | Same (#3092). Awaiting native-speaker review. |
|
||||
| Ukrainian | `README.uk.md` | **shipped** | Same (#4791). Awaiting native-speaker review. |
|
||||
| Indonesian | `README.id.md` | **shipped** | Same (#4789). Awaiting native-speaker review. |
|
||||
| French | `README.fr.md` | **shipped** | Same. Awaiting native-speaker review. |
|
||||
| German | `README.de.md` | **shipped** | Same. Awaiting native-speaker review. |
|
||||
| Traditional Chinese | `README.zh-TW.md` | **shipped** | Same. Awaiting native-speaker review. |
|
||||
| Hindi | `README.hi.md` | **shipped** | Same. Awaiting native-speaker review. |
|
||||
| Turkish | `README.tr.md` | **shipped** | Same. Awaiting native-speaker review. |
|
||||
| Italian | `README.it.md` | **shipped** | Same. Awaiting native-speaker review. |
|
||||
| Polish | `README.pl.md` | **shipped** | Same. Awaiting native-speaker review. |
|
||||
| Arabic | `README.ar.md` | **shipped** | Same. Awaiting native-speaker review. Markdown only; no HTML `dir` attributes. |
|
||||
| Catalan | `README.ca.md` | **shipped** | Same. Awaiting native-speaker review. |
|
||||
| Simplified Chinese | `docs/i18n/README.zh-CN.md` | **shipped** | `scripts/check-readme-translations.py` (stamp + fences + URLs + sections) |
|
||||
| Japanese | `docs/i18n/README.ja-JP.md` | **shipped** | Same |
|
||||
| Vietnamese | `docs/i18n/README.vi.md` | **shipped** | Same |
|
||||
| Korean | `docs/i18n/README.ko-KR.md` | **shipped** | Same |
|
||||
| Latin American Spanish | `docs/i18n/README.es-419.md` | **shipped** | Same |
|
||||
| Brazilian Portuguese | `docs/i18n/README.pt-BR.md` | **shipped** | Same |
|
||||
| Russian | `docs/i18n/README.ru.md` | **shipped** | Same (#3092). Awaiting native-speaker review. |
|
||||
| Ukrainian | `docs/i18n/README.uk.md` | **shipped** | Same (#4791). Awaiting native-speaker review. |
|
||||
| Indonesian | `docs/i18n/README.id.md` | **shipped** | Same (#4789). Awaiting native-speaker review. |
|
||||
| French | `docs/i18n/README.fr.md` | **shipped** | Same. Awaiting native-speaker review. |
|
||||
| German | `docs/i18n/README.de.md` | **shipped** | Same. Awaiting native-speaker review. |
|
||||
| Traditional Chinese | `docs/i18n/README.zh-TW.md` | **shipped** | Same. Awaiting native-speaker review. |
|
||||
| Hindi | `docs/i18n/README.hi.md` | **shipped** | Same. Awaiting native-speaker review. |
|
||||
| Turkish | `docs/i18n/README.tr.md` | **shipped** | Same. Awaiting native-speaker review. |
|
||||
| Italian | `docs/i18n/README.it.md` | **shipped** | Same. Awaiting native-speaker review. |
|
||||
| Polish | `docs/i18n/README.pl.md` | **shipped** | Same. Awaiting native-speaker review. |
|
||||
| Arabic | `docs/i18n/README.ar.md` | **shipped** | Same. Awaiting native-speaker review. Markdown only; no HTML `dir` attributes. |
|
||||
| Catalan | `docs/i18n/README.ca.md` | **shipped** | Same. Awaiting native-speaker review. |
|
||||
|
||||
## Drift checks
|
||||
|
||||
@@ -217,7 +217,7 @@ carry an explicit `planned`/`partial`/`deferred` row in this matrix.
|
||||
|
||||
### 2. README
|
||||
|
||||
1. Translate `README.md` into `README.<tag>.md`, preserving structure,
|
||||
1. Translate `README.md` into `docs/i18n/README.<tag>.md`, preserving structure,
|
||||
commands, and the #3087 factual history.
|
||||
2. Cross-link it from the language line in `README.md` and from the other
|
||||
translated READMEs.
|
||||
|
||||
@@ -1,9 +1,9 @@
|
||||
<!-- source: README.md sha256:182e239fcdf7 -->
|
||||
<!-- source: README.md sha256:7e0946fcaecd -->
|
||||
<div align="center">
|
||||
|
||||
<picture>
|
||||
<source media="(prefers-color-scheme: dark)" srcset="brand/wordmark-inverted.svg">
|
||||
<img src="brand/wordmark.svg" alt="Codewhale" width="320">
|
||||
<source media="(prefers-color-scheme: dark)" srcset="../../brand/wordmark-inverted.svg">
|
||||
<img src="../../brand/wordmark.svg" alt="Codewhale" width="320">
|
||||
</picture>
|
||||
|
||||
**وكيل برمجة مفتوح المصدر لطرفيتك يعمل مع أي نموذج.**
|
||||
@@ -16,14 +16,14 @@
|
||||
[](https://github.com/codewhale-hq/CodeWhale/actions/workflows/ci.yml)
|
||||
[](https://crates.io/crates/codewhale-cli)
|
||||
[](https://www.npmjs.com/package/codewhale)
|
||||
[](LICENSE)
|
||||
[](../../LICENSE)
|
||||
[](https://discord.gg/37gfS3ksug)
|
||||
|
||||
[الموقع](https://codewhale.net) · [التوثيق](docs/README.md) · [سجل التغييرات](CHANGELOG.md) · [المساهمة](CONTRIBUTING.md)
|
||||
[الموقع](https://codewhale.net) · [التوثيق](../README.md) · [سجل التغييرات](../../CHANGELOG.md) · [المساهمة](../../CONTRIBUTING.md)
|
||||
|
||||
[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)
|
||||
[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)
|
||||
|
||||
<img src="web/public/codewhale-tui-0102-demo.png" alt="جلسة Codewhale في الطرفية" width="760">
|
||||
<img src="../../web/public/codewhale-tui-0102-demo.png" alt="جلسة Codewhale في الطرفية" width="760">
|
||||
|
||||
<sub>نسخة تطوير من 0.10.2 مع نموذج اختبار ذي ردود مُعدّة مسبقًا، بإذن Full Access داخل مساحة عمل مؤقتة. أما التعديل والاختبارات الثلاثة ومراجعة الوكيل الفرعي فقد جرت فعلًا.</sub>
|
||||
|
||||
@@ -39,10 +39,10 @@ curl -fsSL https://codewhale.net/install.sh | sh
|
||||
|
||||
يضع المثبّت `codewhale` واسمه البديل المختصر `codew` في `~/.local/bin` بعد التحقق
|
||||
منهما بمجموع الاختبار (checksum). إذا أظهرت الصدفة بعد ذلك `command not found`،
|
||||
فشغّل سطر PATH الذي يطبعه المثبّت ([التفاصيل](docs/INSTALL.md#put-it-on-your-path)).
|
||||
فشغّل سطر PATH الذي يطبعه المثبّت ([التفاصيل](../INSTALL.md#put-it-on-your-path)).
|
||||
ويرقّيه الأمر `codewhale update`. تثبّت هذه الأوامر أحدث إصدار. أما هذه الصفحة
|
||||
فتتبع `main`، لذا فالميزة المعلَّمة برقم إصدار تصل في ذلك الإصدار؛ ويسرد
|
||||
[سجل التغييرات](CHANGELOG.md) ما يضيفه كل إصدار.
|
||||
[سجل التغييرات](../../CHANGELOG.md) ما يضيفه كل إصدار.
|
||||
|
||||
<details>
|
||||
<summary><b>Windows وnpm وCargo وطرق تثبيت أخرى</b></summary>
|
||||
@@ -55,7 +55,7 @@ cargo install codewhale-cli --locked # crates.io; can trail GitHub Releases
|
||||
|
||||
تتوفر ملفات ثنائية جاهزة لأنظمة Linux وmacOS وWindows على x64 وarm64. وتجد Nix
|
||||
وHomebrew على Linux وAndroid/Termux (معاينة) والتنزيل اليدوي في
|
||||
[دليل التثبيت](docs/INSTALL.md)، والحاويات في [Docker](docs/DOCKER.md). التزم بطريقة
|
||||
[دليل التثبيت](../INSTALL.md)، والحاويات في [Docker](../DOCKER.md). التزم بطريقة
|
||||
تثبيت واحدة لكل جهاز؛ وإلا ستوجد نسختان على `PATH` وتُستخدم النسخة التي تأتي أولًا.
|
||||
|
||||
</details>
|
||||
@@ -99,7 +99,7 @@ codewhale exec --auto --sandbox workspace-write "fix the failing tests and expla
|
||||
| الوضع (Mode) | `Tab` (عندما يكون حقل الإدخال فارغًا) أو `/mode` | في **Plan** يقرأ ويبحث لكنه لا يغيّر شيئًا. وفي **Work** يعدّل الملفات ويشغّل الأوامر. أما **Operate** فله صلاحيات Work نفسها، ويعامل طلبك على أنه هدف، ويواصل العمل حتى يُتحقَّق من الهدف أو يحتاج إلى مُدخل منك. |
|
||||
| الإذن (Permission) | `Shift+Tab` | مع **Ask** تُطبَّق تعديلات الملفات في مستودعك دون سؤال، ويسأل قبل أوامر الصدفة التي ليست للقراءة فقط. ومع **Auto-Review** تعتمد القواعد ونموذج مراجِع الاستدعاءات الروتينية، ويرفض هذا الإذن الاستدعاءات عالية الخطورة؛ انتقل إلى Ask لتوافق عليها بنفسك. أما **Full Access** فلا يسأل أبدًا ويوقف صندوق حماية Codewhale؛ وتظل قواعد المستودع والسياسة المُدارة سارية. |
|
||||
|
||||
راجع [دليل الأوضاع والأذونات](docs/MODES.md) للتفاصيل.
|
||||
راجع [دليل الأوضاع والأذونات](../MODES.md) للتفاصيل.
|
||||
|
||||
## ما الذي يفعله
|
||||
|
||||
@@ -128,12 +128,12 @@ codewhale exec --auto --sandbox workspace-write "fix the failing tests and expla
|
||||
OpenAI، وكذلك النماذج المحلية عبر Ollama أو vLLM أو SGLang. والنموذج الافتراضي
|
||||
هو `deepseek-flash` من DeepSeek، الذي نقلته DeepSeek إلى DeepSeek-V4.1-Flash-1017
|
||||
في 2026-10-17؛ ويشغّله 0.10.1 دون تحديث
|
||||
([التفاصيل](docs/PROVIDERS.md#deepseek-v41-flash)).
|
||||
([التفاصيل](../PROVIDERS.md#deepseek-v41-flash)).
|
||||
|
||||
ويبدّل `/model` النموذج بين دورات المحادثة، ويختار `/model auto` نموذجًا لكل دورة
|
||||
(ويضبط `/router` طريقة الاختيار). ويعرض `/turn inspect` النموذج الذي استخدمته
|
||||
الدورة وتكلفتها والمدة التي استغرقتها. ويتيح لك `codewhale auth chatgpt` استخدام
|
||||
اشتراك ChatGPT بدلًا من مفتاح API (تجريبي). راجع [المزوّدين](docs/PROVIDERS.md).
|
||||
اشتراك ChatGPT بدلًا من مفتاح API (تجريبي). راجع [المزوّدين](../PROVIDERS.md).
|
||||
|
||||
### الإيصالات والتراجع
|
||||
|
||||
@@ -142,7 +142,7 @@ OpenAI، وكذلك النماذج المحلية عبر Ollama أو vLLM أو S
|
||||
ومن منحها، وحالات الفشل. ويُلغي `/undo` آخر طلب لك؛ وفي 0.10.1 يتطلب `/trust on`
|
||||
للملفات، ويتراجع عن استدعاء أداة واحد في كل مرة. ويعيد `/restore` مساحة العمل
|
||||
كلها إلى لقطة سابقة؛ ولأن ذلك يكتب فوق التعديلات اللاحقة، فإنه يتطلب `/trust on`
|
||||
أو Full Access. راجع [الإيصالات](docs/RECEIPTS.md).
|
||||
أو Full Access. راجع [الإيصالات](../RECEIPTS.md).
|
||||
|
||||
تُحفظ عمليات تشغيل exec التي تتيح أدوات بكل صيغ الإخراج، لذا يعمل
|
||||
`codewhale receipts --last` بعد `exec --auto`، بما في ذلك مع `--json`.
|
||||
@@ -153,8 +153,8 @@ OpenAI، وكذلك النماذج المحلية عبر Ollama أو vLLM أو S
|
||||
### الأعمال الأطول
|
||||
|
||||
يحدد `/goal` هدفًا يستمر عبر دورات المحادثة. ويستطيع Codewhale توزيع العمل على
|
||||
[وكلاء فرعيين](docs/SUBAGENTS.md)، أو تشغيل [فريق وكلاء](docs/FLEET.md)، أو اتباع
|
||||
[سير عمل](docs/WORKFLOW_AUTHORING.md) مضمَّن في المستودع.
|
||||
[وكلاء فرعيين](../SUBAGENTS.md)، أو تشغيل [فريق وكلاء](../FLEET.md)، أو اتباع
|
||||
[سير عمل](../WORKFLOW_AUTHORING.md) مضمَّن في المستودع.
|
||||
|
||||
### إن كنت قادمًا من وكيل آخر
|
||||
|
||||
@@ -162,24 +162,24 @@ OpenAI، وكذلك النماذج المحلية عبر Ollama أو vLLM أو S
|
||||
أخرى، مثل `CLAUDE.md` أو `.cursorrules` أو `.github/copilot-instructions.md`، فلا
|
||||
تُحمَّل إلا عندما تختار ذلك بإضافة `project_instruction_imports = ["claude"]` (أو
|
||||
`"cursor"` أو `"cline"` أو `"windsurf"` أو `"copilot"` أو `"all"`) إلى ملف
|
||||
إعداداتك؛ راجع [config.example.toml](config.example.toml). ويُصدر Codewhale تحذيرًا
|
||||
إعداداتك؛ راجع [config.example.toml](../../config.example.toml). ويُصدر Codewhale تحذيرًا
|
||||
عندما يعثر على ملف منها لم يحمّله.
|
||||
|
||||
يجهّز `/import-claude` استيرادًا لإعدادات Claude Code وخوادم MCP الخاصة بك لتراجعه.
|
||||
ويقبل `/plugin install` إضافات Claude Code التي تحتوي على مهارات وأوامر وملفات تعريف
|
||||
وكلاء وخوادم MCP، ويرفض الإضافات التي تحتاج إلى خطافات أو خوادم LSP
|
||||
([التفاصيل](docs/CLAUDE_PLUGIN_COMPAT.md)).
|
||||
([التفاصيل](../CLAUDE_PLUGIN_COMPAT.md)).
|
||||
|
||||
### الامتدادات
|
||||
|
||||
اربط [خوادم MCP](docs/MCP.md)، وأضف [المهارات](docs/SKILLS.md) و[الإضافات](docs/PLUGINS.md)،
|
||||
وشغّل [الخطافات](docs/HOOKS.md) عند أحداث الجلسة والأدوات. ويتيح وضع الشيفرة
|
||||
اربط [خوادم MCP](../MCP.md)، وأضف [المهارات](../SKILLS.md) و[الإضافات](../PLUGINS.md)،
|
||||
وشغّل [الخطافات](../HOOKS.md) عند أحداث الجلسة والأدوات. ويتيح وضع الشيفرة
|
||||
(Code mode، تجريبي ومفعّل افتراضيًا) للنموذج كتابة برنامج `execute_tools` واحد
|
||||
يستدعي عدة أدوات من MCP والإضافات؛ ويظل كل استدعاء خاضعًا لقواعد الموافقة لديك
|
||||
ويحتفظ بإيصاله. وتستطيع إضافة Computer Use
|
||||
المضمَّنة (تجريبية، لنظام macOS فقط) مراقبة التطبيقات الأخرى والتحكم فيها. وتبقى
|
||||
معطّلة إلى أن تراجع صلاحيات وصولها وتفعّلها
|
||||
([الدليل](crates/tui/plugins/computer-use/README.md)).
|
||||
([الدليل](../../crates/tui/plugins/computer-use/README.md)).
|
||||
|
||||
## طرق التشغيل
|
||||
|
||||
@@ -187,13 +187,13 @@ OpenAI، وكذلك النماذج المحلية عبر Ollama أو vLLM أو S
|
||||
| --- | --- |
|
||||
| `codewhale` | تطبيق الطرفية التفاعلي |
|
||||
| `codewhale exec "…"` | مهمة واحدة دون الواجهة. دون خيارات إضافية يجيب دون استخدام الأدوات؛ ويفعّل `--auto` الأدوات مع Full Access افتراضيًا، ويقيّدها `--sandbox workspace-write`، ويبث `--output-format stream-json` الأحداث بصيغة JSON |
|
||||
| `codewhale web` | واجهة ويب محلية على `127.0.0.1` ([الدليل](docs/WEB.md)) |
|
||||
| `codewhale review --pr N` | مراجعة استشارية لطلب pull request على GitHub. لا ينشر شيئًا ما لم تضف `--post`؛ ويُجري [GitHub Action](docs/GITHUB_ACTION.md) المراجعة نفسها في CI |
|
||||
| `codewhale app-server --http` | واجهة [Runtime API](docs/RUNTIME_API.md)، وهي واجهة HTTP محلية للخيوط والأحداث والموافقات وتغييرات الملفات في كل دورة |
|
||||
| `codewhale web` | واجهة ويب محلية على `127.0.0.1` ([الدليل](../WEB.md)) |
|
||||
| `codewhale review --pr N` | مراجعة استشارية لطلب pull request على GitHub. لا ينشر شيئًا ما لم تضف `--post`؛ ويُجري [GitHub Action](../GITHUB_ACTION.md) المراجعة نفسها في CI |
|
||||
| `codewhale app-server --http` | واجهة [Runtime API](../RUNTIME_API.md)، وهي واجهة HTTP محلية للخيوط والأحداث والموافقات وتغييرات الملفات في كل دورة |
|
||||
| `codewhale serve --acp` | بروتوكول Agent Client Protocol عبر stdio، لمحررات مثل Zed |
|
||||
|
||||
يتشارك تطبيق الطرفية و`exec` و`web` وRuntime API محركًا واحدًا
|
||||
([البنية](docs/ARCHITECTURE.md)). ويتصل به من الشريط الجانبي
|
||||
([البنية](../ARCHITECTURE.md)). ويتصل به من الشريط الجانبي
|
||||
[امتداد VS Code](https://marketplace.visualstudio.com/items?itemName=HengQuWorld.brotherwhale-vscode)
|
||||
الذي يصونه المجتمع ([المصدر](https://github.com/HengQuWorld/CodeWhale-VSCode)).
|
||||
ويجري تطوير تطبيق أصلي لسطح المكتب مبني على Runtime API؛ ولا يتوفر له تنزيل عام
|
||||
@@ -225,25 +225,25 @@ Windows صندوق حماية لنظام التشغيل بعد، ويوقف Full
|
||||
أو بيانات الاعتماد. ويوقفه الأمر `codewhale config set telemetry false`. وعند بدء
|
||||
التشغيل يتحقق Codewhale أيضًا من GitHub بحثًا عن إصدار جديد؛ اضبط
|
||||
`CODEWHALE_NO_UPDATE_CHECK=1` لتخطي ذلك. المزيد في
|
||||
[ترتيب التفويض](docs/AUTHORIZATION_ORDER.md) و[صندوق الحماية](docs/SANDBOX.md)
|
||||
و[القياس عن بُعد](docs/TELEMETRY.md).
|
||||
[ترتيب التفويض](../AUTHORIZATION_ORDER.md) و[صندوق الحماية](../SANDBOX.md)
|
||||
و[القياس عن بُعد](../TELEMETRY.md).
|
||||
|
||||
## التوثيق
|
||||
|
||||
| ابدأ من هنا | المرجع |
|
||||
| --- | --- |
|
||||
| [التثبيت](docs/INSTALL.md) | [الإعدادات](docs/CONFIGURATION.md) |
|
||||
| [المزوّدون والنماذج المحلية](docs/PROVIDERS.md) | [البنية](docs/ARCHITECTURE.md) |
|
||||
| [الأوضاع والأذونات](docs/MODES.md) | [Runtime API](docs/RUNTIME_API.md) |
|
||||
| [اختصارات لوحة المفاتيح](docs/KEYBINDINGS.md) | [تأليف الإضافات](docs/PLUGIN_AUTHORING.md) |
|
||||
| [مراجعة PR على GitHub](docs/GITHUB_ACTION.md) | [كل التوثيق](docs/README.md) |
|
||||
| [التثبيت](../INSTALL.md) | [الإعدادات](../CONFIGURATION.md) |
|
||||
| [المزوّدون والنماذج المحلية](../PROVIDERS.md) | [البنية](../ARCHITECTURE.md) |
|
||||
| [الأوضاع والأذونات](../MODES.md) | [Runtime API](../RUNTIME_API.md) |
|
||||
| [اختصارات لوحة المفاتيح](../KEYBINDINGS.md) | [تأليف الإضافات](../PLUGIN_AUTHORING.md) |
|
||||
| [مراجعة PR على GitHub](../GITHUB_ACTION.md) | [كل التوثيق](../README.md) |
|
||||
|
||||
## المجتمع
|
||||
|
||||
إذا كان هناك مزوّد مفقود أو سير عمل غير مريح،
|
||||
[فافتح issue](https://github.com/codewhale-hq/CodeWhale/issues/new/choose) أو
|
||||
[أرسل pull request](CONTRIBUTING.md). يحتفظ المساهمون بالفضل في العمل الذي يُدمج،
|
||||
وتوضّح [بنية المستودع](CONTRIBUTING.md#project-structure) مكان كل شيء.
|
||||
[أرسل pull request](../../CONTRIBUTING.md). يحتفظ المساهمون بالفضل في العمل الذي يُدمج،
|
||||
وتوضّح [بنية المستودع](../../CONTRIBUTING.md#project-structure) مكان كل شيء.
|
||||
|
||||
تواصل معنا على [Discord](https://discord.gg/37gfS3ksug)، أو أضف القائم على صيانة
|
||||
المشروع، Hunter، على WeChat (`hunterbown`) واطلب الانضمام إلى مجموعة Whale Brothers.
|
||||
@@ -252,9 +252,9 @@ Windows صندوق حماية لنظام التشغيل بعد، ويوقف Full
|
||||
|
||||
بدأ Codewhale باسم `deepseek-tui` ولا يزال يقرأ إعدادات ذلك المشروع وجلساته. ويُصان
|
||||
باستقلال، وليس تابعًا لـ DeepSeek ولا لأي مزوّد نماذج آخر. شكرًا
|
||||
لـ[كل من ساهم](docs/CONTRIBUTORS.md).
|
||||
لـ[كل من ساهم](../CONTRIBUTORS.md).
|
||||
|
||||
[](docs/CONTRIBUTORS.md#everyone)
|
||||
[](../CONTRIBUTORS.md#everyone)
|
||||
|
||||
الترخيص: [MIT](LICENSE). والشيفرة المقتبسة من مشاريع مفتوحة المصدر أخرى مُدرجة في
|
||||
[إشعارات الأطراف الثالثة](docs/THIRD_PARTY_NOTICES.md).
|
||||
الترخيص: [MIT](../../LICENSE). والشيفرة المقتبسة من مشاريع مفتوحة المصدر أخرى مُدرجة في
|
||||
[إشعارات الأطراف الثالثة](../THIRD_PARTY_NOTICES.md).
|
||||
@@ -1,9 +1,9 @@
|
||||
<!-- source: README.md sha256:182e239fcdf7 -->
|
||||
<!-- source: README.md sha256:7e0946fcaecd -->
|
||||
<div align="center">
|
||||
|
||||
<picture>
|
||||
<source media="(prefers-color-scheme: dark)" srcset="brand/wordmark-inverted.svg">
|
||||
<img src="brand/wordmark.svg" alt="Codewhale" width="320">
|
||||
<source media="(prefers-color-scheme: dark)" srcset="../../brand/wordmark-inverted.svg">
|
||||
<img src="../../brand/wordmark.svg" alt="Codewhale" width="320">
|
||||
</picture>
|
||||
|
||||
**Un agent de programació de codi obert per al teu terminal que funciona amb qualsevol model.**
|
||||
@@ -17,14 +17,14 @@ canviat, les ordres que ha executat i les crides web i MCP que ha fet.
|
||||
[](https://github.com/codewhale-hq/CodeWhale/actions/workflows/ci.yml)
|
||||
[](https://crates.io/crates/codewhale-cli)
|
||||
[](https://www.npmjs.com/package/codewhale)
|
||||
[](LICENSE)
|
||||
[](../../LICENSE)
|
||||
[](https://discord.gg/37gfS3ksug)
|
||||
|
||||
[Lloc web](https://codewhale.net) · [Documentació](docs/README.md) · [Registre de canvis](CHANGELOG.md) · [Contribuir](CONTRIBUTING.md)
|
||||
[Lloc web](https://codewhale.net) · [Documentació](../README.md) · [Registre de canvis](../../CHANGELOG.md) · [Contribuir](../../CONTRIBUTING.md)
|
||||
|
||||
[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)
|
||||
[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)
|
||||
|
||||
<img src="web/public/codewhale-tui-0102-demo.png" alt="Una sessió de terminal de Codewhale" width="760">
|
||||
<img src="../../web/public/codewhale-tui-0102-demo.png" alt="Una sessió de terminal de Codewhale" width="760">
|
||||
|
||||
<sub>Una compilació de desenvolupament de la 0.10.2 amb un model de prova amb guió, en Full Access dins d’un espai de treball d’un sol ús. L’edició, tres proves i una revisió d’un subagent es van executar de debò.</sub>
|
||||
|
||||
@@ -41,10 +41,10 @@ curl -fsSL https://codewhale.net/install.sh | sh
|
||||
L’instal·lador desa `codewhale` i el seu àlies curt `codew` a `~/.local/bin`,
|
||||
després de comprovar-ne la suma de verificació. Si després el teu shell diu
|
||||
`command not found`, executa la línia de PATH que mostra l’instal·lador
|
||||
([detalls](docs/INSTALL.md#put-it-on-your-path)). `codewhale update`
|
||||
([detalls](../INSTALL.md#put-it-on-your-path)). `codewhale update`
|
||||
l’actualitza. Aquestes ordres instal·len la darrera versió. Aquesta pàgina
|
||||
segueix `main`, de manera que una funcionalitat marcada amb una versió arriba en
|
||||
aquella versió; el [registre de canvis](CHANGELOG.md) llista què afegeix cada
|
||||
aquella versió; el [registre de canvis](../../CHANGELOG.md) llista què afegeix cada
|
||||
versió.
|
||||
|
||||
<details>
|
||||
@@ -58,8 +58,8 @@ cargo install codewhale-cli --locked # crates.io; can trail GitHub Releases
|
||||
|
||||
Hi ha binaris precompilats per a Linux, macOS i Windows en x64 i arm64. Nix,
|
||||
Homebrew a Linux, Android/Termux (versió preliminar) i les descàrregues manuals
|
||||
s’expliquen a la [guia d’instal·lació](docs/INSTALL.md), i els contenidors a
|
||||
[Docker](docs/DOCKER.md). Fes servir un sol mètode d’instal·lació per màquina;
|
||||
s’expliquen a la [guia d’instal·lació](../INSTALL.md), i els contenidors a
|
||||
[Docker](../DOCKER.md). Fes servir un sol mètode d’instal·lació per màquina;
|
||||
si no, acabaràs amb dues còpies al `PATH` i s’executarà la que hi aparegui
|
||||
primer.
|
||||
|
||||
@@ -107,7 +107,7 @@ Una instal·lació nova comença en mode Work amb el permís Ask.
|
||||
| Mode | `Tab` (amb l’entrada buida) o `/mode` | **Plan** llegeix i cerca però no canvia res. **Work** edita fitxers i executa ordres. **Operate** té el mateix accés que Work, tracta la teva petició com un objectiu i continua fins que l’objectiu està verificat o necessita alguna resposta teva. |
|
||||
| Permís | `Shift+Tab` | **Ask** aplica les edicions de fitxers al teu repositori sense preguntar i pregunta abans de les ordres de shell que no són de només lectura. **Auto-Review** deixa que unes regles i un model revisor aprovin les crides rutinàries i rebutja les d’alt risc; canvia a Ask per aprovar-les tu mateix. **Full Access** no pregunta mai i desactiva el sandbox de Codewhale; les regles del repositori i la política gestionada continuen aplicant-se. |
|
||||
|
||||
Consulta la [guia de modes i permisos](docs/MODES.md) per als detalls.
|
||||
Consulta la [guia de modes i permisos](../MODES.md) per als detalls.
|
||||
|
||||
## Què fa
|
||||
|
||||
@@ -140,13 +140,13 @@ endpoint compatible amb OpenAI, i també els models locals mitjançant Ollama,
|
||||
vLLM o SGLang. El model per defecte és `deepseek-flash` de DeepSeek, que
|
||||
DeepSeek va passar a DeepSeek-V4.1-Flash-1017 el 2026-10-17; la 0.10.1
|
||||
l’executa sense cap actualització
|
||||
([detalls](docs/PROVIDERS.md#deepseek-v41-flash)).
|
||||
([detalls](../PROVIDERS.md#deepseek-v41-flash)).
|
||||
|
||||
`/model` canvia de model entre torns, i `/model auto` en tria un per a cada torn
|
||||
(`/router` configura com ho fa). `/turn inspect` mostra quin model ha fet servir
|
||||
un torn, quant ha costat i quant ha trigat. `codewhale auth chatgpt` et permet
|
||||
fer servir un pla de ChatGPT en lloc d’una clau API (experimental). Consulta
|
||||
[Proveïdors](docs/PROVIDERS.md).
|
||||
[Proveïdors](../PROVIDERS.md).
|
||||
|
||||
### Rebuts i desfer
|
||||
|
||||
@@ -156,7 +156,7 @@ aprovacions i qui les va donar, i els errors. `/undo` desfà la teva última
|
||||
petició; a la 0.10.1 necessita `/trust on` per als fitxers i retrocedeix una
|
||||
crida d’eina cada vegada. `/restore` torna tot l’espai de treball a una
|
||||
instantània anterior; com que això sobreescriu les edicions posteriors,
|
||||
necessita `/trust on` o Full Access. Consulta [Rebuts](docs/RECEIPTS.md).
|
||||
necessita `/trust on` o Full Access. Consulta [Rebuts](../RECEIPTS.md).
|
||||
|
||||
Les execucions d’exec que ofereixen eines es desen en tots els formats de
|
||||
sortida, de manera que `codewhale receipts --last` funciona després
|
||||
@@ -168,8 +168,8 @@ per desar-les sempre per als rebuts o per a `exec --continue`.
|
||||
### Feines més llargues
|
||||
|
||||
`/goal` defineix un objectiu que es manté entre torns. Codewhale pot repartir la
|
||||
feina entre [subagents](docs/SUBAGENTS.md), executar una [flota](docs/FLEET.md)
|
||||
d’agents o seguir un [flux de treball](docs/WORKFLOW_AUTHORING.md) versionat al
|
||||
feina entre [subagents](../SUBAGENTS.md), executar una [flota](../FLEET.md)
|
||||
d’agents o seguir un [flux de treball](../WORKFLOW_AUTHORING.md) versionat al
|
||||
repositori.
|
||||
|
||||
### Si véns d’un altre agent
|
||||
@@ -179,25 +179,25 @@ per a altres eines, com ara `CLAUDE.md`, `.cursorrules` o
|
||||
`.github/copilot-instructions.md`, només es carreguen si ho actives amb
|
||||
`project_instruction_imports = ["claude"]` (o `"cursor"`, `"cline"`,
|
||||
`"windsurf"`, `"copilot"`, `"all"`) a la configuració; consulta
|
||||
[config.example.toml](config.example.toml). Codewhale avisa quan en troba un que
|
||||
[config.example.toml](../../config.example.toml). Codewhale avisa quan en troba un que
|
||||
no ha carregat.
|
||||
|
||||
`/import-claude` prepara una importació de la teva configuració i dels servidors
|
||||
MCP de Claude Code perquè la revisis. `/plugin install` accepta plugins de
|
||||
Claude Code que continguin skills, ordres, perfils d’agent i servidors MCP, i
|
||||
rebutja els plugins que necessiten hooks o servidors LSP
|
||||
([detalls](docs/CLAUDE_PLUGIN_COMPAT.md)).
|
||||
([detalls](../CLAUDE_PLUGIN_COMPAT.md)).
|
||||
|
||||
### Extensions
|
||||
|
||||
Connecta [servidors MCP](docs/MCP.md), afegeix [skills](docs/SKILLS.md) i
|
||||
[plugins](docs/PLUGINS.md), i executa [hooks](docs/HOOKS.md) en esdeveniments de
|
||||
Connecta [servidors MCP](../MCP.md), afegeix [skills](../SKILLS.md) i
|
||||
[plugins](../PLUGINS.md), i executa [hooks](../HOOKS.md) en esdeveniments de
|
||||
sessió i d’eines. Code mode (experimental, activat per defecte) permet que el
|
||||
model escrigui un sol programa `execute_tools` que crida diverses eines de MCP i
|
||||
de plugins; cada crida continua subjecta a les teves regles d’aprovació i
|
||||
conserva el seu rebut. El plugin Computer Use inclòs (experimental, només
|
||||
macOS) pot observar i operar altres aplicacions. Roman desactivat fins que en revises
|
||||
l’accés i l’actives ([guia](crates/tui/plugins/computer-use/README.md)).
|
||||
l’accés i l’actives ([guia](../../crates/tui/plugins/computer-use/README.md)).
|
||||
|
||||
## Maneres d’executar-lo
|
||||
|
||||
@@ -205,13 +205,13 @@ l’accés i l’actives ([guia](crates/tui/plugins/computer-use/README.md)).
|
||||
| --- | --- |
|
||||
| `codewhale` | L’aplicació interactiva de terminal |
|
||||
| `codewhale exec "…"` | Una tasca sense la interfície. Per si sol respon sense fer servir eines; `--auto` activa les eines amb Full Access per defecte, `--sandbox workspace-write` les restringeix, i `--output-format stream-json` emet els esdeveniments en streaming com a JSON |
|
||||
| `codewhale web` | Una interfície web local a `127.0.0.1` ([guia](docs/WEB.md)) |
|
||||
| `codewhale review --pr N` | Una revisió orientativa d’un pull request de GitHub. No publica res tret que hi afegeixis `--post`; la [GitHub Action](docs/GITHUB_ACTION.md) executa la mateixa revisió a CI |
|
||||
| `codewhale app-server --http` | La [Runtime API](docs/RUNTIME_API.md), una API HTTP local per a fils, esdeveniments, aprovacions i els canvis de fitxers de cada torn |
|
||||
| `codewhale web` | Una interfície web local a `127.0.0.1` ([guia](../WEB.md)) |
|
||||
| `codewhale review --pr N` | Una revisió orientativa d’un pull request de GitHub. No publica res tret que hi afegeixis `--post`; la [GitHub Action](../GITHUB_ACTION.md) executa la mateixa revisió a CI |
|
||||
| `codewhale app-server --http` | La [Runtime API](../RUNTIME_API.md), una API HTTP local per a fils, esdeveniments, aprovacions i els canvis de fitxers de cada torn |
|
||||
| `codewhale serve --acp` | L’Agent Client Protocol sobre stdio, per a editors com ara Zed |
|
||||
|
||||
L’aplicació de terminal, `exec`, `web` i la Runtime API comparteixen un mateix
|
||||
motor ([arquitectura](docs/ARCHITECTURE.md)). Una
|
||||
motor ([arquitectura](../ARCHITECTURE.md)). Una
|
||||
[extensió de VS Code](https://marketplace.visualstudio.com/items?itemName=HengQuWorld.brotherwhale-vscode)
|
||||
mantinguda per la comunitat s’hi connecta des de la barra lateral
|
||||
([codi font](https://github.com/HengQuWorld/CodeWhale-VSCode)).
|
||||
@@ -246,25 +246,25 @@ d’instal·lació aleatori que canvia cada 90 dies, i mai converses, codi, prom
|
||||
noms de models, noms de fitxers o de repositoris, ni credencials. `codewhale config set telemetry false` la desactiva. En iniciar-se,
|
||||
Codewhale també comprova a GitHub si hi ha una versió nova; defineix
|
||||
`CODEWHALE_NO_UPDATE_CHECK=1` per ometre-ho. Més informació a
|
||||
[ordre d’autorització](docs/AUTHORIZATION_ORDER.md),
|
||||
[sandboxing](docs/SANDBOX.md) i [telemetria](docs/TELEMETRY.md).
|
||||
[ordre d’autorització](../AUTHORIZATION_ORDER.md),
|
||||
[sandboxing](../SANDBOX.md) i [telemetria](../TELEMETRY.md).
|
||||
|
||||
## Documentació
|
||||
|
||||
| Comença aquí | Referència |
|
||||
| --- | --- |
|
||||
| [Instal·lació](docs/INSTALL.md) | [Configuració](docs/CONFIGURATION.md) |
|
||||
| [Proveïdors i models locals](docs/PROVIDERS.md) | [Arquitectura](docs/ARCHITECTURE.md) |
|
||||
| [Modes i permisos](docs/MODES.md) | [Runtime API](docs/RUNTIME_API.md) |
|
||||
| [Dreceres de teclat](docs/KEYBINDINGS.md) | [Creació de plugins](docs/PLUGIN_AUTHORING.md) |
|
||||
| [Revisió de PR a GitHub](docs/GITHUB_ACTION.md) | [Tota la documentació](docs/README.md) |
|
||||
| [Instal·lació](../INSTALL.md) | [Configuració](../CONFIGURATION.md) |
|
||||
| [Proveïdors i models locals](../PROVIDERS.md) | [Arquitectura](../ARCHITECTURE.md) |
|
||||
| [Modes i permisos](../MODES.md) | [Runtime API](../RUNTIME_API.md) |
|
||||
| [Dreceres de teclat](../KEYBINDINGS.md) | [Creació de plugins](../PLUGIN_AUTHORING.md) |
|
||||
| [Revisió de PR a GitHub](../GITHUB_ACTION.md) | [Tota la documentació](../README.md) |
|
||||
|
||||
## Comunitat
|
||||
|
||||
Si falta un proveïdor o un flux de treball és incòmode,
|
||||
[obre un issue](https://github.com/codewhale-hq/CodeWhale/issues/new/choose) o
|
||||
[envia un pull request](CONTRIBUTING.md). Qui contribueix conserva el crèdit pel
|
||||
treball que s’hi integra, i l’[estructura del repositori](CONTRIBUTING.md#project-structure)
|
||||
[envia un pull request](../../CONTRIBUTING.md). Qui contribueix conserva el crèdit pel
|
||||
treball que s’hi integra, i l’[estructura del repositori](../../CONTRIBUTING.md#project-structure)
|
||||
mostra on és cada cosa.
|
||||
|
||||
Xateja al [Discord](https://discord.gg/37gfS3ksug), o afegeix el mantenidor,
|
||||
@@ -275,9 +275,9 @@ Hunter, a WeChat (`hunterbown`) i demana entrar al grup Whale Brothers.
|
||||
Codewhale va començar com a `deepseek-tui` i encara llegeix la configuració i
|
||||
les sessions d’aquell projecte. Es manté de manera independent i no està afiliat
|
||||
a DeepSeek ni a cap altre proveïdor de models. Gràcies a
|
||||
[tothom qui hi ha contribuït](docs/CONTRIBUTORS.md).
|
||||
[tothom qui hi ha contribuït](../CONTRIBUTORS.md).
|
||||
|
||||
[](docs/CONTRIBUTORS.md#everyone)
|
||||
[](../CONTRIBUTORS.md#everyone)
|
||||
|
||||
[MIT](LICENSE). El codi adaptat d’altres projectes de codi obert es recull als
|
||||
[avisos de tercers](docs/THIRD_PARTY_NOTICES.md).
|
||||
[MIT](../../LICENSE). El codi adaptat d’altres projectes de codi obert es recull als
|
||||
[avisos de tercers](../THIRD_PARTY_NOTICES.md).
|
||||
@@ -1,9 +1,9 @@
|
||||
<!-- source: README.md sha256:182e239fcdf7 -->
|
||||
<!-- source: README.md sha256:7e0946fcaecd -->
|
||||
<div align="center">
|
||||
|
||||
<picture>
|
||||
<source media="(prefers-color-scheme: dark)" srcset="brand/wordmark-inverted.svg">
|
||||
<img src="brand/wordmark.svg" alt="Codewhale" width="320">
|
||||
<source media="(prefers-color-scheme: dark)" srcset="../../brand/wordmark-inverted.svg">
|
||||
<img src="../../brand/wordmark.svg" alt="Codewhale" width="320">
|
||||
</picture>
|
||||
|
||||
**Ein Open-Source-Coding-Agent für dein Terminal, der mit jedem Modell arbeitet.**
|
||||
@@ -18,14 +18,14 @@ ausgeführt hat, und die Web- und MCP-Aufrufe, die es gemacht hat.
|
||||
[](https://github.com/codewhale-hq/CodeWhale/actions/workflows/ci.yml)
|
||||
[](https://crates.io/crates/codewhale-cli)
|
||||
[](https://www.npmjs.com/package/codewhale)
|
||||
[](LICENSE)
|
||||
[](../../LICENSE)
|
||||
[](https://discord.gg/37gfS3ksug)
|
||||
|
||||
[Website](https://codewhale.net) · [Dokumentation](docs/README.md) · [Changelog](CHANGELOG.md) · [Mitwirken](CONTRIBUTING.md)
|
||||
[Website](https://codewhale.net) · [Dokumentation](../README.md) · [Changelog](../../CHANGELOG.md) · [Mitwirken](../../CONTRIBUTING.md)
|
||||
|
||||
[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) · [繁體中文](README.zh-TW.md) · [हिन्दी](README.hi.md) · [Türkçe](README.tr.md) · [Italiano](README.it.md) · [Polski](README.pl.md) · [العربية](README.ar.md) · [Català](README.ca.md)
|
||||
[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) · [繁體中文](README.zh-TW.md) · [हिन्दी](README.hi.md) · [Türkçe](README.tr.md) · [Italiano](README.it.md) · [Polski](README.pl.md) · [العربية](README.ar.md) · [Català](README.ca.md)
|
||||
|
||||
<img src="web/public/codewhale-tui-0102-demo.png" alt="Eine Codewhale-Terminalsitzung" width="760">
|
||||
<img src="../../web/public/codewhale-tui-0102-demo.png" alt="Eine Codewhale-Terminalsitzung" width="760">
|
||||
|
||||
<sub>Ein Entwicklungs-Build von 0.10.2 mit einem geskripteten Testmodell, in Full Access in einem Wegwerf-Arbeitsbereich. Die Änderung, drei Tests und ein Review durch einen Sub-Agenten liefen wirklich.</sub>
|
||||
|
||||
@@ -42,10 +42,10 @@ curl -fsSL https://codewhale.net/install.sh | sh
|
||||
Das Installationsskript legt `codewhale` und den kurzen Alias `codew` nach
|
||||
Prüfsummenkontrolle in `~/.local/bin` ab. Meldet deine Shell danach
|
||||
`command not found`, führe die PATH-Zeile aus, die das Skript ausgibt
|
||||
([Details](docs/INSTALL.md#put-it-on-your-path)).
|
||||
([Details](../INSTALL.md#put-it-on-your-path)).
|
||||
`codewhale update` aktualisiert es. Diese Befehle installieren das neueste
|
||||
Release. Diese Seite folgt `main`; eine mit einer Version markierte Funktion
|
||||
kommt also mit diesem Release, und der [Changelog](CHANGELOG.md) listet, was
|
||||
kommt also mit diesem Release, und der [Changelog](../../CHANGELOG.md) listet, was
|
||||
jedes Release hinzufügt.
|
||||
|
||||
<details>
|
||||
@@ -59,8 +59,8 @@ cargo install codewhale-cli --locked # crates.io; can trail GitHub Releases
|
||||
|
||||
Vorkompilierte Binärdateien gibt es für Linux, macOS und Windows auf x64 und
|
||||
arm64. Nix, Homebrew unter Linux, Android/Termux (Vorschau) und manuelle
|
||||
Downloads beschreibt die [Installationsanleitung](docs/INSTALL.md), Container
|
||||
die Seite [Docker](docs/DOCKER.md). Bleib pro Rechner bei einer
|
||||
Downloads beschreibt die [Installationsanleitung](../INSTALL.md), Container
|
||||
die Seite [Docker](../DOCKER.md). Bleib pro Rechner bei einer
|
||||
Installationsmethode; sonst landen zwei Kopien im `PATH`, und es gewinnt die,
|
||||
die zuerst kommt.
|
||||
|
||||
@@ -110,7 +110,7 @@ Eine neue Installation startet im Work-Modus mit der Berechtigung Ask.
|
||||
| Modus | `Tab` (bei leerer Eingabe) oder `/mode` | **Plan** liest und durchsucht, ändert aber nichts. **Work** bearbeitet Dateien und führt Befehle aus. **Operate** hat dieselben Zugriffsrechte wie Work, behandelt deine Anfrage als Ziel und arbeitet weiter, bis das Ziel überprüft ist oder es eine Eingabe von dir braucht. |
|
||||
| Berechtigung | `Shift+Tab` | **Ask** wendet Dateiänderungen in deinem Repository an, ohne zu fragen, und fragt vor Shell-Befehlen, die nicht nur lesen. **Auto-Review** lässt Regeln und ein Prüfmodell Routineaufrufe freigeben und lehnt Aufrufe mit hohem Risiko ab; wechsle zu Ask, um diese selbst freizugeben. **Full Access** fragt nie und schaltet die Sandbox von Codewhale ab; Repository-Regeln und verwaltete Richtlinien gelten weiterhin. |
|
||||
|
||||
Details stehen in der [Anleitung zu Modi und Berechtigungen](docs/MODES.md).
|
||||
Details stehen in der [Anleitung zu Modi und Berechtigungen](../MODES.md).
|
||||
|
||||
## Was es kann
|
||||
|
||||
@@ -145,13 +145,13 @@ Google, Mistral, Moonshot, OpenRouter und xAI. Jeder OpenAI-kompatible Endpunkt
|
||||
funktioniert, ebenso lokale Modelle über Ollama, vLLM oder SGLang. Standard ist
|
||||
`deepseek-flash` von DeepSeek, das DeepSeek am 2026-10-17 auf
|
||||
DeepSeek-V4.1-Flash-1017 umgestellt hat; 0.10.1 nutzt es ohne Update
|
||||
([Details](docs/PROVIDERS.md#deepseek-v41-flash)).
|
||||
([Details](../PROVIDERS.md#deepseek-v41-flash)).
|
||||
|
||||
`/model` wechselt das Modell zwischen den Turns, und `/model auto` wählt für
|
||||
jeden Turn eines aus (`/router` legt fest, wie). `/turn inspect` zeigt, welches
|
||||
Modell ein Turn verwendet hat, was er gekostet hat und wie lange er gedauert
|
||||
hat. Mit `codewhale auth chatgpt` kannst du statt eines API-Schlüssels ein
|
||||
ChatGPT-Abo verwenden (experimentell). Siehe [Anbieter](docs/PROVIDERS.md).
|
||||
ChatGPT-Abo verwenden (experimentell). Siehe [Anbieter](../PROVIDERS.md).
|
||||
|
||||
### Belege und Rückgängigmachen
|
||||
|
||||
@@ -162,7 +162,7 @@ letzte Anfrage rückgängig; in 0.10.1 braucht es für Dateien `/trust on` und
|
||||
geht jeweils um einen Tool-Aufruf zurück. `/restore` setzt den gesamten
|
||||
Arbeitsbereich auf einen früheren Snapshot zurück; weil dabei spätere
|
||||
Änderungen überschrieben werden, braucht es `/trust on` oder Full Access. Siehe
|
||||
[Belege](docs/RECEIPTS.md).
|
||||
[Belege](../RECEIPTS.md).
|
||||
|
||||
Exec-Läufe, die Tools anbieten, werden in jedem Ausgabeformat gespeichert,
|
||||
sodass `codewhale receipts --last` nach `exec --auto` funktioniert, auch mit
|
||||
@@ -174,9 +174,9 @@ verwende `--output-format stream-json`, um sie immer für Belege oder
|
||||
### Längere Arbeit
|
||||
|
||||
`/goal` setzt ein Ziel, das über mehrere Turns bestehen bleibt. Codewhale kann
|
||||
Arbeit auf [Sub-Agenten](docs/SUBAGENTS.md) verteilen, eine
|
||||
[Flotte](docs/FLEET.md) von Agenten betreiben oder einem im Repository
|
||||
eingecheckten [Workflow](docs/WORKFLOW_AUTHORING.md) folgen.
|
||||
Arbeit auf [Sub-Agenten](../SUBAGENTS.md) verteilen, eine
|
||||
[Flotte](../FLEET.md) von Agenten betreiben oder einem im Repository
|
||||
eingecheckten [Workflow](../WORKFLOW_AUTHORING.md) folgen.
|
||||
|
||||
### Umstieg von einem anderen Agenten
|
||||
|
||||
@@ -184,19 +184,19 @@ Codewhale liest `AGENTS.md` von selbst. Anweisungsdateien für andere Tools wie
|
||||
`CLAUDE.md`, `.cursorrules` oder `.github/copilot-instructions.md` werden nur
|
||||
geladen, wenn du sie mit `project_instruction_imports = ["claude"]` (oder
|
||||
`"cursor"`, `"cline"`, `"windsurf"`, `"copilot"`, `"all"`) in deiner
|
||||
Konfiguration aktivierst; siehe [config.example.toml](config.example.toml).
|
||||
Konfiguration aktivierst; siehe [config.example.toml](../../config.example.toml).
|
||||
Codewhale warnt, wenn es eine findet, die es nicht geladen hat.
|
||||
|
||||
`/import-claude` bereitet einen Import deiner Claude-Code-Einstellungen und
|
||||
MCP-Server vor, den du prüfen kannst. `/plugin install` nimmt Claude-Code-Plugins
|
||||
mit Skills, Befehlen, Agentenprofilen und MCP-Servern an und lehnt Plugins ab,
|
||||
die Hooks oder LSP-Server brauchen
|
||||
([Details](docs/CLAUDE_PLUGIN_COMPAT.md)).
|
||||
([Details](../CLAUDE_PLUGIN_COMPAT.md)).
|
||||
|
||||
### Erweiterungen
|
||||
|
||||
Verbinde [MCP-Server](docs/MCP.md), füge [Skills](docs/SKILLS.md) und
|
||||
[Plugins](docs/PLUGINS.md) hinzu und führe [Hooks](docs/HOOKS.md) bei Sitzungs-
|
||||
Verbinde [MCP-Server](../MCP.md), füge [Skills](../SKILLS.md) und
|
||||
[Plugins](../PLUGINS.md) hinzu und führe [Hooks](../HOOKS.md) bei Sitzungs-
|
||||
und Tool-Ereignissen aus. Der Code-Modus (experimentell, standardmäßig
|
||||
eingeschaltet) lässt das Modell ein einziges `execute_tools`-Programm schreiben,
|
||||
das mehrere MCP- und Plugin-Tools aufruft; jeder Aufruf unterliegt weiterhin
|
||||
@@ -204,7 +204,7 @@ deinen Freigaberegeln und behält seinen Beleg. Das mitgelieferte Plugin
|
||||
Computer Use (experimentell, nur macOS) kann andere Apps beobachten und
|
||||
bedienen. Es bleibt ausgeschaltet,
|
||||
bis du seine Zugriffsrechte geprüft und es aktiviert hast
|
||||
([Anleitung](crates/tui/plugins/computer-use/README.md)).
|
||||
([Anleitung](../../crates/tui/plugins/computer-use/README.md)).
|
||||
|
||||
## Wege, es auszuführen
|
||||
|
||||
@@ -212,13 +212,13 @@ bis du seine Zugriffsrechte geprüft und es aktiviert hast
|
||||
| --- | --- |
|
||||
| `codewhale` | Die interaktive Terminal-App |
|
||||
| `codewhale exec "…"` | Eine Aufgabe ohne Oberfläche. Ohne weitere Optionen antwortet es, ohne Tools zu verwenden; `--auto` aktiviert Tools standardmäßig mit Full Access, `--sandbox workspace-write` schränkt sie ein, und `--output-format stream-json` streamt Ereignisse als JSON |
|
||||
| `codewhale web` | Eine lokale Web-Oberfläche auf `127.0.0.1` ([Anleitung](docs/WEB.md)) |
|
||||
| `codewhale review --pr N` | Ein beratendes Review eines GitHub-Pull-Requests. Es veröffentlicht nichts, solange du nicht `--post` angibst; die [GitHub Action](docs/GITHUB_ACTION.md) führt dasselbe Review in der CI aus |
|
||||
| `codewhale app-server --http` | Die [Runtime API](docs/RUNTIME_API.md), eine lokale HTTP-API für Threads, Ereignisse, Freigaben und die Dateiänderungen jedes Turns |
|
||||
| `codewhale web` | Eine lokale Web-Oberfläche auf `127.0.0.1` ([Anleitung](../WEB.md)) |
|
||||
| `codewhale review --pr N` | Ein beratendes Review eines GitHub-Pull-Requests. Es veröffentlicht nichts, solange du nicht `--post` angibst; die [GitHub Action](../GITHUB_ACTION.md) führt dasselbe Review in der CI aus |
|
||||
| `codewhale app-server --http` | Die [Runtime API](../RUNTIME_API.md), eine lokale HTTP-API für Threads, Ereignisse, Freigaben und die Dateiänderungen jedes Turns |
|
||||
| `codewhale serve --acp` | Das Agent Client Protocol über stdio, für Editoren wie Zed |
|
||||
|
||||
Die Terminal-App, `exec`, `web` und die Runtime API teilen sich eine Engine
|
||||
([Architektur](docs/ARCHITECTURE.md)). Eine von der Community gepflegte
|
||||
([Architektur](../ARCHITECTURE.md)). Eine von der Community gepflegte
|
||||
[VS-Code-Erweiterung](https://marketplace.visualstudio.com/items?itemName=HengQuWorld.brotherwhale-vscode)
|
||||
verbindet sich aus der Seitenleiste damit ([Quellcode](https://github.com/HengQuWorld/CodeWhale-VSCode)).
|
||||
Eine native Desktop-App auf Basis der Runtime API ist in Entwicklung; einen
|
||||
@@ -253,26 +253,26 @@ Installations-ID, die alle 90 Tage wechselt, und niemals Unterhaltungen, Code,
|
||||
Prompts, Modellnamen, Datei- oder Repository-Namen oder Zugangsdaten. `codewhale config set telemetry false` schaltet sie ab. Beim Start
|
||||
prüft Codewhale außerdem auf GitHub, ob es ein neues Release gibt; setze
|
||||
`CODEWHALE_NO_UPDATE_CHECK=1`, um das zu überspringen. Mehr dazu unter
|
||||
[Autorisierungsreihenfolge](docs/AUTHORIZATION_ORDER.md),
|
||||
[Sandboxing](docs/SANDBOX.md) und [Telemetrie](docs/TELEMETRY.md).
|
||||
[Autorisierungsreihenfolge](../AUTHORIZATION_ORDER.md),
|
||||
[Sandboxing](../SANDBOX.md) und [Telemetrie](../TELEMETRY.md).
|
||||
|
||||
## Dokumentation
|
||||
|
||||
| Zum Einstieg | Referenz |
|
||||
| --- | --- |
|
||||
| [Installation](docs/INSTALL.md) | [Konfiguration](docs/CONFIGURATION.md) |
|
||||
| [Anbieter und lokale Modelle](docs/PROVIDERS.md) | [Architektur](docs/ARCHITECTURE.md) |
|
||||
| [Modi und Berechtigungen](docs/MODES.md) | [Runtime API](docs/RUNTIME_API.md) |
|
||||
| [Tastenbelegung](docs/KEYBINDINGS.md) | [Plugins entwickeln](docs/PLUGIN_AUTHORING.md) |
|
||||
| [GitHub-PR-Review](docs/GITHUB_ACTION.md) | [Gesamte Dokumentation](docs/README.md) |
|
||||
| [Installation](../INSTALL.md) | [Konfiguration](../CONFIGURATION.md) |
|
||||
| [Anbieter und lokale Modelle](../PROVIDERS.md) | [Architektur](../ARCHITECTURE.md) |
|
||||
| [Modi und Berechtigungen](../MODES.md) | [Runtime API](../RUNTIME_API.md) |
|
||||
| [Tastenbelegung](../KEYBINDINGS.md) | [Plugins entwickeln](../PLUGIN_AUTHORING.md) |
|
||||
| [GitHub-PR-Review](../GITHUB_ACTION.md) | [Gesamte Dokumentation](../README.md) |
|
||||
|
||||
## Community
|
||||
|
||||
Fehlt ein Anbieter oder ist ein Workflow umständlich,
|
||||
[eröffne ein Issue](https://github.com/codewhale-hq/CodeWhale/issues/new/choose) oder
|
||||
[sende einen Pull Request](CONTRIBUTING.md). Wer beiträgt, behält die
|
||||
[sende einen Pull Request](../../CONTRIBUTING.md). Wer beiträgt, behält die
|
||||
Anerkennung für die Arbeit, die übernommen wird, und die
|
||||
[Repository-Struktur](CONTRIBUTING.md#project-structure) zeigt, wo was liegt.
|
||||
[Repository-Struktur](../../CONTRIBUTING.md#project-structure) zeigt, wo was liegt.
|
||||
|
||||
Chatte auf [Discord](https://discord.gg/37gfS3ksug), oder füge den Maintainer
|
||||
Hunter auf WeChat (`hunterbown`) hinzu und bitte darum, in die Gruppe
|
||||
@@ -283,10 +283,10 @@ Whale Brothers aufgenommen zu werden.
|
||||
Codewhale begann als `deepseek-tui` und liest weiterhin die Konfiguration und
|
||||
die Sitzungen dieses Projekts. Es wird unabhängig gepflegt und ist weder mit
|
||||
DeepSeek noch mit einem anderen Modellanbieter verbunden. Danke an
|
||||
[alle, die beigetragen haben](docs/CONTRIBUTORS.md).
|
||||
[alle, die beigetragen haben](../CONTRIBUTORS.md).
|
||||
|
||||
[](docs/CONTRIBUTORS.md#everyone)
|
||||
[](../CONTRIBUTORS.md#everyone)
|
||||
|
||||
[MIT](LICENSE). Code, der aus anderen Open-Source-Projekten übernommen wurde,
|
||||
ist in den [Hinweisen zu Drittanbietern](docs/THIRD_PARTY_NOTICES.md)
|
||||
[MIT](../../LICENSE). Code, der aus anderen Open-Source-Projekten übernommen wurde,
|
||||
ist in den [Hinweisen zu Drittanbietern](../THIRD_PARTY_NOTICES.md)
|
||||
aufgeführt.
|
||||
@@ -1,9 +1,9 @@
|
||||
<!-- source: README.md sha256:182e239fcdf7 -->
|
||||
<!-- source: README.md sha256:7e0946fcaecd -->
|
||||
<div align="center">
|
||||
|
||||
<picture>
|
||||
<source media="(prefers-color-scheme: dark)" srcset="brand/wordmark-inverted.svg">
|
||||
<img src="brand/wordmark.svg" alt="Codewhale" width="320">
|
||||
<source media="(prefers-color-scheme: dark)" srcset="../../brand/wordmark-inverted.svg">
|
||||
<img src="../../brand/wordmark.svg" alt="Codewhale" width="320">
|
||||
</picture>
|
||||
|
||||
**Un agente de programación de código abierto para tu terminal que funciona con cualquier modelo.**
|
||||
@@ -18,14 +18,14 @@ MCP que hizo.
|
||||
[](https://github.com/codewhale-hq/CodeWhale/actions/workflows/ci.yml)
|
||||
[](https://crates.io/crates/codewhale-cli)
|
||||
[](https://www.npmjs.com/package/codewhale)
|
||||
[](LICENSE)
|
||||
[](../../LICENSE)
|
||||
[](https://discord.gg/37gfS3ksug)
|
||||
|
||||
[Sitio web](https://codewhale.net) · [Documentación](docs/README.md) · [Registro de cambios](CHANGELOG.md) · [Contribuir](CONTRIBUTING.md)
|
||||
[Sitio web](https://codewhale.net) · [Documentación](../README.md) · [Registro de cambios](../../CHANGELOG.md) · [Contribuir](../../CONTRIBUTING.md)
|
||||
|
||||
[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) · [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) · [Català](README.ca.md)
|
||||
[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) · [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) · [Català](README.ca.md)
|
||||
|
||||
<img src="web/public/codewhale-tui-0102-demo.png" alt="Una sesión de terminal de Codewhale" width="760">
|
||||
<img src="../../web/public/codewhale-tui-0102-demo.png" alt="Una sesión de terminal de Codewhale" width="760">
|
||||
|
||||
<sub>Una compilación de desarrollo de 0.10.2 con un modelo de prueba con guion, en Full Access dentro de un espacio de trabajo desechable. La edición, tres pruebas y una revisión de un sub-agente se ejecutaron de verdad.</sub>
|
||||
|
||||
@@ -42,10 +42,10 @@ curl -fsSL https://codewhale.net/install.sh | sh
|
||||
El instalador coloca `codewhale` y su alias corto `codew`, con la suma de
|
||||
verificación comprobada, en `~/.local/bin`. Si después tu shell responde
|
||||
`command not found`, ejecuta la línea de PATH que muestra el instalador
|
||||
([detalles](docs/INSTALL.md#put-it-on-your-path)). `codewhale update` lo
|
||||
([detalles](../INSTALL.md#put-it-on-your-path)). `codewhale update` lo
|
||||
actualiza. Estos comandos instalan la versión más reciente. Esta página sigue a
|
||||
`main`, así que una función marcada con una versión llega en esa versión; el
|
||||
[registro de cambios](CHANGELOG.md) enumera lo que agrega cada versión.
|
||||
[registro de cambios](../../CHANGELOG.md) enumera lo que agrega cada versión.
|
||||
|
||||
<details>
|
||||
<summary><b>Windows, npm, Cargo y otras formas de instalarlo</b></summary>
|
||||
@@ -58,8 +58,8 @@ cargo install codewhale-cli --locked # crates.io; can trail GitHub Releases
|
||||
|
||||
Hay binarios precompilados para Linux, macOS y Windows en x64 y arm64. Nix,
|
||||
Homebrew en Linux, Android/Termux (versión preliminar) y las descargas manuales
|
||||
están en la [guía de instalación](docs/INSTALL.md), y los contenedores, en
|
||||
[Docker](docs/DOCKER.md). Usa un solo método de instalación por máquina; de lo
|
||||
están en la [guía de instalación](../INSTALL.md), y los contenedores, en
|
||||
[Docker](../DOCKER.md). Usa un solo método de instalación por máquina; de lo
|
||||
contrario, terminas con dos copias en el `PATH` y gana la que aparezca primero.
|
||||
|
||||
</details>
|
||||
@@ -107,7 +107,7 @@ Una instalación nueva arranca en el modo Work con el permiso Ask.
|
||||
| Modo | `Tab` (cuando la entrada está vacía) o `/mode` | **Plan** lee y busca, pero no cambia nada. **Work** edita archivos y ejecuta comandos. **Operate** tiene el mismo acceso que Work, trata tu solicitud como una meta y sigue hasta que la meta queda verificada o necesita una respuesta tuya. |
|
||||
| Permiso | `Shift+Tab` | **Ask** aplica las ediciones de archivos en tu repositorio sin preguntar y pregunta antes de los comandos de shell que no son de solo lectura. **Auto-Review** deja que unas reglas y un modelo revisor aprueben las llamadas rutinarias y rechaza las de alto riesgo; cambia a Ask para aprobar esas tú mismo. **Full Access** nunca pregunta y desactiva el sandbox de Codewhale; las reglas del repositorio y la política administrada siguen aplicándose. |
|
||||
|
||||
Consulta la [guía de modos y permisos](docs/MODES.md) para ver los detalles.
|
||||
Consulta la [guía de modos y permisos](../MODES.md) para ver los detalles.
|
||||
|
||||
## Qué hace
|
||||
|
||||
@@ -139,13 +139,13 @@ Google, Mistral, Moonshot, OpenRouter y xAI. Funciona cualquier endpoint
|
||||
compatible con OpenAI, y también los modelos locales mediante Ollama, vLLM o
|
||||
SGLang. El modelo predeterminado es `deepseek-flash` de DeepSeek, que DeepSeek
|
||||
cambió a DeepSeek-V4.1-Flash-1017 el 2026-10-17; 0.10.1 lo ejecuta sin
|
||||
necesidad de actualizar ([detalles](docs/PROVIDERS.md#deepseek-v41-flash)).
|
||||
necesidad de actualizar ([detalles](../PROVIDERS.md#deepseek-v41-flash)).
|
||||
|
||||
`/model` cambia de modelo entre turnos, y `/model auto` elige uno para cada
|
||||
turno (`/router` configura cómo). `/turn inspect` muestra qué modelo usó un
|
||||
turno, cuánto costó y cuánto tardó. `codewhale auth chatgpt` te permite usar un
|
||||
plan de ChatGPT en lugar de una clave API (experimental). Consulta
|
||||
[Proveedores](docs/PROVIDERS.md).
|
||||
[Proveedores](../PROVIDERS.md).
|
||||
|
||||
### Recibos y deshacer
|
||||
|
||||
@@ -156,7 +156,7 @@ deshace tu última solicitud; en 0.10.1 necesita `/trust on` para los archivos y
|
||||
retrocede una llamada de herramienta a la vez. `/restore` regresa todo el
|
||||
espacio de trabajo a una instantánea anterior; como eso sobrescribe las
|
||||
ediciones posteriores, requiere `/trust on` o Full Access. Consulta
|
||||
[Recibos](docs/RECEIPTS.md).
|
||||
[Recibos](../RECEIPTS.md).
|
||||
|
||||
Las ejecuciones de exec que ofrecen herramientas se guardan en todos los
|
||||
formatos de salida, así que `codewhale receipts --last` funciona después de
|
||||
@@ -168,9 +168,9 @@ para guardarlas siempre para los recibos o para `exec --continue`.
|
||||
### Trabajos más largos
|
||||
|
||||
`/goal` define un objetivo que se mantiene entre turnos. Codewhale puede
|
||||
repartir el trabajo entre [sub-agentes](docs/SUBAGENTS.md), ejecutar una
|
||||
[flota](docs/FLEET.md) de agentes o seguir un
|
||||
[flujo de trabajo](docs/WORKFLOW_AUTHORING.md) versionado en el repositorio.
|
||||
repartir el trabajo entre [sub-agentes](../SUBAGENTS.md), ejecutar una
|
||||
[flota](../FLEET.md) de agentes o seguir un
|
||||
[flujo de trabajo](../WORKFLOW_AUTHORING.md) versionado en el repositorio.
|
||||
|
||||
### Si vienes de otro agente
|
||||
|
||||
@@ -179,26 +179,26 @@ para otras herramientas, como `CLAUDE.md`, `.cursorrules` o
|
||||
`.github/copilot-instructions.md`, solo se cargan si los habilitas con
|
||||
`project_instruction_imports = ["claude"]` (o `"cursor"`, `"cline"`,
|
||||
`"windsurf"`, `"copilot"`, `"all"`) en tu configuración; consulta
|
||||
[config.example.toml](config.example.toml). Codewhale te avisa cuando encuentra
|
||||
[config.example.toml](../../config.example.toml). Codewhale te avisa cuando encuentra
|
||||
uno que no cargó.
|
||||
|
||||
`/import-claude` prepara una importación de tu configuración y tus servidores
|
||||
MCP de Claude Code para que la revises. `/plugin install` acepta plugins de
|
||||
Claude Code que contengan skills, comandos, perfiles de agente y servidores MCP,
|
||||
y rechaza los plugins que necesitan hooks o servidores LSP
|
||||
([detalles](docs/CLAUDE_PLUGIN_COMPAT.md)).
|
||||
([detalles](../CLAUDE_PLUGIN_COMPAT.md)).
|
||||
|
||||
### Extensiones
|
||||
|
||||
Conecta [servidores MCP](docs/MCP.md), agrega [skills](docs/SKILLS.md) y
|
||||
[plugins](docs/PLUGINS.md), y ejecuta [hooks](docs/HOOKS.md) en eventos de
|
||||
Conecta [servidores MCP](../MCP.md), agrega [skills](../SKILLS.md) y
|
||||
[plugins](../PLUGINS.md), y ejecuta [hooks](../HOOKS.md) en eventos de
|
||||
sesión y de herramientas. Code mode (experimental, activado de forma
|
||||
predeterminada) permite que el modelo escriba un solo programa `execute_tools`
|
||||
que llama a varias herramientas de MCP y de plugins; cada llamada sigue sujeta a
|
||||
tus reglas de aprobación y conserva su recibo. El plugin Computer Use incluido
|
||||
(experimental, solo macOS) puede observar y operar otras aplicaciones. Permanece desactivado hasta
|
||||
que revises su acceso y lo habilites
|
||||
([guía](crates/tui/plugins/computer-use/README.md)).
|
||||
([guía](../../crates/tui/plugins/computer-use/README.md)).
|
||||
|
||||
## Formas de ejecutarlo
|
||||
|
||||
@@ -206,13 +206,13 @@ que revises su acceso y lo habilites
|
||||
| --- | --- |
|
||||
| `codewhale` | La aplicación interactiva de terminal |
|
||||
| `codewhale exec "…"` | Una tarea sin la interfaz. Por sí solo responde sin usar herramientas; `--auto` habilita las herramientas con Full Access de forma predeterminada, `--sandbox workspace-write` las restringe, y `--output-format stream-json` transmite los eventos como JSON |
|
||||
| `codewhale web` | Una interfaz web local en `127.0.0.1` ([guía](docs/WEB.md)) |
|
||||
| `codewhale review --pr N` | Una revisión orientativa de un pull request de GitHub. No publica nada a menos que agregues `--post`; la [GitHub Action](docs/GITHUB_ACTION.md) ejecuta la misma revisión en CI |
|
||||
| `codewhale app-server --http` | La [Runtime API](docs/RUNTIME_API.md), una API HTTP local para hilos, eventos, aprobaciones y los cambios de archivos de cada turno |
|
||||
| `codewhale web` | Una interfaz web local en `127.0.0.1` ([guía](../WEB.md)) |
|
||||
| `codewhale review --pr N` | Una revisión orientativa de un pull request de GitHub. No publica nada a menos que agregues `--post`; la [GitHub Action](../GITHUB_ACTION.md) ejecuta la misma revisión en CI |
|
||||
| `codewhale app-server --http` | La [Runtime API](../RUNTIME_API.md), una API HTTP local para hilos, eventos, aprobaciones y los cambios de archivos de cada turno |
|
||||
| `codewhale serve --acp` | El Agent Client Protocol sobre stdio, para editores como Zed |
|
||||
|
||||
La aplicación de terminal, `exec`, `web` y la Runtime API comparten un mismo
|
||||
motor ([arquitectura](docs/ARCHITECTURE.md)). Una
|
||||
motor ([arquitectura](../ARCHITECTURE.md)). Una
|
||||
[extensión de VS Code](https://marketplace.visualstudio.com/items?itemName=HengQuWorld.brotherwhale-vscode)
|
||||
mantenida por la comunidad se conecta a él desde la barra lateral
|
||||
([código fuente](https://github.com/HengQuWorld/CodeWhale-VSCode)).
|
||||
@@ -247,26 +247,26 @@ aleatorio que cambia cada 90 días, y nunca conversaciones, código, prompts,
|
||||
nombres de modelos, nombres de archivos o de repositorios, ni credenciales. `codewhale config set telemetry false` la desactiva. Al
|
||||
iniciar, Codewhale también consulta GitHub para ver si hay una versión nueva;
|
||||
define `CODEWHALE_NO_UPDATE_CHECK=1` para omitir esa consulta. Más información
|
||||
en [orden de autorización](docs/AUTHORIZATION_ORDER.md),
|
||||
[sandboxing](docs/SANDBOX.md) y [telemetría](docs/TELEMETRY.md).
|
||||
en [orden de autorización](../AUTHORIZATION_ORDER.md),
|
||||
[sandboxing](../SANDBOX.md) y [telemetría](../TELEMETRY.md).
|
||||
|
||||
## Documentación
|
||||
|
||||
| Empieza aquí | Referencia |
|
||||
| --- | --- |
|
||||
| [Instalación](docs/INSTALL.md) | [Configuración](docs/CONFIGURATION.md) |
|
||||
| [Proveedores y modelos locales](docs/PROVIDERS.md) | [Arquitectura](docs/ARCHITECTURE.md) |
|
||||
| [Modos y permisos](docs/MODES.md) | [Runtime API](docs/RUNTIME_API.md) |
|
||||
| [Atajos de teclado](docs/KEYBINDINGS.md) | [Creación de plugins](docs/PLUGIN_AUTHORING.md) |
|
||||
| [Revisión de PR en GitHub](docs/GITHUB_ACTION.md) | [Toda la documentación](docs/README.md) |
|
||||
| [Instalación](../INSTALL.md) | [Configuración](../CONFIGURATION.md) |
|
||||
| [Proveedores y modelos locales](../PROVIDERS.md) | [Arquitectura](../ARCHITECTURE.md) |
|
||||
| [Modos y permisos](../MODES.md) | [Runtime API](../RUNTIME_API.md) |
|
||||
| [Atajos de teclado](../KEYBINDINGS.md) | [Creación de plugins](../PLUGIN_AUTHORING.md) |
|
||||
| [Revisión de PR en GitHub](../GITHUB_ACTION.md) | [Toda la documentación](../README.md) |
|
||||
|
||||
## Comunidad
|
||||
|
||||
Si falta un proveedor o un flujo de trabajo resulta incómodo,
|
||||
[abre un issue](https://github.com/codewhale-hq/CodeWhale/issues/new/choose) o
|
||||
[envía un pull request](CONTRIBUTING.md). Quienes contribuyen conservan el
|
||||
[envía un pull request](../../CONTRIBUTING.md). Quienes contribuyen conservan el
|
||||
crédito por el trabajo que se integra, y la
|
||||
[estructura del repositorio](CONTRIBUTING.md#project-structure) muestra dónde
|
||||
[estructura del repositorio](../../CONTRIBUTING.md#project-structure) muestra dónde
|
||||
está cada cosa.
|
||||
|
||||
Conversa en [Discord](https://discord.gg/37gfS3ksug), o agrega al mantenedor,
|
||||
@@ -277,9 +277,9 @@ Hunter, en WeChat (`hunterbown`) y pide unirte al grupo Whale Brothers.
|
||||
Codewhale comenzó como `deepseek-tui` y todavía lee la configuración y las
|
||||
sesiones de ese proyecto. Se mantiene de forma independiente y no está afiliado
|
||||
a DeepSeek ni a ningún otro proveedor de modelos. Gracias a
|
||||
[todas las personas que han contribuido](docs/CONTRIBUTORS.md).
|
||||
[todas las personas que han contribuido](../CONTRIBUTORS.md).
|
||||
|
||||
[](docs/CONTRIBUTORS.md#everyone)
|
||||
[](../CONTRIBUTORS.md#everyone)
|
||||
|
||||
[MIT](LICENSE). El código adaptado de otros proyectos de código abierto se
|
||||
enumera en los [avisos de terceros](docs/THIRD_PARTY_NOTICES.md).
|
||||
[MIT](../../LICENSE). El código adaptado de otros proyectos de código abierto se
|
||||
enumera en los [avisos de terceros](../THIRD_PARTY_NOTICES.md).
|
||||
@@ -1,9 +1,9 @@
|
||||
<!-- source: README.md sha256:182e239fcdf7 -->
|
||||
<!-- source: README.md sha256:7e0946fcaecd -->
|
||||
<div align="center">
|
||||
|
||||
<picture>
|
||||
<source media="(prefers-color-scheme: dark)" srcset="brand/wordmark-inverted.svg">
|
||||
<img src="brand/wordmark.svg" alt="Codewhale" width="320">
|
||||
<source media="(prefers-color-scheme: dark)" srcset="../../brand/wordmark-inverted.svg">
|
||||
<img src="../../brand/wordmark.svg" alt="Codewhale" width="320">
|
||||
</picture>
|
||||
|
||||
**Un agent de code open source pour votre terminal qui fonctionne avec n’importe quel modèle.**
|
||||
@@ -18,14 +18,14 @@ qu’il a exécutées et les appels web et MCP qu’il a effectués.
|
||||
[](https://github.com/codewhale-hq/CodeWhale/actions/workflows/ci.yml)
|
||||
[](https://crates.io/crates/codewhale-cli)
|
||||
[](https://www.npmjs.com/package/codewhale)
|
||||
[](LICENSE)
|
||||
[](../../LICENSE)
|
||||
[](https://discord.gg/37gfS3ksug)
|
||||
|
||||
[Site web](https://codewhale.net) · [Documentation](docs/README.md) · [Journal des modifications](CHANGELOG.md) · [Contribuer](CONTRIBUTING.md)
|
||||
[Site web](https://codewhale.net) · [Documentation](../README.md) · [Journal des modifications](../../CHANGELOG.md) · [Contribuer](../../CONTRIBUTING.md)
|
||||
|
||||
[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) · [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) · [Català](README.ca.md)
|
||||
[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) · [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) · [Català](README.ca.md)
|
||||
|
||||
<img src="web/public/codewhale-tui-0102-demo.png" alt="Une session de terminal Codewhale" width="760">
|
||||
<img src="../../web/public/codewhale-tui-0102-demo.png" alt="Une session de terminal Codewhale" width="760">
|
||||
|
||||
<sub>Une version de développement de la 0.10.2 avec un modèle de test scripté, en Full Access dans un espace de travail jetable. La modification, trois tests et une revue par un sous-agent ont réellement été exécutés.</sub>
|
||||
|
||||
@@ -42,10 +42,10 @@ curl -fsSL https://codewhale.net/install.sh | sh
|
||||
L’installeur place `codewhale` et son alias court `codew` dans `~/.local/bin`,
|
||||
après vérification de leur somme de contrôle. Si votre shell répond ensuite
|
||||
`command not found`, exécutez la ligne PATH qu’affiche l’installeur
|
||||
([détails](docs/INSTALL.md#put-it-on-your-path)). `codewhale update` le met à
|
||||
([détails](../INSTALL.md#put-it-on-your-path)). `codewhale update` le met à
|
||||
jour. Ces commandes installent la dernière version publiée. Cette page suit
|
||||
`main` : une fonctionnalité marquée d’un numéro de version arrive avec cette
|
||||
version, et le [journal des modifications](CHANGELOG.md) liste ce qu’apporte
|
||||
version, et le [journal des modifications](../../CHANGELOG.md) liste ce qu’apporte
|
||||
chaque version.
|
||||
|
||||
<details>
|
||||
@@ -60,8 +60,8 @@ cargo install codewhale-cli --locked # crates.io; can trail GitHub Releases
|
||||
Des binaires précompilés sont fournis pour Linux, macOS et Windows, en x64 et
|
||||
arm64. Nix, Homebrew sous Linux, Android/Termux (préversion) et les
|
||||
téléchargements manuels sont décrits dans le
|
||||
[guide d’installation](docs/INSTALL.md), et les conteneurs dans
|
||||
[Docker](docs/DOCKER.md). Tenez-vous-en à une seule méthode d’installation par
|
||||
[guide d’installation](../INSTALL.md), et les conteneurs dans
|
||||
[Docker](../DOCKER.md). Tenez-vous-en à une seule méthode d’installation par
|
||||
machine ; sinon, deux copies se retrouvent dans le `PATH` et c’est la première
|
||||
trouvée qui l’emporte.
|
||||
|
||||
@@ -111,7 +111,7 @@ Une nouvelle installation démarre en mode Work avec la permission Ask.
|
||||
| Mode | `Tab` (quand la saisie est vide) ou `/mode` | **Plan** lit et effectue des recherches, mais ne modifie rien. **Work** modifie des fichiers et exécute des commandes. **Operate** a les mêmes accès que Work, traite votre demande comme un objectif et continue jusqu’à ce que l’objectif soit vérifié ou qu’il ait besoin d’une réponse de votre part. |
|
||||
| Permission | `Shift+Tab` | **Ask** applique sans demander les modifications de fichiers dans votre dépôt et demande avant les commandes shell qui ne sont pas en lecture seule. **Auto-Review** laisse des règles et un modèle de revue approuver les appels courants et refuse ceux à haut risque ; passez en Ask pour les approuver vous-même. **Full Access** ne demande jamais et désactive le bac à sable de Codewhale ; les règles du dépôt et la politique gérée s’appliquent toujours. |
|
||||
|
||||
Le [guide des modes et des permissions](docs/MODES.md) donne les détails.
|
||||
Le [guide des modes et des permissions](../MODES.md) donne les détails.
|
||||
|
||||
## Ce qu’il fait
|
||||
|
||||
@@ -146,13 +146,13 @@ Google, Mistral, Moonshot, OpenRouter et xAI. Tout point d’accès compatible
|
||||
OpenAI fonctionne, tout comme les modèles locaux via Ollama, vLLM ou SGLang.
|
||||
Le modèle par défaut est `deepseek-flash` de DeepSeek, que DeepSeek a fait
|
||||
passer à DeepSeek-V4.1-Flash-1017 le 2026-10-17 ; la 0.10.1 l’exécute sans
|
||||
mise à jour ([détails](docs/PROVIDERS.md#deepseek-v41-flash)).
|
||||
mise à jour ([détails](../PROVIDERS.md#deepseek-v41-flash)).
|
||||
|
||||
`/model` change de modèle entre deux tours, et `/model auto` en choisit un pour
|
||||
chaque tour (`/router` permet de régler comment). `/turn inspect` montre quel
|
||||
modèle un tour a utilisé, ce qu’il a coûté et combien de temps il a pris.
|
||||
`codewhale auth chatgpt` vous permet d’utiliser un abonnement ChatGPT au lieu
|
||||
d’une clé API (expérimental). Voir [Fournisseurs](docs/PROVIDERS.md).
|
||||
d’une clé API (expérimental). Voir [Fournisseurs](../PROVIDERS.md).
|
||||
|
||||
### Reçus et annulation
|
||||
|
||||
@@ -163,7 +163,7 @@ annule votre dernière demande ; dans la 0.10.1, il nécessite `/trust on` pour
|
||||
les fichiers et revient en arrière d’un appel d’outil à la fois. `/restore`
|
||||
ramène tout l’espace de travail à un instantané antérieur ; comme cela écrase
|
||||
les modifications ultérieures, il faut `/trust on` ou Full Access. Voir
|
||||
[Reçus](docs/RECEIPTS.md).
|
||||
[Reçus](../RECEIPTS.md).
|
||||
|
||||
Les exécutions d’exec qui proposent des outils sont enregistrées dans tous les
|
||||
formats de sortie ; `codewhale receipts --last` fonctionne donc après
|
||||
@@ -176,9 +176,9 @@ pour `exec --continue`.
|
||||
### Travail de longue durée
|
||||
|
||||
`/goal` fixe un objectif qui se maintient d’un tour à l’autre. Codewhale peut
|
||||
répartir le travail entre des [sous-agents](docs/SUBAGENTS.md), faire tourner
|
||||
une [flotte](docs/FLEET.md) d’agents ou suivre un
|
||||
[workflow](docs/WORKFLOW_AUTHORING.md) versionné dans le dépôt.
|
||||
répartir le travail entre des [sous-agents](../SUBAGENTS.md), faire tourner
|
||||
une [flotte](../FLEET.md) d’agents ou suivre un
|
||||
[workflow](../WORKFLOW_AUTHORING.md) versionné dans le dépôt.
|
||||
|
||||
### Venir d’un autre agent
|
||||
|
||||
@@ -187,26 +187,26 @@ d’autres outils, comme `CLAUDE.md`, `.cursorrules` ou
|
||||
`.github/copilot-instructions.md`, ne sont chargés que si vous l’activez
|
||||
explicitement avec `project_instruction_imports = ["claude"]` (ou `"cursor"`,
|
||||
`"cline"`, `"windsurf"`, `"copilot"`, `"all"`) dans votre configuration ; voir
|
||||
[config.example.toml](config.example.toml). Codewhale vous avertit lorsqu’il en
|
||||
[config.example.toml](../../config.example.toml). Codewhale vous avertit lorsqu’il en
|
||||
trouve un qu’il n’a pas chargé.
|
||||
|
||||
`/import-claude` prépare une importation de vos paramètres Claude Code et de vos
|
||||
serveurs MCP, pour que vous la vérifiiez. `/plugin install` accepte les plugins
|
||||
Claude Code contenant des skills, des commandes, des profils d’agent et des
|
||||
serveurs MCP, et refuse ceux qui ont besoin de hooks ou de serveurs LSP
|
||||
([détails](docs/CLAUDE_PLUGIN_COMPAT.md)).
|
||||
([détails](../CLAUDE_PLUGIN_COMPAT.md)).
|
||||
|
||||
### Extensions
|
||||
|
||||
Connectez des [serveurs MCP](docs/MCP.md), ajoutez des [skills](docs/SKILLS.md)
|
||||
et des [plugins](docs/PLUGINS.md), et exécutez des [hooks](docs/HOOKS.md) sur
|
||||
Connectez des [serveurs MCP](../MCP.md), ajoutez des [skills](../SKILLS.md)
|
||||
et des [plugins](../PLUGINS.md), et exécutez des [hooks](../HOOKS.md) sur
|
||||
les événements de session et d’outil. Le mode code (expérimental, activé par
|
||||
défaut) permet au modèle d’écrire un seul programme `execute_tools` qui appelle
|
||||
plusieurs outils MCP et de plugins ; chaque appel reste soumis à vos règles
|
||||
d’approbation et conserve son reçu. Le plugin Computer Use fourni
|
||||
(expérimental, macOS uniquement) peut observer et utiliser d’autres
|
||||
applications. Il reste désactivé tant que vous n’avez pas examiné ses accès et
|
||||
ne l’avez pas activé ([guide](crates/tui/plugins/computer-use/README.md)).
|
||||
ne l’avez pas activé ([guide](../../crates/tui/plugins/computer-use/README.md)).
|
||||
|
||||
## Façons de l’exécuter
|
||||
|
||||
@@ -214,13 +214,13 @@ ne l’avez pas activé ([guide](crates/tui/plugins/computer-use/README.md)).
|
||||
| --- | --- |
|
||||
| `codewhale` | L’application interactive dans le terminal |
|
||||
| `codewhale exec "…"` | Une tâche sans l’interface. Sans option, il répond sans utiliser d’outils ; `--auto` active les outils avec Full Access par défaut, `--sandbox workspace-write` les restreint, et `--output-format stream-json` diffuse les événements en JSON |
|
||||
| `codewhale web` | Une interface web locale sur `127.0.0.1` ([guide](docs/WEB.md)) |
|
||||
| `codewhale review --pr N` | Une revue consultative d’une pull request GitHub. Elle ne publie rien sauf si vous ajoutez `--post` ; la [GitHub Action](docs/GITHUB_ACTION.md) exécute la même revue en CI |
|
||||
| `codewhale app-server --http` | La [Runtime API](docs/RUNTIME_API.md), une API HTTP locale pour les fils, les événements, les approbations et les modifications de fichiers de chaque tour |
|
||||
| `codewhale web` | Une interface web locale sur `127.0.0.1` ([guide](../WEB.md)) |
|
||||
| `codewhale review --pr N` | Une revue consultative d’une pull request GitHub. Elle ne publie rien sauf si vous ajoutez `--post` ; la [GitHub Action](../GITHUB_ACTION.md) exécute la même revue en CI |
|
||||
| `codewhale app-server --http` | La [Runtime API](../RUNTIME_API.md), une API HTTP locale pour les fils, les événements, les approbations et les modifications de fichiers de chaque tour |
|
||||
| `codewhale serve --acp` | L’Agent Client Protocol sur stdio, pour des éditeurs comme Zed |
|
||||
|
||||
L’application de terminal, `exec`, `web` et la Runtime API partagent un seul
|
||||
moteur ([architecture](docs/ARCHITECTURE.md)). Une
|
||||
moteur ([architecture](../ARCHITECTURE.md)). Une
|
||||
[extension VS Code](https://marketplace.visualstudio.com/items?itemName=HengQuWorld.brotherwhale-vscode)
|
||||
maintenue par la communauté s’y connecte depuis la barre latérale
|
||||
([source](https://github.com/HengQuWorld/CodeWhale-VSCode)). Une application de
|
||||
@@ -258,26 +258,26 @@ de dépôts, ni d’informations d’identification.
|
||||
`codewhale config set telemetry false` la désactive. Au démarrage, Codewhale
|
||||
vérifie aussi sur GitHub si une nouvelle version est disponible ; définissez
|
||||
`CODEWHALE_NO_UPDATE_CHECK=1` pour l’éviter. Pour en savoir plus :
|
||||
[ordre d’autorisation](docs/AUTHORIZATION_ORDER.md),
|
||||
[bac à sable](docs/SANDBOX.md) et [télémétrie](docs/TELEMETRY.md).
|
||||
[ordre d’autorisation](../AUTHORIZATION_ORDER.md),
|
||||
[bac à sable](../SANDBOX.md) et [télémétrie](../TELEMETRY.md).
|
||||
|
||||
## Documentation
|
||||
|
||||
| Pour commencer | Référence |
|
||||
| --- | --- |
|
||||
| [Installation](docs/INSTALL.md) | [Configuration](docs/CONFIGURATION.md) |
|
||||
| [Fournisseurs et modèles locaux](docs/PROVIDERS.md) | [Architecture](docs/ARCHITECTURE.md) |
|
||||
| [Modes et permissions](docs/MODES.md) | [Runtime API](docs/RUNTIME_API.md) |
|
||||
| [Raccourcis clavier](docs/KEYBINDINGS.md) | [Création de plugins](docs/PLUGIN_AUTHORING.md) |
|
||||
| [Revue de PR GitHub](docs/GITHUB_ACTION.md) | [Toute la documentation](docs/README.md) |
|
||||
| [Installation](../INSTALL.md) | [Configuration](../CONFIGURATION.md) |
|
||||
| [Fournisseurs et modèles locaux](../PROVIDERS.md) | [Architecture](../ARCHITECTURE.md) |
|
||||
| [Modes et permissions](../MODES.md) | [Runtime API](../RUNTIME_API.md) |
|
||||
| [Raccourcis clavier](../KEYBINDINGS.md) | [Création de plugins](../PLUGIN_AUTHORING.md) |
|
||||
| [Revue de PR GitHub](../GITHUB_ACTION.md) | [Toute la documentation](../README.md) |
|
||||
|
||||
## Communauté
|
||||
|
||||
S’il manque un fournisseur ou si un workflow est peu pratique,
|
||||
[ouvrez une issue](https://github.com/codewhale-hq/CodeWhale/issues/new/choose) ou
|
||||
[envoyez une pull request](CONTRIBUTING.md). Les personnes qui contribuent
|
||||
[envoyez une pull request](../../CONTRIBUTING.md). Les personnes qui contribuent
|
||||
restent créditées pour le travail intégré, et
|
||||
l’[organisation du dépôt](CONTRIBUTING.md#project-structure) montre où se trouve
|
||||
l’[organisation du dépôt](../../CONTRIBUTING.md#project-structure) montre où se trouve
|
||||
chaque chose.
|
||||
|
||||
Discutez sur [Discord](https://discord.gg/37gfS3ksug), ou ajoutez le mainteneur,
|
||||
@@ -289,9 +289,9 @@ Brothers.
|
||||
Codewhale a commencé sous le nom de `deepseek-tui` et lit toujours la
|
||||
configuration et les sessions de ce projet. Il est maintenu de manière
|
||||
indépendante et n’est affilié ni à DeepSeek ni à aucun autre fournisseur de
|
||||
modèles. Merci à [toutes les personnes qui ont contribué](docs/CONTRIBUTORS.md).
|
||||
modèles. Merci à [toutes les personnes qui ont contribué](../CONTRIBUTORS.md).
|
||||
|
||||
[](docs/CONTRIBUTORS.md#everyone)
|
||||
[](../CONTRIBUTORS.md#everyone)
|
||||
|
||||
[MIT](LICENSE). Le code adapté d’autres projets open source est répertorié dans
|
||||
les [mentions tierces](docs/THIRD_PARTY_NOTICES.md).
|
||||
[MIT](../../LICENSE). Le code adapté d’autres projets open source est répertorié dans
|
||||
les [mentions tierces](../THIRD_PARTY_NOTICES.md).
|
||||
@@ -1,9 +1,9 @@
|
||||
<!-- source: README.md sha256:182e239fcdf7 -->
|
||||
<!-- source: README.md sha256:7e0946fcaecd -->
|
||||
<div align="center">
|
||||
|
||||
<picture>
|
||||
<source media="(prefers-color-scheme: dark)" srcset="brand/wordmark-inverted.svg">
|
||||
<img src="brand/wordmark.svg" alt="Codewhale" width="320">
|
||||
<source media="(prefers-color-scheme: dark)" srcset="../../brand/wordmark-inverted.svg">
|
||||
<img src="../../brand/wordmark.svg" alt="Codewhale" width="320">
|
||||
</picture>
|
||||
|
||||
**आपके टर्मिनल के लिए एक ओपन सोर्स कोडिंग एजेंट, जो किसी भी मॉडल के साथ काम करता है।**
|
||||
@@ -17,14 +17,14 @@ Codewhale को कोई काम दें, और वह रिपॉज़
|
||||
[](https://github.com/codewhale-hq/CodeWhale/actions/workflows/ci.yml)
|
||||
[](https://crates.io/crates/codewhale-cli)
|
||||
[](https://www.npmjs.com/package/codewhale)
|
||||
[](LICENSE)
|
||||
[](../../LICENSE)
|
||||
[](https://discord.gg/37gfS3ksug)
|
||||
|
||||
[वेबसाइट](https://codewhale.net) · [दस्तावेज़](docs/README.md) · [बदलावों की सूची](CHANGELOG.md) · [योगदान](CONTRIBUTING.md)
|
||||
[वेबसाइट](https://codewhale.net) · [दस्तावेज़](../README.md) · [बदलावों की सूची](../../CHANGELOG.md) · [योगदान](../../CONTRIBUTING.md)
|
||||
|
||||
[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) · [Türkçe](README.tr.md) · [Italiano](README.it.md) · [Polski](README.pl.md) · [العربية](README.ar.md) · [Català](README.ca.md)
|
||||
[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) · [Türkçe](README.tr.md) · [Italiano](README.it.md) · [Polski](README.pl.md) · [العربية](README.ar.md) · [Català](README.ca.md)
|
||||
|
||||
<img src="web/public/codewhale-tui-0102-demo.png" alt="Codewhale का एक टर्मिनल सेशन" width="760">
|
||||
<img src="../../web/public/codewhale-tui-0102-demo.png" alt="Codewhale का एक टर्मिनल सेशन" width="760">
|
||||
|
||||
<sub>0.10.2 का एक डेवलपमेंट बिल्ड, स्क्रिप्टेड टेस्ट मॉडल के साथ, एक अस्थायी वर्कस्पेस के भीतर Full Access में। संपादन, तीन टेस्ट और एक सब-एजेंट समीक्षा सचमुच चलीं।</sub>
|
||||
|
||||
@@ -40,10 +40,10 @@ curl -fsSL https://codewhale.net/install.sh | sh
|
||||
|
||||
इंस्टॉलर चेकसम से सत्यापित `codewhale` और उसका छोटा उपनाम `codew` `~/.local/bin` में
|
||||
रखता है। अगर इसके बाद आपका शेल `command not found` कहे, तो इंस्टॉलर जो PATH लाइन
|
||||
प्रिंट करता है, उसे चलाएँ ([विवरण](docs/INSTALL.md#put-it-on-your-path))।
|
||||
प्रिंट करता है, उसे चलाएँ ([विवरण](../INSTALL.md#put-it-on-your-path))।
|
||||
`codewhale update` इसे अपग्रेड करता है। ये कमांड नवीनतम रिलीज़ इंस्टॉल करती हैं।
|
||||
यह पेज `main` के अनुसार चलता है, इसलिए जिस फ़ीचर पर कोई संस्करण लिखा है, वह उसी रिलीज़
|
||||
में आता है; [बदलावों की सूची](CHANGELOG.md) बताती है कि हर रिलीज़ में क्या जुड़ा।
|
||||
में आता है; [बदलावों की सूची](../../CHANGELOG.md) बताती है कि हर रिलीज़ में क्या जुड़ा।
|
||||
|
||||
<details>
|
||||
<summary><b>Windows, npm, Cargo और इंस्टॉल करने के अन्य तरीके</b></summary>
|
||||
@@ -56,7 +56,7 @@ cargo install codewhale-cli --locked # crates.io; can trail GitHub Releases
|
||||
|
||||
पहले से बनी बाइनरी x64 और arm64 पर Linux, macOS और Windows के लिए उपलब्ध हैं। Nix,
|
||||
Linux पर Homebrew, Android/Termux (प्रीव्यू) और मैन्युअल डाउनलोड
|
||||
[इंस्टॉलेशन गाइड](docs/INSTALL.md) में हैं, और कंटेनर [Docker](docs/DOCKER.md) में।
|
||||
[इंस्टॉलेशन गाइड](../INSTALL.md) में हैं, और कंटेनर [Docker](../DOCKER.md) में।
|
||||
हर मशीन पर इंस्टॉल का एक ही तरीका अपनाएँ; वरना `PATH` पर दो कॉपी हो जाती हैं और जो
|
||||
पहले आती है, वही चलती है।
|
||||
|
||||
@@ -102,7 +102,7 @@ codewhale exec --auto --sandbox workspace-write "fix the failing tests and expla
|
||||
| मोड | `Tab` (जब इनपुट खाली हो) या `/mode` | **Plan** पढ़ता और खोजता है, पर कुछ नहीं बदलता। **Work** फ़ाइलें संपादित करता है और कमांड चलाता है। **Operate** के पास Work जितना ही एक्सेस है; यह आपके अनुरोध को एक लक्ष्य मानता है और तब तक चलता रहता है जब तक लक्ष्य सत्यापित न हो जाए या उसे आपसे इनपुट की ज़रूरत न पड़े। |
|
||||
| अनुमति | `Shift+Tab` | **Ask** आपकी रिपॉज़िटरी में फ़ाइल संपादन बिना पूछे लागू करता है और जो शेल कमांड read-only नहीं हैं, उनसे पहले पूछता है। **Auto-Review** नियमों और एक समीक्षक मॉडल को सामान्य कॉल मंज़ूर करने देता है और उच्च जोखिम वाली कॉल मना कर देता है; उन्हें खुद मंज़ूर करने के लिए Ask पर जाएँ। **Full Access** कभी नहीं पूछता और Codewhale का सैंडबॉक्स बंद कर देता है; रिपॉज़िटरी के नियम और प्रबंधित नीति (managed policy) फिर भी लागू रहते हैं। |
|
||||
|
||||
विवरण के लिए [मोड और अनुमतियों की गाइड](docs/MODES.md) देखें।
|
||||
विवरण के लिए [मोड और अनुमतियों की गाइड](../MODES.md) देखें।
|
||||
|
||||
## यह क्या करता है
|
||||
|
||||
@@ -132,13 +132,13 @@ Mistral, Moonshot, OpenRouter और xAI शामिल हैं। कोई
|
||||
है, और Ollama, vLLM या SGLang के ज़रिए लोकल मॉडल भी। डिफ़ॉल्ट मॉडल DeepSeek का
|
||||
`deepseek-flash` है, जिसे DeepSeek ने 2026-10-17 को DeepSeek-V4.1-Flash-1017 पर
|
||||
कर दिया; 0.10.1 इसे बिना अपडेट के चलाता है
|
||||
([विवरण](docs/PROVIDERS.md#deepseek-v41-flash))।
|
||||
([विवरण](../PROVIDERS.md#deepseek-v41-flash))।
|
||||
|
||||
`/model` टर्न के बीच मॉडल बदलता है, और `/model auto` हर टर्न के लिए एक मॉडल चुनता है
|
||||
(`/router` तय करता है कि कैसे)। `/turn inspect` दिखाता है कि किसी टर्न ने कौन-सा मॉडल
|
||||
इस्तेमाल किया, उस पर कितना खर्च हुआ और उसमें कितना समय लगा। `codewhale auth chatgpt`
|
||||
से आप API कुंजी के बजाय ChatGPT प्लान इस्तेमाल कर सकते हैं (प्रायोगिक)।
|
||||
[प्रोवाइडर](docs/PROVIDERS.md) देखें।
|
||||
[प्रोवाइडर](../PROVIDERS.md) देखें।
|
||||
|
||||
### रसीदें और पूर्ववत करना
|
||||
|
||||
@@ -148,7 +148,7 @@ Mistral, Moonshot, OpenRouter और xAI शामिल हैं। कोई
|
||||
के लिए इसे `/trust on` चाहिए और यह एक बार में एक टूल कॉल पीछे जाता है। `/restore` पूरे
|
||||
वर्कस्पेस को किसी पिछले स्नैपशॉट पर वापस ले जाता है; क्योंकि इससे बाद के संपादन
|
||||
ओवरराइट हो जाते हैं, इसके लिए `/trust on` या Full Access चाहिए।
|
||||
[रसीदें](docs/RECEIPTS.md) देखें।
|
||||
[रसीदें](../RECEIPTS.md) देखें।
|
||||
|
||||
जिन exec रन में टूल उपलब्ध होते हैं, वे हर आउटपुट फ़ॉर्मैट में सहेजे जाते हैं, इसलिए
|
||||
`codewhale receipts --last`, `exec --auto` के बाद काम करता है, `--json` के साथ भी।
|
||||
@@ -159,8 +159,8 @@ Mistral, Moonshot, OpenRouter और xAI शामिल हैं। कोई
|
||||
### लंबे काम
|
||||
|
||||
`/goal` एक ऐसा उद्देश्य तय करता है जो कई टर्न तक बना रहता है। Codewhale काम को
|
||||
[सब-एजेंटों](docs/SUBAGENTS.md) में बाँट सकता है, एजेंटों का एक [fleet](docs/FLEET.md)
|
||||
चला सकता है, या रिपॉज़िटरी में रखे किसी [वर्कफ़्लो](docs/WORKFLOW_AUTHORING.md) का
|
||||
[सब-एजेंटों](../SUBAGENTS.md) में बाँट सकता है, एजेंटों का एक [fleet](../FLEET.md)
|
||||
चला सकता है, या रिपॉज़िटरी में रखे किसी [वर्कफ़्लो](../WORKFLOW_AUTHORING.md) का
|
||||
पालन कर सकता है।
|
||||
|
||||
### किसी दूसरे एजेंट से आ रहे हैं
|
||||
@@ -169,23 +169,23 @@ Codewhale `AGENTS.md` अपने-आप पढ़ता है। दूसर
|
||||
`CLAUDE.md`, `.cursorrules` या `.github/copilot-instructions.md`, तभी लोड होती हैं जब
|
||||
आप अपने कॉन्फ़िग में `project_instruction_imports = ["claude"]` (या `"cursor"`,
|
||||
`"cline"`, `"windsurf"`, `"copilot"`, `"all"`) से इन्हें चालू करते हैं;
|
||||
[config.example.toml](config.example.toml) देखें। जब Codewhale को ऐसी कोई फ़ाइल
|
||||
[config.example.toml](../../config.example.toml) देखें। जब Codewhale को ऐसी कोई फ़ाइल
|
||||
मिलती है जिसे उसने लोड नहीं किया, तो वह चेतावनी देता है।
|
||||
|
||||
`/import-claude` आपकी Claude Code सेटिंग और MCP सर्वर का इंपोर्ट तैयार करता है, ताकि
|
||||
आप उसकी समीक्षा कर सकें। `/plugin install` ऐसे Claude Code प्लगइन स्वीकार करता है
|
||||
जिनमें स्किल, कमांड, एजेंट प्रोफ़ाइल और MCP सर्वर हों, और उन प्लगइन को मना कर देता है
|
||||
जिन्हें हुक या LSP सर्वर चाहिए ([विवरण](docs/CLAUDE_PLUGIN_COMPAT.md))।
|
||||
जिन्हें हुक या LSP सर्वर चाहिए ([विवरण](../CLAUDE_PLUGIN_COMPAT.md))।
|
||||
|
||||
### एक्सटेंशन
|
||||
|
||||
[MCP सर्वर](docs/MCP.md) कनेक्ट करें, [स्किल](docs/SKILLS.md) और
|
||||
[प्लगइन](docs/PLUGINS.md) जोड़ें, और सेशन व टूल इवेंट पर [हुक](docs/HOOKS.md) चलाएँ।
|
||||
[MCP सर्वर](../MCP.md) कनेक्ट करें, [स्किल](../SKILLS.md) और
|
||||
[प्लगइन](../PLUGINS.md) जोड़ें, और सेशन व टूल इवेंट पर [हुक](../HOOKS.md) चलाएँ।
|
||||
Code mode (प्रायोगिक, डिफ़ॉल्ट रूप से चालू) मॉडल को एक ऐसा `execute_tools` प्रोग्राम
|
||||
लिखने देता है जो कई MCP और प्लगइन टूल कॉल करता है; हर कॉल फिर भी आपके अनुमोदन नियमों
|
||||
से गुज़रती है और उसकी रसीद बनी रहती है। साथ आने वाला Computer Use प्लगइन (प्रायोगिक, केवल macOS) दूसरे ऐप देख और चला सकता
|
||||
है। जब तक आप उसके एक्सेस की समीक्षा करके उसे सक्षम नहीं करते, वह बंद रहता है
|
||||
([गाइड](crates/tui/plugins/computer-use/README.md))।
|
||||
([गाइड](../../crates/tui/plugins/computer-use/README.md))।
|
||||
|
||||
## इसे चलाने के तरीके
|
||||
|
||||
@@ -193,13 +193,13 @@ Code mode (प्रायोगिक, डिफ़ॉल्ट रूप स
|
||||
| --- | --- |
|
||||
| `codewhale` | इंटरैक्टिव टर्मिनल ऐप |
|
||||
| `codewhale exec "…"` | बिना इंटरफ़ेस के एक काम। अकेले चलाने पर यह टूल का इस्तेमाल किए बिना जवाब देता है; `--auto` डिफ़ॉल्ट रूप से Full Access के साथ टूल चालू करता है, `--sandbox workspace-write` उन्हें सीमित करता है, और `--output-format stream-json` इवेंट को JSON के रूप में स्ट्रीम करता है |
|
||||
| `codewhale web` | `127.0.0.1` पर एक लोकल वेब UI ([गाइड](docs/WEB.md)) |
|
||||
| `codewhale review --pr N` | किसी GitHub pull request की सलाह के तौर पर समीक्षा। जब तक आप `--post` न जोड़ें, यह कुछ पोस्ट नहीं करता; [GitHub Action](docs/GITHUB_ACTION.md) यही समीक्षा CI में चलाता है |
|
||||
| `codewhale app-server --http` | [Runtime API](docs/RUNTIME_API.md), थ्रेड, इवेंट, अनुमोदन और हर टर्न के फ़ाइल बदलावों के लिए एक लोकल HTTP API |
|
||||
| `codewhale web` | `127.0.0.1` पर एक लोकल वेब UI ([गाइड](../WEB.md)) |
|
||||
| `codewhale review --pr N` | किसी GitHub pull request की सलाह के तौर पर समीक्षा। जब तक आप `--post` न जोड़ें, यह कुछ पोस्ट नहीं करता; [GitHub Action](../GITHUB_ACTION.md) यही समीक्षा CI में चलाता है |
|
||||
| `codewhale app-server --http` | [Runtime API](../RUNTIME_API.md), थ्रेड, इवेंट, अनुमोदन और हर टर्न के फ़ाइल बदलावों के लिए एक लोकल HTTP API |
|
||||
| `codewhale serve --acp` | stdio पर Agent Client Protocol, Zed जैसे एडिटर के लिए |
|
||||
|
||||
टर्मिनल ऐप, `exec`, `web` और Runtime API एक ही इंजन साझा करते हैं
|
||||
([आर्किटेक्चर](docs/ARCHITECTURE.md))। समुदाय द्वारा अनुरक्षित एक
|
||||
([आर्किटेक्चर](../ARCHITECTURE.md))। समुदाय द्वारा अनुरक्षित एक
|
||||
[VS Code एक्सटेंशन](https://marketplace.visualstudio.com/items?itemName=HengQuWorld.brotherwhale-vscode)
|
||||
साइडबार से इससे जुड़ता है ([सोर्स](https://github.com/HengQuWorld/CodeWhale-VSCode))।
|
||||
Runtime API पर बने एक नेटिव डेस्कटॉप ऐप पर काम चल रहा है; उसका अभी कोई सार्वजनिक
|
||||
@@ -229,25 +229,25 @@ OS सैंडबॉक्स नहीं है, और Full Access सैं
|
||||
कोड, प्रॉम्प्ट, मॉडल के नाम, फ़ाइल या रिपॉज़िटरी के नाम, या क्रेडेंशियल नहीं भेजती। `codewhale config set telemetry false` इसे बंद कर
|
||||
देता है। शुरू होते समय Codewhale नई रिलीज़ के लिए GitHub भी जाँचता है; इसे छोड़ने के
|
||||
लिए `CODEWHALE_NO_UPDATE_CHECK=1` सेट करें। ज़्यादा जानकारी
|
||||
[अधिकार क्रम](docs/AUTHORIZATION_ORDER.md), [सैंडबॉक्सिंग](docs/SANDBOX.md) और
|
||||
[टेलीमेट्री](docs/TELEMETRY.md) में है।
|
||||
[अधिकार क्रम](../AUTHORIZATION_ORDER.md), [सैंडबॉक्सिंग](../SANDBOX.md) और
|
||||
[टेलीमेट्री](../TELEMETRY.md) में है।
|
||||
|
||||
## दस्तावेज़
|
||||
|
||||
| यहाँ से शुरू करें | संदर्भ |
|
||||
| --- | --- |
|
||||
| [इंस्टॉलेशन](docs/INSTALL.md) | [कॉन्फ़िगरेशन](docs/CONFIGURATION.md) |
|
||||
| [प्रोवाइडर और लोकल मॉडल](docs/PROVIDERS.md) | [आर्किटेक्चर](docs/ARCHITECTURE.md) |
|
||||
| [मोड और अनुमतियाँ](docs/MODES.md) | [Runtime API](docs/RUNTIME_API.md) |
|
||||
| [कीबाइंडिंग](docs/KEYBINDINGS.md) | [प्लगइन लेखन](docs/PLUGIN_AUTHORING.md) |
|
||||
| [GitHub PR समीक्षा](docs/GITHUB_ACTION.md) | [सभी दस्तावेज़](docs/README.md) |
|
||||
| [इंस्टॉलेशन](../INSTALL.md) | [कॉन्फ़िगरेशन](../CONFIGURATION.md) |
|
||||
| [प्रोवाइडर और लोकल मॉडल](../PROVIDERS.md) | [आर्किटेक्चर](../ARCHITECTURE.md) |
|
||||
| [मोड और अनुमतियाँ](../MODES.md) | [Runtime API](../RUNTIME_API.md) |
|
||||
| [कीबाइंडिंग](../KEYBINDINGS.md) | [प्लगइन लेखन](../PLUGIN_AUTHORING.md) |
|
||||
| [GitHub PR समीक्षा](../GITHUB_ACTION.md) | [सभी दस्तावेज़](../README.md) |
|
||||
|
||||
## समुदाय
|
||||
|
||||
अगर कोई प्रोवाइडर मौजूद नहीं है या कोई वर्कफ़्लो असहज है, तो
|
||||
[issue खोलें](https://github.com/codewhale-hq/CodeWhale/issues/new/choose) या
|
||||
[pull request भेजें](CONTRIBUTING.md)। मर्ज होने वाले काम का श्रेय योगदानकर्ताओं के
|
||||
पास रहता है, और [रिपॉज़िटरी की संरचना](CONTRIBUTING.md#project-structure) बताती है कि
|
||||
[pull request भेजें](../../CONTRIBUTING.md)। मर्ज होने वाले काम का श्रेय योगदानकर्ताओं के
|
||||
पास रहता है, और [रिपॉज़िटरी की संरचना](../../CONTRIBUTING.md#project-structure) बताती है कि
|
||||
कौन-सी चीज़ कहाँ है।
|
||||
|
||||
[Discord](https://discord.gg/37gfS3ksug) पर बात करें, या WeChat पर मेंटेनर Hunter
|
||||
@@ -258,9 +258,9 @@ OS सैंडबॉक्स नहीं है, और Full Access सैं
|
||||
Codewhale की शुरुआत `deepseek-tui` के रूप में हुई थी और यह आज भी उस प्रोजेक्ट का
|
||||
कॉन्फ़िगरेशन और सेशन पढ़ता है। यह स्वतंत्र रूप से अनुरक्षित है और DeepSeek या किसी भी
|
||||
अन्य मॉडल प्रोवाइडर से संबद्ध नहीं है।
|
||||
[योगदान देने वाले हर व्यक्ति](docs/CONTRIBUTORS.md) का धन्यवाद।
|
||||
[योगदान देने वाले हर व्यक्ति](../CONTRIBUTORS.md) का धन्यवाद।
|
||||
|
||||
[](docs/CONTRIBUTORS.md#everyone)
|
||||
[](../CONTRIBUTORS.md#everyone)
|
||||
|
||||
[MIT](LICENSE)। अन्य ओपन सोर्स प्रोजेक्ट से अनुकूलित कोड
|
||||
[थर्ड-पार्टी नोटिस](docs/THIRD_PARTY_NOTICES.md) में सूचीबद्ध है।
|
||||
[MIT](../../LICENSE)। अन्य ओपन सोर्स प्रोजेक्ट से अनुकूलित कोड
|
||||
[थर्ड-पार्टी नोटिस](../THIRD_PARTY_NOTICES.md) में सूचीबद्ध है।
|
||||
@@ -1,9 +1,9 @@
|
||||
<!-- source: README.md sha256:182e239fcdf7 -->
|
||||
<!-- source: README.md sha256:7e0946fcaecd -->
|
||||
<div align="center">
|
||||
|
||||
<picture>
|
||||
<source media="(prefers-color-scheme: dark)" srcset="brand/wordmark-inverted.svg">
|
||||
<img src="brand/wordmark.svg" alt="Codewhale" width="320">
|
||||
<source media="(prefers-color-scheme: dark)" srcset="../../brand/wordmark-inverted.svg">
|
||||
<img src="../../brand/wordmark.svg" alt="Codewhale" width="320">
|
||||
</picture>
|
||||
|
||||
**Agen pengodean sumber terbuka untuk terminal Anda yang bekerja dengan model apa pun.**
|
||||
@@ -18,14 +18,14 @@ yang dilakukannya.
|
||||
[](https://github.com/codewhale-hq/CodeWhale/actions/workflows/ci.yml)
|
||||
[](https://crates.io/crates/codewhale-cli)
|
||||
[](https://www.npmjs.com/package/codewhale)
|
||||
[](LICENSE)
|
||||
[](../../LICENSE)
|
||||
[](https://discord.gg/37gfS3ksug)
|
||||
|
||||
[Situs web](https://codewhale.net) · [Dokumentasi](docs/README.md) · [Changelog](CHANGELOG.md) · [Berkontribusi](CONTRIBUTING.md)
|
||||
[Situs web](https://codewhale.net) · [Dokumentasi](../README.md) · [Changelog](../../CHANGELOG.md) · [Berkontribusi](../../CONTRIBUTING.md)
|
||||
|
||||
[English](README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja-JP.md) · [Tiếng Việt](README.vi.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) · [Català](README.ca.md)
|
||||
[English](../../README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja-JP.md) · [Tiếng Việt](README.vi.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) · [Català](README.ca.md)
|
||||
|
||||
<img src="web/public/codewhale-tui-0102-demo.png" alt="Sesi terminal Codewhale" width="760">
|
||||
<img src="../../web/public/codewhale-tui-0102-demo.png" alt="Sesi terminal Codewhale" width="760">
|
||||
|
||||
<sub>Build pengembangan 0.10.2 dengan model uji yang berjalan sesuai skrip, dalam Akses penuh di dalam workspace sekali pakai. Edit, tiga pengujian, dan tinjauan sub-agen benar-benar dijalankan.</sub>
|
||||
|
||||
@@ -42,10 +42,10 @@ curl -fsSL https://codewhale.net/install.sh | sh
|
||||
Installer menaruh `codewhale` dan alias pendeknya `codew`, yang checksum-nya
|
||||
sudah diverifikasi, di `~/.local/bin`. Jika setelah itu shell Anda menampilkan
|
||||
`command not found`, jalankan baris PATH yang dicetak installer
|
||||
([detail](docs/INSTALL.md#put-it-on-your-path)). `codewhale update`
|
||||
([detail](../INSTALL.md#put-it-on-your-path)). `codewhale update`
|
||||
memperbaruinya. Perintah-perintah ini memasang rilis terbaru. Halaman ini
|
||||
mengikuti `main`, jadi fitur yang ditandai dengan versi akan hadir di rilis
|
||||
tersebut; [changelog](CHANGELOG.md) mencantumkan apa yang ditambahkan setiap
|
||||
tersebut; [changelog](../../CHANGELOG.md) mencantumkan apa yang ditambahkan setiap
|
||||
rilis.
|
||||
|
||||
<details>
|
||||
@@ -59,8 +59,8 @@ cargo install codewhale-cli --locked # crates.io; can trail GitHub Releases
|
||||
|
||||
Biner siap pakai tersedia untuk Linux, macOS, dan Windows di x64 dan arm64. Nix,
|
||||
Homebrew di Linux, Android/Termux (pratinjau), dan unduhan manual dibahas di
|
||||
[panduan instalasi](docs/INSTALL.md), sedangkan container di
|
||||
[Docker](docs/DOCKER.md). Gunakan satu cara instalasi per mesin; jika tidak, dua
|
||||
[panduan instalasi](../INSTALL.md), sedangkan container di
|
||||
[Docker](../DOCKER.md). Gunakan satu cara instalasi per mesin; jika tidak, dua
|
||||
salinan akan ada di `PATH` dan yang muncul lebih dulu yang dipakai.
|
||||
|
||||
</details>
|
||||
@@ -107,7 +107,7 @@ Instalasi baru dimulai dalam mode Work dengan izin Tanya.
|
||||
| Mode | `Tab` (saat input kosong) atau `/mode` | **Plan** membaca dan mencari tetapi tidak mengubah apa pun. **Work** mengedit berkas dan menjalankan perintah. **Operate** memiliki akses yang sama dengan Work, memperlakukan permintaan Anda sebagai tujuan, dan terus berjalan sampai tujuan itu terverifikasi atau ia memerlukan masukan dari Anda. |
|
||||
| Izin | `Shift+Tab` | **Tanya** (Ask) menerapkan edit berkas di repositori Anda tanpa bertanya dan bertanya sebelum perintah shell yang bukan baca-saja. **Tinjauan otomatis** (Auto-Review) membiarkan aturan dan model peninjau menyetujui panggilan rutin dan menolak panggilan berisiko tinggi; beralihlah ke Tanya untuk menyetujuinya sendiri. **Akses penuh** (Full Access) tidak pernah bertanya dan menonaktifkan sandbox Codewhale; aturan repositori dan kebijakan terkelola tetap berlaku. |
|
||||
|
||||
Lihat [panduan mode dan izin](docs/MODES.md) untuk detailnya.
|
||||
Lihat [panduan mode dan izin](../MODES.md) untuk detailnya.
|
||||
|
||||
## Apa yang bisa dilakukan
|
||||
|
||||
@@ -142,13 +142,13 @@ kompatibel dengan OpenAI juga bisa dipakai, begitu pula model lokal melalui
|
||||
Ollama, vLLM, atau SGLang. Defaultnya adalah `deepseek-flash` dari DeepSeek,
|
||||
yang dipindahkan DeepSeek ke DeepSeek-V4.1-Flash-1017 pada 2026-10-17; 0.10.1
|
||||
menjalankannya tanpa pembaruan
|
||||
([detail](docs/PROVIDERS.md#deepseek-v41-flash)).
|
||||
([detail](../PROVIDERS.md#deepseek-v41-flash)).
|
||||
|
||||
`/model` mengganti model di antara giliran, dan `/model auto` memilih model
|
||||
untuk setiap giliran (`/router` mengatur caranya). `/turn inspect` menampilkan
|
||||
model yang dipakai sebuah giliran, biayanya, dan berapa lama prosesnya.
|
||||
`codewhale auth chatgpt` memungkinkan Anda memakai paket ChatGPT sebagai ganti
|
||||
kunci API (eksperimental). Lihat [Penyedia](docs/PROVIDERS.md).
|
||||
kunci API (eksperimental). Lihat [Penyedia](../PROVIDERS.md).
|
||||
|
||||
### Receipt dan pembatalan
|
||||
|
||||
@@ -159,7 +159,7 @@ membatalkan permintaan terakhir Anda; di 0.10.1, perintah ini memerlukan
|
||||
`/trust on` untuk berkas dan mundur satu panggilan alat setiap kali. `/restore`
|
||||
mengembalikan seluruh workspace
|
||||
ke snapshot sebelumnya; karena itu menimpa edit yang lebih baru, perintah ini
|
||||
memerlukan `/trust on` atau Akses penuh. Lihat [Receipt](docs/RECEIPTS.md).
|
||||
memerlukan `/trust on` atau Akses penuh. Lihat [Receipt](../RECEIPTS.md).
|
||||
|
||||
Eksekusi exec yang menyediakan alat disimpan dalam setiap format output, jadi
|
||||
`codewhale receipts --last` bisa dipakai setelah `exec --auto`, termasuk dengan
|
||||
@@ -171,9 +171,9 @@ saat melanjutkan percakapan atau ketika pemadatan percakapan dimulai; gunakan
|
||||
### Pekerjaan yang lebih panjang
|
||||
|
||||
`/goal` menetapkan sasaran yang berlanjut lintas giliran. Codewhale dapat
|
||||
membagi pekerjaan ke beberapa [sub-agen](docs/SUBAGENTS.md), menjalankan
|
||||
[armada](docs/FLEET.md) agen, atau mengikuti
|
||||
[workflow](docs/WORKFLOW_AUTHORING.md) yang disimpan di repositori.
|
||||
membagi pekerjaan ke beberapa [sub-agen](../SUBAGENTS.md), menjalankan
|
||||
[armada](../FLEET.md) agen, atau mengikuti
|
||||
[workflow](../WORKFLOW_AUTHORING.md) yang disimpan di repositori.
|
||||
|
||||
### Beralih dari agen lain
|
||||
|
||||
@@ -182,25 +182,25 @@ untuk alat lain, seperti `CLAUDE.md`, `.cursorrules`, atau
|
||||
`.github/copilot-instructions.md`, hanya dimuat jika Anda mengaktifkannya dengan
|
||||
`project_instruction_imports = ["claude"]` (atau `"cursor"`, `"cline"`,
|
||||
`"windsurf"`, `"copilot"`, `"all"`) di config Anda; lihat
|
||||
[config.example.toml](config.example.toml). Codewhale memberi peringatan jika
|
||||
[config.example.toml](../../config.example.toml). Codewhale memberi peringatan jika
|
||||
menemukan berkas seperti itu yang tidak dimuatnya.
|
||||
|
||||
`/import-claude` menyiapkan impor pengaturan Claude Code dan server MCP Anda
|
||||
untuk Anda tinjau. `/plugin install` menerima plugin Claude Code yang berisi
|
||||
skill, perintah, profil agen, dan server MCP, dan menolak plugin yang memerlukan
|
||||
hook atau server LSP ([detail](docs/CLAUDE_PLUGIN_COMPAT.md)).
|
||||
hook atau server LSP ([detail](../CLAUDE_PLUGIN_COMPAT.md)).
|
||||
|
||||
### Ekstensi
|
||||
|
||||
Hubungkan [server MCP](docs/MCP.md), tambahkan [skill](docs/SKILLS.md) dan
|
||||
[plugin](docs/PLUGINS.md), dan jalankan [hook](docs/HOOKS.md) pada event sesi
|
||||
Hubungkan [server MCP](../MCP.md), tambahkan [skill](../SKILLS.md) dan
|
||||
[plugin](../PLUGINS.md), dan jalankan [hook](../HOOKS.md) pada event sesi
|
||||
dan alat. Mode kode (eksperimental, aktif secara default) memungkinkan model
|
||||
menulis satu program `execute_tools` yang memanggil beberapa alat MCP dan
|
||||
plugin; setiap panggilan tetap tunduk pada aturan persetujuan Anda dan tetap
|
||||
memiliki receipt-nya. Plugin Computer Use bawaan (eksperimental, hanya macOS) dapat
|
||||
mengamati dan mengoperasikan aplikasi lain. Plugin ini tetap nonaktif sampai
|
||||
Anda meninjau aksesnya dan mengaktifkannya
|
||||
([panduan](crates/tui/plugins/computer-use/README.md)).
|
||||
([panduan](../../crates/tui/plugins/computer-use/README.md)).
|
||||
|
||||
## Cara menjalankannya
|
||||
|
||||
@@ -208,13 +208,13 @@ Anda meninjau aksesnya dan mengaktifkannya
|
||||
| --- | --- |
|
||||
| `codewhale` | Aplikasi terminal interaktif |
|
||||
| `codewhale exec "…"` | Satu tugas tanpa antarmuka. Tanpa flag tambahan, ia menjawab tanpa memakai alat; `--auto` mengaktifkan alat dengan Akses penuh secara default, `--sandbox workspace-write` membatasinya, dan `--output-format stream-json` men-streaming event sebagai JSON |
|
||||
| `codewhale web` | UI web lokal di `127.0.0.1` ([panduan](docs/WEB.md)) |
|
||||
| `codewhale review --pr N` | Tinjauan yang bersifat saran untuk pull request GitHub. Ia tidak memposting apa pun kecuali Anda menambahkan `--post`; [GitHub Action](docs/GITHUB_ACTION.md) menjalankan tinjauan yang sama di CI |
|
||||
| `codewhale app-server --http` | [Runtime API](docs/RUNTIME_API.md), API HTTP lokal untuk thread, event, persetujuan, dan perubahan berkas setiap giliran |
|
||||
| `codewhale web` | UI web lokal di `127.0.0.1` ([panduan](../WEB.md)) |
|
||||
| `codewhale review --pr N` | Tinjauan yang bersifat saran untuk pull request GitHub. Ia tidak memposting apa pun kecuali Anda menambahkan `--post`; [GitHub Action](../GITHUB_ACTION.md) menjalankan tinjauan yang sama di CI |
|
||||
| `codewhale app-server --http` | [Runtime API](../RUNTIME_API.md), API HTTP lokal untuk thread, event, persetujuan, dan perubahan berkas setiap giliran |
|
||||
| `codewhale serve --acp` | Agent Client Protocol melalui stdio, untuk editor seperti Zed |
|
||||
|
||||
Aplikasi terminal, `exec`, `web`, dan Runtime API memakai satu engine yang sama
|
||||
([arsitektur](docs/ARCHITECTURE.md)).
|
||||
([arsitektur](../ARCHITECTURE.md)).
|
||||
[Ekstensi VS Code](https://marketplace.visualstudio.com/items?itemName=HengQuWorld.brotherwhale-vscode)
|
||||
yang dipelihara komunitas terhubung ke engine itu dari sidebar
|
||||
([sumber](https://github.com/HengQuWorld/CodeWhale-VSCode)).
|
||||
@@ -249,26 +249,26 @@ repositori, maupun kredensial.
|
||||
`codewhale config set telemetry false` menonaktifkannya. Saat dijalankan,
|
||||
Codewhale juga memeriksa GitHub untuk rilis baru; atur
|
||||
`CODEWHALE_NO_UPDATE_CHECK=1` untuk melewatinya. Selengkapnya di
|
||||
[urutan otorisasi](docs/AUTHORIZATION_ORDER.md), [sandbox](docs/SANDBOX.md),
|
||||
dan [telemetri](docs/TELEMETRY.md).
|
||||
[urutan otorisasi](../AUTHORIZATION_ORDER.md), [sandbox](../SANDBOX.md),
|
||||
dan [telemetri](../TELEMETRY.md).
|
||||
|
||||
## Dokumentasi
|
||||
|
||||
| Mulai dari sini | Referensi |
|
||||
| --- | --- |
|
||||
| [Instalasi](docs/INSTALL.md) | [Konfigurasi](docs/CONFIGURATION.md) |
|
||||
| [Penyedia dan model lokal](docs/PROVIDERS.md) | [Arsitektur](docs/ARCHITECTURE.md) |
|
||||
| [Mode dan izin](docs/MODES.md) | [Runtime API](docs/RUNTIME_API.md) |
|
||||
| [Pintasan keyboard](docs/KEYBINDINGS.md) | [Penulisan plugin](docs/PLUGIN_AUTHORING.md) |
|
||||
| [Tinjauan PR GitHub](docs/GITHUB_ACTION.md) | [Seluruh dokumentasi](docs/README.md) |
|
||||
| [Instalasi](../INSTALL.md) | [Konfigurasi](../CONFIGURATION.md) |
|
||||
| [Penyedia dan model lokal](../PROVIDERS.md) | [Arsitektur](../ARCHITECTURE.md) |
|
||||
| [Mode dan izin](../MODES.md) | [Runtime API](../RUNTIME_API.md) |
|
||||
| [Pintasan keyboard](../KEYBINDINGS.md) | [Penulisan plugin](../PLUGIN_AUTHORING.md) |
|
||||
| [Tinjauan PR GitHub](../GITHUB_ACTION.md) | [Seluruh dokumentasi](../README.md) |
|
||||
|
||||
## Komunitas
|
||||
|
||||
Jika ada penyedia yang belum tersedia atau alur kerja yang terasa canggung,
|
||||
[buka issue](https://github.com/codewhale-hq/CodeWhale/issues/new/choose) atau
|
||||
[kirim pull request](CONTRIBUTING.md). Kontributor tetap mendapat kredit atas
|
||||
[kirim pull request](../../CONTRIBUTING.md). Kontributor tetap mendapat kredit atas
|
||||
pekerjaan yang digabungkan, dan
|
||||
[struktur repositori](CONTRIBUTING.md#project-structure) menunjukkan letak
|
||||
[struktur repositori](../../CONTRIBUTING.md#project-structure) menunjukkan letak
|
||||
setiap bagian.
|
||||
|
||||
Ikuti obrolan di [Discord](https://discord.gg/37gfS3ksug), atau tambahkan
|
||||
@@ -280,9 +280,9 @@ Whale Brothers.
|
||||
Codewhale berawal dari `deepseek-tui` dan masih membaca konfigurasi serta sesi
|
||||
proyek itu. Codewhale dipelihara secara mandiri dan tidak berafiliasi dengan
|
||||
DeepSeek atau penyedia model lain mana pun. Terima kasih kepada
|
||||
[semua yang telah berkontribusi](docs/CONTRIBUTORS.md).
|
||||
[semua yang telah berkontribusi](../CONTRIBUTORS.md).
|
||||
|
||||
[](docs/CONTRIBUTORS.md#everyone)
|
||||
[](../CONTRIBUTORS.md#everyone)
|
||||
|
||||
[MIT](LICENSE). Kode yang diadaptasi dari proyek sumber terbuka lain dicantumkan
|
||||
di [pemberitahuan pihak ketiga](docs/THIRD_PARTY_NOTICES.md).
|
||||
[MIT](../../LICENSE). Kode yang diadaptasi dari proyek sumber terbuka lain dicantumkan
|
||||
di [pemberitahuan pihak ketiga](../THIRD_PARTY_NOTICES.md).
|
||||
@@ -1,9 +1,9 @@
|
||||
<!-- source: README.md sha256:182e239fcdf7 -->
|
||||
<!-- source: README.md sha256:7e0946fcaecd -->
|
||||
<div align="center">
|
||||
|
||||
<picture>
|
||||
<source media="(prefers-color-scheme: dark)" srcset="brand/wordmark-inverted.svg">
|
||||
<img src="brand/wordmark.svg" alt="Codewhale" width="320">
|
||||
<source media="(prefers-color-scheme: dark)" srcset="../../brand/wordmark-inverted.svg">
|
||||
<img src="../../brand/wordmark.svg" alt="Codewhale" width="320">
|
||||
</picture>
|
||||
|
||||
**Un agente di programmazione open source per il terminale che funziona con qualsiasi modello.**
|
||||
@@ -18,14 +18,14 @@ fatto.
|
||||
[](https://github.com/codewhale-hq/CodeWhale/actions/workflows/ci.yml)
|
||||
[](https://crates.io/crates/codewhale-cli)
|
||||
[](https://www.npmjs.com/package/codewhale)
|
||||
[](LICENSE)
|
||||
[](../../LICENSE)
|
||||
[](https://discord.gg/37gfS3ksug)
|
||||
|
||||
[Sito web](https://codewhale.net) · [Documentazione](docs/README.md) · [Changelog](CHANGELOG.md) · [Contribuire](CONTRIBUTING.md)
|
||||
[Sito web](https://codewhale.net) · [Documentazione](../README.md) · [Changelog](../../CHANGELOG.md) · [Contribuire](../../CONTRIBUTING.md)
|
||||
|
||||
[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) · [Polski](README.pl.md) · [العربية](README.ar.md) · [Català](README.ca.md)
|
||||
[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) · [Polski](README.pl.md) · [العربية](README.ar.md) · [Català](README.ca.md)
|
||||
|
||||
<img src="web/public/codewhale-tui-0102-demo.png" alt="Una sessione di terminale di Codewhale" width="760">
|
||||
<img src="../../web/public/codewhale-tui-0102-demo.png" alt="Una sessione di terminale di Codewhale" width="760">
|
||||
|
||||
<sub>Una build di sviluppo della 0.10.2 con un modello di test scriptato, in Full Access dentro un’area di lavoro usa e getta. La modifica, tre test e una revisione di un sub-agente sono stati eseguiti davvero.</sub>
|
||||
|
||||
@@ -42,10 +42,10 @@ curl -fsSL https://codewhale.net/install.sh | sh
|
||||
Il programma di installazione mette in `~/.local/bin` `codewhale` e il suo alias
|
||||
breve `codew`, con checksum verificato. Se poi la shell risponde
|
||||
`command not found`, esegui la riga PATH che l’installer stampa
|
||||
([dettagli](docs/INSTALL.md#put-it-on-your-path)). `codewhale update` lo
|
||||
([dettagli](../INSTALL.md#put-it-on-your-path)). `codewhale update` lo
|
||||
aggiorna. Questi comandi installano l’ultima release. Questa pagina segue
|
||||
`main`, quindi una funzione contrassegnata con una versione arriva in quella
|
||||
release; il [changelog](CHANGELOG.md) elenca le novità di ogni release.
|
||||
release; il [changelog](../../CHANGELOG.md) elenca le novità di ogni release.
|
||||
|
||||
<details>
|
||||
<summary><b>Windows, npm, Cargo e altri modi per installarlo</b></summary>
|
||||
@@ -58,8 +58,8 @@ cargo install codewhale-cli --locked # crates.io; can trail GitHub Releases
|
||||
|
||||
I binari precompilati coprono Linux, macOS e Windows su x64 e arm64. Nix,
|
||||
Homebrew su Linux, Android/Termux (anteprima) e i download manuali sono descritti
|
||||
nella [guida all’installazione](docs/INSTALL.md), i container in
|
||||
[Docker](docs/DOCKER.md). Usa un solo metodo di installazione per macchina;
|
||||
nella [guida all’installazione](../INSTALL.md), i container in
|
||||
[Docker](../DOCKER.md). Usa un solo metodo di installazione per macchina;
|
||||
altrimenti nel `PATH` finiscono due copie e vince quella che compare per prima.
|
||||
|
||||
</details>
|
||||
@@ -107,7 +107,7 @@ Una nuova installazione parte in modalità Work con il permesso Ask.
|
||||
| Modalità | `Tab` (quando l’input è vuoto) o `/mode` | **Plan** legge e cerca, ma non modifica nulla. **Work** modifica file ed esegue comandi. **Operate** ha gli stessi accessi di Work, tratta la tua richiesta come un obiettivo e va avanti finché l’obiettivo non è verificato o finché non ha bisogno di un tuo input. |
|
||||
| Permesso | `Shift+Tab` | **Ask** applica senza chiedere le modifiche ai file nel tuo repository e chiede prima dei comandi di shell che non sono in sola lettura. **Auto-Review** lascia che regole e un modello revisore approvino le chiamate di routine e rifiuta quelle ad alto rischio; passa ad Ask per approvarle tu stesso. **Full Access** non chiede mai e disattiva la sandbox di Codewhale; le regole del repository e le policy gestite restano comunque valide. |
|
||||
|
||||
I dettagli sono nella [guida a modalità e permessi](docs/MODES.md).
|
||||
I dettagli sono nella [guida a modalità e permessi](../MODES.md).
|
||||
|
||||
## Cosa fa
|
||||
|
||||
@@ -139,13 +139,13 @@ Mistral, Moonshot, OpenRouter e xAI. Funziona qualsiasi endpoint compatibile con
|
||||
OpenAI, e anche i modelli locali tramite Ollama, vLLM o SGLang. Il predefinito è
|
||||
`deepseek-flash` di DeepSeek, che DeepSeek ha spostato su
|
||||
DeepSeek-V4.1-Flash-1017 il 2026-10-17; la 0.10.1 lo esegue senza aggiornamenti
|
||||
([dettagli](docs/PROVIDERS.md#deepseek-v41-flash)).
|
||||
([dettagli](../PROVIDERS.md#deepseek-v41-flash)).
|
||||
|
||||
`/model` cambia modello tra un turno e l’altro, e `/model auto` ne sceglie uno
|
||||
per ogni turno (`/router` imposta come). `/turn inspect` mostra quale modello ha
|
||||
usato un turno, quanto è costato e quanto è durato. `codewhale auth chatgpt` ti
|
||||
permette di usare un abbonamento ChatGPT invece di una chiave API
|
||||
(sperimentale). Vedi [Provider](docs/PROVIDERS.md).
|
||||
(sperimentale). Vedi [Provider](../PROVIDERS.md).
|
||||
|
||||
### Ricevute e annullamento
|
||||
|
||||
@@ -155,7 +155,7 @@ approvazioni e chi le ha date, e gli errori. `/undo` annulla la tua ultima
|
||||
richiesta; nella 0.10.1 richiede `/trust on` per i file e torna indietro di una
|
||||
chiamata di strumento alla volta. `/restore` riporta l’intera area di lavoro a
|
||||
uno snapshot precedente; poiché sovrascrive le modifiche successive, richiede
|
||||
`/trust on` o Full Access. Vedi [Ricevute](docs/RECEIPTS.md).
|
||||
`/trust on` o Full Access. Vedi [Ricevute](../RECEIPTS.md).
|
||||
|
||||
Le esecuzioni di exec che offrono strumenti vengono salvate in ogni formato di
|
||||
output, quindi `codewhale receipts --last` funziona dopo `exec --auto`, anche
|
||||
@@ -167,9 +167,9 @@ per salvarle sempre per le ricevute o per `exec --continue`.
|
||||
### Lavori più lunghi
|
||||
|
||||
`/goal` imposta un obiettivo che resta valido da un turno all’altro. Codewhale
|
||||
può suddividere il lavoro tra [sub-agenti](docs/SUBAGENTS.md), avviare una
|
||||
[flotta](docs/FLEET.md) di agenti o seguire un
|
||||
[workflow](docs/WORKFLOW_AUTHORING.md) versionato nel repository.
|
||||
può suddividere il lavoro tra [sub-agenti](../SUBAGENTS.md), avviare una
|
||||
[flotta](../FLEET.md) di agenti o seguire un
|
||||
[workflow](../WORKFLOW_AUTHORING.md) versionato nel repository.
|
||||
|
||||
### Se arrivi da un altro agente
|
||||
|
||||
@@ -178,19 +178,19 @@ strumenti, come `CLAUDE.md`, `.cursorrules` o
|
||||
`.github/copilot-instructions.md`, vengono caricati solo se li abiliti
|
||||
esplicitamente con `project_instruction_imports = ["claude"]` (oppure
|
||||
`"cursor"`, `"cline"`, `"windsurf"`, `"copilot"`, `"all"`) nella tua
|
||||
configurazione; vedi [config.example.toml](config.example.toml). Codewhale
|
||||
configurazione; vedi [config.example.toml](../../config.example.toml). Codewhale
|
||||
avvisa quando ne trova uno che non ha caricato.
|
||||
|
||||
`/import-claude` prepara un’importazione delle tue impostazioni e dei tuoi
|
||||
server MCP di Claude Code, che puoi poi rivedere. `/plugin install` accetta
|
||||
plugin di Claude Code che contengono skill, comandi, profili di agente e server
|
||||
MCP, e rifiuta i plugin che richiedono hook o server LSP
|
||||
([dettagli](docs/CLAUDE_PLUGIN_COMPAT.md)).
|
||||
([dettagli](../CLAUDE_PLUGIN_COMPAT.md)).
|
||||
|
||||
### Estensioni
|
||||
|
||||
Collega [server MCP](docs/MCP.md), aggiungi [skill](docs/SKILLS.md) e
|
||||
[plugin](docs/PLUGINS.md) ed esegui [hook](docs/HOOKS.md) sugli eventi di
|
||||
Collega [server MCP](../MCP.md), aggiungi [skill](../SKILLS.md) e
|
||||
[plugin](../PLUGINS.md) ed esegui [hook](../HOOKS.md) sugli eventi di
|
||||
sessione e degli strumenti. La modalità codice (sperimentale, attiva per
|
||||
impostazione predefinita) consente al modello di scrivere un unico programma
|
||||
`execute_tools` che chiama più strumenti MCP e dei plugin; ogni chiamata resta
|
||||
@@ -198,7 +198,7 @@ soggetta alle tue regole di approvazione e conserva la sua ricevuta. Il plugin
|
||||
Computer Use incluso (sperimentale, solo macOS) può osservare e usare altre
|
||||
applicazioni. Resta disattivato finché non ne
|
||||
controlli gli accessi e lo abiliti
|
||||
([guida](crates/tui/plugins/computer-use/README.md)).
|
||||
([guida](../../crates/tui/plugins/computer-use/README.md)).
|
||||
|
||||
## Modi di eseguirlo
|
||||
|
||||
@@ -206,13 +206,13 @@ controlli gli accessi e lo abiliti
|
||||
| --- | --- |
|
||||
| `codewhale` | L’app interattiva nel terminale |
|
||||
| `codewhale exec "…"` | Un compito senza interfaccia. Da solo risponde senza usare strumenti; `--auto` abilita gli strumenti con Full Access per impostazione predefinita, `--sandbox workspace-write` li limita, e `--output-format stream-json` trasmette gli eventi in streaming come JSON |
|
||||
| `codewhale web` | Un’interfaccia web locale su `127.0.0.1` ([guida](docs/WEB.md)) |
|
||||
| `codewhale review --pr N` | Una revisione consultiva di una pull request GitHub. Non pubblica nulla a meno che tu non aggiunga `--post`; la [GitHub Action](docs/GITHUB_ACTION.md) esegue la stessa revisione in CI |
|
||||
| `codewhale app-server --http` | La [Runtime API](docs/RUNTIME_API.md), un’API HTTP locale per thread, eventi, approvazioni e le modifiche ai file di ogni turno |
|
||||
| `codewhale web` | Un’interfaccia web locale su `127.0.0.1` ([guida](../WEB.md)) |
|
||||
| `codewhale review --pr N` | Una revisione consultiva di una pull request GitHub. Non pubblica nulla a meno che tu non aggiunga `--post`; la [GitHub Action](../GITHUB_ACTION.md) esegue la stessa revisione in CI |
|
||||
| `codewhale app-server --http` | La [Runtime API](../RUNTIME_API.md), un’API HTTP locale per thread, eventi, approvazioni e le modifiche ai file di ogni turno |
|
||||
| `codewhale serve --acp` | L’Agent Client Protocol su stdio, per editor come Zed |
|
||||
|
||||
L’app nel terminale, `exec`, `web` e la Runtime API condividono un unico motore
|
||||
([architettura](docs/ARCHITECTURE.md)). Un’[estensione VS Code](https://marketplace.visualstudio.com/items?itemName=HengQuWorld.brotherwhale-vscode)
|
||||
([architettura](../ARCHITECTURE.md)). Un’[estensione VS Code](https://marketplace.visualstudio.com/items?itemName=HengQuWorld.brotherwhale-vscode)
|
||||
mantenuta dalla comunità vi si collega dalla barra laterale ([sorgente](https://github.com/HengQuWorld/CodeWhale-VSCode)).
|
||||
Un’app desktop nativa basata sulla Runtime API è in sviluppo; non ha ancora un
|
||||
download pubblico.
|
||||
@@ -245,26 +245,26 @@ casuale che cambia ogni 90 giorni, e non invia mai conversazioni, codice,
|
||||
prompt, nomi di modelli, nomi di file o di repository, né credenziali. `codewhale config set telemetry false` la disattiva. All’avvio
|
||||
Codewhale controlla anche su GitHub se c’è una nuova release; imposta
|
||||
`CODEWHALE_NO_UPDATE_CHECK=1` per saltare questo controllo. Altri dettagli in
|
||||
[ordine di autorizzazione](docs/AUTHORIZATION_ORDER.md),
|
||||
[sandbox](docs/SANDBOX.md) e [telemetria](docs/TELEMETRY.md).
|
||||
[ordine di autorizzazione](../AUTHORIZATION_ORDER.md),
|
||||
[sandbox](../SANDBOX.md) e [telemetria](../TELEMETRY.md).
|
||||
|
||||
## Documentazione
|
||||
|
||||
| Per iniziare | Per approfondire |
|
||||
| --- | --- |
|
||||
| [Installazione](docs/INSTALL.md) | [Configurazione](docs/CONFIGURATION.md) |
|
||||
| [Provider e modelli locali](docs/PROVIDERS.md) | [Architettura](docs/ARCHITECTURE.md) |
|
||||
| [Modalità e permessi](docs/MODES.md) | [Runtime API](docs/RUNTIME_API.md) |
|
||||
| [Scorciatoie da tastiera](docs/KEYBINDINGS.md) | [Creare plugin](docs/PLUGIN_AUTHORING.md) |
|
||||
| [Revisione PR su GitHub](docs/GITHUB_ACTION.md) | [Tutta la documentazione](docs/README.md) |
|
||||
| [Installazione](../INSTALL.md) | [Configurazione](../CONFIGURATION.md) |
|
||||
| [Provider e modelli locali](../PROVIDERS.md) | [Architettura](../ARCHITECTURE.md) |
|
||||
| [Modalità e permessi](../MODES.md) | [Runtime API](../RUNTIME_API.md) |
|
||||
| [Scorciatoie da tastiera](../KEYBINDINGS.md) | [Creare plugin](../PLUGIN_AUTHORING.md) |
|
||||
| [Revisione PR su GitHub](../GITHUB_ACTION.md) | [Tutta la documentazione](../README.md) |
|
||||
|
||||
## Comunità
|
||||
|
||||
Se manca un provider o un workflow è scomodo,
|
||||
[apri una issue](https://github.com/codewhale-hq/CodeWhale/issues/new/choose) o
|
||||
[invia una pull request](CONTRIBUTING.md). Chi contribuisce mantiene il
|
||||
[invia una pull request](../../CONTRIBUTING.md). Chi contribuisce mantiene il
|
||||
riconoscimento per il lavoro che viene integrato, e la
|
||||
[struttura del repository](CONTRIBUTING.md#project-structure) mostra dove si
|
||||
[struttura del repository](../../CONTRIBUTING.md#project-structure) mostra dove si
|
||||
trova ogni cosa.
|
||||
|
||||
Scrivici su [Discord](https://discord.gg/37gfS3ksug), oppure aggiungi il
|
||||
@@ -276,9 +276,9 @@ Whale Brothers.
|
||||
Codewhale è nato come `deepseek-tui` e legge ancora la configurazione e le
|
||||
sessioni di quel progetto. È mantenuto in modo indipendente e non è affiliato a
|
||||
DeepSeek né ad alcun altro fornitore di modelli. Grazie a
|
||||
[tutti coloro che hanno contribuito](docs/CONTRIBUTORS.md).
|
||||
[tutti coloro che hanno contribuito](../CONTRIBUTORS.md).
|
||||
|
||||
[](docs/CONTRIBUTORS.md#everyone)
|
||||
[](../CONTRIBUTORS.md#everyone)
|
||||
|
||||
[MIT](LICENSE). Il codice adattato da altri progetti open source è elencato
|
||||
negli [avvisi di terze parti](docs/THIRD_PARTY_NOTICES.md).
|
||||
[MIT](../../LICENSE). Il codice adattato da altri progetti open source è elencato
|
||||
negli [avvisi di terze parti](../THIRD_PARTY_NOTICES.md).
|
||||
@@ -1,9 +1,9 @@
|
||||
<!-- source: README.md sha256:182e239fcdf7 -->
|
||||
<!-- source: README.md sha256:7e0946fcaecd -->
|
||||
<div align="center">
|
||||
|
||||
<picture>
|
||||
<source media="(prefers-color-scheme: dark)" srcset="brand/wordmark-inverted.svg">
|
||||
<img src="brand/wordmark.svg" alt="Codewhale" width="320">
|
||||
<source media="(prefers-color-scheme: dark)" srcset="../../brand/wordmark-inverted.svg">
|
||||
<img src="../../brand/wordmark.svg" alt="Codewhale" width="320">
|
||||
</picture>
|
||||
|
||||
**どのモデルでも使える、ターミナル向けのオープンソースのコーディングエージェント。**
|
||||
@@ -15,14 +15,14 @@ Codewhale にタスクを渡すと、タスクが完了するか、あなたの
|
||||
[](https://github.com/codewhale-hq/CodeWhale/actions/workflows/ci.yml)
|
||||
[](https://crates.io/crates/codewhale-cli)
|
||||
[](https://www.npmjs.com/package/codewhale)
|
||||
[](LICENSE)
|
||||
[](../../LICENSE)
|
||||
[](https://discord.gg/37gfS3ksug)
|
||||
|
||||
[ウェブサイト](https://codewhale.net) · [ドキュメント](docs/README.md) · [変更履歴](CHANGELOG.md) · [コントリビュート](CONTRIBUTING.md)
|
||||
[ウェブサイト](https://codewhale.net) · [ドキュメント](../README.md) · [変更履歴](../../CHANGELOG.md) · [コントリビュート](../../CONTRIBUTING.md)
|
||||
|
||||
[English](README.md) · [简体中文](README.zh-CN.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) · [Català](README.ca.md)
|
||||
[English](../../README.md) · [简体中文](README.zh-CN.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) · [Català](README.ca.md)
|
||||
|
||||
<img src="web/public/codewhale-tui-0102-demo.png" alt="Codewhale のターミナルセッション" width="760">
|
||||
<img src="../../web/public/codewhale-tui-0102-demo.png" alt="Codewhale のターミナルセッション" width="760">
|
||||
|
||||
<sub>スクリプト化したテストモデルを使う 0.10.2 の開発ビルドを、使い捨てのワークスペース内でフルアクセスにして実行した画面です。編集、3 つのテスト、サブエージェントによるレビューは実際に実行されています。</sub>
|
||||
|
||||
@@ -37,10 +37,10 @@ curl -fsSL https://codewhale.net/install.sh | sh
|
||||
```
|
||||
|
||||
インストーラーは、チェックサム検証済みの `codewhale` と短縮エイリアス `codew` を `~/.local/bin` に配置します。
|
||||
その後シェルが `command not found` と表示する場合は、インストーラーが出力する PATH 用の行を実行してください（[詳細](docs/INSTALL.md#put-it-on-your-path)）。
|
||||
その後シェルが `command not found` と表示する場合は、インストーラーが出力する PATH 用の行を実行してください（[詳細](../INSTALL.md#put-it-on-your-path)）。
|
||||
アップグレードは `codewhale update` で行えます。
|
||||
これらのコマンドは最新のリリースをインストールします。
|
||||
このページは `main` に合わせて更新されるため、バージョンが記された機能はそのリリースで提供されます。各リリースで追加される内容は[変更履歴](CHANGELOG.md)に記載しています。
|
||||
このページは `main` に合わせて更新されるため、バージョンが記された機能はそのリリースで提供されます。各リリースで追加される内容は[変更履歴](../../CHANGELOG.md)に記載しています。
|
||||
|
||||
<details>
|
||||
<summary><b>Windows、npm、Cargo、その他のインストール方法</b></summary>
|
||||
@@ -52,7 +52,7 @@ cargo install codewhale-cli --locked # crates.io; can trail GitHub Releases
|
||||
```
|
||||
|
||||
ビルド済みバイナリは、x64 と arm64 の Linux、macOS、Windows に対応しています。
|
||||
Nix、Linux 上の Homebrew、Android/Termux（プレビュー）、手動ダウンロードについては[インストールガイド](docs/INSTALL.md)を、コンテナについては [Docker](docs/DOCKER.md) を参照してください。
|
||||
Nix、Linux 上の Homebrew、Android/Termux（プレビュー）、手動ダウンロードについては[インストールガイド](../INSTALL.md)を、コンテナについては [Docker](../DOCKER.md) を参照してください。
|
||||
インストール方法は 1 台のマシンにつき 1 つにしてください。
|
||||
そうしないと `PATH` 上に 2 つのコピーができ、先に見つかった方が使われます。
|
||||
|
||||
@@ -96,7 +96,7 @@ codewhale exec --auto --sandbox workspace-write "fix the failing tests and expla
|
||||
| モード | `Tab`（入力欄が空のとき）または `/mode` | **Plan** は読み取りと検索を行いますが、何も変更しません。**Work** はファイルを編集し、コマンドを実行します。**Operate** は Work と同じアクセス権を持ち、リクエストを目標として扱い、目標が検証されるか、あなたの入力が必要になるまで作業を続けます。 |
|
||||
| 権限 | `Shift+Tab` | **確認**（Ask）では、リポジトリ内のファイル編集は確認なしで適用され、読み取り専用ではないシェルコマンドの前に確認が入ります。**自動レビュー**（Auto-Review）では、ルールとレビュー担当のモデルが定型的な呼び出しを承認し、高リスクの呼び出しは拒否します。それらを自分で承認するには「確認」に切り替えてください。**フルアクセス**（Full Access）は一切確認せず、Codewhale のサンドボックスを無効にします。リポジトリのルールと管理ポリシーは引き続き適用されます。 |
|
||||
|
||||
詳しくは[モードと権限のガイド](docs/MODES.md)を参照してください。
|
||||
詳しくは[モードと権限のガイド](../MODES.md)を参照してください。
|
||||
|
||||
## 主な機能
|
||||
|
||||
@@ -120,12 +120,12 @@ codewhale exec --auto --sandbox workspace-write "fix the failing tests and expla
|
||||
Anthropic、OpenAI、DeepSeek、Google、Mistral、Moonshot、OpenRouter、xAI など、40 を超えるプロバイダーを組み込んでいます。
|
||||
OpenAI 互換のエンドポイントであればどれでも使え、Ollama、vLLM、SGLang 経由のローカルモデルも使えます。
|
||||
既定は DeepSeek の `deepseek-flash` です。
|
||||
DeepSeek は 2026-10-17 にこれを DeepSeek-V4.1-Flash-1017 に切り替えましたが、0.10.1 はアップデートなしで動作します（[詳細](docs/PROVIDERS.md#deepseek-v41-flash)）。
|
||||
DeepSeek は 2026-10-17 にこれを DeepSeek-V4.1-Flash-1017 に切り替えましたが、0.10.1 はアップデートなしで動作します（[詳細](../PROVIDERS.md#deepseek-v41-flash)）。
|
||||
|
||||
`/model` でターンの合間にモデルを切り替えられ、`/model auto` ではターンごとにモデルが選ばれます（選び方は `/router` で設定します）。
|
||||
`/turn inspect` は、あるターンで使われたモデル、費用、所要時間を表示します。
|
||||
`codewhale auth chatgpt` を使うと、API キーの代わりに ChatGPT のプランを利用できます（実験的）。
|
||||
[プロバイダー](docs/PROVIDERS.md)を参照してください。
|
||||
[プロバイダー](../PROVIDERS.md)を参照してください。
|
||||
|
||||
### レシートと取り消し
|
||||
|
||||
@@ -134,7 +134,7 @@ DeepSeek は 2026-10-17 にこれを DeepSeek-V4.1-Flash-1017 に切り替えま
|
||||
0.10.1 では、ファイルを戻すには `/trust on` が必要で、戻せるのは 1 回につき 1 つのツール呼び出しずつです。
|
||||
`/restore` はワークスペース全体を以前のスナップショットまで巻き戻します。
|
||||
それ以降の編集を上書きするため、`/trust on` またはフルアクセスが必要です。
|
||||
[レシート](docs/RECEIPTS.md)を参照してください。
|
||||
[レシート](../RECEIPTS.md)を参照してください。
|
||||
|
||||
ツールを利用できる exec の実行は、どの出力形式でも保存されるため、`--json` を含む `exec --auto` の実行後に `codewhale receipts --last` を使えます。
|
||||
回答のみを返すテキスト出力や `--json` の実行は、再開時か会話の圧縮が始まるときにだけ保存されます。
|
||||
@@ -143,25 +143,25 @@ DeepSeek は 2026-10-17 にこれを DeepSeek-V4.1-Flash-1017 に切り替えま
|
||||
### 長い作業
|
||||
|
||||
`/goal` は、ターンをまたいで持続する目標を設定します。
|
||||
Codewhale は作業を[サブエージェント](docs/SUBAGENTS.md)に分担させたり、複数のエージェントを [Fleet](docs/FLEET.md) として動かしたり、リポジトリにコミットされた[ワークフロー](docs/WORKFLOW_AUTHORING.md)に従ったりできます。
|
||||
Codewhale は作業を[サブエージェント](../SUBAGENTS.md)に分担させたり、複数のエージェントを [Fleet](../FLEET.md) として動かしたり、リポジトリにコミットされた[ワークフロー](../WORKFLOW_AUTHORING.md)に従ったりできます。
|
||||
|
||||
### 他のエージェントからの移行
|
||||
|
||||
Codewhale は `AGENTS.md` を自動で読み込みます。
|
||||
`CLAUDE.md`、`.cursorrules`、`.github/copilot-instructions.md` など、他のツール向けに書かれた指示ファイルは、設定で `project_instruction_imports = ["claude"]`（または `"cursor"`、`"cline"`、`"windsurf"`、`"copilot"`、`"all"`）を指定してオプトインした場合にのみ読み込まれます。
|
||||
[config.example.toml](config.example.toml) を参照してください。
|
||||
[config.example.toml](../../config.example.toml) を参照してください。
|
||||
読み込んでいない指示ファイルを見つけると、Codewhale は警告を出します。
|
||||
|
||||
`/import-claude` は、Claude Code の設定と MCP サーバーのインポート内容を、確認できる形で用意します。
|
||||
`/plugin install` は、スキル、コマンド、エージェントプロファイル、MCP サーバーを含む Claude Code プラグインを受け付け、フックや LSP サーバーを必要とするプラグインは拒否します（[詳細](docs/CLAUDE_PLUGIN_COMPAT.md)）。
|
||||
`/plugin install` は、スキル、コマンド、エージェントプロファイル、MCP サーバーを含む Claude Code プラグインを受け付け、フックや LSP サーバーを必要とするプラグインは拒否します（[詳細](../CLAUDE_PLUGIN_COMPAT.md)）。
|
||||
|
||||
### 拡張
|
||||
|
||||
[MCP サーバー](docs/MCP.md)を接続し、[スキル](docs/SKILLS.md)や[プラグイン](docs/PLUGINS.md)を追加し、セッションやツールのイベントで[フック](docs/HOOKS.md)を実行できます。
|
||||
[MCP サーバー](../MCP.md)を接続し、[スキル](../SKILLS.md)や[プラグイン](../PLUGINS.md)を追加し、セッションやツールのイベントで[フック](../HOOKS.md)を実行できます。
|
||||
コードモード（実験的、既定で有効）では、モデルが複数の MCP ツールやプラグインツールを呼び出す 1 つの `execute_tools` プログラムを書けます。
|
||||
個々の呼び出しは引き続き承認ルールに従い、それぞれのレシートも残ります。
|
||||
同梱の Computer Use プラグイン（実験的、macOS のみ）は、他のアプリを観察・操作できます。
|
||||
アクセス範囲を確認して有効にするまではオフのままです（[ガイド](crates/tui/plugins/computer-use/README.md)）。
|
||||
アクセス範囲を確認して有効にするまではオフのままです（[ガイド](../../crates/tui/plugins/computer-use/README.md)）。
|
||||
|
||||
## 実行方法
|
||||
|
||||
@@ -169,12 +169,12 @@ Codewhale は `AGENTS.md` を自動で読み込みます。
|
||||
| --- | --- |
|
||||
| `codewhale` | 対話型のターミナルアプリ |
|
||||
| `codewhale exec "…"` | インターフェースなしで 1 つのタスクを実行します。オプションなしではツールを使わずに回答し、`--auto` は既定でフルアクセスでツールを有効にし、`--sandbox workspace-write` はそれらを制限し、`--output-format stream-json` でイベントを JSON としてストリーミングします |
|
||||
| `codewhale web` | `127.0.0.1` で動作するローカル Web UI（[ガイド](docs/WEB.md)） |
|
||||
| `codewhale review --pr N` | GitHub のプルリクエストに対する参考としてのレビュー。`--post` を付けない限り何も投稿しません。[GitHub Action](docs/GITHUB_ACTION.md) は同じレビューを CI で実行します |
|
||||
| `codewhale app-server --http` | [Runtime API](docs/RUNTIME_API.md)。スレッド、イベント、承認、各ターンのファイル変更のためのローカル HTTP API |
|
||||
| `codewhale web` | `127.0.0.1` で動作するローカル Web UI（[ガイド](../WEB.md)） |
|
||||
| `codewhale review --pr N` | GitHub のプルリクエストに対する参考としてのレビュー。`--post` を付けない限り何も投稿しません。[GitHub Action](../GITHUB_ACTION.md) は同じレビューを CI で実行します |
|
||||
| `codewhale app-server --http` | [Runtime API](../RUNTIME_API.md)。スレッド、イベント、承認、各ターンのファイル変更のためのローカル HTTP API |
|
||||
| `codewhale serve --acp` | stdio 経由の Agent Client Protocol。Zed などのエディター向け |
|
||||
|
||||
ターミナルアプリ、`exec`、`web`、Runtime API は 1 つのエンジンを共有しています（[アーキテクチャ](docs/ARCHITECTURE.md)）。
|
||||
ターミナルアプリ、`exec`、`web`、Runtime API は 1 つのエンジンを共有しています（[アーキテクチャ](../ARCHITECTURE.md)）。
|
||||
コミュニティが保守している [VS Code 拡張機能](https://marketplace.visualstudio.com/items?itemName=HengQuWorld.brotherwhale-vscode)は、サイドバーからこのエンジンに接続します（[ソース](https://github.com/HengQuWorld/CodeWhale-VSCode)）。
|
||||
Runtime API の上に構築したネイティブのデスクトップアプリを開発中です。
|
||||
まだ公開ダウンロードはありません。
|
||||
@@ -204,23 +204,23 @@ Windows にはまだ OS のサンドボックスがなく、フルアクセス
|
||||
`codewhale config set telemetry false` で無効にできます。
|
||||
また、Codewhale は起動時に GitHub で新しいリリースを確認します。
|
||||
これを省くには `CODEWHALE_NO_UPDATE_CHECK=1` を設定してください。
|
||||
詳しくは[認可の順序](docs/AUTHORIZATION_ORDER.md)、[サンドボックス](docs/SANDBOX.md)、[テレメトリ](docs/TELEMETRY.md)を参照してください。
|
||||
詳しくは[認可の順序](../AUTHORIZATION_ORDER.md)、[サンドボックス](../SANDBOX.md)、[テレメトリ](../TELEMETRY.md)を参照してください。
|
||||
|
||||
## ドキュメント
|
||||
|
||||
| まずはここから | リファレンス |
|
||||
| --- | --- |
|
||||
| [インストール](docs/INSTALL.md) | [設定](docs/CONFIGURATION.md) |
|
||||
| [プロバイダーとローカルモデル](docs/PROVIDERS.md) | [アーキテクチャ](docs/ARCHITECTURE.md) |
|
||||
| [モードと権限](docs/MODES.md) | [Runtime API](docs/RUNTIME_API.md) |
|
||||
| [キーバインド](docs/KEYBINDINGS.md) | [プラグイン作成](docs/PLUGIN_AUTHORING.md) |
|
||||
| [GitHub PR レビュー](docs/GITHUB_ACTION.md) | [すべてのドキュメント](docs/README.md) |
|
||||
| [インストール](../INSTALL.md) | [設定](../CONFIGURATION.md) |
|
||||
| [プロバイダーとローカルモデル](../PROVIDERS.md) | [アーキテクチャ](../ARCHITECTURE.md) |
|
||||
| [モードと権限](../MODES.md) | [Runtime API](../RUNTIME_API.md) |
|
||||
| [キーバインド](../KEYBINDINGS.md) | [プラグイン作成](../PLUGIN_AUTHORING.md) |
|
||||
| [GitHub PR レビュー](../GITHUB_ACTION.md) | [すべてのドキュメント](../README.md) |
|
||||
|
||||
## コミュニティ
|
||||
|
||||
プロバイダーが足りない、あるいはワークフローが使いにくいと感じたら、[issue を作成](https://github.com/codewhale-hq/CodeWhale/issues/new/choose)するか、[プルリクエストを送って](CONTRIBUTING.md)ください。
|
||||
プロバイダーが足りない、あるいはワークフローが使いにくいと感じたら、[issue を作成](https://github.com/codewhale-hq/CodeWhale/issues/new/choose)するか、[プルリクエストを送って](../../CONTRIBUTING.md)ください。
|
||||
取り込まれた作業のクレジットはコントリビューターに残ります。
|
||||
どこに何があるかは[リポジトリの構成](CONTRIBUTING.md#project-structure)で確認できます。
|
||||
どこに何があるかは[リポジトリの構成](../../CONTRIBUTING.md#project-structure)で確認できます。
|
||||
|
||||
[Discord](https://discord.gg/37gfS3ksug) で話すか、WeChat でメンテナーの Hunter（`hunterbown`）を追加して、Whale Brothers グループへの参加を依頼してください。
|
||||
|
||||
@@ -228,8 +228,8 @@ Windows にはまだ OS のサンドボックスがなく、フルアクセス
|
||||
|
||||
Codewhale は `deepseek-tui` として始まり、今もそのプロジェクトの設定とセッションを読み込みます。
|
||||
独立して保守されており、DeepSeek をはじめとするどのモデルプロバイダーとも提携していません。
|
||||
[これまでに貢献してくれたすべての方](docs/CONTRIBUTORS.md)に感謝します。
|
||||
[これまでに貢献してくれたすべての方](../CONTRIBUTORS.md)に感謝します。
|
||||
|
||||
[](docs/CONTRIBUTORS.md#everyone)
|
||||
[](../CONTRIBUTORS.md#everyone)
|
||||
|
||||
[MIT](LICENSE)。他のオープンソースプロジェクトから改変して取り入れたコードは、[サードパーティ通知](docs/THIRD_PARTY_NOTICES.md)に記載しています。
|
||||
[MIT](../../LICENSE)。他のオープンソースプロジェクトから改変して取り入れたコードは、[サードパーティ通知](../THIRD_PARTY_NOTICES.md)に記載しています。
|
||||
@@ -1,9 +1,9 @@
|
||||
<!-- source: README.md sha256:182e239fcdf7 -->
|
||||
<!-- source: README.md sha256:7e0946fcaecd -->
|
||||
<div align="center">
|
||||
|
||||
<picture>
|
||||
<source media="(prefers-color-scheme: dark)" srcset="brand/wordmark-inverted.svg">
|
||||
<img src="brand/wordmark.svg" alt="Codewhale" width="320">
|
||||
<source media="(prefers-color-scheme: dark)" srcset="../../brand/wordmark-inverted.svg">
|
||||
<img src="../../brand/wordmark.svg" alt="Codewhale" width="320">
|
||||
</picture>
|
||||
|
||||
**어떤 모델과도 함께 쓸 수 있는 오픈 소스 터미널용 코딩 에이전트.**
|
||||
@@ -17,14 +17,14 @@ MCP 호출을 보여 줍니다.
|
||||
[](https://github.com/codewhale-hq/CodeWhale/actions/workflows/ci.yml)
|
||||
[](https://crates.io/crates/codewhale-cli)
|
||||
[](https://www.npmjs.com/package/codewhale)
|
||||
[](LICENSE)
|
||||
[](../../LICENSE)
|
||||
[](https://discord.gg/37gfS3ksug)
|
||||
|
||||
[웹사이트](https://codewhale.net) · [문서](docs/README.md) · [변경 내역](CHANGELOG.md) · [기여하기](CONTRIBUTING.md)
|
||||
[웹사이트](https://codewhale.net) · [문서](../README.md) · [변경 내역](../../CHANGELOG.md) · [기여하기](../../CONTRIBUTING.md)
|
||||
|
||||
[English](README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja-JP.md) · [Tiếng Việt](README.vi.md) · [Bahasa Indonesia](README.id.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) · [Català](README.ca.md)
|
||||
[English](../../README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja-JP.md) · [Tiếng Việt](README.vi.md) · [Bahasa Indonesia](README.id.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) · [Català](README.ca.md)
|
||||
|
||||
<img src="web/public/codewhale-tui-0102-demo.png" alt="Codewhale 터미널 세션" width="760">
|
||||
<img src="../../web/public/codewhale-tui-0102-demo.png" alt="Codewhale 터미널 세션" width="760">
|
||||
|
||||
<sub>스크립트로 동작하는 테스트 모델을 쓴 0.10.2 개발 빌드를 버려도 되는 작업 공간에서 전체 접근 권한으로 실행한 화면입니다. 편집, 테스트 세 개, 하위 에이전트 리뷰는 실제로 실행되었습니다.</sub>
|
||||
|
||||
@@ -41,10 +41,10 @@ curl -fsSL https://codewhale.net/install.sh | sh
|
||||
설치 스크립트는 체크섬을 검증한 `codewhale`과 짧은 별칭 `codew`를
|
||||
`~/.local/bin`에 설치합니다. 이후 셸에서 `command not found`가 나오면 설치
|
||||
스크립트가 출력하는 PATH 설정 줄을 실행하세요
|
||||
([자세히](docs/INSTALL.md#put-it-on-your-path)). 업그레이드는
|
||||
([자세히](../INSTALL.md#put-it-on-your-path)). 업그레이드는
|
||||
`codewhale update`로 합니다. 이 명령들은 최신 릴리스를 설치합니다. 이 페이지는
|
||||
`main`을 따르므로, 버전이 표시된 기능은 그 릴리스에서 제공됩니다. 각 릴리스에
|
||||
추가된 내용은 [변경 내역](CHANGELOG.md)에서 볼 수 있습니다.
|
||||
추가된 내용은 [변경 내역](../../CHANGELOG.md)에서 볼 수 있습니다.
|
||||
|
||||
<details>
|
||||
<summary><b>Windows, npm, Cargo 등 다른 설치 방법</b></summary>
|
||||
@@ -57,7 +57,7 @@ cargo install codewhale-cli --locked # crates.io; can trail GitHub Releases
|
||||
|
||||
미리 빌드된 바이너리는 x64와 arm64의 Linux, macOS, Windows를 지원합니다. Nix,
|
||||
Linux의 Homebrew, Android/Termux(프리뷰), 수동 다운로드는
|
||||
[설치 안내서](docs/INSTALL.md)에서, 컨테이너는 [Docker](docs/DOCKER.md)에서
|
||||
[설치 안내서](../INSTALL.md)에서, 컨테이너는 [Docker](../DOCKER.md)에서
|
||||
다룹니다. 한 컴퓨터에는 설치 방법을 하나만 쓰세요. 그렇지 않으면 `PATH`에
|
||||
사본이 두 개 생기고, 먼저 오는 쪽이 실행됩니다.
|
||||
|
||||
@@ -105,7 +105,7 @@ codewhale exec --auto --sandbox workspace-write "fix the failing tests and expla
|
||||
| 모드 | `Tab`(입력란이 비어 있을 때) 또는 `/mode` | **계획**(Plan)은 읽고 검색하지만 아무것도 바꾸지 않습니다. **실행**(Work)은 파일을 편집하고 명령을 실행합니다. **운영**(Operate)은 실행과 같은 접근 권한을 가지며, 요청을 목표로 다루고 목표가 검증되거나 사용자의 입력이 필요할 때까지 계속 진행합니다. |
|
||||
| 권한 | `Shift+Tab` | **확인**(Ask)은 저장소 안의 파일 편집은 묻지 않고 적용하고, 읽기 전용이 아닌 셸 명령은 실행 전에 묻습니다. **자동 검토**(Auto-Review)는 규칙과 리뷰어 모델이 일상적인 호출을 승인하게 하고 위험도가 높은 호출은 거부합니다. 그런 호출을 직접 승인하려면 확인으로 전환하세요. **전체 접근**(Full Access)은 전혀 묻지 않으며 Codewhale의 샌드박스를 끕니다. 저장소 규칙과 관리 정책은 계속 적용됩니다. |
|
||||
|
||||
자세한 내용은 [모드와 권한 안내서](docs/MODES.md)를 참고하세요.
|
||||
자세한 내용은 [모드와 권한 안내서](../MODES.md)를 참고하세요.
|
||||
|
||||
## 할 수 있는 일
|
||||
|
||||
@@ -137,12 +137,12 @@ Anthropic, OpenAI, DeepSeek, Google, Mistral, Moonshot, OpenRouter, xAI를
|
||||
어느 것이든 쓸 수 있고, Ollama, vLLM, SGLang을 통한 로컬 모델도 쓸 수
|
||||
있습니다. 기본값은 DeepSeek의 `deepseek-flash`이며, DeepSeek는 2026-10-17에 이
|
||||
모델을 DeepSeek-V4.1-Flash-1017로 바꿨습니다. 0.10.1은 업데이트 없이 이 모델을
|
||||
실행합니다([자세히](docs/PROVIDERS.md#deepseek-v41-flash)).
|
||||
실행합니다([자세히](../PROVIDERS.md#deepseek-v41-flash)).
|
||||
|
||||
`/model`로 턴 사이에 모델을 바꾸고, `/model auto`는 턴마다 모델을 고릅니다
|
||||
(고르는 방식은 `/router`로 설정합니다). `/turn inspect`는 한 턴에 쓰인 모델,
|
||||
비용, 걸린 시간을 보여 줍니다. `codewhale auth chatgpt`를 쓰면 API 키 대신
|
||||
ChatGPT 요금제를 사용할 수 있습니다(실험적). [제공업체](docs/PROVIDERS.md)를
|
||||
ChatGPT 요금제를 사용할 수 있습니다(실험적). [제공업체](../PROVIDERS.md)를
|
||||
참고하세요.
|
||||
|
||||
### 영수증과 되돌리기
|
||||
@@ -152,7 +152,7 @@ ChatGPT 요금제를 사용할 수 있습니다(실험적). [제공업체](docs/
|
||||
줍니다. `/undo`는 마지막 요청을 되돌립니다. 0.10.1에서는 파일을 되돌리려면
|
||||
`/trust on`이 필요하고, 도구 호출을 한 번에 하나씩 되돌립니다. `/restore`는 작업 공간 전체를 이전
|
||||
스냅샷으로 되돌리는데, 이후의 편집을 덮어쓰기 때문에 `/trust on` 또는 전체
|
||||
접근 권한이 필요합니다. [영수증](docs/RECEIPTS.md)을 참고하세요.
|
||||
접근 권한이 필요합니다. [영수증](../RECEIPTS.md)을 참고하세요.
|
||||
|
||||
도구를 사용할 수 있는 exec 실행은 모든 출력 형식에서 저장되므로, `--json`을
|
||||
포함한 `exec --auto` 실행 후에도 `codewhale receipts --last`를 쓸 수 있습니다.
|
||||
@@ -163,9 +163,9 @@ ChatGPT 요금제를 사용할 수 있습니다(실험적). [제공업체](docs/
|
||||
### 긴 작업
|
||||
|
||||
`/goal`은 여러 턴에 걸쳐 유지되는 목표를 정합니다. Codewhale은 작업을
|
||||
[하위 에이전트](docs/SUBAGENTS.md)에 나눠 맡기거나, 여러 에이전트로 구성된
|
||||
[Fleet](docs/FLEET.md)를 실행하거나, 저장소에 커밋된
|
||||
[워크플로](docs/WORKFLOW_AUTHORING.md)를 따를 수 있습니다.
|
||||
[하위 에이전트](../SUBAGENTS.md)에 나눠 맡기거나, 여러 에이전트로 구성된
|
||||
[Fleet](../FLEET.md)를 실행하거나, 저장소에 커밋된
|
||||
[워크플로](../WORKFLOW_AUTHORING.md)를 따를 수 있습니다.
|
||||
|
||||
### 다른 에이전트에서 옮겨 오는 경우
|
||||
|
||||
@@ -173,25 +173,25 @@ Codewhale은 따로 설정하지 않아도 `AGENTS.md`를 읽습니다. `CLAUDE.
|
||||
`.cursorrules`, `.github/copilot-instructions.md`처럼 다른 도구용으로 작성된
|
||||
지침 파일은 설정에서 `project_instruction_imports = ["claude"]`(또는
|
||||
`"cursor"`, `"cline"`, `"windsurf"`, `"copilot"`, `"all"`)로 직접 켠 경우에만
|
||||
불러옵니다. [config.example.toml](config.example.toml)을 참고하세요. 불러오지
|
||||
불러옵니다. [config.example.toml](../../config.example.toml)을 참고하세요. 불러오지
|
||||
않은 지침 파일을 발견하면 Codewhale이 경고를 표시합니다.
|
||||
|
||||
`/import-claude`는 사용자가 검토할 수 있도록 Claude Code 설정과 MCP 서버
|
||||
가져오기를 준비합니다. `/plugin install`은 스킬, 명령, 에이전트 프로필, MCP
|
||||
서버를 담은 Claude Code 플러그인을 받아들이고, 훅이나 LSP 서버가 필요한
|
||||
플러그인은 거부합니다([자세히](docs/CLAUDE_PLUGIN_COMPAT.md)).
|
||||
플러그인은 거부합니다([자세히](../CLAUDE_PLUGIN_COMPAT.md)).
|
||||
|
||||
### 확장
|
||||
|
||||
[MCP 서버](docs/MCP.md)를 연결하고, [스킬](docs/SKILLS.md)과
|
||||
[플러그인](docs/PLUGINS.md)을 추가하고, 세션 및 도구 이벤트에서
|
||||
[훅](docs/HOOKS.md)을 실행할 수 있습니다. 코드 모드(실험적, 기본으로 켜짐)에서는
|
||||
[MCP 서버](../MCP.md)를 연결하고, [스킬](../SKILLS.md)과
|
||||
[플러그인](../PLUGINS.md)을 추가하고, 세션 및 도구 이벤트에서
|
||||
[훅](../HOOKS.md)을 실행할 수 있습니다. 코드 모드(실험적, 기본으로 켜짐)에서는
|
||||
모델이 여러 MCP 및 플러그인 도구를 호출하는 `execute_tools` 프로그램 하나를
|
||||
작성할 수 있으며, 각 호출은 여전히 승인 규칙을 따르고 영수증에 남습니다. 기본
|
||||
포함된 Computer Use
|
||||
플러그인(실험적, macOS 전용)은 다른 앱을 관찰하고 조작할 수 있습니다. 접근
|
||||
범위를 검토하고 활성화하기 전까지는 꺼져 있습니다
|
||||
([안내서](crates/tui/plugins/computer-use/README.md)).
|
||||
([안내서](../../crates/tui/plugins/computer-use/README.md)).
|
||||
|
||||
## 실행 방법
|
||||
|
||||
@@ -199,13 +199,13 @@ Codewhale은 따로 설정하지 않아도 `AGENTS.md`를 읽습니다. `CLAUDE.
|
||||
| --- | --- |
|
||||
| `codewhale` | 대화형 터미널 앱 |
|
||||
| `codewhale exec "…"` | 인터페이스 없이 작업 하나를 실행합니다. 옵션 없이 쓰면 도구를 사용하지 않고 답변만 하고, `--auto`는 기본적으로 전체 접근 권한으로 도구를 활성화하고, `--sandbox workspace-write`는 도구를 제한하며, `--output-format stream-json`은 이벤트를 JSON으로 스트리밍합니다 |
|
||||
| `codewhale web` | `127.0.0.1`에서 동작하는 로컬 웹 UI([안내서](docs/WEB.md)) |
|
||||
| `codewhale review --pr N` | GitHub 풀 리퀘스트에 대한 참고용 리뷰. `--post`를 추가하지 않으면 아무것도 게시하지 않으며, [GitHub Action](docs/GITHUB_ACTION.md)이 CI에서 같은 리뷰를 실행합니다 |
|
||||
| `codewhale app-server --http` | 스레드, 이벤트, 승인, 각 턴의 파일 변경을 다루는 로컬 HTTP API인 [Runtime API](docs/RUNTIME_API.md) |
|
||||
| `codewhale web` | `127.0.0.1`에서 동작하는 로컬 웹 UI([안내서](../WEB.md)) |
|
||||
| `codewhale review --pr N` | GitHub 풀 리퀘스트에 대한 참고용 리뷰. `--post`를 추가하지 않으면 아무것도 게시하지 않으며, [GitHub Action](../GITHUB_ACTION.md)이 CI에서 같은 리뷰를 실행합니다 |
|
||||
| `codewhale app-server --http` | 스레드, 이벤트, 승인, 각 턴의 파일 변경을 다루는 로컬 HTTP API인 [Runtime API](../RUNTIME_API.md) |
|
||||
| `codewhale serve --acp` | Zed 같은 에디터를 위한 stdio 기반 Agent Client Protocol |
|
||||
|
||||
터미널 앱, `exec`, `web`, Runtime API는 하나의 엔진을 공유합니다
|
||||
([아키텍처](docs/ARCHITECTURE.md)). 커뮤니티가 관리하는
|
||||
([아키텍처](../ARCHITECTURE.md)). 커뮤니티가 관리하는
|
||||
[VS Code 확장](https://marketplace.visualstudio.com/items?itemName=HengQuWorld.brotherwhale-vscode)은
|
||||
사이드바에서 이 엔진에 연결됩니다([소스](https://github.com/HengQuWorld/CodeWhale-VSCode)).
|
||||
Runtime API를 기반으로 한 네이티브 데스크톱 앱이 개발 중이며, 아직 공개
|
||||
@@ -237,26 +237,26 @@ bubblewrap을 사용합니다. Windows에는 아직 OS 샌드박스가 없으며
|
||||
`codewhale config set telemetry false`로 끌 수 있습니다. Codewhale은 시작할 때
|
||||
GitHub에서 새 릴리스도 확인합니다. 이 확인을 건너뛰려면
|
||||
`CODEWHALE_NO_UPDATE_CHECK=1`을 설정하세요. 자세한 내용은
|
||||
[권한 확인 순서](docs/AUTHORIZATION_ORDER.md), [샌드박스](docs/SANDBOX.md),
|
||||
[텔레메트리](docs/TELEMETRY.md)를 참고하세요.
|
||||
[권한 확인 순서](../AUTHORIZATION_ORDER.md), [샌드박스](../SANDBOX.md),
|
||||
[텔레메트리](../TELEMETRY.md)를 참고하세요.
|
||||
|
||||
## 문서
|
||||
|
||||
| 시작하기 | 참고 자료 |
|
||||
| --- | --- |
|
||||
| [설치](docs/INSTALL.md) | [설정](docs/CONFIGURATION.md) |
|
||||
| [제공업체와 로컬 모델](docs/PROVIDERS.md) | [아키텍처](docs/ARCHITECTURE.md) |
|
||||
| [모드와 권한](docs/MODES.md) | [Runtime API](docs/RUNTIME_API.md) |
|
||||
| [단축키](docs/KEYBINDINGS.md) | [플러그인 작성](docs/PLUGIN_AUTHORING.md) |
|
||||
| [GitHub PR 리뷰](docs/GITHUB_ACTION.md) | [전체 문서](docs/README.md) |
|
||||
| [설치](../INSTALL.md) | [설정](../CONFIGURATION.md) |
|
||||
| [제공업체와 로컬 모델](../PROVIDERS.md) | [아키텍처](../ARCHITECTURE.md) |
|
||||
| [모드와 권한](../MODES.md) | [Runtime API](../RUNTIME_API.md) |
|
||||
| [단축키](../KEYBINDINGS.md) | [플러그인 작성](../PLUGIN_AUTHORING.md) |
|
||||
| [GitHub PR 리뷰](../GITHUB_ACTION.md) | [전체 문서](../README.md) |
|
||||
|
||||
## 커뮤니티
|
||||
|
||||
빠진 제공업체가 있거나 불편한 작업 흐름이 있으면
|
||||
[이슈를 열거나](https://github.com/codewhale-hq/CodeWhale/issues/new/choose)
|
||||
[풀 리퀘스트를 보내 주세요](CONTRIBUTING.md). 반영된 작업의 기여 이력은
|
||||
[풀 리퀘스트를 보내 주세요](../../CONTRIBUTING.md). 반영된 작업의 기여 이력은
|
||||
기여자에게 남으며, 무엇이 어디에 있는지는
|
||||
[저장소 구조](CONTRIBUTING.md#project-structure)에서 볼 수 있습니다.
|
||||
[저장소 구조](../../CONTRIBUTING.md#project-structure)에서 볼 수 있습니다.
|
||||
|
||||
[Discord](https://discord.gg/37gfS3ksug)에서 이야기하거나, WeChat에서 메인테이너
|
||||
Hunter(`hunterbown`)를 추가하고 Whale Brothers 그룹 가입을 요청하세요.
|
||||
@@ -265,9 +265,9 @@ Hunter(`hunterbown`)를 추가하고 Whale Brothers 그룹 가입을 요청하
|
||||
|
||||
Codewhale은 `deepseek-tui`에서 시작했으며 지금도 그 프로젝트의 설정과 세션을
|
||||
읽습니다. 독립적으로 유지되며 DeepSeek를 비롯한 어떤 모델 제공업체와도 제휴
|
||||
관계가 없습니다. [기여해 주신 모든 분](docs/CONTRIBUTORS.md)께 감사드립니다.
|
||||
관계가 없습니다. [기여해 주신 모든 분](../CONTRIBUTORS.md)께 감사드립니다.
|
||||
|
||||
[](docs/CONTRIBUTORS.md#everyone)
|
||||
[](../CONTRIBUTORS.md#everyone)
|
||||
|
||||
[MIT](LICENSE). 다른 오픈 소스 프로젝트에서 가져와 수정한 코드는
|
||||
[서드파티 고지](docs/THIRD_PARTY_NOTICES.md)에 정리되어 있습니다.
|
||||
[MIT](../../LICENSE). 다른 오픈 소스 프로젝트에서 가져와 수정한 코드는
|
||||
[서드파티 고지](../THIRD_PARTY_NOTICES.md)에 정리되어 있습니다.
|
||||
@@ -1,9 +1,9 @@
|
||||
<!-- source: README.md sha256:182e239fcdf7 -->
|
||||
<!-- source: README.md sha256:7e0946fcaecd -->
|
||||
<div align="center">
|
||||
|
||||
<picture>
|
||||
<source media="(prefers-color-scheme: dark)" srcset="brand/wordmark-inverted.svg">
|
||||
<img src="brand/wordmark.svg" alt="Codewhale" width="320">
|
||||
<source media="(prefers-color-scheme: dark)" srcset="../../brand/wordmark-inverted.svg">
|
||||
<img src="../../brand/wordmark.svg" alt="Codewhale" width="320">
|
||||
</picture>
|
||||
|
||||
**Agent programistyczny open source do terminala, który działa z dowolnym modelem.**
|
||||
@@ -18,14 +18,14 @@ oraz wywołań internetowych i MCP, które wykonał.
|
||||
[](https://github.com/codewhale-hq/CodeWhale/actions/workflows/ci.yml)
|
||||
[](https://crates.io/crates/codewhale-cli)
|
||||
[](https://www.npmjs.com/package/codewhale)
|
||||
[](LICENSE)
|
||||
[](../../LICENSE)
|
||||
[](https://discord.gg/37gfS3ksug)
|
||||
|
||||
[Strona](https://codewhale.net) · [Dokumentacja](docs/README.md) · [Dziennik zmian](CHANGELOG.md) · [Współtworzenie](CONTRIBUTING.md)
|
||||
[Strona](https://codewhale.net) · [Dokumentacja](../README.md) · [Dziennik zmian](../../CHANGELOG.md) · [Współtworzenie](../../CONTRIBUTING.md)
|
||||
|
||||
[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) · [العربية](README.ar.md) · [Català](README.ca.md)
|
||||
[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) · [العربية](README.ar.md) · [Català](README.ca.md)
|
||||
|
||||
<img src="web/public/codewhale-tui-0102-demo.png" alt="Sesja Codewhale w terminalu" width="760">
|
||||
<img src="../../web/public/codewhale-tui-0102-demo.png" alt="Sesja Codewhale w terminalu" width="760">
|
||||
|
||||
<sub>Wersja rozwojowa 0.10.2 ze skryptowanym modelem testowym, z uprawnieniem Full Access, w jednorazowym obszarze roboczym. Edycja, trzy testy i przegląd wykonany przez subagenta odbyły się naprawdę.</sub>
|
||||
|
||||
@@ -42,10 +42,10 @@ curl -fsSL https://codewhale.net/install.sh | sh
|
||||
Instalator umieszcza w `~/.local/bin` plik `codewhale` i jego krótki alias
|
||||
`codew`, po weryfikacji sum kontrolnych. Jeśli powłoka zgłosi potem
|
||||
`command not found`, uruchom linię z PATH, którą wypisuje instalator
|
||||
([szczegóły](docs/INSTALL.md#put-it-on-your-path)). Do aktualizacji służy
|
||||
([szczegóły](../INSTALL.md#put-it-on-your-path)). Do aktualizacji służy
|
||||
`codewhale update`. Te polecenia instalują najnowsze wydanie. Ta strona opisuje
|
||||
gałąź `main`, więc funkcja oznaczona wersją pojawi się w tym wydaniu;
|
||||
[dziennik zmian](CHANGELOG.md) pokazuje, co wnosi każde wydanie.
|
||||
[dziennik zmian](../../CHANGELOG.md) pokazuje, co wnosi każde wydanie.
|
||||
|
||||
<details>
|
||||
<summary><b>Windows, npm, Cargo i inne sposoby instalacji</b></summary>
|
||||
@@ -58,8 +58,8 @@ cargo install codewhale-cli --locked # crates.io; can trail GitHub Releases
|
||||
|
||||
Gotowe pliki binarne są dostępne dla Linuksa, macOS i Windows na x64 i arm64.
|
||||
Nix, Homebrew w Linuksie, Android/Termux (wersja zapoznawcza) i ręczne
|
||||
pobieranie opisuje [przewodnik instalacji](docs/INSTALL.md), a kontenery
|
||||
[Docker](docs/DOCKER.md). Na jednej maszynie używaj jednej metody instalacji;
|
||||
pobieranie opisuje [przewodnik instalacji](../INSTALL.md), a kontenery
|
||||
[Docker](../DOCKER.md). Na jednej maszynie używaj jednej metody instalacji;
|
||||
inaczej w `PATH` znajdą się dwie kopie i zadziała ta, która jest pierwsza.
|
||||
|
||||
</details>
|
||||
@@ -107,7 +107,7 @@ codewhale exec --auto --sandbox workspace-write "fix the failing tests and expla
|
||||
| Tryb | `Tab` (gdy pole wprowadzania jest puste) lub `/mode` | **Plan** czyta i przeszukuje, ale niczego nie zmienia. **Work** edytuje pliki i uruchamia polecenia. **Operate** ma ten sam dostęp co Work, traktuje Twoje zlecenie jako cel i działa dalej, dopóki cel nie zostanie zweryfikowany albo nie będzie potrzebował informacji od Ciebie. |
|
||||
| Uprawnienie | `Shift+Tab` | **Ask** wprowadza zmiany w plikach Twojego repozytorium bez pytania i pyta przed poleceniami powłoki, które nie są tylko do odczytu. **Auto-Review** pozwala regułom i modelowi recenzującemu zatwierdzać rutynowe wywołania, a wywołania wysokiego ryzyka odrzuca; aby zatwierdzać je samodzielnie, przełącz na Ask. **Full Access** nigdy nie pyta i wyłącza piaskownicę Codewhale; reguły repozytorium i polityka zarządzana nadal obowiązują. |
|
||||
|
||||
Szczegóły opisuje [przewodnik po trybach i uprawnieniach](docs/MODES.md).
|
||||
Szczegóły opisuje [przewodnik po trybach i uprawnieniach](../MODES.md).
|
||||
|
||||
## Co potrafi
|
||||
|
||||
@@ -142,13 +142,13 @@ Google, Mistral, Moonshot, OpenRouter i xAI. Działa każdy punkt końcowy zgodn
|
||||
z OpenAI, a także modele lokalne przez Ollama, vLLM lub SGLang. Domyślnym
|
||||
modelem jest `deepseek-flash` od DeepSeek, który DeepSeek 2026-10-17 przełączył
|
||||
na DeepSeek-V4.1-Flash-1017; 0.10.1 obsługuje go bez aktualizacji
|
||||
([szczegóły](docs/PROVIDERS.md#deepseek-v41-flash)).
|
||||
([szczegóły](../PROVIDERS.md#deepseek-v41-flash)).
|
||||
|
||||
`/model` przełącza model między turami, a `/model auto` wybiera model dla
|
||||
każdej tury (sposób wyboru ustawia `/router`). `/turn inspect` pokazuje, jakiego
|
||||
modelu użyła tura, ile kosztowała i jak długo trwała. `codewhale auth chatgpt`
|
||||
pozwala korzystać z subskrypcji ChatGPT zamiast klucza API (eksperymentalnie).
|
||||
Zobacz [Dostawcy](docs/PROVIDERS.md).
|
||||
Zobacz [Dostawcy](../PROVIDERS.md).
|
||||
|
||||
### Pokwitowania i cofanie
|
||||
|
||||
@@ -159,7 +159,7 @@ niepowodzeń. `/undo` cofa Twoje ostatnie zlecenie; w 0.10.1 wymaga
|
||||
`/trust on` dla plików i cofa po jednym wywołaniu narzędzia naraz. `/restore`
|
||||
przywraca cały obszar roboczy do wcześniejszej migawki; ponieważ nadpisuje to
|
||||
późniejsze zmiany, wymaga `/trust on` lub Full Access. Zobacz
|
||||
[Pokwitowania](docs/RECEIPTS.md).
|
||||
[Pokwitowania](../RECEIPTS.md).
|
||||
|
||||
Uruchomienia exec z dostępnymi narzędziami są zapisywane w każdym formacie
|
||||
wyjściowym, więc `codewhale receipts --last` działa po `exec --auto`, także
|
||||
@@ -171,9 +171,9 @@ lub `exec --continue`.
|
||||
### Dłuższa praca
|
||||
|
||||
`/goal` ustawia cel, który obowiązuje przez kolejne tury. Codewhale może
|
||||
podzielić pracę między [subagentów](docs/SUBAGENTS.md), uruchomić
|
||||
[flotę](docs/FLEET.md) agentów albo wykonać
|
||||
[przepływ pracy](docs/WORKFLOW_AUTHORING.md) zapisany w repozytorium.
|
||||
podzielić pracę między [subagentów](../SUBAGENTS.md), uruchomić
|
||||
[flotę](../FLEET.md) agentów albo wykonać
|
||||
[przepływ pracy](../WORKFLOW_AUTHORING.md) zapisany w repozytorium.
|
||||
|
||||
### Przejście z innego agenta
|
||||
|
||||
@@ -182,26 +182,26 @@ takie jak `CLAUDE.md`, `.cursorrules` czy `.github/copilot-instructions.md`, są
|
||||
wczytywane tylko wtedy, gdy włączysz to w konfiguracji ustawieniem
|
||||
`project_instruction_imports = ["claude"]` (lub `"cursor"`, `"cline"`,
|
||||
`"windsurf"`, `"copilot"`, `"all"`); zobacz
|
||||
[config.example.toml](config.example.toml). Codewhale ostrzega, gdy znajdzie
|
||||
[config.example.toml](../../config.example.toml). Codewhale ostrzega, gdy znajdzie
|
||||
taki plik, którego nie wczytał.
|
||||
|
||||
`/import-claude` przygotowuje import Twoich ustawień Claude Code i serwerów MCP
|
||||
do przejrzenia. `/plugin install` przyjmuje wtyczki Claude Code zawierające
|
||||
umiejętności, polecenia, profile agentów i serwery MCP, a odrzuca wtyczki
|
||||
wymagające hooków lub serwerów LSP
|
||||
([szczegóły](docs/CLAUDE_PLUGIN_COMPAT.md)).
|
||||
([szczegóły](../CLAUDE_PLUGIN_COMPAT.md)).
|
||||
|
||||
### Rozszerzenia
|
||||
|
||||
Podłączaj [serwery MCP](docs/MCP.md), dodawaj [umiejętności](docs/SKILLS.md) i
|
||||
[wtyczki](docs/PLUGINS.md) oraz uruchamiaj [hooki](docs/HOOKS.md) na
|
||||
Podłączaj [serwery MCP](../MCP.md), dodawaj [umiejętności](../SKILLS.md) i
|
||||
[wtyczki](../PLUGINS.md) oraz uruchamiaj [hooki](../HOOKS.md) na
|
||||
zdarzeniach sesji i narzędzi. Code mode (eksperymentalny, domyślnie włączony)
|
||||
pozwala modelowi napisać jeden program `execute_tools`, który wywołuje kilka
|
||||
narzędzi MCP i wtyczek; każde wywołanie nadal podlega Twoim regułom
|
||||
zatwierdzania i ma własne pokwitowanie. Dołączona wtyczka Computer Use
|
||||
(eksperymentalna, tylko macOS) potrafi obserwować i obsługiwać inne aplikacje.
|
||||
Pozostaje wyłączona, dopóki nie sprawdzisz jej dostępu i jej nie włączysz
|
||||
([przewodnik](crates/tui/plugins/computer-use/README.md)).
|
||||
([przewodnik](../../crates/tui/plugins/computer-use/README.md)).
|
||||
|
||||
## Sposoby uruchamiania
|
||||
|
||||
@@ -209,13 +209,13 @@ Pozostaje wyłączona, dopóki nie sprawdzisz jej dostępu i jej nie włączysz
|
||||
| --- | --- |
|
||||
| `codewhale` | Interaktywna aplikacja terminalowa |
|
||||
| `codewhale exec "…"` | Jedno zadanie bez interfejsu. Bez dodatkowych flag odpowiada bez użycia narzędzi; `--auto` domyślnie włącza narzędzia z Full Access, `--sandbox workspace-write` je ogranicza, a `--output-format stream-json` strumieniuje zdarzenia jako JSON |
|
||||
| `codewhale web` | Lokalny interfejs przeglądarkowy pod `127.0.0.1` ([przewodnik](docs/WEB.md)) |
|
||||
| `codewhale review --pr N` | Doradczy przegląd pull requesta na GitHubie. Niczego nie publikuje, chyba że dodasz `--post`; [GitHub Action](docs/GITHUB_ACTION.md) uruchamia ten sam przegląd w CI |
|
||||
| `codewhale app-server --http` | [Runtime API](docs/RUNTIME_API.md), lokalne HTTP API dla wątków, zdarzeń, zatwierdzeń i zmian w plikach z każdej tury |
|
||||
| `codewhale web` | Lokalny interfejs przeglądarkowy pod `127.0.0.1` ([przewodnik](../WEB.md)) |
|
||||
| `codewhale review --pr N` | Doradczy przegląd pull requesta na GitHubie. Niczego nie publikuje, chyba że dodasz `--post`; [GitHub Action](../GITHUB_ACTION.md) uruchamia ten sam przegląd w CI |
|
||||
| `codewhale app-server --http` | [Runtime API](../RUNTIME_API.md), lokalne HTTP API dla wątków, zdarzeń, zatwierdzeń i zmian w plikach z każdej tury |
|
||||
| `codewhale serve --acp` | Agent Client Protocol przez stdio, dla edytorów takich jak Zed |
|
||||
|
||||
Aplikacja terminalowa, `exec`, `web` i Runtime API korzystają z jednego silnika
|
||||
([architektura](docs/ARCHITECTURE.md)). Utrzymywane przez społeczność
|
||||
([architektura](../ARCHITECTURE.md)). Utrzymywane przez społeczność
|
||||
[rozszerzenie VS Code](https://marketplace.visualstudio.com/items?itemName=HengQuWorld.brotherwhale-vscode)
|
||||
łączy się z nim z panelu bocznego ([kod źródłowy](https://github.com/HengQuWorld/CodeWhale-VSCode)).
|
||||
Natywna aplikacja desktopowa oparta na Runtime API jest w trakcie tworzenia;
|
||||
@@ -250,25 +250,25 @@ ani repozytoriów, ani danych uwierzytelniających.
|
||||
`codewhale config set telemetry false` ją wyłącza. Przy uruchomieniu Codewhale
|
||||
sprawdza też na GitHubie, czy jest nowe wydanie; ustaw
|
||||
`CODEWHALE_NO_UPDATE_CHECK=1`, aby to pominąć. Więcej o
|
||||
[kolejności autoryzacji](docs/AUTHORIZATION_ORDER.md),
|
||||
[piaskownicy](docs/SANDBOX.md) i [telemetrii](docs/TELEMETRY.md).
|
||||
[kolejności autoryzacji](../AUTHORIZATION_ORDER.md),
|
||||
[piaskownicy](../SANDBOX.md) i [telemetrii](../TELEMETRY.md).
|
||||
|
||||
## Dokumentacja
|
||||
|
||||
| Zacznij tutaj | Materiały referencyjne |
|
||||
| --- | --- |
|
||||
| [Instalacja](docs/INSTALL.md) | [Konfiguracja](docs/CONFIGURATION.md) |
|
||||
| [Dostawcy i modele lokalne](docs/PROVIDERS.md) | [Architektura](docs/ARCHITECTURE.md) |
|
||||
| [Tryby i uprawnienia](docs/MODES.md) | [Runtime API](docs/RUNTIME_API.md) |
|
||||
| [Skróty klawiszowe](docs/KEYBINDINGS.md) | [Tworzenie wtyczek](docs/PLUGIN_AUTHORING.md) |
|
||||
| [Przegląd PR na GitHubie](docs/GITHUB_ACTION.md) | [Cała dokumentacja](docs/README.md) |
|
||||
| [Instalacja](../INSTALL.md) | [Konfiguracja](../CONFIGURATION.md) |
|
||||
| [Dostawcy i modele lokalne](../PROVIDERS.md) | [Architektura](../ARCHITECTURE.md) |
|
||||
| [Tryby i uprawnienia](../MODES.md) | [Runtime API](../RUNTIME_API.md) |
|
||||
| [Skróty klawiszowe](../KEYBINDINGS.md) | [Tworzenie wtyczek](../PLUGIN_AUTHORING.md) |
|
||||
| [Przegląd PR na GitHubie](../GITHUB_ACTION.md) | [Cała dokumentacja](../README.md) |
|
||||
|
||||
## Społeczność
|
||||
|
||||
Jeśli brakuje dostawcy albo jakiś przepływ pracy jest niewygodny,
|
||||
[otwórz issue](https://github.com/codewhale-hq/CodeWhale/issues/new/choose) lub
|
||||
[wyślij pull request](CONTRIBUTING.md). Autorzy zachowują uznanie za pracę,
|
||||
która zostanie włączona, a [struktura repozytorium](CONTRIBUTING.md#project-structure)
|
||||
[wyślij pull request](../../CONTRIBUTING.md). Autorzy zachowują uznanie za pracę,
|
||||
która zostanie włączona, a [struktura repozytorium](../../CONTRIBUTING.md#project-structure)
|
||||
pokazuje, gdzie co się znajduje.
|
||||
|
||||
Rozmawiaj na [Discordzie](https://discord.gg/37gfS3ksug) albo dodaj opiekuna
|
||||
@@ -280,9 +280,9 @@ Whale Brothers.
|
||||
Codewhale zaczynał jako `deepseek-tui` i nadal czyta konfigurację oraz sesje
|
||||
tego projektu. Jest utrzymywany niezależnie i nie jest powiązany z DeepSeek ani
|
||||
z żadnym innym dostawcą modeli. Dziękujemy
|
||||
[wszystkim, którzy wnieśli swój wkład](docs/CONTRIBUTORS.md).
|
||||
[wszystkim, którzy wnieśli swój wkład](../CONTRIBUTORS.md).
|
||||
|
||||
[](docs/CONTRIBUTORS.md#everyone)
|
||||
[](../CONTRIBUTORS.md#everyone)
|
||||
|
||||
[MIT](LICENSE). Kod zaadaptowany z innych projektów open source wymieniono w
|
||||
[informacjach o komponentach zewnętrznych](docs/THIRD_PARTY_NOTICES.md).
|
||||
[MIT](../../LICENSE). Kod zaadaptowany z innych projektów open source wymieniono w
|
||||
[informacjach o komponentach zewnętrznych](../THIRD_PARTY_NOTICES.md).
|
||||
@@ -1,9 +1,9 @@
|
||||
<!-- source: README.md sha256:182e239fcdf7 -->
|
||||
<!-- source: README.md sha256:7e0946fcaecd -->
|
||||
<div align="center">
|
||||
|
||||
<picture>
|
||||
<source media="(prefers-color-scheme: dark)" srcset="brand/wordmark-inverted.svg">
|
||||
<img src="brand/wordmark.svg" alt="Codewhale" width="320">
|
||||
<source media="(prefers-color-scheme: dark)" srcset="../../brand/wordmark-inverted.svg">
|
||||
<img src="../../brand/wordmark.svg" alt="Codewhale" width="320">
|
||||
</picture>
|
||||
|
||||
**Um agente de programação de código aberto para o seu terminal que funciona com qualquer modelo.**
|
||||
@@ -17,14 +17,14 @@ os comandos que executou e as chamadas web e MCP que fez.
|
||||
[](https://github.com/codewhale-hq/CodeWhale/actions/workflows/ci.yml)
|
||||
[](https://crates.io/crates/codewhale-cli)
|
||||
[](https://www.npmjs.com/package/codewhale)
|
||||
[](LICENSE)
|
||||
[](../../LICENSE)
|
||||
[](https://discord.gg/37gfS3ksug)
|
||||
|
||||
[Site](https://codewhale.net) · [Documentação](docs/README.md) · [Changelog](CHANGELOG.md) · [Contribuindo](CONTRIBUTING.md)
|
||||
[Site](https://codewhale.net) · [Documentação](../README.md) · [Changelog](../../CHANGELOG.md) · [Contribuindo](../../CONTRIBUTING.md)
|
||||
|
||||
[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) · [Русский](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) · [Català](README.ca.md)
|
||||
[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) · [Русский](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) · [Català](README.ca.md)
|
||||
|
||||
<img src="web/public/codewhale-tui-0102-demo.png" alt="Uma sessão de terminal do Codewhale" width="760">
|
||||
<img src="../../web/public/codewhale-tui-0102-demo.png" alt="Uma sessão de terminal do Codewhale" width="760">
|
||||
|
||||
<sub>Um build de desenvolvimento da 0.10.2 com um modelo de teste roteirizado, em Acesso total dentro de um workspace descartável. A edição, três testes e uma revisão de sub-agente rodaram de verdade.</sub>
|
||||
|
||||
@@ -41,10 +41,10 @@ curl -fsSL https://codewhale.net/install.sh | sh
|
||||
O instalador coloca `codewhale` e o alias curto `codew`, com checksum
|
||||
verificado, em `~/.local/bin`. Se depois o shell responder `command not found`,
|
||||
execute a linha de PATH que o instalador exibe
|
||||
([detalhes](docs/INSTALL.md#put-it-on-your-path)). `codewhale update` faz a
|
||||
([detalhes](../INSTALL.md#put-it-on-your-path)). `codewhale update` faz a
|
||||
atualização. Esses comandos instalam a versão mais recente. Esta página
|
||||
acompanha a branch `main`, então um recurso marcado com uma versão chega nessa
|
||||
versão; o [changelog](CHANGELOG.md) lista o que cada versão traz.
|
||||
versão; o [changelog](../../CHANGELOG.md) lista o que cada versão traz.
|
||||
|
||||
<details>
|
||||
<summary><b>Windows, npm, Cargo e outras formas de instalar</b></summary>
|
||||
@@ -57,8 +57,8 @@ cargo install codewhale-cli --locked # crates.io; can trail GitHub Releases
|
||||
|
||||
Há binários pré-compilados para Linux, macOS e Windows em x64 e arm64. Nix,
|
||||
Homebrew no Linux, Android/Termux (prévia) e downloads manuais estão no
|
||||
[guia de instalação](docs/INSTALL.md), e contêineres em
|
||||
[Docker](docs/DOCKER.md). Use um único método de instalação por máquina; caso
|
||||
[guia de instalação](../INSTALL.md), e contêineres em
|
||||
[Docker](../DOCKER.md). Use um único método de instalação por máquina; caso
|
||||
contrário, duas cópias acabam no `PATH` e vale a que vier primeiro.
|
||||
|
||||
</details>
|
||||
@@ -106,7 +106,7 @@ Uma instalação nova começa no modo Work com a permissão Perguntar.
|
||||
| Modo | `Tab` (com o campo de entrada vazio) ou `/mode` | **Plan** lê e pesquisa, mas não altera nada. **Work** edita arquivos e executa comandos. **Operate** tem o mesmo acesso que o Work, trata seu pedido como um objetivo e continua até o objetivo ser verificado ou precisar de uma resposta sua. |
|
||||
| Permissão | `Shift+Tab` | **Perguntar** (Ask) aplica edições de arquivos no seu repositório sem perguntar e pergunta antes de comandos de shell que não sejam somente leitura. **Revisão automática** (Auto-Review) deixa regras e um modelo revisor aprovarem chamadas rotineiras e recusa as de alto risco; mude para Perguntar para aprová-las você mesmo. **Acesso total** (Full Access) nunca pergunta e desliga o sandbox do Codewhale; as regras do repositório e a política gerenciada continuam valendo. |
|
||||
|
||||
Os detalhes estão no [guia de modos e permissões](docs/MODES.md).
|
||||
Os detalhes estão no [guia de modos e permissões](../MODES.md).
|
||||
|
||||
## O que ele faz
|
||||
|
||||
@@ -138,13 +138,13 @@ Google, Mistral, Moonshot, OpenRouter e xAI. Qualquer endpoint compatível com
|
||||
OpenAI funciona, assim como modelos locais via Ollama, vLLM ou SGLang. O padrão
|
||||
é o `deepseek-flash` da DeepSeek, que a DeepSeek passou para o
|
||||
DeepSeek-V4.1-Flash-1017 em 2026-10-17; a 0.10.1 o executa sem precisar de
|
||||
atualização ([detalhes](docs/PROVIDERS.md#deepseek-v41-flash)).
|
||||
atualização ([detalhes](../PROVIDERS.md#deepseek-v41-flash)).
|
||||
|
||||
`/model` troca de modelo entre turnos, e `/model auto` escolhe um para cada
|
||||
turno (`/router` configura como). `/turn inspect` mostra qual modelo um turno
|
||||
usou, quanto custou e quanto tempo levou. `codewhale auth chatgpt` permite usar
|
||||
um plano do ChatGPT em vez de uma chave de API (experimental). Veja
|
||||
[Provedores](docs/PROVIDERS.md).
|
||||
[Provedores](../PROVIDERS.md).
|
||||
|
||||
### Recibos e desfazer
|
||||
|
||||
@@ -154,7 +154,7 @@ iniciados, as aprovações e quem as deu, e as falhas. `/undo` desfaz seu últim
|
||||
pedido; na 0.10.1, ele exige `/trust on` para arquivos e volta uma chamada de
|
||||
ferramenta por vez. `/restore` volta o workspace inteiro para um snapshot
|
||||
anterior; como isso sobrescreve edições posteriores, exige `/trust on` ou Acesso
|
||||
total. Veja [Recibos](docs/RECEIPTS.md).
|
||||
total. Veja [Recibos](../RECEIPTS.md).
|
||||
|
||||
As execuções de exec que oferecem ferramentas são salvas em todos os formatos
|
||||
de saída, então `codewhale receipts --last` funciona depois de `exec --auto`,
|
||||
@@ -166,9 +166,9 @@ os recibos ou para `exec --continue`.
|
||||
### Trabalhos mais longos
|
||||
|
||||
`/goal` define um objetivo que se mantém entre turnos. O Codewhale pode dividir
|
||||
o trabalho entre [sub-agentes](docs/SUBAGENTS.md), executar uma
|
||||
[frota](docs/FLEET.md) de agentes ou seguir um
|
||||
[workflow](docs/WORKFLOW_AUTHORING.md) versionado no repositório.
|
||||
o trabalho entre [sub-agentes](../SUBAGENTS.md), executar uma
|
||||
[frota](../FLEET.md) de agentes ou seguir um
|
||||
[workflow](../WORKFLOW_AUTHORING.md) versionado no repositório.
|
||||
|
||||
### Vindo de outro agente
|
||||
|
||||
@@ -177,26 +177,26 @@ para outras ferramentas, como `CLAUDE.md`, `.cursorrules` ou
|
||||
`.github/copilot-instructions.md`, só são carregados quando você opta por eles
|
||||
com `project_instruction_imports = ["claude"]` (ou `"cursor"`, `"cline"`,
|
||||
`"windsurf"`, `"copilot"`, `"all"`) na sua configuração; veja
|
||||
[config.example.toml](config.example.toml). O Codewhale avisa quando encontra
|
||||
[config.example.toml](../../config.example.toml). O Codewhale avisa quando encontra
|
||||
um que não carregou.
|
||||
|
||||
`/import-claude` prepara uma importação das suas configurações e servidores MCP
|
||||
do Claude Code para você revisar. `/plugin install` aceita plugins do Claude
|
||||
Code que contêm skills, comandos, perfis de agente e servidores MCP, e recusa
|
||||
plugins que precisam de hooks ou servidores LSP
|
||||
([detalhes](docs/CLAUDE_PLUGIN_COMPAT.md)).
|
||||
([detalhes](../CLAUDE_PLUGIN_COMPAT.md)).
|
||||
|
||||
### Extensões
|
||||
|
||||
Conecte [servidores MCP](docs/MCP.md), adicione [skills](docs/SKILLS.md) e
|
||||
[plugins](docs/PLUGINS.md) e execute [hooks](docs/HOOKS.md) em eventos de
|
||||
Conecte [servidores MCP](../MCP.md), adicione [skills](../SKILLS.md) e
|
||||
[plugins](../PLUGINS.md) e execute [hooks](../HOOKS.md) em eventos de
|
||||
sessão e de ferramentas. O Code mode (experimental, ativado por padrão) permite
|
||||
que o modelo escreva um único programa `execute_tools` que chama várias
|
||||
ferramentas de MCP e de plugins; cada chamada continua sujeita às suas regras de
|
||||
aprovação e mantém o seu recibo. O plugin Computer Use incluído (experimental,
|
||||
só no macOS) pode observar e operar outros aplicativos. Ele fica desligado até você
|
||||
revisar o acesso dele e ativá-lo
|
||||
([guia](crates/tui/plugins/computer-use/README.md)).
|
||||
([guia](../../crates/tui/plugins/computer-use/README.md)).
|
||||
|
||||
## Formas de executar
|
||||
|
||||
@@ -204,13 +204,13 @@ revisar o acesso dele e ativá-lo
|
||||
| --- | --- |
|
||||
| `codewhale` | O aplicativo interativo de terminal |
|
||||
| `codewhale exec "…"` | Uma tarefa sem a interface. Sozinho, ele responde sem usar ferramentas; `--auto` habilita ferramentas com Acesso total por padrão, `--sandbox workspace-write` as restringe, e `--output-format stream-json` transmite os eventos como JSON |
|
||||
| `codewhale web` | Uma interface web local em `127.0.0.1` ([guia](docs/WEB.md)) |
|
||||
| `codewhale review --pr N` | Uma revisão consultiva de um pull request do GitHub. Não publica nada a menos que você adicione `--post`; a [GitHub Action](docs/GITHUB_ACTION.md) executa a mesma revisão no CI |
|
||||
| `codewhale app-server --http` | A [Runtime API](docs/RUNTIME_API.md), uma API HTTP local para threads, eventos, aprovações e as alterações de arquivos de cada turno |
|
||||
| `codewhale web` | Uma interface web local em `127.0.0.1` ([guia](../WEB.md)) |
|
||||
| `codewhale review --pr N` | Uma revisão consultiva de um pull request do GitHub. Não publica nada a menos que você adicione `--post`; a [GitHub Action](../GITHUB_ACTION.md) executa a mesma revisão no CI |
|
||||
| `codewhale app-server --http` | A [Runtime API](../RUNTIME_API.md), uma API HTTP local para threads, eventos, aprovações e as alterações de arquivos de cada turno |
|
||||
| `codewhale serve --acp` | O Agent Client Protocol via stdio, para editores como o Zed |
|
||||
|
||||
O aplicativo de terminal, o `exec`, o `web` e a Runtime API compartilham um
|
||||
único engine ([arquitetura](docs/ARCHITECTURE.md)). Uma
|
||||
único engine ([arquitetura](../ARCHITECTURE.md)). Uma
|
||||
[extensão do VS Code](https://marketplace.visualstudio.com/items?itemName=HengQuWorld.brotherwhale-vscode)
|
||||
mantida pela comunidade se conecta a ele pela barra lateral
|
||||
([código-fonte](https://github.com/HengQuWorld/CodeWhale-VSCode)).
|
||||
@@ -245,26 +245,26 @@ muda a cada 90 dias, e nunca envia conversas, código, prompts, nomes de modelos
|
||||
nomes de arquivos ou de repositórios, nem credenciais. `codewhale config set telemetry false` a desativa. Na
|
||||
inicialização, o Codewhale também consulta o GitHub em busca de uma nova
|
||||
versão; defina `CODEWHALE_NO_UPDATE_CHECK=1` para pular essa verificação. Mais
|
||||
em [ordem de autorização](docs/AUTHORIZATION_ORDER.md),
|
||||
[sandboxing](docs/SANDBOX.md) e [telemetria](docs/TELEMETRY.md).
|
||||
em [ordem de autorização](../AUTHORIZATION_ORDER.md),
|
||||
[sandboxing](../SANDBOX.md) e [telemetria](../TELEMETRY.md).
|
||||
|
||||
## Documentação
|
||||
|
||||
| Comece aqui | Referência |
|
||||
| --- | --- |
|
||||
| [Instalação](docs/INSTALL.md) | [Configuração](docs/CONFIGURATION.md) |
|
||||
| [Provedores e modelos locais](docs/PROVIDERS.md) | [Arquitetura](docs/ARCHITECTURE.md) |
|
||||
| [Modos e permissões](docs/MODES.md) | [Runtime API](docs/RUNTIME_API.md) |
|
||||
| [Atalhos de teclado](docs/KEYBINDINGS.md) | [Criação de plugins](docs/PLUGIN_AUTHORING.md) |
|
||||
| [Revisão de PR no GitHub](docs/GITHUB_ACTION.md) | [Toda a documentação](docs/README.md) |
|
||||
| [Instalação](../INSTALL.md) | [Configuração](../CONFIGURATION.md) |
|
||||
| [Provedores e modelos locais](../PROVIDERS.md) | [Arquitetura](../ARCHITECTURE.md) |
|
||||
| [Modos e permissões](../MODES.md) | [Runtime API](../RUNTIME_API.md) |
|
||||
| [Atalhos de teclado](../KEYBINDINGS.md) | [Criação de plugins](../PLUGIN_AUTHORING.md) |
|
||||
| [Revisão de PR no GitHub](../GITHUB_ACTION.md) | [Toda a documentação](../README.md) |
|
||||
|
||||
## Comunidade
|
||||
|
||||
Se faltar um provedor ou algum fluxo de trabalho for incômodo,
|
||||
[abra uma issue](https://github.com/codewhale-hq/CodeWhale/issues/new/choose) ou
|
||||
[envie um pull request](CONTRIBUTING.md). Quem contribui mantém o crédito pelo
|
||||
[envie um pull request](../../CONTRIBUTING.md). Quem contribui mantém o crédito pelo
|
||||
trabalho incorporado, e a
|
||||
[estrutura do repositório](CONTRIBUTING.md#project-structure) mostra onde fica
|
||||
[estrutura do repositório](../../CONTRIBUTING.md#project-structure) mostra onde fica
|
||||
cada coisa.
|
||||
|
||||
Converse no [Discord](https://discord.gg/37gfS3ksug), ou adicione o mantenedor,
|
||||
@@ -275,9 +275,9 @@ Hunter, no WeChat (`hunterbown`) e peça para entrar no grupo Whale Brothers.
|
||||
O Codewhale começou como `deepseek-tui` e ainda lê a configuração e as sessões
|
||||
desse projeto. Ele é mantido de forma independente e não é afiliado à DeepSeek
|
||||
nem a nenhum outro provedor de modelos. Agradecemos a
|
||||
[todos que contribuíram](docs/CONTRIBUTORS.md).
|
||||
[todos que contribuíram](../CONTRIBUTORS.md).
|
||||
|
||||
[](docs/CONTRIBUTORS.md#everyone)
|
||||
[](../CONTRIBUTORS.md#everyone)
|
||||
|
||||
[MIT](LICENSE). O código adaptado de outros projetos de código aberto está
|
||||
listado nos [avisos de terceiros](docs/THIRD_PARTY_NOTICES.md).
|
||||
[MIT](../../LICENSE). O código adaptado de outros projetos de código aberto está
|
||||
listado nos [avisos de terceiros](../THIRD_PARTY_NOTICES.md).
|
||||
@@ -1,9 +1,9 @@
|
||||
<!-- source: README.md sha256:182e239fcdf7 -->
|
||||
<!-- source: README.md sha256:7e0946fcaecd -->
|
||||
<div align="center">
|
||||
|
||||
<picture>
|
||||
<source media="(prefers-color-scheme: dark)" srcset="brand/wordmark-inverted.svg">
|
||||
<img src="brand/wordmark.svg" alt="Codewhale" width="320">
|
||||
<source media="(prefers-color-scheme: dark)" srcset="../../brand/wordmark-inverted.svg">
|
||||
<img src="../../brand/wordmark.svg" alt="Codewhale" width="320">
|
||||
</picture>
|
||||
|
||||
**Агент для программирования в терминале с открытым исходным кодом, который работает с любой моделью.**
|
||||
@@ -18,14 +18,14 @@ Flash) и с моделями, запущенными на вашей собст
|
||||
[](https://github.com/codewhale-hq/CodeWhale/actions/workflows/ci.yml)
|
||||
[](https://crates.io/crates/codewhale-cli)
|
||||
[](https://www.npmjs.com/package/codewhale)
|
||||
[](LICENSE)
|
||||
[](../../LICENSE)
|
||||
[](https://discord.gg/37gfS3ksug)
|
||||
|
||||
[Сайт](https://codewhale.net) · [Документация](docs/README.md) · [Список изменений](CHANGELOG.md) · [Участие в проекте](CONTRIBUTING.md)
|
||||
[Сайт](https://codewhale.net) · [Документация](../README.md) · [Список изменений](../../CHANGELOG.md) · [Участие в проекте](../../CONTRIBUTING.md)
|
||||
|
||||
[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.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) · [Català](README.ca.md)
|
||||
[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.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) · [Català](README.ca.md)
|
||||
|
||||
<img src="web/public/codewhale-tui-0102-demo.png" alt="Сессия Codewhale в терминале" width="760">
|
||||
<img src="../../web/public/codewhale-tui-0102-demo.png" alt="Сессия Codewhale в терминале" width="760">
|
||||
|
||||
<sub>Сборка 0.10.2 для разработки с тестовой моделью, работающей по сценарию, с разрешением Full Access в одноразовой рабочей области. Правка, три теста и проверка субагентом были выполнены по-настоящему.</sub>
|
||||
|
||||
@@ -42,11 +42,11 @@ curl -fsSL https://codewhale.net/install.sh | sh
|
||||
Установщик проверяет контрольные суммы и кладёт `codewhale` и его короткий
|
||||
псевдоним `codew` в `~/.local/bin`. Если после этого оболочка выдаёт
|
||||
`command not found`, выполните строку для PATH, которую выводит установщик
|
||||
([подробнее](docs/INSTALL.md#put-it-on-your-path)). Обновление — командой
|
||||
([подробнее](../INSTALL.md#put-it-on-your-path)). Обновление — командой
|
||||
`codewhale update`. Эти команды устанавливают последний релиз. Страница
|
||||
описывает ветку `main`, поэтому функция с пометкой версии появится в
|
||||
соответствующем релизе; что добавляет каждый релиз, смотрите в
|
||||
[списке изменений](CHANGELOG.md).
|
||||
[списке изменений](../../CHANGELOG.md).
|
||||
|
||||
<details>
|
||||
<summary><b>Windows, npm, Cargo и другие способы установки</b></summary>
|
||||
@@ -59,8 +59,8 @@ cargo install codewhale-cli --locked # crates.io; can trail GitHub Releases
|
||||
|
||||
Готовые бинарные файлы есть для Linux, macOS и Windows на x64 и arm64. Nix,
|
||||
Homebrew в Linux, Android/Termux (предварительная версия) и ручная загрузка
|
||||
описаны в [руководстве по установке](docs/INSTALL.md), а контейнеры — в разделе
|
||||
[Docker](docs/DOCKER.md). Используйте на одной машине только один способ
|
||||
описаны в [руководстве по установке](../INSTALL.md), а контейнеры — в разделе
|
||||
[Docker](../DOCKER.md). Используйте на одной машине только один способ
|
||||
установки, иначе в `PATH` окажутся две копии и сработает та, что стоит первой.
|
||||
|
||||
</details>
|
||||
@@ -108,7 +108,7 @@ codewhale exec --auto --sandbox workspace-write "fix the failing tests and expla
|
||||
| Режим | `Tab` (когда поле ввода пустое) или `/mode` | **Plan** читает и ищет, но ничего не меняет. **Work** редактирует файлы и выполняет команды. **Operate** имеет тот же доступ, что и Work, воспринимает ваш запрос как цель и продолжает работу, пока цель не будет проверена или ему не понадобится ваш ответ. |
|
||||
| Разрешение | `Shift+Tab` | **Ask** применяет правки файлов в вашем репозитории без запроса и спрашивает перед командами оболочки, кроме команд только для чтения. **Auto-Review** позволяет правилам и модели-рецензенту одобрять рутинные вызовы и отклоняет вызовы с высоким риском; чтобы одобрять их самостоятельно, переключитесь на Ask. **Full Access** никогда не спрашивает и отключает песочницу Codewhale; правила репозитория и управляемая политика продолжают действовать. |
|
||||
|
||||
Подробности — в [руководстве по режимам и разрешениям](docs/MODES.md).
|
||||
Подробности — в [руководстве по режимам и разрешениям](../MODES.md).
|
||||
|
||||
## Что он умеет
|
||||
|
||||
@@ -141,13 +141,13 @@ Mistral, Moonshot, OpenRouter и xAI. Работает любая OpenAI-сов
|
||||
точка, а также локальные модели через Ollama, vLLM или SGLang. По умолчанию
|
||||
используется `deepseek-flash` от DeepSeek, который DeepSeek 2026-10-17 перевёл
|
||||
на DeepSeek-V4.1-Flash-1017; 0.10.1 работает с ним без обновления
|
||||
([подробнее](docs/PROVIDERS.md#deepseek-v41-flash)).
|
||||
([подробнее](../PROVIDERS.md#deepseek-v41-flash)).
|
||||
|
||||
`/model` переключает модель между ходами, а `/model auto` выбирает модель для
|
||||
каждого хода (как именно — настраивается через `/router`). `/turn inspect`
|
||||
показывает, какую модель использовал ход, сколько он стоил и сколько длился.
|
||||
`codewhale auth chatgpt` позволяет пользоваться подпиской ChatGPT вместо ключа
|
||||
API (экспериментально). См. [Провайдеры](docs/PROVIDERS.md).
|
||||
API (экспериментально). См. [Провайдеры](../PROVIDERS.md).
|
||||
|
||||
### Квитанции и отмена
|
||||
|
||||
@@ -157,7 +157,7 @@ API (экспериментально). См. [Провайдеры](docs/PROVID
|
||||
запрос; в 0.10.1 для файлов ему нужен `/trust on`, и он откатывает по одному
|
||||
вызову инструмента за раз. `/restore` откатывает всю рабочую область к более
|
||||
раннему снимку; поскольку при этом перезаписываются более поздние правки, для
|
||||
него нужен `/trust on` или Full Access. См. [Квитанции](docs/RECEIPTS.md).
|
||||
него нужен `/trust on` или Full Access. См. [Квитанции](../RECEIPTS.md).
|
||||
|
||||
Запуски exec, в которых доступны инструменты, сохраняются при любом формате
|
||||
вывода, поэтому `codewhale receipts --last` работает после `exec --auto`, в том
|
||||
@@ -169,9 +169,9 @@ API (экспериментально). См. [Провайдеры](docs/PROVID
|
||||
### Долгие задачи
|
||||
|
||||
`/goal` задаёт цель, которая сохраняется между ходами. Codewhale может
|
||||
распределять работу между [субагентами](docs/SUBAGENTS.md), запускать группу
|
||||
агентов ([Fleet](docs/FLEET.md)) или следовать
|
||||
[рабочему процессу](docs/WORKFLOW_AUTHORING.md), сохранённому в репозитории.
|
||||
распределять работу между [субагентами](../SUBAGENTS.md), запускать группу
|
||||
агентов ([Fleet](../FLEET.md)) или следовать
|
||||
[рабочему процессу](../WORKFLOW_AUTHORING.md), сохранённому в репозитории.
|
||||
|
||||
### Переход с другого агента
|
||||
|
||||
@@ -180,19 +180,19 @@ Codewhale сам читает `AGENTS.md`. Файлы инструкций, на
|
||||
`.github/copilot-instructions.md`, загружаются, только если вы явно включите
|
||||
это параметром `project_instruction_imports = ["claude"]` (или `"cursor"`,
|
||||
`"cline"`, `"windsurf"`, `"copilot"`, `"all"`) в конфигурации; см.
|
||||
[config.example.toml](config.example.toml). Если Codewhale находит такой файл,
|
||||
[config.example.toml](../../config.example.toml). Если Codewhale находит такой файл,
|
||||
но не загружает его, он предупреждает об этом.
|
||||
|
||||
`/import-claude` готовит импорт ваших настроек Claude Code и MCP-серверов,
|
||||
чтобы вы могли его проверить. `/plugin install` принимает плагины Claude Code,
|
||||
содержащие навыки, команды, профили агентов и MCP-серверы, и отклоняет плагины,
|
||||
которым нужны хуки или LSP-серверы
|
||||
([подробнее](docs/CLAUDE_PLUGIN_COMPAT.md)).
|
||||
([подробнее](../CLAUDE_PLUGIN_COMPAT.md)).
|
||||
|
||||
### Расширения
|
||||
|
||||
Подключайте [MCP-серверы](docs/MCP.md), добавляйте [навыки](docs/SKILLS.md) и
|
||||
[плагины](docs/PLUGINS.md), запускайте [хуки](docs/HOOKS.md) на события сессии
|
||||
Подключайте [MCP-серверы](../MCP.md), добавляйте [навыки](../SKILLS.md) и
|
||||
[плагины](../PLUGINS.md), запускайте [хуки](../HOOKS.md) на события сессии
|
||||
и инструментов. Code mode (экспериментальный, включён по умолчанию) позволяет
|
||||
модели написать одну программу `execute_tools`, которая вызывает несколько
|
||||
инструментов MCP и плагинов; каждый вызов по-прежнему проходит через ваши
|
||||
@@ -200,7 +200,7 @@ Codewhale сам читает `AGENTS.md`. Файлы инструкций, на
|
||||
Computer Use (экспериментальный, только macOS) может наблюдать за другими
|
||||
приложениями и управлять ими. Он остаётся выключенным, пока вы не проверите
|
||||
его доступ и не включите его
|
||||
([руководство](crates/tui/plugins/computer-use/README.md)).
|
||||
([руководство](../../crates/tui/plugins/computer-use/README.md)).
|
||||
|
||||
## Способы запуска
|
||||
|
||||
@@ -208,13 +208,13 @@ Computer Use (экспериментальный, только macOS) может
|
||||
| --- | --- |
|
||||
| `codewhale` | Интерактивное терминальное приложение |
|
||||
| `codewhale exec "…"` | Одна задача без интерфейса. Сам по себе он отвечает, не используя инструменты; `--auto` по умолчанию включает инструменты с Full Access, `--sandbox workspace-write` ограничивает их, а `--output-format stream-json` выводит события потоком в формате JSON |
|
||||
| `codewhale web` | Локальный веб-интерфейс на `127.0.0.1` ([руководство](docs/WEB.md)) |
|
||||
| `codewhale review --pr N` | Рекомендательный обзор pull request на GitHub. Он ничего не публикует, если вы не добавите `--post`; [GitHub Action](docs/GITHUB_ACTION.md) выполняет тот же обзор в CI |
|
||||
| `codewhale app-server --http` | [Runtime API](docs/RUNTIME_API.md) — локальный HTTP API для тредов, событий, одобрений и изменений файлов в каждом ходе |
|
||||
| `codewhale web` | Локальный веб-интерфейс на `127.0.0.1` ([руководство](../WEB.md)) |
|
||||
| `codewhale review --pr N` | Рекомендательный обзор pull request на GitHub. Он ничего не публикует, если вы не добавите `--post`; [GitHub Action](../GITHUB_ACTION.md) выполняет тот же обзор в CI |
|
||||
| `codewhale app-server --http` | [Runtime API](../RUNTIME_API.md) — локальный HTTP API для тредов, событий, одобрений и изменений файлов в каждом ходе |
|
||||
| `codewhale serve --acp` | Agent Client Protocol через stdio для редакторов, например Zed |
|
||||
|
||||
Терминальное приложение, `exec`, `web` и Runtime API используют один движок
|
||||
([архитектура](docs/ARCHITECTURE.md)). Поддерживаемое сообществом
|
||||
([архитектура](../ARCHITECTURE.md)). Поддерживаемое сообществом
|
||||
[расширение для VS Code](https://marketplace.visualstudio.com/items?itemName=HengQuWorld.brotherwhale-vscode)
|
||||
подключается к нему из боковой панели ([исходный код](https://github.com/HengQuWorld/CodeWhale-VSCode)).
|
||||
Нативное настольное приложение на основе Runtime API находится в разработке;
|
||||
@@ -249,25 +249,25 @@ Windows песочницы ОС пока нет, а Full Access отключае
|
||||
`codewhale config set telemetry false` отключает её. При запуске Codewhale
|
||||
также проверяет на GitHub, не вышел ли новый релиз; чтобы пропустить эту
|
||||
проверку, задайте `CODEWHALE_NO_UPDATE_CHECK=1`. Подробнее:
|
||||
[порядок авторизации](docs/AUTHORIZATION_ORDER.md),
|
||||
[песочница](docs/SANDBOX.md) и [телеметрия](docs/TELEMETRY.md).
|
||||
[порядок авторизации](../AUTHORIZATION_ORDER.md),
|
||||
[песочница](../SANDBOX.md) и [телеметрия](../TELEMETRY.md).
|
||||
|
||||
## Документация
|
||||
|
||||
| С чего начать | Справочник |
|
||||
| --- | --- |
|
||||
| [Установка](docs/INSTALL.md) | [Конфигурация](docs/CONFIGURATION.md) |
|
||||
| [Провайдеры и локальные модели](docs/PROVIDERS.md) | [Архитектура](docs/ARCHITECTURE.md) |
|
||||
| [Режимы и разрешения](docs/MODES.md) | [Runtime API](docs/RUNTIME_API.md) |
|
||||
| [Сочетания клавиш](docs/KEYBINDINGS.md) | [Создание плагинов](docs/PLUGIN_AUTHORING.md) |
|
||||
| [Обзор PR в GitHub](docs/GITHUB_ACTION.md) | [Вся документация](docs/README.md) |
|
||||
| [Установка](../INSTALL.md) | [Конфигурация](../CONFIGURATION.md) |
|
||||
| [Провайдеры и локальные модели](../PROVIDERS.md) | [Архитектура](../ARCHITECTURE.md) |
|
||||
| [Режимы и разрешения](../MODES.md) | [Runtime API](../RUNTIME_API.md) |
|
||||
| [Сочетания клавиш](../KEYBINDINGS.md) | [Создание плагинов](../PLUGIN_AUTHORING.md) |
|
||||
| [Обзор PR в GitHub](../GITHUB_ACTION.md) | [Вся документация](../README.md) |
|
||||
|
||||
## Сообщество
|
||||
|
||||
Если не хватает провайдера или какой-то сценарий неудобен,
|
||||
[откройте issue](https://github.com/codewhale-hq/CodeWhale/issues/new/choose) или
|
||||
[отправьте pull request](CONTRIBUTING.md). Авторы сохраняют признание за
|
||||
принятую работу, а [структура репозитория](CONTRIBUTING.md#project-structure)
|
||||
[отправьте pull request](../../CONTRIBUTING.md). Авторы сохраняют признание за
|
||||
принятую работу, а [структура репозитория](../../CONTRIBUTING.md#project-structure)
|
||||
показывает, где что находится.
|
||||
|
||||
Общайтесь в [Discord](https://discord.gg/37gfS3ksug) или добавьте мейнтейнера,
|
||||
@@ -278,9 +278,9 @@ Whale Brothers.
|
||||
|
||||
Codewhale начинался как `deepseek-tui` и по-прежнему читает конфигурацию и
|
||||
сессии того проекта. Он развивается независимо и не связан ни с DeepSeek, ни с
|
||||
другими поставщиками моделей. Спасибо [всем, кто внёс вклад](docs/CONTRIBUTORS.md).
|
||||
другими поставщиками моделей. Спасибо [всем, кто внёс вклад](../CONTRIBUTORS.md).
|
||||
|
||||
[](docs/CONTRIBUTORS.md#everyone)
|
||||
[](../CONTRIBUTORS.md#everyone)
|
||||
|
||||
[MIT](LICENSE). Код, адаптированный из других проектов с открытым исходным
|
||||
кодом, перечислен в [уведомлениях о сторонних компонентах](docs/THIRD_PARTY_NOTICES.md).
|
||||
[MIT](../../LICENSE). Код, адаптированный из других проектов с открытым исходным
|
||||
кодом, перечислен в [уведомлениях о сторонних компонентах](../THIRD_PARTY_NOTICES.md).
|
||||
@@ -1,9 +1,9 @@
|
||||
<!-- source: README.md sha256:182e239fcdf7 -->
|
||||
<!-- source: README.md sha256:7e0946fcaecd -->
|
||||
<div align="center">
|
||||
|
||||
<picture>
|
||||
<source media="(prefers-color-scheme: dark)" srcset="brand/wordmark-inverted.svg">
|
||||
<img src="brand/wordmark.svg" alt="Codewhale" width="320">
|
||||
<source media="(prefers-color-scheme: dark)" srcset="../../brand/wordmark-inverted.svg">
|
||||
<img src="../../brand/wordmark.svg" alt="Codewhale" width="320">
|
||||
</picture>
|
||||
|
||||
**Terminaliniz için her modelle çalışan, açık kaynaklı bir kodlama ajanı.**
|
||||
@@ -18,14 +18,14 @@ okur, dosyaları düzenler ve komutları çalıştırır. 40'tan fazla yerleşik
|
||||
[](https://github.com/codewhale-hq/CodeWhale/actions/workflows/ci.yml)
|
||||
[](https://crates.io/crates/codewhale-cli)
|
||||
[](https://www.npmjs.com/package/codewhale)
|
||||
[](LICENSE)
|
||||
[](../../LICENSE)
|
||||
[](https://discord.gg/37gfS3ksug)
|
||||
|
||||
[Web sitesi](https://codewhale.net) · [Belgeler](docs/README.md) · [Değişiklik günlüğü](CHANGELOG.md) · [Katkıda bulunma](CONTRIBUTING.md)
|
||||
[Web sitesi](https://codewhale.net) · [Belgeler](../README.md) · [Değişiklik günlüğü](../../CHANGELOG.md) · [Katkıda bulunma](../../CONTRIBUTING.md)
|
||||
|
||||
[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) · [Italiano](README.it.md) · [Polski](README.pl.md) · [العربية](README.ar.md) · [Català](README.ca.md)
|
||||
[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) · [Italiano](README.it.md) · [Polski](README.pl.md) · [العربية](README.ar.md) · [Català](README.ca.md)
|
||||
|
||||
<img src="web/public/codewhale-tui-0102-demo.png" alt="Bir Codewhale terminal oturumu" width="760">
|
||||
<img src="../../web/public/codewhale-tui-0102-demo.png" alt="Bir Codewhale terminal oturumu" width="760">
|
||||
|
||||
<sub>Betikli bir test modeliyle, atılabilir bir çalışma alanında Full Access ile çalışan bir 0.10.2 geliştirme derlemesi. Düzenleme, üç test ve bir alt ajan incelemesi gerçekten çalıştı.</sub>
|
||||
|
||||
@@ -42,10 +42,10 @@ curl -fsSL https://codewhale.net/install.sh | sh
|
||||
Kurulum betiği, sağlama toplamı doğrulanmış `codewhale` ikili dosyasını ve kısa
|
||||
takma adı olan `codew` komutunu `~/.local/bin` dizinine koyar. Ardından kabuğunuz
|
||||
`command not found` derse, betiğin yazdırdığı PATH satırını çalıştırın
|
||||
([ayrıntılar](docs/INSTALL.md#put-it-on-your-path)). `codewhale update` kurulumu
|
||||
([ayrıntılar](../INSTALL.md#put-it-on-your-path)). `codewhale update` kurulumu
|
||||
yükseltir. Bu komutlar en son sürümü kurar. Bu sayfa `main` dalını izler; bu yüzden
|
||||
bir sürüm numarasıyla işaretlenen özellik o sürümle gelir. Her sürümün neler
|
||||
eklediğini [değişiklik günlüğü](CHANGELOG.md) listeler.
|
||||
eklediğini [değişiklik günlüğü](../../CHANGELOG.md) listeler.
|
||||
|
||||
<details>
|
||||
<summary><b>Windows, npm, Cargo ve diğer kurulum yolları</b></summary>
|
||||
@@ -58,7 +58,7 @@ cargo install codewhale-cli --locked # crates.io; can trail GitHub Releases
|
||||
|
||||
Hazır derlenmiş ikili dosyalar x64 ve arm64 üzerinde Linux, macOS ve Windows'u
|
||||
kapsar. Nix, Linux'ta Homebrew, Android/Termux (önizleme) ve elle indirme
|
||||
[kurulum kılavuzunda](docs/INSTALL.md), konteynerler ise [Docker](docs/DOCKER.md)
|
||||
[kurulum kılavuzunda](../INSTALL.md), konteynerler ise [Docker](../DOCKER.md)
|
||||
sayfasında anlatılır. Her makinede tek bir kurulum yöntemi kullanın; aksi halde
|
||||
`PATH` üzerinde iki kopya olur ve hangisi önce gelirse o çalışır.
|
||||
|
||||
@@ -107,7 +107,7 @@ Yeni bir kurulum Work modunda ve Ask izniyle başlar.
|
||||
| Mod | `Tab` (giriş alanı boşken) veya `/mode` | **Plan** okur ve arar ama hiçbir şeyi değiştirmez. **Work** dosyaları düzenler ve komutları çalıştırır. **Operate** Work ile aynı erişime sahiptir, isteğinizi bir hedef olarak ele alır ve hedef doğrulanana ya da sizden girdi gerekene kadar devam eder. |
|
||||
| İzin | `Shift+Tab` | **Ask** deponuzdaki dosya düzenlemelerini sormadan uygular, salt okunur olmayan kabuk komutlarından önce sorar. **Auto-Review** rutin çağrıların kurallar ve bir inceleyici model tarafından onaylanmasına izin verir, yüksek riskli olanları reddeder; bunları kendiniz onaylamak için Ask iznine geçin. **Full Access** hiç sormaz ve Codewhale'in korumalı alanını kapatır; depo kuralları ve yönetilen politika yine de geçerlidir. |
|
||||
|
||||
Ayrıntılar için [modlar ve izinler kılavuzuna](docs/MODES.md) bakın.
|
||||
Ayrıntılar için [modlar ve izinler kılavuzuna](../MODES.md) bakın.
|
||||
|
||||
## Ne yapar
|
||||
|
||||
@@ -138,13 +138,13 @@ Anthropic, OpenAI, DeepSeek, Google, Mistral, Moonshot, OpenRouter ve xAI dahil
|
||||
Ollama, vLLM veya SGLang üzerinden yerel modeller de çalışır. Varsayılan model,
|
||||
DeepSeek'in `deepseek-flash` modelidir; DeepSeek bu modeli 2026-10-17'de
|
||||
DeepSeek-V4.1-Flash-1017'ye taşıdı. 0.10.1 onu güncelleme gerektirmeden çalıştırır
|
||||
([ayrıntılar](docs/PROVIDERS.md#deepseek-v41-flash)).
|
||||
([ayrıntılar](../PROVIDERS.md#deepseek-v41-flash)).
|
||||
|
||||
`/model` turlar arasında model değiştirir; `/model auto` ise her tur için bir model
|
||||
seçer (seçimin nasıl yapılacağını `/router` ayarlar). `/turn inspect`, bir turun
|
||||
hangi modeli kullandığını, ne kadara mal olduğunu ve ne kadar sürdüğünü gösterir.
|
||||
`codewhale auth chatgpt`, API anahtarı yerine bir ChatGPT planı kullanmanızı sağlar
|
||||
(deneysel). Bkz. [Sağlayıcılar](docs/PROVIDERS.md).
|
||||
(deneysel). Bkz. [Sağlayıcılar](../PROVIDERS.md).
|
||||
|
||||
### Makbuzlar ve geri alma
|
||||
|
||||
@@ -154,7 +154,7 @@ onayları ve bunları kimin verdiğini ve hataları listeler. `/undo` son isteğ
|
||||
geri alır; 0.10.1'de dosyalar için `/trust on` gerektirir ve her seferinde bir araç
|
||||
çağrısı geri gider. `/restore` tüm çalışma alanını daha önceki bir anlık görüntüye geri
|
||||
döndürür; bu, sonraki düzenlemelerin üzerine yazdığı için `/trust on` veya Full
|
||||
Access gerektirir. Bkz. [Makbuzlar](docs/RECEIPTS.md).
|
||||
Access gerektirir. Bkz. [Makbuzlar](../RECEIPTS.md).
|
||||
|
||||
Araçların kullanılabilir olduğu exec çalıştırmaları her çıktı biçiminde
|
||||
kaydedilir; böylece `codewhale receipts --last`, `--json` dahil olmak üzere
|
||||
@@ -166,8 +166,8 @@ kaydedilir; makbuzlar veya `exec --continue` için bunları her zaman kaydetmek
|
||||
### Daha uzun işler
|
||||
|
||||
`/goal`, turlar boyunca geçerli kalan bir hedef belirler. Codewhale işi
|
||||
[alt ajanlara](docs/SUBAGENTS.md) bölebilir, bir [ajan filosu](docs/FLEET.md)
|
||||
çalıştırabilir veya depoya eklenmiş bir [iş akışını](docs/WORKFLOW_AUTHORING.md)
|
||||
[alt ajanlara](../SUBAGENTS.md) bölebilir, bir [ajan filosu](../FLEET.md)
|
||||
çalıştırabilir veya depoya eklenmiş bir [iş akışını](../WORKFLOW_AUTHORING.md)
|
||||
izleyebilir.
|
||||
|
||||
### Başka bir ajandan geçiş
|
||||
@@ -176,26 +176,26 @@ Codewhale `AGENTS.md` dosyasını kendiliğinden okur. `CLAUDE.md`, `.cursorrule
|
||||
veya `.github/copilot-instructions.md` gibi başka araçlar için yazılmış talimat
|
||||
dosyaları, yalnızca yapılandırmanızda `project_instruction_imports = ["claude"]`
|
||||
(veya `"cursor"`, `"cline"`, `"windsurf"`, `"copilot"`, `"all"`) ile bunu açıkça
|
||||
seçtiğinizde yüklenir; bkz. [config.example.toml](config.example.toml). Codewhale,
|
||||
seçtiğinizde yüklenir; bkz. [config.example.toml](../../config.example.toml). Codewhale,
|
||||
yüklemediği böyle bir dosya bulduğunda uyarır.
|
||||
|
||||
`/import-claude`, Claude Code ayarlarınızın ve MCP sunucularınızın içe aktarımını
|
||||
gözden geçirmeniz için hazırlar. `/plugin install`, beceriler, komutlar, ajan
|
||||
profilleri ve MCP sunucuları içeren Claude Code eklentilerini kabul eder; kanca
|
||||
veya LSP sunucusu gerektiren eklentileri reddeder
|
||||
([ayrıntılar](docs/CLAUDE_PLUGIN_COMPAT.md)).
|
||||
([ayrıntılar](../CLAUDE_PLUGIN_COMPAT.md)).
|
||||
|
||||
### Uzantılar
|
||||
|
||||
[MCP sunucuları](docs/MCP.md) bağlayın, [beceriler](docs/SKILLS.md) ve
|
||||
[eklentiler](docs/PLUGINS.md) ekleyin, oturum ve araç olaylarında
|
||||
[kancalar](docs/HOOKS.md) çalıştırın. Code mode (deneysel, varsayılan olarak açık),
|
||||
[MCP sunucuları](../MCP.md) bağlayın, [beceriler](../SKILLS.md) ve
|
||||
[eklentiler](../PLUGINS.md) ekleyin, oturum ve araç olaylarında
|
||||
[kancalar](../HOOKS.md) çalıştırın. Code mode (deneysel, varsayılan olarak açık),
|
||||
modelin birkaç MCP ve eklenti aracını çağıran tek bir `execute_tools` programı
|
||||
yazmasını sağlar; her çağrı yine onay kurallarınızdan geçer ve makbuzunu korur.
|
||||
Birlikte gelen Computer Use eklentisi
|
||||
(deneysel, yalnızca macOS) diğer uygulamaları gözlemleyip kullanabilir. Siz
|
||||
erişimini gözden geçirip etkinleştirene kadar kapalı kalır
|
||||
([kılavuz](crates/tui/plugins/computer-use/README.md)).
|
||||
([kılavuz](../../crates/tui/plugins/computer-use/README.md)).
|
||||
|
||||
## Çalıştırma yolları
|
||||
|
||||
@@ -203,13 +203,13 @@ erişimini gözden geçirip etkinleştirene kadar kapalı kalır
|
||||
| --- | --- |
|
||||
| `codewhale` | Etkileşimli terminal uygulaması |
|
||||
| `codewhale exec "…"` | Arayüz olmadan tek bir görev. Tek başına araç kullanmadan yanıt verir; `--auto` varsayılan olarak araçları Full Access ile etkinleştirir, `--sandbox workspace-write` bunları kısıtlar, `--output-format stream-json` olayları JSON olarak akış halinde verir |
|
||||
| `codewhale web` | `127.0.0.1` üzerinde yerel bir web arayüzü ([kılavuz](docs/WEB.md)) |
|
||||
| `codewhale review --pr N` | Bir GitHub pull request'inin tavsiye niteliğinde incelemesi. `--post` eklemediğiniz sürece hiçbir şey yayınlamaz; [GitHub Action](docs/GITHUB_ACTION.md) aynı incelemeyi CI'da çalıştırır |
|
||||
| `codewhale app-server --http` | [Runtime API](docs/RUNTIME_API.md); iş parçacıkları, olaylar, onaylar ve her turun dosya değişiklikleri için yerel bir HTTP API |
|
||||
| `codewhale web` | `127.0.0.1` üzerinde yerel bir web arayüzü ([kılavuz](../WEB.md)) |
|
||||
| `codewhale review --pr N` | Bir GitHub pull request'inin tavsiye niteliğinde incelemesi. `--post` eklemediğiniz sürece hiçbir şey yayınlamaz; [GitHub Action](../GITHUB_ACTION.md) aynı incelemeyi CI'da çalıştırır |
|
||||
| `codewhale app-server --http` | [Runtime API](../RUNTIME_API.md); iş parçacıkları, olaylar, onaylar ve her turun dosya değişiklikleri için yerel bir HTTP API |
|
||||
| `codewhale serve --acp` | Zed gibi editörler için stdio üzerinden Agent Client Protocol |
|
||||
|
||||
Terminal uygulaması, `exec`, `web` ve Runtime API tek bir motoru paylaşır
|
||||
([mimari](docs/ARCHITECTURE.md)). Topluluk tarafından sürdürülen bir
|
||||
([mimari](../ARCHITECTURE.md)). Topluluk tarafından sürdürülen bir
|
||||
[VS Code eklentisi](https://marketplace.visualstudio.com/items?itemName=HengQuWorld.brotherwhale-vscode)
|
||||
kenar çubuğundan bu motora bağlanır ([kaynak](https://github.com/HengQuWorld/CodeWhale-VSCode)).
|
||||
Runtime API üzerine kurulu, platforma özgü bir masaüstü uygulaması geliştiriliyor;
|
||||
@@ -242,26 +242,26 @@ bilgileri asla gönderilmez.
|
||||
`codewhale config set telemetry false` telemetriyi kapatır. Codewhale başlangıçta
|
||||
ayrıca yeni bir sürüm için GitHub'ı kontrol eder; bunu atlamak için
|
||||
`CODEWHALE_NO_UPDATE_CHECK=1` ayarlayın. Daha fazlası için
|
||||
[yetkilendirme sırası](docs/AUTHORIZATION_ORDER.md),
|
||||
[korumalı alan](docs/SANDBOX.md) ve [telemetri](docs/TELEMETRY.md) belgelerine
|
||||
[yetkilendirme sırası](../AUTHORIZATION_ORDER.md),
|
||||
[korumalı alan](../SANDBOX.md) ve [telemetri](../TELEMETRY.md) belgelerine
|
||||
bakın.
|
||||
|
||||
## Belgeler
|
||||
|
||||
| Buradan başlayın | Başvuru |
|
||||
| --- | --- |
|
||||
| [Kurulum](docs/INSTALL.md) | [Yapılandırma](docs/CONFIGURATION.md) |
|
||||
| [Sağlayıcılar ve yerel modeller](docs/PROVIDERS.md) | [Mimari](docs/ARCHITECTURE.md) |
|
||||
| [Modlar ve izinler](docs/MODES.md) | [Runtime API](docs/RUNTIME_API.md) |
|
||||
| [Tuş atamaları](docs/KEYBINDINGS.md) | [Eklenti geliştirme](docs/PLUGIN_AUTHORING.md) |
|
||||
| [GitHub PR incelemesi](docs/GITHUB_ACTION.md) | [Tüm belgeler](docs/README.md) |
|
||||
| [Kurulum](../INSTALL.md) | [Yapılandırma](../CONFIGURATION.md) |
|
||||
| [Sağlayıcılar ve yerel modeller](../PROVIDERS.md) | [Mimari](../ARCHITECTURE.md) |
|
||||
| [Modlar ve izinler](../MODES.md) | [Runtime API](../RUNTIME_API.md) |
|
||||
| [Tuş atamaları](../KEYBINDINGS.md) | [Eklenti geliştirme](../PLUGIN_AUTHORING.md) |
|
||||
| [GitHub PR incelemesi](../GITHUB_ACTION.md) | [Tüm belgeler](../README.md) |
|
||||
|
||||
## Topluluk
|
||||
|
||||
Bir sağlayıcı eksikse veya bir iş akışı zahmetliyse
|
||||
[bir issue açın](https://github.com/codewhale-hq/CodeWhale/issues/new/choose) ya da
|
||||
[pull request gönderin](CONTRIBUTING.md). Katkıda bulunanlar, kabul edilen işin
|
||||
hakkını korur; [depo yapısı](CONTRIBUTING.md#project-structure) neyin nerede
|
||||
[pull request gönderin](../../CONTRIBUTING.md). Katkıda bulunanlar, kabul edilen işin
|
||||
hakkını korur; [depo yapısı](../../CONTRIBUTING.md#project-structure) neyin nerede
|
||||
olduğunu gösterir.
|
||||
|
||||
[Discord](https://discord.gg/37gfS3ksug) üzerinde sohbet edin veya projenin
|
||||
@@ -273,9 +273,9 @@ istediğinizi söyleyin.
|
||||
Codewhale, `deepseek-tui` olarak başladı ve hâlâ o projenin yapılandırmasını ve
|
||||
oturumlarını okur. Bağımsız olarak sürdürülür ve DeepSeek ya da başka herhangi bir
|
||||
model sağlayıcısıyla bağlantılı değildir.
|
||||
[Katkıda bulunan herkese](docs/CONTRIBUTORS.md) teşekkürler.
|
||||
[Katkıda bulunan herkese](../CONTRIBUTORS.md) teşekkürler.
|
||||
|
||||
[](docs/CONTRIBUTORS.md#everyone)
|
||||
[](../CONTRIBUTORS.md#everyone)
|
||||
|
||||
[MIT](LICENSE). Diğer açık kaynak projelerden uyarlanan kod
|
||||
[üçüncü taraf bildirimlerinde](docs/THIRD_PARTY_NOTICES.md) listelenir.
|
||||
[MIT](../../LICENSE). Diğer açık kaynak projelerden uyarlanan kod
|
||||
[üçüncü taraf bildirimlerinde](../THIRD_PARTY_NOTICES.md) listelenir.
|
||||
@@ -1,9 +1,9 @@
|
||||
<!-- source: README.md sha256:182e239fcdf7 -->
|
||||
<!-- source: README.md sha256:7e0946fcaecd -->
|
||||
<div align="center">
|
||||
|
||||
<picture>
|
||||
<source media="(prefers-color-scheme: dark)" srcset="brand/wordmark-inverted.svg">
|
||||
<img src="brand/wordmark.svg" alt="Codewhale" width="320">
|
||||
<source media="(prefers-color-scheme: dark)" srcset="../../brand/wordmark-inverted.svg">
|
||||
<img src="../../brand/wordmark.svg" alt="Codewhale" width="320">
|
||||
</picture>
|
||||
|
||||
**Агент для програмування з відкритим кодом у вашому терміналі, що працює з будь-якою моделлю.**
|
||||
@@ -18,14 +18,14 @@ DeepSeek V4.1 Flash), а також із моделями, запущеними
|
||||
[](https://github.com/codewhale-hq/CodeWhale/actions/workflows/ci.yml)
|
||||
[](https://crates.io/crates/codewhale-cli)
|
||||
[](https://www.npmjs.com/package/codewhale)
|
||||
[](LICENSE)
|
||||
[](../../LICENSE)
|
||||
[](https://discord.gg/37gfS3ksug)
|
||||
|
||||
[Вебсайт](https://codewhale.net) · [Документація](docs/README.md) · [Журнал змін](CHANGELOG.md) · [Участь у проєкті](CONTRIBUTING.md)
|
||||
[Вебсайт](https://codewhale.net) · [Документація](../README.md) · [Журнал змін](../../CHANGELOG.md) · [Участь у проєкті](../../CONTRIBUTING.md)
|
||||
|
||||
[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) · [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) · [Català](README.ca.md)
|
||||
[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) · [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) · [Català](README.ca.md)
|
||||
|
||||
<img src="web/public/codewhale-tui-0102-demo.png" alt="Сесія Codewhale в терміналі" width="760">
|
||||
<img src="../../web/public/codewhale-tui-0102-demo.png" alt="Сесія Codewhale в терміналі" width="760">
|
||||
|
||||
<sub>Збірка 0.10.2 для розробки з тестовою моделлю, що діє за сценарієм, з дозволом «Повний доступ» в одноразовому робочому просторі. Зміна, три тести й перевірка субагентом відбулися насправді.</sub>
|
||||
|
||||
@@ -42,11 +42,11 @@ curl -fsSL https://codewhale.net/install.sh | sh
|
||||
Інсталятор встановлює в `~/.local/bin` перевірені за контрольними сумами
|
||||
`codewhale` і його короткий псевдонім `codew`. Якщо після цього оболонка
|
||||
виводить `command not found`, виконайте рядок для PATH, який друкує інсталятор
|
||||
([докладніше](docs/INSTALL.md#put-it-on-your-path)). Оновлення виконує
|
||||
([докладніше](../INSTALL.md#put-it-on-your-path)). Оновлення виконує
|
||||
`codewhale update`. Ці команди встановлюють останній реліз. Ця сторінка
|
||||
відповідає гілці `main`, тож функція з позначкою версії з’явиться у
|
||||
відповідному релізі; що додає кожен реліз, дивіться в
|
||||
[журналі змін](CHANGELOG.md).
|
||||
[журналі змін](../../CHANGELOG.md).
|
||||
|
||||
<details>
|
||||
<summary><b>Windows, npm, Cargo та інші способи встановлення</b></summary>
|
||||
@@ -59,8 +59,8 @@ cargo install codewhale-cli --locked # crates.io; can trail GitHub Releases
|
||||
|
||||
Готові бінарні файли є для Linux, macOS і Windows на x64 та arm64. Nix,
|
||||
Homebrew у Linux, Android/Termux (попередня версія) і ручне завантаження
|
||||
описано в [посібнику зі встановлення](docs/INSTALL.md), а контейнери — у
|
||||
[Docker](docs/DOCKER.md). Використовуйте на одній машині лише один спосіб
|
||||
описано в [посібнику зі встановлення](../INSTALL.md), а контейнери — у
|
||||
[Docker](../DOCKER.md). Використовуйте на одній машині лише один спосіб
|
||||
встановлення, інакше в `PATH` опиняться дві копії й спрацює та, що стоїть
|
||||
першою.
|
||||
|
||||
@@ -110,7 +110,7 @@ codewhale exec --auto --sandbox workspace-write "fix the failing tests and expla
|
||||
| Режим | `Tab` (коли поле введення порожнє) або `/mode` | **Plan** читає й шукає, але нічого не змінює. **Work** редагує файли й виконує команди. **Operate** має той самий доступ, що й Work, сприймає ваш запит як ціль і продовжує роботу, доки досягнення цілі не буде перевірено або йому не знадобиться щось від вас. |
|
||||
| Дозвіл | `Shift+Tab` | **Запитувати** (Ask) застосовує зміни у файлах вашого репозиторію без запиту й питає перед командами оболонки, які не є лише для читання. **Автоперевірка** (Auto-Review) дає правилам і моделі-рецензенту схвалювати рутинні виклики й відхиляє виклики з високим ризиком; щоб схвалювати їх самостійно, перейдіть на «Запитувати». **Повний доступ** (Full Access) ніколи не питає й вимикає пісочницю Codewhale; правила репозиторію та керована політика й далі діють. |
|
||||
|
||||
Докладніше — у [посібнику з режимів і дозволів](docs/MODES.md).
|
||||
Докладніше — у [посібнику з режимів і дозволів](../MODES.md).
|
||||
|
||||
## Що він уміє
|
||||
|
||||
@@ -143,13 +143,13 @@ Google, Mistral, Moonshot, OpenRouter і xAI. Працює будь-яка OpenA
|
||||
кінцева точка, а також локальні моделі через Ollama, vLLM або SGLang. За
|
||||
замовчуванням використовується `deepseek-flash` від DeepSeek, який DeepSeek
|
||||
2026-10-17 переключив на DeepSeek-V4.1-Flash-1017; 0.10.1 працює з ним без
|
||||
оновлення ([докладніше](docs/PROVIDERS.md#deepseek-v41-flash)).
|
||||
оновлення ([докладніше](../PROVIDERS.md#deepseek-v41-flash)).
|
||||
|
||||
`/model` перемикає модель між ходами, а `/model auto` вибирає модель для
|
||||
кожного ходу (як саме, налаштовує `/router`). `/turn inspect` показує, яку
|
||||
модель використав хід, скільки він коштував і скільки тривав.
|
||||
`codewhale auth chatgpt` дає змогу користуватися підпискою ChatGPT замість
|
||||
ключа API (експериментально). Див. [Провайдери](docs/PROVIDERS.md).
|
||||
ключа API (експериментально). Див. [Провайдери](../PROVIDERS.md).
|
||||
|
||||
### Квитанції та скасування
|
||||
|
||||
@@ -159,7 +159,7 @@ Google, Mistral, Moonshot, OpenRouter і xAI. Працює будь-яка OpenA
|
||||
запит; у 0.10.1 для файлів йому потрібен `/trust on`, і він повертає по одному
|
||||
виклику інструмента за раз. `/restore` повертає весь робочий простір до раніше
|
||||
збереженого знімка; оскільки це перезаписує пізніші зміни, потрібен
|
||||
`/trust on` або «Повний доступ». Див. [Квитанції](docs/RECEIPTS.md).
|
||||
`/trust on` або «Повний доступ». Див. [Квитанції](../RECEIPTS.md).
|
||||
|
||||
Запуски exec, у яких доступні інструменти, зберігаються за будь-якого формату
|
||||
виводу, тому `codewhale receipts --last` працює після `exec --auto`, зокрема
|
||||
@@ -171,9 +171,9 @@ Google, Mistral, Moonshot, OpenRouter і xAI. Працює будь-яка OpenA
|
||||
### Довші завдання
|
||||
|
||||
`/goal` задає ціль, яка зберігається між ходами. Codewhale може розподіляти
|
||||
роботу між [субагентами](docs/SUBAGENTS.md), запускати
|
||||
[групу агентів](docs/FLEET.md) або виконувати
|
||||
[робочий процес](docs/WORKFLOW_AUTHORING.md), збережений у репозиторії.
|
||||
роботу між [субагентами](../SUBAGENTS.md), запускати
|
||||
[групу агентів](../FLEET.md) або виконувати
|
||||
[робочий процес](../WORKFLOW_AUTHORING.md), збережений у репозиторії.
|
||||
|
||||
### Перехід з іншого агента
|
||||
|
||||
@@ -182,19 +182,19 @@ Codewhale сам читає `AGENTS.md`. Файли інструкцій, нап
|
||||
`.github/copilot-instructions.md`, завантажуються лише тоді, коли ви явно
|
||||
ввімкнете це через `project_instruction_imports = ["claude"]` (або `"cursor"`,
|
||||
`"cline"`, `"windsurf"`, `"copilot"`, `"all"`) у своїй конфігурації; див.
|
||||
[config.example.toml](config.example.toml). Codewhale попереджає, коли
|
||||
[config.example.toml](../../config.example.toml). Codewhale попереджає, коли
|
||||
знаходить такий файл, але не завантажує його.
|
||||
|
||||
`/import-claude` готує імпорт ваших налаштувань Claude Code і MCP-серверів, щоб
|
||||
ви його переглянули. `/plugin install` приймає плагіни Claude Code, що містять
|
||||
навички, команди, профілі агентів і MCP-сервери, і відхиляє плагіни, яким
|
||||
потрібні гуки або LSP-сервери
|
||||
([докладніше](docs/CLAUDE_PLUGIN_COMPAT.md)).
|
||||
([докладніше](../CLAUDE_PLUGIN_COMPAT.md)).
|
||||
|
||||
### Розширення
|
||||
|
||||
Підключайте [MCP-сервери](docs/MCP.md), додавайте [навички](docs/SKILLS.md) і
|
||||
[плагіни](docs/PLUGINS.md) та запускайте [гуки](docs/HOOKS.md) на події сесії
|
||||
Підключайте [MCP-сервери](../MCP.md), додавайте [навички](../SKILLS.md) і
|
||||
[плагіни](../PLUGINS.md) та запускайте [гуки](../HOOKS.md) на події сесії
|
||||
та інструментів. Code mode (експериментальний, увімкнений за замовчуванням)
|
||||
дає моделі змогу написати одну програму `execute_tools`, яка викликає кілька
|
||||
інструментів MCP і плагінів; кожен виклик і далі проходить через ваші правила
|
||||
@@ -202,7 +202,7 @@ Codewhale сам читає `AGENTS.md`. Файли інструкцій, нап
|
||||
комплекту (експериментальний, лише для macOS), може спостерігати за іншими
|
||||
застосунками й керувати ними. Він залишається вимкненим, доки ви не перевірите
|
||||
його доступ і не ввімкнете його
|
||||
([посібник](crates/tui/plugins/computer-use/README.md)).
|
||||
([посібник](../../crates/tui/plugins/computer-use/README.md)).
|
||||
|
||||
## Способи запуску
|
||||
|
||||
@@ -210,13 +210,13 @@ Codewhale сам читає `AGENTS.md`. Файли інструкцій, нап
|
||||
| --- | --- |
|
||||
| `codewhale` | Інтерактивний термінальний застосунок |
|
||||
| `codewhale exec "…"` | Одне завдання без інтерфейсу. Без додаткових прапорців він відповідає, не використовуючи інструментів; `--auto` за замовчуванням вмикає інструменти з «Повним доступом», `--sandbox workspace-write` обмежує їх, а `--output-format stream-json` передає події потоком у форматі JSON |
|
||||
| `codewhale web` | Локальний вебінтерфейс на `127.0.0.1` ([посібник](docs/WEB.md)) |
|
||||
| `codewhale review --pr N` | Рекомендаційний огляд pull request у GitHub. Нічого не публікує, якщо не додати `--post`; [GitHub Action](docs/GITHUB_ACTION.md) виконує такий самий огляд у CI |
|
||||
| `codewhale app-server --http` | [Runtime API](docs/RUNTIME_API.md) — локальний HTTP API для тредів, подій, підтверджень і змін у файлах кожного ходу |
|
||||
| `codewhale web` | Локальний вебінтерфейс на `127.0.0.1` ([посібник](../WEB.md)) |
|
||||
| `codewhale review --pr N` | Рекомендаційний огляд pull request у GitHub. Нічого не публікує, якщо не додати `--post`; [GitHub Action](../GITHUB_ACTION.md) виконує такий самий огляд у CI |
|
||||
| `codewhale app-server --http` | [Runtime API](../RUNTIME_API.md) — локальний HTTP API для тредів, подій, підтверджень і змін у файлах кожного ходу |
|
||||
| `codewhale serve --acp` | Agent Client Protocol через stdio для редакторів, як-от Zed |
|
||||
|
||||
Термінальний застосунок, `exec`, `web` і Runtime API використовують один рушій
|
||||
([архітектура](docs/ARCHITECTURE.md)). Підтримуване спільнотою
|
||||
([архітектура](../ARCHITECTURE.md)). Підтримуване спільнотою
|
||||
[розширення для VS Code](https://marketplace.visualstudio.com/items?itemName=HengQuWorld.brotherwhale-vscode)
|
||||
підключається до нього з бічної панелі ([вихідний код](https://github.com/HengQuWorld/CodeWhale-VSCode)).
|
||||
Нативний настільний застосунок на основі Runtime API в розробці; публічного
|
||||
@@ -251,25 +251,25 @@ Codewhale безкоштовний і поширюється за ліцензі
|
||||
або облікові дані. `codewhale config set telemetry false` її вимикає. Під час
|
||||
запуску Codewhale також перевіряє на GitHub, чи вийшов новий реліз; щоб
|
||||
пропустити цю перевірку, задайте `CODEWHALE_NO_UPDATE_CHECK=1`.
|
||||
Докладніше: [порядок авторизації](docs/AUTHORIZATION_ORDER.md),
|
||||
[пісочниця](docs/SANDBOX.md) і [телеметрія](docs/TELEMETRY.md).
|
||||
Докладніше: [порядок авторизації](../AUTHORIZATION_ORDER.md),
|
||||
[пісочниця](../SANDBOX.md) і [телеметрія](../TELEMETRY.md).
|
||||
|
||||
## Документація
|
||||
|
||||
| З чого почати | Довідка |
|
||||
| --- | --- |
|
||||
| [Встановлення](docs/INSTALL.md) | [Конфігурація](docs/CONFIGURATION.md) |
|
||||
| [Провайдери та локальні моделі](docs/PROVIDERS.md) | [Архітектура](docs/ARCHITECTURE.md) |
|
||||
| [Режими й дозволи](docs/MODES.md) | [Runtime API](docs/RUNTIME_API.md) |
|
||||
| [Комбінації клавіш](docs/KEYBINDINGS.md) | [Створення плагінів](docs/PLUGIN_AUTHORING.md) |
|
||||
| [Огляд PR у GitHub](docs/GITHUB_ACTION.md) | [Уся документація](docs/README.md) |
|
||||
| [Встановлення](../INSTALL.md) | [Конфігурація](../CONFIGURATION.md) |
|
||||
| [Провайдери та локальні моделі](../PROVIDERS.md) | [Архітектура](../ARCHITECTURE.md) |
|
||||
| [Режими й дозволи](../MODES.md) | [Runtime API](../RUNTIME_API.md) |
|
||||
| [Комбінації клавіш](../KEYBINDINGS.md) | [Створення плагінів](../PLUGIN_AUTHORING.md) |
|
||||
| [Огляд PR у GitHub](../GITHUB_ACTION.md) | [Уся документація](../README.md) |
|
||||
|
||||
## Спільнота
|
||||
|
||||
Якщо бракує провайдера або якийсь сценарій роботи незручний,
|
||||
[відкрийте issue](https://github.com/codewhale-hq/CodeWhale/issues/new/choose) або
|
||||
[надішліть pull request](CONTRIBUTING.md). Автори зберігають визнання за
|
||||
прийняту роботу, а [структура репозиторію](CONTRIBUTING.md#project-structure)
|
||||
[надішліть pull request](../../CONTRIBUTING.md). Автори зберігають визнання за
|
||||
прийняту роботу, а [структура репозиторію](../../CONTRIBUTING.md#project-structure)
|
||||
показує, де що лежить.
|
||||
|
||||
Спілкуйтеся в [Discord](https://discord.gg/37gfS3ksug) або додайте супровідника
|
||||
@@ -281,9 +281,9 @@ Whale Brothers.
|
||||
Codewhale починався як `deepseek-tui` і досі читає конфігурацію та сесії того
|
||||
проєкту. Він розвивається незалежно й не пов’язаний ні з DeepSeek, ні з жодним
|
||||
іншим провайдером моделей. Дякуємо
|
||||
[усім, хто долучився до проєкту](docs/CONTRIBUTORS.md).
|
||||
[усім, хто долучився до проєкту](../CONTRIBUTORS.md).
|
||||
|
||||
[](docs/CONTRIBUTORS.md#everyone)
|
||||
[](../CONTRIBUTORS.md#everyone)
|
||||
|
||||
[MIT](LICENSE). Код, адаптований з інших проєктів із відкритим кодом,
|
||||
перелічено в [повідомленнях про сторонні компоненти](docs/THIRD_PARTY_NOTICES.md).
|
||||
[MIT](../../LICENSE). Код, адаптований з інших проєктів із відкритим кодом,
|
||||
перелічено в [повідомленнях про сторонні компоненти](../THIRD_PARTY_NOTICES.md).
|
||||
@@ -1,9 +1,9 @@
|
||||
<!-- source: README.md sha256:182e239fcdf7 -->
|
||||
<!-- source: README.md sha256:7e0946fcaecd -->
|
||||
<div align="center">
|
||||
|
||||
<picture>
|
||||
<source media="(prefers-color-scheme: dark)" srcset="brand/wordmark-inverted.svg">
|
||||
<img src="brand/wordmark.svg" alt="Codewhale" width="320">
|
||||
<source media="(prefers-color-scheme: dark)" srcset="../../brand/wordmark-inverted.svg">
|
||||
<img src="../../brand/wordmark.svg" alt="Codewhale" width="320">
|
||||
</picture>
|
||||
|
||||
**Tác nhân lập trình mã nguồn mở chạy trong terminal, hoạt động với mọi mô hình.**
|
||||
@@ -17,14 +17,14 @@ các lệnh nó đã chạy, cùng các lệnh gọi web và MCP nó đã thực
|
||||
[](https://github.com/codewhale-hq/CodeWhale/actions/workflows/ci.yml)
|
||||
[](https://crates.io/crates/codewhale-cli)
|
||||
[](https://www.npmjs.com/package/codewhale)
|
||||
[](LICENSE)
|
||||
[](../../LICENSE)
|
||||
[](https://discord.gg/37gfS3ksug)
|
||||
|
||||
[Trang web](https://codewhale.net) · [Tài liệu](docs/README.md) · [Nhật ký thay đổi](CHANGELOG.md) · [Đóng góp](CONTRIBUTING.md)
|
||||
[Trang web](https://codewhale.net) · [Tài liệu](../README.md) · [Nhật ký thay đổi](../../CHANGELOG.md) · [Đóng góp](../../CONTRIBUTING.md)
|
||||
|
||||
[English](README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja-JP.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) · [Català](README.ca.md)
|
||||
[English](../../README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja-JP.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) · [Català](README.ca.md)
|
||||
|
||||
<img src="web/public/codewhale-tui-0102-demo.png" alt="Một phiên terminal của Codewhale" width="760">
|
||||
<img src="../../web/public/codewhale-tui-0102-demo.png" alt="Một phiên terminal của Codewhale" width="760">
|
||||
|
||||
<sub>Một bản dựng phát triển 0.10.2 với mô hình thử nghiệm chạy theo kịch bản, ở chế độ Full Access trong một không gian làm việc dùng một lần. Thao tác chỉnh sửa, ba bài kiểm thử và lượt đánh giá của tác nhân phụ đều chạy thật.</sub>
|
||||
|
||||
@@ -41,10 +41,10 @@ curl -fsSL https://codewhale.net/install.sh | sh
|
||||
Trình cài đặt đặt `codewhale` và bí danh ngắn `codew` của nó, đã được xác minh
|
||||
checksum, vào `~/.local/bin`. Nếu sau đó shell báo `command not found`, hãy chạy
|
||||
dòng PATH mà trình cài đặt in ra
|
||||
([chi tiết](docs/INSTALL.md#put-it-on-your-path)). Dùng `codewhale update` để
|
||||
([chi tiết](../INSTALL.md#put-it-on-your-path)). Dùng `codewhale update` để
|
||||
nâng cấp. Các lệnh này cài bản phát hành mới nhất. Trang này theo nhánh `main`,
|
||||
nên một tính năng được đánh dấu phiên bản sẽ có mặt trong bản phát hành đó;
|
||||
[nhật ký thay đổi](CHANGELOG.md) liệt kê những gì mỗi bản phát hành bổ sung.
|
||||
[nhật ký thay đổi](../../CHANGELOG.md) liệt kê những gì mỗi bản phát hành bổ sung.
|
||||
|
||||
<details>
|
||||
<summary><b>Windows, npm, Cargo và các cách cài khác</b></summary>
|
||||
@@ -57,8 +57,8 @@ cargo install codewhale-cli --locked # crates.io; can trail GitHub Releases
|
||||
|
||||
Có sẵn tệp nhị phân dựng sẵn cho Linux, macOS và Windows trên x64 và arm64. Nix,
|
||||
Homebrew trên Linux, Android/Termux (bản xem trước) và tải thủ công được trình
|
||||
bày trong [hướng dẫn cài đặt](docs/INSTALL.md), còn container thì ở
|
||||
[Docker](docs/DOCKER.md). Mỗi máy chỉ nên dùng một cách cài đặt; nếu không, hai
|
||||
bày trong [hướng dẫn cài đặt](../INSTALL.md), còn container thì ở
|
||||
[Docker](../DOCKER.md). Mỗi máy chỉ nên dùng một cách cài đặt; nếu không, hai
|
||||
bản sẽ cùng nằm trên `PATH` và bản nào đứng trước sẽ được dùng.
|
||||
|
||||
</details>
|
||||
@@ -106,7 +106,7 @@ Bản cài đặt mới khởi động ở chế độ Work với quyền Ask.
|
||||
| Chế độ | `Tab` (khi ô nhập trống) hoặc `/mode` | **Plan** đọc và tìm kiếm nhưng không thay đổi gì. **Work** chỉnh sửa tệp và chạy lệnh. **Operate** có cùng quyền truy cập như Work, coi yêu cầu của bạn là một mục tiêu và tiếp tục làm cho đến khi mục tiêu được xác minh hoặc cần bạn cung cấp thêm thông tin. |
|
||||
| Quyền | `Shift+Tab` | **Ask** áp dụng các chỉnh sửa tệp trong kho mã của bạn mà không hỏi, và hỏi trước khi chạy các lệnh shell không phải chỉ đọc. **Auto-Review** để các quy tắc và một mô hình đánh giá phê duyệt các lệnh gọi thông thường, và từ chối các lệnh gọi rủi ro cao; hãy chuyển sang Ask để tự phê duyệt những lệnh gọi đó. **Full Access** không bao giờ hỏi và tắt sandbox của Codewhale; các quy tắc của kho mã và chính sách được quản lý vẫn được áp dụng. |
|
||||
|
||||
Xem chi tiết trong [hướng dẫn về chế độ và quyền](docs/MODES.md).
|
||||
Xem chi tiết trong [hướng dẫn về chế độ và quyền](../MODES.md).
|
||||
|
||||
## Codewhale làm được gì
|
||||
|
||||
@@ -138,13 +138,13 @@ Mistral, Moonshot, OpenRouter và xAI. Mọi endpoint tương thích OpenAI đ
|
||||
được, mô hình cục bộ qua Ollama, vLLM hoặc SGLang cũng vậy. Mặc định là
|
||||
`deepseek-flash` của DeepSeek, mô hình mà DeepSeek đã chuyển sang
|
||||
DeepSeek-V4.1-Flash-1017 vào ngày 2026-10-17; 0.10.1 chạy được mô hình này mà
|
||||
không cần cập nhật ([chi tiết](docs/PROVIDERS.md#deepseek-v41-flash)).
|
||||
không cần cập nhật ([chi tiết](../PROVIDERS.md#deepseek-v41-flash)).
|
||||
|
||||
`/model` đổi mô hình giữa các lượt, còn `/model auto` chọn một mô hình cho từng
|
||||
lượt (`/router` thiết lập cách chọn). `/turn inspect` cho biết một lượt đã dùng
|
||||
mô hình nào, tốn bao nhiêu chi phí và mất bao lâu. `codewhale auth chatgpt` cho
|
||||
phép bạn dùng gói ChatGPT thay cho khóa API (thử nghiệm). Xem
|
||||
[Nhà cung cấp](docs/PROVIDERS.md).
|
||||
[Nhà cung cấp](../PROVIDERS.md).
|
||||
|
||||
### Biên nhận và hoàn tác
|
||||
|
||||
@@ -154,7 +154,7 @@ chạy, các phê duyệt và người đã phê duyệt, cùng các lần thấ
|
||||
tác yêu cầu gần nhất của bạn; ở 0.10.1, nó cần `/trust on` để hoàn tác tệp và lùi
|
||||
lại từng lệnh gọi công cụ một. `/restore` đưa toàn bộ không gian làm việc về một
|
||||
snapshot trước đó; vì thao tác này ghi đè các chỉnh sửa sau đó, nó cần
|
||||
`/trust on` hoặc Full Access. Xem [Biên nhận](docs/RECEIPTS.md).
|
||||
`/trust on` hoặc Full Access. Xem [Biên nhận](../RECEIPTS.md).
|
||||
|
||||
Các lần chạy exec có sẵn công cụ đều được lưu ở mọi định dạng đầu ra,
|
||||
vì vậy `codewhale receipts --last` dùng được sau `exec --auto`, kể cả khi dùng
|
||||
@@ -166,8 +166,8 @@ tiếp tục cuộc trò chuyện hoặc khi bắt đầu nén cuộc trò chuy
|
||||
### Công việc dài hơi
|
||||
|
||||
`/goal` đặt một mục tiêu được giữ qua các lượt. Codewhale có thể chia việc cho
|
||||
các [tác nhân phụ](docs/SUBAGENTS.md), chạy một [nhóm tác nhân](docs/FLEET.md),
|
||||
hoặc làm theo một [workflow](docs/WORKFLOW_AUTHORING.md) đã được commit vào kho
|
||||
các [tác nhân phụ](../SUBAGENTS.md), chạy một [nhóm tác nhân](../FLEET.md),
|
||||
hoặc làm theo một [workflow](../WORKFLOW_AUTHORING.md) đã được commit vào kho
|
||||
mã.
|
||||
|
||||
### Chuyển từ tác nhân khác
|
||||
@@ -176,25 +176,25 @@ Codewhale tự đọc `AGENTS.md`. Các tệp chỉ dẫn viết cho công cụ
|
||||
`CLAUDE.md`, `.cursorrules` hoặc `.github/copilot-instructions.md`, chỉ được nạp
|
||||
khi bạn chủ động bật bằng `project_instruction_imports = ["claude"]` (hoặc
|
||||
`"cursor"`, `"cline"`, `"windsurf"`, `"copilot"`, `"all"`) trong cấu hình; xem
|
||||
[config.example.toml](config.example.toml). Codewhale sẽ cảnh báo khi tìm thấy
|
||||
[config.example.toml](../../config.example.toml). Codewhale sẽ cảnh báo khi tìm thấy
|
||||
một tệp như vậy mà nó không nạp.
|
||||
|
||||
`/import-claude` chuẩn bị việc nhập cài đặt Claude Code và các máy chủ MCP của
|
||||
bạn để bạn xem lại. `/plugin install` chấp nhận các plugin Claude Code chứa
|
||||
skill, lệnh, hồ sơ tác nhân và máy chủ MCP, và từ chối các plugin cần hook hoặc
|
||||
máy chủ LSP ([chi tiết](docs/CLAUDE_PLUGIN_COMPAT.md)).
|
||||
máy chủ LSP ([chi tiết](../CLAUDE_PLUGIN_COMPAT.md)).
|
||||
|
||||
### Tiện ích mở rộng
|
||||
|
||||
Kết nối [máy chủ MCP](docs/MCP.md), thêm [skill](docs/SKILLS.md) và
|
||||
[plugin](docs/PLUGINS.md), và chạy [hook](docs/HOOKS.md) theo sự kiện phiên và
|
||||
Kết nối [máy chủ MCP](../MCP.md), thêm [skill](../SKILLS.md) và
|
||||
[plugin](../PLUGINS.md), và chạy [hook](../HOOKS.md) theo sự kiện phiên và
|
||||
công cụ. Chế độ code (thử nghiệm, bật theo mặc định) cho phép mô hình viết một
|
||||
chương trình `execute_tools` gọi nhiều công cụ MCP và plugin; mỗi lệnh gọi vẫn
|
||||
tuân theo quy tắc phê duyệt của bạn và vẫn có biên nhận riêng. Plugin Computer
|
||||
Use đi kèm (thử nghiệm, chỉ có trên macOS) có thể quan
|
||||
sát và điều khiển các ứng dụng khác. Plugin này luôn tắt cho đến khi bạn xem lại
|
||||
quyền truy cập của nó và bật nó lên
|
||||
([hướng dẫn](crates/tui/plugins/computer-use/README.md)).
|
||||
([hướng dẫn](../../crates/tui/plugins/computer-use/README.md)).
|
||||
|
||||
## Các cách chạy
|
||||
|
||||
@@ -202,13 +202,13 @@ quyền truy cập của nó và bật nó lên
|
||||
| --- | --- |
|
||||
| `codewhale` | Ứng dụng terminal tương tác |
|
||||
| `codewhale exec "…"` | Một tác vụ không có giao diện. Khi không kèm cờ, nó trả lời mà không dùng công cụ; `--auto` bật công cụ với Full Access theo mặc định, `--sandbox workspace-write` giới hạn chúng, còn `--output-format stream-json` phát trực tiếp các sự kiện dưới dạng JSON |
|
||||
| `codewhale web` | Giao diện web cục bộ tại `127.0.0.1` ([hướng dẫn](docs/WEB.md)) |
|
||||
| `codewhale review --pr N` | Đánh giá mang tính tham khảo cho một pull request trên GitHub. Nó không đăng gì trừ khi bạn thêm `--post`; [GitHub Action](docs/GITHUB_ACTION.md) chạy cùng kiểu đánh giá đó trong CI |
|
||||
| `codewhale app-server --http` | [Runtime API](docs/RUNTIME_API.md), một API HTTP cục bộ cho thread, sự kiện, phê duyệt và các thay đổi tệp của từng lượt |
|
||||
| `codewhale web` | Giao diện web cục bộ tại `127.0.0.1` ([hướng dẫn](../WEB.md)) |
|
||||
| `codewhale review --pr N` | Đánh giá mang tính tham khảo cho một pull request trên GitHub. Nó không đăng gì trừ khi bạn thêm `--post`; [GitHub Action](../GITHUB_ACTION.md) chạy cùng kiểu đánh giá đó trong CI |
|
||||
| `codewhale app-server --http` | [Runtime API](../RUNTIME_API.md), một API HTTP cục bộ cho thread, sự kiện, phê duyệt và các thay đổi tệp của từng lượt |
|
||||
| `codewhale serve --acp` | Agent Client Protocol qua stdio, dành cho các trình soạn thảo như Zed |
|
||||
|
||||
Ứng dụng terminal, `exec`, `web` và Runtime API dùng chung một engine
|
||||
([kiến trúc](docs/ARCHITECTURE.md)). Một
|
||||
([kiến trúc](../ARCHITECTURE.md)). Một
|
||||
[tiện ích mở rộng VS Code](https://marketplace.visualstudio.com/items?itemName=HengQuWorld.brotherwhale-vscode)
|
||||
do cộng đồng duy trì kết nối với engine này từ thanh bên
|
||||
([mã nguồn](https://github.com/HengQuWorld/CodeWhale-VSCode)). Một ứng dụng
|
||||
@@ -243,25 +243,25 @@ tên tệp hay tên kho mã, hoặc thông tin xác thực.
|
||||
`codewhale config set telemetry false` sẽ tắt telemetry. Khi khởi động,
|
||||
Codewhale cũng kiểm tra GitHub xem có bản phát hành mới không; đặt
|
||||
`CODEWHALE_NO_UPDATE_CHECK=1` để bỏ qua bước này. Xem thêm tại
|
||||
[thứ tự cấp quyền](docs/AUTHORIZATION_ORDER.md), [sandbox](docs/SANDBOX.md) và
|
||||
[telemetry](docs/TELEMETRY.md).
|
||||
[thứ tự cấp quyền](../AUTHORIZATION_ORDER.md), [sandbox](../SANDBOX.md) và
|
||||
[telemetry](../TELEMETRY.md).
|
||||
|
||||
## Tài liệu
|
||||
|
||||
| Bắt đầu tại đây | Tham khảo |
|
||||
| --- | --- |
|
||||
| [Cài đặt](docs/INSTALL.md) | [Cấu hình](docs/CONFIGURATION.md) |
|
||||
| [Nhà cung cấp và mô hình cục bộ](docs/PROVIDERS.md) | [Kiến trúc](docs/ARCHITECTURE.md) |
|
||||
| [Chế độ và quyền](docs/MODES.md) | [Runtime API](docs/RUNTIME_API.md) |
|
||||
| [Phím tắt](docs/KEYBINDINGS.md) | [Viết plugin](docs/PLUGIN_AUTHORING.md) |
|
||||
| [Đánh giá PR trên GitHub](docs/GITHUB_ACTION.md) | [Toàn bộ tài liệu](docs/README.md) |
|
||||
| [Cài đặt](../INSTALL.md) | [Cấu hình](../CONFIGURATION.md) |
|
||||
| [Nhà cung cấp và mô hình cục bộ](../PROVIDERS.md) | [Kiến trúc](../ARCHITECTURE.md) |
|
||||
| [Chế độ và quyền](../MODES.md) | [Runtime API](../RUNTIME_API.md) |
|
||||
| [Phím tắt](../KEYBINDINGS.md) | [Viết plugin](../PLUGIN_AUTHORING.md) |
|
||||
| [Đánh giá PR trên GitHub](../GITHUB_ACTION.md) | [Toàn bộ tài liệu](../README.md) |
|
||||
|
||||
## Cộng đồng
|
||||
|
||||
Nếu thiếu một nhà cung cấp hoặc một quy trình làm việc còn bất tiện, hãy
|
||||
[mở một issue](https://github.com/codewhale-hq/CodeWhale/issues/new/choose) hoặc
|
||||
[gửi pull request](CONTRIBUTING.md). Người đóng góp được ghi nhận cho phần việc
|
||||
được tích hợp, và [cấu trúc kho mã](CONTRIBUTING.md#project-structure) cho biết
|
||||
[gửi pull request](../../CONTRIBUTING.md). Người đóng góp được ghi nhận cho phần việc
|
||||
được tích hợp, và [cấu trúc kho mã](../../CONTRIBUTING.md#project-structure) cho biết
|
||||
mọi thứ nằm ở đâu.
|
||||
|
||||
Trò chuyện trên [Discord](https://discord.gg/37gfS3ksug), hoặc thêm người duy
|
||||
@@ -272,9 +272,9 @@ trì dự án, Hunter, trên WeChat (`hunterbown`) và xin vào nhóm Whale Brot
|
||||
Codewhale khởi đầu là `deepseek-tui` và vẫn đọc cấu hình cùng các phiên của dự
|
||||
án đó. Dự án được duy trì độc lập và không liên kết với DeepSeek hay bất kỳ nhà
|
||||
cung cấp mô hình nào khác. Cảm ơn
|
||||
[mọi người đã đóng góp](docs/CONTRIBUTORS.md).
|
||||
[mọi người đã đóng góp](../CONTRIBUTORS.md).
|
||||
|
||||
[](docs/CONTRIBUTORS.md#everyone)
|
||||
[](../CONTRIBUTORS.md#everyone)
|
||||
|
||||
[MIT](LICENSE). Mã được điều chỉnh từ các dự án mã nguồn mở khác được liệt kê
|
||||
trong [thông báo bên thứ ba](docs/THIRD_PARTY_NOTICES.md).
|
||||
[MIT](../../LICENSE). Mã được điều chỉnh từ các dự án mã nguồn mở khác được liệt kê
|
||||
trong [thông báo bên thứ ba](../THIRD_PARTY_NOTICES.md).
|
||||
@@ -1,9 +1,9 @@
|
||||
<!-- source: README.md sha256:182e239fcdf7 -->
|
||||
<!-- source: README.md sha256:7e0946fcaecd -->
|
||||
<div align="center">
|
||||
|
||||
<picture>
|
||||
<source media="(prefers-color-scheme: dark)" srcset="brand/wordmark-inverted.svg">
|
||||
<img src="brand/wordmark.svg" alt="Codewhale" width="320">
|
||||
<source media="(prefers-color-scheme: dark)" srcset="../../brand/wordmark-inverted.svg">
|
||||
<img src="../../brand/wordmark.svg" alt="Codewhale" width="320">
|
||||
</picture>
|
||||
|
||||
**在终端中运行、可搭配任意模型的开源编程智能体。**
|
||||
@@ -15,14 +15,14 @@
|
||||
[](https://github.com/codewhale-hq/CodeWhale/actions/workflows/ci.yml)
|
||||
[](https://crates.io/crates/codewhale-cli)
|
||||
[](https://www.npmjs.com/package/codewhale)
|
||||
[](LICENSE)
|
||||
[](../../LICENSE)
|
||||
[](https://discord.gg/37gfS3ksug)
|
||||
|
||||
[官网](https://codewhale.net) · [文档](docs/README.md) · [更新日志](CHANGELOG.md) · [参与贡献](CONTRIBUTING.md)
|
||||
[官网](https://codewhale.net) · [文档](../README.md) · [更新日志](../../CHANGELOG.md) · [参与贡献](../../CONTRIBUTING.md)
|
||||
|
||||
[English](README.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) · [Català](README.ca.md)
|
||||
[English](../../README.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) · [Català](README.ca.md)
|
||||
|
||||
<img src="web/public/codewhale-tui-0102-demo.png" alt="一次 Codewhale 终端会话" width="760">
|
||||
<img src="../../web/public/codewhale-tui-0102-demo.png" alt="一次 Codewhale 终端会话" width="760">
|
||||
|
||||
<sub>一个使用脚本化测试模型的 0.10.2 开发版本，在一次性工作区中以“完全访问”权限运行。其中的编辑、三个测试和一次子智能体审查都是真实运行的。</sub>
|
||||
|
||||
@@ -38,8 +38,8 @@ curl -fsSL https://codewhale.net/install.sh | sh
|
||||
|
||||
安装器会把经过校验和验证的 `codewhale` 及其简短别名 `codew` 放到 `~/.local/bin`。
|
||||
如果之后 shell 提示 `command not found`，请运行安装器打印出的那行 PATH 命令
|
||||
（[详情](docs/INSTALL.md#put-it-on-your-path)）。使用 `codewhale update` 升级。这些命令安装的是最新发布版本。
|
||||
本页跟随 `main` 更新，因此标注了版本号的功能会在该版本中推出；[更新日志](CHANGELOG.md)列出了每个版本新增的内容。
|
||||
（[详情](../INSTALL.md#put-it-on-your-path)）。使用 `codewhale update` 升级。这些命令安装的是最新发布版本。
|
||||
本页跟随 `main` 更新，因此标注了版本号的功能会在该版本中推出；[更新日志](../../CHANGELOG.md)列出了每个版本新增的内容。
|
||||
|
||||
<details>
|
||||
<summary><b>Windows、npm、Cargo 及其他安装方式</b></summary>
|
||||
@@ -51,8 +51,8 @@ cargo install codewhale-cli --locked # crates.io; can trail GitHub Releases
|
||||
```
|
||||
|
||||
预编译二进制文件覆盖 Linux、macOS 和 Windows 的 x64 与 arm64 架构。Nix、Linux 上的
|
||||
Homebrew、Android/Termux（预览版）以及手动下载见[安装指南](docs/INSTALL.md)，容器见
|
||||
[Docker](docs/DOCKER.md)。每台机器只使用一种安装方式；否则 `PATH` 上会出现两份副本，
|
||||
Homebrew、Android/Termux（预览版）以及手动下载见[安装指南](../INSTALL.md)，容器见
|
||||
[Docker](../DOCKER.md)。每台机器只使用一种安装方式；否则 `PATH` 上会出现两份副本，
|
||||
排在前面的那一份生效。
|
||||
|
||||
</details>
|
||||
@@ -93,7 +93,7 @@ codewhale exec --auto --sandbox workspace-write "fix the failing tests and expla
|
||||
| 模式 | `Tab`（输入框为空时）或 `/mode` | **Plan** 只读取和搜索，不做任何改动。**Work** 编辑文件并运行命令。**Operate** 拥有与 Work 相同的访问权限，把你的请求当作一个目标，并持续推进，直到目标得到验证或需要你提供输入为止。 |
|
||||
| 权限 | `Shift+Tab` | **询问**（Ask）在你的仓库中直接应用文件编辑而不询问，并在运行非只读的 shell 命令之前先询问。**自动审核**（Auto-Review）让规则和一个审查模型批准常规调用，并拒绝高风险调用；如需亲自批准这些调用，请切换到“询问”。**完全访问**（Full Access）从不询问，并关闭 Codewhale 的沙箱；仓库规则和受管策略仍然适用。 |
|
||||
|
||||
详情见[模式与权限指南](docs/MODES.md)。
|
||||
详情见[模式与权限指南](../MODES.md)。
|
||||
|
||||
## 功能
|
||||
|
||||
@@ -120,19 +120,19 @@ codewhale exec --auto --sandbox workspace-write "fix the failing tests and expla
|
||||
OpenRouter 和 xAI。任何兼容 OpenAI 的端点都可以使用，通过 Ollama、vLLM 或 SGLang
|
||||
运行的本地模型也可以。默认模型是 DeepSeek 的 `deepseek-flash`，DeepSeek 已于 2026-10-17
|
||||
将其切换为 DeepSeek-V4.1-Flash-1017；0.10.1 无需更新即可运行它
|
||||
（[详情](docs/PROVIDERS.md#deepseek-v41-flash)）。
|
||||
（[详情](../PROVIDERS.md#deepseek-v41-flash)）。
|
||||
|
||||
`/model` 可在回合之间切换模型，`/model auto` 会为每个回合挑选一个模型（用 `/router`
|
||||
设置挑选方式）。`/turn inspect` 显示某个回合使用了哪个模型、花费多少以及耗时多久。
|
||||
`codewhale auth chatgpt` 让你可以用 ChatGPT 套餐代替 API 密钥（实验性）。
|
||||
参见[提供商](docs/PROVIDERS.md)。
|
||||
参见[提供商](../PROVIDERS.md)。
|
||||
|
||||
### 回执与撤销
|
||||
|
||||
`/receipts`（退出后可用 `codewhale receipts --last`）会列出修改过的文件、运行过的命令、
|
||||
Web 和 MCP 调用、启动过的智能体、审批及审批人，以及失败记录。`/undo` 撤销你的上一个请求；
|
||||
在 0.10.1 中，撤销文件改动需要 `/trust on`，而且每次只回退一个工具调用。`/restore` 把整个工作区回滚到更早的快照；由于这会覆盖之后的编辑，它需要 `/trust on`
|
||||
或“完全访问”权限。参见[回执](docs/RECEIPTS.md)。
|
||||
或“完全访问”权限。参见[回执](../RECEIPTS.md)。
|
||||
|
||||
可使用工具的 exec 运行无论采用哪种输出格式都会保存，因此在 `exec --auto` 之后，
|
||||
包括使用 `--json` 时，`codewhale receipts --last` 都能正常工作。仅作答且使用文本输出或
|
||||
@@ -142,29 +142,29 @@ Web 和 MCP 调用、启动过的智能体、审批及审批人，以及失败
|
||||
### 更长的任务
|
||||
|
||||
`/goal` 设定一个跨回合持续有效的目标。Codewhale 可以把工作拆分给
|
||||
[子智能体](docs/SUBAGENTS.md)，运行由多个智能体组成的 [Fleet](docs/FLEET.md)，
|
||||
或者按照提交到仓库中的[工作流](docs/WORKFLOW_AUTHORING.md)执行。
|
||||
[子智能体](../SUBAGENTS.md)，运行由多个智能体组成的 [Fleet](../FLEET.md)，
|
||||
或者按照提交到仓库中的[工作流](../WORKFLOW_AUTHORING.md)执行。
|
||||
|
||||
### 从其他智能体迁移
|
||||
|
||||
Codewhale 会自动读取 `AGENTS.md`。为其他工具编写的指令文件，例如 `CLAUDE.md`、
|
||||
`.cursorrules` 或 `.github/copilot-instructions.md`，只有在你于配置中设置
|
||||
`project_instruction_imports = ["claude"]`（或 `"cursor"`、`"cline"`、`"windsurf"`、
|
||||
`"copilot"`、`"all"`）主动启用后才会加载；参见 [config.example.toml](config.example.toml)。
|
||||
`"copilot"`、`"all"`）主动启用后才会加载；参见 [config.example.toml](../../config.example.toml)。
|
||||
如果 Codewhale 发现了未加载的此类文件，会给出警告。
|
||||
|
||||
`/import-claude` 会准备一份导入你的 Claude Code 设置和 MCP 服务器的方案，供你审阅。
|
||||
`/plugin install` 接受包含技能、命令、智能体配置文件和 MCP 服务器的 Claude Code 插件，
|
||||
但会拒绝需要钩子或 LSP 服务器的插件（[详情](docs/CLAUDE_PLUGIN_COMPAT.md)）。
|
||||
但会拒绝需要钩子或 LSP 服务器的插件（[详情](../CLAUDE_PLUGIN_COMPAT.md)）。
|
||||
|
||||
### 扩展
|
||||
|
||||
连接 [MCP 服务器](docs/MCP.md)，添加[技能](docs/SKILLS.md)和[插件](docs/PLUGINS.md)，
|
||||
并在会话和工具事件上运行[钩子](docs/HOOKS.md)。代码模式（Code mode，实验性，默认开启）
|
||||
连接 [MCP 服务器](../MCP.md)，添加[技能](../SKILLS.md)和[插件](../PLUGINS.md)，
|
||||
并在会话和工具事件上运行[钩子](../HOOKS.md)。代码模式（Code mode，实验性，默认开启）
|
||||
让模型编写一个 `execute_tools` 程序来调用多个 MCP 和插件工具；每次调用仍要遵守你的审批规则，
|
||||
并保留各自的回执。内置的 Computer Use 插件（实验性，
|
||||
仅限 macOS）可以观察和操作其他应用。在你审阅其访问权限并启用之前，它保持关闭
|
||||
（[指南](crates/tui/plugins/computer-use/README.md)）。
|
||||
（[指南](../../crates/tui/plugins/computer-use/README.md)）。
|
||||
|
||||
## 运行方式
|
||||
|
||||
@@ -172,12 +172,12 @@ Codewhale 会自动读取 `AGENTS.md`。为其他工具编写的指令文件，
|
||||
| --- | --- |
|
||||
| `codewhale` | 交互式终端应用 |
|
||||
| `codewhale exec "…"` | 不启动界面，运行一个任务。单独使用时，它只作答而不使用工具；`--auto` 默认以“完全访问”权限启用工具，`--sandbox workspace-write` 对工具施加限制，`--output-format stream-json` 以 JSON 形式流式输出事件 |
|
||||
| `codewhale web` | 监听 `127.0.0.1` 的本地 Web 界面（[指南](docs/WEB.md)） |
|
||||
| `codewhale review --pr N` | 对 GitHub PR 进行仅供参考的审查。除非你加上 `--post`，否则它不会发布任何内容；[GitHub Action](docs/GITHUB_ACTION.md) 会在 CI 中运行同样的审查 |
|
||||
| `codewhale app-server --http` | [Runtime API](docs/RUNTIME_API.md)，用于对话线程、事件、审批以及每个回合文件改动的本地 HTTP API |
|
||||
| `codewhale web` | 监听 `127.0.0.1` 的本地 Web 界面（[指南](../WEB.md)） |
|
||||
| `codewhale review --pr N` | 对 GitHub PR 进行仅供参考的审查。除非你加上 `--post`，否则它不会发布任何内容；[GitHub Action](../GITHUB_ACTION.md) 会在 CI 中运行同样的审查 |
|
||||
| `codewhale app-server --http` | [Runtime API](../RUNTIME_API.md)，用于对话线程、事件、审批以及每个回合文件改动的本地 HTTP API |
|
||||
| `codewhale serve --acp` | 通过 stdio 提供 Agent Client Protocol，供 Zed 等编辑器使用 |
|
||||
|
||||
终端应用、`exec`、`web` 和 Runtime API 共用同一个引擎（[架构](docs/ARCHITECTURE.md)）。
|
||||
终端应用、`exec`、`web` 和 Runtime API 共用同一个引擎（[架构](../ARCHITECTURE.md)）。
|
||||
社区维护的
|
||||
[VS Code 扩展](https://marketplace.visualstudio.com/items?itemName=HengQuWorld.brotherwhale-vscode)
|
||||
可以从侧边栏连接到它（[源码](https://github.com/HengQuWorld/CodeWhale-VSCode)）。
|
||||
@@ -203,25 +203,25 @@ macOS 上是 Seatbelt，Linux 上是 bubblewrap（需已安装）。Windows 目
|
||||
功能和错误计数），并附带一个每 90 天轮换一次的随机安装 ID；它从不包含对话、代码、提示词、
|
||||
模型名称、文件名或仓库名，也从不包含凭据。运行 `codewhale config set telemetry false` 即可关闭。启动时，Codewhale 还会
|
||||
检查 GitHub 上是否有新版本；设置 `CODEWHALE_NO_UPDATE_CHECK=1` 可跳过这一检查。
|
||||
更多信息见[授权顺序](docs/AUTHORIZATION_ORDER.md)、[沙箱](docs/SANDBOX.md)和
|
||||
[遥测](docs/TELEMETRY.md)。
|
||||
更多信息见[授权顺序](../AUTHORIZATION_ORDER.md)、[沙箱](../SANDBOX.md)和
|
||||
[遥测](../TELEMETRY.md)。
|
||||
|
||||
## 文档
|
||||
|
||||
| 从这里开始 | 参考 |
|
||||
| --- | --- |
|
||||
| [安装](docs/INSTALL.md) | [配置](docs/CONFIGURATION.md) |
|
||||
| [提供商与本地模型](docs/PROVIDERS.md) | [架构](docs/ARCHITECTURE.md) |
|
||||
| [模式与权限](docs/MODES.md) | [Runtime API](docs/RUNTIME_API.md) |
|
||||
| [快捷键](docs/KEYBINDINGS.md) | [插件开发](docs/PLUGIN_AUTHORING.md) |
|
||||
| [GitHub PR 审查](docs/GITHUB_ACTION.md) | [全部文档](docs/README.md) |
|
||||
| [安装](../INSTALL.md) | [配置](../CONFIGURATION.md) |
|
||||
| [提供商与本地模型](../PROVIDERS.md) | [架构](../ARCHITECTURE.md) |
|
||||
| [模式与权限](../MODES.md) | [Runtime API](../RUNTIME_API.md) |
|
||||
| [快捷键](../KEYBINDINGS.md) | [插件开发](../PLUGIN_AUTHORING.md) |
|
||||
| [GitHub PR 审查](../GITHUB_ACTION.md) | [全部文档](../README.md) |
|
||||
|
||||
## 社区
|
||||
|
||||
如果缺少某个提供商，或某个工作流用起来不顺手，
|
||||
请[提交 issue](https://github.com/codewhale-hq/CodeWhale/issues/new/choose)或
|
||||
[提交 PR](CONTRIBUTING.md)。被合并的工作会保留贡献者的署名；
|
||||
[仓库结构](CONTRIBUTING.md#project-structure)说明了各部分代码所在的位置。
|
||||
[提交 PR](../../CONTRIBUTING.md)。被合并的工作会保留贡献者的署名；
|
||||
[仓库结构](../../CONTRIBUTING.md#project-structure)说明了各部分代码所在的位置。
|
||||
|
||||
欢迎在 [Discord](https://discord.gg/37gfS3ksug) 上交流，或在微信上添加维护者 Hunter
|
||||
（`hunterbown`），申请加入 Whale Brothers 群。
|
||||
@@ -229,8 +229,8 @@ macOS 上是 Seatbelt，Linux 上是 bubblewrap（需已安装）。Windows 目
|
||||
## 历史与许可证
|
||||
|
||||
Codewhale 最初名为 `deepseek-tui`，至今仍会读取该项目的配置和会话。它是独立维护的项目，
|
||||
与 DeepSeek 或任何其他模型提供商均无隶属关系。感谢[每一位贡献者](docs/CONTRIBUTORS.md)。
|
||||
与 DeepSeek 或任何其他模型提供商均无隶属关系。感谢[每一位贡献者](../CONTRIBUTORS.md)。
|
||||
|
||||
[](docs/CONTRIBUTORS.md#everyone)
|
||||
[](../CONTRIBUTORS.md#everyone)
|
||||
|
||||
[MIT](LICENSE)。改编自其他开源项目的代码列在[第三方声明](docs/THIRD_PARTY_NOTICES.md)中。
|
||||
[MIT](../../LICENSE)。改编自其他开源项目的代码列在[第三方声明](../THIRD_PARTY_NOTICES.md)中。
|
||||
@@ -1,9 +1,9 @@
|
||||
<!-- source: README.md sha256:182e239fcdf7 -->
|
||||
<!-- source: README.md sha256:7e0946fcaecd -->
|
||||
<div align="center">
|
||||
|
||||
<picture>
|
||||
<source media="(prefers-color-scheme: dark)" srcset="brand/wordmark-inverted.svg">
|
||||
<img src="brand/wordmark.svg" alt="Codewhale" width="320">
|
||||
<source media="(prefers-color-scheme: dark)" srcset="../../brand/wordmark-inverted.svg">
|
||||
<img src="../../brand/wordmark.svg" alt="Codewhale" width="320">
|
||||
</picture>
|
||||
|
||||
**在終端機中運作、可搭配任何模型的開源程式開發代理（coding agent）。**
|
||||
@@ -15,14 +15,14 @@
|
||||
[](https://github.com/codewhale-hq/CodeWhale/actions/workflows/ci.yml)
|
||||
[](https://crates.io/crates/codewhale-cli)
|
||||
[](https://www.npmjs.com/package/codewhale)
|
||||
[](LICENSE)
|
||||
[](../../LICENSE)
|
||||
[](https://discord.gg/37gfS3ksug)
|
||||
|
||||
[官方網站](https://codewhale.net) · [文件](docs/README.md) · [變更記錄](CHANGELOG.md) · [參與貢獻](CONTRIBUTING.md)
|
||||
[官方網站](https://codewhale.net) · [文件](../README.md) · [變更記錄](../../CHANGELOG.md) · [參與貢獻](../../CONTRIBUTING.md)
|
||||
|
||||
[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.hi.md) · [Türkçe](README.tr.md) · [Italiano](README.it.md) · [Polski](README.pl.md) · [العربية](README.ar.md) · [Català](README.ca.md)
|
||||
[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.hi.md) · [Türkçe](README.tr.md) · [Italiano](README.it.md) · [Polski](README.pl.md) · [العربية](README.ar.md) · [Català](README.ca.md)
|
||||
|
||||
<img src="web/public/codewhale-tui-0102-demo.png" alt="一次 Codewhale 終端機工作階段" width="760">
|
||||
<img src="../../web/public/codewhale-tui-0102-demo.png" alt="一次 Codewhale 終端機工作階段" width="760">
|
||||
|
||||
<sub>使用腳本化測試模型的 0.10.2 開發版本，在用完即丟的工作區中以「完整存取」執行。其中的編輯、三項測試與一次子代理審查都是實際執行的。</sub>
|
||||
|
||||
@@ -38,8 +38,8 @@ curl -fsSL https://codewhale.net/install.sh | sh
|
||||
|
||||
安裝程式會把經過 checksum 驗證的 `codewhale` 及其簡短別名 `codew` 放到 `~/.local/bin`。
|
||||
如果之後 shell 顯示 `command not found`，請執行安裝程式印出的那一行 PATH 指令
|
||||
（[詳細說明](docs/INSTALL.md#put-it-on-your-path)）。執行 `codewhale update` 即可升級。這些指令安裝的是最新發行版本。
|
||||
本頁跟隨 `main` 更新，因此標示版本的功能會在該版本推出；[變更記錄](CHANGELOG.md)列出了每個版本新增的內容。
|
||||
（[詳細說明](../INSTALL.md#put-it-on-your-path)）。執行 `codewhale update` 即可升級。這些指令安裝的是最新發行版本。
|
||||
本頁跟隨 `main` 更新，因此標示版本的功能會在該版本推出；[變更記錄](../../CHANGELOG.md)列出了每個版本新增的內容。
|
||||
|
||||
<details>
|
||||
<summary><b>Windows、npm、Cargo 與其他安裝方式</b></summary>
|
||||
@@ -51,8 +51,8 @@ cargo install codewhale-cli --locked # crates.io; can trail GitHub Releases
|
||||
```
|
||||
|
||||
預先建置的二進位檔涵蓋 x64 與 arm64 上的 Linux、macOS 與 Windows。Nix、Linux 上的
|
||||
Homebrew、Android/Termux（預覽版）與手動下載請見[安裝指南](docs/INSTALL.md)，容器請見
|
||||
[Docker](docs/DOCKER.md)。每台機器請只使用一種安裝方式；否則 `PATH` 上會出現兩份副本，
|
||||
Homebrew、Android/Termux（預覽版）與手動下載請見[安裝指南](../INSTALL.md)，容器請見
|
||||
[Docker](../DOCKER.md)。每台機器請只使用一種安裝方式；否則 `PATH` 上會出現兩份副本，
|
||||
以排在前面的那份為準。
|
||||
|
||||
</details>
|
||||
@@ -92,7 +92,7 @@ codewhale exec --auto --sandbox workspace-write "fix the failing tests and expla
|
||||
| 模式 | `Tab`（輸入框為空時）或 `/mode` | **Plan** 會讀取與搜尋，但不做任何變更。**Work** 會編輯檔案並執行指令。**Operate** 擁有與 Work 相同的存取權限，會把你的請求當作目標，持續推進，直到目標通過驗證或需要你提供輸入為止。 |
|
||||
| 權限 | `Shift+Tab` | **詢問**（Ask）會在你的儲存庫中直接套用檔案編輯、不先詢問，並在執行非唯讀的 shell 指令前先詢問。**自動審核**（Auto-Review）讓規則與審核模型核准例行呼叫，並拒絕高風險呼叫；若要自行核准這些呼叫，請切換到「詢問」。**完整存取**（Full Access）從不詢問，並關閉 Codewhale 的沙箱；儲存庫規則與受管理的政策仍然適用。 |
|
||||
|
||||
詳情請參閱[模式與權限指南](docs/MODES.md)。
|
||||
詳情請參閱[模式與權限指南](../MODES.md)。
|
||||
|
||||
## 功能
|
||||
|
||||
@@ -119,19 +119,19 @@ codewhale exec --auto --sandbox workspace-write "fix the failing tests and expla
|
||||
OpenRouter 與 xAI。任何相容 OpenAI 的端點都能使用，透過 Ollama、vLLM 或 SGLang 執行的
|
||||
本機模型也可以。預設模型是 DeepSeek 的 `deepseek-flash`，DeepSeek 已於 2026-10-17
|
||||
將其切換為 DeepSeek-V4.1-Flash-1017；0.10.1 不需更新即可執行
|
||||
（[詳細說明](docs/PROVIDERS.md#deepseek-v41-flash)）。
|
||||
（[詳細說明](../PROVIDERS.md#deepseek-v41-flash)）。
|
||||
|
||||
`/model` 可在回合之間切換模型，`/model auto` 會為每個回合挑選模型（以 `/router`
|
||||
設定挑選方式）。`/turn inspect` 會顯示某個回合使用了哪個模型、花費多少以及耗時多久。
|
||||
`codewhale auth chatgpt` 讓你可以用 ChatGPT 方案取代 API 金鑰（實驗性）。
|
||||
請參閱[供應商](docs/PROVIDERS.md)。
|
||||
請參閱[供應商](../PROVIDERS.md)。
|
||||
|
||||
### 回條與復原
|
||||
|
||||
`/receipts`（或在結束後執行 `codewhale receipts --last`）會列出變更的檔案、執行的指令、
|
||||
網路與 MCP 呼叫、啟動的代理、核准紀錄與核准人，以及失敗項目。`/undo` 會還原你上一個請求；
|
||||
在 0.10.1 中，還原檔案需要 `/trust on`，而且每次只退回一個工具呼叫。`/restore` 會把整個工作區回復到先前的快照；由於這會覆寫之後的編輯，因此需要 `/trust on`
|
||||
或「完整存取」。請參閱[回條](docs/RECEIPTS.md)。
|
||||
或「完整存取」。請參閱[回條](../RECEIPTS.md)。
|
||||
|
||||
可使用工具的 exec 執行紀錄無論採用哪種輸出格式都會儲存，因此在 `exec --auto` 之後，
|
||||
包括使用 `--json` 時，`codewhale receipts --last` 都能正常運作。只回答且使用文字輸出或
|
||||
@@ -140,30 +140,30 @@ OpenRouter 與 xAI。任何相容 OpenAI 的端點都能使用，透過 Ollama
|
||||
|
||||
### 長時間工作
|
||||
|
||||
`/goal` 會設定一個跨回合延續的目標。Codewhale 可以把工作分給[子代理](docs/SUBAGENTS.md)、
|
||||
執行[代理團隊（Fleet）](docs/FLEET.md)，或依照已提交到儲存庫的
|
||||
[工作流程](docs/WORKFLOW_AUTHORING.md)進行。
|
||||
`/goal` 會設定一個跨回合延續的目標。Codewhale 可以把工作分給[子代理](../SUBAGENTS.md)、
|
||||
執行[代理團隊（Fleet）](../FLEET.md)，或依照已提交到儲存庫的
|
||||
[工作流程](../WORKFLOW_AUTHORING.md)進行。
|
||||
|
||||
### 從其他代理轉過來
|
||||
|
||||
Codewhale 會自行讀取 `AGENTS.md`。為其他工具撰寫的指示檔，例如 `CLAUDE.md`、`.cursorrules`
|
||||
或 `.github/copilot-instructions.md`，只有在你於設定中以
|
||||
`project_instruction_imports = ["claude"]`（或 `"cursor"`、`"cline"`、`"windsurf"`、
|
||||
`"copilot"`、`"all"`）選擇啟用時才會載入；請參閱 [config.example.toml](config.example.toml)。
|
||||
`"copilot"`、`"all"`）選擇啟用時才會載入；請參閱 [config.example.toml](../../config.example.toml)。
|
||||
Codewhale 發現這類檔案卻沒有載入時，會發出警告。
|
||||
|
||||
`/import-claude` 會準備匯入你的 Claude Code 設定與 MCP 伺服器，供你審閱。`/plugin install`
|
||||
接受包含技能、指令、代理設定檔與 MCP 伺服器的 Claude Code 外掛，並拒絕需要 Hook 或 LSP
|
||||
伺服器的外掛（[詳細說明](docs/CLAUDE_PLUGIN_COMPAT.md)）。
|
||||
伺服器的外掛（[詳細說明](../CLAUDE_PLUGIN_COMPAT.md)）。
|
||||
|
||||
### 擴充功能
|
||||
|
||||
連接 [MCP 伺服器](docs/MCP.md)、加入[技能](docs/SKILLS.md)與[外掛](docs/PLUGINS.md)，
|
||||
並在工作階段與工具事件上執行 [Hook](docs/HOOKS.md)。程式碼模式（Code mode，實驗性，預設開啟）
|
||||
連接 [MCP 伺服器](../MCP.md)、加入[技能](../SKILLS.md)與[外掛](../PLUGINS.md)，
|
||||
並在工作階段與工具事件上執行 [Hook](../HOOKS.md)。程式碼模式（Code mode，實驗性，預設開啟）
|
||||
讓模型撰寫一個 `execute_tools` 程式來呼叫多個 MCP 與外掛工具；每次呼叫仍須遵守你的核准規則，
|
||||
並保留各自的回條。隨附的 Computer Use 外掛（實驗性，
|
||||
僅限 macOS）可以觀察並操作其他應用程式。在你檢視其存取範圍並啟用之前，它會保持關閉
|
||||
（[指南](crates/tui/plugins/computer-use/README.md)）。
|
||||
（[指南](../../crates/tui/plugins/computer-use/README.md)）。
|
||||
|
||||
## 執行方式
|
||||
|
||||
@@ -171,12 +171,12 @@ Codewhale 發現這類檔案卻沒有載入時，會發出警告。
|
||||
| --- | --- |
|
||||
| `codewhale` | 互動式終端機應用程式 |
|
||||
| `codewhale exec "…"` | 在沒有介面的情況下執行一項任務。單獨使用時，它只回答、不使用工具；`--auto` 預設以「完整存取」權限啟用工具，`--sandbox workspace-write` 對工具加以限制，`--output-format stream-json` 以 JSON 串流輸出事件 |
|
||||
| `codewhale web` | 在 `127.0.0.1` 上的本機 Web UI（[指南](docs/WEB.md)） |
|
||||
| `codewhale review --pr N` | 對 GitHub PR（Pull Request）進行僅供參考的審查。除非你加上 `--post`，否則不會張貼任何內容；[GitHub Action](docs/GITHUB_ACTION.md) 會在 CI 中執行相同的審查 |
|
||||
| `codewhale app-server --http` | [Runtime API](docs/RUNTIME_API.md)，用於執行緒、事件、核准與每個回合檔案變更的本機 HTTP API |
|
||||
| `codewhale web` | 在 `127.0.0.1` 上的本機 Web UI（[指南](../WEB.md)） |
|
||||
| `codewhale review --pr N` | 對 GitHub PR（Pull Request）進行僅供參考的審查。除非你加上 `--post`，否則不會張貼任何內容；[GitHub Action](../GITHUB_ACTION.md) 會在 CI 中執行相同的審查 |
|
||||
| `codewhale app-server --http` | [Runtime API](../RUNTIME_API.md)，用於執行緒、事件、核准與每個回合檔案變更的本機 HTTP API |
|
||||
| `codewhale serve --acp` | 透過 stdio 提供的 Agent Client Protocol，供 Zed 等編輯器使用 |
|
||||
|
||||
終端機應用程式、`exec`、`web` 與 Runtime API 共用同一個引擎（[架構](docs/ARCHITECTURE.md)）。
|
||||
終端機應用程式、`exec`、`web` 與 Runtime API 共用同一個引擎（[架構](../ARCHITECTURE.md)）。
|
||||
由社群維護的
|
||||
[VS Code 擴充功能](https://marketplace.visualstudio.com/items?itemName=HengQuWorld.brotherwhale-vscode)
|
||||
可從側邊欄連接到它（[原始碼](https://github.com/HengQuWorld/CodeWhale-VSCode)）。
|
||||
@@ -203,24 +203,24 @@ Seatbelt，Linux 上則在已安裝 bubblewrap 時使用它。Windows 目前還
|
||||
模型名稱、檔案或儲存庫名稱，或憑證。
|
||||
執行 `codewhale config set telemetry false` 即可關閉。Codewhale 啟動時也會向 GitHub 檢查
|
||||
是否有新版本；設定 `CODEWHALE_NO_UPDATE_CHECK=1` 即可略過。更多資訊請參閱
|
||||
[授權順序](docs/AUTHORIZATION_ORDER.md)、[沙箱](docs/SANDBOX.md)與[遙測](docs/TELEMETRY.md)。
|
||||
[授權順序](../AUTHORIZATION_ORDER.md)、[沙箱](../SANDBOX.md)與[遙測](../TELEMETRY.md)。
|
||||
|
||||
## 文件
|
||||
|
||||
| 從這裡開始 | 參考資料 |
|
||||
| --- | --- |
|
||||
| [安裝](docs/INSTALL.md) | [設定](docs/CONFIGURATION.md) |
|
||||
| [供應商與本機模型](docs/PROVIDERS.md) | [架構](docs/ARCHITECTURE.md) |
|
||||
| [模式與權限](docs/MODES.md) | [Runtime API](docs/RUNTIME_API.md) |
|
||||
| [鍵盤快速鍵](docs/KEYBINDINGS.md) | [外掛開發](docs/PLUGIN_AUTHORING.md) |
|
||||
| [GitHub PR 審查](docs/GITHUB_ACTION.md) | [所有文件](docs/README.md) |
|
||||
| [安裝](../INSTALL.md) | [設定](../CONFIGURATION.md) |
|
||||
| [供應商與本機模型](../PROVIDERS.md) | [架構](../ARCHITECTURE.md) |
|
||||
| [模式與權限](../MODES.md) | [Runtime API](../RUNTIME_API.md) |
|
||||
| [鍵盤快速鍵](../KEYBINDINGS.md) | [外掛開發](../PLUGIN_AUTHORING.md) |
|
||||
| [GitHub PR 審查](../GITHUB_ACTION.md) | [所有文件](../README.md) |
|
||||
|
||||
## 社群
|
||||
|
||||
如果缺少某個供應商，或某個工作流程不順手，
|
||||
請[提出 issue](https://github.com/codewhale-hq/CodeWhale/issues/new/choose)或
|
||||
[送出 PR](CONTRIBUTING.md)。被合併的成果會保留貢獻者的署名；
|
||||
[儲存庫結構](CONTRIBUTING.md#project-structure)說明了各部分放在哪裡。
|
||||
[送出 PR](../../CONTRIBUTING.md)。被合併的成果會保留貢獻者的署名；
|
||||
[儲存庫結構](../../CONTRIBUTING.md#project-structure)說明了各部分放在哪裡。
|
||||
|
||||
歡迎到 [Discord](https://discord.gg/37gfS3ksug) 交流，或在微信上加維護者 Hunter
|
||||
（`hunterbown`）為好友，申請加入 Whale Brothers 群組。
|
||||
@@ -228,8 +228,8 @@ Seatbelt，Linux 上則在已安裝 bubblewrap 時使用它。Windows 目前還
|
||||
## 歷史與授權
|
||||
|
||||
Codewhale 最初名為 `deepseek-tui`，至今仍會讀取該專案的設定與工作階段。它是獨立維護的專案，
|
||||
與 DeepSeek 或任何其他模型供應商均無隸屬關係。感謝[每一位貢獻者](docs/CONTRIBUTORS.md)。
|
||||
與 DeepSeek 或任何其他模型供應商均無隸屬關係。感謝[每一位貢獻者](../CONTRIBUTORS.md)。
|
||||
|
||||
[](docs/CONTRIBUTORS.md#everyone)
|
||||
[](../CONTRIBUTORS.md#everyone)
|
||||
|
||||
[MIT](LICENSE)。改編自其他開源專案的程式碼列於[第三方聲明](docs/THIRD_PARTY_NOTICES.md)中。
|
||||
[MIT](../../LICENSE)。改編自其他開源專案的程式碼列於[第三方聲明](../THIRD_PARTY_NOTICES.md)中。
|
||||
@@ -6,7 +6,7 @@
|
||||
凡 Codewhale 已发布、正在构建、已排期或明确搁置的区域设置（locale），都以本文档为准。
|
||||
|
||||
> **范围说明（2026-07-12）：** 本矩阵覆盖三个层面——TUI 语言包
|
||||
> （`crates/localization/locales/`）、已翻译的 README（仓库根目录），以及网站（`web/`）。
|
||||
> （`crates/localization/locales/`）、已翻译的 README（`docs/i18n/`），以及网站（`web/`）。
|
||||
> 三者发布节奏不同，所以同一个区域设置可能在某个层面已**发布**、在另一个层面还是
|
||||
> **已排期**；下面每个层面各有一张表，每张表只讲自己层面的事实。网站注册表是
|
||||
> `web/lib/i18n/config.ts`（`ALL_LOCALES`）：区域设置切换器和路由生成都从它派生。
|
||||
@@ -122,24 +122,24 @@ partial 区域设置在网站上还差的范围（下一波）：首页之外的
|
||||
| 区域设置 | 文件 | 状态 | 对等检查 |
|
||||
|--------|------|--------|-------------|
|
||||
| 英语 | `README.md` | **shipped** | 权威源文件 |
|
||||
| 简体中文 | `README.zh-CN.md` | **shipped** | `scripts/check-readme-translations.py`（同步戳 + 代码围栏 + URL + 章节） |
|
||||
| 日语 | `README.ja-JP.md` | **shipped** | 同上 |
|
||||
| 越南语 | `README.vi.md` | **shipped** | 同上 |
|
||||
| 韩语 | `README.ko-KR.md` | **shipped** | 同上 |
|
||||
| 拉美西班牙语 | `README.es-419.md` | **shipped** | 同上 |
|
||||
| 巴西葡萄牙语 | `README.pt-BR.md` | **shipped** | 同上 |
|
||||
| 俄语 | `README.ru.md` | **shipped** | 同上（#3092）。等待母语者审核。 |
|
||||
| 乌克兰语 | `README.uk.md` | **shipped** | 同上（#4791）。等待母语者审核。 |
|
||||
| 印尼语 | `README.id.md` | **shipped** | 同上（#4789）。等待母语者审核。 |
|
||||
| 法语 | `README.fr.md` | **shipped** | 同上。等待母语者审核。 |
|
||||
| 德语 | `README.de.md` | **shipped** | 同上。等待母语者审核。 |
|
||||
| 繁体中文 | `README.zh-TW.md` | **shipped** | 同上。等待母语者审核。 |
|
||||
| 印地语 | `README.hi.md` | **shipped** | 同上。等待母语者审核。 |
|
||||
| 土耳其语 | `README.tr.md` | **shipped** | 同上。等待母语者审核。 |
|
||||
| 意大利语 | `README.it.md` | **shipped** | 同上。等待母语者审核。 |
|
||||
| 波兰语 | `README.pl.md` | **shipped** | 同上。等待母语者审核。 |
|
||||
| 阿拉伯语 | `README.ar.md` | **shipped** | 同上。等待母语者审核。只用 Markdown；不加 HTML `dir` 属性。 |
|
||||
| 加泰罗尼亚语 | `README.ca.md` | **shipped** | 同上。等待母语者审核。 |
|
||||
| 简体中文 | `docs/i18n/README.zh-CN.md` | **shipped** | `scripts/check-readme-translations.py`（同步戳 + 代码围栏 + URL + 章节） |
|
||||
| 日语 | `docs/i18n/README.ja-JP.md` | **shipped** | 同上 |
|
||||
| 越南语 | `docs/i18n/README.vi.md` | **shipped** | 同上 |
|
||||
| 韩语 | `docs/i18n/README.ko-KR.md` | **shipped** | 同上 |
|
||||
| 拉美西班牙语 | `docs/i18n/README.es-419.md` | **shipped** | 同上 |
|
||||
| 巴西葡萄牙语 | `docs/i18n/README.pt-BR.md` | **shipped** | 同上 |
|
||||
| 俄语 | `docs/i18n/README.ru.md` | **shipped** | 同上（#3092）。等待母语者审核。 |
|
||||
| 乌克兰语 | `docs/i18n/README.uk.md` | **shipped** | 同上（#4791）。等待母语者审核。 |
|
||||
| 印尼语 | `docs/i18n/README.id.md` | **shipped** | 同上（#4789）。等待母语者审核。 |
|
||||
| 法语 | `docs/i18n/README.fr.md` | **shipped** | 同上。等待母语者审核。 |
|
||||
| 德语 | `docs/i18n/README.de.md` | **shipped** | 同上。等待母语者审核。 |
|
||||
| 繁体中文 | `docs/i18n/README.zh-TW.md` | **shipped** | 同上。等待母语者审核。 |
|
||||
| 印地语 | `docs/i18n/README.hi.md` | **shipped** | 同上。等待母语者审核。 |
|
||||
| 土耳其语 | `docs/i18n/README.tr.md` | **shipped** | 同上。等待母语者审核。 |
|
||||
| 意大利语 | `docs/i18n/README.it.md` | **shipped** | 同上。等待母语者审核。 |
|
||||
| 波兰语 | `docs/i18n/README.pl.md` | **shipped** | 同上。等待母语者审核。 |
|
||||
| 阿拉伯语 | `docs/i18n/README.ar.md` | **shipped** | 同上。等待母语者审核。只用 Markdown；不加 HTML `dir` 属性。 |
|
||||
| 加泰罗尼亚语 | `docs/i18n/README.ca.md` | **shipped** | 同上。等待母语者审核。 |
|
||||
|
||||
## 漂移检查
|
||||
|
||||
@@ -196,7 +196,7 @@ partial 区域设置在网站上还差的范围（下一波）：首页之外的
|
||||
|
||||
### 2. README
|
||||
|
||||
1. 把 `README.md` 翻成 `README.<tag>.md`，保留结构、命令，以及 #3087 确立的史实。
|
||||
1. 把 `README.md` 翻成 `docs/i18n/README.<tag>.md`，保留结构、命令，以及 #3087 确立的史实。
|
||||
2. 在 `README.md` 的语言行和其他已翻译的 README 里与它互链。
|
||||
3. 按 `scripts/check-readme-translations.py` 的规定重新盖同步戳，然后运行
|
||||
`python3 scripts/check-readme-translations.py` 和
|
||||
|
||||
@@ -23,15 +23,16 @@ echo "[check-readme-locales] Main: $MAIN"
|
||||
|
||||
# ---- Extract locale links from main README -------------------------
|
||||
|
||||
# Match patterns like: [简体中文 README](README.zh-CN.md)
|
||||
# Translations live in docs/i18n/. Match the whole link target so a link that
|
||||
# points outside that directory is caught rather than read as a bare filename.
|
||||
LOCALES_DIR="docs/i18n"
|
||||
linked_locales=()
|
||||
while IFS= read -r link; do
|
||||
# Extract the filename from the markdown link
|
||||
file=$(echo "$link" | sed -n 's/.*\](\(README\.[^)]*\.md\)).*/\1/p')
|
||||
file=$(echo "$link" | sed -n 's/.*\](\([^)]*README\.[^)]*\.md\)).*/\1/p')
|
||||
if [[ -n "$file" && "$file" != "README.md" ]]; then
|
||||
linked_locales+=("$file")
|
||||
fi
|
||||
done < <(grep -oE '\[[^]]*\]\(README\.[^)]+\.md\)' "$MAIN" 2>/dev/null || true)
|
||||
done < <(grep -oE '\[[^]]*\]\([^)]*README\.[^)]+\.md\)' "$MAIN" 2>/dev/null || true)
|
||||
|
||||
echo "[check-readme-locales] Linked from main README: ${linked_locales[*]:-(none)}"
|
||||
|
||||
@@ -56,7 +57,7 @@ echo "[check-readme-locales] OK — all linked locale READMEs exist"
|
||||
existing_locales=()
|
||||
while IFS= read -r f; do
|
||||
existing_locales+=("$(basename "$f")")
|
||||
done < <(find "$ROOT" -maxdepth 1 -name 'README.*.md' -not -name 'README.md' 2>/dev/null | sort)
|
||||
done < <(find "$ROOT/$LOCALES_DIR" -maxdepth 1 -name 'README.*.md' 2>/dev/null | sort)
|
||||
|
||||
echo "[check-readme-locales] Existing locale READMEs: ${existing_locales[*]:-(none)}"
|
||||
|
||||
@@ -64,7 +65,7 @@ orphans=()
|
||||
for file in "${existing_locales[@]}"; do
|
||||
found=0
|
||||
for linked in "${linked_locales[@]}"; do
|
||||
if [[ "$linked" == "$file" ]]; then
|
||||
if [[ "$(basename "$linked")" == "$file" ]]; then
|
||||
found=1
|
||||
break
|
||||
fi
|
||||
|
||||
@@ -23,28 +23,28 @@ from pathlib import Path
|
||||
ROOT = Path(__file__).resolve().parent.parent
|
||||
SOURCE = ROOT / "README.md"
|
||||
TRANSLATIONS = [
|
||||
"README.zh-CN.md",
|
||||
"README.ja-JP.md",
|
||||
"README.vi.md",
|
||||
"README.id.md",
|
||||
"README.ko-KR.md",
|
||||
"README.es-419.md",
|
||||
"README.pt-BR.md",
|
||||
"README.ru.md",
|
||||
"README.uk.md",
|
||||
"README.fr.md",
|
||||
"README.de.md",
|
||||
"README.zh-TW.md",
|
||||
"README.hi.md",
|
||||
"README.tr.md",
|
||||
"README.it.md",
|
||||
"README.pl.md",
|
||||
"README.ar.md",
|
||||
"README.ca.md",
|
||||
"docs/i18n/README.zh-CN.md",
|
||||
"docs/i18n/README.ja-JP.md",
|
||||
"docs/i18n/README.vi.md",
|
||||
"docs/i18n/README.id.md",
|
||||
"docs/i18n/README.ko-KR.md",
|
||||
"docs/i18n/README.es-419.md",
|
||||
"docs/i18n/README.pt-BR.md",
|
||||
"docs/i18n/README.ru.md",
|
||||
"docs/i18n/README.uk.md",
|
||||
"docs/i18n/README.fr.md",
|
||||
"docs/i18n/README.de.md",
|
||||
"docs/i18n/README.zh-TW.md",
|
||||
"docs/i18n/README.hi.md",
|
||||
"docs/i18n/README.tr.md",
|
||||
"docs/i18n/README.it.md",
|
||||
"docs/i18n/README.pl.md",
|
||||
"docs/i18n/README.ar.md",
|
||||
"docs/i18n/README.ca.md",
|
||||
]
|
||||
STAMP_RE = re.compile(r"<!--\s*source:\s*README\.md\s+sha256:([0-9a-f]{12})\s*-->")
|
||||
FENCE_RE = re.compile(r"```[a-z]*\n(.*?)```", re.DOTALL)
|
||||
URL_RE = re.compile(r"\((https?://[^)\s]+|docs/[^)\s]+|[A-Za-z0-9_./-]+\.md[^)\s]*)\)")
|
||||
URL_RE = re.compile(r"\((?:\.\./)*(https?://[^)\s]+|docs/[^)\s]+|[A-Za-z0-9_./-]+\.md[^)\s]*)\)")
|
||||
# The language-switcher line legitimately differs per translation (each file
|
||||
# links the *other* languages), so its links are exempt from the URL check.
|
||||
LANGUAGE_LINKS = {
|
||||
@@ -79,7 +79,18 @@ def fences(text: str) -> list[str]:
|
||||
|
||||
|
||||
def urls(text: str) -> set[str]:
|
||||
return {u for u in URL_RE.findall(text) if u not in LANGUAGE_LINKS}
|
||||
"""Links that must agree with README.md, independent of where a translation sits.
|
||||
|
||||
A translated README lives one directory deeper, so its relative links carry
|
||||
a `../` the English source does not; and the language switcher legitimately
|
||||
differs per file. Everything else is compared verbatim.
|
||||
"""
|
||||
out = set()
|
||||
for url in URL_RE.findall(text):
|
||||
if url in LANGUAGE_LINKS or url.rsplit("/", 1)[-1] in LANGUAGE_LINKS:
|
||||
continue
|
||||
out.add(url.removeprefix("../"))
|
||||
return out
|
||||
|
||||
|
||||
def sections(text: str) -> int:
|
||||
|
||||
Reference in new issue
Block a user