README.uk.md - CodeWhale

README.uk.md

1	<!-- source: README.md sha256:a87c9f323f35 -->
2	# Codewhale
3
4	Агент для програмування з відкритим кодом у вашому терміналі — модель приносите ви.
5
6	Codewhale починався як нативний інструмент для DeepSeek. Відтоді він виріс у
7	проєкт, яким керує спільнота: єдине середовище для програмування, яке підходить
8	міжнародній спільноті, що зростає, і підтримує якнайбільше моделей та
9	провайдерів — відкриті моделі насамперед, хмарні чи локальні, жодна не має
10	переваги перед іншими.
11
12	Дайте йому провайдера, модель і завдання. Він читає ваш код, редагує файли,
13	виконує команди й перевіряє власну роботу, а потім зупиняється, коли робота
14	завершена або коли йому потрібні ви. Перемикайте моделі в розпалі завдання
15	командою `/model`. Працюйте інтерактивно в TUI або запускайте `codewhale exec`
16	у скриптах і CI. Він написаний на Rust, поширюється за ліцензією MIT і працює
17	на вашому комп'ютері.
18
19	Ми завжди шукаємо учасників і способи стати кращими. Якщо моделі чи
20	провайдера, якими ви користуєтесь, бракує, або щось ламається, повідомити про
21	це — одна з найкорисніших речей, які ви можете зробити — див.
22	[Участь у проєкті](#участь-у-проєкті).
23
24	[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) · [codewhale.net](https://codewhale.net/) · [Документація](docs) · [Журнал змін](CHANGELOG.md) · [Discord](https://discord.gg/37gfS3ksug)
25
26	[![CI](https://github.com/Hmbown/CodeWhale/actions/workflows/ci.yml/badge.svg)](https://github.com/Hmbown/CodeWhale/actions/workflows/ci.yml)
27	[![crates.io](https://img.shields.io/crates/v/codewhale-cli?label=crates.io)](https://crates.io/crates/codewhale-cli)
28	[![npm](https://img.shields.io/npm/v/codewhale?label=npm)](https://www.npmjs.com/package/codewhale)
29	[![Discord](https://img.shields.io/badge/Discord-join%20the%20community-5865F2?logo=discord&logoColor=white)](https://discord.gg/37gfS3ksug)
30
31	![Codewhale працює в терміналі](assets/screenshot.png)
32
33	## Встановлення
34
35	```bash
36	npm install -g codewhale
37	```
38
39	Cargo, Docker, Nix, Scoop, готові архіви, Android/Termux, а також дзеркало CNB
40	для тих, хто не може отримати доступ до GitHub, описані в
41	[docs/INSTALL.md](docs/INSTALL.md). Переходите з `deepseek-tui`? Ваші
42	налаштування й сесії переносяться — див. [docs/REBRAND.md](docs/REBRAND.md).
43
44	## Використання
45
46	```bash
47	codewhale auth set --provider deepseek # or export ANTHROPIC_API_KEY, etc.
48	codewhale # open the TUI
49	codewhale exec "fix the failing test" # headless
50	codewhale web # local browser client on 127.0.0.1
51	```
52
53
54	У TUI: `/model` перемикає провайдера й модель разом, `/fleet` запускає команду
55	працівників, `/undo` скасовує останній крок, а `/restore <N>` відкочує робочу
56	копію до давнішого знімка (`/restore` без аргументу лише виводить їхній
57	список). Коли поле введення порожнє, `Tab` циклічно перемикає Plan / Act /
58	Operate; якщо в полі є текст, `Tab` доповнює слеш-команди та згадки `@`.
59	`Shift+Tab` перемикає режими дозволів Ask / Auto-Review / Full Access будь-коли.
60	`!` виконує команду оболонки через звичайний шлях затвердження.
61
62	## Що він уміє
63
64	- Будь-яка модель, будь-який провайдер. DeepSeek, Claude, GPT, Kimi, GLM та
65	понад 30 провайдерів, а також власні vLLM, SGLang чи Ollama без жодного
66	ключа — усе через одне середовище виконання й один набір інструментів. Ліміти
67	контексту й ціни беруться з реального маршруту, а невідома ціна показується
68	як невідома, а не як $0.
69	- Лише читання, доки ви не дозволите більше. Режим Plan не може змінювати
70	файли, а ризиковані команди проходять через затвердження. Коли пісочниця ОС
71	справді обгортає команду, Codewhale каже про це: Seatbelt на macOS, де він
72	доступний, і bubblewrap за бажанням на Linux. `constitution.json` репозиторію
73	компілюється у блокування запису, які не може обійти навіть Full Access.
74	- Робота, яку можна відновити. Флот записує кожен крок до журналу, що лише
75	доповнюється, тож `fleet resume` підхоплює роботу з місця, де ви зупинились.
76
77	## Дізнатися більше
78
79	- [docs/PROVIDERS.md](docs/PROVIDERS.md) — кожен маршрут провайдера: хмарний,
80	шлюзовий і локальний
81	- [docs/FLEET.md](docs/FLEET.md) — флоти, журнал і відновлення
82	- [docs/WORKFLOW_EXPERIMENTAL_SEARCH.md](docs/WORKFLOW_EXPERIMENTAL_SEARCH.md) — заморожений, нейтральний до провайдерів експериментальний пошук у Workflow
83	- [docs/CONFIGURATION.md](docs/CONFIGURATION.md) — `config.toml`, хуки й
84	конституція
85	- [docs/AUTHORIZATION_ORDER.md](docs/AUTHORIZATION_ORDER.md) — як поєднуються
86	режими, хуки, правила дозволів, мінімальні вимоги безпеки, правила репозиторію,
87	затвердження та пісочниця
88	- [docs/HOOKS.md](docs/HOOKS.md) — одинадцять подій хуків життєвого циклу TUI,
89	їхні корисні навантаження та три з них, що можуть скеровувати хід (`codewhale
90	exec` і підкоманди CLI хуків не запускають)
91	- [docs/WEB.md](docs/WEB.md) — браузерний клієнт, доступний лише через
92	loopback, і його межа одноразової автентифікації
93
94	Усе решта — режими, комбінації клавіш, деталі пісочниці, MCP, API середовища
95	виконання й архітектура — знаходиться в [docs](docs) і на
96	[codewhale.net](https://codewhale.net/).
97
98	## Участь у проєкті
99
100	Звіти про проблеми, PR, кроки відтворення, журнали й побажання щодо функцій —
101	усе це справжня робота над проєктом, і перші внески вітаються. Коли PR не можна
102	злити як є, супровідники забирають те, що працює, і зберігають авторство — у
103	коміті, в журналі змін і в [docs/CONTRIBUTORS.md](docs/CONTRIBUTORS.md).
104
105	- [Відкриті issues](https://github.com/Hmbown/CodeWhale/issues) — тут живуть
106	хороші перші внески
107	- [CONTRIBUTING.md](CONTRIBUTING.md) — налаштування середовища розробки й
108	процес PR
109	- [docs/CONTRIBUTORS.md](docs/CONTRIBUTORS.md) — усі, хто сформував цей проєкт
110	- [Buy me a coffee](https://www.buymeacoffee.com/hmbown)
111
112	Дякуємо [DeepSeek](https://github.com/deepseek-ai) за моделі й підтримку, з
113	яких почався проєкт, [DataWhale](https://github.com/datawhalechina) 🐋 за те,
114	що прийняли нас у родину Китових Братів, а також
115	[OpenWarp](https://github.com/zerx-lab/warp) і
116	[Open Design](https://github.com/nexu-io/open-design) за співпрацю над досвідом
117	термінального агента.
118
119	## Ліцензія
120
121	[MIT](LICENSE). Незалежний проєкт спільноти, не пов'язаний із жодним
122	провайдером моделей.
123
124	[![Star History Chart](https://api.star-history.com/chart?repos=Hmbown/CodeWhale&type=date&legend=top-left)](https://www.star-history.com/?repos=Hmbown%2FCodeWhale&type=date)
125

125 lines MARKDOWN