docs: add OpenChamber feature docs and translations (#1400)
* docs: add OpenChamber feature docs and translations Add 30 new docs pages covering OpenChamber-specific workflows and setup: OpenCode server, providers/models/agents, MCP, skills, commands & snippets, usage, projects, context, notes/todos/plans, scheduled tasks, project actions, preview, worktrees, multi-run, git & GitHub, magic prompts, git identities, mobile/PWA, security, notifications, voice, project icons, remote instances, desktop browser, updates, and three troubleshooting pages. Rebuild sidebar into eight task-oriented sections and translate every new page into all six supported locales (uk, zh-cn, es, pt-br, ko, pl). * docs: surface new sections on homepage and cross-link tunnels Add an Explore block to the docs homepage (all seven locales) linking to the new section anchors, and cross-link the Tunnels page to Security and PWA & Mobile.
This commit is contained in:
committed by
GitHub
parent
bf6043a472
commit
967704a9b9
@@ -0,0 +1,34 @@
|
||||
---
|
||||
title: OpenCode 연결
|
||||
description: OpenChamber가 OpenCode 서버에 연결되지 않는 문제를 해결하세요.
|
||||
---
|
||||
|
||||
# OpenCode 연결
|
||||
|
||||
OpenChamber가 로드되지만 "OpenCode is restarting"에서 넘어가지 못하거나 채팅이 응답하지 않는다면, 통신하는 서버에 접근할 수 없는 상태입니다. 다음을 차례로 확인하세요.
|
||||
|
||||
## "OpenCode is restarting"에서 멈춰 있음
|
||||
|
||||
- 실행 직후에는 잠시 기다리세요. 서버가 시작되는 동안에는 정상적인 상태입니다
|
||||
- `openchamber status`로 서버가 살아 있는지 확인합니다
|
||||
- `openchamber restart`로 재시작합니다
|
||||
- `openchamber logs`로 시작 세부 정보를 봅니다
|
||||
|
||||
## 직접 운영하는 서버에 연결 중
|
||||
|
||||
OpenChamber가 기존 서버를 사용하도록 설정했다면 [OpenCode Server](/ko/opencode-server/)의 설정을 다시 확인하세요.
|
||||
|
||||
- `OPENCODE_HOST`에는 포트가 포함되어야 하며 경로가 없어야 합니다(예: `http://localhost:4096`)
|
||||
- OpenChamber가 자체 서버를 함께 시작하지 않도록 `OPENCODE_SKIP_START=true`를 설정합니다
|
||||
- 주소가 올바르지 않으면 OpenChamber가 이를 무시하고 자체 서버를 시작합니다. 로그에서 `[config]` 경고를 찾아보세요
|
||||
|
||||
## 여전히 실패함
|
||||
|
||||
- Node.js 버전이 `20` 이상인지 확인합니다
|
||||
- 최신 CLI를 다시 설치합니다
|
||||
- 터널이나 원격 링크를 테스트하기 전에 `http://localhost:3000`을 직접 엽니다
|
||||
|
||||
## 관련 항목
|
||||
|
||||
- [OpenCode Server](/ko/opencode-server/) — OpenChamber가 서버를 찾고 관리하는 방법
|
||||
- [문제 해결](/ko/troubleshooting/) — 다른 일반적인 문제
|
||||
@@ -0,0 +1,38 @@
|
||||
---
|
||||
title: 원격 접속
|
||||
description: 터널, 원격 인스턴스, 다른 기기에서 OpenChamber에 접근하는 문제를 해결하세요.
|
||||
---
|
||||
|
||||
# 원격 접속
|
||||
|
||||
휴대폰이나 다른 컴퓨터에서 OpenChamber에 접근할 수 없을 때, 해결 방법은 연결 방식에 따라 다릅니다.
|
||||
|
||||
## 먼저 기본 사항 확인
|
||||
|
||||
- 같은 컴퓨터에서 `http://localhost:3000`을 먼저 엽니다. 이것이 실패하면 원격 문제가 아닙니다. [OpenCode 연결](/ko/troubleshooting/opencode-connection/)을 참고하세요
|
||||
- `openchamber status`로 서버가 실행 중인지 확인합니다
|
||||
|
||||
## 터널 링크가 작동하지 않음
|
||||
|
||||
- `openchamber tunnel status --all`을 실행합니다
|
||||
- 같은 인스턴스와 포트에서 터널을 재시작합니다
|
||||
- 이전 링크가 이미 사용되었다면 연결 링크를 다시 생성합니다
|
||||
|
||||
전체 설정은 [Tunnels](/ko/tunnels/)를 참고하세요.
|
||||
|
||||
## 원격 인스턴스가 연결되지 않음(데스크톱)
|
||||
|
||||
[원격 인스턴스](/ko/remote-instances/)가 멈추면 OpenChamber가 실패한 단계를 알려줍니다.
|
||||
|
||||
- **auth** — SSH 또는 UI 비밀번호가 거부됨. 다시 입력하세요
|
||||
- **install / start** — OpenChamber가 원격 컴퓨터에서 서버를 설정하거나 시작하지 못함. 그 컴퓨터의 요구 사항을 확인하세요
|
||||
- **forwarding** — 연결은 되었지만 포트가 도달하지 않음. 다른 로컬 포트를 시도하세요
|
||||
|
||||
## 자체 서버 뒤에 있음
|
||||
|
||||
OpenChamber를 리버스 프록시 뒤에 두었는데 이상하게 로드되거나 연결되지 않으면 [Reverse Proxy](/ko/reverse-proxy/)를 참고하세요.
|
||||
|
||||
## 관련 항목
|
||||
|
||||
- [Tunnels](/ko/tunnels/) · [Remote Instances](/ko/remote-instances/) · [Reverse Proxy](/ko/reverse-proxy/)
|
||||
- [Security](/ko/security/) — 노출하기 전에 UI를 보호하세요
|
||||
@@ -0,0 +1,35 @@
|
||||
---
|
||||
title: Worktree 및 Git
|
||||
description: 일반적인 worktree 및 git 문제를 해결하세요.
|
||||
---
|
||||
|
||||
# Worktree 및 Git
|
||||
|
||||
[worktree 세션](/ko/worktrees/)과 [git 보기](/ko/git/)에서 발생하는 문제와 해결 방법입니다.
|
||||
|
||||
## worktree에 주의가 필요함
|
||||
|
||||
OpenChamber는 무언가 잘못되면 worktree를 표시합니다.
|
||||
|
||||
- **folder missing** — worktree의 폴더가 OpenChamber 외부에서 삭제되거나 이동됨. 세션을 제거하고 새 worktree를 만드세요
|
||||
- **detached or unborn branch** — worktree가 정상적인 브랜치에 있지 않음. 정상 브랜치로 체크아웃하세요
|
||||
- **merge, rebase, or cherry-pick in progress** — 작업이 절반만 끝남. git 보기에서 완료하거나 중단하세요
|
||||
|
||||
## worktree를 만들 수 없음
|
||||
|
||||
- **branch already exists** — 다른 브랜치 이름을 선택하거나 existing-branch 옵션을 사용하세요
|
||||
- **name already in use** — 다른 worktree 이름을 선택하세요
|
||||
|
||||
## 커밋 또는 PR 생성 실패
|
||||
|
||||
커밋 메시지나 PR 설명 생성은 활성 세션에서 실행되므로, 작동하는 모델이 선택된 세션이 열려 있어야 합니다. 세션을 열거나 선택한 뒤 다시 시도하세요.
|
||||
|
||||
## SSH 또는 Windows 경로 문제
|
||||
|
||||
- 저장소가 사용하는 SSH 키가 [git 신원](/ko/git-identities/)에 설정된 것과 같은지 확인하세요
|
||||
- Windows에서 git은 Unix 스타일 경로(예: `/c/Users/...`)를 사용합니다. OpenChamber가 이를 처리하지만, 사용자 지정 SSH 키 경로도 같은 형식을 따라야 합니다
|
||||
|
||||
## 관련 항목
|
||||
|
||||
- [Worktree Sessions](/ko/worktrees/) — worktree가 생성되고 제거되는 방법
|
||||
- [Git Identities](/ko/git-identities/) — 저장소마다 올바른 키와 신원을 설정하세요
|
||||
Reference in New Issue
Block a user