docs: organize localized readme entrypoints

CONTRIBUTING.md

@@ -259,9 +259,13 @@ translations may ship as `ai-translated`; do not claim fluent review unless a
 review reference is recorded. Focused correction PRs from fluent contributors
 are the canonical way to improve wording and can advance a locale to
 `community-reviewed` or `verified` under `docs/translation-playbook.md`.
-Translated READMEs use separate `README.<locale>.md` files; `README.md` remains
-the canonical project description. User docs may be added incrementally under
-`user-docs/<locale>/`, with links back to canonical English reference material.
+Translated README entrypoints live under `docs/readme/` as
+`README.<locale>.md`; root `README.md` remains the canonical project
+description. Keep translated entrypoints concise: summarize onboarding and
+core capabilities, link to localized user docs where available, and link back
+to English for fast-moving architecture, security, and operator detail. User
+docs may be added incrementally under `user-docs/<locale>/`, with links back to
+canonical English reference material.
 
 ## Changelog & writing conventions
 

README.md

@@ -21,7 +21,13 @@
 </p>
 
 <p align="center">
-  <strong>English</strong> · <a href="README.zh-CN.md">简体中文</a><br>
+  <strong>English</strong> ·
+  <a href="docs/readme/README.de.md">Deutsch</a> ·
+  <a href="docs/readme/README.es.md">Español</a> ·
+  <a href="docs/readme/README.ja.md">日本語</a> ·
+  <a href="docs/readme/README.pt-BR.md">Português (Brasil)</a> ·
+  <a href="docs/readme/README.ru.md">Русский</a> ·
+  <a href="docs/readme/README.zh-CN.md">简体中文</a><br>
   <a href="https://hermes-relay.dev/docs/">Documentation</a> ·
   <a href="https://github.com/Codename-11/hermes-relay/releases">Releases</a> ·
   <a href="https://github.com/Codename-11/hermes-relay/discussions">Discussions</a> ·

README.zh-CN.md

@@ -1,109 +0,0 @@
-<p align="center">
-  <img src="assets/play-store-feature-1024x500.png" alt="Hermes-Relay — 随身携带您的 Hermes 代理" width="800">
-</p>
-
-<p align="center">
-  <strong>运行在您的电脑上，连接到您的设备。</strong><br>
-  Hermes-Relay 是 <a href="https://github.com/NousResearch/hermes-agent">Hermes Agent</a> 的原生 Android 客户端，提供流式聊天、免手动语音和代理管理；另有单文件 CLI，让代理在已配对的电脑上安全使用终端、文件和截图工具。
-</p>
-
-<p align="center">
-  <strong>简体中文</strong> · <a href="README.md">English</a><br>
-  <a href="https://hermes-relay.dev/docs/zh-CN/">中文文档</a> ·
-  <a href="https://github.com/Codename-11/hermes-relay/releases">版本下载</a> ·
-  <a href="https://github.com/Codename-11/hermes-relay/discussions">社区讨论</a> ·
-  <a href="CHANGELOG.md">更新日志</a>
-</p>
-
-> 英文 [README.md](README.md) 是最新、完整的项目说明。本页维护中文安装入口和核心功能摘要；协议、架构和维护者文档以英文版本为准。
-
-## 功能简介
-
-- **Android 应用**：流式聊天、会话历史、文件附件、Hermes 管理、语音模式、原生插件页面、Petdex 悬浮宠物、多连接和配置文件；也可将 Hermes 设为 Android 助手。
-- **无需插件的标准路径**：聊天、管理和标准语音可直接连接未修改的上游 Hermes Agent。
-- **可选 Relay 插件**：增加终端、手机控制、媒体传输、通知助手、Relay 语音、电脑工具，以及需确认的代理创建插件页面草稿。
-- **安全连接**：二维码配对、Android Keystore、证书固定、按通道授权和可配置会话有效期。
-- **远程使用**：可配置 Tailscale 或 HTTPS 地址，在家庭局域网和远程路由之间自动切换。
-- **两种 Android 发行渠道**：Google Play 版本适合日常使用；sideload 版本包含完整手机控制能力。
-
-## 快速开始
-
-### 1. 安装 Android 应用
-
-- [Google Play](https://play.google.com/store/apps/details?id=com.axiomlabs.hermesrelay)：自动更新，包含聊天、语音、管理、终端、媒体和通知功能。
-- [GitHub Releases](https://github.com/Codename-11/hermes-relay/releases)：下载最新 `android-v*` 版本中以 `-sideload-release.apk` 结尾的文件，获得完整手机控制功能。
-
-### 2. 启动 Hermes API 服务
-
-手机需要能够访问 Hermes API 服务，并使用 API 密钥进行身份验证：
-
-```bash
-hermes setup --portal
-
-mkdir -p ~/.hermes
-API_SERVER_KEY="$(openssl rand -hex 32)"
-cat >> ~/.hermes/.env <<EOF
-API_SERVER_ENABLED=true
-API_SERVER_HOST=0.0.0.0
-API_SERVER_PORT=8642
-API_SERVER_KEY=$API_SERVER_KEY
-EOF
-chmod 600 ~/.hermes/.env
-
-echo "Android API URL: http://<电脑IP>:8642   key: $API_SERVER_KEY"
-hermes gateway
-```
-
-`0.0.0.0` 会让同一网络中的设备访问 API。请保留强密钥；离开可信局域网时，应使用 Tailscale 或 HTTPS 反向代理，不要直接把端口暴露到互联网。
-
-### 3. 在手机上连接
-
-打开应用后，可以：
-
-- 扫描局域网中的 Hermes；
-- 手动输入 `http://<主机>:8642` 和 API 密钥；
-- 扫描包含 API、Dashboard 和可选 Relay 地址的设置二维码。
-
-如需在手机上管理模型、密钥、技能和配置文件，请运行 Hermes Dashboard，并在应用的 **管理** 页面登录一次。同一登录会话也会启用标准语音。
-
-### 4. 可选：安装 Relay
-
-仅在需要终端、手机控制、媒体路由、Relay 会话、实时语音、电脑工具或代理创建插件页面草稿时安装：
-
-```bash
-hermes plugins install Codename-11/hermes-relay/plugin --enable
-hermes relay doctor
-hermes relay start --no-ssl
-hermes pair
-```
-
-已安装的 Hermes 插件可通过已认证的 Dashboard 向 Android 提供由应用安全渲染的原生页面，无需在手机上运行插件代码。Relay 1.5.0 另支持需用户确认的代理创建页面草稿。
-
-完整说明请阅读[中文快速开始](https://hermes-relay.dev/docs/zh-CN/guide/quick-start)；远程访问、协议和高级配置暂时链接到英文参考文档。
-
-安装问题、早期想法、一般交流和作品分享请使用 [GitHub Discussions](https://github.com/Codename-11/hermes-relay/discussions)。可复现的错误和明确、可执行的功能请求请提交到 [Issues](https://github.com/Codename-11/hermes-relay/issues/new)。
-
-## 中文界面
-
-<table>
-  <tr>
-    <td align="center" width="33%"><img src="assets/screenshots/Zh01.jpg" alt="中文设置界面" width="100%"><br><sub><b>设置</b></sub></td>
-    <td align="center" width="33%"><img src="assets/screenshots/Zh02.jpg" alt="中文管理界面" width="100%"><br><sub><b>管理</b></sub></td>
-    <td align="center" width="33%"><img src="assets/screenshots/Zh03.jpg" alt="中文导航界面" width="100%"><br><sub><b>导航</b></sub></td>
-  </tr>
-</table>
-
-## 参与翻译
-
-Android 英文资源是规范来源。新增语言必须保持资源名称、类型和格式参数一致，并通过：
-
-```bash
-python scripts/check-android-locales.py
-./gradlew lint
-```
-
-翻译规范、目录命名、复数和占位符规则见 [docs/localization.md](docs/localization.md)。
-
-## 许可证
-
-[MIT](LICENSE) — Copyright (c) 2026 [Axiom-Labs](https://codename-11.dev)

docs/localization-status.json

@@ -18,7 +18,7 @@
       },
       "surfaces": {
         "android": "complete",
-        "readme": "english-fallback",
+        "readme": "maintained-summary",
         "user_docs": "core-pages",
         "website": "complete"
       },
@@ -53,7 +53,7 @@
       },
       "surfaces": {
         "android": "complete",
-        "readme": "english-fallback",
+        "readme": "maintained-summary",
         "user_docs": "core-pages",
         "website": "complete"
       },
@@ -77,7 +77,7 @@
       },
       "surfaces": {
         "android": "complete",
-        "readme": "english-fallback",
+        "readme": "maintained-summary",
         "user_docs": "core-pages",
         "website": "complete"
       },
@@ -101,7 +101,7 @@
       },
       "surfaces": {
         "android": "complete",
-        "readme": "english-fallback",
+        "readme": "maintained-summary",
         "user_docs": "core-pages",
         "website": "complete"
       },
@@ -125,7 +125,7 @@
       },
       "surfaces": {
         "android": "complete",
-        "readme": "english-fallback",
+        "readme": "maintained-summary",
         "user_docs": "english-fallback",
         "website": "english-fallback"
       }

docs/localization.md

@@ -78,21 +78,25 @@ structurally complete but semantically stale translation.
 9. Test the locale on an emulator or device, including in-app and Android-system
    language switching, process restart, text expansion, and
    accessibility.
-10. Add the language to the README language links and status registry. New
-   AI-assisted locales start as `ai-translated` with empty `review_refs`.
+10. Add a compact `docs/readme/README.<locale>.md` entrypoint, link it from the
+   root README language list, and update the status registry. New AI-assisted
+   locales start as `ai-translated` with empty `review_refs`.
 
 ## README and user documentation
 
-`README.md` remains canonical. Translations use separate files such as
-`README.zh-CN.md` and link back to English. Product documentation can be rolled
-out by locale under `user-docs/<locale>/`; untranslated technical references
-should link to the canonical English page rather than copying stale content.
+`README.md` remains canonical. Translated entrypoints live under
+`docs/readme/` as `README.<locale>.md` and link back to English. They are
+deliberately compact onboarding and core-feature summaries, not full copies of
+the fast-moving English README. Product documentation can be rolled out by
+locale under `user-docs/<locale>/`; untranslated technical references should
+link to the canonical English page rather than copying stale content.
 
 `docs/localization-status.json` is the authoritative per-locale and per-surface
 status. README and user-documentation translations may follow app translation;
 maintainer `docs/` and ADRs remain canonical English.
 
-The public documentation currently localizes a deliberately bounded first-run
+All shipped non-English Android locales have a compact translated README
+entrypoint. The public documentation localizes a deliberately bounded first-run
 set for German, Spanish, Japanese, Brazilian Portuguese, and Simplified Chinese.
 Russian currently falls back to the canonical English documentation:
 

docs/readme/README.de.md

@@ -0,0 +1,49 @@
+# Hermes-Relay
+
+**Läuft auf deinem Rechner. Ist auf deinen Geräten dabei.**
+
+[English](../../README.md) · **Deutsch** · [Español](README.es.md) · [日本語](README.ja.md) · [Português (Brasil)](README.pt-BR.md) · [Русский](README.ru.md) · [简体中文](README.zh-CN.md)
+
+> Englisch ist die verbindliche und vollständige Projektbeschreibung. Diese
+> KI-gestützte Übersetzung ist ein gepflegter, kompakter Einstieg.
+
+Hermes-Relay bringt deinen [Hermes Agent](https://github.com/NousResearch/hermes-agent)
+auf Android und verbundene Computer. Hermes läuft weiterhin auf deinem eigenen
+Rechner; Hermes-Relay stellt die nativen Oberflächen und optionalen Erweiterungen bereit.
+
+## Kernfunktionen
+
+- **Android:** Streaming-Chat, Sitzungen, eingehende Dateien, Manage, Voice und Petdex.
+- **Standardverbindung:** Chat, Manage, Sitzungen, Voice und Dateien nutzen direkt das unveränderte Hermes Dashboard/Gateway.
+- **Optionale Relay-Erweiterung:** Terminal/TUI, Benachrichtigungen, Desktop-Werkzeuge, erweiterte Voice, Relay-Sitzungen und Medienfunktionen.
+- **Sideload-Version:** ergänzt zustimmungspflichtige Device-Control-Funktionen wie Bildschirmlesen, Tippen und Navigation.
+- **CLI / UI:** verbindet Computer direkt mit Relay und stellt zustimmungspflichtige Datei-, Terminal-, Such- und Screenshot-Werkzeuge bereit.
+
+## Schnellstart für Android
+
+1. Installiere die App über [Google Play](https://play.google.com/store/apps/details?id=com.axiomlabs.hermesrelay) oder lade die signierte Sideload-APK aus den neuesten [`android-v*` Releases](https://github.com/Codename-11/hermes-relay/releases) herunter.
+2. Starte auf dem Hermes-Rechner die Standardoberfläche:
+
+   ```bash
+   hermes dashboard
+   ```
+
+3. Öffne in Android **Connect**, suche Hermes im LAN oder gib die Dashboard-Adresse ein und melde dich an. Für den Standardweg sind weder Relay noch ein separater API-Schlüssel erforderlich.
+4. Installiere Relay nur für die zusätzlichen Funktionen:
+
+   ```bash
+   hermes plugins install Codename-11/hermes-relay/plugin --enable
+   hermes relay doctor
+   hermes relay start --no-ssl
+   ```
+
+   Verwende `--no-ssl` nur in einem vertrauenswürdigen LAN oder VPN. Kopple danach über **Relay → Pair new device** im Dashboard.
+
+## Weitere Informationen
+
+[Deutscher Schnellstart](https://hermes-relay.dev/docs/de/guide/quick-start) ·
+[Installation](https://hermes-relay.dev/docs/de/guide/getting-started) ·
+[Fehlerbehebung](https://hermes-relay.dev/docs/de/guide/troubleshooting) ·
+[Vollständige englische Dokumentation](https://hermes-relay.dev/docs/)
+
+[MIT-Lizenz](../../LICENSE)

docs/readme/README.es.md

@@ -0,0 +1,49 @@
+# Hermes-Relay
+
+**Se ejecuta en tu equipo. Te acompaña en tus dispositivos.**
+
+[English](../../README.md) · [Deutsch](README.de.md) · **Español** · [日本語](README.ja.md) · [Português (Brasil)](README.pt-BR.md) · [Русский](README.ru.md) · [简体中文](README.zh-CN.md)
+
+> El inglés es la descripción canónica y completa del proyecto. Esta traducción
+> asistida por IA es una introducción breve y mantenida.
+
+Hermes-Relay lleva tu [Hermes Agent](https://github.com/NousResearch/hermes-agent)
+a Android y a equipos conectados. Hermes sigue ejecutándose en tu propia máquina;
+Hermes-Relay aporta interfaces nativas y extensiones opcionales.
+
+## Funciones principales
+
+- **Android:** chat en streaming, sesiones, archivos entrantes, Manage, voz y Petdex.
+- **Conexión estándar:** chat, Manage, sesiones, voz y archivos se conectan directamente al Dashboard/Gateway de Hermes sin modificar.
+- **Extensión Relay opcional:** Terminal/TUI, notificaciones, herramientas de escritorio, voz mejorada, sesiones Relay y funciones multimedia.
+- **Versión sideload:** añade Device Control con confirmación para leer la pantalla, tocar y navegar.
+- **CLI / UI:** conecta equipos directamente con Relay y ofrece herramientas de archivos, terminal, búsqueda y capturas sujetas a consentimiento.
+
+## Inicio rápido en Android
+
+1. Instala la aplicación desde [Google Play](https://play.google.com/store/apps/details?id=com.axiomlabs.hermesrelay) o descarga la APK sideload firmada desde la versión [`android-v*` más reciente](https://github.com/Codename-11/hermes-relay/releases).
+2. Inicia la superficie estándar en el equipo que ejecuta Hermes:
+
+   ```bash
+   hermes dashboard
+   ```
+
+3. En Android, abre **Connect**, busca Hermes en la red local o escribe la dirección del Dashboard e inicia sesión. La ruta estándar no necesita Relay ni una clave de API independiente.
+4. Instala Relay solo si quieres las funciones adicionales:
+
+   ```bash
+   hermes plugins install Codename-11/hermes-relay/plugin --enable
+   hermes relay doctor
+   hermes relay start --no-ssl
+   ```
+
+   Usa `--no-ssl` únicamente en una red local o VPN de confianza. Después, vincula el dispositivo desde **Relay → Pair new device** en el Dashboard.
+
+## Más información
+
+[Inicio rápido en español](https://hermes-relay.dev/docs/es/guide/quick-start) ·
+[Instalación](https://hermes-relay.dev/docs/es/guide/getting-started) ·
+[Solución de problemas](https://hermes-relay.dev/docs/es/guide/troubleshooting) ·
+[Documentación completa en inglés](https://hermes-relay.dev/docs/)
+
+[Licencia MIT](../../LICENSE)

docs/readme/README.ja.md

@@ -0,0 +1,49 @@
+# Hermes-Relay
+
+**自分のマシンで動作し、いつものデバイスから使えます。**
+
+[English](../../README.md) · [Deutsch](README.de.md) · [Español](README.es.md) · **日本語** · [Português (Brasil)](README.pt-BR.md) · [Русский](README.ru.md) · [简体中文](README.zh-CN.md)
+
+> 英語版が完全かつ正規のプロジェクト説明です。この AI 支援翻訳は、
+> 継続的に管理される簡潔な導入ページです。
+
+Hermes-Relay は、[Hermes Agent](https://github.com/NousResearch/hermes-agent)
+を Android と接続済みコンピューターから使えるようにします。Hermes 本体は
+自分のマシンで動作し続け、Hermes-Relay がネイティブ UI と任意の拡張機能を提供します。
+
+## 主な機能
+
+- **Android:** ストリーミング Chat、Sessions、受信ファイル、Manage、Voice、Petdex。
+- **標準接続:** Chat、Manage、Sessions、Voice、Files は、変更を加えていない Hermes Dashboard/Gateway に直接接続します。
+- **任意の Relay 拡張:** Terminal/TUI、通知、デスクトップツール、拡張 Voice、Relay Sessions、メディア機能。
+- **Sideload 版:** 画面読み取り、タップ、ナビゲーションなど、確認が必要な Device Control を追加します。
+- **CLI / UI:** コンピューターを Relay に直接接続し、同意制のファイル、ターミナル、検索、スクリーンショットツールを提供します。
+
+## Android クイックスタート
+
+1. [Google Play](https://play.google.com/store/apps/details?id=com.axiomlabs.hermesrelay) からインストールするか、最新の [`android-v*` リリース](https://github.com/Codename-11/hermes-relay/releases)から署名済み Sideload APK をダウンロードします。
+2. Hermes を実行しているマシンで標準の接続先を起動します。
+
+   ```bash
+   hermes dashboard
+   ```
+
+3. Android で **Connect** を開き、LAN 内の Hermes を検索するか Dashboard アドレスを入力してサインインします。標準経路では Relay も別の API キーも不要です。
+4. 追加機能が必要な場合だけ Relay をインストールします。
+
+   ```bash
+   hermes plugins install Codename-11/hermes-relay/plugin --enable
+   hermes relay doctor
+   hermes relay start --no-ssl
+   ```
+
+   `--no-ssl` は信頼できる LAN または VPN 内でのみ使用してください。その後、Dashboard の **Relay → Pair new device** からペアリングします。
+
+## 詳細
+
+[日本語クイックスタート](https://hermes-relay.dev/docs/ja/guide/quick-start) ·
+[インストール](https://hermes-relay.dev/docs/ja/guide/getting-started) ·
+[トラブルシューティング](https://hermes-relay.dev/docs/ja/guide/troubleshooting) ·
+[完全な英語ドキュメント](https://hermes-relay.dev/docs/)
+
+[MIT ライセンス](../../LICENSE)

docs/readme/README.pt-BR.md

@@ -0,0 +1,49 @@
+# Hermes-Relay
+
+**Roda na sua máquina. Acompanha você nos seus dispositivos.**
+
+[English](../../README.md) · [Deutsch](README.de.md) · [Español](README.es.md) · [日本語](README.ja.md) · **Português (Brasil)** · [Русский](README.ru.md) · [简体中文](README.zh-CN.md)
+
+> O inglês é a descrição canônica e completa do projeto. Esta tradução assistida
+> por IA é uma introdução compacta e mantida.
+
+O Hermes-Relay leva seu [Hermes Agent](https://github.com/NousResearch/hermes-agent)
+para o Android e computadores conectados. O Hermes continua rodando na sua própria
+máquina; o Hermes-Relay fornece interfaces nativas e extensões opcionais.
+
+## Recursos principais
+
+- **Android:** chat com streaming, sessões, arquivos recebidos, Manage, voz e Petdex.
+- **Conexão padrão:** chat, Manage, sessões, voz e arquivos se conectam diretamente ao Dashboard/Gateway do Hermes sem modificações.
+- **Extensão Relay opcional:** Terminal/TUI, notificações, ferramentas de desktop, voz aprimorada, sessões Relay e recursos de mídia.
+- **Versão sideload:** adiciona Device Control com confirmação para ler a tela, tocar e navegar.
+- **CLI / UI:** conecta computadores diretamente ao Relay e oferece ferramentas de arquivos, terminal, busca e captura de tela com consentimento.
+
+## Início rápido no Android
+
+1. Instale pelo [Google Play](https://play.google.com/store/apps/details?id=com.axiomlabs.hermesrelay) ou baixe o APK sideload assinado na versão [`android-v*` mais recente](https://github.com/Codename-11/hermes-relay/releases).
+2. Inicie a superfície padrão na máquina que executa o Hermes:
+
+   ```bash
+   hermes dashboard
+   ```
+
+3. No Android, abra **Connect**, procure o Hermes na rede local ou informe o endereço do Dashboard e entre. O caminho padrão não exige Relay nem uma chave de API separada.
+4. Instale o Relay apenas se quiser os recursos adicionais:
+
+   ```bash
+   hermes plugins install Codename-11/hermes-relay/plugin --enable
+   hermes relay doctor
+   hermes relay start --no-ssl
+   ```
+
+   Use `--no-ssl` somente em uma rede local ou VPN confiável. Depois, faça o pareamento em **Relay → Pair new device** no Dashboard.
+
+## Saiba mais
+
+[Início rápido em português](https://hermes-relay.dev/docs/pt-BR/guide/quick-start) ·
+[Instalação](https://hermes-relay.dev/docs/pt-BR/guide/getting-started) ·
+[Solução de problemas](https://hermes-relay.dev/docs/pt-BR/guide/troubleshooting) ·
+[Documentação completa em inglês](https://hermes-relay.dev/docs/)
+
+[Licença MIT](../../LICENSE)

docs/readme/README.ru.md

@@ -0,0 +1,52 @@
+# Hermes-Relay
+
+**Работает на вашем компьютере. Доступен с ваших устройств.**
+
+[English](../../README.md) · [Deutsch](README.de.md) · [Español](README.es.md) · [日本語](README.ja.md) · [Português (Brasil)](README.pt-BR.md) · **Русский** · [简体中文](README.zh-CN.md)
+
+> Английская версия — полное и каноническое описание проекта. Этот перевод,
+> выполненный с помощью ИИ, — краткое поддерживаемое введение.
+
+Hermes-Relay переносит ваш [Hermes Agent](https://github.com/NousResearch/hermes-agent)
+на Android и подключённые компьютеры. Сам Hermes продолжает работать на вашем
+компьютере, а Hermes-Relay предоставляет нативные интерфейсы и дополнительные расширения.
+
+## Основные возможности
+
+- **Android:** потоковый чат, сессии, входящие файлы, Manage, голосовой режим и Petdex.
+- **Стандартное подключение:** чат, Manage, сессии, голос и файлы подключаются напрямую к неизменённому Hermes Dashboard/Gateway.
+- **Необязательное расширение Relay:** Terminal/TUI, уведомления, инструменты рабочего стола, расширенный голосовой режим, сессии Relay и работа с медиа.
+- **Sideload-версия:** добавляет Device Control с подтверждением для чтения экрана, нажатий и навигации.
+- **CLI / UI:** подключает компьютеры напрямую к Relay и предоставляет требующие согласия инструменты для файлов, терминала, поиска и снимков экрана.
+
+## Быстрый старт на Android
+
+1. Установите приложение из [Google Play](https://play.google.com/store/apps/details?id=com.axiomlabs.hermesrelay) или загрузите подписанный sideload APK из последнего выпуска [`android-v*`](https://github.com/Codename-11/hermes-relay/releases).
+2. Запустите стандартную поверхность на компьютере с Hermes:
+
+   ```bash
+   hermes dashboard
+   ```
+
+3. На Android откройте **Connect**, найдите Hermes в локальной сети или введите адрес Dashboard и войдите в систему. Для стандартного пути не нужны Relay или отдельный API-ключ.
+4. Установите Relay, только если нужны дополнительные возможности:
+
+   ```bash
+   hermes plugins install Codename-11/hermes-relay/plugin --enable
+   hermes relay doctor
+   hermes relay start --no-ssl
+   ```
+
+   Используйте `--no-ssl` только в доверенной локальной сети или VPN. Затем выполните сопряжение через **Relay → Pair new device** в Dashboard.
+
+## Подробнее
+
+Русская пользовательская документация пока не локализована. Быстро меняющиеся
+сведения остаются каноническими на английском:
+
+[Быстрый старт на английском](https://hermes-relay.dev/docs/guide/quick-start) ·
+[Установка](https://hermes-relay.dev/docs/guide/getting-started) ·
+[Устранение неполадок](https://hermes-relay.dev/docs/guide/troubleshooting) ·
+[Полная документация](https://hermes-relay.dev/docs/)
+
+[Лицензия MIT](../../LICENSE)

docs/readme/README.zh-CN.md

@@ -0,0 +1,48 @@
+# Hermes-Relay
+
+**运行在您的电脑上，连接到您的设备。**
+
+[English](../../README.md) · [Deutsch](README.de.md) · [Español](README.es.md) · [日本語](README.ja.md) · [Português (Brasil)](README.pt-BR.md) · [Русский](README.ru.md) · **简体中文**
+
+> 英文版是完整、规范的项目说明。此 AI 辅助翻译是持续维护的精简入门页。
+
+Hermes-Relay 将您的 [Hermes Agent](https://github.com/NousResearch/hermes-agent)
+带到 Android 和已连接的电脑上。Hermes 仍在您自己的电脑上运行；
+Hermes-Relay 提供原生界面和可选扩展。
+
+## 核心功能
+
+- **Android：**流式聊天、会话、接收文件、Manage、语音和 Petdex。
+- **标准连接：**聊天、Manage、会话、语音和文件直接连接未修改的 Hermes Dashboard/Gateway。
+- **可选 Relay 扩展：**Terminal/TUI、通知、桌面工具、增强语音、Relay 会话和媒体功能。
+- **Sideload 版本：**增加需要确认的 Device Control，可读取屏幕、点击和导航。
+- **CLI / UI：**电脑直接连接 Relay，并提供需要授权的文件、终端、搜索和截图工具。
+
+## Android 快速开始
+
+1. 从 [Google Play](https://play.google.com/store/apps/details?id=com.axiomlabs.hermesrelay) 安装，或从最新 [`android-v*` 版本](https://github.com/Codename-11/hermes-relay/releases)下载已签名的 Sideload APK。
+2. 在运行 Hermes 的电脑上启动标准连接界面：
+
+   ```bash
+   hermes dashboard
+   ```
+
+3. 在 Android 中打开 **Connect**，在局域网中查找 Hermes，或输入 Dashboard 地址并登录。标准路径不需要 Relay，也不需要单独的 API 密钥。
+4. 仅在需要附加功能时安装 Relay：
+
+   ```bash
+   hermes plugins install Codename-11/hermes-relay/plugin --enable
+   hermes relay doctor
+   hermes relay start --no-ssl
+   ```
+
+   `--no-ssl` 仅限可信局域网或 VPN。然后在 Dashboard 中通过 **Relay → Pair new device** 配对。
+
+## 了解更多
+
+[中文快速开始](https://hermes-relay.dev/docs/zh-CN/guide/quick-start) ·
+[安装与设置](https://hermes-relay.dev/docs/zh-CN/guide/getting-started) ·
+[故障排除](https://hermes-relay.dev/docs/zh-CN/guide/troubleshooting) ·
+[完整英文文档](https://hermes-relay.dev/docs/)
+
+[MIT 许可证](../../LICENSE)