全局发送与监视配置

本页是所有配置项的完整参考。所有配置均可在「全局设置」页面的 UI 控件中调整，无需手动编辑文件。

---

全局系统设置 (GlobalConfig)

跨发送器 / 监视器共享，只此一份。

配置项	类型	默认值	UI 控件	说明
prevent_sleep	bool	true	QCheckBox	任务运行时阻止系统休眠
use_system_proxy	bool	true	QCheckBox	是否使用系统代理

---

发送配置 (SenderConfig)

发送相关配置收在一个模型下，分运行模式、单任务节奏与整队规则三部分，分别位于 mode、pacing、queue。

单任务发送节奏 (pacing)

描述单个任务里弹幕怎么发。入队时会派生成不可变的工单参数快照，因此修改这些设置只对新建的任务生效，已入队任务保持入队那一刻的节奏。

配置项	类型	默认值	UI 控件	说明
min_delay	float	9.5	QDoubleSpinBox	两条弹幕之间的最小随机间隔（秒）
max_delay	float	10.5	QDoubleSpinBox	两条弹幕之间的最大随机间隔（秒）
burst_enabled	bool	true	QCheckBox	是否启用突发模式
burst_size	int	5	QSpinBox	突发模式下每轮连发条数
rest_min	float	30.0	QDoubleSpinBox	突发模式休息期最小时间（秒）
rest_max	float	35.0	QDoubleSpinBox	突发模式休息期最大时间（秒）

整队规则 (queue)

描述整个任务队列怎么跑。启动队列时取一次快照，运行期间修改这些设置不影响正在跑的队列（下次运行生效）。

配置项	类型	默认值	UI 控件	说明
delay_between_tasks	float	30	QDoubleSpinBox	两个任务之间的等待时间（秒）
allow_duplicates	bool	false	QCheckBox	允许重复发送（危险区，见下）

运行模式 (mode)

配置项	类型	默认值	UI 控件	说明
mode	SendMode	send_and_monitor	QComboBox	整轮运行做什么：仅发送，还是发送并监视

详细说明见 频率控制与并发策略 和 断点续传与智能去重。

在 config.json 中三者同属 sender 段：

{
  "sender": {
    "mode": "send_and_monitor",
    "pacing": {
      "min_delay": 9.5,
      "max_delay": 10.5,
      "burst_enabled": true,
      "burst_size": 5,
      "rest_min": 30.0,
      "rest_max": 35.0
    },
    "queue": {
      "delay_between_tasks": 30.0,
      "allow_duplicates": false
    }
  }
}

危险区：允许重复发送

该项位于设置页的「危险区」，默认关闭。启用后发送前不再比对数据库，已发送的弹幕会被再次发送到同一视频，视频中会出现重复弹幕。仅在确需重复发送同一批弹幕时启用，用毕请关闭。

旧配置不做迁移

旧版 sender 段的平铺字段与 send_policy 段一律不迁移，整块回退为默认值。默认节奏即长期实测稳定值（9.5 / 10.5 秒、突发每轮 5 条、休息 30~35 秒），回退落在安全一侧；需要保留的取值在设置页改回即可。更早版本的 skip_sent 已废弃移除，写入配置将被忽略；其默认行为（跳过已发送弹幕）等同于 allow_duplicates 关闭时的行为。

---

监视器配置 (MonitorConfig)

配置项	类型	默认值	UI 控件	说明
refresh_interval	int	60	QSpinBox	轮询 B 站弹幕池的间隔（秒），最小 10

监视页上的「统计基线」是本次会话的运行时状态，不属于持久化配置，不在本表内。详见 实时存活率仪表盘。

详细说明见 实时存活率仪表盘。

---

弹幕校验配置 (ValidationConfig)

配置项	类型	默认值	UI 控件	说明
enabled	bool	true	QCheckBox	是否启用自定义关键词过滤
blocked_keywords	list[str]	[]	QLineEdit	自定义屏蔽关键词列表（逗号分隔）

配置位置

校验配置的 UI 控件位于「弹幕编辑器」弹窗内的「校验与过滤规则」区域，而非全局设置页面。详见 校验规则与异常标红。

---

配置持久化

控件写回后 800 毫秒自动保存；窗口关闭时再兜底保存一次。文件位于：

%LOCALAPPDATA%/Miku_oso/BiliDanmakuSender/config.json

保存机制：

• 使用 Pydantic 模型校验，确保写入的值合法。
• 使用 atomic_write（先写临时文件再重命名），避免写入中断导致文件损坏。
• 加载时如果某个配置段校验失败，自动回退到默认值，不影响其他配置段。