ljsysfurryACE/dsh-aura-scheduler

插件Plugin 原生Native ⭐ 3 自动化Automation

DeepSeek Harness 的主动调度:Aura 心跳 + 价值网络(官方仅模型驱动)

项目介绍Project Overview

dsh-aura-scheduler 是 DeepSeek Harness 的主动调度插件,由系统心跳驱动让 Agent 在适当时机开口。核心能力包括自适应频率(空闲越久越急切)、价值网络打分(V=α·u+β·r−δ·i)、静默时段和反骚扰冷却;v2 新增文件/进程/HTTP/端口传感器触发、HMAC Webhook 唤醒及低谷时段省钱模式。适用于需要 Agent 主动巡检、响应外部事件或避开 API 高峰调用的场景。注意:offPeakOnly 设为 true 后非低谷时段将完全沉默,部署前需确认业务容忍度。

dsh-aura-scheduler is a system-driven proactive scheduling plugin for DeepSeek Harness that lets agents speak at the right moment. Core features include a heart-beat scheduler with adaptive frequency, a value-network scoring model (V=α·u+β·r−δ·i), quiet hours, and anti-spam cooldown. Version 2 adds file/process/HTTP/port sensor triggers, HMAC-signed webhook wake-ups, and off-peak cost-saving mode. Use it when an agent must patrol, react to external signals, or avoid peak API pricing. Caveat: enabling offPeakOnly silences the agent outside the configured low-cost window, so verify business tolerance before deployment.

或使用命令行安装(适合开发者)Or use CLI install (for developers)

命令行安装CLI Install

dsh plugin --profile web add github:ljsysfurryACE/dsh-aura-scheduler

ljsysfurryACE/dsh-aura-scheduler 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

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

上一个 Prev dsh-git-worktree 下一个 Next dsh-tui-pro