dsh-aura-scheduler
Aura 主动调度插件 —— 让 DeepSeek Harness 的 Agent "知道什么时候该开口"。
官方 dsh-schedule 是模型驱动的：模型调用 schedule_create 创建提醒。
Aura 是系统驱动的：系统主动决定何时让 Agent 主动出击。
差异化
| 能力 | 官方 dsh-schedule | dsh-aura-scheduler |
|---|
| 创建提醒 | ✓ 模型主动调用 | ✓ (可配合) |
| 系统主动出击 | × | ✓ Aura 心跳 |
| 自适应频率 | × | ✓ 空闲越久越急切 |
| 价值网络 | × | ✓ V = α·u + β·r − δ·i |
| 静默时段 | × | ✓ 23:00-8:00 不打扰 |
| 反骚扰冷却 | × | ✓ |
| 传感器触发 (v2) | × | ✓ 文件/进程/HTTP/端口 监听 |
| Webhook 触发 (v2) | × | ✓ HMAC 验证 + 限流 |
| Off-peak 省钱 (v2) | × | ✓ 低谷时段才开口 |
接入
- id: aura-scheduler
name: '@agentframe/dsh-aura-scheduler'
config:
minInterval: 1800 # 30 min
maxInterval: 7200 # 2 hours
quietHours: [23, 8] # 夜间静默
alpha: 0.4 # 急切度权重
beta: 0.4 # 相关性权重
relevance: 0.5
delta: 0.2 # 打扰惩罚
cooldown: 600 # 反骚扰冷却 10min
onProactive: notify # 主动事件回调
auto: true
# ---- v2 新增 ----
offPeakHours: [2, 7] # 低谷时段 (省钱模式窗口)
offPeakOnly: false # true = 只在低谷时段开口
sensors: # 传感器 (文件/进程/HTTP/端口 状态翻转触发)
- kind: file
target: /tmp/aura-signal
intervalSeconds: 30
webhookSecret: '' # webhook HMAC 密钥 (留空自动生成)
v2 新能力（吸收生态竞品）
1. 传感器触发（学 dsh-sentinel）
监听文件/进程/HTTP/端口，状态变化（不存在→出现、无匹配→匹配）时触发主动开口：
sensors: [
{ kind: 'file', target: '/tmp/important.txt', pattern: 'done', intervalSeconds: 30 },
{ kind: 'process', target: 'my-server', intervalSeconds: 60 },
{ kind: 'http', target: 'https://api.example.com/health', pattern: '"ok"', intervalSeconds: 300 },
{ kind: 'port', target: '127.0.0.1:8080', intervalSeconds: 60 },
]
2. Webhook 触发（学 EngramPulse）
外部系统 POST 唤醒 Agent，HMAC-SHA256 签名验证 + 每分钟限流：
const url = await ctx.aura.addWebhook('deploy-finished', '检查部署结果并汇报')
// POST {url} 带 X-Aura-Signature 头 (HMAC)
3. Off-peak 省钱模式（学 dsh-automations）
offPeakOnly: true 时只在低谷时段（默认 2:00-7:00）主动开口，避开高峰价。
机制
每分钟心跳
→ 计算价值 V = α·(空闲率) + β·relevance − δ·interruption
→ 静默时段? 跳过
→ 冷却中? 跳过
→ V > 阈值 或 超过最大间隔? → 触发主动事件
→ onProactive 回调 (emit 事件 或 webhook POST)
验证（smoke test 12/12 全绿）
✅ file 传感器: 文件出现 → 触发 (状态翻转 absent→match)
✅ file 传感器: 无变化 → 不触发
✅ webhook: 注册返回路由 /aura-webhook/<name>?token=...
✅ webhook: 正确签名 → 200 + handler 收到
✅ webhook: 错误签名 → 401 (HMAC 防护)
✅ webhook: 未知路由 → 404
✅ service: 构造正常
✅ service: offPeak 模式就绪
✅ service: force tick 绕过 off-peak
✅ service: addWebhook 返回路由
✅ service: webhook → proactive 触发 (proactiveCount=1)
License
GPL-3.0 © Cloud LTE Studio / AgentFrame
