kaneda
7428d42b92
- src/markdown.{h,cpp}: convertitore minimale, due funzioni:
* toRichText() -> HTML per QML Text.RichText: grassetti (**x**/__x__),
corsivi (*x*/_x_ con confini di parola per non toccare snake_case),
titoli (#), liste (-/1.), citazioni (>), codice (`x` e blocchi ```,
in monospace), link [t](u) -> solo testo, barrato ~~x~~; escape di
< & > contro injection nel rich text
* toSpeech() -> testo piatto per il TTS: via recinti di codice, marcatori
di titoli/liste/citazioni, enfasi, backtick; link/immagini -> testo;
tabelle | a | b | -> "a, b"; righe vuote compattate
- ChatModel: nuovo ruolo contentRich (calcolato in C++, testabile);
incluso nei dataChanged dello streaming
- ChatPage: le bolle dell'assistente usano contentRich con
textFormat: Text.RichText; i messaggi utente restano testo semplice
- ApiClient::speak(): il testo passa da Markdown::toSpeech (niente più
simboli di formattazione letti ad alta voce)
- core-test: 19 casi nuovi per il convertitore (tutti locali, senza device)
Verificato: build zero warning + unit test completi.
84 lines
3.7 KiB
Markdown
84 lines
3.7 KiB
Markdown
# harbour-hermes
|
|
|
|
Native **Sailfish OS** client for the **Hermes Web UI** (`hermes-webui`):
|
|
chat with your Hermes agent from the phone — and use it with your **voice**.
|
|
|
|
## Features
|
|
|
|
- Sign in to your Hermes Web UI (session cookie persisted; password never stored)
|
|
- Sessions list, new session, open any session
|
|
- Chat with **live streaming** replies (SSE token deltas)
|
|
- **Voice dictation**: tap Mic, speak, tap Stop → server-side Whisper
|
|
transcription lands in the composer (optionally sent right away)
|
|
- **Read aloud**: server-side TTS (voice/engine configurable) played through
|
|
QMediaPlayer; optional auto-read of every completed reply
|
|
- **Voice dialog (hands-free)**: continuous listen → transcribe → send →
|
|
read-aloud loop, auto-stopping on speech pauses (tunable)
|
|
- **Localized UI**: English (source), Italian, French and German — follows
|
|
the system language
|
|
- **Profile selection**: pick which server profile's sessions to show
|
|
(Settings → Sessions; per-client via the WebUI signed cookie)
|
|
- Cancel a running turn, resync from server state, cover page
|
|
|
|
## Requirements
|
|
|
|
- Sailfish OS 4.4+ (developed against Sailfish 5.1)
|
|
- A running `hermes-webui` instance reachable over HTTPS (the address is
|
|
configured in the app — nothing is compiled in)
|
|
- Sailjail permissions `Internet;Audio;Microphone` (declared in the .desktop)
|
|
|
|
## Configuration
|
|
|
|
No configuration is compiled into the binary: everything lives in the app's
|
|
Settings (persisted in `~/.config/harbour/hermes.conf`, sandbox-persistent).
|
|
Defaults are neutral — empty means "the server decides" — and the login screen
|
|
requires a server address.
|
|
|
|
| Setting | Meaning |
|
|
|---|---|
|
|
| Server | Hermes Web UI address, e.g. `https://hermes.example.com` (required) |
|
|
| Profile | server profile whose sessions are shown (empty = server's active) |
|
|
| Read-aloud voice / TTS engine | empty = server defaults |
|
|
| Voice/engine presets | comma-separated lists used to fill the pickers |
|
|
| Read replies aloud | auto-play every reply (off by default) |
|
|
| Send right after dictation | auto-send when dictation lands (on by default) |
|
|
| Auto-stop pause / Mic sensitivity | voice-dialog tuning (1.5 s / medium) |
|
|
| Max recording time | voice-dialog safety cap (60 s) |
|
|
|
|
> **Read-aloud voices depend on your server.** The selected voice is sent to
|
|
> `hermes-webui`'s `/api/tts`, which only accepts voices present in its Edge
|
|
> TTS allowlist (`api/routes.py`; upstream ships Chinese, English, French and
|
|
> Indonesian voices). If your server rejects a voice (`400 invalid voice`),
|
|
> pick another one, leave the voice empty (server default), or add your
|
|
> language's voices to your own `hermes-webui`.
|
|
|
|
## Localization
|
|
|
|
The UI follows the system language: English is the source language, and
|
|
Italian, French and German translations live in `translations/*.ts`. At build
|
|
time (`sailfishapp_i18n`) the `.qm` files are generated and installed to
|
|
`/usr/share/harbour-hermes/translations`, where the app loads them on startup.
|
|
After changing UI strings:
|
|
|
|
```bash
|
|
lupdate -no-obsolete -recursive src qml \
|
|
-ts translations/harbour-hermes-it.ts \
|
|
translations/harbour-hermes-fr.ts \
|
|
translations/harbour-hermes-de.ts
|
|
# then edit the .ts files and rebuild
|
|
```
|
|
|
|
## Build
|
|
|
|
See [docs/BUILD.md](docs/BUILD.md) (Sailfish SDK, `sfdk build` / `sfdk deploy`)
|
|
and [docs/PROTOCOL.md](docs/PROTOCOL.md) for the HTTP/SSE protocol the app
|
|
speaks (validated live against a real instance).
|
|
|
|
## Status
|
|
|
|
Version 0.5.2 — protocol and C++ core validated against a real `hermes-webui`
|
|
(login, sessions, streaming chat, TTS, STT, voice dialog, profile selection);
|
|
UI in English, Italian, French and German; replies rendered as formatted
|
|
markdown and cleaned before read-aloud; every request has a watchdog
|
|
timeout; on-device testing still ongoing.
|