ljsysfurryACE / dsh-aura-scheduler

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