用途：在 shell 中运行或设计 vivadicta 命令，用于查询 Mac 上 VivaDicta 的转录历史，以及发起转写与 AI 改写等写入操作。
前置条件：VivaDicta.app 安装于 /Applications/VivaDicta.app；vivadicta 在 $PATH 中（brew install n0an/tap/vivadicta）；仅写入命令需要 UI 应用运行，读取命令可独立工作。可用 vivadicta --help 及各子命令 --help 查看权威用法。
子命令：只读命令 recent [N]（默认 10，上限 50）、search（支持 --since、--from/--to、--tag、--source、--mode、--limit、--full）、get（接受 UUID、latest 等关键词或自然语言查询）、presets、tags、modes、vocab、replacements；写入命令 rewrite（需 --preset，支持 --dry-run）、transcribe（文件或 YouTube 链接，--async 返回 job UUID）、job（查询异步任务状态）。modes 在 v1 只读。
全局标志与输出：--output text|table|json|markdown（markdown 仅 get 支持）、--pretty、--quiet、--verbose、--help、--version。输出格式优先级为显式 --output、VIVADICTA_OUTPUT 环境变量、stdout TTY 检测（TTY 为 text，管道为 json），可用 VIVADICTA_FORCE_TTY 或 VIVADICTA_FORCE_NON_TTY 覆盖。其他环境变量含 VIVADICTA_TIMEOUT_SECONDS、NO_COLOR。
退出码：0 成功，1 内部失败，2 参数无效，3 预设未找到或歧义，4 转录未找到或歧义，5 应用未运行，6 达到每日限额，10 存储不可用，64 用法错误。错误输出到 stderr，JSON 模式下返回结构化错误载荷。
限制：v1 不支持从 CLI 创建或编辑预设、标签、模式、词汇和替换规则，需在 UI 应用中操作；写入前应确认应用运行，否则以退出码 5 失败且不应重试；刚在 UI 端编辑后读取可能有几秒 CloudKit 同步延迟。