chore(docs): i18n sync (#15417)

This commit is contained in:
Adam
2026-02-28 15:27:11 -06:00
committed by GitHub
parent 971bd30516
commit e1e18c7abd
174 changed files with 6358 additions and 4392 deletions
+103 -97
View File
@@ -5,9 +5,9 @@ description: OpenCode 터미널 사용자 인터페이스 사용.
import { Tabs, TabItem } from "@astrojs/starlight/components"
opencode는 LLM과 함께 프로젝트를 위해 대화형 terminal 인터페이스 또는 TUI를 제공합니다.
OpenCode는 LLM과 함께 프로젝트 작업을 하기 위한 대화형 터미널 인터페이스(TUI)를 제공합니다.
opencode는 현재 디렉토리에 TUI를 시작합니다.
OpenCode를 실행하면 현재 디렉토리에서 TUI가 시작됩니다.
```bash
opencode
@@ -19,7 +19,7 @@ opencode
opencode /path/to/project
```
TUI에 있다면 메시지가 표시됩니다.
TUI에 들어가면 메시지를 입력하여 프롬프트할 수 있습니다.
```text
Give me a quick summary of the codebase.
@@ -29,10 +29,10 @@ Give me a quick summary of the codebase.
## 파일 참조
`@`를 사용하여 메시지에 파일을 참조 할 수 있습니다. 이것은 현재 작업 디렉토리에서 fuzzy 파일 검색입니다.
`@`를 사용하여 메시지에서 파일을 참조할 수 있습니다. 이것은 현재 작업 디렉토리에서 퍼지(fuzzy) 파일 검색을 수행합니다.
:::tip
`@`를 사용하여 메시지의 참조 파일을 사용할 수 있습니다.
`@`를 사용하여 메시지에서 파일을 참조할 수 있습니다.
:::
```text "@packages/functions/src/api/index.ts"
@@ -45,7 +45,7 @@ How is auth handled in @packages/functions/src/api/index.ts?
## Bash 명령
`!`를 사용하여 shell 명령을 실행합니다.
`!`로 메시지를 시작하여 셸 명령을 실행합니다.
```bash frame="none"
!ls -la
@@ -57,21 +57,21 @@ How is auth handled in @packages/functions/src/api/index.ts?
## 명령
opencode TUI를 사용할 때, `/`를 입력하여 명령 이름을 따라 작업을 신속하게 실행할 수 있습니다. 예를 들면:
OpenCode TUI를 사용할 때 `/` 뒤에 명령 이름을 입력하여 작업을 빠르게 실행할 수 있습니다. 예를 들어:
```bash frame="none"
/help
```
대부분의 명령은 `ctrl+x`를 `ctrl+x`가 기본 리더 키입니다. [더 알아보기](/docs/keybinds).
대부분의 명령에는 기본 리더 키인 `ctrl+x`를 사용하는 키바인드도 있습니다. [더 알아보기](/docs/keybinds).
여기에 모든 가능한 슬래시 명령이 있습니다.
사용 가능한 모든 슬래시 명령은 다음과 같습니다:
---
### /connect
### connect
opencode에 대한 공급자를 추가합니다. 사용 가능한 공급자에서 선택하고 API 키를 추가 할 수 있습니다.
OpenCode에 공급자를 추가합니다. 사용 가능한 공급자 중에서 선택하고 API 키를 추가할 수 있습니다.
```bash frame="none"
/connect
@@ -79,67 +79,67 @@ opencode에 대한 공급자를 추가합니다. 사용 가능한 공급자에
---
### /compact
### compact
현재 세션을 압축합니다. 앨리스 : `/summarize`
현재 세션을 압축합니다. _별칭_: `/summarize`
```bash frame="none"
/compact
```
** Keybind:** `ctrl+x c`
**키바인드:** `ctrl+x c`
---
### /details
### details
토글 툴 실행 세부 사항.
도구 실행 세부 정보 토글.
```bash frame="none"
/details
```
** Keybind:** `ctrl+x d`
**키바인드:** `ctrl+x d`
---
### /editor
### editor
메시지를 작성하기 위한 외부 편집기를 엽니다. `EDITOR` 환경에서 설정된 편집기를 사용합니다. [더 알아보기](#editor-setup).
메시지 작성을 위한 외부 편집기를 엽니다. `EDITOR` 환경 변수에 설정된 편집기를 사용합니다. [더 알아보기](#editor-setup).
```bash frame="none"
/editor
```
** Keybind:** `ctrl+x e`
**키바인드:** `ctrl+x e`
---
### /exit
### exit
opencode를 종료합니다. Aliases : `/quit`, `/q`
OpenCode를 종료합니다. _별칭_: `/quit`, `/q`
```bash frame="none"
/exit
```
** Keybind:** `ctrl+x q`
**키바인드:** `ctrl+x q`
---
### /export
### export
Markdown에 대한 현재 대화를 내보내고 기본 편집기에서 열립니다. `EDITOR` 환경에서 설정된 편집기를 사용합니다. [더 알아보기](#editor-setup).
현재 대화를 Markdown으로 내보내고 기본 편집기에서 엽니다. `EDITOR` 환경 변수에 설정된 편집기를 사용합니다. [더 알아보기](#editor-setup).
```bash frame="none"
/export
```
** Keybind:** `ctrl+x x`
**키바인드:** `ctrl+x x`
---
### /help
### help
도움말 대화 상자를 표시합니다.
@@ -147,107 +147,106 @@ Markdown에 대한 현재 대화를 내보내고 기본 편집기에서 열립
/help
```
** Keybind:** `ctrl+x h`
**키바인드:** `ctrl+x h`
---
###### /init
### init
`AGENTS.md` 파일을 만들거나 업데이트하십시오. [더 알아보기](/docs/rules).
`AGENTS.md` 파일을 생성하거나 업데이트합니다. [더 알아보기](/docs/rules).
```bash frame="none"
/init
```
** Keybind:** `ctrl+x i`
**키바인드:** `ctrl+x i`
---
## /models
### models
사용 가능한 모델 목록.
사용 가능한 모델 목록을 표시합니다.
```bash frame="none"
/models
```
** Keybind:** `ctrl+x m`
**키바인드:** `ctrl+x m`
---
## /new
### new
새로운 세션을 시작합니다. 앨리스 : `/clear`
새 세션을 시작합니다. _별칭_: `/clear`
```bash frame="none"
/new
```
** Keybind:** `ctrl+x n`
**키바인드:** `ctrl+x n`
---
##### /redo
### redo
이전 undone 메시지 Redo. `/undo`를 사용하는 후에만 유효한.
이전에 실행 취소한 메시지를 다시 실행합니다. `/undo`를 사용한 후에만 사용할 수 있습니다.
:::tip
모든 파일 변경도 복원됩니다.
모든 파일 변경 사항도 복원됩니다.
:::
내부적으로 Git을 사용하여 파일 변경을 관리합니다. 그래서 프로젝트 **
Git 저장소**입니다.
내부적으로 Git을 사용하여 파일 변경 사항을 관리합니다. 따라서 프로젝트가 **Git 저장소**여야 합니다.
```bash frame="none"
/redo
```
** Keybind:** `ctrl+x r`
**키바인드:** `ctrl+x r`
---
## /sessions
### sessions
세션 간 목록 및 전환. Aliases : `/resume`, `/continue`
세션 목록을 표시하고 세션 간을 전환합니다. _별칭_: `/resume`, `/continue`
```bash frame="none"
/sessions
```
** Keybind:** `ctrl+x l`
**키바인드:** `ctrl+x l`
---
## 공유
### share
현재 세션 공유. [더 알아보기](/docs/share).
현재 세션을 공유합니다. [더 알아보기](/docs/share).
```bash frame="none"
/share
```
** Keybind:** `ctrl+x s`
**키바인드:** `ctrl+x s`
---
## /theme
### themes
사용할 수 있는 테마 목록.
사용 가능한 테마 목록을 표시합니다.
```bash frame="none"
/theme
/themes
```
** Keybind:** `ctrl+x t`
**키바인드:** `ctrl+x t`
---
### /thinking
### thinking
대화의 사고/거주 블록의 가시성을 토합니다. 사용할 때, 확장 된 생각을 지원하는 모델의 이유 프로세스를 볼 수 있습니다.
대화에서 생각/추론 블록의 가시성을 토글합니다. 활성화하면 확장된 사고를 지원하는 모델의 추론 과정을 볼 수 있습니다.
:::note
이 명령은 생각 블록이 ** 표시되었는지 여부 만 제어 ** - 모델의 소싱 기능을 활성화하거나 비활성화하지 않습니다. toggle 실제적인 reasoning 기능에, 모형 변종을 통해서 주기 위하여 `ctrl+t`를 이용합니다.
이 명령은 생각 블록이 **표시되는지 여부만 제어**하며 모델의 추론 기능을 활성화하거나 비활성화하지 않습니다. 실제 추론 기능을 토글하려면 `ctrl+t`를 사용하여 모델 변형을 순환하십시오.
:::
```bash frame="none"
@@ -256,28 +255,27 @@ Git 저장소**입니다.
---
##### /undo
### undo
대화에서 마지막 메시지. 가장 최근의 사용자 메시지, 모든 후속 응답 및 모든 파일 변경 제거.
대화의 마지막 메시지를 실행 취소합니다. 가장 최근의 사용자 메시지, 모든 후속 응답 및 모든 파일 변경 사항을 제거합니다.
:::tip
어떤 파일 변경도 복제됩니다.
모든 파일 변경 사항도 되돌려집니다.
:::
내부적으로 Git을 사용하여 파일 변경을 관리합니다. 그래서 프로젝트 **
Git 저장소**입니다.
내부적으로 Git을 사용하여 파일 변경 사항을 관리합니다. 따라서 프로젝트가 **Git 저장소**여야 합니다.
```bash frame="none"
/undo
```
** Keybind:** `ctrl+x u`
**키바인드:** `ctrl+x u`
---
#### /unshare
### unshare
Unshare 현재 세션. [더 알아보기](/docs/share#un-sharing).
현재 세션 공유를 취소합니다. [더 알아보기](/docs/share#un-sharing).
```bash frame="none"
/unshare
@@ -285,9 +283,9 @@ Unshare 현재 세션. [더 알아보기](/docs/share#un-sharing).
---
## 편집기 설정
## Editor setup
`/editor`와 `/export` 명령 모두는 `EDITOR` 환경변수에서 지정된 편집기를 사용합니다.
`/editor`와 `/export` 명령 모두 `EDITOR` 환경 변수에 지정된 편집기를 사용합니다.
<Tabs>
<TabItem label="Linux/macOS">
@@ -301,8 +299,7 @@ Unshare 현재 세션. [더 알아보기](/docs/share#un-sharing).
export EDITOR="code --wait"
```
영원한 만들기 위하여, 당신의 shell 프로파일에 이것을 추가하십시오;
`~/.bashrc`, `~/.zshrc`, 등.
영구적으로 설정하려면 셸 프로필(`~/.bashrc`, `~/.zshrc` 등)에 추가하십시오.
</TabItem>
@@ -315,8 +312,7 @@ Unshare 현재 세션. [더 알아보기](/docs/share#un-sharing).
set EDITOR=code --wait
```
영구적으로, use **System Properties** > ** 환경
변수**.
영구적으로 설정하려면 **시스템 속성** > **환경 변수**를 사용하십시오.
</TabItem>
@@ -329,62 +325,72 @@ Unshare 현재 세션. [더 알아보기](/docs/share#un-sharing).
$env:EDITOR = "code --wait"
```
영구적으로 만들려면 PowerShell 프로파일에 추가하십시오.
영구적으로 설정하려면 PowerShell 프로필에 추가하십시오.
</TabItem>
</Tabs>
인기있는 편집기 옵션은 다음과 같습니다 :
인기 있는 편집기 옵션은 다음과 같습니다:
- `code` - Visual Studio 코드
- `cursor` - 커서
- `windsurf` - 윈드 서핑
- `nvim` - Neovim 편집기
- `vim` - Vim 편집기
- `nano` - 나노 편집기
- `notepad` - 윈도우 노트패드
- `subl` - 승화 텍스트
- `code` - Visual Studio Code
- `cursor` - Cursor
- `windsurf` - Windsurf
- `nvim` - Neovim editor
- `vim` - Vim editor
- `nano` - Nano editor
- `notepad` - Windows Notepad
- `subl` - Sublime Text
:::note
VS Code와 같은 일부 편집기는 `--wait` 플래그와 함께 시작해야합니다.
VS Code와 같은 일부 편집기는 `--wait` 플래그와 함께 시작해야 합니다.
:::
일부 편집기는 명령줄 인수가 차단 모드에서 실행되어야 합니다. `--wait` 플래그는 닫힐 때까지 편집기 프로세스 블록을 만듭니다.
일부 편집기는 차단 모드에서 실행하려면 명령줄 인수가 필요합니다. `--wait` 플래그는 편집기 프로세스가 닫힐 때까지 차단되도록 합니다.
---
## 구성
opencode config 파일을 통해 TUI 동작을 사용자 정의할 수 있습니다.
`tui.json` (또는 `tui.jsonc`) 파일을 통해 TUI 동작을 사용자 정의할 수 있습니다.
```json title="opencode.json"
```json title="tui.json"
{
"$schema": "https://opencode.ai/config.json",
"tui": {
"scroll_speed": 3,
"scroll_acceleration": {
"enabled": true
}
}
"$schema": "https://opencode.ai/tui.json",
"theme": "opencode",
"keybinds": {
"leader": "ctrl+x"
},
"scroll_speed": 3,
"scroll_acceleration": {
"enabled": true
},
"diff_style": "auto"
}
```
이는 서버/런타임 동작을 구성하는 `opencode.json`과는 별개입니다.
### 옵션
- `scroll_acceleration` - 부드러운 자연 스크롤을위한 macOS 스타일 스크롤 가속 가능. 사용할 때, 스크롤 속도는 빠른 스크롤 제스처로 증가하고 느린 움직임을 위해 정확한 유지. **이 설정은 `scroll_speed`를 통해 우선 순위를 부여하고 활성화 할 때. **
- `scroll_speed` - 스크롤 명령 (최소 : `1`)을 사용하여 TUI 스크롤을 빠르게 제어합니다. 기본 `3`. ** 참고: `scroll_acceleration.enabled`가 `true`로 설정되면 무시됩니다.**
- `theme` - UI 테마를 설정합니다. [더 알아보기](/docs/themes).
- `keybinds` - 키보드 단축키를 사용자 정의합니다. [더 알아보기](/docs/keybinds).
- `scroll_acceleration.enabled` - 부드럽고 자연스러운 스크롤을 위해 macOS 스타일의 스크롤 가속을 활성화합니다. 활성화하면 빠른 스크롤 제스처로 스크롤 속도가 증가하고 느린 움직임에서는 정밀하게 유지됩니다. **이 설정은 `scroll_speed`보다 우선하며 활성화 시 이를 덮어씁니다.**
- `scroll_speed` - 스크롤 명령을 사용할 때 TUI 스크롤 속도를 제어합니다 (최소: `0.001`, 소수점 값 지원). 기본값은 `3`입니다. **참고: `scroll_acceleration.enabled`가 `true`로 설정되면 무시됩니다.**
- `diff_style` - diff 렌더링 방식을 제어합니다. `"auto"`는 터미널 너비에 적응하고, `"stacked"`는 항상 단일 열 레이아웃을 표시합니다.
`OPENCODE_TUI_CONFIG`를 사용하여 사용자 정의 TUI 설정 경로를 로드할 수 있습니다.
---
## 사용자 정의
명령 팔레트 (`ctrl+x h` 또는 `/help`)를 사용하여 TUI보기의 다양한 측면을 사용자 정의 할 수 있습니다. 재시작에 따른 설정 persist.
명령 팔레트(`ctrl+x h` 또는 `/help`)를 사용하여 TUI 보기의 다양한 측면을 사용자 정의할 수 있습니다. 설정은 다시 시작해도 유지됩니다.
---
#### 사용자 이름 표시
사용자 이름이 채팅 메시지에 나타나는지 여부를 수정합니다. 이것을 통해 접근:
채팅 메시지에 사용자 이름이 표시되는지 여부를 토글합니다. 다음을 통해 액세스:
- 명령 팔레트 : "username" 또는 "hide 사용자" 검색
- 자동 설정은 TUI 세션을 통해 기억됩니다.
- 명령 팔레트: "username" 또는 "hide username" 검색
- 설정은 자동으로 유지되며 TUI 세션 간에 기억됩니다.