配置

默认值即可用。自定义：在 $DSH_HOME/proactive/config.json：

{
  "enabled": true,
  "maxDeliveriesPerDay": 3,                    // 每 UTC 日可见聊天文本投递上限（no_reply 不计）
  "quietHours": { "start": "23:00", "end": "08:00", "timeZone": "Asia/Shanghai" },
  "maxWakeupsPerHour": 4,                      // 全 host 每小时唤醒次数上限
  "maxConcurrentPerSession": 1,                // 每会话并发在途唤醒数
  "bootOverduePolicy": "fire",                 // fire | notify-only | drop
  "maxRetriesPerFire": 3,                      // 单次唤醒的 busy/failed 重试上限
  "maxPromptLength": 4000,
  "defaultPrompt": "这是一个 heartbeat reminder，…" // 新建闹钟表单的预填文案（纯预填，闹钟各自保存 prompt）
}

环境变量覆盖：DSH_PROACTIVE_ENABLED、DSH_PROACTIVE_MAX_DELIVERIES_PER_DAY、DSH_PROACTIVE_DATA_DIR。

配置的双入口语义

同一份配置有两个编辑面，写入层不同：

入口	写入层	生效方式
`proactive_update_settings` 工具	`config.json`（原子写，持久）	写入后立即热应用到运行中调度器；重启后仍生效
设置面板（Proactive 页签）	settings 服务层（base=启动时 config.json 快照）	热应用立即生效；重启后由 settings 层持久值胜出

若两者交替编辑：工具改动会实时反映在运行中的调度器与 config.json，但面板会话内可能显示旧值；面板随后保存任一字段会把其 base 合成值整表回写，覆盖工具改动（重启后以 settings 层最终值为准）。日常使用模型自主更新走工具即可；需要面板所见一致时，改完工具设置后刷新面板或重启。数值上限：工具严格遵循 resolveConfig 钳制（如并发 ≤4、重试 ≤10），面板 schema 更宽——工具接受的值不会被下次启动静默截断。

dsh-proactive

같은 패키지 이름의 다른 저장소

설치

문서

配置

配置的双入口语义