dsh-cybernetics: DeepSeek Harness 控制论内核

前言¶

DeepSeek Harness (DSH) 的 Cordis 插件。作者为 boomzikazita。该插件基于《工程控制论》机制，实现观察者、前馈、反馈控制回路、稳定阀和能控性检查。它旨在为智能体提供类似物理系统的动态稳定性调节能力。

核心机制¶

该插件通过经典控制回路运行：

• 观测器：内存状态按 session 分区，并使用 JSONL 格式持久化至 ~/.dsh/cybernetics/state_log.ndjson。
• 前馈控制：通过 tools/pre-execute 规则表拦截工具调用，支持白名单和参数正则匹配。
• 反馈校正：捕获 tools/result 事件，计算 delta 值并使用 EMA（指数移动平均）滤波。根据失败率触发档位自适应和发散/振荡检测。
• 执行器：提供以下命令供外部调用：
  • cybernetics_snap：快照状态
  • cybernetics_status：状态概览
  • cybernetics_check：能控性检查
  • cybernetics_sandbox_mode：沙箱模式控制

安装与启用¶

通过 bundle 方式安装，推荐使用标准命令：

dsh plugin --profile web add /home/boom/Deepseek/dsh-cybernetics

关键约束：插件目录下的 node_modules 必须软链到 DSH 的全局宿主目录，严禁在插件目录内自行执行 pnpm install。否则会导致 TOOL_RUNTIME_SCHEDULER Symbol 不匹配，引发调度崩溃。

参数配置¶

核心参数位于 cordis.patch.yml，主要控制反馈滤波和阈值判定：

• EMA 滤波：alpha (默认 0.2)
• 档位阈值：
  • fast：阈值 5
  • deep：阈值 4
  • conservative：阈值 3
• 稳定性判定：
  • 升档/降档阈值：escalateAt (0.6) / deescalateAt (0.15)
  • 降档防抖：deescalateStreak (5)
  • 发散判定：divergenceStreak (3)
• 振荡与冗余：
  • oscillationWindow / oscillationRatio (10 / 0.7)
  • redundantWindow (20)
• 熵值告警：
  • entropyWarnAt / entropyRecoverAt (1.0 / 1.5)

开发注意事项¶

基于 v4.2 及开发经验，以下问题需特别注意：

1. 依赖软链：必须将宿主的 node_modules 软链到插件目录，避免依赖副本冲突。
2. waterfall 监听器：必须显式 return next()，否则会断链导致后续工具调度失效。
3. rc.6 defineTool 签名：参数结构为 execute(args, exec)，输出结构为 output:{schema, render}。工具列表应通过 ctx.tools.schemas() 获取。
4. HMR 副作用：修改插件后，dsh web 的热重载会回滚 ctx.tools.register 的副作用，必须重启 dsh web 才能生效。
5. 稳定阀缺陷：存在积分饱和问题（计数器跨轮累计不重置），可能导致系统锁死。
6. TRANSPORT 报错：根因是 tools/pre-execute 注入消息破坏了角色交替约束。需移至 agent/pre-step 使用 createUserMessage 构造消息。
7. 参数字段名：rc.6 版本中，参数字段名为 arguments 而非 args。读取参数时需优先使用 execArgsText 以避免 exec.args 为 undefined。

验证与调试¶

安装后，可以通过以下步骤验证插件状态：

1. 语法与测试：

    node --check index.js && node --check core.mjs
    node -e "import('./index.js').then(m => console.log(m.name, m.inject))"

2. 运行时状态：

    cybernetics_status

3. 日志检查：
   • 检查 Boot 恢复日志：

        grep boot-recover ~/.dsh/cybernetics/state_log.ndjson | tail -1

*   检查冗余事件聚合（A1 修复生效后，冗余计数应不再骤降）：

        grep redundant-burst ~/.dsh/cybernetics/state_log.ndjson | tail -1

参考资料¶

• GitHub: https://github.com/boomzikazita/dsh-cybernetics
• 目录页: https://www.skillhub.cn/plugins/boomzikazita/dsh-cybernetics