verbalcoding 0.2.10 → 0.2.12

package/docs/i18n/RELEASE.ko.md

@@ -1,5 +1,30 @@
 # VerbalCoding 릴리스 노트
 
+<!-- readme-glow-up:intro -->
+<p align="center">
+  <a href="../../README.ko.md">README</a> ·
+  <a href="README.ko.md">문서 허브</a> ·
+  <a href="FRESH_INSTALL.ko.md">Fresh Install</a> ·
+  <a href="USAGE.ko.md">Usage</a> ·
+  <a href="CONFIGURATION.ko.md">Configuration</a> ·
+  <a href="TROUBLESHOOTING.ko.md">Troubleshooting</a> ·
+  <a href="MULTI_INSTANCE.ko.md">Multi-Instance</a>
+</p>
+
+> 빠른 경로: `npm install -g verbalcoding@latest → vc setup → vc doctor → vc start`
+<!-- /readme-glow-up:intro -->
+
+## 최신 setup 흐름
+
+```bash
+npm install -g verbalcoding@latest
+vc setup
+vc doctor
+vc start
+```
+
+수동 `.env` 편집 대신 `vc setup token`으로 `DISCORD_BOT_TOKEN`/`DISCORD_CLIENT_ID`를 저장하고, `vc setup channels`로 `AUTO_JOIN_VOICE_CHANNELS`를 저장하세요. Docker에서 `Cannot perform IP discovery - socket closed`가 보이면 Linux Compose 서비스에 `network_mode: "host"`를 사용하고 `ports:`를 제거하세요.
+
 ## 현재 릴리스 후보
 
 VerbalCoding은 CLI 기반 코딩 에이전트를 음성으로 제어하기 위한 Discord 음성 브리지입니다. 공개 릴리스를 지향하며, macOS / Apple Silicon 경로가 가장 많이 테스트되었고 일반적인 패키지 관리자에 대한 Linux 부트스트랩은 최선 노력으로 지원됩니다.
@@ -22,7 +47,7 @@ VerbalCoding은 CLI 기반 코딩 에이전트를 음성으로 제어하기 위
 - 큰 기술 출력이 소리 내어 읽히지 않도록 하는 diff/code/log 안전장치.
 - 실내와 시끄러운/실외 사용을 위한 일반 및 보수적 감도 모드.
 - OS 패키지, npm 의존성, Edge TTS 헬퍼, 기본 whisper.cpp 모델을 위한 설정 마법사, `.env.example`, `vc doctor` 필수 조건 점검기, `./scripts/install.sh --yes` 부트스트랩.
-- npm 패키지 설치 경로: `npm install -g verbalcoding`, `vc setup --yes`, `vc start`.
+- npm 패키지 설치 경로: `npm install -g verbalcoding`, guided `vc setup`, `vc start`.
 - 긴 에이전트 작업 중 텍스트 전용 중간 단계 업데이트를 위한 선택적 자세한 진행 모드.
 - 파이프라인 최적화를 위한 항상 켜진 JSONL 지연 시간 지표와 `!latency` / `!metrics` 요약.
 - 더 여유 있는 발화 유휴 대기(`UTTERANCE_IDLE_MS=4500`)로, 자연스러운 멈춤이 있는 긴 음성 지시가 부분 프롬프트와 무시되는 처리 중 발화로 나뉘지 않도록 함.

package/docs/i18n/RELEASE.ru.md

@@ -1,5 +1,30 @@
 # Заметки о релизе VerbalCoding
 
+<!-- readme-glow-up:intro -->
+<p align="center">
+  <a href="../../README.ru.md">README</a> ·
+  <a href="README.ru.md">Центр документации</a> ·
+  <a href="FRESH_INSTALL.ru.md">Fresh Install</a> ·
+  <a href="USAGE.ru.md">Usage</a> ·
+  <a href="CONFIGURATION.ru.md">Configuration</a> ·
+  <a href="TROUBLESHOOTING.ru.md">Troubleshooting</a> ·
+  <a href="MULTI_INSTANCE.ru.md">Multi-Instance</a>
+</p>
+
+> Быстрый путь: `npm install -g verbalcoding@latest → vc setup → vc doctor → vc start`
+<!-- /readme-glow-up:intro -->
+
+## Актуальный setup-процесс
+
+```bash
+npm install -g verbalcoding@latest
+vc setup
+vc doctor
+vc start
+```
+
+Не редактируйте `.env` вручную: используйте `vc setup token` для `DISCORD_BOT_TOKEN`/`DISCORD_CLIENT_ID` и `vc setup channels` для `AUTO_JOIN_VOICE_CHANNELS`. Если Docker показывает `Cannot perform IP discovery - socket closed`, в Linux Compose используйте `network_mode: "host"` и удалите `ports:`.
+
 ## Текущий релиз-кандидат
 
 VerbalCoding — это голосовой bridge Discord для управления CLI-агентами кодинга голосом. Он ориентирован на публичный релиз; macOS / Apple Silicon — наиболее протестированный путь, а bootstrap-поддержка Linux для распространённых менеджеров пакетов предоставляется по мере возможностей.
@@ -22,7 +47,7 @@ VerbalCoding — это голосовой bridge Discord для управле
 - Защитные ограничения для diff/code/log, чтобы большой технический вывод не читался вслух.
 - Обычный и консервативный режимы чувствительности для помещений по сравнению с шумным/уличным использованием.
 - Мастер настройки, `.env.example`, проверка prerequisites через `vc doctor` и bootstrap `./scripts/install.sh --yes` для пакетов ОС, npm-зависимостей, помощника Edge TTS и стандартной модели whisper.cpp.
-- Путь установки npm-пакета: `npm install -g verbalcoding`, `vc setup --yes` и `vc start`.
+- Путь установки npm-пакета: `npm install -g verbalcoding`, guided `vc setup` и `vc start`.
 - Необязательный режим подробного прогресса для текстовых обновлений промежуточных шагов во время долгой работы агента.
 - Постоянные JSONL-метрики задержки плюс сводка `!latency` / `!metrics` для оптимизации pipeline.
 - Более терпеливое ожидание бездействия реплики (`UTTERANCE_IDLE_MS=4500`), чтобы длинные голосовые инструкции с естественными паузами не разделялись на частичный prompt плюс игнорируемую речь во время обработки.

package/docs/i18n/RELEASE.zh.md

@@ -1,5 +1,30 @@
 # VerbalCoding 发行说明
 
+<!-- readme-glow-up:intro -->
+<p align="center">
+  <a href="../../README.zh.md">README</a> ·
+  <a href="README.zh.md">文档中心</a> ·
+  <a href="FRESH_INSTALL.zh.md">Fresh Install</a> ·
+  <a href="USAGE.zh.md">Usage</a> ·
+  <a href="CONFIGURATION.zh.md">Configuration</a> ·
+  <a href="TROUBLESHOOTING.zh.md">Troubleshooting</a> ·
+  <a href="MULTI_INSTANCE.zh.md">Multi-Instance</a>
+</p>
+
+> 最快路径: `npm install -g verbalcoding@latest → vc setup → vc doctor → vc start`
+<!-- /readme-glow-up:intro -->
+
+## 最新 setup 流程
+
+```bash
+npm install -g verbalcoding@latest
+vc setup
+vc doctor
+vc start
+```
+
+不要手动编辑 `.env`；使用 `vc setup token` 保存 `DISCORD_BOT_TOKEN`/`DISCORD_CLIENT_ID`，使用 `vc setup channels` 保存 `AUTO_JOIN_VOICE_CHANNELS`。如果 Docker 中出现 `Cannot perform IP discovery - socket closed`，请在 Linux Compose 服务中使用 `network_mode: "host"` 并移除 `ports:`。
+
 ## 当前候选版本
 
 VerbalCoding 是一个 Discord 语音桥接，用于通过语音控制基于 CLI 的编码代理。它面向公开发布，macOS / Apple Silicon 是测试最多的路径，并为常见包管理器提供尽力支持的 Linux 引导。
@@ -22,7 +47,7 @@ VerbalCoding 是一个 Discord 语音桥接，用于通过语音控制基于 CLI
 - Diff/code/log 保护机制，避免大段技术输出被朗读。
 - 面向室内与嘈杂/户外使用的普通和保守灵敏度模式。
 - 设置向导、`.env.example`、`vc doctor` 前置条件检查器，以及用于 OS 软件包、npm 依赖、Edge TTS 辅助环境和默认 whisper.cpp 模型的 `./scripts/install.sh --yes` 引导。
-- npm 包安装路径：`npm install -g verbalcoding`、`vc setup --yes` 和 `vc start`。
+- npm 包安装路径：`npm install -g verbalcoding`、guided `vc setup` 和 `vc start`。
 - 可选详细进度模式，在长时间代理工作期间提供仅文本的中间步骤更新。
 - 常开 JSONL 延迟指标，以及用于流水线优化的 `!latency` / `!metrics` 摘要。
 - 更耐心的发言空闲等待（`UTTERANCE_IDLE_MS=4500`），使带自然停顿的长口述指令不会被拆成部分提示加被忽略的处理期间语音。

package/docs/i18n/TROUBLESHOOTING.es.md

@@ -0,0 +1,39 @@
+# Solución de problemas de VerbalCoding
+
+<!-- readme-glow-up:intro -->
+<p align="center">
+  <a href="../../README.es.md">README</a> ·
+  <a href="README.es.md">Centro de documentación</a> ·
+  <a href="FRESH_INSTALL.es.md">Fresh Install</a> ·
+  <a href="USAGE.es.md">Usage</a> ·
+  <a href="CONFIGURATION.es.md">Configuration</a> ·
+  <a href="TROUBLESHOOTING.es.md">Troubleshooting</a> ·
+  <a href="MULTI_INSTANCE.es.md">Multi-Instance</a>
+</p>
+
+> Ruta rápida: `npm install -g verbalcoding@latest → vc setup → vc doctor → vc start`
+<!-- /readme-glow-up:intro -->
+
+## `Cannot perform IP discovery - socket closed`
+
+Este error significa que el bot inició sesión y encontró el canal de voz, pero falló el descubrimiento UDP de voz de Discord.
+
+En Docker Compose sobre Linux usa:
+
+```yaml
+services:
+  verbalcoding:
+    network_mode: "host"
+```
+
+Elimina `ports:` del mismo servicio. En Docker Desktop para macOS/Windows el modo host se comporta de otra forma; si sigue fallando, ejecútalo en el host o en una VM Linux.
+
+## Token and channel setup
+
+Si falta el token, ejecuta `vc setup token`; si el nombre del canal no coincide, ejecuta `vc setup channels "<canal de voz real>"`.
+
+```bash
+vc setup token
+vc setup channels "General,Team Voice"
+vc doctor
+```

package/docs/i18n/TROUBLESHOOTING.fr.md

@@ -0,0 +1,39 @@
+# Dépannage VerbalCoding
+
+<!-- readme-glow-up:intro -->
+<p align="center">
+  <a href="../../README.fr.md">README</a> ·
+  <a href="README.fr.md">Centre de documentation</a> ·
+  <a href="FRESH_INSTALL.fr.md">Fresh Install</a> ·
+  <a href="USAGE.fr.md">Usage</a> ·
+  <a href="CONFIGURATION.fr.md">Configuration</a> ·
+  <a href="TROUBLESHOOTING.fr.md">Troubleshooting</a> ·
+  <a href="MULTI_INSTANCE.fr.md">Multi-Instance</a>
+</p>
+
+> Chemin rapide: `npm install -g verbalcoding@latest → vc setup → vc doctor → vc start`
+<!-- /readme-glow-up:intro -->
+
+## `Cannot perform IP discovery - socket closed`
+
+Cette erreur signifie que le bot s’est connecté à Discord et a trouvé le salon vocal, mais que la découverte UDP de Discord voice a échoué.
+
+Sous Docker Compose Linux, utilisez :
+
+```yaml
+services:
+  verbalcoding:
+    network_mode: "host"
+```
+
+Supprimez `ports:` du même service. Docker Desktop macOS/Windows gère le mode host différemment ; si cela échoue encore, lancez VerbalCoding sur l’hôte ou dans une VM Linux.
+
+## Token and channel setup
+
+Si le jeton manque, lancez `vc setup token` ; si le nom du salon ne correspond pas, lancez `vc setup channels "<vrai salon vocal>"`.
+
+```bash
+vc setup token
+vc setup channels "General,Team Voice"
+vc doctor
+```

package/docs/i18n/TROUBLESHOOTING.ja.md

@@ -0,0 +1,39 @@
+# VerbalCoding トラブルシューティング
+
+<!-- readme-glow-up:intro -->
+<p align="center">
+  <a href="../../README.ja.md">README</a> ·
+  <a href="README.ja.md">ドキュメントハブ</a> ·
+  <a href="FRESH_INSTALL.ja.md">Fresh Install</a> ·
+  <a href="USAGE.ja.md">Usage</a> ·
+  <a href="CONFIGURATION.ja.md">Configuration</a> ·
+  <a href="TROUBLESHOOTING.ja.md">Troubleshooting</a> ·
+  <a href="MULTI_INSTANCE.ja.md">Multi-Instance</a>
+</p>
+
+> 最短経路: `npm install -g verbalcoding@latest → vc setup → vc doctor → vc start`
+<!-- /readme-glow-up:intro -->
+
+## `Cannot perform IP discovery - socket closed`
+
+このエラーは、ボットが Discord にログインし音声チャンネルを見つけたものの、Discord 音声の UDP 検出に失敗したことを示します。
+
+Linux Docker Compose では次を使います:
+
+```yaml
+services:
+  verbalcoding:
+    network_mode: "host"
+```
+
+同じサービスの `ports:` は削除してください。Docker Desktop macOS/Windows では host networking の挙動が異なるため、失敗が続く場合はホストまたは Linux VM で実行してください。
+
+## Token and channel setup
+
+トークンがない場合は `vc setup token`、チャンネル名が違う場合は `vc setup channels "<実際の音声チャンネル>"` を実行します。
+
+```bash
+vc setup token
+vc setup channels "General,Team Voice"
+vc doctor
+```

package/docs/i18n/TROUBLESHOOTING.ko.md

@@ -0,0 +1,39 @@
+# VerbalCoding 문제 해결
+
+<!-- readme-glow-up:intro -->
+<p align="center">
+  <a href="../../README.ko.md">README</a> ·
+  <a href="README.ko.md">문서 허브</a> ·
+  <a href="FRESH_INSTALL.ko.md">Fresh Install</a> ·
+  <a href="USAGE.ko.md">Usage</a> ·
+  <a href="CONFIGURATION.ko.md">Configuration</a> ·
+  <a href="TROUBLESHOOTING.ko.md">Troubleshooting</a> ·
+  <a href="MULTI_INSTANCE.ko.md">Multi-Instance</a>
+</p>
+
+> 빠른 경로: `npm install -g verbalcoding@latest → vc setup → vc doctor → vc start`
+<!-- /readme-glow-up:intro -->
+
+## `Cannot perform IP discovery - socket closed`
+
+이 오류는 봇이 Discord에 로그인하고 음성 채널을 찾았지만 Discord 음성 UDP 검색에 실패했다는 뜻입니다.
+
+Linux Docker Compose에서는 다음을 사용하세요:
+
+```yaml
+services:
+  verbalcoding:
+    network_mode: "host"
+```
+
+같은 서비스의 `ports:`는 제거하세요. Docker Desktop macOS/Windows에서는 host networking 동작이 다르므로 계속 실패하면 호스트나 Linux VM에서 실행하세요.
+
+## Token and channel setup
+
+토큰이 없으면 `vc setup token`을 실행하고, 채널 이름이 맞지 않으면 `vc setup channels "<실제 음성 채널>"`을 실행하세요.
+
+```bash
+vc setup token
+vc setup channels "General,Team Voice"
+vc doctor
+```

package/docs/i18n/TROUBLESHOOTING.ru.md

@@ -0,0 +1,39 @@
+# Устранение неполадок VerbalCoding
+
+<!-- readme-glow-up:intro -->
+<p align="center">
+  <a href="../../README.ru.md">README</a> ·
+  <a href="README.ru.md">Центр документации</a> ·
+  <a href="FRESH_INSTALL.ru.md">Fresh Install</a> ·
+  <a href="USAGE.ru.md">Usage</a> ·
+  <a href="CONFIGURATION.ru.md">Configuration</a> ·
+  <a href="TROUBLESHOOTING.ru.md">Troubleshooting</a> ·
+  <a href="MULTI_INSTANCE.ru.md">Multi-Instance</a>
+</p>
+
+> Быстрый путь: `npm install -g verbalcoding@latest → vc setup → vc doctor → vc start`
+<!-- /readme-glow-up:intro -->
+
+## `Cannot perform IP discovery - socket closed`
+
+Эта ошибка означает, что бот вошёл в Discord и нашёл голосовой канал, но UDP-обнаружение Discord voice не сработало.
+
+В Linux Docker Compose используйте:
+
+```yaml
+services:
+  verbalcoding:
+    network_mode: "host"
+```
+
+Удалите `ports:` у этого же сервиса. В Docker Desktop для macOS/Windows host networking работает иначе; если ошибка остаётся, запускайте на хосте или в Linux VM.
+
+## Token and channel setup
+
+Если нет токена, выполните `vc setup token`; если имя канала не совпадает, выполните `vc setup channels "<реальный голосовой канал>"`.
+
+```bash
+vc setup token
+vc setup channels "General,Team Voice"
+vc doctor
+```

package/docs/i18n/TROUBLESHOOTING.zh.md

@@ -0,0 +1,39 @@
+# VerbalCoding 故障排查
+
+<!-- readme-glow-up:intro -->
+<p align="center">
+  <a href="../../README.zh.md">README</a> ·
+  <a href="README.zh.md">文档中心</a> ·
+  <a href="FRESH_INSTALL.zh.md">Fresh Install</a> ·
+  <a href="USAGE.zh.md">Usage</a> ·
+  <a href="CONFIGURATION.zh.md">Configuration</a> ·
+  <a href="TROUBLESHOOTING.zh.md">Troubleshooting</a> ·
+  <a href="MULTI_INSTANCE.zh.md">Multi-Instance</a>
+</p>
+
+> 最快路径: `npm install -g verbalcoding@latest → vc setup → vc doctor → vc start`
+<!-- /readme-glow-up:intro -->
+
+## `Cannot perform IP discovery - socket closed`
+
+此错误表示机器人已登录 Discord 并找到了语音频道，但 Discord 语音 UDP 发现失败。
+
+在 Linux Docker Compose 中使用：
+
+```yaml
+services:
+  verbalcoding:
+    network_mode: "host"
+```
+
+请移除同一服务的 `ports:`。Docker Desktop macOS/Windows 的 host networking 行为不同；如果仍失败，请在宿主机或 Linux VM 上运行。
+
+## Token and channel setup
+
+缺少令牌时运行 `vc setup token`；频道名称不匹配时运行 `vc setup channels "<真实语音频道>"`。
+
+```bash
+vc setup token
+vc setup channels "General,Team Voice"
+vc doctor
+```

package/docs/i18n/USAGE.es.md

@@ -1,5 +1,30 @@
 # Guía de uso de VerbalCoding
 
+<!-- readme-glow-up:intro -->
+<p align="center">
+  <a href="../../README.es.md">README</a> ·
+  <a href="README.es.md">Centro de documentación</a> ·
+  <a href="FRESH_INSTALL.es.md">Fresh Install</a> ·
+  <a href="USAGE.es.md">Usage</a> ·
+  <a href="CONFIGURATION.es.md">Configuration</a> ·
+  <a href="TROUBLESHOOTING.es.md">Troubleshooting</a> ·
+  <a href="MULTI_INSTANCE.es.md">Multi-Instance</a>
+</p>
+
+> Ruta rápida: `npm install -g verbalcoding@latest → vc setup → vc doctor → vc start`
+<!-- /readme-glow-up:intro -->
+
+## Flujo setup actualizado
+
+```bash
+npm install -g verbalcoding@latest
+vc setup
+vc doctor
+vc start
+```
+
+No edites `.env` manualmente: usa `vc setup token` para guardar `DISCORD_BOT_TOKEN`/`DISCORD_CLIENT_ID` y `vc setup channels` para guardar `AUTO_JOIN_VOICE_CHANNELS`. Si Docker muestra `Cannot perform IP discovery - socket closed`, usa `network_mode: "host"` en Linux Compose y elimina `ports:`.
+
 Esta página contiene los detalles operativos que antes hacían que el README fuera demasiado largo.
 
 ## Comandos CLI

package/docs/i18n/USAGE.fr.md

@@ -1,5 +1,30 @@
 # Guide d'utilisation de VerbalCoding
 
+<!-- readme-glow-up:intro -->
+<p align="center">
+  <a href="../../README.fr.md">README</a> ·
+  <a href="README.fr.md">Centre de documentation</a> ·
+  <a href="FRESH_INSTALL.fr.md">Fresh Install</a> ·
+  <a href="USAGE.fr.md">Usage</a> ·
+  <a href="CONFIGURATION.fr.md">Configuration</a> ·
+  <a href="TROUBLESHOOTING.fr.md">Troubleshooting</a> ·
+  <a href="MULTI_INSTANCE.fr.md">Multi-Instance</a>
+</p>
+
+> Chemin rapide: `npm install -g verbalcoding@latest → vc setup → vc doctor → vc start`
+<!-- /readme-glow-up:intro -->
+
+## Flux setup actuel
+
+```bash
+npm install -g verbalcoding@latest
+vc setup
+vc doctor
+vc start
+```
+
+Ne modifiez pas `.env` à la main : utilisez `vc setup token` pour enregistrer `DISCORD_BOT_TOKEN`/`DISCORD_CLIENT_ID`, et `vc setup channels` pour `AUTO_JOIN_VOICE_CHANNELS`. Si Docker affiche `Cannot perform IP discovery - socket closed`, utilisez `network_mode: "host"` avec Compose sous Linux et supprimez `ports:`.
+
 Cette page contient les détails opérationnels qui rendaient auparavant le README trop long.
 
 ## Commandes CLI

package/docs/i18n/USAGE.ja.md

@@ -1,5 +1,30 @@
 # VerbalCoding 使い方ガイド
 
+<!-- readme-glow-up:intro -->
+<p align="center">
+  <a href="../../README.ja.md">README</a> ·
+  <a href="README.ja.md">ドキュメントハブ</a> ·
+  <a href="FRESH_INSTALL.ja.md">Fresh Install</a> ·
+  <a href="USAGE.ja.md">Usage</a> ·
+  <a href="CONFIGURATION.ja.md">Configuration</a> ·
+  <a href="TROUBLESHOOTING.ja.md">Troubleshooting</a> ·
+  <a href="MULTI_INSTANCE.ja.md">Multi-Instance</a>
+</p>
+
+> 最短経路: `npm install -g verbalcoding@latest → vc setup → vc doctor → vc start`
+<!-- /readme-glow-up:intro -->
+
+## 最新の setup フロー
+
+```bash
+npm install -g verbalcoding@latest
+vc setup
+vc doctor
+vc start
+```
+
+手動で `.env` を編集せず、`vc setup token` で `DISCORD_BOT_TOKEN`/`DISCORD_CLIENT_ID`、`vc setup channels` で `AUTO_JOIN_VOICE_CHANNELS` を保存してください。Docker で `Cannot perform IP discovery - socket closed` が出る場合、Linux Compose サービスに `network_mode: "host"` を使い、`ports:` を削除します。
+
 このページには、README を長くしすぎていた運用上の詳細をまとめています。
 
 ## CLI コマンド

package/docs/i18n/USAGE.ko.md

@@ -1,5 +1,30 @@
 # VerbalCoding 사용 가이드
 
+<!-- readme-glow-up:intro -->
+<p align="center">
+  <a href="../../README.ko.md">README</a> ·
+  <a href="README.ko.md">문서 허브</a> ·
+  <a href="FRESH_INSTALL.ko.md">Fresh Install</a> ·
+  <a href="USAGE.ko.md">Usage</a> ·
+  <a href="CONFIGURATION.ko.md">Configuration</a> ·
+  <a href="TROUBLESHOOTING.ko.md">Troubleshooting</a> ·
+  <a href="MULTI_INSTANCE.ko.md">Multi-Instance</a>
+</p>
+
+> 빠른 경로: `npm install -g verbalcoding@latest → vc setup → vc doctor → vc start`
+<!-- /readme-glow-up:intro -->
+
+## 최신 setup 흐름
+
+```bash
+npm install -g verbalcoding@latest
+vc setup
+vc doctor
+vc start
+```
+
+수동 `.env` 편집 대신 `vc setup token`으로 `DISCORD_BOT_TOKEN`/`DISCORD_CLIENT_ID`를 저장하고, `vc setup channels`로 `AUTO_JOIN_VOICE_CHANNELS`를 저장하세요. Docker에서 `Cannot perform IP discovery - socket closed`가 보이면 Linux Compose 서비스에 `network_mode: "host"`를 사용하고 `ports:`를 제거하세요.
+
 이 페이지에는 README를 너무 길게 만들던 운영 세부 정보가 담겨 있습니다.
 
 ## CLI 명령

package/docs/i18n/USAGE.ru.md

@@ -1,5 +1,30 @@
 # Руководство по использованию VerbalCoding
 
+<!-- readme-glow-up:intro -->
+<p align="center">
+  <a href="../../README.ru.md">README</a> ·
+  <a href="README.ru.md">Центр документации</a> ·
+  <a href="FRESH_INSTALL.ru.md">Fresh Install</a> ·
+  <a href="USAGE.ru.md">Usage</a> ·
+  <a href="CONFIGURATION.ru.md">Configuration</a> ·
+  <a href="TROUBLESHOOTING.ru.md">Troubleshooting</a> ·
+  <a href="MULTI_INSTANCE.ru.md">Multi-Instance</a>
+</p>
+
+> Быстрый путь: `npm install -g verbalcoding@latest → vc setup → vc doctor → vc start`
+<!-- /readme-glow-up:intro -->
+
+## Актуальный setup-процесс
+
+```bash
+npm install -g verbalcoding@latest
+vc setup
+vc doctor
+vc start
+```
+
+Не редактируйте `.env` вручную: используйте `vc setup token` для `DISCORD_BOT_TOKEN`/`DISCORD_CLIENT_ID` и `vc setup channels` для `AUTO_JOIN_VOICE_CHANNELS`. Если Docker показывает `Cannot perform IP discovery - socket closed`, в Linux Compose используйте `network_mode: "host"` и удалите `ports:`.
+
 Эта страница содержит эксплуатационные подробности, которые раньше делали README слишком длинным.
 
 ## CLI-команды

package/docs/i18n/USAGE.zh.md

@@ -1,5 +1,30 @@
 # VerbalCoding 使用指南
 
+<!-- readme-glow-up:intro -->
+<p align="center">
+  <a href="../../README.zh.md">README</a> ·
+  <a href="README.zh.md">文档中心</a> ·
+  <a href="FRESH_INSTALL.zh.md">Fresh Install</a> ·
+  <a href="USAGE.zh.md">Usage</a> ·
+  <a href="CONFIGURATION.zh.md">Configuration</a> ·
+  <a href="TROUBLESHOOTING.zh.md">Troubleshooting</a> ·
+  <a href="MULTI_INSTANCE.zh.md">Multi-Instance</a>
+</p>
+
+> 最快路径: `npm install -g verbalcoding@latest → vc setup → vc doctor → vc start`
+<!-- /readme-glow-up:intro -->
+
+## 最新 setup 流程
+
+```bash
+npm install -g verbalcoding@latest
+vc setup
+vc doctor
+vc start
+```
+
+不要手动编辑 `.env`；使用 `vc setup token` 保存 `DISCORD_BOT_TOKEN`/`DISCORD_CLIENT_ID`，使用 `vc setup channels` 保存 `AUTO_JOIN_VOICE_CHANNELS`。如果 Docker 中出现 `Cannot perform IP discovery - socket closed`，请在 Linux Compose 服务中使用 `network_mode: "host"` 并移除 `ports:`。
+
 本页面保存曾经让 README 过长的运维细节。
 
 ## CLI 命令