49 lines
1.9 KiB
Markdown
49 lines
1.9 KiB
Markdown
|
# talk
|
||
|
|
|
||
|
|
> **Status: WIP** — aktive Entwicklung (talk 2.0). Binde Spezifikation:
|
||
|
|
> [`.scratch/talk-2-0/spec.md`](.scratch/talk-2-0/spec.md) ·
|
||
|
|
> Implementierungsplan: [`.scratch/talk-2-0/plan.md`](.scratch/talk-2-0/plan.md)
|
||
|
|
|
||
|
|
**talk** macht Skripte und KI-Agenten hörbar: Ein Aufruf — `talk "Build fertig"` —
|
||
|
|
spricht eine kurze Nachricht über eine TTS-Provider-Kette
|
||
|
|
(ElevenLabs → OpenAI → Edge-TTS → OS-Stimme), serialisiert durch den Daemon
|
||
|
|
`talkd`. Cross-platform (Windows/macOS/Linux, amd64/arm64), statische Binaries,
|
||
|
|
keine Runtime-Abhängigkeiten.
|
||
|
|
|
||
|
|
## Befehle
|
||
|
|
|
||
|
|
| Befehl | Zweck |
|
||
|
|
| --- | --- |
|
||
|
|
| `talk "Text"` | Ansage — Abkürzung für `talk say`, non-blocking |
|
||
|
|
| `talk say "Text"` | Ansage (Text als Argument oder von stdin) |
|
||
|
|
| `talk wrap -- <Befehl>` | Befehl ausführen, Erfolg/Misserfolg + Dauer ansagen |
|
||
|
|
| `talk mute` / `talk unmute` | Ansagen dauerhaft stummschalten / Stummschaltung aufheben |
|
||
|
|
| `talk status` | Daemon-Status (Queue, Mute, Provider, Version) |
|
||
|
|
| `talk cancel` | laufende und geplante Ansagen abbrechen |
|
||
|
|
| `talk voices` | verfügbare Stimmen anzeigen |
|
||
|
|
| `talk test` | Test-Ansage ausgeben |
|
||
|
|
| `talk doctor` | Selbstdiagnose des Setups |
|
||
|
|
| `talk setup` | geführte Ersteinrichtung (Wizard) |
|
||
|
|
|
||
|
|
Say-Flags (gelten auch für `talk "Text"`): `--wait`, `--now`, `--priority`,
|
||
|
|
`--voice`, `--lang`, `--provider`.
|
||
|
|
|
||
|
|
**Hinweis:** Alle Befehle sind in diesem Stand Stubs und melden
|
||
|
|
`not implemented yet` (Exit-Code ≠ 0). Die Implementierung entsteht
|
||
|
|
Aufgabenweise gemäß Plan; `--version` und `--help` funktionieren.
|
||
|
|
|
||
|
|
## Entwicklung
|
||
|
|
|
||
|
|
```console
|
||
|
|
go build ./... # bauen
|
||
|
|
go test ./... # Tests
|
||
|
|
go vet ./... # statische Analyse
|
||
|
|
gofmt -l . # Formatierung prüfen (leerer Output = ok)
|
||
|
|
```
|
||
|
|
|
||
|
|
CI: `.gitea/workflows/test.yml` (Gitea Actions) läuft vet, gofmt-Check, Tests
|
||
|
|
und Build bei jedem Push und Pull Request.
|
||
|
|
|
||
|
|
## Lizenz
|
||
|
|
|
||
|
|
MIT — siehe [LICENSE](LICENSE).
|