wip(docs): i18n (#12681)

This commit is contained in:
Adam
2026-02-09 11:34:35 -06:00
committed by GitHub
parent f74c0339cc
commit dc53086c1e
642 changed files with 192745 additions and 509 deletions

View File

@@ -0,0 +1,299 @@
---
title: komandant
description: Kreirajte prilagođene komande za zadatke koji se ponavljaju.
---
Prilagođene komande vam omogućavaju da odredite prompt koji želite da pokrenete kada se ta naredba izvrši u TUI-ju.
```bash frame="none"
/my-command
```
Prilagođene komande su dodatak ugrađenim komandama kao što su `/init`, `/undo`, `/redo`, `/share`, `/help`. [Saznajte više](/docs/tui#commands).
---
## Kreirajte komandne fajlove
Kreirajte mardown fajlove u direktorijumu `commands/` da definišete prilagođene komande.
Kreiraj `.opencode/commands/test.md`:
```md title=".opencode/commands/test.md"
---
description: Run tests with coverage
agent: build
model: anthropic/claude-3-5-sonnet-20241022
---
Run the full test suite with coverage report and show any failures.
Focus on the failing tests and suggest fixes.
```
Frontmatter definira svojstva komande. Sadržaj postaje predložak.
Koristite komandu tako što ćete upisati `/` nakon čega slijedi naziv komande.
```bash frame="none"
"/test"
```
---
## Konfiguriši
Možete dodati prilagođene komande kroz OpenCode konfiguraciju ili kreiranjem markdown datoteka u direktoriju `commands/`.
---
### JSON
Koristite opciju `command` u svom OpenCode [config](/docs/config):
```json title="opencode.jsonc" {4-12}
{
"$schema": "https://opencode.ai/config.json",
"command": {
// This becomes the name of the command
"test": {
// This is the prompt that will be sent to the LLM
"template": "Run the full test suite with coverage report and show any failures.\nFocus on the failing tests and suggest fixes.",
// This is shown as the description in the TUI
"description": "Run tests with coverage",
"agent": "build",
"model": "anthropic/claude-3-5-sonnet-20241022"
}
}
}
```
Sada možete pokrenuti ovu naredbu u TUI:
```bash frame="none"
/test
```
---
### Markdown
Također možete definirati komande koristeći mardown datoteke. Stavite ih u:
- Globalno: `~/.config/opencode/commands/`
- Po projektu: `.opencode/commands/
````markdown title="~/.config/opencode/commands/test.md"
---
description: Run tests with coverage
agent: build
model: anthropic/claude-3-5-sonnet-20241022
---
Run the full test suite with coverage report and show any failures.
Focus on the failing tests and suggest fixes.
```
Ime datoteke za označavanje postaje ime naredbe. Na primjer, `test.md` dozvoljava
pokrećeš:
```bash frame="none"
/test
```
---
## Prompt config
Promptovi za prilagođene komande podržavaju nekoliko posebnih čuvara mjesta i sintakse.
---
### Argumenti
Proslijedite argumente naredbama koristeći čuvar mjesta `$ARGUMENTS`.
```md title=".opencode/commands/component.md"
---
description: Create a new component
---
Create a new React component named $ARGUMENTS with TypeScript support.
Include proper typing and basic structure.
```
Pokrenite naredbu s argumentima:
```bash frame="none"
/componentButton
```
I `$ARGUMENTS` će biti zamijenjen sa `Button`.
Također možete pristupiti pojedinačnim argumentima koristeći pozicione parametre:
- `$1` - Prvi argument
- `$2` - Drugi argument
- `$3` - Treći argument
- I tako dalje...
na primjer:
```md title=".opencode/commands/create-file.md"
---
description: Create a new file with content
---
Create a file named $1 in the directory $2
with the following content: $3
```
Pokrenite naredbu:
```bash frame="none"
/create-file config.json src "{ \"key\": \"value\" }"
```
Ovo zamjenjuje:
- `$1` do `config.json`
- `$2` do `src`
- `$3` do `{ "key": "value" }`
---
### Izlaz ljuske
Koristite _!`command`_ da ubacite [bash command](/docs/tui#bash-commands) izlaz u svoj prompt.
Na primjer, da kreirate prilagođenu naredbu koja analizira pokrivenost testom:
```md title=".opencode/commands/analyze-coverage.md"
---
description: Analyze test coverage
---
Here are the current test results:
!`npm test`
Based on these results, suggest improvements to increase coverage.
```
Ili da vidite nedavne promjene:
```md title=".opencode/commands/review-changes.md"
---
opis: Pregledajte nedavne promjene
---
Nedavna git urezivanja:
!`git log --oneline -10`
Pregledajte ove promjene i predložite bilo kakva poboljšanja.
```
Naredbe se pokreću u korijenskom direktoriju vašeg projekta i njihov izlaz postaje dio prompta.
---
### Reference fajlova
Uključite datoteke u svoju naredbu koristeći `@` nakon čega slijedi naziv datoteke.
```md title=".opencode/commands/review-component.md"
---
description: Review component
---
Review the component in @src/components/Button.tsx.
Check for performance issues and suggest improvements.
```
Sadržaj datoteke se automatski uključuje u prompt.
---
## Opcije
Pogledajmo detaljno opcije konfiguracije.
---
### Template
Opcija `template` definira prompt koji će biti poslan LLM-u kada se naredba izvrši.
```json title="opencode.json"
{
"komanda": {
"test": {
"template": "Pokrenite kompletan testni paket sa izvještajem o pokrivenosti i pokažite sve greške.\nFokusirajte se na neuspjele testove i predložite popravke." }
}
}
```
Ovo je **obavezna** opcija konfiguracije.
---
### Opis
Koristite opciju `description` da pružite kratak opis onoga što naredba radi.
```json title="opencode.json"
{
"command": {
"test": {
"description": "Run tests with coverage"
}
}
}
```
Ovo se prikazuje kao opis u TUI-u kada unesete naredbu.
---
### Agent
Koristite `agent` konfiguraciju da opciono odredite koji [agent](/docs/agents) treba da izvrši ovu naredbu.
Ako je ovo [subagent](/docs/agents/#subagents) naredba će po defaultu pokrenuti pozivanje subagenta.
Da onemogućite ovo ponašanje, postavite `subtask` na `false`.
```json title="opencode.json"
{
"komanda": {
"recenzija": {
"agent": "plan" }
}
}
```
Ovo je **opciona** opcija konfiguracije. Ako nije navedeno, podrazumevano je vaš trenutni agent.
---
### Subdatatak
Koristite `subtask` boolean da prisilite naredbu da pokrene [subagent](/docs/agents/#subagents) pozivanje.
Ovo je korisno ako želite da naredba ne zagađuje vaš primarni kontekst i da će **primorati** agenta da djeluje kao subagent,
čak i ako je `mode` postavljeno na `primary` u konfiguraciji [agent](/docs/agents).
```json title="opencode.json"
{
"command": {
"analyze": {
"subtask": true
}
}
}
```
Ovo je **opciona** opcija konfiguracije.
---
### Model
Koristite `model` konfiguraciju da nadjačate zadani model za ovu naredbu.
```json title="opencode.json"
{
"komanda": {
"analizirati": {
"model": "antropski/claude-3-5-sonnet-20241022" }
}
}
```
Ovo je **opciona** opcija konfiguracije.
---
## Embedded
opencode uključuje nekoliko ugrađenih naredbi kao što su `/init`, `/undo`, `/redo`, `/share`, `/help`; [saznaj više](/docs/tui#commands).
:::napomena
Prilagođene komande mogu nadjačati ugrađene komande.
:::
Ako definirate prilagođenu naredbu s istim imenom, ona će nadjačati ugrađenu naredbu.