SOBAAgent Docs

声音通知

SOBA 声音通知:CLI 标志、环境变量、config.json,以及不同平台上的行为。

SOBA 可以在重要事件发生时播放声音:任务完成、出现错误,或者危险操作需要确认。


1. CLI 标志

标志作用
--sound-enabled为本次运行启用声音
--no-sound为本次运行关闭声音
--sound-volume <0..1>音量
--sound-repeat重复播放声音,直到下一个事件或状态变化

示例:

soba -i --sound-enabled --sound-volume 0.5

2. 配置

~/.soba/config.json 中的 sound 块:

{
  "sound": {
    "enabled": true,
    "volume": 0.7,
    "repeatMode": "once",
    "repeatIntervalMs": 3000
  }
}
取值
enabledtruefalse
volume0.01.0 之间的数字
repeatMode"once""repeat"
repeatIntervalMs重复间隔,单位是毫秒

3. 环境变量

export SOBA_SOUND_ENABLED=true
export SOBA_SOUND_VOLUME=0.7
export SOBA_SOUND_REPEAT=once

优先级是常规顺序:

CLI flags > env > config.json > defaults

4. 实际使用

对于耗时较长的任务:

soba -i --sound-enabled --sound-repeat

对于 CI、录屏或安静模式:

soba -i --no-sound

如果没有播放声音,请检查系统播放器和操作系统音量。SOBA 不应该因为音频不可用而阻塞任务执行。

下一步

本頁目錄