docs(core): 完善睡眠与主动思考模块的文档注释

为 `ProactiveThinker`, `SleepManager`, 和 `SleepState` 核心类及其方法添加了详尽的中文文档字符串和内联注释。

本次更新旨在提高代码的可读性和可维护性,详细解释了以下关键组件的职责和工作流程:
- **ProactiveThinker**: 阐明了其作为主动事件处理中心的角色,以及如何与规划器和生成器协作。
- **SleepManager**: 详细描述了其作为睡眠状态机的核心逻辑,包括状态转换的条件和处理流程。
- **SleepState**: 解释了各个睡眠状态的含义以及序列化器的作用,确保状态持久化。

此外,对配置文件 `bot_config_template.toml` 中的相关配置项也补充了更清晰的注释。
This commit is contained in:
minecraft1024a
2025-09-06 13:44:38 +08:00
committed by Windpicker-owo
parent 48b7e0be37
commit 42e0bb3b96
4 changed files with 149 additions and 41 deletions

View File

@@ -456,8 +456,6 @@ insomnia_chance_normal_pressure = 0.1
sleep_pressure_increment = 1.5
# 睡眠时,每分钟衰减的睡眠压力值
sleep_pressure_decay_rate = 1.5
insomnia_trigger_delay_minutes = [30, 60] # 入睡后触发失眠判定的延迟时间范围(分钟)
insomnia_duration_minutes = [15, 45] # 单次失眠状态的持续时间范围(分钟)
# --- 弹性睡眠与睡前消息 ---
# 是否启用弹性睡眠。启用后AI不会到点立刻入睡而是会根据睡眠压力增加5-10分钟的缓冲并可能因为压力不足而推迟睡眠。
@@ -473,6 +471,11 @@ enable_pre_sleep_notification = false
pre_sleep_notification_groups = []
# 用于生成睡前消息的提示。AI会根据这个提示生成一句晚安问候。
pre_sleep_prompt = "我准备睡觉了,请生成一句简短自然的晚安问候。"
insomnia_duration_minutes = [30, 60] # 单次失眠状态的持续时间范围(分钟)
# --- 睡后失眠 ---
# 入睡后,经过一段延迟后触发失眠判定的延迟时间(分钟),设置为范围以增加随机性
insomnia_trigger_delay_minutes = [15, 45]
[cross_context] # 跨群聊/私聊上下文共享配置
# 这是总开关,用于一键启用或禁用此功能