fix(docs): locale translations for nav elements and headings

This commit is contained in:
Adam
2026-02-11 18:51:27 -06:00
parent 8eea53a41e
commit aea68c386a
484 changed files with 12718 additions and 11212 deletions

View File

@@ -1,31 +1,33 @@
---
title: Wsparcie AKP
description: przetwarzanie opencode w procesorze komunikatu z ACP.
title: ACP
description: Używanie OpenCode z protokołem Agent Client Protocol (ACP).
---
opencode obsługi [Protokół klienta agenta](https://agentclientprotocol.com) lub (ACP), dzięki któremu można przejść do oprogramowania bezpośrednio w zainstalowanych edytorach i środowisku IDE.
import { Tabs, TabItem } from "@astrojs/starlight/components"
OpenCode obsługuje [Agent Client Protocol](https://agentclientprotocol.com) (ACP), który umożliwia korzystanie z OpenCode bezpośrednio w edytorach i środowiskach IDE.
:::tip
Lista edytorów i narzędzi obsługujących ACP w [raportu sprzętu ACP](https://zed.dev/blog/acp-progress-report#available-now).
Listę edytorów i narzędzi obsługujących ACP znajdziesz w [raporcie postępu ACP](https://zed.dev/blog/acp-progress-report#available-now).
:::
ACP do otwierania dokumentów, które standaryzują treść między edytorami kodu a agentem kodującym AI.
ACP to otwarty standard, który ujednolica komunikację między edytorami kodu a agentami kodującymi AI.
---
## Skonfiguruj
## Konfiguracja
Aby wybropencode przez ACP, skonfiguruj edytor tak, aby wybrać opcję `opencode acp`.
Aby używOpenCode przez ACP, skonfiguruj swój edytor tak, aby uruchamiał polecenie `opencode acp`.
Uruchomienie opencode jako podproces oprogramowania z ACP, który komunikuje się z edytorem poprzez JSON-RPC poprzez stdio.
Uruchamia to OpenCode jako podproces zgodny z ACP, który komunikuje się z edytorem za pomocą JSON-RPC przez stdio.
Poniżej znajdują się przykłady procesorów obsługujących ACP.
Poniżej znajdują się przykłady dla edytorów obsługujących ACP.
---
### Zeda
### Zed
Dodaj do konstrukcji [Zed](https://zed.dev) (`~/.config/zed/settings.json`):
Dodaj do konfiguracji [Zed](https://zed.dev) (`~/.config/zed/settings.json`):
```json title="~/.config/zed/settings.json"
{
@@ -38,9 +40,9 @@ Dodaj do konstrukcji [Zed](https://zed.dev) (`~/.config/zed/settings.json`):
}
```
Aby przejść do akcji, `agent: new thread` w **Palecie redakcji**.
Aby użyć, wybierz `agent: new thread` w **Palecie poleceń** (Command Palette).
Można także po skrócie skrótowym, edytując `keymap.json`:
Możesz także przypisać skrót klawiszowy, edytując `keymap.json`:
```json title="keymap.json"
[
@@ -67,9 +69,9 @@ Można także po skrócie skrótowym, edytując `keymap.json`:
---
### IDE JetBrains
### JetBrains IDE
Dodaj do swojego [JetBrains IDE](https://www.jetbrains.com/) acp.json zgodnie z [dokumentacją](https://www.jetbrains.com/help/ai-assistant/acp.html):
Dodaj do swojego [JetBrains IDE](https://www.jetbrains.com/) plik `acp.json` zgodnie z [dokumentacją](https://www.jetbrains.com/help/ai-assistant/acp.html):
```json title="acp.json"
{
@@ -82,13 +84,13 @@ Dodaj do swojego [JetBrains IDE](https://www.jetbrains.com/) acp.json zgodnie z
}
```
Aby przejść do nowego agentaopencode” w selektorze agenta AI Chat.
Następnie wybierzOpenCode” w selektorze agentów AI Chat.
---
### Avante.nvim
Dodaj do konstrukcji [Avante.nvim](https://github.com/yetone/avante.nvim):
Dodaj do konfiguracji [Avante.nvim](https://github.com/yetone/avante.nvim):
```lua
{
@@ -101,7 +103,7 @@ Dodaj do konstrukcji [Avante.nvim](https://github.com/yetone/avante.nvim):
}
```
Jeśli chcesz zachować bezpieczeństwo:
Jeśli potrzebujesz przekazać klucz API:
```lua {6-8}
{
@@ -121,7 +123,7 @@ Jeśli chcesz zachować bezpieczeństwo:
### CodeCompanion.nvim
Aby opencode jako agenta ACP w [CodeCompanion.nvim](https://github.com/olimorris/codecompanion.nvim), dodaj dodatkowe elementy, aby otrzymać konstrukcje Neovim:
Aby używać OpenCode jako agenta ACP w [CodeCompanion.nvim](https://github.com/olimorris/codecompanion.nvim), dodaj następującą konfigurację do Neovim:
```lua
require("codecompanion").setup({
@@ -136,21 +138,21 @@ require("codecompanion").setup({
})
```
Ta konfiguracja CodeCompanion wymaga opencode jako agenta ACP dla czatu.
Ta konfiguracja sprawia, że CodeCompanion używa OpenCode jako agenta ACP do czatu.
Jeśli jesteś zarejestrowany jako `OPENCODE_API_KEY`, zapoznaj się z sekcją [Konfigurowanie adapterów: Zmienne przebieg](https://codecompanion.olimorris.dev/getting-started#setting-an-api-key) w dokumentacji CodeCompanion.nvim, aby uzyskać szczegółowe informacje.
Jeśli wymagany jest `OPENCODE_API_KEY`, zapoznaj się z sekcją [Konfigurowanie adapterów: Zmienne środowiskowe](https://codecompanion.olimorris.dev/getting-started#setting-an-api-key) w dokumentacji CodeCompanion.nvim, aby uzyskać szczegółowe informacje.
## Wsparcie
opencode działa tak samo przez ACP, jak w terminalu. Obsługiwane są wszystkie funkcje:
OpenCode działa przez ACP tak samo, jak w terminalu. Obsługiwane są wszystkie główne funkcje:
:::note
początek źródła ukośnikowego, takie jak `/undo` i `/redo`, nie są aktualne pobierane.
Niektóre polecenia z ukośnikiem, takie jak `/undo` i `/redo`, nie są obecnie obsługiwane przez ACP.
:::
- Wbudowane narzędzie (operacje na plikach, rozwiązanie terminala itp.)
- Niestandardowe narzędzie i polecenie ukośnikowe
- Serwery MCP skonfigurowane w konfiguracji opencode
- Zasady dotyczące projektu od `AGENTS.md`
- Niestandardowe formatory i lintery
- Agentów systemowych i uprawnień
- Narzędzia wbudowane (operacje na plikach, terminal itp.)
- Niestandardowe narzędzia i polecenia z ukośnikiem
- Serwery MCP zdefiniowane w konfiguracji OpenCode
- Zasady projektu z `AGENTS.md`
- Niestandardowe formatery i lintery
- Agenci systemowi i uprawnienia

View File

@@ -1,142 +1,141 @@
---
title: Agenci
description: Konfiguruj i używaj funkcjonalnych agentów.
description: Konfiguruj i używaj potężnych agentów.
---
Agenci to asystenci AI, które można podłączyć do gniazd zasilania i przepływów pracy. Umożliwiają tworzenie ukierunkowanych narzędzi z niestandardowymi monitami, modelami i udostępnianiem narzędzi.
Agenci to asystenci AI, których można przypisać do ról i workflow. Umożliwiają tworzenie ukierunkowanych narzędzi z niestandardowymi promptami, modelami i dostępem do narzędzi.
:::tip
Skorzystaj z agenta Plan, aby uzyskać dostęp do kodu i przeglądać informacje bez dodatkowych zmian w kodzie.
Użyj agenta Plan, aby uzyskać dostęp do kodu i przeglądać informacje bez wprowadzania zmian w kodzie.
:::
Możesz przełączać się między agentami podczas sesji lub wywoływać ich za pomocą wzmianki `@`.
---
## Typowe
## Typy
W opencode zasada dwóch charakterystycznych agentów; Najpierw Primary i Subagents.
W OpenCode obowiązuje zasada dwóch typów agentów: Primary (Główni) i Subagents (Subagenci).
---
### Primary Agents
### Primary Agents (Agenci główni)
Główne zasady asystenci, z podstawowym kontaktem. Możesz je mieć za pomocą klawisza **Tab** lub podwójnego skrótu klawiszowego `switch_agent`. Ci agenci obsługujący urządzenie główne. Dostęp do narzędzia jest konfigurowany za pomocą uprawnień — na przykład w programie Build wszystkie narzędzia są dostępne, a Plan jest ograniczony.
Główni asystenci, z którymi prowadzisz interakcję. Możesz przełączać się między nimi za pomocą klawisza **Tab** lub skrótu klawiszowego `switch_agent`. Ci agenci obsługują główną pętlę. Dostęp do narzędzi jest konfigurowany za pomocą uprawnień — na przykład w agencie Build wszystkie narzędzia są dostępne, a w agencie Plan ograniczone.
:::tip
Twój klawisz klawisza **Tab**, aby wyłączyć się między agentami podczas sesji.
Użyj klawisza **Tab**, aby przełączać się między agentami podczas sesji.
:::
opencode zawiera dwa puste agenty główne: **Build** i **Plan**. Dobrze
spójrz na te poniżej.
OpenCode zawiera dwa wbudowane agenty główne: **Build** i **Plan**. Przyjrzymy się im poniżej.
---
### Subagents
### Subagents (Subagenci)
Subagenci to pomocniczy asystenci, których można przywoływać agenci główni w celu wykonania podstawowych zadań. Możesz także wytwarzać je, **@ wspominając** o nich w swoich wiadomościach.
Subagenci to asystenci pomocniczy, których mo przywoływać agenci główni w celu wykonania konkretnych zadań. Możesz także wywoływać ich ręcznie, **wzmiankując ich (@)** w swoich wiadomościach.
opencode ma dwóch subagentów: **General** i **Explore**. Przyjrzymy się temu poniżej.
OpenCode ma dwóch wbudowanych subagentów: **General** i **Explore**. Przyjrzymy się im poniżej.
---
## Wbudowany
## Wbudowane
opencode ma dwa główne agenty i dwa główne agenty podrzędne.
OpenCode ma dwa wbudowane agenty główne i dwa wbudowane subagenty.
---
### Build
_Tryb_: `primary`
_Mode_: `primary`
Kompilacja jest **domyślnym** agentem zastosowania z ukrytymi narzędziami. Jest to standardowy agent do prac programistycznych, którego dostęp jest udostępniony do operacji na plikach i podstawowych systemowych.
Build to **domyślny** agent ogólnego przeznaczenia z pełnym zestawem narzędzi. Jest to standardowy agent do prac programistycznych, który ma dostęp do operacji na plikach i poleceń systemowych.
---
### Plan
_Tryb_: `primary`
_Mode_: `primary`
Zastrzeżony agent do analizy. Używamy systemu, aby włączyć Ci większe ryzyko i zapobiec niezamierzonym zmianom.
Domyślnie są wybrane na `ask`:
Dedykowany agent do analizy. Używa zestawu narzędzi tylko do odczytu, aby zmniejszyć ryzyko i zapobiec niezamierzonym zmianom.
Domyślnie uprawnienia są ustawione na `ask` dla:
- `file edits`: Wszystkie zapisy, transkrypcja i edycje
- `bash`: Wszystkie polecam bash
- `file edits`: Wszystkie zapisy, patche i edycje
- `bash`: Wszystkie polecenia bash
Ten agent jest podłączony, gdy chcesz, aby LLM był kompatybilny z kodem, który wymaga zastosowania lub wersji plastikowej bez konieczności stosowania innej wersji bazy kodu.
Ten agent jest zalecany, gdy chcesz, aby LLM zapoznał się z kodem, stworzył plan lub odpowiedział na pytania bez ryzyka modyfikacji bazy kodu.
---
### General
_Tryb_: `subagent`
_Mode_: `subagent`
Rozwiązanie rozwiązania złożone z zadań wieloetapowych. Pełny dostęp do narzędzia (z funkcjonalnymi funkcjami do wykonania), dzięki czemu może w razie potrzeby zostać dostarczone w plikach. Przewoźnik dziesięć, aby określić wiele jednostek roboczych.
Rozwiązuje złożone zadania wieloetapowe. Pełny dostęp do narzędzi (z możliwością modyfikacji plików), dzięki czemu może w razie potrzeby wprowadzać zmiany w plikach. Używany przez agenta nadrzędnego do delegowania jednostek pracy.
---
### Explore
_Tryb_: `subagent`
_Mode_: `subagent`
Szybki agent tylko do odczytu do eksploracji baz kodu. Nie można modyfikować plików. Użycie tej opcji, jeśli chcesz szybko uzyskać dostęp do plików według wzorców, wyszukać w kodzie słowa kluczowe lub rozwiązania dotyczące zapytań dotyczących bazy kodu.
Szybki agent tylko do odczytu do eksploracji baz kodu. Nie może modyfikować plików. Używany, gdy chcesz szybko znaleźć pliki według wzorców, wyszukać w kodzie słowa kluczowe lub uzyskać odpowiedzi na pytania dotyczące bazy kodu.
---
### Compaction
_Tryb_: `primary`
_Mode_: `primary`
Ukryty agent systemowy, który jest kontekstem kontekstowym w dużym podsumowaniu. W razie działania nie można przejść do interfejsu użytkownika.
Ukryty agent systemowy, który kompresuje kontekst w zwięzłe podsumowanie. Działa automatycznie i nie jest widoczny w interfejsie użytkownika.
---
### Title
_Tryb_: `primary`
_Mode_: `primary`
Ukryty agent systemowy, krótki tytuł sesji. Działa automatycznie i nie można przejść do interfejsu użytkownika.
Ukryty agent systemowy, który generuje krótki tytuł sesji. Działa automatycznie i nie jest widoczny w interfejsie użytkownika.
---
### Summary
_Tryb_: `primary`
_Mode_: `primary`
Ukryty agent systemowy, który stanowi podsumowanie podsumowania sesji. Działa automatycznie i nie można przejść do interfejsu użytkownika.
Ukryty agent systemowy, który generuje podsumowanie sesji. Działa automatycznie i nie jest widoczny w interfejsie użytkownika.
---
## Stosowanie
## Użycie
1. W przypadku agentów głównych klawisza **Tab**, aby przełączać się między nimi podczas sesji. Można również podać z skrótu klawiszowego `switch_agent`.
1. W przypadku agentów głównych użyj klawisza **Tab**, aby przełączać się między nimi podczas sesji. Można to również zrobić za pomocą skrótu klawiszowego `switch_agent`.
2. Subagent można wytwarzać:
2. Subagentów można wywoływać:
- **Automatycznie** przez głównych agentów do specjalistycznych zadań na podstawie ich opisów.
- Ręcznie, **@ wspomnienie** o subagencji w Twoich wiadomościach. Na przykład.
- Ręcznie, **wzmiankując (@)** subagenta w swoich wiadomościach. Na przykład:
```txt frame="none"
@general help me search for this function
@explore help me search for this function
```
3. **Nawigacja pomiędzy sesjami**: Kiedy można mieć własne sesje podrzędne, można nawigować pomiędzy sesjami nadrzędnymi a określonymi podrzędnymi, dostępnymi z:
- **\<Lider>+Prawo** (lub skonfigurowane przez Ciebie klawisze `session_child_cycle`), aby przełączać się między jednostkami nadrzędnymi → podrzędnymi 1 → podrzędnymi 2 → ... → nadrzędnymi
- **\<Leader>+Left** (lub skrót klawiszowy `session_child_cycle_reverse`), aby przejść dalej między macierzym ← podnośnik1 ← podnośnik2 ← ... ← prowadzącym
3. **Nawigacja pomiędzy sesjami**: Kiedy sesja ma sesje podrzędne, możesz nawigować pomiędzy sesją nadrzędną a sesjami podrzędnymi za pomocą:
- **\<Leader>+Prawo** (lub skonfigurowanego klawisza `session_child_cycle`), aby przełączać się w dół: rodzic → dziecko 1 → dziecko 2 → ... → rodzic
- **\<Leader>+Lewo** (lub skonfigurowanego klawisza `session_child_cycle_reverse`), aby przełączać się w górę: rodzic ← dziecko 1 ← dziecko 2 ← ... ← rodzic
Dostępna możliwość płynnego przełączania pomiędzy rozmową główną a pracą specjalistyczną subagentę.
Umożliwia to płynne przełączanie się między główną rozmową a pracą specjalistyczną wykonywaną przez subagentów.
---
## Skonfiguruj
## Konfiguracja
Możliwość zastosowania agentów lub urządzeń poprzez zastosowanie. Agentów można zidentyfikować na dwóch systemach:
Możesz tworzyć własnych agentów lub dostosowywać istniejących. Agentów można definiować na dwa sposoby:
---
### JSON
Skonfiguruj agenta w pliku konfiguracyjnym `opencode.json`:
Skonfiguruj agenta w pliku `opencode.json`:
```json title="opencode.json"
{
@@ -177,12 +176,12 @@ Skonfiguruj agenta w pliku konfiguracyjnym `opencode.json`:
---
### Obniżka cen
### Markdown
Można także definiować agentów za pomocą plików przecen. Trzymaj je w:
Możesz także definiować agentów za pomocą plików markdown. Przechowuj je w:
- Globalnie: `~/.config/opencode/agents/`
- Na projekt: `.opencode/agents/`
- W projekcie: `.opencode/agents/`
```markdown title="~/.config/opencode/agents/review.md"
---
@@ -206,19 +205,19 @@ You are in code review mode. Focus on:
Provide constructive feedback without making direct changes.
```
Nazwa pliku przecen staje się nazwą agenta. Na przykład `review.md` tworzy agenta `review`.
Nazwa pliku markdown staje się nazwą agenta. Na przykład `review.md` tworzy agenta `review`.
---
## Opcje
Przyjrzyjmy się szczegółowo tym opcjom konfiguracji.
Przyjrzyjmy się szczegółowo opcjom konfiguracji.
---
### Opis
### Description (Opis)
miejsce `description`, aby krótko tego, co robi agent i kiedy go stosować.
Użyj `description`, aby krótko opisać, co robi agent i kiedy go używać.
```json title="opencode.json"
{
@@ -234,11 +233,11 @@ Jest to **wymagana** opcja konfiguracji.
---
### Temperatura
### Temperature (Temperatura)
Kontroluj losowość i kreatywność odpowiedzi LLM za pomocą konfiguracji `temperature`.
Niższe wartości, że odpowiedzi są bardziej skupione i deterministyczne, gdy wartość jest innowacyjna i złożona.
Niższe wartości sprawiają, że odpowiedzi są bardziej skupione i deterministyczne, podczas gdy wyższe wartości wprowadzają więcej różnorodności i kreatywności.
```json title="opencode.json"
{
@@ -253,11 +252,11 @@ Niższe wartości, że odpowiedzi są bardziej skupione i deterministyczne, gdy
}
```
Wartość temperatury zwykle waha się od 0,0 do 1,0:
Wartość temperatury zwykle waha się od 0.0 do 1.0:
- **0,0-0,2**: Bardzo skoncentrowane i deterministyczne odpowiedzi, idealne do analizy i kodu źródłowego
- **0,3-0,5**: Zrównoważona odpowiedź z chwilą powstania, dobre do ogólnych zadań rozwojowych
- **0,61,0**: Bardziej kreatywne i odpowiedzi, rozstrzygnięte podczas burzy mózgów i eksploracji
- **0.0-0.2**: Bardzo skoncentrowane i deterministyczne odpowiedzi, idealne do analizy kodu i debugowania
- **0.3-0.5**: Zrównoważone odpowiedzi, dobre do ogólnych zadań programistycznych
- **0.6-1.0**: Bardziej kreatywne i zróżnicowane odpowiedzi, przydatne podczas burzy mózgów i eksploracji
```json title="opencode.json"
{
@@ -277,15 +276,15 @@ Wartość temperatury zwykle waha się od 0,0 do 1,0:
}
```
Jeśli nie ma wpływu na kontrolę, opencode używa narzędzia do analizy danych dla modelu; 0 dla określonych modeli, 0,55 dla modeli Qwen.
Jeśli nie zostanie skonfigurowana, OpenCode używa wartości domyślnej dla danego modelu; 0 dla modeli rozumowania (reasoning models), 0.55 dla modeli Qwen.
---
### Maksymalna liczba kroków
### Steps (Kroki)
Kontroluj funkcjonowanie iteracji agenta, jaki agent może być, zanim będzie dostępny wyłącznie z tekstem. Dzięki temu użytkownicy kontrolujący koszty mogą mieć wpływ na działanie agentów.
Kontroluj maksymalną liczbę iteracji, jaką agent może wykonać, zanim poprosi o interwencję użytkownika. Pomaga to kontrolować koszty i zapobiegać pętlom.
Jeśli ta opcja nie zostanie skonfigurowana, agent będzie obowiązywał iterację, jeśli model nie zostanie wydany lub użytkownik nie będzie regularnie używany.
Jeśli ta opcja nie zostanie skonfigurowana, agent będzie kontynuował iterację, dopóki model nie zakończy zadania lub użytkownik nie przerwie działania.
```json title="opencode.json"
{
@@ -299,7 +298,7 @@ Jeśli ta opcja nie zostanie skonfigurowana, agent będzie obowiązywał iteracj
}
```
Po tym, jak agent limitu otrzymuje specjalny monit systemowy nakazujący podsumowanie swojej pracy i rekomendowanych do wykonywania zadań.
Po osiągnięciu limitu agent otrzymuje specjalny monit systemowy nakazujący podsumowanie swojej pracy i zarekomendowanie kolejnych kroków.
:::caution
Starsze pole `maxSteps` jest przestarzałe. Zamiast tego użyj `steps`.
@@ -307,7 +306,7 @@ Starsze pole `maxSteps` jest przestarzałe. Zamiast tego użyj `steps`.
---
### Wymienne
### Disabled (Wyłączony)
Ustaw na `true`, aby wyłączyć agenta.
@@ -323,9 +322,9 @@ Ustaw na `true`, aby wyłączyć agenta.
---
### Podpowiedź
### Prompt (Monit)
niestandardowy plik podpowiedzi systemowych dla tego agenta z konfiguracją `prompt`. Plik informacyjny powinien zawierać dla celu agenta.
Podaj niestandardowy prompt systemowy dla tego agenta za pomocą konfiguracji `prompt`. Prompt powinien zawierać instrukcje dotyczące celu i zachowania agenta.
```json title="opencode.json"
{
@@ -337,16 +336,16 @@ niestandardowy plik podpowiedzi systemowych dla tego agenta z konfiguracją `pro
}
```
Ścieżka ta zależy od miejsca, w którym znajduje się plik konfiguracyjny. Działa również w przypadku globalnej konstrukcji opencode, jak i funkcjonalnej dla projektu.
Ścieżka jest względna do miejsca, w którym znajduje się plik konfiguracyjny. Działa to zarówno w przypadku globalnej konfiguracji OpenCode, jak i konfiguracji specyficznej dla projektu.
---
### Model
konstrukcja nośna `model`, aby mieć model dla tego agenta. Przydatne przy różnych modelach konfiguracji w różnych zadaniach. Na przykład zastosowania modelu, skuteczne wykonanie modelu.
Użyj `model`, aby określić model dla tego agenta. Przydatne do używania różnych modeli do różnych zadań. Na przykład użycie modelu rozumowania do planowania, ale szybszego modelu do edycji.
:::tip
Jeśli nie ma wpływu na model, główne są [modelu skonfigurowanego globalnie](/docs/config#models), agenci podrzędni podmiotem modelu agenta, który wywołał subagentę.
Jeśli model nie zostanie określony, agenci główni używają [modelu skonfigurowanego globalnie](/docs/config#models), a agenci podrzędni używają modelu agenta, który ich wywołał.
:::
```json title="opencode.json"
@@ -359,13 +358,13 @@ Jeśli nie ma wpływu na model, główne są [modelu skonfigurowanego globalnie]
}
```
Identyfikator modelu w konfiguracji opencode w `provider/model-id`. Na koniec, [OpenCode Zen](/docs/zen), przestrzeganie `opencode/gpt-5.1-codex` dla kodeksu GPT 5.1.
Identyfikator modelu jest taki sam, jak w konfiguracji OpenCode w `provider/model-id`. Na przykład, [OpenCode Zen](/docs/zen), użyj `opencode/gpt-5.1-codex` dla GPT 5.1 Codex.
---
### Narzędzia
### Tools (Narzędzia)
Kontroluj, które narzędzia są dostępne w tej agencji, za pomocą konfiguracji `tools`. Można włączyć lub dostępne narzędzie, ustawiając je na `true` lub `false`.
Kontroluj, które narzędzia są dostępne dla tego agenta, za pomocą konfiguracji `tools`. Możesz włączyć lub wyłączyć określone narzędzia, ustawiając je na `true` lub `false`.
```json title="opencode.json" {3-6,9-12}
{
@@ -386,10 +385,10 @@ Kontroluj, które narzędzia są dostępne w tej agencji, za pomocą konfiguracj
```
:::note
Konfiguracja specjalna dla agenta globalnego.
Konfiguracja specyficzna dla agenta nadpisuje konfigurację globalną.
:::
Można także zastosować symboli wieloznacznych do kontrolowanych wielu narzędzi jednocześnie. Na przykład, aby wyłączyć wszystkie narzędzia z serwera MCP:
Możesz także używać symboli wieloznacznych (wildcards), aby kontrolować wiele narzędzi jednocześnie. Na przykład, aby wyłączyć wszystkie narzędzia z serwera MCP:
```json title="opencode.json"
{
@@ -410,13 +409,13 @@ Można także zastosować symboli wieloznacznych do kontrolowanych wielu narzęd
---
### Uprawnienia
### Permissions (Uprawnienia)
Może wystąpić możliwość działania, które może pozostać ostateczne przez agenta. Obecnie proste dla narzędzia `edit`, `bash` i `webfetch` można znaleźć w drodze:
Możesz skonfigurować uprawnienia dla potencjalnie wrażliwych działań wykonywanych przez agenta. Obecnie obsługiwane dla narzędzi `edit`, `bash` i `webfetch`:
- `"ask"` — Monituj o zatwierdzenie przed użyciem narzędzia
- `"allow"` — Zezwalaj na wszystkie operacje bez zatwierdzenia
- `"deny"` — Wyłączenie narzędzia
- `"ask"` — Pytaj o zatwierdzenie przed użyciem narzędzia
- `"allow"` — Zezwalaj na użycie bez zatwierdzenia
- `"deny"` — Zabroń użycia narzędzia
```json title="opencode.json"
{
@@ -427,7 +426,7 @@ Może wystąpić możliwość działania, które może pozostać ostateczne prze
}
```
Można mieć odpowiedni dla każdego agenta.
Możesz nadpisać to dla każdego agenta.
```json title="opencode.json" {3-5,8-10}
{
@@ -445,7 +444,7 @@ Można mieć odpowiedni dla każdego agenta.
}
```
Można także istnieć w agentach Markdown.
Można to również ustawić w agentach Markdown.
```markdown title="~/.config/opencode/agents/review.md"
---
@@ -464,7 +463,7 @@ permission:
Only analyze code and suggest changes.
```
Można podłączyć do gniazda bash.
Możesz to skonfigurować szczegółowo dla poleceń bash.
```json title="opencode.json" {7}
{
@@ -482,7 +481,7 @@ Można podłączyć do gniazda bash.
}
```
Może być przestrzegany globalnym.
Można to połączyć z globalnym symbolem wieloznacznym.
```json title="opencode.json" {7}
{
@@ -499,8 +498,8 @@ Może być przestrzegany globalnym.
}
```
Możesz także uzyskać symbolu wieloznacznego `*` do zarządzania uprawnieniami dla wszystkich użytkowników.
Ostatnie dostępne źródło pierwszeństwo, symbol wieloznaczny `*` na pierwszym miejscu, wyodrębnione na końcu.
Możesz także użyć symbolu wieloznacznego `*`, aby zarządzać wszystkimi innymi poleceniami.
Najbardziej szczegółowa reguła ma pierwszeństwo, symbol wieloznaczny `*` jest sprawdzany na końcu.
```json title="opencode.json" {8}
{
@@ -518,13 +517,13 @@ Ostatnie dostępne źródło pierwszeństwo, symbol wieloznaczny `*` na pierwszy
}
```
[Dowiedz się więcej o prawach](/docs/permissions).
[Dowiedz się więcej o uprawnieniach](/docs/permissions).
---
### Tryb
### Mode (Tryb)
Kontroluj tryb agenta za pomocą konfiguracji `mode`. Opcja `mode` umożliwiająca użycie środka.
Kontroluj tryb agenta za pomocą konfiguracji `mode`. Opcja `mode` określa, w jaki sposób agent może być używany.
```json title="opencode.json"
{
@@ -536,13 +535,13 @@ Kontroluj tryb agenta za pomocą konfiguracji `mode`. Opcja `mode` umożliwiają
}
```
Opcję `mode` można ustawić na `primary`, `subagent` lub `all`. Jeśli nie dotyczy `mode`, jest to `all`.
Opcję `mode` można ustawić na `primary`, `subagent` lub `all`. Jeśli nie podano `mode`, domyślnie jest to `all`.
---
### Ukryty
### Hidden (Ukryty)
Ukryj subagenta w menu autouzupełniania `@` za pomocą `hidden: true`. Przydatne w postępowaniu sądowym podagenci, potencjalnie być wywoływani programowo przez innych agentów, którzy korzystają z pomocy jako narzędzia.
Ukryj subagenta w menu autouzupełniania `@` za pomocą `hidden: true`. Przydatne w przypadku subagentów narzędziowych, którzy powinni być wywoływani tylko programowo przez innych agentów, a nie bezpośrednio przez użytkownika.
```json title="opencode.json"
{
@@ -555,17 +554,17 @@ Ukryj subagenta w menu autouzupełniania `@` za pomocą `hidden: true`. Przydatn
}
```
Wpływ tylko na użytkownika w menu autouzupełniania. Model może nadal wywoływać ukrytych agentów za pomocą narzędzi do zadań, funkcji użytkowych.
Wpływa to tylko na widoczność w menu autouzupełniania. Model nadal może wywoływać ukrytych agentów za pomocą narzędzia zadania, jeśli ma do nich dostęp.
:::note
Dotyczy tylko agentów `mode: subagent`.
Dotyczy tylko agentów z `mode: subagent`.
:::
---
### Uprawnienia do zadań
### Task Permissions (Uprawnienia zadań)
Kontroluj, których agenci podawców mo wywołać za pomocą narzędzia zadanie za pomocą `permission.task`. Używa wzorców globalnych do elastycznego dopasowywania.
Kontroluj, których subagentów może wywołać ten agent za pomocą narzędzia zadania, używając `permission.task`. Używa wzorców glob do elastycznego dopasowywania.
```json title="opencode.json"
{
@@ -584,23 +583,23 @@ Kontroluj, których agenci podawców mogą wywołać za pomocą narzędzia zadan
}
```
Po ustawieniu wartości `deny` podagent zostanie usunięty z opisu narzędzia Zadania, więc model nie będzie gotowy do uruchomienia.
Po ustawieniu wartości `deny` subagent zostanie usunięty z definicji narzędzia Zadania, więc model nie będzie nawet wiedział o jego istnieniu.
:::tip
Reguły są następujące w kolejności i **ostatnia reguła wygrywająca**. W zasadzie `orchestrator-planner` jest konfiguracją `*` (odmową), jak i `orchestrator-*` (zezwolenie), ale ponieważ `orchestrator-*` użytkownika po `*`, postać jest `allow`.
Reguły są oceniane w kolejności i **wygrywa ostatnia pasująca reguła**. W powyższym przykładzie `orchestrator-planner` pasuje zarówno do `*` (odmowa), jak i `orchestrator-*` (zezwolenie), ale ponieważ `orchestrator-*` występuje po `*`, wynikiem jest `allow`.
:::
:::tip
Zawsze można rozwiązać rozwiązanie, bezpośrednio poprzez menu autouzupełnieniania `@`, nawet jeśli wystąpią zadania agenta temu naprawiające.
Zawsze możesz wywołać subagenta ręcznie, wspominając go bezpośrednio (`@`), nawet jeśli obecny agent ma uprawnienia ustawione na `deny`.
:::
---
### Kolor
### Color (Kolor)
Dostosuj wygląd agenta w interfejsie użytkownika za pomocą opcji `color`. Wpływ na wygląd agenta w interfejsie.
Dostosuj wygląd agenta w interfejsie użytkownika za pomocą opcji `color`. Wpływa to na ikonę i obramowanie agenta w interfejsie.
Użyj koloru hex (np. `#FF5733`) lub koloru motywu: `primary`, `secondary`, `accent`, `success`, `warning`, `error`, `info`.
Użyj kodu hex (np. `#FF5733`) lub nazwy koloru motywu: `primary`, `secondary`, `accent`, `success`, `warning`, `error`, `info`.
```json title="opencode.json"
{
@@ -619,7 +618,7 @@ Użyj koloru hex (np. `#FF5733`) lub koloru motywu: `primary`, `secondary`, `acc
### Top P
Kontroluj różnorodność odpowiedzi za pomocą opcji `top_p`. Alternatywa dla temperatury w celu kontrolowanej braku wartości.
Kontroluj różnorodność odpowiedzi za pomocą opcji `top_p`. Alternatywa dla temperatury w celu kontrolowania losowości.
```json title="opencode.json"
{
@@ -631,15 +630,15 @@ Kontroluj różnorodność odpowiedzi za pomocą opcji `top_p`. Alternatywa dla
}
```
Wartość mieszkalna obejmuje zakres od 0,0 do 1,0. Niższe wartości są bardziej skoncentrowane, wyższe wartości są bardziej zaawansowane.
Wartość waha się od 0.0 do 1.0. Niższe wartości są bardziej skoncentrowane, wyższe wartości są bardziej zróżnicowane.
---
### nadal
### Passthrough (Przekazywanie)
Wszelkie inne konfiguracje w agentach **przekazane bezpośrednio** jako model sprzedawcy. Dostęp do funkcji i parametrów dostarczanych dla dostawcy.
Wszelkie inne konfiguracje w agentach **przekazywane bezpośrednio** do dostawcy modelu. Pozwala to na korzystanie z funkcji i parametrów specyficznych dla dostawcy.
Na przykład dzięki modelowi rozumowania OpenAI może kontrolować rozumowanie:
Na przykład, używając modelu rozumowania OpenAI, możesz kontrolować wysiłek rozumowania:
```json title="opencode.json" {6,7}
{
@@ -654,55 +653,55 @@ Na przykład dzięki modelowi rozumowania OpenAI może kontrolować rozumowanie:
}
```
Te dodatkowe cechy można zidentyfikować od modelu i dostawcy. Sprawdź swoje dostawcę pod kątem parametrów.
Te dodatkowe właściwości zależą od modelu i dostawcy. Sprawdź dokumentację swojego dostawcy pod kątem dostępnych parametrów.
:::tip
Uruchomione `opencode models`, aby wyłączyć modele.
Uruchom `opencode models`, aby zobaczyć dostępne modele.
:::
---
## Utwórz agentów
## Tworzenie agentów
Możesz stworzyć nowych agentów za pomocą innego polecenia:
Możesz stworzyć nowych agentów interaktywnie za pomocą polecenia:
```bash
opencode agent create
```
Wykonaj decyzję:
Poprowadzi Cię to przez proces:
1. Zapytaj, gdzie zapis agenta; globalne lub szczegółowe dla projektu.
2. Opisz tego, co agent powinien.
3. Wygeneruj właściwy monit systemowy i identyfikator.
4. Wejście do wybrania narzędzia, do którego agenta może być dostęp.
5. Na koniec pliku pliku przecen z konfiguracją agenta.
1. Pytanie o miejsce zapisu agenta (globalnie lub dla projektu).
2. Opis tego, co agent powinien robić.
3. Wygenerowanie odpowiedniego promptu systemowego i identyfikatora.
4. Wybór narzędzi, do których agent powinien mieć dostęp.
5. Zapisanie pliku markdown z konfiguracją agenta.
---
## Przypadki użycia
Oto kilka typowych zastosowań różnych agentów.
Oto kilka typowych zastosowań różnych agentów:
- **Agent użyciai**: Pełne prace programistyczne z dostępnymi narzędziami
- **Plan agenta**: Analiza i planowanie bez zmian
- **Agent recenzujący**: Przegląd kodu z odczytu i narzędzia do dokumentacji
- **Agent debugujący**: Koncentruje się na urządzeniu z dostępnymi narzędziami bash i odczytu
- **Agent Dokumentów**: Zapisywanie dokumentacji za pomocą operacji na plikach, ale bez konieczności posiadania kopii systemowych
- **Agent programista**: Pełne prace programistyczne z dostępem do wszystkich narzędzi.
- **Agent Plan**: Analiza i planowanie bez ryzyka modyfikacji kodu.
- **Agent recenzujący**: Przegląd kodu z dostępem do odczytu plików i narzędzi dokumentacyjnych.
- **Agent debugujący**: Koncentruje się na rozwiązywaniu problemów z dostępem do narzędzi bash i odczytu plików.
- **Agent Documentation**: Tworzenie i utrzymywanie dokumentacji z dostępem do operacji na plikach, ale bez poleceń systemowych.
---
## Przykład
## Przykłady
Oto kilka przykładowych agentów, którzy mogą się przydatni.
Oto kilka przykładowych agentów, którzy mogą być przydatni.
:::tip
Czy masz agenta, który jest osobą towarzyszącą? [Prześlij PR](https://github.com/anomalyco/opencode).
Masz agenta, którym warto się podzielić? [Prześlij PR](https://github.com/anomalyco/opencode).
:::
---
### Dokumentacja agenta
### Agent Documentation
```markdown title="~/.config/opencode/agents/docs-writer.md"
---
@@ -724,7 +723,7 @@ Focus on:
---
### Audytor bezpieczeństwa
### Security Auditor
```markdown title="~/.config/opencode/agents/security-auditor.md"
---

View File

@@ -1,17 +1,17 @@
---
title: CLI
description: Opcje i polecenia CLI opencode.
description: Opcje i polecenia wiersza poleceń OpenCode.
---
import { Tabs, TabItem } from "@astrojs/starlight/components"
CLI opencode domyślnie uruchamia [TUI](/docs/tui), gdy wywołasz je bez argumentów.
CLI OpenCode domyślnie uruchamia [TUI](/docs/tui), gdy wywołasz je bez argumentów.
```bash
opencode
```
CLI obsługuje też polecenia opisane na tej stronie, więc możesz używać opencode programowo.
CLI obsługuje też polecenia opisane na tej stronie, więc możesz używać OpenCode programowo.
```bash
opencode run "Explain how closures work in JavaScript"
@@ -21,7 +21,7 @@ opencode run "Explain how closures work in JavaScript"
### tui
Uruchomienie interfejsu użytkownika terminala opencode.
Uruchamia interfejs terminalowy (TUI) OpenCode.
```bash
opencode [project]
@@ -29,28 +29,28 @@ opencode [project]
#### Flagi
| Flaga | Krótkie | Opis |
| ------------ | ------- | ------------------------------------------------------------------------ |
| `--continue` | `-c` | Kontynuuj ostatnią datę |
| `--session` | `-s` | Identyfikator sesji, aby kontynuować |
| `--fork` | | Rozgałęź sesję podczas kontynuacji (użyj z `--continue` lub `--session`) |
| `--prompt` | | Monituj o zastosowanie |
| `--model` | `-m` | Model wykorzystania w postaci dostawcy/modelu |
| `--agent` | | Agent do użycia |
| `--port` | | Port do słuchania |
| `--hostname` | | Nazwa hosta, która jest częścią składową |
| Flaga | Skrót | Opis |
| ------------ | ----- | ----------------------------------------------------------------------- |
| `--continue` | `-c` | Kontynuuj ostatnią sesję |
| `--session` | `-s` | Identyfikator sesji do kontynuowania |
| `--fork` | | Sklonuj sesję podczas kontynuacji (użyj z `--continue` lub `--session`) |
| `--prompt` | | Monit do użycia |
| `--model` | `-m` | Model do użycia w formacie dostawca/model |
| `--agent` | | Agent do użycia |
| `--port` | | Port do nasłuchiwania |
| `--hostname` | | Nazwa hosta, do której należy się powiązać |
---
## Polecenia
Interfejs CLI opencode zawiera także szczegółowe polecenie.
Interfejs CLI OpenCode zawiera także dodatkowe polecenia.
---
### agent
Zarządzaj agentami opencode.
Zarządzaj agentami OpenCode.
```bash
opencode agent [command]
@@ -60,13 +60,13 @@ opencode agent [command]
### attach
Dołącz terminal do już działającego serwera zaplecza opencode uruchomionego za pomocą oprogramowania `serve` lub `web`.
Dołącz terminal do już działającego serwera backendu OpenCode uruchomionego za pomocą `serve` lub `web`.
```bash
opencode attach [url]
```
Możliwość zabezpieczenia z TUI ze zdalnym backendem opencode. Na przykład:
Pozwala to połączyć TUI ze zdalnym backendem OpenCode. Na przykład:
```bash
# Start the backend server for web/mobile access
@@ -78,10 +78,10 @@ opencode attach http://10.20.30.40:4096
#### Flagi
| Flaga | Krótkie | Opis |
| ----------- | ------- | ------------------------------------- |
| `--dir` | | Katalog roboczy do uruchomienia TUI w |
| `--session` | `-s` | Identyfikator sesji, aby kontynuować |
| Flaga | Skrót | Opis |
| ----------- | ----- | --------------------------------------- |
| `--dir` | | Katalog roboczy, w którym uruchomić TUI |
| `--session` | `-s` | Identyfikator sesji do kontynuowania |
---
@@ -93,13 +93,13 @@ Utwórz nowego agenta z niestandardową konfiguracją.
opencode agent create
```
To działanie poprowadził Cię przez proces tworzenia nowego agenta z niestandardowym monitem systemowym i konfiguracją narzędzia.
To polecenie poprowadzi Cię przez proces tworzenia nowego agenta z niestandardowym promptem systemowym i konfiguracją narzędzi.
---
#### list
Lista wszystkich agentów.
Wyświetl listę wszystkich agentów.
```bash
opencode agent list
@@ -109,7 +109,7 @@ opencode agent list
### auth
Polecenie do zarządzania danymi uwierzytelniającymi i logowaniem dla dostawców.
Zarządzaj danymi uwierzytelniającymi i logowaniem dla dostawców.
```bash
opencode auth [command]
@@ -119,25 +119,25 @@ opencode auth [command]
#### login
opencode jest dostępny przez listę dostawców w [Models.dev](https://models.dev), więc można użyć `opencode auth login` do skonfigurowania klucza API dla dowolnego dostawcy, który może być kontrolowany. Jest to możliwe w `~/.local/share/opencode/auth.json`.
OpenCode integruje się z wieloma dostawcami. Możesz użyć `opencode auth login`, aby skonfigurować klucz API dla dowolnego obsługiwanego dostawcy. Klucze są bezpiecznie przechowywane w `~/.local/share/opencode/auth.json`.
```bash
opencode auth login
```
Po uruchomieniu opencode ładuje dostawców z pliku poświadczeń. A jeśli twoje siedliskiem są jakieś klucze lub plik `.env` w twoim projekcie.
Podczas uruchamiania OpenCode ładuje dostawców z pliku poświadczeń, a także ze zmiennych środowiskowych lub pliku `.env` w Twoim projekcie.
---
#### list
Wyświetlanie list wszystkich uwierzytelnionych dostawców przechowywanych w pliku poświadczeń.
Wyświetl listę wszystkich uwierzytelnionych dostawców przechowywanych w pliku poświadczeń.
```bash
opencode auth list
```
Lub krótka wersja.
Lub skrócona wersja:
```bash
opencode auth ls
@@ -147,7 +147,7 @@ opencode auth ls
#### logout
Wylogowuje Cię z dostawcy poprzez usunięcie go z pliku poświadczeń.
Wyloguj się z dostawcy, usuwając go z pliku poświadczeń.
```bash
opencode auth logout
@@ -173,13 +173,13 @@ Zainstaluj agenta GitHub w swoim repozytorium.
opencode github install
```
Spowoduje to konieczność uruchomienia akcji GitHub i przeprowadzi cię przez proces tworzenia. [Dowiedz się więcej](/docs/github).
Spowoduje to utworzenie pliku workflow GitHub Actions i poprowadzi Cię przez proces konfiguracji. [Dowiedz się więcej](/docs/github).
---
#### run
Uruchom agenta na GitHubie. Jest to zwykły użytkownik w akcjach GitHub.
Uruchom agenta na GitHubie. Zwykle używane w GitHub Actions.
```bash
opencode github run
@@ -187,16 +187,16 @@ opencode github run
##### Flagi
| Flaga | Opis |
| --------- | ------------------------------------------------- |
| `--event` | Zdarzenie próbne GitHub, aby sprawdzić agenta dla |
| `--token` | Osobisty token dostępu GitHub |
| Flaga | Opis |
| --------- | ---------------------------------------- |
| `--event` | Zdarzenie GitHub, które wyzwoliło agenta |
| `--token` | Osobisty token dostępu GitHub |
---
### MCP
### mcp
Zarządzaj serwerem kluczowego modelu kontekstowego.
Zarządzaj serwerami Model Context Protocol (MCP).
```bash
opencode mcp [command]
@@ -212,19 +212,19 @@ Dodaj serwer MCP do swojej konfiguracji.
opencode mcp add
```
To polecenie poprowadzić Cię przez proces dodawania lokalnego lub zdalnego serwera MCP.
To polecenie poprowadzi Cię przez proces dodawania lokalnego lub zdalnego serwera MCP.
---
#### list
Wyświetlanie list wszystkich skonfigurowanych serwerów MCP i ich awarii.
Wyświetl listę wszystkich skonfigurowanych serwerów MCP i ich status.
```bash
opencode mcp list
```
Lub skrót krótkiej wersji.
Lub skrócona wersja:
```bash
opencode mcp ls
@@ -234,21 +234,21 @@ opencode mcp ls
#### auth
Uwierzytelnij się za pomocą serwera MCP z włączoną funkcją OAuth.
Uwierzytelnij się w serwerze MCP z włączoną funkcją OAuth.
```bash
opencode mcp auth [name]
```
Jeśli nie poddasz nazwy serwera, zostaniesz poproszony o wybranie jednego z serwerów obsługujących OAuth.
Jeśli nie podasz nazwy serwera, zostaniesz poproszony o wybranie jednego z serwerów wymagających uwierzytelnienia.
Możesz także uruchomić serwery obsługujące OAuth i ich status uwierzytelnienia.
Możesz także wyświetlić listę serwerów obsługujących OAuth i ich status uwierzytelnienia.
```bash
opencode mcp auth list
```
Lub skrót krótkiej wersji.
Lub skrócona wersja:
```bash
opencode mcp auth ls
@@ -258,7 +258,7 @@ opencode mcp auth ls
#### logout
Usuń doświadczenie OAuth dla serwera MCP.
Usuń tokeny OAuth dla serwera MCP.
```bash
opencode mcp logout [name]
@@ -278,17 +278,17 @@ opencode mcp debug <name>
### models
Wyświetlanie list modeli wszystkich skonfigurowanych dostawców.
Wyświetl listę modeli ze wszystkich skonfigurowanych dostawców.
```bash
opencode models [provider]
```
Do sterowania dostępnymi modelami u dostawców w `provider/model`.
Pokazuje modele dostępne do użycia w `provider/model`.
Jest to wydanie do nazwy modelu, który jest używany w [twoja] (./config/).
Jest to identyfikator modelu, którego używasz w [konfiguracji](/docs/config).
Opcjonalnie możesz udostępnić identyfikator dostawcy, aby filtrować modele według tego dostawcy.
Opcjonalnie możesz podać identyfikator dostawcy, aby filtrować modele według tego dostawcy.
```bash
opencode models anthropic
@@ -298,10 +298,10 @@ opencode models anthropic
| Flaga | Opis |
| ----------- | ------------------------------------------------------------------------------- |
| `--refresh` | Odśwież pamięć podręczną modele z models.dev |
| `--refresh` | Odśwież pamięć podręczną modeli |
| `--verbose` | Bardziej szczegółowe dane wyjściowe modelu (zawiera metadane, takie jak koszty) |
flagi `--refresh`, aby znaleźć listę modeli w pamięci podręcznej. Jest to wymagane, gdy dostawca dodano nowe modele, które chcesz zobaczyć w opencode.
Użyj flagi `--refresh`, aby zaktualizować listę modeli w pamięci podręcznej. Jest to przydatne, gdy dostawca dodał nowe modele, które chcesz zobaczyć w OpenCode.
```bash
opencode models --refresh
@@ -309,21 +309,21 @@ opencode models --refresh
---
### chcesz
### run
Uruchomiony opencode w trybie nieinteraktywnym, przekazując bezpośrednio monit.
Uruchom OpenCode w trybie nieinteraktywnym, przekazując bezpośrednio prompt.
```bash
opencode run [message..]
```
Jest to wymagane w przypadku tworzenia skryptów, automatyzacji lub gdy zostanie wysłane natychmiastowe przesłanie bez uruchomienia TUI. Na przykład.
Jest to przydatne do tworzenia skryptów, automatyzacji lub gdy chcesz wysłać szybkie zapytanie bez uruchamiania TUI. Na przykład:
```bash "opencode run"
opencode run Explain the use of context in Go
```
Można również zastosować, uruchamiając `opencode serve`, aby wyłączyć zimne uruchamianie serwera MCP przy każdym uruchomieniu:
Można również użyć tego z działającym `opencode serve`, aby uniknąć zimnego startu serwera MCP przy każdym uruchomieniu:
```bash
# Start a headless server in one terminal
@@ -335,47 +335,47 @@ opencode run --attach http://localhost:4096 "Explain async/await in JavaScript"
#### Flagi
| Flaga | Krótkie | Opis |
| ------------ | ------- | ------------------------------------------------------------------------ |
| `--command` | | Polecenie do uruchomienia, komunikatu dla argumentów |
| `--continue` | `-c` | Kontynuuj ostatnią datę |
| `--session` | `-s` | Identyfikator sesji, aby kontynuować |
| `--fork` | | Rozgałęź sesję podczas kontynuacji (użyj z `--continue` lub `--session`) |
| `--share` | | Udostępnij sesję |
| `--model` | `-m` | Model wykorzystania w postaci dostawcy/modelu |
| `--agent` | | Agent do użycia |
| `--file` | `-f` | Pliki do załączenia do wiadomości |
| `--format` | | Format: domyślny (sformatowany) lub json (surowe rozwiązanie JSON) |
| `--title` | | Tytuł sesji (używany skróconego monitu, jeśli nie podano wartości) |
| `--attach` | | Dołącz do skutecznego serwera opencode (np. http://localhost:4096) |
| `--port` | | Port dla serwera lokalnego (domyślnie jest do portu losowego) |
| Flaga | Skrót | Opis |
| ------------ | ----- | ----------------------------------------------------------------------- |
| `--command` | | Polecenie do uruchomienia, reszta to argumenty |
| `--continue` | `-c` | Kontynuuj ostatnią sesję |
| `--session` | `-s` | Identyfikator sesji do kontynuowania |
| `--fork` | | Sklonuj sesję podczas kontynuacji (użyj z `--continue` lub `--session`) |
| `--share` | | Udostępnij sesję po zakończeniu |
| `--model` | `-m` | Model do użycia w formacie dostawca/model |
| `--agent` | | Agent do użycia |
| `--file` | `-f` | Pliki do załączenia do wiadomości |
| `--format` | | Format wyjściowy: `default` (sformatowany) lub `json` (surowy JSON) |
| `--title` | | Tytuł sesji (jeśli nie podano, zostanie wygenerowany z promptu) |
| `--attach` | | Dołącz do działającego serwera OpenCode (np. http://localhost:4096) |
| `--port` | | Port dla serwera lokalnego (domyślnie losowy) |
---
### serve
Uruchom bezgłowy serwer opencode w celu uzyskania dostępu do API. Pełny interfejs HTTP w [dokumentacji serwera](/docs/server).
Uruchom serwer OpenCode (bez interfejsu) w celu uzyskania dostępu do API. Pełny opis API HTTP znajduje się w [dokumentacji serwera](/docs/server).
```bash
opencode serve
```
Spowoduje dostęp do serwera HTTP, który zapewnia dostęp do API opencode bez interfejsu TUI. Ustaw `OPENCODE_SERVER_PASSWORD`, aby włączyć podstawowe uwierzytelnianie HTTP (domyślna nazwa użytkownika do `opencode`).
Uruchamia to serwer HTTP, który zapewnia dostęp do API OpenCode bez interfejsu TUI. Ustaw `OPENCODE_SERVER_PASSWORD`, aby włączyć podstawowe uwierzytelnianie HTTP (domyślna nazwa użytkownika to `opencode`).
#### Flagi
| Flaga | Opis |
| ------------ | ---------------------------------------- |
| `--port` | Port do słuchania |
| `--hostname` | Nazwa hosta, która jest częścią składową |
| `--mdns` | Włącz wykrywanie mDNS |
| `--cors` | Dodatkowe źródło użytkownika CORS |
| Flaga | Opis |
| ------------ | ------------------------------------------ |
| `--port` | Port do nasłuchiwania |
| `--hostname` | Nazwa hosta, do której należy się powiązać |
| `--mdns` | Włącz wykrywanie mDNS |
| `--cors` | Dodatkowe dozwolone źródła CORS |
---
### session
Zarządzaj sesją opencode.
Zarządzaj sesjami OpenCode.
```bash
opencode session [command]
@@ -385,7 +385,7 @@ opencode session [command]
#### list
Lista wszystkich sesji opencode.
Lista wszystkich sesji OpenCode.
```bash
opencode session list
@@ -393,16 +393,16 @@ opencode session list
##### Flagi
| Flaga | Krótkie | Opis |
| ------------- | ------- | ------------------------------------------ |
| `--max-count` | `-n` | Ograniczony do ostatniego sesji |
| `--format` | | Format wyjściowy: tabela lub json (tabela) |
| Flaga | Skrót | Opis |
| ------------- | ----- | ------------------------------------------ |
| `--max-count` | `-n` | Ogranicz do ostatnich N sesji |
| `--format` | | Format wyjściowy: tabela lub json (tabela) |
---
### stats
Pokaż statystyki wykorzystania tokenów i sesji szkoleniowych opencode.
Pokaż statystyki wykorzystania tokenów i sesji OpenCode.
```bash
opencode stats
@@ -412,10 +412,10 @@ opencode stats
| Flaga | Opis |
| ----------- | ------------------------------------------------------------------------------------- |
| `--days` | Pokaż statystyki z ostatnich N dni (cały czas) |
| `--tools` | Liczba narzędzi do po specyfikacji (wszystkie) |
| `--models` | Pokaż podział modelu wykorzystania (domyślnie ukryty). Podajnik usługowy, aby górne N |
| `--project` | Filtruj według projektu (wszystkie projekty, pusty ciąg: dostęp projekt) |
| `--days` | Pokaż statystyki z ostatnich N dni (domyślnie: cały czas) |
| `--tools` | Pokaż użycie poszczególnych narzędzi (domyślnie: wszystkie) |
| `--models` | Pokaż podział na modele (domyślnie ukryty). Podaj liczbę, aby pokazać N najczęstszych |
| `--project` | Filtruj według projektu (domyślnie: wszystkie projekty, pusty ciąg: bieżący projekt) |
---
@@ -427,19 +427,19 @@ Eksportuj dane sesji jako JSON.
opencode export [sessionID]
```
Jeśli nie poddasz identyfikatora sesji, zostaniesz poproszony o wybranie jednego z sesji.
Jeśli nie podasz identyfikatora sesji, zostaniesz poproszony o wybranie jednej z ostatnich sesji.
---
### import
Importuj dane sesji z pliku JSON lub adresu URL udostępniania opencode.
Importuj dane sesji z pliku JSON lub adresu URL udostępniania OpenCode.
```bash
opencode import <file>
```
Możesz importować z lokalnego lub adresu URL opencode.
Możesz importować z pliku lokalnego lub adresu URL.
```bash
opencode import session.json
@@ -450,48 +450,48 @@ opencode import https://opncd.ai/s/abc123
### web
Uruchomiony bezgłowy serwer opencode z interfejsem internetowym.
Uruchom serwer OpenCode z interfejsem internetowym.
```bash
opencode web
```
Spowoduje dostęp do serwera HTTP i otwarcie dostępu do opencode przez interfejs sieciowy. Ustaw `OPENCODE_SERVER_PASSWORD`, aby włączyć podstawowe uwierzytelnianie HTTP (domyślna nazwa użytkownika do `opencode`).
Uruchamia to serwer HTTP i udostępnia OpenCode przez interfejs przeglądarkowy. Ustaw `OPENCODE_SERVER_PASSWORD`, aby włączyć podstawowe uwierzytelnianie HTTP (domyślna nazwa użytkownika to `opencode`).
#### Flagi
| Flaga | Opis |
| ------------ | ---------------------------------------- |
| `--port` | Port do słuchania |
| `--hostname` | Nazwa hosta, która jest częścią składową |
| `--mdns` | Włącz wykrywanie mDNS |
| `--cors` | Dodatkowe źródło użytkownika CORS |
| Flaga | Opis |
| ------------ | ------------------------------------------ |
| `--port` | Port do nasłuchiwania |
| `--hostname` | Nazwa hosta, do której należy się powiązać |
| `--mdns` | Włącz wykrywanie mDNS |
| `--cors` | Dodatkowe dozwolone źródła CORS |
---
### acp
Uruchomiony serwer ACP (Agent Client Protocol).
Uruchom serwer ACP (Agent Client Protocol).
```bash
opencode acp
```
Aby udostępnić serwer ACP, który komunikuje się poprzez stdin/stdout przy użyciu nd-JSON.
Uruchamia serwer ACP, który komunikuje się przez stdin/stdout przy użyciu JSON-RPC.
#### Flagi
| Flaga | Opis |
| ------------ | ---------------------------------------- |
| `--cwd` | Katalog roboczy |
| `--port` | Port do słuchania |
| `--hostname` | Nazwa hosta, która jest częścią składową |
| Flaga | Opis |
| ------------ | ------------------------------------------ |
| `--cwd` | Katalog roboczy |
| `--port` | Port do nasłuchiwania |
| `--hostname` | Nazwa hosta, do której należy się powiązać |
---
### uninstall
Odinstaluj opencode i usuń wszystkie pliki powiązane.
Odinstaluj OpenCode i usuń wszystkie powiązane pliki.
```bash
opencode uninstall
@@ -499,30 +499,30 @@ opencode uninstall
#### Flagi
| Flaga | Krótkie | Opis |
| --------------- | ------- | --------------------------------- |
| `--keep-config` | `-c` | Zachowaj pliki konfiguracyjne |
| `--keep-data` | `-d` | Przechowuj dane sesji i snapshots |
| `--dry-run` | | Pokaż, wykluczy bez usuwania |
| `--force` | `-f` | Pomiń monity o potwierdzenie |
| Flaga | Skrót | Opis |
| --------------- | ----- | ----------------------------- |
| `--keep-config` | `-c` | Zachowaj pliki konfiguracyjne |
| `--keep-data` | `-d` | Zachowaj dane sesji i migawki |
| `--dry-run` | | Pokaż co zostanie usunięte |
| `--force` | `-f` | Pomiń monity o potwierdzenie |
---
### upgrade
Aktualizuje opencode do oryginalnej wersji lub oryginalnej wersji.
Aktualizuj OpenCode do najnowszej lub określonej wersji.
```bash
opencode upgrade [target]
```
Aby zachować ostatnią wersję.
Aby zaktualizować do najnowszej wersji:
```bash
opencode upgrade
```
Aby zobaczyć wersję pierwotną.
Aby zaktualizować do konkretnej wersji:
```bash
opencode upgrade v0.1.48
@@ -530,74 +530,74 @@ opencode upgrade v0.1.48
#### Flagi
| Flaga | Krótkie | Opis |
| ---------- | ------- | --------------------------------------------------------- |
| `--method` | `-m` | Zastosowana metoda instalacji; curl, npm, pnpm, bun, brew |
| Flaga | Skrót | Opis |
| ---------- | ----- | --------------------------------------------------- |
| `--method` | `-m` | Wymuś metodę instalacji: curl, npm, pnpm, bun, brew |
---
## Flagi globalne
Interfejs CLI kod opencode przyjmuje flagi globalne.
Interfejs CLI OpenCode przyjmuje następujące flagi globalne dla każdego polecenia.
| Flaga | Krótkie | Opis |
| -------------- | ------- | ------------------------------------------- |
| `--help` | `-h` | Wyświetl pomoc |
| `--version` | `-v` | Drukuj numer wersji |
| `--print-logs` | | Wydrukuj logi na stderr |
| `--log-level` | | Poziom dziennika (DEBUG, INFO, WARN, ERROR) |
| Flaga | Skrót | Opis |
| -------------- | ----- | ------------------------------------------- |
| `--help` | `-h` | Wyświetl pomoc |
| `--version` | `-v` | Wydrukuj numer wersji |
| `--print-logs` | | Drukuj logi na stderr |
| `--log-level` | | Poziom logowania (DEBUG, INFO, WARN, ERROR) |
---
## Zmienne środowiskowe
opencode można skonfigurować za pomocą zmiennych środowiskowych.
OpenCode można skonfigurować za pomocą zmiennych środowiskowych.
| Zmienna | Wpisz | Opis |
| ------------------------------------- | ------- | ----------------------------------------------------------------------- |
| `OPENCODE_AUTO_SHARE` | boolean | Automatycznie udostępniaj sesje |
| `OPENCODE_GIT_BASH_PATH` | string | Ścieżka do pliku wykonywalnego Git Bash w systemie Windows |
| `OPENCODE_CONFIG` | string | Ścieżka do pliku konfiguracyjnego |
| `OPENCODE_CONFIG_DIR` | string | Ścieżka do katalogu konfiguracyjnego |
| `OPENCODE_CONFIG_CONTENT` | string | Wbudowana treść konstrukcji JSON |
| `OPENCODE_DISABLE_AUTOUPDATE` | boolean | Wyłącz automatyczne sprawdzanie aktualizacji |
| `OPENCODE_DISABLE_PRUNE` | boolean | Wyłączenie regulowane |
| `OPENCODE_DISABLE_TERMINAL_TITLE` | boolean | Wyłącz automatycznie tytuł terminala |
| `OPENCODE_PERMISSION` | string | Wbudowane prawo JSON |
| `OPENCODE_DISABLE_DEFAULT_PLUGINS` | boolean | Wyłączenie wtyczki |
| `OPENCODE_DISABLE_LSP_DOWNLOAD` | boolean | Wyłącz automatyczne pobieranie z serwera LSP |
| `OPENCODE_ENABLE_EXPERIMENTAL_MODELS` | boolean | Włącz modele eksperymentalne |
| `OPENCODE_DISABLE_AUTOCOMPACT` | boolean | Wyłącz automatyczne zagęszczanie kontekstu |
| `OPENCODE_DISABLE_CLAUDE_CODE` | boolean | Wyłączenie gry z `.claude` (podpowiedź + podłączenie) |
| `OPENCODE_DISABLE_CLAUDE_CODE_PROMPT` | boolean | Wyłącz czytanie `~/.claude/CLAUDE.md` |
| `OPENCODE_DISABLE_CLAUDE_CODE_SKILLS` | boolean | Wyłącz ładowanie `.claude/skills` |
| `OPENCODE_DISABLE_MODELS_FETCH` | boolean | Wyłączenie modeli pobierania ze źródeł niedostępnych |
| `OPENCODE_FAKE_VCS` | string | Fałszywy sprzedawca VCS do celów testowych |
| `OPENCODE_DISABLE_FILETIME_CHECK` | boolean | Wyłączone sprawdzanie pliku w celu optymalizacji |
| `OPENCODE_CLIENT` | string | Identyfikator klienta (domyślnie `cli`) |
| `OPENCODE_ENABLE_EXA` | boolean | Włącz narzędzie wyszukiwania internetowego Exa |
| `OPENCODE_SERVER_PASSWORD` | string | Włącz uwierzytelnianie podstawowe dla `serve`/`web` |
| `OPENCODE_SERVER_USERNAME` | string | Zakończenie stosowania użytkownika z autoryzacją (domyślnie `opencode`) |
| `OPENCODE_MODELS_URL` | string | Niestandardowy adres URL do pobrania konfiguracji modeli |
| Zmienna | Typ | Opis |
| ------------------------------------- | ------- | ----------------------------------------------------------- |
| `OPENCODE_AUTO_SHARE` | boolean | Automatycznie udostępniaj sesje |
| `OPENCODE_GIT_BASH_PATH` | string | Ścieżka do pliku wykonywalnego Git Bash w systemie Windows |
| `OPENCODE_CONFIG` | string | Ścieżka do pliku konfiguracyjnego |
| `OPENCODE_CONFIG_DIR` | string | Ścieżka do katalogu konfiguracyjnego |
| `OPENCODE_CONFIG_CONTENT` | string | Treść konfiguracji JSON (inline) |
| `OPENCODE_DISABLE_AUTOUPDATE` | boolean | Wyłącz automatyczne sprawdzanie aktualizacji |
| `OPENCODE_DISABLE_PRUNE` | boolean | Wyłącz czyszczenie starych wyników (pruning) |
| `OPENCODE_DISABLE_TERMINAL_TITLE` | boolean | Wyłącz automatyczne ustawianie tytułu terminala |
| `OPENCODE_PERMISSION` | string | Konfiguracja uprawnień w JSON (inline) |
| `OPENCODE_DISABLE_DEFAULT_PLUGINS` | boolean | Wyłącz domyślne wtyczki |
| `OPENCODE_DISABLE_LSP_DOWNLOAD` | boolean | Wyłącz automatyczne pobieranie serwerów LSP |
| `OPENCODE_ENABLE_EXPERIMENTAL_MODELS` | boolean | Włącz modele eksperymentalne |
| `OPENCODE_DISABLE_AUTOCOMPACT` | boolean | Wyłącz automatyczne kompaktowanie kontekstu |
| `OPENCODE_DISABLE_CLAUDE_CODE` | boolean | Wyłącz integrację z `.claude` (prompt + skills) |
| `OPENCODE_DISABLE_CLAUDE_CODE_PROMPT` | boolean | Wyłącz czytanie `~/.claude/CLAUDE.md` |
| `OPENCODE_DISABLE_CLAUDE_CODE_SKILLS` | boolean | Wyłącz ładowanie `.claude/skills` |
| `OPENCODE_DISABLE_MODELS_FETCH` | boolean | Wyłącz pobieranie modeli ze źródeł zewnętrznych |
| `OPENCODE_FAKE_VCS` | string | Fałszywy dostawca VCS do celów testowych |
| `OPENCODE_DISABLE_FILETIME_CHECK` | boolean | Wyłącz sprawdzanie czasu modyfikacji plików (optymalizacja) |
| `OPENCODE_CLIENT` | string | Identyfikator klienta (domyślnie `cli`) |
| `OPENCODE_ENABLE_EXA` | boolean | Włącz narzędzie wyszukiwania internetowego Exa |
| `OPENCODE_SERVER_PASSWORD` | string | Włącz uwierzytelnianie podstawowe dla `serve`/`web` |
| `OPENCODE_SERVER_USERNAME` | string | Nazwa użytkownika do autoryzacji (domyślnie `opencode`) |
| `OPENCODE_MODELS_URL` | string | Niestandardowy adres URL do pobierania konfiguracji modeli |
---
### Eksperymentalne
Te zmienne możliwości użycia funkcji eksperymentalnych, które mogą zostać lub usunięte.
Te zmienne włączają funkcje eksperymentalne, które mogą ulec zmianie lub zostać usunięte.
| Zmienna | Wpisz | Opis |
| ----------------------------------------------- | ------- | ---------------------------------------------- |
| `OPENCODE_EXPERIMENTAL` | boolean | Włącz wszystkie funkcje eksperymentalne |
| `OPENCODE_EXPERIMENTAL_ICON_DISCOVERY` | boolean | Włącz wykrywanie ikon |
| `OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT` | boolean | Wyłączenie kopiowania przy wyborze w TUI |
| `OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS` | numer | Domyślny limit czasu dla ukrytego bash w ms |
| `OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX` | numer | Maksymalne tokeny wyjściowe dla odpowiedzi LLM |
| `OPENCODE_EXPERIMENTAL_FILEWATCHER` | boolean | Włącz obserwatora plików dla całego katalogu |
| `OPENCODE_EXPERIMENTAL_OXFMT` | boolean | Włącz formater oxfmt |
| `OPENCODE_EXPERIMENTAL_LSP_TOOL` | boolean | Włącz eksperymentalne narzędzie LSP |
| `OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER` | boolean | Wyłącz obserwatora plików |
| `OPENCODE_EXPERIMENTAL_EXA` | boolean | Włącz funkcje eksperymentalne Exa |
| `OPENCODE_EXPERIMENTAL_LSP_TY` | boolean | Włącz eksperymentalne sprawdzanie typu LSP |
| `OPENCODE_EXPERIMENTAL_MARKDOWN` | boolean | Włącz funkcje eksperymentalne Markdown |
| `OPENCODE_EXPERIMENTAL_PLAN_MODE` | boolean | Włącz tryb planu |
| Zmienna | Typ | Opis |
| ----------------------------------------------- | ------- | -------------------------------------------- |
| `OPENCODE_EXPERIMENTAL` | boolean | Włącz wszystkie funkcje eksperymentalne |
| `OPENCODE_EXPERIMENTAL_ICON_DISCOVERY` | boolean | Włącz wykrywanie ikon |
| `OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT` | boolean | Wyłącz kopiowanie przy zaznaczaniu w TUI |
| `OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS` | number | Domyślny limit czasu dla narzędzia bash w ms |
| `OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX` | number | Maksymalne tokeny wyjściowe dla LLM |
| `OPENCODE_EXPERIMENTAL_FILEWATCHER` | boolean | Włącz obserwatora plików dla całego katalogu |
| `OPENCODE_EXPERIMENTAL_OXFMT` | boolean | Włącz formater oxfmt |
| `OPENCODE_EXPERIMENTAL_LSP_TOOL` | boolean | Włącz eksperymentalne narzędzie LSP |
| `OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER` | boolean | Wyłącz obserwatora plików |
| `OPENCODE_EXPERIMENTAL_EXA` | boolean | Włącz funkcje eksperymentalne Exa |
| `OPENCODE_EXPERIMENTAL_LSP_TY` | boolean | Włącz eksperymentalne sprawdzanie typów LSP |
| `OPENCODE_EXPERIMENTAL_MARKDOWN` | boolean | Włącz funkcje eksperymentalne Markdown |
| `OPENCODE_EXPERIMENTAL_PLAN_MODE` | boolean | Włącz tryb planowania |

View File

@@ -1,21 +1,21 @@
---
title: Polecenia
description: Tworz polecany dla powtarzalnych zadań.
description: Twórz polecenia dla powtarzalnych zadań.
---
Polecenia ustawienia monitu, które może zostać uruchomione po uruchomieniu tego polecenia w TUI.
Polecenia to zdefiniowane prompty, które można uruchomić w TUI.
```bash frame="none"
/my-command
```
Polecenia stanowią dodatek do dostarczonych, takich jak `/init`, `/undo`, `/redo`, `/share`, `/help`. [Dowiedz się więcej](/docs/tui#commands).
Polecenia są dodatkiem do wbudowanych, takich jak `/init`, `/undo`, `/redo`, `/share`, `/help`. [Dowiedz się więcej](/docs/tui#commands).
---
## Utwórz źródło plikówwe
## Utwórz pliki źródłowe
Utwórz pliki Markdown w katalogu `commands/`, aby móc korzystać z usług polecanych.
Utwórz pliki Markdown w katalogu `commands/`, aby zdefiniować polecenia.
Utwórz `.opencode/commands/test.md`:
@@ -30,9 +30,9 @@ Run the full test suite with coverage report and show any failures.
Focus on the failing tests and suggest fixes.
```
Frontmatter posiada właściwości. Treść staje się szablonem.
Frontmatter definiuje właściwości. Treść staje się szablonem.
polecany, w rejestrze `/`, a następnie polecany.
Uruchom polecenie, wpisując `/`, a następnie nazwę polecenia.
```bash frame="none"
"/test"
@@ -40,15 +40,15 @@ polecany, w rejestrze `/`, a następnie polecany.
---
## Skonfiguruj
## Konfiguracja
Dostęp do sieci przez połączenie opencode lub udostępnia pliki w katalogu `commands/`.
Możesz zdefiniować polecenia w `opencode.json` lub w plikach w katalogu `commands/`.
---
### JSON
opcja opcja `command` w swoim opencode [config](/docs/config):
Użyj opcji `command` w swojej konfiguracji opencode:
```json title="opencode.jsonc" {4-12}
{
@@ -93,8 +93,8 @@ Run the full test suite with coverage report and show any failures.
Focus on the failing tests and suggest fixes.
```
Nazwa pliku Markdown staje się nazwą referencyjną. Na przykład `test.md` pozwala
biegniesz:
Nazwa pliku Markdown staje się nazwą polecenia. Na przykład `test.md` pozwala
uruchomić:
```bash frame="none"
/test
@@ -102,15 +102,15 @@ biegniesz:
---
## Szybko kliknij
## Składnia promptu
Monity dotyczące niestandardowych urządzeń obsługujących kilka specjalnych symboli zastępczych i składni.
Prompty niestandardowych poleceń obsługują kilka specjalnych symboli zastępczych.
---
### Argumentacja
### Argumenty
Przekazuj argumentację do ręki, używając symbolu zastępczego `$ARGUMENTS`.
Przekazuj argumenty do promptu, używając symbolu zastępczego `$ARGUMENTS`.
```md title=".opencode/commands/component.md"
---
@@ -121,20 +121,20 @@ Create a new React component named $ARGUMENTS with TypeScript support.
Include proper typing and basic structure.
```
Uruchomienie reakcji z argumentami:
Uruchomienie polecenia z argumentami:
```bash frame="none"
/component Button
```
A `$ARGUMENTS` pozostanie pozostawione przez `Button`.
`$ARGUMENTS` zostanie zastąpione przez `Button`.
Dostępność do poszczególnych argumentów można również uzyskać za pomocą parametrów funkcjonalnych:
Dostęp do poszczególnych argumentów można uzyskać za pomocą parametrów pozycyjnych:
- `$1` - Pierwszy argument
- `$2` - Drugi argument
- `$3` - Trzeci argument
- Biorę dalej...
- I tak dalej...
Na przykład:
@@ -147,25 +147,25 @@ Create a file named $1 in the directory $2
with the following content: $3
```
Uruchomienie decyzji:
Uruchomienie polecenia:
```bash frame="none"
/create-file config.json src "{ \"key\": \"value\" }"
```
Aby przechowywać:
Wartości:
- `$1` z `config.json`
- `$2` z `src`
- `$3` z `{ "key": "value" }`
- `$1` to `config.json`
- `$2` to `src`
- `$3` to `{ "key": "value" }`
---
### Wyjście z pamięci
### Dane wyjściowe poleceń
urządzenie \__!`command`_, aby wstawić dane wyjściowe [polecenie bash](/docs/tui#bash-commands) wykonaj obciążenie.
Użyj `!command`, aby wstawić dane wyjściowe [polecenia bash](/docs/tui#bash-commands) do promptu.
Na przykład, aby sprawdzić narzędzie analityczne:
Na przykład, aby przeanalizować pokrycie testami:
```md title=".opencode/commands/analyze-coverage.md"
---
@@ -178,7 +178,7 @@ Here are the current test results:
Based on these results, suggest improvements to increase coverage.
```
Lub aby ostatnia zmiana:
Lub aby przejrzeć ostatnie zmiany:
```md title=".opencode/commands/review-changes.md"
---
@@ -191,13 +191,13 @@ Recent git commits:
Review these changes and suggest any improvements.
```
Polecenia są uruchamiane w systemie wyjściowym, a ich dane wyjściowe są uruchamiane.
Polecenia są uruchamiane w powłoce, a ich dane wyjściowe są wstawiane do promptu.
---
### Referencje plików
### Odwołania do plików
Dołącz pliki do swojego polecenia, używając `@`, zawierającego plik.
Dołącz pliki do swojego polecenia, używając `@` i ścieżki do pliku.
```md title=".opencode/commands/review-component.md"
---
@@ -208,7 +208,7 @@ Review the component in @src/components/Button.tsx.
Check for performance issues and suggest improvements.
```
Zawartość pliku jest automatycznie umieszczana w pliku.
Zawartość pliku jest automatycznie wstawiana do promptu.
---
@@ -218,9 +218,9 @@ Przyjrzyjmy się szczegółowo opcjom konfiguracji.
---
### Szablon
### Template
Opcja `template` została rozstrzygnięta, która została wysłana do LLM po wykonaniu polecenia.
Opcja `template` to prompt wysyłany do LLM po wykonaniu polecenia.
```json title="opencode.json"
{
@@ -236,9 +236,9 @@ Jest to **wymagana** opcja konfiguracji.
---
### Opis
### Description
Możliwość użycia `description`, aby skrócony opis działania polecenia.
Użyj `description`, aby dodać krótki opis działania polecenia.
```json title="opencode.json"
{
@@ -250,15 +250,15 @@ Możliwość użycia `description`, aby skrócony opis działania polecenia.
}
```
Jest podany jako opis w TUI po wpisaniu polecenia.
Jest wyświetlany jako opis w TUI po wpisaniu polecenia.
---
### Agent
Zastosowanie zastosowania `agent`, aby określić, który [agent] (./agents) powinien zostać naprawiony do wyboru.
Jeśli jest to [podagent](/docs/agents/#subagents), rozwiązanie to ujawnione, podagenta.
Aby móc, ustawa `subtask` na `false`.
Użyj opcji `agent`, aby określić, który [agent](/docs/agents) powinien wykonać to polecenie.
Jeśli jest to [subagent](/docs/agents/#subagents), zostanie on użyty.
Aby to zmienić, ustaw `subtask` na `false`.
```json title="opencode.json"
{
@@ -270,15 +270,15 @@ Aby móc, ustawa `subtask` na `false`.
}
```
Jest to **opcjonalna** opcja konfiguracji. Jeśli nie jest dostępny, dostępny jest agentem.
Jest to **opcjonalna** opcja konfiguracji. Jeśli nie podano, użyty zostanie domyślny agent.
---
### Podzadanie
### Subtask
Użyj wartości logicznej `subtask`, aby wymusić wywołanie [podagenta](/docs/agents/#subagents) polecenia.
Jest to narzędzie, jeśli chcesz, aby decyzja nie zanieczyszczała kontekstu i **zmusiło** agenta do działania jako subagent,
nawet jeśli `mode` jest podłączony na `primary` w konfiguracji [agent](/docs/agents).
Użyj `subtask`, aby wymusić wywołanie polecenia jako subzadania.
Jest to przydatne, jeśli chcesz, aby polecenie nie zanieczyszczało kontekstu i **zmusiło** agenta do działania jako subagent,
nawet jeśli `mode` jest ustawiony na `primary` w konfiguracji [agent](/docs/agents).
```json title="opencode.json"
{
@@ -296,7 +296,7 @@ Jest to **opcjonalna** opcja konfiguracji.
### Model
Używając konstrukcji `model`, aby znaleźć ukryty model dla tego polecenia.
Użyj `model`, aby określić model dla tego polecenia.
```json title="opencode.json"
{
@@ -312,12 +312,12 @@ Jest to **opcjonalna** opcja konfiguracji.
---
## Wbudowany
## Wbudowane
opencode zawiera kilka istniejących urządzeń, takich jak `/init`, `/undo`, `/redo`, `/share`, `/help`; [dowiedz się więcej](/docs/tui#commands).
opencode zawiera kilka wbudowanych poleceń, takich jak `/init`, `/undo`, `/redo`, `/share`, `/help`; [dowiedz się więcej](/docs/tui#commands).
:::note
Polecenia mogą zostać usunięte.
Polecenia wbudowane mogą zostać nadpisane.
:::
Jeśli zdefiniujesz tę samą nazwę, nastąpi decyzja.
Jeśli zdefiniujesz tę samą nazwę, twoje polecenie będzie miało pierwszeństwo.

View File

@@ -1,15 +1,15 @@
---
title: Konfiguracja
description: Ustawienia opencode w pliku JSON.
description: Ustawienia OpenCode w pliku JSON.
---
Możesz zagrać z opencode za pomocą pliku konfiguracyjnego JSON.
Możesz dostosować OpenCode za pomocą pliku konfiguracyjnego JSON.
---
## Format
opencode obsługa formaty **JSON** i **JSONC** (JSON z komentarzami).
OpenCode obsługuje formaty **JSON** i **JSONC** (JSON z komentarzami).
```jsonc title="opencode.jsonc"
{
@@ -25,45 +25,44 @@ opencode obsługa formaty **JSON** i **JSONC** (JSON z komentarzami).
## Lokalizacje
Możesz umieścić swoją instalację w kilku różnych lokalizacjach i jednym pliku
inne porządki pierwszeństwa.
Możesz umieścić swoją konfigurację w kilku różnych lokalizacjach, które mają ustaloną kolejność pierwszeństwa.
:::note
Pliki konfiguracyjne są **łączone**, a nie zastępowane.
Pliki konfiguracyjne są **łączone**, a nie nadpisywane.
:::
Pliki konfiguracyjne są łączone ze sobą, a nie zastępowane. Ustawienia z lokalizacji konfiguracyjnych są konfigurowalne. Ewentualne konfiguracje zaistnieją tylko w przypadku sprzecznych kluczy. Niekonfliktowe ustawienia ze wszystkich zasobów zachowanych.
Pliki konfiguracyjne są łączone ze sobą. Ustawienia z lokalizacji o wyższym priorytecie nadpisują ustawienia z lokalizacji o niższym priorytecie tylko w przypadku konfliktów kluczy. Ustawienia niekolidujące ze wszystkich źródeł są zachowywane.
Na zestawie, przygotowana globalna ustawi `theme: "opencode"` i `autoupdate: true`, zestaw zestawu `model: "anthropic/claude-sonnet-4-5"`, ostateczna zestaw będzie zawierał wszystkie trzy ustawienia.
Na przykład, jeśli konfiguracja globalna ustawi `theme: "opencode"` i `autoupdate: true`, a konfiguracja projektu ustawi `model: "anthropic/claude-sonnet-4-5"`, ostateczna konfiguracja będzie zawierać wszystkie trzy ustawienia.
---
### Kolejność pierwszeństwa
Źródła konfiguracji są ładowane w kolejności (później źródła występują wcześniej):
Źródła konfiguracji są ładowane w następującej kolejności (źródła występujące później mają pierwszeństwo):
1. **Zdalna konfiguracja** (od `.well-known/opencode`) ustawienia stosowane w organizacji
2. **Konfiguracja globalna** (`~/.config/opencode/opencode.json`) przestrzeganie użytkownika
3. **Konfiguracja niestandardowa** (`OPENCODE_CONFIG` env var) — zastosowanie zastąpienie
4. **Konfiguracja projektu** (`opencode.json` w projekcie) - ustawienia dla projektu specjalnego
5. **`.opencode` katalogi** - agent, poleca, półki
6. **Konfiguracja wbudowana** (`OPENCODE_CONFIG_CONTENT` env var) — zastąpienie środowiska wykonawczego
1. **Konfiguracja zdalna** (z `.well-known/opencode`) ustawienia wymuszane przez organizację
2. **Konfiguracja globalna** (`~/.config/opencode/opencode.json`) preferencje użytkownika
3. **Konfiguracja niestandardowa** (zmienna `OPENCODE_CONFIG`) — jawne nadpisanie
4. **Konfiguracja projektu** (`opencode.json` w projekcie) - ustawienia specyficzne dla projektu
5. **Katalogi `.opencode`** - agenci, polecenia, umiejętności
6. **Konfiguracja wbudowana** (zmienna `OPENCODE_CONFIG_CONTENT`) — nadpisanie środowiska uruchomieniowego
to, że konfiguracje projektu mogą być dostępne na poziomie globalnym konfiguracji, a konfiguracje globalne mogą być zdalne, zdalne konfiguracja organizacji.
Oznacza to, że konfiguracje projektu mogą nadpisywać konfiguracje globalne, a konfiguracje globalne mogą nadpisywać konfiguracje zdalne.
:::note
W katalogach `.opencode` i `~/.config/opencode` użytkownicy są **nazwy w zwykłej mnogiej** dla podkatalogów: `agents/`, `commands/`, `modes/`, `plugins/`, `skills/`, `tools/` i `themes/`. Nazwy wydane (np. `agent/`) są również objęte gwarancją kompatybilności wstecznej.
W katalogach `.opencode` i `~/.config/opencode` używane są **nazwy w liczbie mnogiej** dla podkatalogów: `agents/`, `commands/`, `modes/`, `plugins/`, `skills/`, `tools/` i `themes/`. Nazwy w liczbie pojedynczej (np. `agent/`) są również obsługiwane dla kompatybilności wstecznej.
:::
---
### Zdalny
### Zdalna
Organizacje mogą być podłączone do łączy końcowych `.well-known/opencode`. Jest pobierane automatycznie po uwierzytelnieniu u dostawcy, który obsługuje.
Organizacje mogą publikować konfigurację pod adresem `.well-known/opencode`. Jest ona pobierana automatycznie po uwierzytelnieniu u dostawcy, który obsługuje.
Zdalna jest ładowana jako pierwsza i podstawowa. Wszystkie inne źródła konfiguracji (globalne, projektowe) mogą zostać udostępnione menu.
Konfiguracja zdalna jest ładowana jako pierwsza i stanowi bazę. Wszystkie inne źródła konfiguracji (globalne, projektowe) mogą ją nadpisywać.
Na przykład, jeśli Twoja organizacja udostępnia serwery MCP, które są siecią internetową:
Na przykład, jeśli Twoja organizacja udostępnia serwery MCP, które są domyślnie wyłączone:
```json title="Remote config from .well-known/opencode"
{
@@ -77,7 +76,7 @@ Na przykład, jeśli Twoja organizacja udostępnia serwery MCP, które są sieci
}
```
Możesz udostępnić serwery w szczegółach:
Możesz włączyć serwer w konfiguracji projektu:
```json title="opencode.json"
{
@@ -93,68 +92,65 @@ Możesz udostępnić serwery w szczegółach:
---
### Światowy
### Globalna
Umieść swoją globalną konfigurację opencode w `~/.config/opencode/opencode.json`. przestrzeganie funkcji globalnej, aby uzyskać dostęp do całego użytkownika, takie jak motywy, dostawca lub skróty klawiszowe.
Umieść swoją globalną konfigurację OpenCode w `~/.config/opencode/opencode.json`. Użyj jej do ustawień ogólnych dla użytkownika, takich jak motywy, domyślny dostawca lub skróty klawiszowe.
Konfiguracja globalna zaawansowana, zdalne ustawienie konfiguracji.
Konfiguracja globalna ma pierwszeństwo przed konfiguracją zdalną.
---
### Projekt
Dodaj `opencode.json` w katalogu głównym projektu. Konfiguracja projektu ma priorytet wśród plików konfiguracyjnych — zaawansowane konfiguracje globalne i zdalne.
Dodaj `opencode.json` w katalogu głównym projektu. Konfiguracja projektu ma najwyższy priorytet wśród plików konfiguracyjnych — nadpisuje konfiguracje globalne i zdalne.
:::tip
Instalacja wstępna dla katalogu w katalogu.
Dodaj ten plik do kontroli wersji, aby udostępniać konfigurację zespołowi.
:::
Kiedy opencode się uruchomi, szuka pliku konfiguracyjnego w katalogu Git.
Kiedy OpenCode się uruchamia, szuka pliku konfiguracyjnego w katalogu głównym repozytorium Git.
Można również sprawdzić w Git i tego samego schematu, co globalny.
Może on być przechowywany w Git i mieć ten sam schemat, co konfiguracja globalna.
---
### Niestandardowa ścieżka
Niestandardowe rozwiązanie konfiguracyjne, różne opcje `OPENCODE_CONFIG`.
Możesz załadować niestandardowy plik konfiguracyjny, ustawiając zmienną środowiskową `OPENCODE_CONFIG`.
```bash
export OPENCODE_CONFIG=/path/to/my/custom-config.json
opencode run "Hello world"
```
Konfiguracja niestandardowa jest ładowana z konfiguracją globalną i konfiguracją projektu w kolejności pierwszych.
Konfiguracja niestandardowa jest ładowana po konfiguracji globalnej i przed konfiguracją projektu w kolejności priorytetów.
---
### Katalog niestandardowy
### Niestandardowy katalog
niestandardowy katalog konfiguracyjny za pomocą `OPENCODE_CONFIG_DIR`
zmienna środowiskowa. Katalog ten będzie przeszukiwany pod kątem agentów, ukryty,
tryby i wtyczki, tak jak standardowy katalog `.opencode` i powinienem
podążaj tą samą strukturą.
Możesz ustawić niestandardowy katalog konfiguracyjny za pomocą zmiennej środowiskowej `OPENCODE_CONFIG_DIR`. Katalog ten będzie przeszukiwany pod kątem agentów, poleceń, trybów i wtyczek, tak jak standardowy katalog `.opencode` i powinien zachować tę samą strukturę.
```bash
export OPENCODE_CONFIG_DIR=/path/to/my/config-directory
opencode run "Hello world"
```
Katalog niestandardowy jest ładowany po katalogach global config i `.opencode`, więc **może być połączony** z ich urządzeniami.
Katalog niestandardowy jest ładowany po globalnej konfiguracji i katalogach `.opencode`, więc **może być łączony** z ich zawartością.
---
## Schemat
Plik konfiguracyjny ma schemat końcowy w [**`opencode.ai/config.json`**](https://opencode.ai/config.json).
Plik konfiguracyjny ma schemat JSON dostępny pod adresem [**`opencode.ai/config.json`**](https://opencode.ai/config.json).
Twój edytor powinien mieć możliwość sprawdzania poprawności i autouzupełniania na podstawie schematu.
Twój edytor powinien zapewniać walidację i autouzupełnianie na podstawie tego schematu.
---
### TUI
Możliwość podłączenia urządzenia dla TUI za pomocą opcji `tui`.
Możesz skonfigurować zachowanie TUI za pomocą opcji `tui`.
```json title="opencode.json"
{
@@ -169,19 +165,19 @@ Możliwość podłączenia urządzenia dla TUI za pomocą opcji `tui`.
}
```
Dostępna opcja:
Dostępne opcje:
- `scroll_acceleration.enabled` - Włącz przyspieszenie przewijania w rysiku macOS. **Ma pierwszeństwo przed `scroll_speed`.**
- `scroll_speed` - Niestandardowy mnożnik szybkości przewijania (domyślnie: `3`, minimalnie: `1`). Ignorowane, jeśli `scroll_acceleration.enabled` do `true`.
- `diff_style` Sterowanie renderowaniem różnicowym. `"auto"` dostępny jest do szerokości terminala, `"stacked"` zawsze pojawia się pojedyncza kolumna.
- `scroll_acceleration.enabled` - Włącz przyspieszenie przewijania na gładzikach macOS. **Ma pierwszeństwo przed `scroll_speed`.**
- `scroll_speed` - Niestandardowy mnożnik szybkości przewijania (domyślnie: `3`, minimalnie: `1`). Ignorowane, jeśli `scroll_acceleration.enabled` ustawiono na `true`.
- `diff_style` Sterowanie renderowaniem różnic. `"auto"` przełącza się w zależności od szerokości terminala, `"stacked"` zawsze wymusza pojedynczą kolumnę.
[Dowiedz się więcej o korzystaniu z TUI tutaj](/docs/tui).
[Dowiedz się więcej o korzystaniu z TUI](/docs/tui).
---
### Serwer
### Server (Serwer)
Możliwość ustawienia serwera dla źródeł `opencode serve` i `opencode web` za pomocą opcji `server`.
Możesz skonfigurować serwer dla `opencode serve` i `opencode web` za pomocą opcji `server`.
```json title="opencode.json"
{
@@ -196,21 +192,21 @@ Możliwość ustawienia serwera dla źródeł `opencode serve` i `opencode web`
}
```
Dostępna opcja:
Dostępne opcje:
- `port` - Port do nasłuchiwania.
- `hostname` — nazwa hosta, która jest przeznaczona dla Ciebie. Gdy `mdns` jest połączony i nie jest ułożony inną nazwą hosta, jest połączony z `0.0.0.0`.
- `mdns` - Włącz wykrywanie usług mDNS. Dzięki temu zewnętrznemu urządzeniu w sieci może być przesyłany Twój serwer opencode.
- `mdnsDomain` - Niestandardowa nazwa domeny dla usług mDNS. Wartość domyślna do `opencode.local`. Przydatne do uruchomienia wielu zastosowań w tej samej sieci.
- `cors` - Dodatkowe źródło CORS podczas korzystania z serwera HTTP z punktu końcowego. Wartość musi być dostępna dla źródeł (schemat + host + port opcjonalny), np. `https://app.example.com`.
- `hostname` — Nazwa hosta, z którą należy się powiązać. Gdy `mdns` jest włączone i nie ustawiono innej nazwy hosta, domyślnie jest to `0.0.0.0`.
- `mdns` - Włącz wykrywanie usług mDNS. Dzięki temu inne urządzenia w sieci mogą łatwo znaleźć Twój serwer OpenCode.
- `mdnsDomain` - Niestandardowa nazwa domeny dla usług mDNS. Domyślnie `opencode.local`. Przydatne do uruchamiania wielu instancji w tej samej sieci.
- `cors` - Dozwolone źródła CORS podczas korzystania z serwera HTTP z przeglądarki. Wartość musi być listą źródeł (schemat + host + opcjonalny port), np. `https://app.example.com`.
[Dowiedz się więcej o tutaj](/docs/server).
[Dowiedz się więcej o serwerze](/docs/server).
---
### Narzędzia
### Tools (Narzędzia)
Dostępne narzędzia, z których można korzystać LLM, dostęp do opcji `tools`.
Kontroluj, które narzędzia są dostępne dla LLM, za pomocą opcji `tools`.
```json title="opencode.json"
{
@@ -222,13 +218,13 @@ Dostępne narzędzia, z których można korzystać LLM, dostęp do opcji `tools`
}
```
[Dowiedz się więcej o narzędziach tutaj](/docs/tools).
[Dowiedz się więcej o narzędziach](/docs/tools).
---
### Modele
### Models (Modele)
Możesz mieć dostawców i modele, które chcesz mieć w konfiguracji opencode, za pomocą opcji `provider`, `model` i `small_model`.
Możesz skonfigurować dostawców i modele, których chcesz używać, za pomocą opcji `provider`, `model` i `small_model`.
```json title="opencode.json"
{
@@ -239,9 +235,9 @@ Możesz mieć dostawców i modele, które chcesz mieć w konfiguracji opencode,
}
```
Opcja `small_model` konfiguruje oddzielny model do lekkich zadań, takich jak generowanie tytułów. Domyślnie opencode wyparte przez dostępny model, jeśli jest dostępny u dostawcy, w razie potrzeby powróć do innego modelu.
Opcja `small_model` konfiguruje oddzielny model do lżejszych zadań, takich jak generowanie tytułów. Domyślnie OpenCode wybiera tańszy model od tego samego dostawcy, jeśli jest dostępny, w przeciwnym razie powraca do modelu głównego.
Opcje dostawcy mogą być zainstalowane `timeout` i `setCacheKey`:
Opcje dostawcy mogą zawierać `timeout` i `setCacheKey`:
```json title="opencode.json"
{
@@ -257,20 +253,20 @@ Opcje dostawcy mogą być zainstalowane `timeout` i `setCacheKey`:
}
```
- `timeout` - Limit czasu trwania w milisekundach (domyślnie: 300000). Ustaw na `false`, aby wyłączyć.
- `setCacheKey` — wkrótce, że klucz pamięci podręcznej jest zawsze gotowy dla dostawcy.
- `timeout` - Limit czasu żądania w milisekundach (domyślnie: 300000). Ustaw na `false`, aby wyłączyć.
- `setCacheKey` — Wymuś ustawienie klucza pamięci podręcznej dla dostawcy.
Możesz także mieć [model lokalny](/docs/models#local). [Dowiedz się więcej](/docs/models).
Możesz także skonfigurować [modele lokalne](/docs/models#local). [Dowiedz się więcej o modelach](/docs/models).
---
#### Opcje specyficzne dla dostawców
inne udostępnienie dodatkowych możliwości wyposażenia poza urządzeniami `timeout` i `apiKey`.
Niektórzy dostawcy obsługują dodatkowe opcje konfiguracji poza `timeout` i `apiKey`.
##### Amazon Bedrock
Amazon Bedrock umożliwia podłączenie wyłącznika dla AWS:
Amazon Bedrock umożliwia konfigurację połączenia z AWS:
```json title="opencode.json"
{
@@ -287,21 +283,21 @@ Amazon Bedrock umożliwia podłączenie wyłącznika dla AWS:
}
```
- `region` — region AWS dla Bedrock (domyślnie jest do `AWS_REGION` env var lub `us-east-1`)
- `profile` - profil nazwany AWS z `~/.aws/credentials` (domyślnie `AWS_PROFILE` env var)
- `endpoint` — niestandardowy adres URL punktu końcowego dla punktów końcowych VPC. Jest to alias dla opcji ogólnej `baseURL` przy użyciu terminologii specjalnej dla AWS. Jeśli oba, pierwszeństwo ma `endpoint`.
- `region` — Region AWS dla Bedrock (domyślnie `AWS_REGION` env var lub `us-east-1`)
- `profile` - Nazwa profilu AWS z `~/.aws/credentials` (domyślnie `AWS_PROFILE` env var)
- `endpoint` — Niestandardowy adres URL punktu końcowego (np. dla punktów końcowych VPC). Jest to alias dla opcji ogólnej `baseURL` przy użyciu terminologii AWS. Jeśli podano oba, pierwszeństwo ma `endpoint`.
:::note
Token okaziciela (`AWS_BEARER_TOKEN_BEDROCK` lub `/connect`) ma pierwszeństwo przed uwierzytelnianiem opartym na profilu. Aby uzyskać szczegółowe informacje, zobacz [pierwszeństwo uwierzytelniania](/docs/providers#authentication-precedence).
:::
[Dowiedz się więcej o budowie Amazon Bedrock](/docs/providers#amazon-bedrock).
[Dowiedz się więcej o Amazon Bedrock](/docs/providers#amazon-bedrock).
---
### Motywy
### Theme (Motyw)
Urządzenie zachęcające do korzystania z urządzeń opencode, za pomocą sieci `theme`.
Skonfiguruj motyw interfejsu OpenCode za pomocą opcji `theme`.
```json title="opencode.json"
{
@@ -310,13 +306,13 @@ Urządzenie zachęcające do korzystania z urządzeń opencode, za pomocą sieci
}
```
[Dowiedz się więcej tutaj](/docs/themes).
[Dowiedz się więcej o motywach](/docs/themes).
---
### Agenci
### Agents (Agenci)
Możliwość dostępności agentów do gniazd za pomocą opcji `agent`.
Możesz zdefiniować i skonfigurować agentów za pomocą opcji `agent`.
```jsonc title="opencode.jsonc"
{
@@ -336,13 +332,13 @@ Możliwość dostępności agentów do gniazd za pomocą opcji `agent`.
}
```
Możesz także uniknąć agentów przy użyciu plików przecen w `~/.config/opencode/agents/` lub `.opencode/agents/`. [Dowiedz się więcej tutaj](/docs/agents).
Możesz także definiować agentów przy użyciu plików markdown w `~/.config/opencode/agents/` lub `.opencode/agents/`. [Dowiedz się więcej o agentach](/docs/agents).
---
### Domyślny agent
### Default Agent (Domyślny agent)
Domyślnego agenta można ustawić za pomocą opcji `default_agent`. Wykrywacz, który jest używany, jeśli nie został ujawniony.
Domyślnego agenta można ustawić za pomocą opcji `default_agent`. Określa to agenta, który jest używany, jeśli nie wybrano żadnego innego.
```json title="opencode.json"
{
@@ -351,15 +347,15 @@ Domyślnego agenta można ustawić za pomocą opcji `default_agent`. Wykrywacz,
}
```
Agent domyślny musi być agentem (nie subagentem). Może być agentem aplikacji, taki jak `"build"` lub `"plan"`, albo ukryty przez Ciebie [agent niestandardowy](/docs/agents). Jeśli agent nie istnieje lub jest podagentem, opencode powróć do `"build"` z ostrzeżeniem.
Agent domyślny musi być agentem typu `primary` (nie `subagent`). Może to być agent wbudowany, taki jak `"build"` lub `"plan"`, albo zdefiniowany przez Ciebie [agent niestandardowy](/docs/agents). Jeśli agent nie istnieje lub jest subagentem, OpenCode powróci do `"build"` z ostrzeżeniem.
Dotyczy urządzeń wszystkich interfejsów: TUI, CLI (`opencode run`), aplikacji komputerowej i akcji GitHub.
Dotyczy to wszystkich interfejsów: TUI, CLI (`opencode run`), aplikacji desktopowej i GitHub Actions.
---
### Udostępnianie
### Share (Udostępnianie)
Możesz udostępnić [udostępnij](/docs/share) za pomocą opcji `share`.
Możesz skonfigurować [udostępnianie](/docs/share) za pomocą opcji `share`.
```json title="opencode.json"
{
@@ -368,19 +364,19 @@ Możesz udostępnić [udostępnij](/docs/share) za pomocą opcji `share`.
}
```
Działaj:
Opcje:
- `"manual"` Zezwalaj na ręczne korzystanie z pomocy narzędzi (domyślnie)
- `"manual"` Zezwalaj na ręczne udostępnianie (domyślnie)
- `"auto"` - Automatycznie udostępniaj nowe rozmowy
- `"disabled"` - Całkowicie udostępnienie
- `"disabled"` - Całkowicie wyłącz udostępnianie
Domyślnie jest rozwiązaniem na tryb manualny, w którym należy jawnie udostępniać rozmowy za pomocą polecenia `/share`.
Domyślnie ustawiony jest tryb ręczny, w którym należy jawnie udostępniać rozmowy za pomocą polecenia `/share`.
---
### Polecenia
### Commands (Polecenia)
Możesz korzystać z usług polecanych dla powtarzalnych zadań za pomocą opcji `command`.
Możesz zdefiniować niestandardowe polecenia dla powtarzalnych zadań za pomocą opcji `command`.
```jsonc title="opencode.jsonc"
{
@@ -400,13 +396,13 @@ Możesz korzystać z usług polecanych dla powtarzalnych zadań za pomocą opcji
}
```
Można także definiować polecenia przy użyciu plików Markdown w `~/.config/opencode/commands/` lub `.opencode/commands/`. [Dowiedz się więcej tutaj](/docs/commands).
Możesz także definiować polecenia przy użyciu plików Markdown w `~/.config/opencode/commands/` lub `.opencode/commands/`. [Dowiedz się więcej o poleceniach](/docs/commands).
---
### Keybinds
### Keybinds (Skróty klawiszowe)
Możliwość zmiany skrótu klawiszowego za pomocą opcji `keybinds`.
Możesz dostosować skróty klawiszowe za pomocą opcji `keybinds`.
```json title="opencode.json"
{
@@ -415,13 +411,13 @@ Możliwość zmiany skrótu klawiszowego za pomocą opcji `keybinds`.
}
```
[Dowiedz się więcej tutaj](/docs/keybinds).
[Dowiedz się więcej o skrótach klawiszowych](/docs/keybinds).
---
### Automatyczna aktualizacja
### Autoupdate (Automatyczna aktualizacja)
opencode automatycznie pobierze każde nowe uruchomienie. Można skorzystać z opcji `autoupdate`.
OpenCode może automatycznie pobierać nowe wersje. Możesz to kontrolować za pomocą opcji `autoupdate`.
```json title="opencode.json"
{
@@ -430,14 +426,14 @@ opencode automatycznie pobierze każde nowe uruchomienie. Można skorzystać z o
}
```
Jeśli nie chcesz aktualizacji, ale chcesz podłączyć nową wersję, ustaw `autoupdate` na `"notify"`.
Działa tylko wtedy, gdy nie jest uruchamiana przy użyciu menedżera pakietów, jak Homebrew.
Jeśli nie chcesz automatycznych aktualizacji, ale chcesz być powiadamiany o nowych wersjach, ustaw `autoupdate` na `"notify"`.
Działa to tylko wtedy, gdy OpenCode nie został zainstalowany przez menedżera pakietów, takiego jak Homebrew.
---
### Formattery
### Formatters (Formatery)
Można podać kod formacyjny za pomocą opcji `formatter`.
Możesz skonfigurować formatery kodu za pomocą opcji `formatter`.
```json title="opencode.json"
{
@@ -457,15 +453,15 @@ Można podać kod formacyjny za pomocą opcji `formatter`.
}
```
[Dowiedz się więcej o formaterach tutaj](/docs/formatters).
[Dowiedz się więcej o formaterach](/docs/formatters).
---
### Uprawnienia
### Permissions (Uprawnienia)
Domyślnie opencode **zezwala na wszystkie działania** bez konieczności posiadania zgody. Można zmienić opcję `permission`.
Domyślnie OpenCode **zezwala na wszystkie działania** bez konieczności zatwierdzania. Możesz to zmienić za pomocą opcji `permission`.
Na przykład, aby można było wykryć, że narzędzie `edit` i `bash` wymaga zgody użytkownika:
Na przykład, aby wymagać zatwierdzenia dla narzędzi `edit` i `bash`:
```json title="opencode.json"
{
@@ -477,13 +473,13 @@ Na przykład, aby można było wykryć, że narzędzie `edit` i `bash` wymaga zg
}
```
[Dowiedz się więcej o prawach tutaj](/docs/permissions).
[Dowiedz się więcej o uprawnieniach](/docs/permissions).
---
### Zagęszczanie
### Compaction (Kompaktowanie)
Możesz kontrolować zachowanie zagęszczania kontekstu za pomocą opcji `compaction`.
Możesz kontrolować zachowanie kompaktowania kontekstu za pomocą opcji `compaction`.
```json title="opencode.json"
{
@@ -496,13 +492,13 @@ Możesz kontrolować zachowanie zagęszczania kontekstu za pomocą opcji `compac
```
- `auto` - Automatycznie kompaktuj, gdy kontekst jest pełny (domyślnie: `true`).
- `prune` - Usuń stare dane narzędzia, aby zapisać tokeny (domyślnie: `true`).
- `prune` - Usuń stare wyniki narzędzi, aby zaoszczędzić tokeny (domyślnie: `true`).
---
### Obserwator
### Watcher (Obserwator)
Rejestracja wzorca plików za pomocą `watcher`.
Skonfiguruj ignorowane wzorce plików dla obserwatora plików za pomocą `watcher`.
```json title="opencode.json"
{
@@ -513,13 +509,13 @@ Rejestracja wzorca plików za pomocą `watcher`.
}
```
Wzorce są zgodne ze składnią glob. Dostęp tej opcji, aby móc zaszumione katalogi z plikami do przeglądania.
Wzorce są zgodne ze składnią glob. Użyj tej opcji, aby wykluczyć często zmieniające się lub duże katalogi z monitorowania.
---
### Serwery MCP
### MCP Servers (Serwery MCP)
Dostęp do serwerów MCP, których chcesz używać, za pośrednictwem sieci `mcp`.
Skonfiguruj serwery MCP, których chcesz używać, za pomocą opcji `mcp`.
```json title="opencode.json"
{
@@ -528,15 +524,15 @@ Dostęp do serwerów MCP, których chcesz używać, za pośrednictwem sieci `mcp
}
```
[Dowiedz się więcej tutaj](/docs/mcp-servers).
[Dowiedz się więcej o serwerach MCP](/docs/mcp-servers).
---
### Wtyczki
### Plugins (Wtyczki)
[Wtyczki](/docs/plugins) rozszerzają opencode o podstawowe narzędzia, hooki i integracje.
[Wtyczki](/docs/plugins) rozszerzają OpenCode o niestandardowe narzędzia, hooki i integracje.
Pliki plików wtyczek w `.opencode/plugins/` lub `~/.config/opencode/plugins/`. Można także włączyć wtyczkę z npm poprzez opcję `plugin`.
Umieść pliki wtyczek w `.opencode/plugins/` lub `~/.config/opencode/plugins/`. Możesz także załadować wtyczkę z npm za pomocą opcji `plugin`.
```json title="opencode.json"
{
@@ -545,13 +541,13 @@ Pliki plików wtyczek w `.opencode/plugins/` lub `~/.config/opencode/plugins/`.
}
```
[Dowiedz się więcej tutaj](/docs/plugins).
[Dowiedz się więcej o wtyczkach](/docs/plugins).
---
### Instructions
### Instructions (Instrukcje)
Instrukcja dla modelu, w której można zastosować opcję `instructions`.
Określ pliki instrukcji dla modelu, używając opcji `instructions`.
```json title="opencode.json"
{
@@ -560,14 +556,13 @@ Instrukcja dla modelu, w której można zastosować opcję `instructions`.
}
```
Pobierana do schematów i wzorców globalnych do plików graficznych. [Dowiedz się więcej
o zasadach tutaj](/docs/rules).
Załadowane pliki są dołączane do promptu systemowego. Obsługuje wzorce glob. [Dowiedz się więcej o zasadach](/docs/rules).
---
### Wyłączeni dostawcy
### Disabled Providers (Wyłączeni dostawcy)
Zasilacz ładowany automatycznie za pomocą zasilacza `disabled_providers`. Jest to możliwe, gdy istnieje możliwość podłączenia ładowania niektórych dostawców, nawet jeśli dane uwierzytelniające są dostępne.
Zapobiegaj automatycznemu ładowaniu dostawców za pomocą opcji `disabled_providers`. Jest to przydatne, gdy chcesz wyłączyć niektórych dostawców, nawet jeśli masz dla nich dane uwierzytelniające.
```json title="opencode.json"
{
@@ -577,20 +572,20 @@ Zasilacz ładowany automatycznie za pomocą zasilacza `disabled_providers`. Jest
```
:::note
`disabled_providers` pierwszeństwo przed `enabled_providers`.
`disabled_providers` ma pierwszeństwo przed `enabled_providers`.
:::
Opcja `disabled_providers` analiza tablica identyfikatorów dostawców. Gdy dostawca jest wyłączony:
Opcja `disabled_providers` przyjmuje tablicę identyfikatorów dostawców. Gdy dostawca jest wyłączony:
- Nie istnieje możliwość wystąpienia zagrożenia, które jest możliwe do zastosowania.
- Nie nastąpi uruchomienie, nawet jeśli klucz API zostanie uruchomiony za pomocą polecenia `/connect`.
- Model dostawcy nie pojawia się na liście wyboru modeli.
- Nie zostanie załadowany podczas startu.
- Nie zostanie załadowany, nawet jeśli podasz klucz API za pomocą `/connect`.
- Modele tego dostawcy nie pojawią się na liście wyboru modeli.
---
### Włączeni dostawcy
### Enabled Providers (Włączeni dostawcy)
Można znaleźć dostawców za pomoc `enabled_providers`. Po ustawieniu włączeni tylko dostawcy, a wszyscy będą obecni.
Możesz określić listę dozwolonych dostawców za pomocą `enabled_providers`. Po ustawieniu, tylko wymienieni dostawcy będą ładowani.
```json title="opencode.json"
{
@@ -599,19 +594,19 @@ Można znaleźć dostawców za pomoc `enabled_providers`. Po ustawieniu włącze
}
```
Jest to urządzenie, gdy urządzenie opencode jest używane tylko z urządzeniami, zamiast odłączać ich jedno po drugim.
Jest to przydatne, gdy chcesz ograniczyć użycie OpenCode tylko do określonych dostawców.
:::note
`disabled_providers` pierwszeństwo przed `enabled_providers`.
`disabled_providers` ma pierwszeństwo przed `enabled_providers`.
:::
Jeśli obowiązująsz w `enabled_providers`, jak i `disabled_providers`, `disabled_providers` pierwszeństwo ze względu na kompatybilność wsteczną.
Jeśli dostawca jest wymieniony zarówno w `enabled_providers`, jak i `disabled_providers`, `disabled_providers` wygrywa.
---
### Eksperymentalny
### Experimental (Eksperymentalne)
Klucz `experimental` zawiera opcje, które są początkiem rozwoju.
Klucz `experimental` zawiera opcje, które są we wczesnej fazie rozwoju.
```json title="opencode.json"
{
@@ -621,20 +616,20 @@ Klucz `experimental` zawiera opcje, które są początkiem rozwoju.
```
:::caution
Opcje eksperymentalne nie są awaryjne. Jedna zmiana lub zmiana bez zniszczenia.
Opcje eksperymentalne nie są stabilne. Mogą ulec zmianie lub zostać usunięte bez ostrzeżenia.
:::
---
## Zmienne
Możliwość wykorzystania danych zmiennych w plikach konfiguracyjnych, aby odwoływać się do zmiennych zewnętrznych i zawartości plików.
Możesz używać specjalnej składni w plikach konfiguracyjnych, aby odwoływać się do zmiennych środowiskowych i zawartości plików.
---
### Env vars
### Env vars (Zmienne środowiskowe)
zastosowanie `{env:VARIABLE_NAME}`, aby zakończyć zmiennego przebiegu:
Użyj `{env:VARIABLE_NAME}`, aby wstawić wartość zmiennej środowiskowej:
```json title="opencode.json"
{
@@ -651,13 +646,13 @@ zastosowanie `{env:VARIABLE_NAME}`, aby zakończyć zmiennego przebiegu:
}
```
Jeżeli zmienna kontrolna nie jest skonfigurowana, należy zastosować do niej pusty ciąg znaków.
Jeśli zmienna środowiskowa nie jest ustawiona, zostanie zastąpiona pustym ciągiem.
---
### Pliki
### Files (Pliki)
źródło `{file:path/to/file}`, aby znaleźć zawartość pliku:
Użyj `{file:path/to/file}`, aby wstawić zawartość pliku:
```json title="opencode.json"
{
@@ -675,11 +670,11 @@ Jeżeli zmienna kontrolna nie jest skonfigurowana, należy zastosować do niej p
Ścieżki plików mogą być:
- Względem katalogu konfiguracyjnego
- Lub nadrzędne kierowane się od `/` lub `~`
- Względne do pliku konfiguracyjnego
- Lub absolutne, zaczynające się od `/` lub `~`
Sądzimy, że:
Zalecamy używanie tego do:
- Przechowywanie wrażliwych danych, takich jak klucze API, w oddzielnych plikach.
- Do udostępnienia dużych plików bez zaśmiecania konstrukcji.
- Udostępnianie fragmentów konfiguracji w wielu plikach konfiguracyjnych.
- Przechowywania wrażliwych danych, takich jak klucze API, w oddzielnych plikach.
- Ładowania dużych promptów bez zaśmiecania konfiguracji.
- Dzielenia fragmentów konfiguracji między wieloma plikami.

View File

@@ -7,7 +7,7 @@ Narzędzia stosowane do funkcji, z których LLM może korzystać podczas rozmów
---
## Narzędzie do tworzenia
## Tworzenie narzędzia
Narzędzia tworzą pliki **TypeScript** lub **JavaScript**. Definicja narzędzia może być odwoływana do skryptów napisanych w **dowolnym języku** — TypeScript lub JavaScript są używane tylko w tym samym narzędziu.
@@ -79,7 +79,7 @@ Tworzy do dwóch narzędzi: `math_add` i `math_multiply`.
---
### Argumentacja
### Argumenty
Do zdefiniowania argumentów można zastosować `tool.schema`, czyli po prostu [Zod](https://zod.dev).

View File

@@ -1,62 +1,62 @@
---
title: Formatery
description: opencode używa formaterów specyficznych dla języka.
description: OpenCode używa formaterów specyficznych dla języka.
---
opencode automatycznie formatuje pliki po ich zapisaniu lub edycję przy użyciu formaterów przesyłanych dla języka. Dzięki temu wygenerowany kod będzie używany ze stylami kodu Twojego projektu.
OpenCode automatycznie formatuje pliki po ich zapisaniu lub edycji przy użyciu formaterów specyficznych dla języka. Zapewnia to, że wygenerowany kod jest zgodny ze stylem kodu Twojego projektu.
---
## Wbudowany
## Wbudowane
opencode zawiera kilka wbudowanych formaterów dla nauki języków i frameworków. Zawiera listę formaterów, rozszerzonych plików oraz rozszerzenia i konfiguratory, których potrzebujesz.
OpenCode zawiera kilka wbudowanych formaterów dla popularnych języków i frameworków. Poniższa tabela zawiera listę formaterów, obsługiwanych plików oraz wymagań konfiguracyjnych.
| Formater | Rozszerzenia | Wymagania |
| ----------------------- | ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| gofmt | .idź | Komenda `gofmt` dostępna |
| ryzyko | .ex, .exs, .eex, .heex, .leex, .neex, .sface | Komenda `mix` dostępna |
| ładniejsza | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml i [więcej](https://prettier.io/docs/en/index.html) | Zależność `prettier` w `package.json` |
| biom | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml i [więcej](https://biomejs.dev/) | `biome.json(c)` plik konfiguracyjny |
| zyg | .zig, .zon | Komenda `zig` dostępna |
| formatuj brzęk | .c, .cpp, .h, .hpp, .ino i [więcej](https://clang.llvm.org/docs/ClangFormat.html) | `.clang-format` plik konfiguracyjny |
| ktlint | .kt, .kts | Komenda `ktlint` dostępna |
| kryza | .py, .pyi | Komenda `ruff` dostępna w konstrukcji |
| rustfmt | .rs | Komenda `rustfmt` dostępna |
| załadunek | .rs | Komenda `cargo fmt` dostępna |
| UV | .py, .pyi | Komenda `uv` dostępna |
| rubocop | .rb, .rake, .gemspec, .ru | Komenda `rubocop` dostępna |
| standardowe | .rb, .rake, .gemspec, .ru | Komenda `standardrb` dostępna |
| htmlupiększacz | .erb, .html.erb | Komenda `htmlbeautifier` dostępna |
| powietrze | .R | Komenda `air` dostępna |
| strzałka | .dart | Komenda `dart` dostępna |
| formatuj ocaml | .ml, .mli | Dostępna opcja `ocamlformat` i plik konfiguracyjny `.ocamlformat` |
| terraforma | .tf, .tfvars | Komenda `terraform` dostępna |
| blask | .blask | Komenda `gleam` dostępna |
| nixfmt | .nix | Komenda `nixfmt` dostępna |
| shfmt | .sh, .bash | Komenda `shfmt` dostępna |
| kufel | .php | Zależność `laravel/pint` w `composer.json` |
| oxfmt (eksperymentalny) | .js, .jsx, .ts, .tsx | wykonanie `oxfmt` w `package.json` i [flaga eksperymentalna zmienna env](/docs/cli/#experimental) |
| ormolu | .hs | Komenda `ormolu` dostępna |
| Formater | Rozszerzenia | Wymagania |
| -------------------- | ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| gofmt | .go | Dostępne polecenie `gofmt` |
| mix | .ex, .exs, .eex, .heex, .leex, .neex, .sface | Dostępne polecenie `mix` |
| prettier | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml i [więcej](https://prettier.io/docs/en/index.html) | Zależność `prettier` w `package.json` |
| biome | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml i [więcej](https://biomejs.dev/) | Plik konfiguracyjny `biome.json(c)` |
| zig | .zig, .zon | Dostępne polecenie `zig` |
| clang-format | .c, .cpp, .h, .hpp, .ino i [więcej](https://clang.llvm.org/docs/ClangFormat.html) | Plik konfiguracyjny `.clang-format` |
| ktlint | .kt, .kts | Dostępne polecenie `ktlint` |
| ruff | .py, .pyi | Dostępne polecenie `ruff` |
| rustfmt | .rs | Dostępne polecenie `rustfmt` |
| cargo | .rs | Dostępne polecenie `cargo fmt` |
| uv | .py, .pyi | Dostępne polecenie `uv` |
| rubocop | .rb, .rake, .gemspec, .ru | Dostępne polecenie `rubocop` |
| standardrb | .rb, .rake, .gemspec, .ru | Dostępne polecenie `standardrb` |
| htmlbeautifier | .erb, .html.erb | Dostępne polecenie `htmlbeautifier` |
| air | .R | Dostępne polecenie `air` |
| dart | .dart | Dostępne polecenie `dart` |
| ocamlformat | .ml, .mli | Dostępne polecenie `ocamlformat` i plik konfiguracyjny `.ocamlformat` |
| terraform | .tf, .tfvars | Dostępne polecenie `terraform` |
| gleam | .gleam | Dostępne polecenie `gleam` |
| nixfmt | .nix | Dostępne polecenie `nixfmt` |
| shfmt | .sh, .bash | Dostępne polecenie `shfmt` |
| pint | .php | Zależność `laravel/pint` w `composer.json` |
| oxfmt (experimental) | .js, .jsx, .ts, .tsx | Zależność `oxfmt` w `package.json` i [eksperymentalna flaga](/docs/cli/#experimental) |
| ormolu | .hs | Dostępne polecenie `ormolu` |
Jeśli więc Twój projekt zawiera `prettier` w `package.json`, opencode automatycznie przejdź do podmiote.
Jeśli więc Twój projekt zawiera `prettier` w `package.json`, OpenCode automatycznie go użyje.
---
## Jak to działa
Kiedy opencode zapisuje lub edytuje plik:
Kiedy OpenCode zapisuje lub edytuje plik:
1. Badanie pliku dotyczącego wszystkich danych formaterów.
2. Uruchamia decyzje wykonawcze formatujące na plik.
1. Sprawdza plik pod kątem wszystkich dostępnych formaterów.
2. Uruchamia odpowiedni formater na pliku.
3. Automatycznie stosuje zmiany formatowania.
Dziesięć procesów zachodzi w tle, konieczne jest zachowanie stylów kodu bez konieczności wykonania czynności czynnościowych.
Ten proces odbywa się w tle, zapewniając spójność stylu kodu bez konieczności ręcznej interwencji.
---
## Skonfiguruj
## Konfiguracja
Można dostosować formatery za pomocą sekcji `formatter` w konstrukcji opencode.
Możesz dostosować formatery za pomocą sekcji `formatter` w konfiguracji OpenCode.
```json title="opencode.json"
{
@@ -65,14 +65,14 @@ Można dostosować formatery za pomocą sekcji `formatter` w konstrukcji opencod
}
```
obsługiwane formatyzator Zobacz elementy:
Każdy formater obsługuje następujące właściwości:
| Nieruchomość | Wpisz | Opis |
| ------------- | -------- | -------------------------------------------------------------------------- |
| `disabled` | boolean | Ustaw tę opcję na `true`, aby wyłączyć formater |
| `command` | string[] | Polecenie uruchomienia formatowania |
| `environment` | object | Zmienne ustawienia do ustawień podczas uruchamiania programu formatującego |
| `extensions` | string[] | Rozszerzenia plików, które powinny opuścić ten formater |
| Właściwość | Typ | Opis |
| ------------- | -------- | -------------------------------------------------------- |
| `disabled` | boolean | Ustaw na `true`, aby wyłączyć ten formater |
| `command` | string[] | Polecenie uruchomienia formatera |
| `environment` | object | Zmienne środowiskowe ustawiane podczas uruchamiania |
| `extensions` | string[] | Rozszerzenia plików, które powinny używać tego formatera |
Spójrzmy na kilka przykładów.
@@ -106,7 +106,7 @@ Aby wyłączyć **określony** formater, ustaw `disabled` na `true`:
### Niestandardowe formatery
Może wystąpić, gdyby nastąpiło nowe, uruchomienie, zmienne udostępnienie i udostępnienie plików:
Możesz dodać niestandardowe formatery, podając polecenie, zmienne środowiskowe i rozszerzenia plików:
```json title="opencode.json" {4-14}
{
@@ -127,4 +127,4 @@ Może wystąpić, gdyby nastąpiło nowe, uruchomienie, zmienne udostępnienie i
}
```
Symbol zastępczy **`$FILE`** w poleceniu pochodziony z formatowanego pliku.
Symbol zastępczy **`$FILE`** w poleceniu jest zastępowany ścieżką do formatowanego pliku.

View File

@@ -1,5 +1,5 @@
---
title: Intro
title: Wstęp
description: Zacznij pracę z opencode.
---
@@ -7,7 +7,7 @@ import { Tabs, TabItem } from "@astrojs/starlight/components"
import config from "../../../../config.mjs"
export const console = config.console
[**opencode**](/) to open source AI coding agent. Jest dostępny jako interfejs terminalowy, aplikacja desktopowa i rozszerzenie IDE.
[**opencode**](/) to agent kodujący AI typu open source. Jest dostępny jako interfejs terminalowy, aplikacja desktopowa i rozszerzenie IDE.
![opencode TUI z motywem opencode](../../../assets/lander/screenshot.png)
@@ -89,8 +89,8 @@ Możesz też użyć poniższych metod instalacji:
#### Windows
:::tip[Zalecane: prowadzenie WSL]
Aby najlepiej wykorzystać działanie w systemie Windows, zalecamy udostępnienie [Podsystemu Windows dla systemu Linux (WSL)](/docs/windows-wsl). pozwolenie na użytkowanie i pełna kompatybilność z funkcjami opencode.
:::tip[Zalecane: Uruchamianie w WSL]
Aby najlepiej wykorzystać działanie w systemie Windows, zalecamy włączenie [Podsystemu Windows dla systemu Linux (WSL)](/docs/windows-wsl). Zapewnia to pełną kompatybilność z funkcjami opencode.
:::
- **Używając Chocolatey**
@@ -123,21 +123,20 @@ Aby najlepiej wykorzystać działanie w systemie Windows, zalecamy udostępnieni
docker run -it --rm ghcr.io/anomalyco/opencode
```
Obecnie trwają prace nad instalacją opencode w systemie Windows za pomocą Bun.
Obecnie pracujemy nad instalacją opencode w systemie Windows za pomocą Bun.
Możesz także otrzymać plik binarny z [Releases](https://github.com/anomalyco/opencode/releases).
Możesz także pobrać plik binarny z [Releases](https://github.com/anomalyco/opencode/releases).
---
## Skonfiguruj
## Konfiguracja
Dzięki opencode możesz korzystać z dowolnego dostawcy LLM, konfigurując jego klucze API.
Jeśli nadal będziesz korzystać z dostawców LLM, zalecamy skorzystanie z [OpenCode Zen](/docs/zen).
Do wyselekcjonowanej listy modeli, które zostały zatwierdzone i zweryfikowane przez opencode
zespół.
Jeśli będziesz korzystać z wielu dostawców LLM, zalecamy skorzystanie z [OpenCode Zen](/docs/zen).
Aby uzyskać dostęp do wyselekcjonowanej listy modeli, które zostały zatwierdzone i zweryfikowane przez zespół opencode.
1. Uruchom opcję `/connect` w TUI, wybierz opencode i przejdź do [opencode.ai/auth](https://opencode.ai/auth).
1. Uruchom polecenie `/connect` w TUI, wybierz opencode i przejdź do [opencode.ai/auth](https://opencode.ai/auth).
```txt
/connect
@@ -158,55 +157,50 @@ Alternatywnie możesz wybrać jednego z dodatkowych dostawców. [Dowiedz się wi
---
## Zainicjuj
## Inicjalizacja
Po skonfigurowaniu dostawcy, który może przejść do projektu, który
chcesz pracować.
Po skonfigurowaniu dostawcy możesz przejść do projektu, nad którym chcesz pracować.
```bash
cd /path/to/project
```
Uruchamiam opencode.
Uruchom opencode.
```bash
opencode
```
Następnie zainicjuj opencode dla projektu, uruchamiając odpowiednią instrukcję.
Następnie zainicjuj opencode dla projektu, uruchamiając odpowiednie polecenie.
```bash frame="none"
/init
```
Spowoduje to, że opencode przeanalizuje Twój projekt i utworzy plik `AGENTS.md`
katalog główny projektu.
Spowoduje to, że opencode przeanalizuje Twój projekt i utworzy plik `AGENTS.md` w katalogu głównym projektu.
:::tip
Powinieneś zatwierdzić plik `AGENTS.md` swojego projektu w Git.
Powinieneś zacommitować plik `AGENTS.md` swojego projektu w Git.
:::
Pomaga w opencode zrozumieniu struktury projektu i wzorce kodowania
używany.
Pomaga to opencode zrozumieć strukturę projektu i stosowane wzorce kodowania.
---
## Użycie
Teraz możesz pracować nad swoim projektem. Możesz o to zapytać
wszystko!
Teraz możesz pracować nad swoim projektem. Możesz zapytać o wszystko!
Jeśli tylko zaczniesz korzystać z agenta kodującego AI, oto kilka, które mogą być używane
pomoc.
Jeśli dopiero zaczynasz korzystać z agenta kodującego AI, oto kilka wskazówek, które mogą być pomocne.
---
### Zadawaj pytania
Możesz uruchomić opencode o wyjaśnienie bazy kodu.
Możesz poprosić opencode o wyjaśnienie bazy kodu.
:::tip
klawisza klawisza `@` do wyszukiwania rozmytego plików w projekcie.
Użyj `@` do wyszukiwania rozmytego plików w projekcie.
:::
```txt frame="none" "@packages/functions/src/api/index.ts"
@@ -219,20 +213,20 @@ Jest to pomocne, jeśli istnieje część bazy kodu, nad którą nie pracowałe
### Dodaj funkcje
Możesz zastosować opencode o nowej funkcji do Twojego projektu. Najpierw zalecamy poproszenie o wypłacenie planu.
Możesz poprosić opencode o dodanie nowej funkcji do Twojego projektu. Najpierw zalecamy poproszenie o przygotowanie planu.
1. **Plan Stworza**
1. **Stwórz Plan**
opencode ma _Plan Mode_, który umożliwia wyłączenie zmian i
zamiast tego zasugeruj, jak\_ zaimplementuje tę funkcję.
zamiast tego zasugeruje, jak zaimplementować tę funkcję.
Przejdź do niego za pomocą klawisza **Tab**. W osobnym dolnym rogu zobacz właściwy wskaźnik.
Przejdź do niego za pomocą klawisza **Tab**. Zobaczysz odpowiedni wskaźnik w prawym dolnym rogu.
```bash frame="none" title="Switch to Plan mode"
<TAB>
```
Opiszmy teraz, co chcemy, żeby robił.
Opiszmy teraz, co chcemy, żeby zrobił.
```txt frame="none"
When a user deletes a note, we'd like to flag it as deleted in the database.
@@ -240,17 +234,16 @@ Możesz zastosować opencode o nowej funkcji do Twojego projektu. Najpierw zalec
From this screen, the user can undelete a note or permanently delete it.
```
Wersja opencode zawiera dużo oprogramowania, aby zrozumieć, czego chcesz. To pomaga
Wersja opencode jest bardzo inteligentna, aby zrozumieć, czego chcesz. To pomaga
rozmawiaj z nim tak, jakbyś rozmawiał z młodszym programistą w swoim zespole.
:::tip
Podaj opencode kontekstu i kontekstu, które można zrozumi, co Ty
chcieć.
Podaj opencode kontekst, aby zrozumi, czego chcesz.
:::
2. **Postęp zgodnie z planem**
2. **Udoskonalanie planu**
Gdy będziesz mieć plan, możesz pozostawić go lub podłączyć więcej.
Gdy będziesz mieć plan, możesz zostawić go lub dodać więcej.
```txt frame="none"
We'd like to design this new screen using a design I've used before.
@@ -261,18 +254,17 @@ Możesz zastosować opencode o nowej funkcji do Twojego projektu. Najpierw zalec
Przeciągnij i upuść obrazy do terminala, aby dodać je do monitu.
:::
opencode może zeskanować obrazy, które mu przekażesz i poprosisz o potwierdzenie. Możesz
należy to, przeciągając i upuszczając obraz do terminala.
opencode może zeskanować obrazy, które mu przekażesz i zrozumieć je. Możesz to zrobić, przeciągając i upuszczając obraz do terminala.
3. **Stwórz przełącza**
3. **Wprowadź zmiany**
Kiedy już jest komfortowo z planem, przełącz się z powrotem do _Act Mode_ na klawisza **Tab**.
Kiedy już będziesz zadowolony z planu, przełącz się z powrotem do _Act Mode_ naciskając klawisz **Tab**.
```bash frame="none"
<TAB>
```
Poproszę o wprowadzenie zmian.
Poproś o wprowadzenie zmian.
```bash frame="none"
Sounds good! Go ahead and make the changes.
@@ -282,8 +274,7 @@ Możesz zastosować opencode o nowej funkcji do Twojego projektu. Najpierw zalec
### Wprowadź zmiany
Aby zastosować następczą zmianę, można zastosować opencode lub bezpośrednio zbudowanie go
bez konieczności wcześniejszego przeglądania planu.
Aby wprowadzić kolejną zmianę, możesz poprosić opencode lub zrobić to bezpośrednio bez konieczności wcześniejszego przeglądania planu.
```txt frame="none" "@packages/functions/src/settings.ts" "@packages/functions/src/notes.ts"
We need to add authentication to the /settings route. Take a look at how this is
@@ -291,8 +282,7 @@ handled in the /notes route in @packages/functions/src/notes.ts and implement
the same logic in @packages/functions/src/settings.ts
```
Musisz mieć dostęp, że pod warunkiem dostępności narzędzia, więc opencode ma właściwie
zmiany.
Musisz upewnić się, że dostarczyłeś odpowiednie pliki, aby opencode mógł wprowadzić zmiany.
---
@@ -304,27 +294,26 @@ Załóżmy, że prosisz opencode o wprowadzenie zmian.
Can you refactor the function in @packages/functions/src/api/index.ts?
```
Ale z sobie sobie sprawę, że to nie jest to, czego chciałeś. **Możesz być** zmiany
za pomoc polecenia `/undo`.
Ale zdajesz sobie sprawę, że to nie jest to, czego chciałeś. **Możesz cofnąć** zmiany
za pomocą polecenia `/undo`.
```bash frame="none"
/undo
```
opencode cofnie teraz zmiany i wyświetli wiadomość
Ponownie.
opencode cofnie teraz zmiany i wyświetli wiadomość ponownie.
```txt frame="none" "@packages/functions/src/api/index.ts"
Can you refactor the function in @packages/functions/src/api/index.ts?
```
Można zastosować monit i zastosować opencode o próbę próby.
Możesz edytować monit i poprosić opencode o ponowną próbę.
:::tip
Można `/undo` wiele razy, aby uniknąć wielu zmian.
Możesz użyć `/undo` wiele razy, aby cofnąć wiele zmian.
:::
Możesz też **możesz powtórzyć** zmianę za pomocą polecenia `/redo`.
Możesz też **przywrócić** zmianę za pomocą polecenia `/redo`.
```bash frame="none"
/redo
@@ -334,14 +323,13 @@ Możesz też **możesz powtórzyć** zmianę za pomocą polecenia `/redo`.
## Udostępnianie
Rozmowy z opencode można [udostępniać swoim
zespół](/docs/share).
Rozmowy z opencode można [udostępniać swojemu zespołowi](/docs/share).
```bash frame="none"
/share
```
Spowoduje to, że łącza do bieżących połączeń idą do schowki.
Spowoduje to, że link do bieżącej rozmowy zostanie skopiowany do schowka.
:::note
Rozmowy nie są ogólnodostępne.
@@ -353,6 +341,6 @@ Oto [przykładowa rozmowa](https://opencode.ai/s/4XP1fce5) z opencode.
## Dostosuj
tyle! Jesteś teraz profesjonalistą w korzystaniu z opencode.
To tyle! Jesteś teraz profesjonalistą w korzystaniu z opencode.
Aby dostosować go do potrzeb, zalecamy [wybranie motywu](/docs/themes), [dostosowanie skrótów klawiaturowych](/docs/keybinds), [konfigurowanie programów formatujących kod](/docs/formatters), [tworzenie niestandardowych kodów](/docs/commands) lub grę z [konfiguracją opencode](/docs/config).
Aby dostosować go do potrzeb, zalecamy [wybranie motywu](/docs/themes), [dostosowanie skrótów klawiaturowych](/docs/keybinds), [konfigurowanie programów formatujących kod](/docs/formatters), [tworzenie niestandardowych poleceń](/docs/commands) lub zabawę z [konfiguracją opencode](/docs/config).

View File

@@ -1,71 +1,71 @@
---
title: Serwery LSP
description: opencode integruje się z serwerem LSP.
description: OpenCode integruje się z serwerami LSP.
---
opencode integruje się z protokołem serwera językowego (LSP), aby pomóc LLM w korzystaniu z bazowego kodu. Wykorzystuje diagnostykę, aby otrzymać odpowiedź zwrotną do LLM.
OpenCode integruje się z protokołem Language Server Protocol (LSP), aby zapewnić modelom LLM kontekst bazy kodu. Wykorzystuje diagnostykę, aby przekazywać informacje zwrotne do LLM.
---
## Wbudowany
## Wbudowane
opencode posiada kilka wbudowanych serwerów LSP dla języków:
OpenCode posiada kilka wbudowanych serwerów LSP dla następujących języków:
| Serwer LSP | Rozszerzenie | Wymagania |
| ------------------ | ------------------------------------------------------------------- | -------------------------------------------------------------------------- |
| astro | .astro | Automatyczne instalacje dla Astro |
| bash | .sh, .bash, .zsh, .ksh | Automatycznie instaluje serwer języka bash |
| clangd | .c, .cpp, .cc, .cxx, .c++, .h, .hpp, .hh, .hxx, .h++ | Automatyczne instalacje dla C/C++ |
| csharp | .cs | `.NET SDK` zainstalowany |
| clojure-lsp | .clj, .cljs, .cljc, .edn | Komenda `clojure-lsp` dostępna |
| dart | .dart | Komenda `dart` dostępna |
| deno | .ts, .tsx, .js, .jsx, .mjs | Dostępne rozwiązanie `deno` (automatyczne wykrywanie deno.json/deno.jsonc) |
| elixir-ls | .ex, .exs | Komenda `elixir` dostępna |
| eslint | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue | `eslint` zależność w projekcie |
| fsharp | .fs, .fsi, .fsx, .fsscript | `.NET SDK` zainstalowany |
| gleam | .gleam | Komenda `gleam` dostępna |
| gopls | .go | Komenda `go` dostępna |
| hls | .hs, .lhs | Komenda `haskell-language-server-wrapper` dostępna |
| jdtls | .java | `Java SDK (version 21+)` zainstalowany |
| kotlin-ls | .kt, .kts | Automatyczne instalacje dla Kotlin |
| lua-ls | .lua | Automatyczne instalacje dla Lua |
| nixd | .nix | Komenda `nixd` dostępna |
| ocaml-lsp | .ml, .mli | Komenda `ocamllsp` dostępna |
| oxlint | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue, .astro, .svelte | `oxlint` zależność w projekcie |
| php intelephense | .php | Automatyczne instalacje dla PHP |
| prisma | .prisma | Komenda `prisma` dostępna |
| pyright | .py, .pyi | Zainstalowana zależność `pyright` |
| ruby-lsp (rubocop) | .rb, .rake, .gemspec, .ru | Dostępne polecenie `ruby` i `gem` |
| rust | .rs | Komenda `rust-analyzer` dostępna |
| sourcekit-lsp | .swift, .objc, .objcpp | `swift` zainstalowany (`xcode` na macOS) |
| svelte | .svelte | Automatyczne instalacje dla aplikacji Svelte |
| terraform | .tf, .tfvars | Automatyczne instalacje z wydań GitHub |
| tinymist | .typ, .typc | Automatyczne instalacje z wydań GitHub |
| typescript | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts | `typescript` zależność w projekcie |
| vue | .vue | Automatyczne instalacje dla Vue |
| yaml-ls | .yaml, .yml | Automatycznie instaluje serwer języka yaml Red Hat |
| zls | .zig, .zon | Komenda `zig` dostępna |
| Serwer LSP | Rozszerzenia | Wymagania |
| ------------------ | ------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| astro | .astro | Automatyczna instalacja dla Astro |
| bash | .sh, .bash, .zsh, .ksh | Automatycznie instaluje serwer języka bash |
| clangd | .c, .cpp, .cc, .cxx, .c++, .h, .hpp, .hh, .hxx, .h++ | Automatyczna instalacja dla C/C++ |
| csharp | .cs | Zainstalowany `.NET SDK` |
| clojure-lsp | .clj, .cljs, .cljc, .edn | Dostępne polecenie `clojure-lsp` |
| dart | .dart | Dostępne polecenie `dart` |
| deno | .ts, .tsx, .js, .jsx, .mjs | Dostępne polecenie `deno` (automatyczne wykrywanie deno.json/deno.jsonc) |
| elixir-ls | .ex, .exs | Dostępne polecenie `elixir` |
| eslint | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue | Zależność `eslint` w projekcie |
| fsharp | .fs, .fsi, .fsx, .fsscript | Zainstalowany `.NET SDK` |
| gleam | .gleam | Dostępne polecenie `gleam` |
| gopls | .go | Dostępne polecenie `go` |
| hls | .hs, .lhs | Dostępne polecenie `haskell-language-server-wrapper` |
| jdtls | .java | Zainstalowany `Java SDK (version 21+)` |
| kotlin-ls | .kt, .kts | Automatyczna instalacja dla Kotlin |
| lua-ls | .lua | Automatyczna instalacja dla Lua |
| nixd | .nix | Dostępne polecenie `nixd` |
| ocaml-lsp | .ml, .mli | Dostępne polecenie `ocamllsp` |
| oxlint | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue, .astro, .svelte | Zależność `oxlint` w projekcie |
| php intelephense | .php | Automatyczna instalacja dla PHP |
| prisma | .prisma | Dostępne polecenie `prisma` |
| pyright | .py, .pyi | Zainstalowana zależność `pyright` |
| ruby-lsp (rubocop) | .rb, .rake, .gemspec, .ru | Dostępne polecenie `ruby` i `gem` |
| rust | .rs | Dostępne polecenie `rust-analyzer` |
| sourcekit-lsp | .swift, .objc, .objcpp | Zainstalowany `swift` (`xcode` na macOS) |
| svelte | .svelte | Automatyczna instalacja dla aplikacji Svelte |
| terraform | .tf, .tfvars | Automatyczna instalacja z wydań GitHub |
| tinymist | .typ, .typc | Automatyczna instalacja z wydań GitHub |
| typescript | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts | Zależność `typescript` w projekcie |
| vue | .vue | Automatyczna instalacja dla Vue |
| yaml-ls | .yaml, .yml | Automatycznie instaluje serwer języka yaml Red Hat |
| zls | .zig, .zon | Dostępne polecenie `zig` |
Serwery LSP są automatycznie włączane po wykryciu jednego z rozszerzonych plików i wymagań.
Serwery LSP są automatycznie włączane po wykryciu jednego z obsługiwanych plików i spełnieniu wymagań.
:::note
Możliwość automatycznego pobierania z serwera LSP, ustawianie zmiennej środowiska `OPENCODE_DISABLE_LSP_DOWNLOAD` na `true`.
Możesz wyłączyć automatyczne pobieranie serwerów LSP, ustawiając zmienną środowiskową `OPENCODE_DISABLE_LSP_DOWNLOAD` na `true`.
:::
---
## Jak to działa
Gdy opencode otwiera plik, to:
Gdy OpenCode otwiera plik:
1. Sprawdzanie pliku na wszystkich dostępnych serwerach LSP.
2. Uruchamia właściwy serwer LSP, jeśli jeszcze nie działa.
1. Sprawdza plik pod kątem wszystkich dostępnych serwerów LSP.
2. Uruchamia odpowiedni serwer LSP, jeśli jeszcze nie działa.
---
## Skonfiguruj
## Konfiguracja
Możesz dostosować serwery LSP poprzez sekcję `lsp` w konfiguracji opencode.
Możesz dostosować serwery LSP poprzez sekcję `lsp` w konfiguracji OpenCode.
```json title="opencode.json"
{
@@ -74,15 +74,15 @@ Możesz dostosować serwery LSP poprzez sekcję `lsp` w konfiguracji opencode.
}
```
Każdy serwer LSP obsługuje szczegółowe elementy:
Każdy serwer LSP obsługuje następujące właściwości:
| Nieruchomość | Wpisz | Opis |
| Właściwość | Typ | Opis |
| ---------------- | -------- | ------------------------------------------------------ |
| `disabled` | boolean | Ustaw tę opcję na `true`, aby wyłączyć serwer LSP |
| `disabled` | boolean | Ustaw na `true`, aby wyłączyć ten serwer LSP |
| `command` | string[] | Polecenie uruchomienia serwera LSP |
| `extensions` | string[] | Rozszerzenia plików, które powinny mieć ten serwer LSP |
| `env` | object | Zmienne ustawienia podczas uruchamiania serwera |
| `initialization` | object | Opcje inicjalizacji do wysłania na serwer LSP |
| `extensions` | string[] | Rozszerzenia plików, które powinny używać tego serwera |
| `env` | object | Zmienne środowiskowe ustawiane podczas uruchamiania |
| `initialization` | object | Opcje inicjalizacji do wysłania do serwera LSP |
Spójrzmy na kilka przykładów.
@@ -90,7 +90,7 @@ Spójrzmy na kilka przykładów.
### Zmienne środowiskowe
Zastosowanie `env`, aby ustawić zmienne parametry transmisji podczas uruchamiania serwera LSP:
Użyj `env`, aby ustawić zmienne środowiskowe podczas uruchamiania serwera LSP:
```json title="opencode.json" {5-7}
{
@@ -109,7 +109,7 @@ Zastosowanie `env`, aby ustawić zmienne parametry transmisji podczas uruchamian
### Opcje inicjalizacji
właściwości `initialization`, aby mieć możliwość inicjalizacji na serwerze LSP. Są to ustawienia dla serwera wysyłającego podczas przełączania LSP `initialize`:
Użyj właściwości `initialization`, aby przekazać niestandardowe opcje inicjalizacji do serwera LSP. Są one wysyłane w żądaniu `initialize` protokołu LSP:
```json title="opencode.json" {5-9}
{
@@ -127,7 +127,7 @@ właściwości `initialization`, aby mieć możliwość inicjalizacji na serwerz
```
:::note
Opcje inicjalizacji różnią się w zależności od serwera LSP. Sprawdź swój serwer LSP pod gniazdem.
Opcje inicjalizacji różnią się w zależności od serwera LSP. Sprawdź dokumentację swojego serwera LSP.
:::
---
@@ -143,7 +143,7 @@ Aby wyłączyć **wszystkie** serwery LSP globalnie, ustaw `lsp` na `false`:
}
```
Aby wyłączyć **określony** serwer LSP, ustawa `disabled` na `true`:
Aby wyłączyć **określony** serwer LSP, ustaw `disabled` na `true`:
```json title="opencode.json" {5}
{
@@ -160,7 +160,7 @@ Aby wyłączyć **określony** serwer LSP, ustawa `disabled` na `true`:
### Niestandardowe serwery LSP
Serwer udostępniający serwery LSP, mechanizmy sterujące i udostępniane pliki:
Możesz dodać niestandardowe serwery LSP, podając polecenie i rozszerzenia plików:
```json title="opencode.json" {4-7}
{
@@ -178,11 +178,11 @@ Serwer udostępniający serwery LSP, mechanizmy sterujące i udostępniane pliki
## Dodatkowe informacje
### PHP Intelefense
### PHP Intelephense
PHP Intelephense oferuje funkcje premium poprzez klucz licencyjny. Możesz przechowywać klucz licencyjny umieszczając (tylko) klucz w pliku tekstowym pod adresem:
PHP Intelephense oferuje funkcje premium poprzez klucz licencyjny. Możesz użyć klucza licencyjnego, umieszczając go (sam klucz) w pliku tekstowym pod adresem:
- W systemie macOS/Linux: `$HOME/intelephense/license.txt`
- W systemie Windows: `%USERPROFILE%/intelephense/license.txt`
- macOS/Linux: `$HOME/intelephense/license.txt`
- Windows: `%USERPROFILE%/intelephense/license.txt`
Plik powinien zawierać wyłącznie klucz licencyjny, bez udostępniania treści.
Plik powinien zawierać wyłącznie klucz licencyjny, bez białych znaków.

View File

@@ -195,7 +195,7 @@ Można uwzględnić warianty lub dodać własne:
}
```
### Warianty cyklu
### Przełączanie wariantów
Naciśnij klawisza `variant_cycle`, aby szybko przełączać się między wariantami. [Dowiedz się więcej](/docs/keybinds).

View File

@@ -17,7 +17,7 @@ Można przełączać się między trybami podczas sesji lub konfigurować je w p
---
## Wbudowany
## Wbudowane
opencode ma dwa puste tryby.
@@ -54,7 +54,7 @@ Zobacz także: [Formaterzy](/docs/formatters), aby uzyskać informacje na temat
Możliwość dostosowania alternatywnego trybu lub konfiguracji poprzez własną konfigurację. Tryb można skonfigurować na dwa systemy:
### Konfiguracja JSON-a
### Konfiguracja JSON
Skonfiguruj tryb w pliku konfiguracyjnym `opencode.json`:
@@ -83,7 +83,7 @@ Skonfiguruj tryb w pliku konfiguracyjnym `opencode.json`:
}
```
### Konfiguracja przecen
### Konfiguracja Markdown
Można także definiować tryby za pomocą plików przecen. Trzymaj je w:
@@ -177,7 +177,7 @@ Jeśli nie ma wpływu na temperaturę, opencode stosuje się narzędzia badawcze
---
### Podpowiedź
### Prompt (Monit)
niestandardowy plik podpowiedzi systemowych dla tej procedury za pomocą konfiguracji `prompt`. Plik informacyjny powinien zawierać instrukcje dotyczące przeznaczenia trybu.
@@ -221,7 +221,7 @@ Jeśli nie ma żadnych narzędzi, wszystkie narzędzia są wyłączone.
---
#### Dostępne narzędzie
#### Dostępne narzędzia
Oto wszystkie narzędzia, które można sterować za pomocą konfiguracji trybów.

View File

@@ -1,5 +1,5 @@
---
title: Providers
title: Dostawcy
description: Korzystanie z dowolnego dostawcy LLM w opencode.
---
@@ -22,7 +22,7 @@ w `~/.local/share/opencode/auth.json`.
---
### Config
### Konfiguracja
Możesz dostosować dostawców za pomocą sekcji `provider` w swoim opencode
config.
@@ -84,7 +84,7 @@ Działa jak każdy inny dostawca w opencode i jest całkowicie opcjonalny w uży
---
## Directory
## Katalog
Przyjrzyjmy się szczegółowo niektórym dostawcom. Jeśli chcesz dodać dostawcę do
listę, możesz otworzyć PR.
@@ -184,7 +184,7 @@ Aby używać Amazon Bedrock z opencode:
Opcje z pliku konfiguracyjnego mają pierwszeństwo przed zmiennymi środowiskowymi.
:::
#### Zaawansowane: endpointy VPC
#### Zaawansowane: Punkty końcowe VPC
Jeśli używasz punktów końcowych VPC dla Bedrock:
@@ -659,7 +659,7 @@ GitLab Duo zapewnia czat agentowy oparty na sztucznej inteligencji z natywnymi m
Wybierz **OAuth**, a Twoja przeglądarka otworzy się w celu autoryzacji.
#### Using Personal Access Token
#### Użycie osobistego tokenu dostępu
1. Przejdź do [Ustawienia użytkownika GitLab > Tokeny dostępu](https://gitlab.com/-/user_settings/personal_access_tokens)
2. Click **Add new token**
3. Name: `OpenCode`, Scopes: `api`
@@ -748,7 +748,7 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here
Więcej informacji znajdziesz na stronie [opencode-gitlab-auth](https://www.npmjs.com/package/@gitlab/opencode-gitlab-auth).
##### Configuration
##### Konfiguracja
Customize through `opencode.json`:
@@ -769,7 +769,7 @@ Customize through `opencode.json`:
}
```
##### GitLab API Tools (Optional, but highly recommended)
##### Narzędzia GitLab API (opcjonalne, ale wysoce zalecane)
To access GitLab tools (merge requests, issues, pipelines, CI/CD, etc.):
@@ -1873,7 +1873,7 @@ Pola `limit` pozwalają opencode zrozumieć, ile kontekstu pozostało. Standardo
---
## Troubleshooting
## Rozwiązywanie problemów
Jeśli masz problemy z konfiguracją dostawcy, sprawdź następujące elementy:

View File

@@ -1,5 +1,5 @@
---
title: Rules
title: Zasady
description: Ustaw niestandardowe instrukcje dla opencode.
---
@@ -52,21 +52,21 @@ Dodajemy tutaj instrukcje dotyczące konkretnego projektu, które zostaną udost
---
## Types
## Typy
opencode obsługuje także odczytywanie pliku `AGENTS.md` z wielu lokalizacji. A to służy różnym celom.
### Project
### Projekt
Umieść `AGENTS.md` w katalogu głównym projektu, aby uzyskać reguły specyficzne dla projektu. Mają one zastosowanie tylko wtedy, gdy pracujesz w tym katalogu lub jego podkatalogach.
### Global
### Globalne
Możesz także mieć reguły globalne w pliku `~/.config/opencode/AGENTS.md`. Jest to stosowane we wszystkich sesjach opencode.
Ponieważ nie jest to wymagane dla Git ani udostępniane Twojemu zespołowi, zalecamy użycie tego do określenia wszelkich osobistych zasad, których powinien przestrzegać LLM.
### Claude Code Compatibility
### Kompatybilność z Claude Code
W przypadku użytkowników migrujących z Claude Code opencode obsługuje konwencje plików Claude Code jako rozwiązania awaryjne:
@@ -84,7 +84,7 @@ export OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1 # Disable only .claude/skills
---
## Precedence
## Priorytet
Po uruchomieniu opencode szuka plików reguł w następującej kolejności:
@@ -139,7 +139,7 @@ Zalecanym podejściem jest użycie pola `instructions` w `opencode.json`:
}
```
### Manual Instructions in AGENTS.md
### Ręczne instrukcje w AGENTS.md
Możesz nauczyć opencode czytać pliki zewnętrzne, podając wyraźne instrukcje w swoim `AGENTS.md`. Oto praktyczny przykład:

View File

@@ -1,19 +1,19 @@
---
title: SDK
description: Klient JS bezpieczny dla typu dla serwera opencode.
description: Typowany klient JS dla serwera OpenCode.
---
import config from "../../../../config.mjs"
export const typesUrl = `${config.github}/blob/dev/packages/sdk/js/src/gen/types.gen.ts`
Pakiet SDK JS/TS z opencode zapewnia klienta bezpiecznego typu do interakcji z serwerem.
Użyj go do budowania integracji i programowej kontroli otwartego kodu.
Pakiet SDK JS/TS OpenCode zapewnia klienta z bezpiecznym typowaniem (type-safe) do interakcji z serwerem.
Użyj go do budowania integracji i programowej kontroli OpenCode.
[Dowiedz się więcej](/docs/server) o działaniu serwera. Przykłady znajdziesz w [projektach](/docs/ecosystem#projects) stworzonych przez społeczność.
---
## Zainstalować
## Instalacja
Zainstaluj pakiet SDK z npm:
@@ -23,9 +23,9 @@ npm install @opencode-ai/sdk
---
## Utwórz klienta
## Tworzenie klienta
Utwórz instancję otwartego kodu:
Utwórz instancję OpenCode:
```javascript
import { createOpencode } from "@opencode-ai/sdk"
@@ -33,21 +33,21 @@ import { createOpencode } from "@opencode-ai/sdk"
const { client } = await createOpencode()
```
Spowoduje to uruchomienie zarówno serwera, jak i klienta
Spowoduje to uruchomienie zarówno serwera, jak i klienta.
#### Options
#### Opcje
| Opcja | Wpisz | Opis | Domyślne |
| Opcja | Typ | Opis | Domyślne |
| ---------- | ------------- | ----------------------------------------- | ----------- |
| `hostname` | `string` | Nazwa hosta serwera | `127.0.0.1` |
| `port` | `number` | Port serwera | `4096` |
| `signal` | `AbortSignal` | Sygnał przerwania w celu anulowania | `undefined` |
| `timeout` | `number` | Limit czasu w ms dla uruchomienia serwera | `5000` |
| `config` | `Config` | Configuration object | `{}` |
| `config` | `Config` | Obiekt konfiguracji | `{}` |
---
## Config
## Konfiguracja
Można przekazać obiekt konfiguracyjny, aby dostosować zachowanie. Instancja nadal pobiera `opencode.json`, ale możesz zastąpić lub dodać konfigurację bezpośrednio:
@@ -67,9 +67,9 @@ console.log(`Server running at ${opencode.server.url}`)
opencode.server.close()
```
## Client only
## Tylko klient
Jeśli masz już działającą instancję opencode, możesz utworzyć instancję klienta, aby się z nią połączyć:
Jeśli masz już działającą instancję OpenCode, możesz utworzyć instancję klienta, aby się z nią połączyć:
```javascript
import { createOpencodeClient } from "@opencode-ai/sdk"
@@ -79,19 +79,19 @@ const client = createOpencodeClient({
})
```
#### Options
#### Opcje
| Opcja | Wpisz | Opis | Domyślne |
| --------------- | ---------- | -------------------------------- | ----------------------- |
| `baseUrl` | `string` | Adres URL serwera | `http://localhost:4096` |
| `fetch` | `function` | Custom fetch implementation | `globalThis.fetch` |
| `parseAs` | `string` | Response parsing method | `auto` |
| `responseStyle` | `string` | Return style: `data` or `fields` | `fields` |
| `throwOnError` | `boolean` | Throw errors instead of return | `false` |
| Opcja | Typ | Opis | Domyślne |
| --------------- | ---------- | ----------------------------------- | ----------------------- |
| `baseUrl` | `string` | Adres URL serwera | `http://localhost:4096` |
| `fetch` | `function` | Niestandardowa implementacja fetch | `globalThis.fetch` |
| `parseAs` | `string` | Metoda parsowania odpowiedzi | `auto` |
| `responseStyle` | `string` | Styl zwracania: `data` lub `fields` | `fields` |
| `throwOnError` | `boolean` | Rzucaj błędy zamiast zwracać je | `false` |
---
## Types
## Typy
Zestaw SDK zawiera definicje TypeScript dla wszystkich typów API. Zaimportuj je bezpośrednio:
@@ -103,7 +103,7 @@ Wszystkie typy są generowane na podstawie specyfikacji OpenAPI serwera i dostę
---
## Errors
## Błędy
SDK może generować błędy, które można przechwycić i obsłużyć:
@@ -117,21 +117,21 @@ try {
---
## APIs
## API
Zestaw SDK udostępnia wszystkie interfejsy API serwera za pośrednictwem klienta bezpiecznego typu.
---
### Global
### Globalne
| Method | Description | Response |
| Metoda | Opis | Odpowiedź |
| ----------------- | ----------------------------- | ------------------------------------ |
| `global.health()` | Sprawdź stan i wersję serwera | `{ healthy: true, version: string }` |
---
#### Examples
#### Przykłady
```javascript
const health = await client.global.health()
@@ -140,16 +140,16 @@ console.log(health.data.version)
---
### App
### Aplikacja
| Method | Description | Response |
| Metoda | Opis | Odpowiedź |
| -------------- | ----------------------------------- | ------------------------------------------- |
| `app.log()` | Write a log entry | `boolean` |
| `app.log()` | Zapisz wpis logu | `boolean` |
| `app.agents()` | Lista wszystkich dostępnych agentów | <a href={typesUrl}><code>Agent[]</code></a> |
---
#### Examples
#### Przykłady
```javascript
// Write a log entry
@@ -167,16 +167,16 @@ const agents = await client.app.agents()
---
### Project
### Projekt
| Method | Description | Response |
| Metoda | Opis | Odpowiedź |
| ------------------- | -------------------------- | --------------------------------------------- |
| `project.list()` | Lista wszystkich projektów | <a href={typesUrl}><code>Project[]</code></a> |
| `project.current()` | Get current project | <a href={typesUrl}><code>Project</code></a> |
| `project.current()` | Pobierz bieżący projekt | <a href={typesUrl}><code>Project</code></a> |
---
#### Examples
#### Przykłady
```javascript
// List all projects
@@ -188,15 +188,15 @@ const currentProject = await client.project.current()
---
### Path
### Ścieżka
| Method | Description | Response |
| ------------ | ---------------- | ---------------------------------------- |
| `path.get()` | Get current path | <a href={typesUrl}><code>Path</code></a> |
| Metoda | Opis | Odpowiedź |
| ------------ | ----------------------- | ---------------------------------------- |
| `path.get()` | Pobierz bieżącą ścieżkę | <a href={typesUrl}><code>Path</code></a> |
---
#### Examples
#### Przykłady
```javascript
// Get current path information
@@ -205,16 +205,16 @@ const pathInfo = await client.path.get()
---
### Config
### Konfiguracja
| Method | Description | Response |
| Metoda | Opis | Odpowiedź |
| -------------------- | ----------------------------------- | ----------------------------------------------------------------------------------------------------- |
| `config.get()` | Get config info | <a href={typesUrl}><code>Config</code></a> |
| `config.get()` | Pobierz informacje o konfiguracji | <a href={typesUrl}><code>Config</code></a> |
| `config.providers()` | Lista dostawców i modeli domyślnych | `{ providers: `<a href={typesUrl}><code>Provider[]</code></a>`, default: { [key: string]: string } }` |
---
#### Examples
#### Przykłady
```javascript
const config = await client.config.get()
@@ -224,12 +224,12 @@ const { providers, default: defaults } = await client.config.providers()
---
### Sessions
### Sesje
| Method | Description | Notes |
| Metoda | Opis | Uwagi |
| ---------------------------------------------------------- | ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `session.list()` | Lista sesji | Zwraca <a href={typesUrl}><code>Session[]</code></a> |
| `session.get({ path })` | Uzyskaj sesję | Zwraca <a href={typesUrl}><code>Session</code></a> |
| `session.get({ path })` | Pobierz sesję | Zwraca <a href={typesUrl}><code>Session</code></a> |
| `session.children({ path })` | Lista sesji podrzędnych | Zwraca <a href={typesUrl}><code>Session[]</code></a> |
| `session.create({ body })` | Utwórz sesję | Zwraca <a href={typesUrl}><code>Session</code></a> |
| `session.delete({ path })` | Usuń sesję | Zwraca `boolean` |
@@ -238,19 +238,19 @@ const { providers, default: defaults } = await client.config.providers()
| `session.abort({ path })` | Przerwij trwającą sesję | Zwraca `boolean` |
| `session.share({ path })` | Udostępnij sesję | Zwraca <a href={typesUrl}><code>Session</code></a> |
| `session.unshare({ path })` | Cofnij udostępnianie sesji | Zwraca <a href={typesUrl}><code>Session</code></a> |
| `session.summarize({ path, body })` | Podsumowanie sesji | Zwraca `boolean` |
| `session.summarize({ path, body })` | Podsumuj sesję | Zwraca `boolean` |
| `session.messages({ path })` | Lista wiadomości w sesji | Zwraca `{ info: `<a href={typesUrl}><code>Message</code></a>`, parts: `<a href={typesUrl}><code>Part[]</code></a>`}[]` |
| `session.message({ path })` | Uzyskaj szczegóły wiadomości | Zwraca `{ info: `<a href={typesUrl}><code>Message</code></a>`, parts: `<a href={typesUrl}><code>Part[]</code></a>`}` |
| `session.message({ path })` | Pobierz szczegóły wiadomości | Zwraca `{ info: `<a href={typesUrl}><code>Message</code></a>`, parts: `<a href={typesUrl}><code>Part[]</code></a>`}` |
| `session.prompt({ path, body })` | Wyślij wiadomość | `body.noReply: true` zwraca UserMessage (tylko kontekst). Domyślnie zwraca <a href={typesUrl}><code>AssistantMessage</code></a> z odpowiedzią AI |
| `session.command({ path, body })` | Wyślij polecenie do sesji | Zwraca `{ info: `<a href={typesUrl}><code>AssistantMessage</code></a>`, parts: `<a href={typesUrl}><code>Part[]</code></a>`}` |
| `session.shell({ path, body })` | Uruchom polecenie shell | Zwraca <a href={typesUrl}><code>AssistantMessage</code></a> |
| `session.revert({ path, body })` | Przywróć wiadomość | Zwraca <a href={typesUrl}><code>Session</code></a> |
| `session.unrevert({ path })` | Przywróć przywrócone wiadomości | Zwraca <a href={typesUrl}><code>Session</code></a> |
| `postSessionByIdPermissionsByPermissionId({ path, body })` | Respond to a permission request | Returns `boolean` |
| `session.revert({ path, body })` | Cofnij wiadomość (revert) | Zwraca <a href={typesUrl}><code>Session</code></a> |
| `session.unrevert({ path })` | Przywróć cofnięte wiadomości | Zwraca <a href={typesUrl}><code>Session</code></a> |
| `postSessionByIdPermissionsByPermissionId({ path, body })` | Odpowiedz na żądanie uprawnienia | Zwraca `boolean` |
---
#### Examples
#### Przykłady
```javascript
// Create and manage sessions
@@ -281,25 +281,25 @@ await client.session.prompt({
---
### Files
### Pliki
| Method | Description | Response |
| Metoda | Opis | Odpowiedź |
| ------------------------- | ------------------------------------ | ---------------------------------------------------------------------------------------------- |
| `find.text({ query })` | Szukaj tekstu w plikach | Tablica obiektów dopasowania z `path`, `lines`, `line_number`, `absolute_offset`, `submatches` |
| `find.files({ query })` | Znajdź pliki i katalogi według nazwy | `string[]` (ścieżki) |
| `find.symbols({ query })` | Find workspace symbols | <a href={typesUrl}><code>Symbol[]</code></a> |
| `file.read({ query })` | Read a file | `{ type: "raw" \| "patch", content: string }` |
| `file.status({ query? })` | Uzyskaj status śledzonych plików | <a href={typesUrl}><code>File[]</code></a> |
| `find.symbols({ query })` | Znajdź symbole w obszarze roboczym | <a href={typesUrl}><code>Symbol[]</code></a> |
| `file.read({ query })` | Odczytaj plik | `{ type: "raw" \| "patch", content: string }` |
| `file.status({ query? })` | Pobierz status śledzonych plików | <a href={typesUrl}><code>File[]</code></a> |
`find.files` supports a few optional query fields:
`find.files` obsługuje kilka opcjonalnych pól zapytania:
- `type`: `"file"` or `"directory"`
- `type`: `"file"` lub `"directory"`
- `directory`: zastąp katalog główny projektu dla wyszukiwania
- `limit`: max results (1200)
- `limit`: maks. wyników (1200)
---
#### Examples
#### Przykłady
```javascript
// Search and read files
@@ -324,21 +324,21 @@ const content = await client.file.read({
### TUI
| Method | Description | Response |
| Metoda | Opis | Odpowiedź |
| ------------------------------ | --------------------------- | --------- |
| `tui.appendPrompt({ body })` | Dołącz tekst do zachęty | `boolean` |
| `tui.appendPrompt({ body })` | Dołącz tekst do promptu | `boolean` |
| `tui.openHelp()` | Otwórz okno pomocy | `boolean` |
| `tui.openSessions()` | Otwórz selektor sesji | `boolean` |
| `tui.openThemes()` | Otwórz selektor motywów | `boolean` |
| `tui.openModels()` | Otwórz selektor modelu | `boolean` |
| `tui.submitPrompt()` | Prześlij bieżący monit | `boolean` |
| `tui.clearPrompt()` | Wyczyść monit | `boolean` |
| `tui.submitPrompt()` | Prześlij bieżący prompt | `boolean` |
| `tui.clearPrompt()` | Wyczyść prompt | `boolean` |
| `tui.executeCommand({ body })` | Wykonaj polecenie | `boolean` |
| `tui.showToast({ body })` | Pokaż powiadomienie tostowe | `boolean` |
| `tui.showToast({ body })` | Pokaż powiadomienie (toast) | `boolean` |
---
#### Examples
#### Przykłady
```javascript
// Control TUI interface
@@ -353,15 +353,15 @@ await client.tui.showToast({
---
### Auth
### Uwierzytelnianie
| Method | Description | Response |
| ------------------- | ------------------------------ | --------- |
| `auth.set({ ... })` | Set authentication credentials | `boolean` |
| Metoda | Opis | Odpowiedź |
| ------------------- | ------------------------------------ | --------- |
| `auth.set({ ... })` | Ustaw poświadczenia uwierzytelniania | `boolean` |
---
#### Examples
#### Przykłady
```javascript
await client.auth.set({
@@ -372,15 +372,15 @@ await client.auth.set({
---
### Events
### Zdarzenia
| Method | Description | Response |
| ------------------- | --------------------------------------- | --------------------------------------- |
| `event.subscribe()` | Strumień zdarzeń wysłanych przez serwer | Strumień zdarzeń wysłanych przez serwer |
| Metoda | Opis | Odpowiedź |
| ------------------- | ---------------------------------------- | ---------------------------------------- |
| `event.subscribe()` | Strumień zdarzeń wysyłanych przez serwer | Strumień zdarzeń wysyłanych przez serwer |
---
#### Examples
#### Przykłady
```javascript
// Listen to real-time events

View File

@@ -44,7 +44,7 @@ OPENCODE_SERVER_PASSWORD=your-password opencode serve
---
### How it works
### Jak to działa
Kiedy uruchomisz `opencode`, uruchomi się TUI i serwer. Gdzie jest TUI
klient komunikujący się z serwerem. Serwer udostępnia specyfikację OpenAPI 3.1
@@ -61,7 +61,7 @@ opencode TUI działa, `opencode serve` uruchomi nowy serwer.
---
#### Połącz się z istniejącym serwerem
#### Połączenie z istniejącym serwerem
Po uruchomieniu TUI losowo przypisuje port i nazwę hosta. Zamiast tego możesz przekazać `--hostname` i `--port` [flagi](/docs/cli). Następnie użyj tego, aby połączyć się z serwerem.
@@ -69,7 +69,7 @@ Punktu końcowego [`/tui`](#TUI) można użyć do sterowania TUI przez serwer. M
---
## Spec
## Specyfikacja
Serwer publikuje specyfikację OpenAPI 3.1, którą można obejrzeć pod adresem:
@@ -81,13 +81,13 @@ Na przykład `http://localhost:4096/doc`. Użyj specyfikacji, aby wygenerować k
---
## APIs
## API
Serwer opencode udostępnia następujące interfejsy API.
---
### Global
### Globalne
| Method | Path | Description | Response |
| ------ | ---------------- | ------------------------------ | ------------------------------------ |
@@ -96,7 +96,7 @@ Serwer opencode udostępnia następujące interfejsy API.
---
### Project
### Projekt
| Method | Path | Description | Response |
| ------ | ------------------ | -------------------------- | --------------------------------------------- |
@@ -105,7 +105,7 @@ Serwer opencode udostępnia następujące interfejsy API.
---
### Path & VCS
### Ścieżka i VCS
| Method | Path | Description | Response |
| ------ | ------- | --------------------------------------------- | ------------------------------------------- |
@@ -114,7 +114,7 @@ Serwer opencode udostępnia następujące interfejsy API.
---
### Instance
### Instancja
| Method | Path | Description | Response |
| ------ | ------------------- | ---------------------- | --------- |
@@ -122,7 +122,7 @@ Serwer opencode udostępnia następujące interfejsy API.
---
### Config
### Konfiguracja
| Method | Path | Description | Response |
| ------- | ------------------- | ----------------------------------- | ---------------------------------------------------------------------------------------- |
@@ -143,7 +143,7 @@ Serwer opencode udostępnia następujące interfejsy API.
---
### Sessions
### Sesje
| Method | Path | Description | Notes |
| -------- | ---------------------------------------- | ------------------------------------------- | ---------------------------------------------------------------------------------- |
@@ -168,7 +168,7 @@ Serwer opencode udostępnia następujące interfejsy API.
---
### Messages
### Wiadomości
| Method | Path | Description | Notes |
| ------ | --------------------------------- | ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
@@ -181,7 +181,7 @@ Serwer opencode udostępnia następujące interfejsy API.
---
### Komendy
### Polecenia
| Metoda | Ścieżka | Opis | Odpowiedź |
| ------ | ---------- | ------------------------ | --------------------------------------------- |
@@ -210,7 +210,7 @@ Serwer opencode udostępnia następujące interfejsy API.
---
### Tools (Experimental)
### Narzędzia (Eksperymentalne)
| Method | Path | Description | Response |
| ------ | ------------------------------------------- | -------------------------------------------- | -------------------------------------------- |
@@ -219,7 +219,7 @@ Serwer opencode udostępnia następujące interfejsy API.
---
### LSP, Formatters & MCP
### LSP, Formatery i MCP
| Method | Path | Description | Response |
| ------ | ------------ | ---------------------------- | -------------------------------------------------------- |
@@ -230,7 +230,7 @@ Serwer opencode udostępnia następujące interfejsy API.
---
### Agents
### Agenci
| Method | Path | Description | Response |
| ------ | -------- | ----------------------------------- | ------------------------------------------- |
@@ -238,7 +238,7 @@ Serwer opencode udostępnia następujące interfejsy API.
---
### Logging
### Logowanie
| Method | Path | Description | Response |
| ------ | ------ | ------------------------------------------------------------ | --------- |
@@ -264,7 +264,7 @@ Serwer opencode udostępnia następujące interfejsy API.
---
### Auth
### Uwierzytelnianie
| Method | Path | Description | Response |
| ------ | ----------- | --------------------------------------------------------------------- | --------- |
@@ -272,7 +272,7 @@ Serwer opencode udostępnia następujące interfejsy API.
---
### Events
### Zdarzenia
| Method | Path | Description | Response |
| ------ | -------- | -------------------------------------------------------------------------------------------------------------------- | --------------------------------------- |
@@ -280,7 +280,7 @@ Serwer opencode udostępnia następujące interfejsy API.
---
### Docs
### Dokumentacja
| Method | Path | Description | Response |
| ------ | ------ | ------------------------ | ----------------------------------- |

View File

@@ -1,5 +1,5 @@
---
title: Share
title: Udostępnianie
description: Udostępnij swoje rozmowy dotyczące opencode.
---
@@ -11,7 +11,7 @@ Udostępnione konwersacje są publicznie dostępne dla każdej osoby mającej li
---
## How it works
## Jak to działa
Kiedy udostępniasz rozmowę, opencode:
@@ -21,13 +21,13 @@ Kiedy udostępniasz rozmowę, opencode:
---
## Sharing
## Udostępnianie
opencode obsługuje trzy tryby udostępniania, które kontrolują sposób udostępniania rozmów:
---
### Ręczny (domyślny)
### Ręczne (domyślne)
Domyślnie opencode korzysta z ręcznego trybu udostępniania. Sesje nie są udostępniane automatycznie, ale możesz je udostępnić ręcznie za pomocą polecenia `/share`:
@@ -48,7 +48,7 @@ Aby jawnie ustawić tryb ręczny w [pliku konfiguracyjnym] (./config):
---
### Auto-share
### Automatyczne udostępnianie
Możesz włączyć automatyczne udostępnianie dla wszystkich nowych rozmów, ustawiając opcję `share` na `"auto"` w [pliku konfiguracyjnym] (./config):
@@ -63,7 +63,7 @@ Po włączeniu automatycznego udostępniania każda nowa rozmowa będzie automat
---
### Disabled
### Wyłączone
Możesz całkowicie wyłączyć udostępnianie, ustawiając opcję `share` na `"disabled"` w [pliku konfiguracyjnym] (./config):
@@ -78,7 +78,7 @@ Aby wymusić to w całym zespole dla danego projektu, dodaj go do `opencode.json
---
## Un-sharing
## Cofnięcie udostępnienia
Aby zatrzymać udostępnianie rozmowy i usunąć ją z dostępu publicznego:
@@ -90,28 +90,28 @@ Spowoduje to usunięcie łącza udostępniania i danych związanych z rozmową.
---
## Privacy
## Prywatność
There are a few things to keep in mind when sharing a conversation.
Podczas udostępniania rozmowy należy pamiętać o kilku rzeczach.
---
### Data retention
### Przechowywanie danych
Udostępnione rozmowy pozostają dostępne, dopóki wyraźnie ich nie udostępnisz. Ten
includes:
- Full conversation history
- Pełna historia rozmów
- Wszystkie wiadomości i odpowiedzi
- Metadane sesji
---
### Recommendations
### Zalecenia
- Udostępniaj tylko rozmowy, które nie zawierają poufnych informacji.
- Review conversation content before sharing.
- Unshare conversations when collaboration is complete.
- Przejrzyj treść rozmowy przed udostępnieniem.
- Cofnij udostępnianie rozmów po zakończeniu współpracy.
- Unikaj udostępniania rozmów zawierających zastrzeżony kod lub poufne dane.
- W przypadku wrażliwych projektów całkowicie wyłącz udostępnianie.

View File

@@ -1,6 +1,6 @@
---
title: "Agent Skills"
description: "Define reusable behavior via SKILL.md definitions"
title: "Umiejętności Agenta"
description: "Definiuj powtarzalne zachowania za pomocą definicji SKILL.md"
---
Umiejętności agenta pozwalają opencode odkryć instrukcje wielokrotnego użytku z repozytorium lub katalogu domowego.
@@ -8,10 +8,10 @@ Umiejętności są ładowane na żądanie za pośrednictwem natywnego narzędzia
---
## Place files
## Lokalizacja plików
Utwórz jeden folder na nazwę umiejętności i umieść w nim `SKILL.md`.
opencode searches these locations:
opencode przeszukuje te lokalizacje:
- Project config: `.opencode/skills/<name>/SKILL.md`
- Global config: `~/.config/opencode/skills/<name>/SKILL.md`
@@ -22,7 +22,7 @@ opencode searches these locations:
---
## Understand discovery
## Zrozumienie wykrywania
W przypadku ścieżek lokalnych projektu opencode przechodzi od bieżącego katalogu roboczego, aż dotrze do drzewa roboczego git.
Ładuje po drodze dowolne pasujące `skills/*/SKILL.md` w `.opencode/` i dowolne pasujące `.claude/skills/*/SKILL.md` lub `.agents/skills/*/SKILL.md`.
@@ -31,32 +31,32 @@ W przypadku ścieżek lokalnych projektu opencode przechodzi od bieżącego kata
---
## Write frontmatter
## Tworzenie frontmatter
Każdy `SKILL.md` musi zaczynać się od treści YAML.
Only these fields are recognized:
Rozpoznawane są tylko te pola:
- `name` (required)
- `description` (required)
- `license` (optional)
- `compatibility` (optional)
- `metadata` (optional, string-to-string map)
- `name` (wymagane)
- `description` (wymagane)
- `license` (opcjonalnie)
- `compatibility` (opcjonalnie)
- `metadata` (opcjonalnie, mapa string-to-string)
Unknown frontmatter fields are ignored.
Nieznane pola frontmatter ignorowane.
---
## Validate names
## Walidacja nazw
`name` must:
`name` musi:
- Be 164 characters
- Mieć od 1 do 64 znaków
- Należy używać małych liter alfanumerycznych i oddzielać je pojedynczym łącznikiem
- Nie zaczyna się ani nie kończy na `-`
- Not contain consecutive `--`
- Nie może zawierać następujących po sobie `--`
- Dopasuj nazwę katalogu zawierającą `SKILL.md`
Equivalent regex:
Odpowiednik wyrażenia regularnego:
```text
^[a-z0-9]+(-[a-z0-9]+)*$
@@ -64,14 +64,14 @@ Equivalent regex:
---
## Follow length rules
## Zasady dotyczące długości
`description` must be 1-1024 characters.
`description` musi mieć od 1 do 1024 znaków.
Zadbaj o to, aby agent mógł dokonać prawidłowego wyboru.
---
## Skorzystaj z przykładu
## Przykład użycia
Utwórz `.opencode/skills/git-release/SKILL.md` w ten sposób:
@@ -100,7 +100,7 @@ Ask clarifying questions if the target versioning scheme is unclear.
---
## Recognize tool description
## Opis narzędzia
opencode wymienia dostępne umiejętności w opisie narzędzia `skill`.
Każdy wpis zawiera nazwę i opis umiejętności:
@@ -122,9 +122,9 @@ skill({ name: "git-release" })
---
## Skonfiguruj uprawnienia
## Konfiguracja uprawnień
Control which skills agents can access using pattern-based permissions in `opencode.json`:
Kontroluj, do których umiejętności agenci mogą uzyskać dostęp, używając uprawnień opartych na wzorcach w `opencode.json`:
```json
{
@@ -149,7 +149,7 @@ Wzorce obsługują symbole wieloznaczne: `internal-*` odpowiada `internal-docs`,
---
## Override per agent
## Nadpisywanie dla agenta
Nadaj konkretnym agentom inne uprawnienia niż globalne ustawienia domyślne.
@@ -181,11 +181,11 @@ permission:
---
## Wyłącz narzędzie umiejętności
## Wyłączanie narzędzia umiejętności
Całkowicie wyłącz umiejętności agentów, którzy nie powinni ich używać:
**Dla agentów celnych**:
**Dla agentów niestandardowych** (w temacie agentów):
```yaml
---
@@ -212,11 +212,11 @@ Jeśli opcja jest wyłączona, sekcja `<available_skills>` jest całkowicie pomi
---
## Troubleshoot loading
## Rozwiązywanie problemów z ładowaniem
Jeśli umiejętność nie pojawi się:
1. Verify `SKILL.md` is spelled in all caps
1. Sprawdź, czy `SKILL.md` jest napisane wielkimi literami
2. Sprawdź, czy frontmatter zawiera `name` i `description`
3. Ensure skill names are unique across all locations
3. Upewnij się, że nazwy umiejętności są unikalne we wszystkich lokalizacjach
4. Sprawdź uprawnienia — umiejętności z `deny` są ukryte przed agentami

View File

@@ -9,7 +9,7 @@ Domyślnie opencode używa naszego własnego motywu `opencode`.
---
## Terminal requirements
## Wymagania terminala
Aby motywy wyświetlały się poprawnie z pełną paletą kolorów, Twój terminal musi obsługiwać **truecolor** (kolor 24-bitowy). Większość nowoczesnych terminali domyślnie obsługuje tę opcję, ale może być konieczne jej włączenie:
@@ -43,7 +43,7 @@ Co więcej, stale dodajemy nowe motywy.
---
## System theme
## Motyw systemowy
Motyw `system` został zaprojektowany tak, aby automatycznie dostosowywał się do schematu kolorów terminala. W przeciwieństwie do tradycyjnych motywów, które używają stałych kolorów, motyw _system_:
@@ -59,7 +59,7 @@ Motyw systemu przeznaczony jest dla użytkowników, którzy:
---
## Using a theme
## Używanie motywu
Możesz wybrać motyw, wywołując opcję wyboru motywu za pomocą polecenia `/theme`. Możesz też określić to w [config](/docs/config).
@@ -72,26 +72,26 @@ Możesz wybrać motyw, wywołując opcję wyboru motywu za pomocą polecenia `/t
---
## Custom themes
## Motywy niestandardowe
opencode obsługuje elastyczny system motywów oparty na JSON, który pozwala użytkownikom łatwo tworzyć i dostosowywać motywy.
---
### Hierarchy
### Hierarchia
Motywy są ładowane z wielu katalogów w następującej kolejności, przy czym późniejsze katalogi zastępują wcześniejsze:
1. **Wbudowane motywy** są osadzone w formacie binarnym
2. **User config directory** - Defined in `~/.config/opencode/themes/*.json` or `$XDG_CONFIG_HOME/opencode/themes/*.json`
2. **Katalog konfiguracji użytkownika** - Zdefiniowany w `~/.config/opencode/themes/*.json` lub `$XDG_CONFIG_HOME/opencode/themes/*.json`
3. **Katalog główny projektu** - Zdefiniowany w `<project-root>/.opencode/themes/*.json`
4. **Current working directory** - Defined in `./.opencode/themes/*.json`
4. **Bieżący katalog roboczy** - Zdefiniowany w `./.opencode/themes/*.json`
Jeśli wiele katalogów zawiera motyw o tej samej nazwie, zostanie użyty motyw z katalogu o wyższym priorytecie.
---
### Creating a theme
### Tworzenie motywu
Aby utworzyć niestandardowy motyw, utwórz plik JSON w jednym z katalogów motywów.
@@ -111,25 +111,25 @@ vim .opencode/themes/my-theme.json
---
### JSON format
### Format JSON
Motywy korzystają z elastycznego formatu JSON z obsługą:
- **Hex colors**: `"#ffffff"`
- **ANSI colors**: `3` (0-255)
- **Color references**: `"primary"` or custom definitions
- **Dark/light variants**: `{"dark": "#000", "light": "#fff"}`
- **Brak koloru**: `"none"` - Używa domyślnego koloru terminala lub przezroczystości
- **Kolorów Hex**: `"#ffffff"`
- **Kolorów ANSI**: `3` (0-255)
- **Referencji kolorów**: `"primary"` lub definicje niestandardowe
- **Wariantów Ciemny/Jasny**: `{"dark": "#000", "light": "#fff"}`
- **Braku koloru**: `"none"` - Używa domyślnego koloru terminala lub przezroczystości
---
### Color definitions
### Definicje kolorów
Sekcja `defs` jest opcjonalna i pozwala zdefiniować kolory wielokrotnego użytku, do których można się odwoływać w motywie.
---
### Terminal defaults
### Domyślne ustawienia terminala
Wartość specjalna `"none"` może zostać użyta dla dowolnego koloru, aby przejąć domyślny kolor terminala. Jest to szczególnie przydatne do tworzenia motywów, które płynnie komponują się ze schematem kolorów terminala:
@@ -140,7 +140,7 @@ Wartość specjalna `"none"` może zostać użyta dla dowolnego koloru, aby prze
### Przykład
Here's an example of a custom theme:
Oto przykład niestandardowego motywu:
```json title="my-theme.json"
{

View File

@@ -1,17 +1,17 @@
---
title: Tools
title: Narzędzia
description: Zarządzaj narzędziami, z których może korzystać LLM.
---
Narzędzia umożliwiają LLM wykonywanie działań w bazie kodu. opencode ma zestaw wbudowanych narzędzi, ale możesz go rozszerzyć o [narzędzia niestandardowe](/docs/custom-tools) lub [serwery MCP](/docs/mcp-servers).
Narzędzia umożliwiają LLM wykonywanie działań w bazie kodu. OpenCode posiada zestaw wbudowanych narzędzi, ale możesz go rozszerzyć o [narzędzia niestandardowe](/docs/custom-tools) lub [serwery MCP](/docs/mcp-servers).
Domyślnie wszystkie narzędzia są **włączone** i nie wymagają pozwolenia na uruchomienie. Możesz kontrolować zachowanie narzędzia poprzez [uprawnienia](/docs/permissions).
Domyślnie wszystkie narzędzia są **włączone** i nie wymagają zatwierdzenia przed uruchomieniem. Możesz kontrolować zachowanie narzędzi poprzez [uprawnienia](/docs/permissions).
---
## Skonfiguruj
## Konfiguracja
Użyj pola `permission` do kontrolowania zachowania narzędzia. Dla każdego narzędzia możesz zezwolić, odmówić lub wymagać zatwierdzenia.
Użyj pola `permission` do kontrolowania zachowania narzędzia. Dla każdego narzędzia możesz zezwolić (`allow`), odmówić (`deny`) lub wymagać zatwierdzenia (`ask`).
```json title="opencode.json"
{
@@ -24,7 +24,7 @@ Użyj pola `permission` do kontrolowania zachowania narzędzia. Dla każdego nar
}
```
Możesz także używać symboli wieloznacznych do kontrolowania wielu narzędzi jednocześnie. Na przykład, aby wymagać zatwierdzenia wszystkich narzędzi z serwera MCP:
Możesz także używać symboli wieloznacznych do kontrolowania wielu narzędzi jednocześnie. Na przykład, aby wymagać zatwierdzenia dla wszystkich narzędzi z serwera MCP:
```json title="opencode.json"
{
@@ -39,15 +39,15 @@ Możesz także używać symboli wieloznacznych do kontrolowania wielu narzędzi
---
## Wbudowane
## Wbudowane narzędzia
Oto wszystkie wbudowane narzędzia dostępne w opencode.
Oto wszystkie wbudowane narzędzia dostępne w OpenCode.
---
### bash
Wykonuj polecenia shell w środowisku projektu.
Wykonuj polecenia powłoki (shell) w środowisku projektu.
```json title="opencode.json" {4}
{
@@ -58,13 +58,13 @@ Wykonuj polecenia shell w środowisku projektu.
}
```
To narzędzie umożliwia LLM uruchamianie poleceń terminalowych, takich jak `npm install`, `git status` lub dowolne inne polecenie shell.
To narzędzie umożliwia LLM uruchamianie poleceń terminalowych, takich jak `npm install`, `git status` lub dowolne inne polecenie powłoki.
---
### edit
Modyfikuj istniejące pliki przez dokładne podmiany tekstu.
Modyfikuj istniejące pliki poprzez precyzyjne zastępowanie tekstu.
```json title="opencode.json" {4}
{
@@ -81,7 +81,7 @@ To narzędzie umożliwia precyzyjną edycję plików poprzez zastąpienie dokła
### write
Utwórz nowe pliki lub nadpisz istniejące.
Twórz nowe pliki lub nadpisuj istniejące.
```json title="opencode.json" {4}
{
@@ -102,7 +102,7 @@ Narzędzie `write` jest kontrolowane przez uprawnienie `edit`, które obejmuje w
### read
Przeczytaj zawartość pliku z bazy kodu.
Odczytaj zawartość pliku z bazy kodu.
```json title="opencode.json" {4}
{
@@ -147,11 +147,11 @@ Znajduj pliki na podstawie wzorców.
}
```
Szukaj plików przy użyciu wzorców globalnych, takich jak `**/*.js` lub `src/**/*.ts`. Zwraca pasujące ścieżki plików posortowane według czasu modyfikacji.
Szukaj plików przy użyciu wzorców glob, takich jak `**/*.js` lub `src/**/*.ts`. Zwraca pasujące ścieżki plików posortowane według czasu modyfikacji.
---
### lista
### list
Wyświetla listę plików i katalogów w podanej ścieżce.
@@ -164,13 +164,13 @@ Wyświetla listę plików i katalogów w podanej ścieżce.
}
```
To narzędzie wyświetla zawartość katalogu. Akceptuje wzorce globalne do filtrowania wyników.
To narzędzie wyświetla zawartość katalogu. Akceptuje wzorce glob do filtrowania wyników.
---
### LSP (experimental)
### LSP (eksperymentalne)
Wejdź w interakcję ze skonfigurowanymi serwerami LSP, aby uzyskać funkcje analizy kodu, takie jak definicje, odniesienia, informacje o najechaniu myszką i hierarchia połączeń.
Interakcja ze skonfigurowanymi serwerami LSP w celu uzyskania funkcji analizy kodu, takich jak definicje, referencje, podpowiedzi (hover) i hierarchia wywołań.
:::note
To narzędzie jest dostępne tylko wtedy, gdy `OPENCODE_EXPERIMENTAL_LSP_TOOL=true` (lub `OPENCODE_EXPERIMENTAL=true`).
@@ -193,7 +193,7 @@ Aby skonfigurować, które serwery LSP są dostępne dla Twojego projektu, zobac
### patch
Stosuj patche do plików.
Stosuj łatki (patches) do plików.
```json title="opencode.json" {4}
{
@@ -204,7 +204,7 @@ Stosuj patche do plików.
}
```
To narzędzie stosuje pliki poprawek do bazy kodu. Przydatne do stosowania różnic i poprawek z różnych źródeł.
To narzędzie stosuje pliki różnicowe (diffs) do bazy kodu. Przydatne do stosowania zmian z różnych źródeł.
:::note
Narzędzie `patch` jest kontrolowane przez uprawnienie `edit`, które obejmuje wszystkie modyfikacje plików (`edit`, `write`, `patch`, `multiedit`).
@@ -229,7 +229,7 @@ Załaduj [umiejętność](/docs/skills) (plik `SKILL.md`) i zwróć jej treść
### todowrite
Zarządzaj listami rzeczy do zrobienia podczas sesji kodowania.
Zarządzaj listami zadań (todo) podczas sesji kodowania.
```json title="opencode.json" {4}
{
@@ -243,14 +243,14 @@ Zarządzaj listami rzeczy do zrobienia podczas sesji kodowania.
Tworzy i aktualizuje listy zadań w celu śledzenia postępu podczas złożonych operacji. LLM wykorzystuje to do organizowania zadań wieloetapowych.
:::note
To narzędzie jest domyślnie wyłączone dla podagentów, ale można je włączyć ręcznie. [Dowiedz się więcej](/docs/agents/#permissions)
To narzędzie jest domyślnie wyłączone dla subagentów, ale można je włączyć ręcznie. [Dowiedz się więcej](/docs/agents/#permissions)
:::
---
### todoread
Odczytuj istniejące listy todo.
Odczytuj istniejące listy zadań (todo).
```json title="opencode.json" {4}
{
@@ -264,14 +264,14 @@ Odczytuj istniejące listy todo.
Odczytuje bieżący stan listy rzeczy do zrobienia. Używany przez LLM do śledzenia zadań oczekujących lub ukończonych.
:::note
To narzędzie jest domyślnie wyłączone dla podagentów, ale można je włączyć ręcznie. [Dowiedz się więcej](/docs/agents/#permissions)
To narzędzie jest domyślnie wyłączone dla subagentów, ale można je włączyć ręcznie. [Dowiedz się więcej](/docs/agents/#permissions)
:::
---
### webfetch
Pobieraj treści z web.
Pobieraj treści z sieci.
```json title="opencode.json" {4}
{
@@ -282,7 +282,7 @@ Pobieraj treści z web.
}
```
Umożliwia LLM pobieranie i odczytywanie stron internetowych. Przydatne do wyszukiwania dokumentacji lub wyszukiwania zasobów online.
Umożliwia LLM pobieranie i odczytywanie stron internetowych. Przydatne do wyszukiwania dokumentacji lub zasobów online.
---
@@ -291,9 +291,9 @@ Umożliwia LLM pobieranie i odczytywanie stron internetowych. Przydatne do wyszu
Wyszukaj informacje w Internecie.
:::note
To narzędzie jest dostępne tylko w przypadku korzystania z dostawcy opencode lub gdy zmienna środowiskowa `OPENCODE_ENABLE_EXA` jest ustawiona na dowolną wartość prawdziwą (np. `true` lub `1`).
To narzędzie jest dostępne tylko w przypadku korzystania z dostawcy OpenCode lub gdy zmienna środowiskowa `OPENCODE_ENABLE_EXA` jest ustawiona na dowolną wartość prawdziwą (np. `true` lub `1`).
Aby włączyć przy uruchamianiu opencode:
Aby włączyć przy uruchamianiu OpenCode:
```bash
OPENCODE_ENABLE_EXA=1 opencode
@@ -310,12 +310,12 @@ OPENCODE_ENABLE_EXA=1 opencode
}
```
Przeszukuje Internet za pomocą Exa AI, aby znaleźć odpowiednie informacje w Internecie. Przydatne do badania tematów, znajdowania bieżących wydarzeń lub zbierania informacji wykraczających poza limit danych szkoleniowych.
Przeszukuje Internet za pomocą Exa AI, aby znaleźć odpowiednie informacje. Przydatne do badania tematów, znajdowania bieżących wydarzeń lub zbierania informacji wykraczających poza zbiór danych treningowych.
Nie jest wymagany żaden klucz API — narzędzie łączy się bezpośrednio z usługą MCP hostowaną przez Exa AI bez uwierzytelniania.
:::tip
Użyj `websearch`, gdy chcesz znaleźć informacje (odkrycie), i `webfetch`, gdy musisz pobrać treść z określonego adresu URL (pobieranie).
Użyj `websearch`, gdy chcesz znaleźć informacje (odkrywanie), i `webfetch`, gdy musisz pobrać treść z określonego adresu URL (pobieranie).
:::
---
@@ -333,12 +333,12 @@ Zadawaj pytania użytkownikowi podczas wykonywania.
}
```
To narzędzie umożliwia LLM zadawanie pytań użytkownikowi podczas wykonywania zadania. Jest to przydatne dla:
To narzędzie umożliwia LLM zadawanie pytań użytkownikowi podczas wykonywania zadania. Jest to przydatne do:
- Zbieranie preferencji i wymagań użytkownika
- Doprecyzowanie niejednoznacznych instrukcji
- Uzyskiwanie decyzji dotyczących implementacji
- Proponowanie możliwych kierunków działania
- Zbierania preferencji i wymagań użytkownika
- Doprecyzowania niejednoznacznych instrukcji
- Podejmowania decyzji dotyczących implementacji
- Proponowania możliwych kierunków działania
Każde pytanie zawiera nagłówek, tekst pytania i listę opcji. Użytkownicy mogą wybierać spośród dostępnych opcji lub wpisać niestandardową odpowiedź. Jeśli pytań jest wiele, użytkownicy mogą nawigować między nimi przed przesłaniem wszystkich odpowiedzi.
@@ -360,13 +360,13 @@ Serwery MCP (Model Context Protocol) umożliwiają integrację zewnętrznych nar
---
## Wnętrze działania
## Szczegóły techniczne
Wewnętrznie narzędzia takie jak `grep`, `glob` i `list` używają pod maską [ripgrep](https://github.com/BurntSushi/ripgrep). Domyślnie ripgrep respektuje wzorce `.gitignore`, co oznacza, że pliki i katalogi wymienione w Twoim `.gitignore` zostaną wykluczone z wyszukiwań i list.
Wewnętrznie narzędzia takie jak `grep`, `glob` i `list` używają [ripgrep](https://github.com/BurntSushi/ripgrep). Domyślnie ripgrep respektuje wzorce `.gitignore`, co oznacza, że pliki i katalogi wymienione w Twoim `.gitignore` zostaną wykluczone z wyszukiwań i list.
---
### Wzorce ignorowania
### Ignorowanie plików
Aby uwzględnić pliki, które normalnie byłyby ignorowane, utwórz plik `.ignore` w katalogu głównym projektu. Ten plik może jawnie zezwalać na określone ścieżki.

View File

@@ -1,5 +1,5 @@
---
title: Troubleshooting
title: Rozwiązywanie problemów
description: Typowe problemy i sposoby ich rozwiązywania.
---
@@ -7,9 +7,9 @@ Aby debugować problemy z opencode, zacznij od sprawdzenia dzienników i danych
---
## Logs
## Dzienniki
Log files are written to:
Pliki logów są zapisywane w:
- **macOS/Linux**: `~/.local/share/opencode/log/`
- **Windows**: Naciśnij `WIN+R` i wklej `%USERPROFILE%\.local\share\opencode\log`
@@ -20,7 +20,7 @@ Możesz ustawić poziom dziennika za pomocą opcji wiersza poleceń `--log-level
---
## Storage
## Przechowywanie danych
opencode przechowuje dane sesji i inne dane aplikacji na dysku pod adresem:
@@ -37,11 +37,11 @@ Ten katalog zawiera:
---
## Desktop app
## Aplikacja desktopowa
opencode Desktop uruchamia w tle lokalny serwer opencode (sidecar `opencode-cli`). Większość problemów jest spowodowana nieprawidłowo działającą wtyczką, uszkodzoną pamięcią podręczną lub złymi ustawieniami serwera.
### Quick checks
### Szybkie sprawdzenie
- Całkowicie zakończ i uruchom ponownie aplikację.
- Jeśli aplikacja wyświetli ekran błędu, kliknij **Uruchom ponownie** i skopiuj szczegóły błędu.
@@ -49,7 +49,7 @@ opencode Desktop uruchamia w tle lokalny serwer opencode (sidecar `opencode-cli`
---
### Disable plugins
### Wyłączanie wtyczek
Jeśli aplikacja komputerowa ulega awarii podczas uruchamiania, zawiesza się lub zachowuje się dziwnie, zacznij od wyłączenia wtyczek.
@@ -57,8 +57,8 @@ Jeśli aplikacja komputerowa ulega awarii podczas uruchamiania, zawiesza się lu
Otwórz globalny plik konfiguracyjny i poszukaj klucza `plugin`.
- **macOS/Linux**: `~/.config/opencode/opencode.jsonc` (or `~/.config/opencode/opencode.json`)
- **macOS/Linux** (older installs): `~/.local/share/opencode/opencode.jsonc`
- **macOS/Linux**: `~/.config/opencode/opencode.jsonc` (lub `~/.config/opencode/opencode.json`)
- **macOS/Linux** (starsze instalacje): `~/.local/share/opencode/opencode.jsonc`
- **Windows**: Naciśnij `WIN+R` i wklej `%USERPROFILE%\.config\opencode\opencode.jsonc`
Jeśli masz skonfigurowane wtyczki, tymczasowo je wyłącz, usuwając klucz lub ustawiając go na pustą tablicę:
@@ -70,11 +70,11 @@ Jeśli masz skonfigurowane wtyczki, tymczasowo je wyłącz, usuwając klucz lub
}
```
#### Check plugin directories
#### Sprawdź katalogi wtyczek
opencode może także ładować lokalne wtyczki z dysku. Tymczasowo usuń je (lub zmień nazwę folderu) i uruchom ponownie aplikację komputerową:
- **Global plugins**
- **Wtyczki globalne**
- **macOS/Linux**: `~/.config/opencode/plugins/`
- **Windows**: Naciśnij `WIN+R` i wklej `%USERPROFILE%\.config\opencode\plugins`
- **Wtyczki projektowe** (tylko jeśli używasz konfiguracji dla poszczególnych projektów)
@@ -88,14 +88,14 @@ Jeśli aplikacja ponownie zacznie działać, włączaj ponownie wtyczki pojedync
Jeśli wyłączenie wtyczek nie pomoże (lub instalacja wtyczki utknęła), wyczyść pamięć podręczną, aby opencode mógł ją odbudować.
1. Quit opencode Desktop completely.
1. Całkowicie zamknij opencode Desktop.
2. Usuń katalog pamięci podręcznej:
- **macOS**: Finder -> `Cmd+Shift+G` -> paste `~/.cache/opencode`
- **Linux**: usuń `~/.cache/opencode` (lub uruchom `rm -rf ~/.cache/opencode`)
- **Windows**: Naciśnij `WIN+R` i wklej `%USERPROFILE%\.cache\opencode`
3. Restart opencode Desktop.
3. Uruchom ponownie opencode Desktop.
---
@@ -113,49 +113,49 @@ Na ekranie głównym kliknij nazwę serwera (z kropką stanu), aby otworzyć sel
Jeśli Twój `opencode.json(c)` zawiera sekcję `server`, tymczasowo usuń ją i uruchom ponownie aplikację komputerową.
#### Check environment variables
#### Sprawdź zmienne środowiskowe
Jeśli w swoim środowisku masz ustawiony `OPENCODE_PORT`, aplikacja komputerowa spróbuje użyć tego portu dla serwera lokalnego.
- Rozbierz `OPENCODE_PORT` (lub wybierz wolny port) i uruchom ponownie.
- usuń `OPENCODE_PORT` (lub wybierz wolny port) i uruchom ponownie.
---
### Linux: Wayland / X11 issues
### Linux: Problemy z Wayland / X11
On Linux, some Wayland setups can cause blank windows or compositor errors.
W systemie Linux, niektóre konfiguracje Wayland mogą powodować puste okna lub błędy kompozytora.
- Jeśli korzystasz z Wayland, a aplikacja jest pusta/ ulega awarii, spróbuj uruchomić ją za pomocą `OC_ALLOW_WAYLAND=1`.
- Jeśli to pogorszy sprawę, usuń go i zamiast tego spróbuj uruchomić w sesji X11.
---
### Windows: WebView2 runtime
### Windows: Środowisko uruchomieniowe WebView2
W systemie Windows opencode Desktop wymaga Microsoft Edge **WebView2 Runtime**. Jeśli aplikacja otwiera się w pustym oknie lub nie uruchamia się, zainstaluj/zaktualizuj WebView2 i spróbuj ponownie.
---
### Windows: General performance issues
### Windows: Ogólne problemy z wydajnością
Jeśli doświadczasz niskiej wydajności, problemów z dostępem do plików lub problemów z terminalem w systemie Windows, spróbuj użyć [WSL (podsystem Windows dla systemu Linux) (./windows-wsl). WSL zapewnia środowisko Linux, które płynniej współpracuje z funkcjami opencode.
---
### Notifications not showing
### Brak powiadomień
opencode Desktop only shows system notifications when:
opencode Desktop pokazuje powiadomienia systemowe tylko wtedy, gdy:
- powiadomienia są włączone dla opencode w ustawieniach systemu operacyjnego, oraz
- okno aplikacji nie jest aktywne.
---
### Reset desktop app storage (last resort)
### Resetowanie pamięci aplikacji
Jeśli aplikacja nie uruchamia się i nie możesz wyczyścić ustawień w interfejsie użytkownika, zresetuj zapisany stan aplikacji komputerowej.
1. Quit opencode Desktop.
1. Zamknij całkowicie opencode Desktop.
2. Znajdź i usuń te pliki (znajdują się w katalogu danych aplikacji opencode Desktop):
- `opencode.settings.dat` (domyślny adres URL serwera na komputerze stacjonarnym)
@@ -169,11 +169,11 @@ Aby szybko znaleźć katalog:
---
## Getting help
## Uzyskiwanie pomocy
Jeśli masz problemy z opencode:
1. **Report issues on GitHub**
1. **Zgłoś problem na GitHub**
Najlepszym sposobem zgłaszania błędów lub zgłaszania żądań funkcji jest skorzystanie z naszego repozytorium GitHub:
@@ -181,7 +181,7 @@ Jeśli masz problemy z opencode:
Przed utworzeniem nowego problemu przeszukaj istniejące i sprawdź, czy Twój problem nie został już zgłoszony.
2. **Join our Discord**
2. **Dołącz do naszego Discorda**
Aby uzyskać pomoc w czasie rzeczywistym i dyskusję społeczności, dołącz do naszego serwera Discord:
@@ -189,7 +189,7 @@ Jeśli masz problemy z opencode:
---
## Common issues
## Typowe problemy
Oto kilka typowych problemów i sposobów ich rozwiązania.
@@ -203,7 +203,7 @@ Oto kilka typowych problemów i sposobów ich rozwiązania.
---
### Authentication issues
### Problemy z uwierzytelnianiem
1. Spróbuj ponownie uwierzytelnić się za pomocą polecenia `/connect` w TUI
2. Sprawdź, czy klucze API są ważne
@@ -215,13 +215,13 @@ Oto kilka typowych problemów i sposobów ich rozwiązania.
1. Sprawdź, czy dokonałeś uwierzytelnienia u dostawcy
2. Sprawdź, czy nazwa modelu w konfiguracji jest poprawna
3. Some models may require specific access or subscriptions
3. Niektóre modele mogą wymagać określonego dostępu lub subskrypcji
Jeśli napotkasz `ProviderModelNotFoundError`, najprawdopodobniej się mylisz
odwołując się gdzieś do modelu.
Models should be referenced like so: `<providerId>/<modelId>`
Jeśli napotkasz `ProviderModelNotFoundError`, najprawdopodobniej
błędnie odwołujesz się gdzieś do modelu.
Modele powinny być wskazywane w ten sposób: `<providerId>/<modelId>`
Examples:
Przykłady:
- `openai/gpt-4.1`
- `openrouter/google/gemini-2.5-flash`
@@ -250,7 +250,7 @@ Aby rozwiązać ten problem:
---
### Problemy z AI_APICallError i pakietem dostawcy
### Błędy AI_APICallError i problemy z pakietami dostawców
Jeśli napotkasz błędy wywołań API, może to wynikać z nieaktualnych pakietów dostawców. opencode dynamicznie instaluje pakiety dostawców (OpenAI, Anthropic, Google itp.) w razie potrzeby i przechowuje je lokalnie w pamięci podręcznej.
@@ -270,7 +270,7 @@ Zmusi to opencode do pobrania najnowszych wersji pakietów dostawców, co częst
---
### Copy/paste not working on Linux
### Kopiowanie/wklejanie nie działa na Linuxie
Aby funkcja kopiowania/wklejania działała, użytkownicy systemu Linux muszą mieć zainstalowane jedno z następujących narzędzi schowka:

View File

@@ -369,7 +369,7 @@ Możesz dostosować zachowanie TUI za pomocą pliku konfiguracyjnego opencode.
}
```
### Options
### Opcje
- `scroll_acceleration` — Włącz przyspieszenie przewijania w stylu macOS, aby zapewnić płynne, naturalne przewijanie. Po włączeniu prędkość przewijania wzrasta wraz z szybkimi gestami przewijania i pozostaje precyzyjna w przypadku wolniejszych ruchów. **To ustawienie ma pierwszeństwo przed `scroll_speed` i zastępuje je, gdy jest włączone.**
- `scroll_speed` - Kontroluje szybkość przewijania TUI podczas korzystania z poleceń przewijania (minimum: `1`). Wartość domyślna to `3`. **Uwaga: jest to ignorowane, jeśli `scroll_acceleration.enabled` jest ustawione na `true`.**

View File

@@ -7,7 +7,7 @@ opencode może działać jako aplikacja internetowa w przeglądarce, zapewniają
![Sieć opencode - Nowa sesja](../../../assets/web/web-homepage-new-session.png)
## Getting Started
## Pierwsze kroki
Uruchom interfejs sieciowy, uruchamiając:
@@ -27,7 +27,7 @@ Aby uzyskać najlepsze wyniki, uruchom `opencode web` z [WSL](/docs/windows-wsl)
---
## Configuration
## Konfiguracja
Możesz skonfigurować serwer WWW za pomocą flag wiersza poleceń lub w [pliku konfiguracyjnym] (./config).
@@ -39,7 +39,7 @@ Domyślnie opencode wybiera dostępny port. Możesz określić port:
opencode web --port 4096
```
### Hostname
### Nazwa hosta
Domyślnie serwer łączy się z `127.0.0.1` (tylko localhost). Aby udostępnić opencode w swojej sieci:
@@ -54,7 +54,7 @@ Podczas korzystania z `0.0.0.0` opencode wyświetli zarówno adresy lokalne, jak
Network access: http://192.168.1.100:4096
```
### mDNS Discovery
### Wykrywanie mDNS
Włącz mDNS, aby Twój serwer był wykrywalny w sieci lokalnej:
@@ -78,7 +78,7 @@ Aby zezwolić na dodatkowe domeny dla CORS (przydatne w przypadku niestandardowy
opencode web --cors https://example.com
```
### Authentication
### Uwierzytelnianie
Aby chronić dostęp, ustaw hasło za pomocą zmiennej środowiskowej `OPENCODE_SERVER_PASSWORD`:
@@ -94,7 +94,7 @@ Domyślna nazwa użytkownika to `opencode`, ale można ją zmienić za pomocą `
Po uruchomieniu interfejs sieciowy zapewnia dostęp do sesji opencode.
### Sessions
### Sesje
Przeglądaj sesje i zarządzaj nimi ze strony głównej. Możesz zobaczyć aktywne sesje i rozpocząć nowe.
@@ -108,7 +108,7 @@ Kliknij „Zobacz serwery”, aby wyświetlić podłączone serwery i ich status
---
## Attaching a Terminal
## Podłączanie terminala
Możesz podłączyć terminal TUI do działającego serwera WWW:
@@ -124,7 +124,7 @@ Umożliwia to jednoczesne korzystanie z interfejsu sieciowego i terminala, wspó
---
## Config File
## Plik konfiguracyjny
Możesz także skonfigurować ustawienia serwera w pliku konfiguracyjnym `opencode.json`:

View File

@@ -19,11 +19,11 @@ opencode.
---
## Background
## Tło
There are a large number of models out there but only a few of
these models work well as coding agents. Additionally, most providers are
skonfigurowany bardzo różnie; więc otrzymujesz zupełnie inną wydajność i jakość.
Istnieje ogromna liczba modeli, ale tylko kilka z nich
działa dobrze jako agenci kodujący. Dodatkowo większość dostawców jest
skonfigurowana bardzo różnie; więc otrzymujesz zupełnie inną wydajność i jakość.
:::tip
Przetestowaliśmy wybraną grupę modeli i dostawców, którzy dobrze współpracują z opencode.
@@ -45,7 +45,7 @@ OpenCode Zen to brama AI, która zapewnia dostęp do tych modeli.
---
## How it works
## Jak to działa
OpenCode Zen działa jak każdy inny dostawca opencode.
@@ -58,7 +58,7 @@ Opłata jest pobierana za każde żądanie i możesz dodać kredyty do swojego k
---
## Endpoints
## Punkty końcowe
Dostęp do naszych modeli można również uzyskać za pośrednictwem następujących punktów końcowych API.
@@ -100,7 +100,7 @@ użyj `opencode/gpt-5.2-codex` w swojej konfiguracji.
---
### Models
### Modele
Pełną listę dostępnych modeli i ich metadane możesz pobrać z:
@@ -110,7 +110,7 @@ https://opencode.ai/zen/v1/models
---
## Pricing
## Cennik
Wspieramy model pay-as-you-go. Poniżej znajdują się ceny **za 1M tokenów**.
@@ -167,7 +167,7 @@ Darmowe modele:
---
### Auto-reload
### Automatyczne doładowanie
Jeśli Twoje saldo spadnie poniżej 5 USD, Zen automatycznie doładuje 20 USD.
@@ -175,7 +175,7 @@ Możesz zmienić kwotę automatycznego doładowania. Możesz także całkowicie
---
### Monthly limits
### Limity miesięczne
Możesz także ustawić miesięczny limit wykorzystania dla całego obszaru roboczego i dla każdego z nich
członek Twojego zespołu.
@@ -186,7 +186,7 @@ obciąży Cię kwotą wyższą niż 20 USD, jeśli saldo spadnie poniżej 5 USD.
---
## Privacy
## Prywatność
Wszystkie nasze modele są hostowane w USA. Nasi dostawcy przestrzegają polityki zerowego przechowywania i nie wykorzystują Twoich danych do szkolenia modeli, z następującymi wyjątkami:
@@ -213,7 +213,7 @@ wkrótce udostępnimy więcej szczegółów na temat cen.
---
### Roles
### Role
Możesz zapraszać członków zespołu do swojego obszaru roboczego i przypisywać role:
@@ -244,11 +244,11 @@ i chcesz go używać zamiast tego, który zapewnia Zen.
---
## Goals
## Cele
We created OpenCode Zen to:
Stworzyliśmy OpenCode Zen, aby:
1. **Benchmark** najlepsze modele/dostawcy dla agentów kodujących.
1. **Testować** (Benchmark) najlepsze modele/dostawców dla agentów kodujących.
2. Miej dostęp do opcji **najwyższej jakości**, a nie obniżaj wydajności ani nie kieruj się do tańszych dostawców.
3. Przekaż wszelkie **obniżki cen**, sprzedając po kosztach; więc jedyną marżą jest pokrycie naszych opłat manipulacyjnych.
4. Nie **nie blokuj**, umożliwiając używanie go z dowolnym innym agentem kodującym. I zawsze pozwalaj na korzystanie z opencode dowolnego innego dostawcy.