docs+feat: USAGE.md + interesting_fact + mailto packs

USAGE.md (new, ~250 lines)
  - Complete voice command reference organised by 13 categories
  - Table-formatted for fast skim ("Команда → Что делает")
  - Sections: Управление ассистентом / LLM / Память+профили+macros /
    Расписание / Окна+апп / Аудио+медиа / Система / Файлы+буфер /
    Информация из интернета / Утилиты-калькуляторы / Разработка /
    Развлечения / Скриншоты
  - Bottom: "Как добавить свою команду" with Lua snippet template,
    "Голосовое vs GUI" mapping, troubleshooting checklist (mic / TTS /
    LLM / command-not-found / logs).
  - Covers all 67 packs visible in resources/commands/.

interesting_fact pack (resources/commands/interesting_fact/, 2 cmds)
  - fact.about         "удиви меня" / "интересный факт про космос"
                       → LLM with "curious conversationalist" prompt,
                       generic or topic-targeted (1-2 sentences, no fluff).
  - fact.history_today "что было в этот день" / "этот день в истории"
                       → Wikipedia "On this day" API (RU first, EN fallback)
                       → LLM picks top 2-3 events, narrates concisely.

mailto pack (resources/commands/mailto/, 1 cmd)
  - mailto.compose     "напиши письмо" / "напиши письмо маме"
                       → opens default mail client via mailto: URI.
                       Looks up recipient via jarvis.memory ("email_маме")
                       if a name is given.
  - Pairs well with: jarvis.memory.remember("email_маме", "mom@example.com")

Pack count: 67 → 70. Tests: 112/112.
This commit is contained in:
Bossiara13 2026-05-15 23:38:03 +03:00
parent d3180b7d78
commit 4f83062815
6 changed files with 430 additions and 0 deletions

View file

@ -0,0 +1,38 @@
# Interesting fact about X via LLM.
[[commands]]
id = "fact.about"
type = "lua"
script = "fact.lua"
sandbox = "full"
timeout = 15000
[commands.phrases]
ru = [
"расскажи интересный факт",
"интересный факт о",
"интересный факт про",
"удиви меня",
"интересный факт",
"расскажи факт",
]
en = ["tell me an interesting fact", "fun fact about", "surprise me"]
ua = ["цікавий факт"]
[[commands]]
id = "fact.history_today"
type = "lua"
script = "history_today.lua"
sandbox = "full"
timeout = 15000
[commands.phrases]
ru = [
"что было в этот день",
"что произошло в этот день",
"этот день в истории",
"что случилось",
]
en = ["this day in history", "what happened today"]
ua = ["що сталося в цей день"]