Skip to content

Commit 60f1598

Browse files
itigges22itigges22
committed
docs(i18n): sync documentation corrections
1 parent 175f5a2 commit 60f1598

6 files changed

Lines changed: 51 additions & 36 deletions

File tree

‎docs/lang/ja/README.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<!-- source: README.md synced-through: fe64417 -->
1+
<!-- source: README.md synced-through: 175f5a2 -->
22
> **[English](../../../README.md)** | **[简体中文](../zh-CN/README.md)** | **日本語** | **[한국어](../ko/README.md)**
33
44
<p align="center">
@@ -34,8 +34,8 @@
3434
* **受け入れる前に検証する。** 生成されたコードは、分離された実行環境の中でコンパイル・テスト・修正できます。
3535
* **計算資源を要所に集中させる。** 単純な編集は短いパスで済ませ、難しいタスクにはより多くの候補・推論・検証を割り当てます。
3636
* **自分のモデルを動かす。** NVIDIA、AMD、Apple Silicon、Vulkan、あるいは CPU 対応ハードウェア上で、互換性のある GGUF モデルを使えます。
37-
* **すべてをローカルに保つ。** リポジトリ、推論、テスト実行、学習済みアーティファクトはあなたのマシンから出ません。
38-
* **スタック全体を所有する。** ATLAS はオープンソースかつセルフホストで、必須のホスト型 API もトークン課金もありません。
37+
* **ローカルで管理する。** ATLAS は、リポジトリやプロンプトをホスト型モデルまたは ATLAS 運営サービスへ意図的にアップロードしません。サンドボックスコマンドはデフォルトで外部ネットワークへアクセスできます。無効にするには `ATLAS_SANDBOX_NET_INTERNAL=true` を設定してください。
38+
* **スタック全体を所有する。** ATLAS はオープンソースかつセルフホストです。ホスト型モデルやサードパーティのモデルプロバイダー API キーは不要で、ローカルのインストール単位のサービストークンが ATLAS サービス間を認証します。
3939

4040
---
4141

@@ -73,7 +73,7 @@
7373

7474
2. **[atlas-proxy](../../ARCHITECTURE.md#3-atlas-proxy-outer-layer)** - システム全体を統括する Go 製エージェントループ。
7575
- [ツールコールルーティング](../../ARCHITECTURE.md#tools) - ファイル操作を複雑度ティアで分類
76-
- [文法強制](../../ARCHITECTURE.md#grammar-enforcement) - GBNF スキーマで JSON 出力の妥当性を担保
76+
- [文法強制](../../ARCHITECTURE.md#grammar-enforcement) - GBNF スキーマで期待される JSON 形式へ強く誘導し、不正または切り詰められた出力はプロキシ側で回復
7777
- [BiasBusters](../../ARCHITECTURE.md#tool-selection-bias-mitigations) - 構造的なコード編集でモデルを `ast_edit` へ誘導する4つの複合的な緩和策（説明文、文法禁則、システムノート、ASA ステアリング）
7878
- [安全制限](../../ARCHITECTURE.md#safety-limits) - ターン上限、トークン予算、タイムアウト
7979

‎docs/lang/ja/TROUBLESHOOTING.md‎

Lines changed: 13 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<!-- source: docs/TROUBLESHOOTING.md synced-through: fe64417 -->
1+
<!-- source: docs/TROUBLESHOOTING.md synced-through: 175f5a2 -->
22
> **[English](../../TROUBLESHOOTING.md)** | **[简体中文](../zh-CN/TROUBLESHOOTING.md)** | **日本語** | **[한국어](../ko/TROUBLESHOOTING.md)**
33
44
# ATLAS トラブルシューティングガイド
@@ -9,19 +9,24 @@
99

1010
## クイック診断
1111

12-
まず以下を実行して、問題の箇所を特定してください:
12+
まず `atlas doctor` を実行し、次に Compose の状態とログから問題箇所を特定してください:
1313

1414
```bash
15-
# Docker Compose — check all services at once
15+
atlas doctor
1616
docker compose ps
17-
18-
# GPU status
19-
nvidia-smi
20-
21-
# Docker Compose logs (last 50 lines per service)
2217
docker compose logs --tail 50
2318
```
2419

20+
`atlas doctor` はホスト、設定、サービスのヘルスをまとめて確認するため、最初に使う診断コマンドです。`docker compose ps` は起動に失敗したサービスを特定し、ログは次の段階の詳細を示します。最初の結果が推論バックエンドを指している場合にのみ、ハードウェア固有の確認を行ってください:
21+
22+
| バックエンド | 診断コマンドまたは確認項目 |
23+
|---|---|
24+
| NVIDIA CUDA | `nvidia-smi` |
25+
| AMD ROCm | `rocm-smi` を実行し、`/dev/kfd` が存在することを確認します。 |
26+
| Apple Silicon / Metal | `atlas doctor` を実行します。ネイティブサーバーが待ち受けていない場合は、[SETUP_MACOS.md](../../SETUP_MACOS.md#troubleshooting) の説明に従って `./scripts/atlas-llama-macos.sh` を起動し、フォアグラウンドのランチャー出力を確認します。 |
27+
| Vulkan | `/dev/dri` が存在することを確認し、`docker compose -f docker-compose.yml -f docker-compose.vulkan.yml exec llama-server vulkaninfo --summary` を実行します。 |
28+
| CPU のみ | `docker-compose.vulkan.yml` と `docker-compose.cpu.yml` のオーバーレイが有効であることを確認します。GPU がないことだけを理由に `atlas doctor` が失敗するのではなく、警告を出して正常終了するはずです。 |
29+
2530
サービスごとのヘルスチェック curl は [SETUP.md § インストールの確認](./SETUP.md#インストールの確認) を参照してください。トリアージには atlas-proxy のヘルスエンドポイントがもっとも有用です — すべての上流サービスのステータスを報告します:
2631
```json
2732
{

‎docs/lang/ko/README.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<!-- source: README.md synced-through: fe64417 -->
1+
<!-- source: README.md synced-through: 175f5a2 -->
22
> **[English](../../../README.md)** | **[简体中文](../zh-CN/README.md)** | **[日本語](../ja/README.md)** | **한국어**
33
44
<p align="center">
@@ -34,8 +34,8 @@
3434
* **받아들이기 전에 검증합니다.** 생성된 코드는 격리된 실행 환경 안에서 컴파일·테스트·수정될 수 있습니다.
3535
* **연산을 필요한 곳에 씁니다.** 단순한 편집은 짧은 경로를 타고, 어려운 작업일수록 더 많은 후보·추론·검증을 받습니다.
3636
* **본인 모델을 돌립니다.** NVIDIA, AMD, Apple Silicon, Vulkan, CPU 지원 하드웨어에서 호환 GGUF 모델을 사용할 수 있습니다.
37-
* **모든 것을 로컬에 둡니다.** 저장소, 추론, 테스트 실행, 학습된 아티팩트가 전부 본인 머신에 남습니다.
38-
* **스택 전체를 소유합니다.** ATLAS는 오픈 소스이고 셀프 호스팅이며, 필수 호스팅 API나 토큰당 과금이 없습니다.
37+
* **로컬에서 관리합니다.** ATLAS는 저장소나 프롬프트를 호스팅 모델 또는 ATLAS 운영 서비스에 의도적으로 업로드하지 않습니다. 샌드박스 명령은 기본적으로 외부 네트워크에 접근할 수 있으며, `ATLAS_SANDBOX_NET_INTERNAL=true`로 비활성화할 수 있습니다.
38+
* **스택 전체를 소유합니다.** ATLAS는 오픈 소스이며 셀프 호스팅됩니다. 호스팅 모델이나 타사 모델 제공업체 API 키는 필요하지 않으며, 로컬 설치별 서비스 토큰이 ATLAS 서비스 간 통신을 인증합니다.
3939

4040
---
4141

@@ -73,7 +73,7 @@
7373

7474
2. **[atlas-proxy](../../ARCHITECTURE.md#3-atlas-proxy-outer-layer)** - 시스템을 오케스트레이션하는 Go 에이전트 루프.
7575
- [도구 호출 라우팅](../../ARCHITECTURE.md#tools) - 파일 작업을 복잡도 등급별로 분류
76-
- [문법 강제](../../ARCHITECTURE.md#grammar-enforcement) - GBNF 스키마로 JSON 출력의 유효성을 보장
76+
- [문법 강제](../../ARCHITECTURE.md#grammar-enforcement) - GBNF 스키마로 출력을 예상 JSON 형식 쪽으로 강하게 유도하고, 잘못되거나 잘린 출력은 프록시에서 복구
7777
- [BiasBusters](../../ARCHITECTURE.md#tool-selection-bias-mitigations) - 구조적 코드 편집에서 모델을 `ast_edit` 쪽으로 밀어주는 네 가지 결합 완화책(설명, 문법 금지, 시스템 노트, ASA 스티어링)
7878
- [안전 제한](../../ARCHITECTURE.md#safety-limits) - 턴 상한, 토큰 예산, 타임아웃
7979

‎docs/lang/ko/TROUBLESHOOTING.md‎

Lines changed: 13 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<!-- source: docs/TROUBLESHOOTING.md synced-through: fe64417 -->
1+
<!-- source: docs/TROUBLESHOOTING.md synced-through: 175f5a2 -->
22
> **[English](../../TROUBLESHOOTING.md)** | **[简体中文](../zh-CN/TROUBLESHOOTING.md)** | **[日本語](../ja/TROUBLESHOOTING.md)** | **한국어**
33
44
> ℹ️ 영어 원본([TROUBLESHOOTING.md](../../TROUBLESHOOTING.md))의 번역본입니다. 원본과 차이가 있을 경우 영어 원본이 우선합니다.
@@ -12,19 +12,24 @@
1212

1313
## 빠른 진단
1414

15-
문제가 어디에 있는지 파악하기 위해 다음을 먼저 실행하세요:
15+
먼저 `atlas doctor`를 실행한 다음 Compose 상태와 로그로 문제 위치를 찾으세요:
1616

1717
```bash
18-
# Docker Compose — check all services at once
18+
atlas doctor
1919
docker compose ps
20-
21-
# GPU status
22-
nvidia-smi
23-
24-
# Docker Compose logs (last 50 lines per service)
2520
docker compose logs --tail 50
2621
```
2722

23+
`atlas doctor`는 호스트, 설정, 서비스 상태를 함께 확인하므로 가장 먼저 사용할 진단 명령입니다. `docker compose ps`는 시작에 실패한 서비스를 식별하고, 로그는 다음 단계의 세부 정보를 제공합니다. 첫 결과가 추론 백엔드를 가리킬 때만 하드웨어별 검사를 사용하세요:
24+
25+
| 백엔드 | 진단 명령 또는 확인 항목 |
26+
|---|---|
27+
| NVIDIA CUDA | `nvidia-smi` |
28+
| AMD ROCm | `rocm-smi`를 실행하고 `/dev/kfd`가 존재하는지 확인합니다. |
29+
| Apple Silicon / Metal | `atlas doctor`를 실행합니다. 네이티브 서버가 수신 대기 중이 아니면 [SETUP_MACOS.md](../../SETUP_MACOS.md#troubleshooting)의 설명대로 `./scripts/atlas-llama-macos.sh`를 시작하고 포그라운드 런처 출력을 확인합니다. |
30+
| Vulkan | `/dev/dri`가 존재하는지 확인한 다음 `docker compose -f docker-compose.yml -f docker-compose.vulkan.yml exec llama-server vulkaninfo --summary`를 실행합니다. |
31+
| CPU 전용 | `docker-compose.vulkan.yml`과 `docker-compose.cpu.yml` 오버레이가 활성화되어 있는지 확인합니다. GPU가 없다는 이유만으로 `atlas doctor`가 실패하지 않고 경고 후 정상 종료해야 합니다. |
32+
2833
서비스별 헬스 체크 curl은 [SETUP.md § 설치 확인](../ko/SETUP.md#설치-확인)을 참고하세요. 분류(triage)에 가장 유용한 것은 atlas-proxy 헬스 엔드포인트입니다 — 모든 업스트림 서비스의 상태를 보고합니다:
2934
```json
3035
{

‎docs/lang/zh-CN/README.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<!-- source: README.md synced-through: fe64417 -->
1+
<!-- source: README.md synced-through: 175f5a2 -->
22
> **[English](../../../README.md)** | **简体中文** | **[日本語](../ja/README.md)** | **[한국어](../ko/README.md)**
33
44
<p align="center">
@@ -34,8 +34,8 @@
3434
* **先验证，再接受。** 生成的代码可以在隔离的执行环境中编译、测试并修正。
3535
* **把算力花在刀刃上。** 简单的编辑走更短的路径，更难的任务则获得更多候选、推理与验证。
3636
* **运行你自己的模型。** 在 NVIDIA、AMD、Apple Silicon、Vulkan 或支持 CPU 的硬件上使用兼容的 GGUF 模型。
37-
* **一切留在本地。** 你的仓库、推理、测试执行和习得的工件都留在你的机器上。
38-
* **掌控完整技术栈。** ATLAS 开源、自托管，没有必需的托管 API，也没有按 token 的费用。
37+
* **在本地掌控数据。** ATLAS 不会有意把你的仓库或提示上传到托管模型或 ATLAS 运营的服务。沙箱命令默认可以访问外部网络；设置 `ATLAS_SANDBOX_NET_INTERNAL=true` 可禁用该访问。
38+
* **掌控完整技术栈。** ATLAS 开源且自托管，不需要托管模型或第三方模型提供商 API 密钥；ATLAS 服务之间使用本地的逐安装服务令牌进行认证。
3939

4040
---
4141

@@ -73,7 +73,7 @@
7373

7474
2. **[atlas-proxy](../../ARCHITECTURE.md#3-atlas-proxy-outer-layer)** - 基于 Go 的 agent 循环，负责编排整个系统。
7575
- [工具调用路由](../../ARCHITECTURE.md#tools) - 按复杂度层级分类文件操作
76-
- [语法强制执行](../../ARCHITECTURE.md#grammar-enforcement) - GBNF 模式保证 JSON 输出有效
76+
- [语法强制执行](../../ARCHITECTURE.md#grammar-enforcement) - GBNF 模式强力引导输出符合预期 JSON 结构，并由代理恢复格式错误或截断的输出
7777
- [BiasBusters](../../ARCHITECTURE.md#tool-selection-bias-mitigations) - 四道组合的缓解措施（描述、语法禁用、系统提示、ASA 操控），把模型推向用 `ast_edit` 做结构性代码编辑
7878
- [安全限制](../../ARCHITECTURE.md#safety-limits) - 轮次上限、token 预算、超时
7979

‎docs/lang/zh-CN/TROUBLESHOOTING.md‎

Lines changed: 13 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<!-- source: docs/TROUBLESHOOTING.md synced-through: fe64417 -->
1+
<!-- source: docs/TROUBLESHOOTING.md synced-through: 175f5a2 -->
22
> **[English](../../TROUBLESHOOTING.md)** | **简体中文** | **[日本語](../ja/TROUBLESHOOTING.md)** | **[한국어](../ko/TROUBLESHOOTING.md)**
33
44
> ℹ️ **译者注：** 若本译文与英文原版 ([TROUBLESHOOTING.md](../../TROUBLESHOOTING.md)) 有出入，以英文原版为准。
@@ -12,19 +12,24 @@
1212

1313
## 快速诊断
1414

15-
遇到问题时，请先运行以下命令确定问题所在：
15+
先运行 `atlas doctor`，再使用 Compose 状态和日志定位问题：
1616

1717
```bash
18-
# Docker Compose — check all services at once
18+
atlas doctor
1919
docker compose ps
20-
21-
# GPU status
22-
nvidia-smi
23-
24-
# Docker Compose logs (last 50 lines per service)
2520
docker compose logs --tail 50
2621
```
2722

23+
`atlas doctor` 会同时检查主机、配置和服务健康状况，因此是首选的第一项诊断。`docker compose ps` 用于识别启动失败的服务，日志则提供下一层细节。只有当初步结果指向推理后端时，才使用硬件专用检查：
24+
25+
| 后端 | 诊断命令或检查项 |
26+
|---|---|
27+
| NVIDIA CUDA | `nvidia-smi` |
28+
| AMD ROCm | 运行 `rocm-smi` 并确认 `/dev/kfd` 存在。 |
29+
| Apple Silicon / Metal | 运行 `atlas doctor`；如果原生服务器未监听，请按照 [SETUP_MACOS.md](../../SETUP_MACOS.md#troubleshooting) 中的说明启动 `./scripts/atlas-llama-macos.sh`，并检查其前台启动器输出。 |
30+
| Vulkan | 确认 `/dev/dri` 存在，然后运行 `docker compose -f docker-compose.yml -f docker-compose.vulkan.yml exec llama-server vulkaninfo --summary`。 |
31+
| 纯 CPU | 确认 `docker-compose.vulkan.yml` 和 `docker-compose.cpu.yml` 覆盖层已启用。`atlas doctor` 不应仅因没有 GPU 而失败，而应发出警告并成功退出。 |
32+
2833
逐服务的健康检查 curl 命令见 [SETUP.md § 验证安装](SETUP.md#验证安装)。atlas-proxy 的健康检查端点对分诊最有用 —— 它会报告所有上游服务的状态：
2934
```json
3035
{

0 commit comments

Comments
 (0)