dsh-health-scheduler

前言¶

DeepSeek Harness (DSH) 的插件化架构让系统扩展变得灵活，但在设备健康监控、重启压力评估以及维护调度这些运维层面，往往需要专门的逻辑。dsh-health-scheduler 插件就是为了解决这些问题而生，它负责将观测数据转化为可执行的动作决策。

是什么¶

这是一个 DeepSeek Harness 的工作流插件。它提供设备/运行时健康监控、重启压力评分、维护调度和动作决策。该插件由用户 zhiheng-zhang-Mera 维护，采用 MIT 许可证。

核心功能¶

该插件专注于状态感知与决策，核心能力包括：

• 设备/运行时健康监控：收集并分析设备的运行状态与健康指标。
• 重启压力评分：将可观测的指标归一化为 0 到 100 之间的 restart_pressure 数值。
• 维护调度：根据策略安排维护窗口。
• 动作决策：基于压力评分决定下一步操作。
• 减少负载：支持通过 THROTTLE（限流）或 PAUSE_NEW_WORK（暂停新任务）来降低系统负载。

安装与启用¶

安装插件需要使用 dsh plugin 命令。该命令会将参数转发给 profile 目录下的 pnpm，从而完成插件的加入。

1. 安装：
   使用以下命令将插件添加到当前 profile：

    dsh plugin --profile web add dsh-health-scheduler

2. 从 Git 安装的注意事项：
   如果通过 Git URL 安装，pnpm 默认会阻止构建过程。当安装失败时，需要在 <profile directory>/pnpm-workspace.yaml 中添加 allowBuilds 条目，然后重新运行安装命令。

3. 启动与验证：
   安装完成后，启动 DSH 并检查配置是否正确：

    # 启动
    dsh --profile web

    # 验证配置（打印组合后的配置树，不启动）
    dsh --profile web --dump-config

典型用法¶

插件内置了 balanced 预设作为默认值，无需配置即可运行。若需调整行为，可以通过配置项覆盖预设。

• 最小配置：
  仅需指定预设名称：

    {
      "preset": "balanced"
    }

适用场景与注意¶

• 职责边界：该插件本身不执行重启操作。它负责决策并发出请求，实际的重启执行由 dsh-restart 负责。
• 数据缺失处理：任何维度如果缺失遥测数据，会被标记为 unknown，该状态永远不会被视为 healthy。
• 采样安全：单次点采样不会触发高风险动作，所有评分都基于滚动窗口。
• 依赖检查：在使用前，建议检查源码与许可证，确保符合项目安全规范。