verbalcoding 0.2.11 → 0.2.13

package/docs/i18n/HARNESS_OPENCODE.zh.md

@@ -0,0 +1,44 @@
+# OpenCode — Harness 说明
+
+<p align="center">
+  <a href="../../README.zh.md">README</a> ·
+  <a href="HARNESSES.zh.md">Harness</a> ·
+  <a href="USAGE.zh.md">使用</a> ·
+  <a href="CONFIGURATION.zh.md">配置</a>
+</p>
+
+OpenCode 是开源终端编码代理。VerbalCoding 通过 `opencode run` 驱动。
+
+## 安装
+
+参考上游 OpenCode 指引,确认:
+
+```bash
+opencode run "hello"
+```
+
+## VerbalCoding 配置
+
+```bash
+# .env
+AGENT_BACKEND=opencode
+# 可选
+OPENCODE_COMMAND="opencode run"             # 默认
+AGENT_PROJECT_CONTEXT="..."
+AGENT_WORKDIR=/Users/you/code/your-project
+AGENT_CHAT_TIMEOUT_MS=45000
+AGENT_TASK_TIMEOUT_MS=0
+```
+
+## 切到 OpenCode 的语音表述
+
+- en: `"switch to OpenCode"`、`"ask OpenCode ..."`、`"switch to open code"`
+- zh: `"切到 OpenCode"`
+
+别名: `opencode`、`open code`。
+
+## 坑
+
+- **默认命令无会话续接。** 若 OpenCode 构建支持 resume,可改为 `OPENCODE_COMMAND="opencode run --resume"` (适配器会把 prompt 作为末尾 positional 参数)。
+- **模型选择。** 若需 `--model` 等标志,直接加入 `OPENCODE_COMMAND`。
+- **详细进度。** stdout/stderr 中按关键字匹配 (文件读取、网页搜索、终端)。无 `SMART_PROGRESS_API_KEY` 时 bridge 回退到原始标签。

package/docs/i18n/HERMES_VOICE.es.md

@@ -0,0 +1,46 @@
+# Voz integrada de Hermes vs VerbalCoding
+
+<!-- readme-glow-up:intro -->
+<p align="center">
+  <a href="../../README.es.md">README</a> ·
+  <a href="README.es.md">Centro de docs</a> ·
+  <a href="USAGE.es.md">Uso</a> ·
+  <a href="CONFIGURATION.es.md">Configuración</a> ·
+  <a href="TROUBLESHOOTING.es.md">Solución de problemas</a>
+</p>
+
+> Hermes ya soporta canales de voz de Discord. VerbalCoding no reemplaza ese bucle básico: añade una capa de flujo de trabajo para usar agentes de programación como si fueran una llamada.
+<!-- /readme-glow-up:intro -->
+
+## Lo que Hermes ya hace
+
+El gateway de Discord de Hermes Agent incluye soporte para canales de voz. Cuando el bot está en tu servidor, `/voice join` o `/voice channel` lo une al VC donde estás. Después puede transcribir con Whisper/STT y responder con TTS mediante Edge TTS, ElevenLabs, OpenAI u otros proveedores configurados.
+
+Para una conversación de voz básica, esto ya basta:
+
+```text
+Discord VC → Hermes STT → Hermes agent → TTS → Discord VC playback
+```
+
+## Lo que añade VerbalCoding
+
+| Área | Voz integrada de Hermes | VerbalCoding |
+|---|---|---|
+| Objetivo | Conversación general con Hermes en un VC | Flujo de trabajo tipo llamada para agentes CLI de programación |
+| Comandos | `/voice join`, `/voice channel`, `/voice leave`, `/voice tts` | `vc setup`, `vc start`, `!join`, `!ask`, `!session`, `!verbose`, `!latency`, comandos multiinstancia |
+| Backend | Hermes Agent | Hermes Agent, Claude Code, Codex, Gemini CLI, OpenCode, OpenClaw o comando personalizado |
+| Sesiones | Sesión normal del gateway Hermes | Ruteo por proyecto/sesión, vínculos de canal de voz y contexto compartido voz + `!ask` cuando el backend lo soporta |
+| UX de voz | STT + TTS básico | Ventanas de habla ajustadas, presets de idioma, limpieza de transcripción, espejo de texto y pruebas de voz |
+| Interrupción | Comportamiento básico de reproducción | Reglas de barge-in que paran la reproducción sin matar por accidente una tarea activa del agente |
+| Tareas largas | Respuesta genérica del agente | Avisos de progreso/estado, resúmenes verbose de herramientas y supresión de diffs/logs en TTS |
+| Operación | Configuración del gateway Hermes | `vc doctor`, diagnósticos redactados, métricas de latencia, guía Docker UDP y salas/procesos por proyecto |
+
+## Cuándo elegir cada uno
+
+Usa **Hermes integrado** si solo necesitas hablar, transcribir, responder y escuchar en un canal de voz.
+
+Usa **VerbalCoding** si necesitas contexto de proyecto compartido entre voz y texto, varios backends CLI, presets coreano/inglés, interrupciones seguras durante tareas largas, progreso hablado, métricas de latencia y herramientas operativas.
+
+## Posicionamiento honesto
+
+VerbalCoding no debería describirse como “añadir voz de Discord a Hermes desde cero”. Hermes ya tiene esa base. Mejor: VerbalCoding es una capa de workflow de voz en Discord para agentes CLI de programación; puede usar Hermes como backend por defecto y añade ruteo de proyecto, semántica de interrupción, UX de progreso, diagnósticos y cambio de backend.

package/docs/i18n/HERMES_VOICE.fr.md

@@ -0,0 +1,46 @@
+# Voix intégrée Hermes vs VerbalCoding
+
+<!-- readme-glow-up:intro -->
+<p align="center">
+  <a href="../../README.fr.md">README</a> ·
+  <a href="README.fr.md">Accueil docs</a> ·
+  <a href="USAGE.fr.md">Utilisation</a> ·
+  <a href="CONFIGURATION.fr.md">Configuration</a> ·
+  <a href="TROUBLESHOOTING.fr.md">Dépannage</a>
+</p>
+
+> Hermes prend déjà en charge les salons vocaux Discord. VerbalCoding ne remplace pas cette boucle de base : il ajoute une couche de workflow pour travailler avec des agents de code comme lors d’un appel.
+<!-- /readme-glow-up:intro -->
+
+## Ce que Hermes fait déjà
+
+Le gateway Discord de Hermes Agent inclut la prise en charge des salons vocaux. Une fois le bot dans le serveur, `/voice join` ou `/voice channel` le fait rejoindre le VC où vous vous trouvez. Hermes peut ensuite transcrire via Whisper/STT et répondre en TTS avec Edge TTS, ElevenLabs, OpenAI ou un autre provider configuré.
+
+Pour une conversation vocale simple, cette boucle suffit déjà :
+
+```text
+Discord VC → Hermes STT → Hermes agent → TTS → Discord VC playback
+```
+
+## Ce que VerbalCoding ajoute
+
+| Domaine | Voix intégrée Hermes | VerbalCoding |
+|---|---|---|
+| Objectif | Conversation Hermes générale dans un VC | Workflow type appel téléphonique avec agents CLI de code |
+| Commandes | `/voice join`, `/voice channel`, `/voice leave`, `/voice tts` | `vc setup`, `vc start`, `!join`, `!ask`, `!session`, `!verbose`, `!latency`, commandes multi-instance |
+| Backend | Hermes Agent | Hermes Agent, Claude Code, Codex, Gemini CLI, OpenCode, OpenClaw ou commande personnalisée |
+| Sessions | Session gateway Hermes normale | Routage projet/session, liaison de salons vocaux, contexte partagé voix + `!ask` quand le backend le permet |
+| UX vocale | STT + TTS de base | Fenêtres d’énoncé réglées, préréglages de langue, nettoyage de transcription, miroir texte, tests de voix |
+| Interruption | Lecture vocale de base | Règles de barge-in qui arrêtent la lecture sans tuer par erreur une tâche agent active |
+| Tâches longues | Réponse agent générique | Annonces de progression/état, résumés verbose des outils, suppression des diffs/logs en TTS |
+| Opérations | Configuration du gateway Hermes | `vc doctor`, diagnostics redactés, métriques de latence, guide Docker UDP, salons/processus par projet |
+
+## Quand choisir quoi
+
+Choisissez **la voix intégrée Hermes** si vous voulez seulement parler, transcrire, répondre et réécouter dans un salon vocal.
+
+Choisissez **VerbalCoding** si vous avez besoin d’un contexte projet partagé entre voix et texte, de plusieurs backends CLI, de préréglages coréen/anglais, d’interruptions sûres pendant les longues tâches, de progression vocale, de métriques de latence et d’outils d’exploitation.
+
+## Positionnement honnête
+
+VerbalCoding ne doit pas être présenté comme “l’ajout de la voix Discord à Hermes depuis zéro”. Hermes fournit déjà cette base. La description juste : VerbalCoding est une couche de workflow vocal Discord pour agents CLI de code, capable d’utiliser Hermes comme backend par défaut et d’ajouter routage projet, sémantique d’interruption, UX de progression, diagnostics et changement de backend.

package/docs/i18n/HERMES_VOICE.ja.md

@@ -0,0 +1,46 @@
+# Hermes 標準音声 vs VerbalCoding
+
+<!-- readme-glow-up:intro -->
+<p align="center">
+  <a href="../../README.ja.md">README</a> ·
+  <a href="README.ja.md">ドキュメント</a> ·
+  <a href="USAGE.ja.md">利用ガイド</a> ·
+  <a href="CONFIGURATION.ja.md">設定</a> ·
+  <a href="TROUBLESHOOTING.ja.md">トラブルシューティング</a>
+</p>
+
+> Hermes はすでに Discord 音声チャンネルに対応しています。VerbalCoding はその基本ループを置き換えるものではなく、コーディングエージェントと電話のように作業するためのワークフローレイヤーです。
+<!-- /readme-glow-up:intro -->
+
+## Hermes がすでにできること
+
+Hermes Agent の Discord gateway には音声チャンネル対応があります。bot がサーバーに入っていれば、`/voice join` または `/voice channel` で、実行したユーザーが現在入っている VC に参加できます。その後、Whisper/STT で発話を文字起こしし、Edge TTS、ElevenLabs、OpenAI など設定済みの TTS provider で音声回答を再生できます。
+
+基本のライブ音声会話だけなら、この流れで十分です。
+
+```text
+Discord VC → Hermes STT → Hermes agent → TTS → Discord VC playback
+```
+
+## VerbalCoding が追加するもの
+
+| 領域 | Hermes 標準音声 | VerbalCoding |
+|---|---|---|
+| 主目的 | Discord VC での一般的な Hermes 会話 | CLI エージェントと電話のように行うコーディング作業 |
+| コマンド | `/voice join`, `/voice channel`, `/voice leave`, `/voice tts` | `vc setup`, `vc start`, `!join`, `!ask`, `!session`, `!verbose`, `!latency`, multi-instance commands |
+| バックエンド | Hermes Agent | Hermes Agent、Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw、custom command |
+| セッション | 通常の Hermes gateway session | プロジェクト/セッションルーティング、VC バインド、対応バックエンドでの音声 + `!ask` テキスト共有コンテキスト |
+| 音声 UX | 基本 STT + TTS | 調整済み発話ウィンドウ、言語プリセット、transcript cleanup、text mirror、voice test |
+| 割り込み | 基本的な再生動作 | 再生だけ止め、実行中の agent task を誤って殺さない barge-in ルール |
+| 長い作業 | 通常の agent 応答 | 進捗/状態音声、verbose tool-progress 要約、diff/log を TTS で読まない保護 |
+| 運用 | Hermes gateway の設定 | `vc doctor` auto-fix、redacted diagnostics、latency metrics、Docker UDP ガイド、multi-bot/project rooms |
+
+## どちらを選ぶべきか
+
+**Hermes 標準音声**は、単純な「話す → 文字起こし → 回答 → 音声再生」で十分なときに向いています。
+
+**VerbalCoding**は、プロジェクトごとの部屋、音声とテキストの共有コンテキスト、複数 CLI エージェント、韓国語/英語プリセット、長時間作業中の安全な割り込み、進捗音声、運用診断が必要なときに向いています。
+
+## 正直な位置づけ
+
+VerbalCoding を「Hermes に Discord 音声を初めて追加するもの」と説明すべきではありません。Hermes にはすでに基本機能があります。より正確には、VerbalCoding は Hermes を既定バックエンドとして使える、CLI コーディングエージェント向けの Discord 音声ワークフローレイヤーです。

package/docs/i18n/HERMES_VOICE.ko.md

@@ -0,0 +1,65 @@
+# Hermes 기본 음성 vs VerbalCoding
+
+<!-- readme-glow-up:intro -->
+<p align="center">
+  <a href="../../README.ko.md">README</a> ·
+  <a href="README.ko.md">문서 허브</a> ·
+  <a href="USAGE.ko.md">사용법</a> ·
+  <a href="CONFIGURATION.ko.md">설정</a> ·
+  <a href="TROUBLESHOOTING.ko.md">문제 해결</a>
+</p>
+
+> Hermes는 이미 Discord 음성 채널을 지원합니다. VerbalCoding은 그 기본 음성 루프를 대체하는 것이 아니라, 코딩 에이전트와 통화하듯 일하기 위한 워크플로 레이어입니다.
+<!-- /readme-glow-up:intro -->
+
+## Hermes가 이미 하는 일
+
+Hermes Agent에는 Discord gateway 기반 음성 채널 지원이 들어 있습니다. 봇이 서버에 들어온 뒤 `/voice join` 또는 `/voice channel`을 실행하면, 사용자가 현재 들어가 있는 음성 채널에 참가할 수 있습니다. 그 다음 Whisper/STT로 말을 전사하고, Edge TTS, ElevenLabs, OpenAI 등 설정된 TTS provider로 음성 답변을 재생합니다.
+
+기본 라이브 음성 대화만 필요하면 이 흐름으로 충분합니다.
+
+```text
+Discord VC → Hermes STT → Hermes agent → TTS → Discord VC playback
+```
+
+요구사항이 여기까지라면 Hermes 기본 음성 모드를 먼저 쓰면 됩니다.
+
+## VerbalCoding이 더하는 것
+
+VerbalCoding은 같은 큰 루프를 유지하되, CLI 에이전트용 코딩 워크플로 런타임으로 다듬습니다.
+
+| 영역 | Hermes 기본 음성 | VerbalCoding |
+|---|---|---|
+| 주 목적 | Discord VC에서 일반 Hermes 대화 | CLI 에이전트와 통화하듯 코딩 작업 |
+| 명령 | `/voice join`, `/voice channel`, `/voice leave`, `/voice tts` | `vc setup`, `vc start`, `!join`, `!ask`, `!session`, `!verbose`, `!latency`, multi-instance 명령 |
+| 백엔드 | Hermes Agent | Hermes Agent, Claude Code, Codex, Gemini CLI, OpenCode, OpenClaw, custom command |
+| 세션 모델 | 일반 Hermes gateway 세션 | 프로젝트/세션 라우팅, 음성 채널 바인딩, 지원되는 경우 음성 + `!ask` 텍스트 공유 컨텍스트 |
+| 음성 UX | 기본 STT + TTS | 조정된 발화 종료 판단, 언어 프리셋, transcript cleanup, text mirror, voice test |
+| 끼어들기 | 기본 재생 동작 | 재생은 멈추되 실행 중인 에이전트 작업은 실수로 죽이지 않는 바지인 규칙 |
+| 긴 코딩 작업 | 일반 agent 응답 | 진행/상태 음성, verbose tool-progress 요약, diff/log TTS 낭독 방지 |
+| 운영 | Hermes gateway 설정과 config | `vc doctor` auto-fix, redacted diagnostics, latency metrics, Docker UDP 안내, multi-bot/project rooms |
+
+## 무엇을 선택할까
+
+**Hermes 기본 음성**이 맞는 경우:
+
+- Discord 음성 채널 하나에서 간단히 말하고 답변을 듣고 싶다;
+- speak → transcribe → answer → speak-back 흐름이면 충분하다;
+- 추가 소프트웨어를 최소화하고 공식 Hermes gateway 경로를 쓰고 싶다;
+- Hermes 세션과 도구만 쓰면 된다.
+
+**VerbalCoding**이 맞는 경우:
+
+- 음성과 텍스트가 코딩 프로젝트 컨텍스트를 함께 공유해야 한다;
+- Hermes 외 Claude Code, Codex 등 여러 CLI 에이전트 백엔드를 쓰고 싶다;
+- 프로젝트별 Discord 방이나 여러 bot instance가 필요하다;
+- 한국어/영어 언어 프리셋과 런타임 voice control이 필요하다;
+- 긴 작업 중 끼어들기 처리와 취소 의미를 세밀하게 다루고 싶다;
+- 거대한 diff, stack trace, log를 음성으로 읽지 않고 진행 상황만 듣고 싶다;
+- `vc doctor`, latency summary, container voice-network 안내 같은 운영 도구가 필요하다.
+
+## 정직한 포지셔닝
+
+VerbalCoding을 “Hermes에 Discord 음성을 처음 붙이는 프로젝트”라고 설명하면 안 됩니다. Hermes는 이미 그 기본 기능을 갖고 있습니다. 더 정확한 설명은 다음과 같습니다.
+
+> VerbalCoding은 CLI 코딩 에이전트용 Discord 음성 워크플로 레이어입니다. Hermes를 기본 백엔드로 사용할 수 있고, 긴 소프트웨어 작업을 위해 프로젝트 라우팅, 끼어들기 의미론, 진행 UX, 진단, 백엔드 전환을 추가합니다.

package/docs/i18n/HERMES_VOICE.ru.md

@@ -0,0 +1,46 @@
+# Встроенный голос Hermes vs VerbalCoding
+
+<!-- readme-glow-up:intro -->
+<p align="center">
+  <a href="../../README.ru.md">README</a> ·
+  <a href="README.ru.md">Центр документации</a> ·
+  <a href="USAGE.ru.md">Использование</a> ·
+  <a href="CONFIGURATION.ru.md">Конфигурация</a> ·
+  <a href="TROUBLESHOOTING.ru.md">Диагностика</a>
+</p>
+
+> Hermes уже поддерживает голосовые каналы Discord. VerbalCoding не заменяет этот базовый цикл, а добавляет workflow-слой для работы с coding-агентами как по телефону.
+<!-- /readme-glow-up:intro -->
+
+## Что Hermes уже умеет
+
+Discord gateway в Hermes Agent умеет работать с голосовыми каналами. Когда bot находится на сервере, команды `/voice join` или `/voice channel` подключают его к VC, где сейчас находится пользователь. Затем Hermes распознаёт речь через Whisper/STT и отвечает голосом через Edge TTS, ElevenLabs, OpenAI или другой настроенный TTS provider.
+
+Для базового живого голосового чата этого уже достаточно:
+
+```text
+Discord VC → Hermes STT → Hermes agent → TTS → Discord VC playback
+```
+
+## Что добавляет VerbalCoding
+
+| Область | Встроенный голос Hermes | VerbalCoding |
+|---|---|---|
+| Цель | Обычный разговор с Hermes в Discord VC | Телефонный workflow для CLI coding-агентов |
+| Команды | `/voice join`, `/voice channel`, `/voice leave`, `/voice tts` | `vc setup`, `vc start`, `!join`, `!ask`, `!session`, `!verbose`, `!latency`, multi-instance команды |
+| Backend | Hermes Agent | Hermes Agent, Claude Code, Codex, Gemini CLI, OpenCode, OpenClaw или custom command |
+| Сессии | Обычная Hermes gateway session | Маршрутизация project/session, привязка VC, общий контекст голоса + `!ask` где backend это поддерживает |
+| Голосовой UX | Базовые STT + TTS | Настроенные окна реплик, языковые пресеты, очистка transcript, text mirror, voice tests |
+| Прерывания | Базовое поведение playback | Barge-in правила: остановить воспроизведение, не убив случайно активную agent task |
+| Долгие задачи | Обычный ответ agent | Голосовой progress/status, verbose сводки tool-progress, защита от чтения diff/log через TTS |
+| Операции | Настройка Hermes gateway | `vc doctor`, redacted diagnostics, latency metrics, Docker UDP guidance, multi-bot/project rooms |
+
+## Что выбрать
+
+Выбирайте **встроенный голос Hermes**, если нужен простой цикл “сказать → распознать → ответить → озвучить” в одном голосовом канале.
+
+Выбирайте **VerbalCoding**, если нужен общий проектный контекст для голоса и текста, несколько CLI backend, корейские/английские пресеты, безопасные прерывания во время долгих задач, голосовой прогресс, latency metrics и операционные инструменты.
+
+## Честное позиционирование
+
+VerbalCoding не стоит описывать как “добавление Discord voice в Hermes с нуля”. У Hermes уже есть базовая функция. Точнее: VerbalCoding — это Discord voice workflow layer для CLI coding-агентов; он может использовать Hermes как backend по умолчанию и добавляет project routing, interruption semantics, progress UX, diagnostics и backend switching.

package/docs/i18n/HERMES_VOICE.zh.md

@@ -0,0 +1,46 @@
+# Hermes 内置语音 vs VerbalCoding
+
+<!-- readme-glow-up:intro -->
+<p align="center">
+  <a href="../../README.zh.md">README</a> ·
+  <a href="README.zh.md">文档中心</a> ·
+  <a href="USAGE.zh.md">使用指南</a> ·
+  <a href="CONFIGURATION.zh.md">配置</a> ·
+  <a href="TROUBLESHOOTING.zh.md">故障排查</a>
+</p>
+
+> Hermes 已经支持 Discord 语音频道。VerbalCoding 不是替代这个基础能力，而是在其上提供面向编码代理的“电话式”工作流层。
+<!-- /readme-glow-up:intro -->
+
+## Hermes 已经支持什么
+
+Hermes Agent 的 Discord gateway 内置了语音频道支持。bot 加入服务器后，用户可以通过 `/voice join` 或 `/voice channel` 让它加入自己当前所在的 VC。随后 Hermes 会用 Whisper/STT 转写语音，并通过 Edge TTS、ElevenLabs、OpenAI 等已配置的 TTS provider 在语音频道中回答。
+
+如果你只需要基础实时语音对话，这个闭环已经足够：
+
+```text
+Discord VC → Hermes STT → Hermes agent → TTS → Discord VC playback
+```
+
+## VerbalCoding 增加什么
+
+| 领域 | Hermes 内置语音 | VerbalCoding |
+|---|---|---|
+| 主要目标 | 在 Discord VC 中进行普通 Hermes 对话 | 像打电话一样使用 CLI 编码代理工作 |
+| 命令 | `/voice join`, `/voice channel`, `/voice leave`, `/voice tts` | `vc setup`, `vc start`, `!join`, `!ask`, `!session`, `!verbose`, `!latency`, 多实例命令 |
+| 后端 | Hermes Agent | Hermes Agent、Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 或自定义命令 |
+| 会话模型 | 普通 Hermes gateway 会话 | 项目/会话路由、语音频道绑定、支持时共享语音 + `!ask` 文本上下文 |
+| 语音体验 | 基础 STT + TTS | 调整过的发话窗口、语言预设、转写清理、文本镜像、语音测试 |
+| 打断 | 基础播放行为 | 停止当前播放，但避免误杀正在运行的 agent 任务 |
+| 长任务 | 普通 agent 回复 | 进度/状态语音、verbose 工具进度摘要、避免朗读巨大 diff/log |
+| 运维 | Hermes gateway 配置 | `vc doctor` 自动修复、脱敏诊断、延迟指标、Docker UDP 指南、多 bot/项目房间 |
+
+## 如何选择
+
+选择 **Hermes 内置语音**：你只需要一个 bot 在一个 Discord 语音频道中完成简单的“说话、转写、回答、朗读”。
+
+选择 **VerbalCoding**：你需要项目级房间、语音与文本共享上下文、多 CLI agent 后端、韩/英语言预设、长任务中的安全打断、进度语音、延迟指标和 `vc doctor` 这类运维工具。
+
+## 准确定位
+
+不要把 VerbalCoding 描述成“给 Hermes 从零添加 Discord 语音”。Hermes 已经有基础语音功能。更准确的说法是：VerbalCoding 是面向 CLI 编码代理的 Discord 语音工作流层，可以使用 Hermes 作为默认后端，并为长时间软件工作添加项目路由、打断语义、进度 UX、诊断和后端切换。

package/docs/i18n/MULTI_INSTANCE.es.md

@@ -1,5 +1,30 @@
 # VerbalCoding multiinstancia
 
+<!-- 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:`.
+
 VerbalCoding puede ejecutar múltiples procesos independientes de puente de voz de Discord. Cada proceso sigue siendo el puente Node de instancia única existente, pero carga un archivo `instances/<name>.env` diferente y usa un token de bot de Discord diferente.
 
 Usa esto cuando cada proyecto deba ocupar permanentemente su propio canal de voz de Discord y escribir en su propio canal/hilo de transcripción.

package/docs/i18n/MULTI_INSTANCE.fr.md

@@ -1,5 +1,30 @@
 # VerbalCoding multi-instance
 
+<!-- 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:`.
+
 VerbalCoding peut exécuter plusieurs processus indépendants de passerelle vocale Discord. Chaque processus reste la passerelle Node à instance unique existante, mais il charge un fichier `instances/<name>.env` différent et utilise un jeton de bot Discord différent.
 
 Utilisez ceci quand chaque projet doit occuper de façon permanente son propre salon vocal Discord et écrire dans son propre salon/fil de transcription.

package/docs/i18n/MULTI_INSTANCE.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:` を削除します。
+
 VerbalCoding は、複数の独立した Discord 音声ブリッジプロセスを実行できます。各プロセスは既存の単一インスタンス Node ブリッジのままですが、異なる `instances/<name>.env` ファイルを読み込み、異なる Discord ボットトークンを使います。
 
 各プロジェクトが専用の Discord 音声チャンネルに常駐し、専用の文字起こしチャンネル/スレッドへ書き込む必要がある場合に使います。

package/docs/i18n/MULTI_INSTANCE.ko.md

@@ -1,5 +1,30 @@
 # Multi-instance 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은 여러 개의 독립적인 Discord 음성 브리지 프로세스를 실행할 수 있습니다. 각 프로세스는 여전히 기존 단일 인스턴스 Node 브리지이지만, 서로 다른 `instances/<name>.env` 파일을 로드하고 서로 다른 Discord 봇 토큰을 사용합니다.
 
 각 프로젝트가 자체 Discord 음성 채널을 영구적으로 차지하고 자체 전사 채널/스레드에 기록해야 할 때 사용하세요.

package/docs/i18n/MULTI_INSTANCE.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. Каждый процесс всё ещё является существующим одноэкземплярным Node bridge, но загружает другой файл `instances/<name>.env` и использует другой токен Discord-бота.
 
 Используйте это, когда каждый проект должен постоянно занимать собственный голосовой канал Discord и писать в собственный канал/тред расшифровок.

package/docs/i18n/MULTI_INSTANCE.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 语音桥接进程。每个进程仍然是现有的单实例 Node 桥接，但会加载不同的 `instances/<name>.env` 文件，并使用不同的 Discord 机器人令牌。
 
 当每个项目都应长期占用自己的 Discord 语音频道，并写入自己的转写频道/thread 时，请使用此模式。