DeepSeek-TUI/README.pl.md

Codewhale

Otwartoźródłowy agent programistyczny do Twojego terminala — model przynosisz sam.

Codewhale zaczął jako natywne doświadczenie dla DeepSeek. Od tego czasu urósł do projektu prowadzonego przez społeczność: jednego harnessu programistycznego, który pasuje do rosnącej międzynarodowej społeczności i obsługuje tyle modeli i dostawców, ile się da — najpierw modele otwarte, hostowane albo lokalne, żaden nie jest uprzywilejowany wobec reszty.

Daj mu dostawcę, model i zadanie. Czyta Twój kod, edytuje pliki, uruchamia polecenia i sprawdza własną pracę, a potem się zatrzymuje, gdy zadanie jest skończone albo potrzebuje Ciebie. W trakcie zadania zmień model przez /model. Pracuj interaktywnie w TUI albo uruchamiaj codewhale exec w skryptach i CI. Napisany w Rust, na licencji MIT, działa na Twojej maszynie.

To, czym nie przypomina innych harnessów: to Ty wybierasz model dla każdej roli i nie muszą się zgadzać. Fleet przypina dostawcę, model i poziom rozumowania do roli — więc tani, szybki model może kierować drogim modelem rozumującym, a builder GLM może robić to samo zadanie co reviewer Kimi. Napisz własne role i własną constitution, a harness będzie Twój, nie nasz.

Zawsze szukamy osób, które chcą się przyczynić, i sposobów na ulepszenia. Jeśli brakuje modelu albo dostawcy, z którego korzystasz, albo coś się psuje, powiedzenie nam o tym jest jedną z najpożyteczniejszych rzeczy, które możesz zrobić — zobacz Współtworzenie.

English · 简体中文 · 日本語 · Tiếng Việt · Bahasa Indonesia · 한국어 · Español · Português · Русский · Українська · Français · Deutsch · 繁體中文 · हिन्दी · Türkçe · Italiano · العربية · Català · codewhale.net · Docs · Changelog · Discord

Instalacja

npm install -g codewhale

Cargo, Docker, Nix, Scoop, gotowe archiwa, Android/Termux oraz lustro CNB dla tych, którzy nie dochodzą do GitHuba, są w docs/INSTALL.md. Przychodzisz z deepseek-tui? Konfiguracja i sesje przechodzą — zobacz docs/REBRAND.md.

Użycie

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

W TUI: /model przełącza dostawcę i model razem, /fleet buduje i uruchamia zespół — jedna rola na raz, każda z własnym modelem —, /undo cofa ostatnią turę, a /restore <N> cofa przestrzeń roboczą do wcześniejszego zrzutu (gołe /restore je wypisuje). Tab przełącza Plan / Work / Operate, gdy kompozytor jest pusty — z tekstem Tab uzupełnia polecenia slash i wzmianki @. Shift+Tab w każdej chwili przełącza postawę uprawnień Ask / Auto-Review / Full Access. ! uruchamia polecenie powłoki zwykłą ścieżką zatwierdzeń.

Co robi

• Dowolny model, dowolny dostawca — i dowolna mieszanka. DeepSeek, Claude, GPT, Kimi, GLM i ponad 30 dostawców, plus własne vLLM, SGLang albo Ollama bez klucza, wszystko przez jedno środowisko uruchomieniowe i jeden zestaw narzędzi. Katalog śledzi żywą ofertę każdego dostawcy — backend V4 Pro DeepSeek (etykieta DeepSeek-V4-Pro-0813) nadal wywołuje się jako deepseek-v4-pro, Grok 4.6 jest bezpośrednim domyślnym modelem xAI, a OrcaRouter kieruje przez orcarouter/auto. Zapisana rola jawnie notuje provider, model i poziom rozumowania, więc fleet może w jednym uruchomieniu objąć wielu dostawców, a trasa roli nigdy nie zależy od tego, który dostawca akurat jest aktywny. Limity kontekstu i ceny pochodzą z prawdziwej trasy; nieznana cena pokazuje się jako nieznana, nie jako 0 $.
• Harness, który sam piszesz. Role to pliki, które możesz czytać i edytować — model, postawa narzędzi i stałe instrukcje na rolę — trzymane w projekcie, żeby zespół je dzielił, albo obok innych ustawień osobistych, żeby szły za Tobą między repozytoriami. Constitution zapisuje, jak agent ma się zachowywać w każdej sesji, żeby harness pasował do Twojej praktyki, nie do naszej.
• Tylko odczyt, dopóki nie pozwolisz na więcej. Tryb Plan nie może zmieniać plików, a zatwierdzenia pilnują ryzykownych poleceń. Gdy sandbox systemu operacyjnego naprawdę otacza polecenie, Codewhale o tym mówi: Seatbelt na macOS, gdy jest dostępny, opcjonalny bubblewrap na Linuksie. constitution.json repozytorium kompiluje się do blokad zapisu, których nawet Full Access nie przeskoczy.
• Praca, którą możesz wznowić. Fleet zapisuje każdy krok w rejestrze tylko do dopisywania, więc fleet resume podejmuje tam, gdzie skończyłeś.

Integracje

• DeepSeek Harness (dsh) — podłączony przez Codewhale. codewhale integrations dsh connect wiąże istniejącą instalację @deepseek-ai/dsh z Twoją trasą dostawcy Codewhale, uprawnieniami i przestrzenią roboczą, a integrations dsh install-bundle dodaje opcjonalny pakiet wtyczek DSH, żeby dsh --profile codewhale nosił tę tożsamość sam. Codewhale ma uprawnienia i władzę nad cyklem życia; dsh zostawia własne sesje, profile i poświadczenia nietknięte. Zobacz docs/INTEGRATIONS_DSH.md.
• VS Code. Oficjalny szkielet rozszerzenia (extensions/vscode) otwiera Codewhale w zintegrowanym terminalu i udostępnia Agent View tylko do odczytu nad lokalnym środowiskiem. To lokalny podgląd deweloperski, jeszcze nie wydanie na marketplace.

Dowiedz się więcej

• docs/PROVIDERS.md — każda trasa dostawcy: hostowana, bramka i lokalna
• docs/FLEET.md — fleety, rejestr i wznawianie
• docs/WORKFLOW_EXPERIMENTAL_SEARCH.md — zamrożone, niezależne od dostawcy eksperymentalne wyszukiwanie w Workflow
• docs/CONFIGURATION.md — config.toml, hooki i constitution
• docs/AUTHORIZATION_ORDER.md — jak składają się tryby, hooki, reguły uprawnień, podłogi bezpieczeństwa, prawo repo, zatwierdzenia i sandbox
• docs/HOOKS.md — jedenaście zdarzeń hook cyklu życia TUI, ich ładunki i które trzy mogą pokierować turą (codewhale exec i podpolecenia CLI nie odpalają hooków)
• docs/WEB.md — przeglądarkowy klient tylko na loopback i jego jednorazowa granica uwierzytelniania

Wszystko inne — tryby, skróty, szczegóły sandboxa, MCP, API środowiska uruchomieniowego i architektura — żyje w docs i na codewhale.net.

Współtworzenie

Zgłoszenia, PR-y, kroki odtworzenia, logi i prośby o funkcje to prawdziwa praca projektowa, a pierwsze wkłady są mile widziane. Gdy PR nie da się włączyć w obecnym kształcie, opiekunowie zbierają to, co działa, a autor zostaje wymieniony — w commicie, w changelogu i w docs/CONTRIBUTORS.md.

• Otwarte zgłoszenia — dobre pierwsze wkłady są tutaj
• CONTRIBUTING.md — środowisko deweloperskie i przepływ PR
• docs/CONTRIBUTORS.md — wszyscy, którzy to ukształtowali
• Postaw mi kawę

Dziękujemy DeepSeek za modele i wsparcie, które rozpoczęły projekt, DataWhale 🐋 za przyjęcie nas do rodziny Whale Brother oraz OpenWarp i Open Design za współpracę przy doświadczeniu agenta w terminalu.

Licencja

MIT. Niezależny projekt społecznościowy, niezwiązany z żadnym dostawcą modeli.