verbalcoding 0.2.7 → 0.2.8

package/docs/i18n/README.zh.md

@@ -1,27 +1,48 @@
 # VerbalCoding
 
-**通过 Discord 语音像打电话一样控制 CLI 编程代理。**
-
-[English](../../README.md) · [한국어](README.ko.md) · [日本語](README.ja.md) · [中文](README.zh.md) · [Español](README.es.md) · [Français](README.fr.md) · [Русский](README.ru.md)
-
-![VerbalCoding voice-to-agent flow](../assets/figures/verbalcoding-flow.svg)
-
-## Why
-
-VerbalCoding 把 Discord 语音频道变成编程代理的免手控制界面。说出需求，让 CLI 代理工作，然后收到简洁的语音回复、文本转录和进度事件。
-
-## Highlights
-
-| Feature | What it means |
+<p align="center">
+  <strong>通过 Discord 语音与 CLI 编码代理对话——就像给软件工作打一通电话。</strong>
+</p>
+
+<p align="center">
+  <a href="README.ko.md">한국어</a> ·
+  <a href="README.ja.md">日本語</a> ·
+  <a href="README.zh.md">中文</a> ·
+  <a href="README.es.md">Español</a> ·
+  <a href="README.fr.md">Français</a> ·
+  <a href="README.ru.md">Русский</a>
+</p>
+
+<p align="center">
+  <img alt="Node.js" src="https://img.shields.io/badge/Node.js-20%2B-339933?logo=node.js&logoColor=white">
+  <img alt="Discord" src="https://img.shields.io/badge/Discord-voice%20bridge-5865F2?logo=discord&logoColor=white">
+  <img alt="STT" src="https://img.shields.io/badge/STT-whisper.cpp-7C3AED">
+  <img alt="TTS" src="https://img.shields.io/badge/TTS-Edge%20%7C%20OpenVoice%20%7C%20Supertonic%20%7C%20SpeechSwift-0EA5E9">
+  <img alt="Agents" src="https://img.shields.io/badge/Agents-Hermes%20%7C%20Claude%20%7C%20Codex%20%7C%20Gemini%20%7C%20OpenCode-111827">
+</p>
+
+<p align="center">
+  <img src="../assets/figures/verbalcoding-flow.svg" alt="VerbalCoding 语音到代理流程" width="860">
+</p>
+
+## 为什么需要它
+
+VerbalCoding 会把 Discord 语音频道变成编码代理的免手动控制面板。说出请求，让你的 CLI 代理执行工作，然后听到简洁的语音回复——同时保留文本转写、进度事件，以及针对嘈杂代码/日志输出的保护机制。
+
+## 亮点
+
+| 你能获得什么 | 为什么体验很好 |
 |---|---|
-| Voice-first agent control | Hermes Agent, Claude Code, Codex, Gemini CLI, OpenCode, OpenClaw, or a custom CLI harness. |
-| Local-first speech loop | Discord voice capture → `whisper.cpp` STT → agent → chunked TTS playback. |
-| Shared voice + text context | Voice turns and `!ask` text commands can reuse the same supported agent session. |
-| Barge-in and sensitivity modes | Interrupt playback naturally and switch between normal and conservative/noisy modes. |
-| Multilingual voice presets | `vc language ko/en/auto` changes STT, progress language, and TTS voice together. |
-| Multi-room project isolation | Run one bot per project room with isolated Hermes profiles, sessions, memory, and logs. |
+| 语音优先的代理控制 | 可以与 Hermes Agent、Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 或任何自定义 CLI 驱动对话。 |
+| 本机语音闭环 | Discord 语音采集 → 本地 `whisper-cli` 转写 → 代理 → 分块 TTS 播放。 |
+| 共享语音 + 文本上下文 | 语音轮次和 `!ask` 文本命令可以复用同一个受支持的代理会话。 |
+| 插话和灵敏度模式 | 可以自然打断播放，并在普通环境与保守/嘈杂环境之间切换。 |
+| 多语言语音预设 | 使用 `vc language ko/en/auto` 同时切换 STT、进度语言和 TTS 声音。 |
+| 多房间项目隔离 | 每个项目房间运行一个机器人，并隔离 Hermes 配置、会话、记忆和日志。 |
 
-## Quick Start
+## 快速开始
+
+使用 npm 的最快路径：
 
 ```bash
 npm install -g verbalcoding
@@ -30,7 +51,7 @@ vc doctor
 vc start
 ```
 
-Run without a permanent global install:
+或者无需永久全局安装，直接运行：
 
 ```bash
 npx verbalcoding setup --yes
@@ -38,7 +59,7 @@ vc doctor
 vc start
 ```
 
-Contributor clone path:
+贡献者的 GitHub 克隆路径：
 
 ```bash
 git clone https://github.com/ca1773130n/VerbalCoding.git
@@ -48,38 +69,80 @@ vc doctor
 ./run.sh
 ```
 
-`vc setup --yes` and `./scripts/install.sh --yes` bootstrap npm dependencies, `ffmpeg`, `whisper-cli`, the default whisper.cpp model, a local Edge TTS helper, and the short `vc` command where possible.
+`vc setup --yes` 会通过 npm 包内置的安装器引导安装本地前置依赖。`./scripts/install.sh --yes` 只在 GitHub 克隆目录中执行同样的流程。两者都会在可行时处理 Node/npm 依赖、`ffmpeg`、`whisper-cli`、默认 whisper.cpp 模型、本地 `.venv-tts` Edge TTS 辅助环境以及设置向导配置。它们支持 macOS/Homebrew 以及常见 Linux 包管理器（`apt`、`dnf`、`pacman`）；如只想安装依赖而不运行向导，可用 `--no-wizard` 重新运行；如果想自行安装 OS 软件包，可用 `--skip-system`。
+
+需要干净安装演练？从[全新安装](FRESH_INSTALL.zh.md)开始。
+
+## 支持的代理后端
 
-## Guides
+| 后端 | 默认命令 | 会话支持 |
+|---|---:|---|
+| Hermes Agent | `hermes chat -Q -q` | 恢复、详细进度、取消、最终答案恢复 |
+| Claude Code | `claude -p` | 通过适配器默认值支持 CLI 会话文件 |
+| Codex CLI | `codex exec` | 通过适配器默认值支持 CLI 会话文件 |
+| Gemini CLI | `gemini -p` | 通过适配器默认值支持 CLI 会话文件 |
+| OpenCode | `opencode run` | 通过适配器默认值支持 CLI 会话文件 |
+| OpenClaw | `openclaw run` | 通过适配器默认值支持 CLI 会话文件 |
+| Custom | `AGENT_COMMAND` | 自带非交互式命令 |
 
-| Guide | Link |
+## 了解更多
+
+| 指南 | 你能获得什么 |
 |---|---|
-| 全新安装 | [FRESH_INSTALL.zh.md](FRESH_INSTALL.zh.md) |
-| 使用指南 | [USAGE.zh.md](USAGE.zh.md) |
-| 配置 | [CONFIGURATION.zh.md](CONFIGURATION.zh.md) |
-| 多实例 | [MULTI_INSTANCE.zh.md](MULTI_INSTANCE.zh.md) |
-| 发布说明 | [RELEASE.zh.md](RELEASE.zh.md) |
+| [全新安装](FRESH_INSTALL.zh.md) | 干净克隆设置、模型下载、首次运行 |
+| [使用指南](USAGE.zh.md) | CLI 命令、Discord 命令、进度模式、延迟指标 |
+| [配置](CONFIGURATION.zh.md) | `.env`、代理后端、MCP、TTS 后端、运维说明 |
+| [多实例](MULTI_INSTANCE.zh.md) | 每个项目一个长期 Discord 语音房间 |
+| [发行说明](RELEASE.zh.md) | 当前能力和预发布检查清单 |
 
-## Command map
+## 精简命令地图
 
 ```bash
-vc status
-vc language ko|en|auto
-vc bot invite CLIENT_ID
-vc instance setup NAME
-vc instance start NAME
-vc doctor
-vc start
+vc status                 # 当前语言、TTS 和桥接设置
+vc language ko|en|auto    # 切换 STT/进度/TTS 语言预设
+vc bot invite CLIENT_ID   # 生成 Discord 机器人邀请 URL
+vc instance setup NAME    # 创建隔离的项目语音机器人
+vc instance start NAME    # 在后台运行该机器人
+vc doctor                 # 脱敏健康检查
+vc start                  # 启动默认桥接
 ```
 
-Discord commands:
+在 Discord 中：
+
+| 命令 | 作用 |
+|---|---|
+| `!join` | 加入你当前的语音频道。 |
+| `!ask <prompt>` | 将文本发送给同一个代理后端。 |
+| `!verbose on\|off` | 显示/朗读简短进度更新。 |
+| `!latency` | 汇总最近的语音/STT/代理/TTS 延迟。 |
+| `!sensitivity normal` | 使用普通室内插话灵敏度。 |
+| `!sensitivity conservative` | 使用更严格的嘈杂/户外灵敏度。 |
+| `!session new <name> <workdir> [context] --voice <voice-channel>` | 将项目会话绑定到语音房间。 |
+
+## 要求
+
+| 层 | 默认值 |
+|---|---|
+| 运行时 | Node.js 20+、npm；安装脚本可通过 Homebrew/apt/dnf/pacman 安装 |
+| 音频 | `ffmpeg`；安装脚本可安装它 |
+| 语音识别 | 来自 whisper.cpp 的本地 `whisper-cli`；安装脚本在 macOS 使用 Homebrew，在 Linux 使用本地构建回退 |
+| TTS | Edge TTS CLI；安装脚本会在需要时创建 `.venv-tts` |
+| Discord | 机器人令牌、Message Content intent、语音权限 |
+| 代理 | 至少一个已认证的 CLI 驱动，默认是 Hermes Agent |
+| 平台重点 | macOS / Apple Silicon 测试最多；Linux 引导为尽力支持并已文档化 |
+
+## 贡献
+
+提交更改前运行轻量检查：
 
-```text
-!join        !ask <prompt>       !verbose on/off
-!latency     !sensitivity normal !sensitivity conservative
-!session new <name> <workdir> [context] --voice <voice-channel>
+```bash
+node --check app-node/main.mjs
+npm test
+bash -n run.sh scripts/install.sh
+npm pack --dry-run
+vc doctor
 ```
 
-## Requirements
+## 状态
 
-Node.js 20+, npm, `ffmpeg`, `whisper.cpp` / `whisper-cli`, Edge TTS CLI, a Discord bot token with Message Content intent and voice permissions, and at least one authenticated CLI agent backend.
+VerbalCoding 面向公开发布，但仍处于早期阶段。演示视频/GIF、更广泛的 Linux 验证、CI，以及更深入的安全审查仍在 TODO 中。

package/docs/i18n/RELEASE.es.md

@@ -1,58 +1,74 @@
-# VerbalCoding Notas de versión
+# Notas de versión de VerbalCoding
 
-## Current release candidate
+## Candidato de lanzamiento actual
 
-VerbalCoding is a Discord voice bridge for controlling CLI-based coding agents by voice. macOS / Apple Silicon is the most tested path; Linux bootstrap is best-effort for common package managers.
+VerbalCoding es un puente de voz de Discord para controlar por voz agentes de programación basados en CLI. Está orientado al lanzamiento público, con macOS / Apple Silicon como la ruta más probada y soporte de arranque de mejor esfuerzo en Linux para administradores de paquetes comunes.
 
-## Included
+### Incluido
 
-- Discord voice receive via Node `@discordjs/voice`.
-- Local Korean STT via `whisper.cpp` + Metal.
-- Edge TTS playback with Korean default voice.
-- Generic CLI harness adapter layer: Hermes Agent, Claude Code, Codex CLI, Gemini CLI, OpenCode, OpenClaw, or custom command.
-- Shared voice/text session support for Hermes backend.
-- Long-answer TTS chunking and responsive barge-in.
-- Diff/code/log guardrails so large technical output is not read aloud.
-- Normal and conservative sensitivity modes.
-- Setup wizard, `.env.example`, `vc doctor`, `./scripts/install.sh --yes`, and npm install path.
-- `npm install -g verbalcoding`, `vc setup --yes`, and `vc start`.
-- Verbose progress mode, JSONL latency metrics, and `!latency` / `!metrics`.
-- `UTTERANCE_IDLE_MS=4500` for long spoken instructions with natural pauses.
-- Multi-instance Hermes profile isolation via `vc instance setup <name>` and `HERMES_HOME`.
+- Recepción de voz de Discord mediante Node `@discordjs/voice`.
+- STT local en coreano mediante `whisper.cpp` + Metal.
+- Reproducción Edge TTS con voz coreana predeterminada.
+- Capa genérica de adaptador para arneses CLI:
+  - Hermes Agent
+  - Claude Code
+  - Codex CLI
+  - Gemini CLI
+  - OpenCode
+  - OpenClaw
+  - comando personalizado
+- Soporte de sesión compartida de voz/texto para el backend Hermes.
+- Fragmentación TTS de respuestas largas e interrupción receptiva.
+- Protecciones para diff/código/registros para que las salidas técnicas grandes no se lean en voz alta.
+- Modos de sensibilidad normal y conservador para uso en interiores frente a uso ruidoso/exterior.
+- Asistente de configuración, `.env.example`, comprobador de prerrequisitos `vc doctor` y arranque `./scripts/install.sh --yes` para paquetes del SO, dependencias npm, asistente de Edge TTS y el modelo predeterminado de whisper.cpp.
+- Ruta de instalación del paquete npm: `npm install -g verbalcoding`, `vc setup --yes` y `vc start`.
+- Modo opcional de progreso detallado para actualizaciones intermedias solo de texto durante trabajos largos del agente.
+- Métricas de latencia JSONL siempre activas más resumen `!latency` / `!metrics` para optimización del pipeline.
+- Espera de inactividad de emisión más paciente (`UTTERANCE_IDLE_MS=4500`) para que las instrucciones habladas largas con pausas naturales no se dividan en un prompt parcial más habla durante procesamiento ignorada.
+- Aislamiento de perfiles Hermes multiinstancia: `vc instance setup <name>` clona automáticamente un perfil Hermes a `~/.hermes/profiles/<name>` con el workdir de la instancia, inicializa SOUL.md y escribe `HERMES_HOME` en el env de la instancia para mantener separadas la memoria y las skills por proyecto; `vc instance start` autorepara un perfil faltante, y `vc doctor` comprueba la presencia del directorio de perfil y la consistencia de `terminal.cwd`.
 
-## Pre-release checklist
+### Lista de verificación previa al lanzamiento
+
+Ejecuta desde la raíz del repositorio:
 
 ```bash
 ./scripts/install.sh --yes --no-wizard
-./scripts/docker_ubuntu_smoke.sh
+./scripts/docker_ubuntu_smoke.sh   # requires Docker; validates ubuntu:24.04 clean install
 node --check app-node/main.mjs app-node/agent_adapters.mjs app-node/install_config.mjs scripts/install.mjs
 npm test
-PYTEST_DISABLE_PLUGIN_AUTOLOAD=1 python3 -m pytest tests/ -q || [ $? -eq 5 ]
+PYTEST_DISABLE_PLUGIN_AUTOLOAD=1 python3 -m pytest tests/ -q || [ $? -eq 5 ]  # ok when no Python tests exist
 bash -n run.sh scripts/install.sh scripts/bootstrap_prereqs.sh scripts/docker_ubuntu_smoke.sh
 npm pack --dry-run
 vc doctor
 git diff --check
 ```
 
-Manual smoke test:
+Prueba manual rápida:
+
+1. Inicia el puente con `vc start` o `./run.sh`.
+2. Verifica que el registro contenga `Logged in as <bot-name>`.
+3. Verifica que el registro contenga `Listening in voice channel ... / 일반` o el canal predeterminado configurado.
+4. En Discord, ejecuta `!ping`.
+5. En voz de Discord, di una solicitud corta en coreano.
+6. Verifica transcripción STT, respuesta del agente, reproducción TTS y comportamiento de interrupción.
 
-1. Start the bridge with `vc start` or `./run.sh`.
-2. Verify `Logged in as <bot-name>`.
-3. Verify `Listening in voice channel ...`.
-4. In Discord, run `!ping`.
-5. Say a short Korean request in voice.
-6. Verify STT transcript, agent response, TTS playback, and barge-in.
+### Requisitos conocidos
 
-## Known requirements
+- macOS con Homebrew, o Linux con `apt`, `dnf` o `pacman` para arranque de mejor esfuerzo.
+- `ffmpeg`; el instalador intenta instalarlo.
+- `whisper-cli`; el instalador usa Homebrew en macOS o una compilación local alternativa de `vendor/whisper.cpp` en Linux.
+- Modelo predeterminado en `models/ggml-small-q5_1.bin`; el instalador lo descarga salvo que se use `--skip-model`.
+- CLI de Edge TTS en `PATH` o `.venv-tts/bin/edge-tts` local; el instalador crea el asistente local cuando hace falta.
+- Token de bot de Discord en `.env`, `instances/<name>.env`, `~/.zshrc` o env de runtime.
+- Arnés CLI seleccionado instalado y autenticado.
 
-- macOS with Homebrew, or Linux with `apt`, `dnf`, or `pacman`.
-- `ffmpeg`.
-- `whisper-cli`.
-- `models/ggml-small-q5_1.bin`.
-- Edge TTS CLI or `.venv-tts/bin/edge-tts`.
-- Discord bot token in `.env`, `instances/<name>.env`, `~/.zshrc`, or runtime env.
-- Selected CLI harness installed and authenticated.
+### Aún no listo para lanzamiento público
 
-## Not for public release yet
+Antes del lanzamiento público, considera añadir:
 
-Consider adding GitHub Actions CI, demo video/GIF, Discord bot setup screenshots, broader real Linux validation, and security review of logging paths.
+- CI de GitHub Actions.
+- Video / GIF de demostración.
+- Capturas de pantalla de configuración de bot de Discord.
+- Validación más amplia en distribuciones Linux reales más allá de comprobaciones a nivel de script.
+- Revisión de seguridad de todas las rutas de registro.

package/docs/i18n/RELEASE.fr.md

@@ -1,58 +1,74 @@
-# VerbalCoding Notes de version
+# Notes de version de VerbalCoding
 
-## Current release candidate
+## Candidat de version actuel
 
-VerbalCoding is a Discord voice bridge for controlling CLI-based coding agents by voice. macOS / Apple Silicon is the most tested path; Linux bootstrap is best-effort for common package managers.
+VerbalCoding est une passerelle vocale Discord pour contrôler par la voix des agents de codage basés sur CLI. Il vise une publication publique, avec macOS / Apple Silicon comme chemin le plus testé et une prise en charge d'amorçage Linux au mieux pour les gestionnaires de paquets courants.
 
-## Included
+### Inclus
 
-- Discord voice receive via Node `@discordjs/voice`.
-- Local Korean STT via `whisper.cpp` + Metal.
-- Edge TTS playback with Korean default voice.
-- Generic CLI harness adapter layer: Hermes Agent, Claude Code, Codex CLI, Gemini CLI, OpenCode, OpenClaw, or custom command.
-- Shared voice/text session support for Hermes backend.
-- Long-answer TTS chunking and responsive barge-in.
-- Diff/code/log guardrails so large technical output is not read aloud.
-- Normal and conservative sensitivity modes.
-- Setup wizard, `.env.example`, `vc doctor`, `./scripts/install.sh --yes`, and npm install path.
-- `npm install -g verbalcoding`, `vc setup --yes`, and `vc start`.
-- Verbose progress mode, JSONL latency metrics, and `!latency` / `!metrics`.
-- `UTTERANCE_IDLE_MS=4500` for long spoken instructions with natural pauses.
-- Multi-instance Hermes profile isolation via `vc instance setup <name>` and `HERMES_HOME`.
+- Réception vocale Discord via Node `@discordjs/voice`.
+- STT coréen local via `whisper.cpp` + Metal.
+- Lecture Edge TTS avec voix coréenne par défaut.
+- Couche générique d'adaptateur de harnais CLI :
+  - Hermes Agent
+  - Claude Code
+  - Codex CLI
+  - Gemini CLI
+  - OpenCode
+  - OpenClaw
+  - commande personnalisée
+- Prise en charge de session voix/texte partagée pour le backend Hermes.
+- Découpage TTS des longues réponses et interruption réactive.
+- Garde-fous diff/code/journaux pour que les grandes sorties techniques ne soient pas lues à voix haute.
+- Modes de sensibilité normal et conservateur pour usage intérieur vs bruyant/extérieur.
+- Assistant de configuration, `.env.example`, vérificateur de prérequis `vc doctor` et amorçage `./scripts/install.sh --yes` pour les paquets OS, les dépendances npm, l'assistant Edge TTS et le modèle whisper.cpp par défaut.
+- Chemin d'installation par paquet npm : `npm install -g verbalcoding`, `vc setup --yes` et `vc start`.
+- Mode de progression détaillée facultatif pour les mises à jour textuelles d'étapes intermédiaires pendant les longs travaux d'agent.
+- Métriques de latence JSONL toujours actives plus résumé `!latency` / `!metrics` pour l'optimisation du pipeline.
+- Attente d'inactivité d'énonciation plus patiente (`UTTERANCE_IDLE_MS=4500`) afin que les longues instructions parlées avec pauses naturelles ne soient pas coupées en prompt partiel plus parole ignorée pendant le traitement.
+- Isolation multi-instance des profils Hermes : `vc instance setup <name>` clone automatiquement un profil Hermes vers `~/.hermes/profiles/<name>` avec le workdir de l'instance, initialise SOUL.md et écrit `HERMES_HOME` dans l'env de l'instance afin que la mémoire et les skills par projet restent séparés ; `vc instance start` répare automatiquement un profil manquant, et `vc doctor` vérifie la présence du répertoire de profil et la cohérence de `terminal.cwd`.
 
-## Pre-release checklist
+### Checklist de pré-version
+
+Exécutez depuis la racine du dépôt :
 
 ```bash
 ./scripts/install.sh --yes --no-wizard
-./scripts/docker_ubuntu_smoke.sh
+./scripts/docker_ubuntu_smoke.sh   # requires Docker; validates ubuntu:24.04 clean install
 node --check app-node/main.mjs app-node/agent_adapters.mjs app-node/install_config.mjs scripts/install.mjs
 npm test
-PYTEST_DISABLE_PLUGIN_AUTOLOAD=1 python3 -m pytest tests/ -q || [ $? -eq 5 ]
+PYTEST_DISABLE_PLUGIN_AUTOLOAD=1 python3 -m pytest tests/ -q || [ $? -eq 5 ]  # ok when no Python tests exist
 bash -n run.sh scripts/install.sh scripts/bootstrap_prereqs.sh scripts/docker_ubuntu_smoke.sh
 npm pack --dry-run
 vc doctor
 git diff --check
 ```
 
-Manual smoke test:
+Smoke test manuel :
+
+1. Démarrez la passerelle avec `vc start` ou `./run.sh`.
+2. Vérifiez que le journal contient `Logged in as <bot-name>`.
+3. Vérifiez que le journal contient `Listening in voice channel ... / 일반` ou le salon par défaut configuré.
+4. Dans Discord, exécutez `!ping`.
+5. Dans la voix Discord, dites une courte demande en coréen.
+6. Vérifiez la transcription STT, la réponse de l'agent, la lecture TTS et le comportement d'interruption.
 
-1. Start the bridge with `vc start` or `./run.sh`.
-2. Verify `Logged in as <bot-name>`.
-3. Verify `Listening in voice channel ...`.
-4. In Discord, run `!ping`.
-5. Say a short Korean request in voice.
-6. Verify STT transcript, agent response, TTS playback, and barge-in.
+### Exigences connues
 
-## Known requirements
+- macOS avec Homebrew, ou Linux avec `apt`, `dnf` ou `pacman` pour l'amorçage au mieux.
+- `ffmpeg` ; l'installateur tente de l'installer.
+- `whisper-cli` ; l'installateur utilise Homebrew sur macOS ou un fallback de build local `vendor/whisper.cpp` sur Linux.
+- Modèle par défaut à `models/ggml-small-q5_1.bin` ; l'installateur le télécharge sauf si `--skip-model` est utilisé.
+- CLI Edge TTS dans `PATH` ou `.venv-tts/bin/edge-tts` local ; l'installateur crée l'assistant local si nécessaire.
+- Jeton de bot Discord dans `.env`, `instances/<name>.env`, `~/.zshrc` ou l'env d'exécution.
+- Harnais CLI sélectionné installé et authentifié.
 
-- macOS with Homebrew, or Linux with `apt`, `dnf`, or `pacman`.
-- `ffmpeg`.
-- `whisper-cli`.
-- `models/ggml-small-q5_1.bin`.
-- Edge TTS CLI or `.venv-tts/bin/edge-tts`.
-- Discord bot token in `.env`, `instances/<name>.env`, `~/.zshrc`, or runtime env.
-- Selected CLI harness installed and authenticated.
+### Pas encore prêt pour la publication publique
 
-## Not for public release yet
+Avant la publication publique, envisagez d'ajouter :
 
-Consider adding GitHub Actions CI, demo video/GIF, Discord bot setup screenshots, broader real Linux validation, and security review of logging paths.
+- CI GitHub Actions.
+- Vidéo / GIF de démonstration.
+- Captures d'écran de configuration du bot Discord.
+- Validation Linux plus large sur de vraies distributions au-delà des contrôles au niveau des scripts.
+- Revue de sécurité de tous les chemins de journalisation.

package/docs/i18n/RELEASE.ja.md

@@ -1,58 +1,74 @@
 # VerbalCoding リリースノート
 
-## Current release candidate
+## 現在のリリース候補
 
-VerbalCoding is a Discord voice bridge for controlling CLI-based coding agents by voice. macOS / Apple Silicon is the most tested path; Linux bootstrap is best-effort for common package managers.
+VerbalCoding は、CLI ベースのコーディングエージェントを音声で操作するための Discord 音声ブリッジです。公開リリースを意識しており、最も検証されている経路は macOS / Apple Silicon です。一般的なパッケージマネージャー向けに、Linux のベストエフォートなブートストラップもサポートしています。
 
-## Included
+### 含まれるもの
 
-- Discord voice receive via Node `@discordjs/voice`.
-- Local Korean STT via `whisper.cpp` + Metal.
-- Edge TTS playback with Korean default voice.
-- Generic CLI harness adapter layer: Hermes Agent, Claude Code, Codex CLI, Gemini CLI, OpenCode, OpenClaw, or custom command.
-- Shared voice/text session support for Hermes backend.
-- Long-answer TTS chunking and responsive barge-in.
-- Diff/code/log guardrails so large technical output is not read aloud.
-- Normal and conservative sensitivity modes.
-- Setup wizard, `.env.example`, `vc doctor`, `./scripts/install.sh --yes`, and npm install path.
-- `npm install -g verbalcoding`, `vc setup --yes`, and `vc start`.
-- Verbose progress mode, JSONL latency metrics, and `!latency` / `!metrics`.
-- `UTTERANCE_IDLE_MS=4500` for long spoken instructions with natural pauses.
-- Multi-instance Hermes profile isolation via `vc instance setup <name>` and `HERMES_HOME`.
+- Node `@discordjs/voice` による Discord 音声受信。
+- `whisper.cpp` + Metal によるローカル韓国語 STT。
+- 韓国語デフォルト音声による Edge TTS 再生。
+- 汎用 CLI ハーネスアダプターレイヤー:
+  - Hermes Agent
+  - Claude Code
+  - Codex CLI
+  - Gemini CLI
+  - OpenCode
+  - OpenClaw
+  - カスタムコマンド
+- Hermes バックエンド向けの共有音声/テキストセッション対応。
+- 長い回答の TTS 分割と応答性の高い割り込み発話。
+- 大きな技術出力を読み上げないための 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`。
+- 長いエージェント作業中に、テキストのみの中間ステップ更新を出す任意の詳細進捗モード。
+- パイプライン最適化のための常時オン JSONL レイテンシ指標と、`!latency` / `!metrics` 要約。
+- より余裕のある発話アイドル待ち（`UTTERANCE_IDLE_MS=4500`）。自然な間を含む長い音声指示が、部分プロンプトと無視される処理中発話に分割されないようにします。
+- マルチインスタンス Hermes プロファイル分離: `vc instance setup <name>` は、インスタンス作業ディレクトリ付きで Hermes プロファイルを `~/.hermes/profiles/<name>` に自動複製し、SOUL.md を初期化し、インスタンス env に `HERMES_HOME` を書き込みます。これによりプロジェクトごとのメモリとスキルを分離できます。`vc instance start` は欠落したプロファイルを自己修復し、`vc doctor` はプロファイルディレクトリの存在と `terminal.cwd` の整合性を確認します。
 
-## Pre-release checklist
+### プレリリースチェックリスト
+
+リポジトリルートから実行してください:
 
 ```bash
 ./scripts/install.sh --yes --no-wizard
-./scripts/docker_ubuntu_smoke.sh
+./scripts/docker_ubuntu_smoke.sh   # Docker が必要。ubuntu:24.04 のクリーンインストールを検証
 node --check app-node/main.mjs app-node/agent_adapters.mjs app-node/install_config.mjs scripts/install.mjs
 npm test
-PYTEST_DISABLE_PLUGIN_AUTOLOAD=1 python3 -m pytest tests/ -q || [ $? -eq 5 ]
+PYTEST_DISABLE_PLUGIN_AUTOLOAD=1 python3 -m pytest tests/ -q || [ $? -eq 5 ]  # Python テストが存在しない場合は OK
 bash -n run.sh scripts/install.sh scripts/bootstrap_prereqs.sh scripts/docker_ubuntu_smoke.sh
 npm pack --dry-run
 vc doctor
 git diff --check
 ```
 
-Manual smoke test:
+手動スモークテスト:
+
+1. `vc start` または `./run.sh` でブリッジを起動します。
+2. ログに `Logged in as <bot-name>` が含まれることを確認します。
+3. ログに `Listening in voice channel ... / 일반` または設定済みのデフォルトチャンネルが含まれることを確認します。
+4. Discord で `!ping` を実行します。
+5. Discord 音声で短い韓国語リクエストを話します。
+6. STT 文字起こし、エージェント応答、TTS 再生、割り込み発話の動作を確認します。
 
-1. Start the bridge with `vc start` or `./run.sh`.
-2. Verify `Logged in as <bot-name>`.
-3. Verify `Listening in voice channel ...`.
-4. In Discord, run `!ping`.
-5. Say a short Korean request in voice.
-6. Verify STT transcript, agent response, TTS playback, and barge-in.
+### 既知の要件
 
-## Known requirements
+- ベストエフォートのブートストラップには、Homebrew 付き macOS、または `apt`、`dnf`、`pacman` 付き Linux が必要です。
+- `ffmpeg`。インストーラーはこれのインストールを試みます。
+- `whisper-cli`。インストーラーは macOS では Homebrew、Linux ではローカル `vendor/whisper.cpp` ビルドのフォールバックを使います。
+- `models/ggml-small-q5_1.bin` にあるデフォルトモデル。`--skip-model` を使わない限り、インストーラーがダウンロードします。
+- `PATH` 上の Edge TTS CLI、またはローカル `.venv-tts/bin/edge-tts`。必要な場合、インストーラーがローカルヘルパーを作成します。
+- `.env`、`instances/<name>.env`、`~/.zshrc`、または実行時 env 内の Discord ボットトークン。
+- 選択した CLI ハーネスがインストール済みで認証済みであること。
 
-- macOS with Homebrew, or Linux with `apt`, `dnf`, or `pacman`.
-- `ffmpeg`.
-- `whisper-cli`.
-- `models/ggml-small-q5_1.bin`.
-- Edge TTS CLI or `.venv-tts/bin/edge-tts`.
-- Discord bot token in `.env`, `instances/<name>.env`, `~/.zshrc`, or runtime env.
-- Selected CLI harness installed and authenticated.
+### まだ公開リリース向けではないもの
 
-## Not for public release yet
+公開リリース前に、次の追加を検討してください:
 
-Consider adding GitHub Actions CI, demo video/GIF, Discord bot setup screenshots, broader real Linux validation, and security review of logging paths.
+- GitHub Actions CI。
+- デモ動画 / GIF。
+- Discord ボットセットアップのスクリーンショット。
+- スクリプトレベルのチェックを超えた、実ディストリビューション上でのより広範な Linux 検証。
+- すべてのログパスのセキュリティレビュー。