diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index c04c6a7b..5530a5b6 100644 --- a/CONTRIBUTING.md +++ b/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..md` files; `README.md` remains -the canonical project description. User docs may be added incrementally under -`user-docs//`, with links back to canonical English reference material. +Translated README entrypoints live under `docs/readme/` as +`README..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//`, with links back to +canonical English reference material. ## Changelog & writing conventions diff --git a/README.md b/README.md index 233dcb8c..67526cfb 100644 --- a/README.md +++ b/README.md @@ -21,7 +21,13 @@

- English · 简体中文
+ English · + Deutsch · + Español · + 日本語 · + Português (Brasil) · + Русский · + 简体中文
Documentation · Releases · Discussions · diff --git a/README.zh-CN.md b/README.zh-CN.md deleted file mode 100644 index ae797bf3..00000000 --- a/README.zh-CN.md +++ /dev/null @@ -1,109 +0,0 @@ -

- Hermes-Relay — 随身携带您的 Hermes 代理 -

- -

- 运行在您的电脑上，连接到您的设备。
- Hermes-Relay 是 Hermes Agent 的原生 Android 客户端，提供流式聊天、免手动语音和代理管理；另有单文件 CLI，让代理在已配对的电脑上安全使用终端、文件和截图工具。 -

- -

- 简体中文 · English
- 中文文档 · - 版本下载 · - 社区讨论 · - 更新日志 -

- -> 英文 [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 <: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)。 - -## 中文界面 - - - - - - - -
中文设置界面
设置		中文管理界面
管理		中文导航界面
导航
- -## 参与翻译 - -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) diff --git a/docs/localization-status.json b/docs/localization-status.json index bce7818b..e058af0e 100644 --- a/docs/localization-status.json +++ b/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" } diff --git a/docs/localization.md b/docs/localization.md index 8a805fbf..237ea694 100644 --- a/docs/localization.md +++ b/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..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//`; 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..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//`; 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: diff --git a/docs/readme/README.de.md b/docs/readme/README.de.md new file mode 100644 index 00000000..861b07f1 --- /dev/null +++ b/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) diff --git a/docs/readme/README.es.md b/docs/readme/README.es.md new file mode 100644 index 00000000..556fe7de --- /dev/null +++ b/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) diff --git a/docs/readme/README.ja.md b/docs/readme/README.ja.md new file mode 100644 index 00000000..eb587604 --- /dev/null +++ b/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) diff --git a/docs/readme/README.pt-BR.md b/docs/readme/README.pt-BR.md new file mode 100644 index 00000000..b0b97a56 --- /dev/null +++ b/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) diff --git a/docs/readme/README.ru.md b/docs/readme/README.ru.md new file mode 100644 index 00000000..3aebc06b --- /dev/null +++ b/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) diff --git a/docs/readme/README.zh-CN.md b/docs/readme/README.zh-CN.md new file mode 100644 index 00000000..b16ee942 --- /dev/null +++ b/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)