dsh-proactive

Readme

# dsh-proactive

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)
[![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178c6?logo=typescript&logoColor=white)](./tsconfig.json)
[![Node](https://img.shields.io/badge/Node-%3E%3D22.18-339933?logo=nodedotjs&logoColor=white)](#安装)
[![topic](https://img.shields.io/badge/topic-dsh--plugin-8250df)](https://github.com/topics/dsh-plugin)

> **主动智能（Proactive Intelligence）调度插件** —— DeepSeek Harness（DSH）生态中的多模型协同调度系统：自主感知、自主决策、自主进化，内置**科学家 / 理论家双心智**与**认知能量共生经济**。
>
> [English](./README.en.md) | 中文

## 什么是主动智能？

传统调度系统是**被动的**：收到信号才响应，没有信号就空转。本插件在「感知 → 决策 → 执行 → 反思 → 沉淀」闭环之上叠加自主层，让系统：

- **没有任务时**，主动观察自身运行状态、发现瓶颈、生成改进目标
- **遇到未知领域**，主动发起探索，把"不知道"变成"有经验"
- **面对未来负载**，主动预测信号到达趋势，提前预留容量
- **出现异常时**，主动熔断、限流、降级，而不是等到崩溃

## 架构总览

系统由三层组成：**质变内核**（一套共享统计语言的心智底座）、**三环自治**（操作环 / 进化环 / 元认知外环）、**共生经济层**（认知能量市场）。

```
┌─ 共生经济层（symbiosis/）─────────────────────────────────────┐
│  能量账本（复式记账·链式审计）  知识市场（连续双向拍卖·版税）      │
│  信念市场（LMSR·市场即心智）    智能体（信誉·立法执法分离）       │
│  共生运行时（生存→提案→否决→撮合→执行·铸币分红）                 │
├─ 三环自治 ───────────────────────────────────────────────────┤
│  操作环：信号→决策→执行→反思 10 步主链路（index.ts）             │
│  进化环：策略进化器 + 安全沙盒 + 金丝雀部署（policy/）            │
│  元认知外环：自我建模 → 保守调整 → 观察/回滚（meta/）             │
├─ 质变内核（core/）3.0 → 11.0 九大内核 ────────────────────────┤
│  证据 3.0  弹性 4.0  因果 5.0  自由能 6.0  深思 7.0             │
│  元推理 8.0  抽象 9.0  科学家 10.0  理论家 11.0                 │
└──────────────────────────────────────────────────────────────┘
```

## 核心特性

### 主动感知与自主决策
- Sentinel 多源信号接入（webhook / 文件监听 / 轮询 / 手动注入），聚合窗口去重、紧急度智能排序
- 战略决策引擎：execute / defer / dismiss / ask-user 四级决策，统计学习（时间衰减 + Wilson 下界 + UCB 冷启动）持续校准
- 经验检索 + DAG 计划生成 + 多模型并行执行，10 步主链路单向数据流

### 科学家 / 理论家双心智
- **科学家内核**（[core/scientist.ts](./src/core/scientist.ts)）：贝叶斯最优实验设计——为「知识获取本身」定价。真 EIG（nat）评估实验信息价值、混杂加成（实验独占价值）、预算仲裁（netValue = EIG − cost）、信息台账校准、知识前沿收缩
- **理论内核**（[core/theorist.ts](./src/core/theorist.ts)）：层级贝叶斯 + MDL（理解即压缩）——把数据压缩为定律。同族观测边汇聚为定律（借力收缩）、压缩定价（对数贝叶斯因子）、零样本预测、反常侦测、范式转移（库恩跃迁）

### 质变内核（core/，3.0 → 11.0）
| 内核 | 版本 | 一句话 |
|------|------|--------|
| evidence.ts | 3.0 | 统一证据语言：Wilson 界 / 时间衰减 / 证据排序，铺满所有记忆层 |
| resilience.ts | 4.0 | 弹性执行：熔断器状态机 / 指数退避全抖动 / 错误分型 |
| causal-kernel.ts | 5.0 | 因果推断：Pearl do-干预 ATE / 混杂检测 / 反事实查询 |
| free-energy.ts | 6.0 | 主动推断：Friston 自由能，一公式统一利用/探索/好奇心/健康度 |
| deliberation.ts | 7.0 | 规划即推断：想象推演 + beam search × 技能宏 + 梦实现对账 |
| metareasoning.ts | 8.0 | 理性元推理：双过程仲裁 / 任意时搜索稳定停机 / 思考按 nat 计价 |
| abstraction.ts | 9.0 | 抽象泛化：状态骨架分解 + 结构类比，经验跨域「举一反三」 |
| scientist.ts | 10.0 | 科学家心智：贝叶斯最优实验设计（见上） |
| theorist.ts | 11.0 | 理论心智：层级贝叶斯 + MDL 定律归纳（见上） |

### 认知能量共生经济（symbiosis/）
- **能量账本**（ledger.ts）：认知能量不可伪造，复式记账全局守恒，每笔转账 sha256 链式可审计可回放，基尼系数度量生态健康
- **知识市场**（market.ts）：知识作为可交易资产，连续双向拍卖；挂单费燃烧防垃圾、央行支付售后版税，劣质知识被证据校准自然淘汰
- **信念市场**（belief.ts）：LMSR 做市商把「对未来的判断」变成可交易资产，市场即心智；知情者套利错者，结算即审计，激励相容
- **智能体契约**（agent.ts）：感知/提案/执行三段分离（立法-执法分离），信誉复用 Wilson 下界——贡献决定分红，表现差自然饿死休眠
- **共生运行时**（runtime.ts）：心跳编排（生存→感知→提案→监管否决→撮合→授权执行），任务成功铸币按 Wilson 加权分红，余额低于生存线休眠，监管一票否决；**影子模式接入，不接管主链路**
- **宿主融合桥**（bridge.ts）：KPI 注入能量经济、任务结算铸币分红、futarchy 进化表决三个薄接点，缺省关闭零漂移
- **首批智能体**（wrappers.ts）：MemoryAgent（卖方+维护者）/ OptimizerAgent（买方）/ EvolverAgent（策略基因卖方），构成最小认知经济闭环
- **可观测性**（observability.ts）：账本凭证聚合为 Sankey 能量流全景，离线渲染自包含 HTML（见 [symbiosis-sankey-demo.html](./symbiosis-sankey-demo.html)）

### 自我反思与进化
- 目标引擎：从洞察生成目标并分解子任务
- 质量反思引擎：低于阈值自动重试 / 切换模型，阈值按质量分布自校准
- 元认知层（meta/）：自我建模引擎产出四视图心智报告（策略表现/记忆健康/进化效率/系统稳定），元认知控制器保守调参（每轮一步、观察窗、劣化回滚）
- 策略进化：遗传算法演化决策基因 + 策略进化器（policy/）种群进化、沙盒多种子评估、LCB 门禁、金丝雀热切换、劣化自动回滚
- 长期记忆：任务模式、模型画像、经验教训跨会话沉淀

### 记忆体系与检索增强
- **三层记忆 + 知识蒸馏**：情景 → 语义 / 程序记忆，水位门控蒸馏，稳定 id，证据合并与冲突消解
- **SQLite 持久化**：Node 内置 `node:sqlite` 零依赖，关系化分表（`task_patterns` / `model_profiles` / `decision_feedback` + `distilled_strategies` / `meta`）、WAL、版本化迁移、维护 API（完整性检查 / 热备份 / 碎片回收 / 只读 SQL 通道）；加密启用或宿主不支持时自动回退 JSON 原子写后端（[memory/backend.ts](./src/memory/backend.ts)）
- **混合检索**：FTS5 双分词（trigram 中文子串 + token 级）+ 稀疏词频向量余弦 + 记忆图联想，四路召回（`optimizer.hybridSearch`）
- **记忆图**：共现网络与主题图 JSON 序列化跨重启（[memory/memory-graph.ts](./src/memory/memory-graph.ts)）
- **防幻觉短索引**：注入大模型前长 ID 转 `#1…` 短索引，输出后反解（[memory/alias-map.ts](./src/memory/alias-map.ts)）

### 工程基础设施
- Raft 共识、分布式同步、热更新、AES-256-GCM 加密存储
- 多租户隔离、基准测试引擎、零依赖 WebSocket 实时进度（原生 RFC 6455）、可视化 Dashboard
- 18 个 Tool 注册，宿主融合层全宿主可观测与安全治理

## 自主循环（Autonomy Loop）

每个心跳执行 11 步编排（[autonomy-loop.ts](./src/autonomy-loop.ts)）：

1. **元认知观察** —— 采集 KPI，发现异常洞察
2. **1.5 共生心跳** —— KPI 注入能量经济 + 信念市场
3. **世界模型预见** —— 预测信号到达，捕捉上升趋势
4. **汇总反思教训** —— 合并反思引擎经验教训，去重已消化项
5. **目标生成** —— 从洞察自动生成改进目标并分解子任务
6. **子任务派发** —— 经安全治理审查后注入执行
7. **好奇心探索** —— 剩余预算用于知识盲区探索
8. **策略进化** —— 遗传算法演化决策策略
9. **7.5 策略进化器** —— 调度策略经沙盒验证后金丝雀热切换
10. **7.7 元认知环** —— 自我建模 → 保守调整 → 观察 / 回滚（低频）
11. **8. 记忆维护** —— 经验蒸馏 + 遗忘曲线（低频后台）

## 越用越聪明的三个通路（缺一即退化为静态系统）

1. **经验驱动选型**：优化器推荐的模型组合按节点类型真正参与节点分配（`Optimizer.lookupExperience → ModelScheduler.assignModel`），而非仅作提示词
2. **策略反馈校准**：蒸馏策略按执行结果回写应用成功率，有效策略越用越强、无效策略自然淘汰
3. **经验快路径**：命中高置信度模式（默认 ≥ 0.9，`memoryFastPathThreshold` 可调）时直接召回历史最优成功计划（`Optimizer.recallPlan`），跳过 LLM 重新规划——越用越快、越稳、越省 token

三个对冲机制（防止「越学越错」的安全阀）：

1. **遗忘曲线**：长期未用的记忆按艾宾浩斯模型降置信直至遗忘，`lastDecayAt` 基准幂等衰减
2. **置信度衰减**：成功加分、失败扣分，长期未验证的策略衰减清除
3. **阈值自校准**：质量分布偏高收紧阈值、偏低放宽，避免无效重试风暴

## 安装

要求：Node.js `^22.18.0 || >=24.11.0`。

推荐用 dsh CLI 一键安装（`--profile` 指定目标 profile，如 `web`；构建产物 `dist/` 已随仓库分发，安装零构建脚本）：

```bash
dsh plugin add beijingwahw/dsh-proactive --profile web
dsh web
```

## 开发期热更新（HMR）

| 层 | 方法 | 生效范围 |
|---|---|---|
| 运行配置 | 编辑 dsh 用户层 `cordis.patch.yml`（`~/.dsh/profiles/<name>/` 或 `~/.dsh/`），保存即生效 | dsh 原生监视用户层，事务性重载该行（bundle 层默认值已全量列出，照抄整行覆盖即可） |
| 开发期代码 | `npm run dev` 起独立 cordis + HMR 进程 | 保存 `src/` 下任意文件或 `cordis.yml` → 旧实例卸载（调度器资源清理回卷）→ 新代码挂载，无需重启 |
| 安装产物 | 改代码 → `npm run build` → 重新 `dsh plugin add` → 重启 dsh | 更新已安装的插件 |

`npm run dev` 的组成：仓库根 `cordis.yml` 依次挂 logger / timer / hmr / 宿主桩 / 本插件（直接加载 `src/index.ts`，config 与 `cordis.patch.yml` 逐键一致，开发行为 = 生产 bundle 行为）；
`dev/host-stubs.ts` 提供宿主 `tools` 服务桩，让 18 个 Tool 走完整桥接链路（宿主无该服务时插件会静默降级，桩让开发进程更接近 dsh 运行时形态）。

## 配置（零手动配置）

**开箱即用，无需手动配置任何模型或密钥，插件本身也不持有任何 API Key。**

- 随附的 [cordis.patch.yml](./cordis.patch.yml) 已封装全部国产模型（DeepSeek / 通义千问 / 智谱 / Kimi / MiniMax / 讯飞星火 / 腾讯混元 / 百度文心 / 商汤日日新），加载即用；
- 运行时插件经 ctx 上下文获取 DSH 已配置好的 LLM 客户端，DSH 自动把用户配置的 Key（Web UI 填写或环境变量配置）注入请求头；
- **密钥自动填入**：插件还会自动读取宿主本地密钥并按厂商匹配填入请求头，优先级为 宿主 ctx 注入 → 进程环境变量（如 `DEEPSEEK_API_KEY` / `DASHSCOPE_API_KEY`，按模型 id 前缀匹配厂商）→ DSH 本地配置文件（`~/.dsh/config.json` 等，mtime 热更新、缺失时定期重探测）；密钥只进内存，不落盘、不打印；
- **多密钥故障转移**：同一厂商存在多个候选密钥时，认证失败（401/403）或配额耗尽（429）会自动轮换到下一个候选密钥重试，并升级为**健康感知路由**——按成功/失败统计选择最优密钥，429 冷却 1 分钟、401/403 冷却 5 分钟，成功后自动恢复；用户可通过 `manage_keys` 工具调整密钥使用顺序（持久化，重启保留），启动日志输出每个模型的密钥来源（不含密钥值），运行时可用 `query_memory keys` 查看各密钥健康状态；
- 若只需单一厂商，可改用 `patches/domestic-models/` 下按厂商拆分的 patch；重新生成：`pnpm generate:patches`。

完整运行配置项（哨兵 / 加密 / 同步 / 共识 / 热更新 / 租户 / 自主循环 `autonomy` / 宿主融合 `hostFusion`）同样内置于 [cordis.patch.yml](./cordis.patch.yml)，无需改动；共生经济子项位于 `autonomy.symbiosis`（futarchy 表决、能量反哺等，缺省关闭）。

## 工具一览（18 个）

| 分组 | 工具 |
|------|------|
| 执行与调度 | `autonomous_execute` · `model_dashboard` · `run_benchmark` |
| 记忆与知识 | `query_memory` · `query_experience` · `distill_knowledge` · `maintain_memory` · `memory_migration` |
| 元认知 | `mental_report` · `self_knowledge` · `meta_cognition` |
| 自主治理 | `manage_autonomy` · `manage_keys` |
| 基础设施 | `manage_tenants` · `manage_encryption` · `manage_sync` · `manage_consensus` · `manage_hot_reload` |

通过 `manage_autonomy` 获取七维自省报告：

```jsonc
// 调用：manage_autonomy { "action": "introspect" }
// 返回（示例，字段节选）：
{
  "loop":      { "running": true, "tickCount": 42 },
  "health":    { "score": 0.86 },
  "goals":     { "active": 3 },
  "exploration": { "totalExplorations": 5 },
  "governance":  { "circuitState": "closed" },
  "worldModel":  { "types": 4 },
  "evolution":   { "generation": 7 }
}
```

其他常用操作：

- `manage_autonomy`：`start` / `stop` / `tick` / `kill-switch` / `revive` / `reset-circuit`
- `query_memory`：`world-model` / `curiosity` / `governance` / `patterns` / `lessons` / `keys` 等

## 离线验证（24 个，零 API Key）

每个内核与子系统均有离线端到端验证脚本（`node scripts/verify-*.mjs`）：

```bash
node scripts/verify-scientist.mjs     # 科学家：EIG 定价 / 预算仲裁 / 知识前沿收缩
node scripts/verify-theorist.mjs      # 理论家：定律归纳 / 零样本预测 / 范式转移
node scripts/verify-symbiosis.mjs     # 共生经济：账本 / 市场 / 三智能体六轮心跳闭环
node scripts/verify-self-evolution.mjs # 自进化闭环：推荐采纳 / 快路径 / 三对冲机制
```

| 分组 | 脚本 |
|------|------|
| 双心智 | verify-scientist · verify-theorist |
| 质变内核 | verify-unified-evidence · verify-resilience-governance · verify-causal-kernel · verify-active-inference · verify-deliberation · verify-metareasoning · verify-abstraction |
| 共生经济 | verify-symbiosis · verify-symbiosis-bridge · verify-belief-market · verify-futarchy · verify-energy-feedback · verify-full-agents · verify-observability |
| 学习与进化 | verify-self-evolution · verify-self-evolution-v2 · verify-knowledge-distillation · verify-policy-evolution · verify-meta-cognition · verify-meta-cognition-v2 · verify-meta-edge · verify-consensus-sync |

能量流向可视化：浏览器打开 [symbiosis-sankey-demo.html](./symbiosis-sankey-demo.html)（零依赖自包含页面）。

## DSH 插件规范符合性

本插件遵循 DeepSeek Harness（cordis）插件开发规范，在不影响性能的前提下完成以下规范化提升：

- **函数插件形态 + 静态元数据**：默认导出为 `apply(ctx, config)` 函数插件，并挂载 `name` / `Config` / `provide` 静态元数据，供注册表与加载器识别；
- **Schemastery Config schema**：`Config` 为标准 schema，加载时由 cordis `resolveConfig` 自动校验类型并填充默认值（哨兵 / 加密 / 同步 / 共识 / 热更新 / 租户 / 自主智能等全部配置节）；函数型注入字段（`nodeRunner` / `judge` / `llm.fetchImpl` 等）与共生嵌套配置作为额外属性透传，不受校验影响；
- **官方 Tool 注册链路**：宿主加载 `@deepseek-ai/dsh-tools`（`ctx.tools` 服务）时，18 个 Tool 经 duck-typing 桥接注册进官方 ToolRegistry，纳入 pre/around/post 执行管线与模型可见面（参数转为官方 JSON Schema 子集）；宿主未提供时静默降级为内部 ToolRegistry + `ctx.provide('schedulerTools')`，不引入整套 agent 栈依赖；
- **依赖注入与服务声明**：经 `ctx.provide('scheduler' / 'schedulerTools')` 暴露服务面，并通过 TypeScript 声明合并（`declare module '@deepseek-ai/cordis'`）为 `Context` 注入类型；
- **生命周期清理**：全部资源在 fiber 卸载时经 `ctx.effect` 按依赖逆序清理（含官方 Tool 注销）；
- **发布清单**：`package.json` 声明 `dsh.bundle.patch` 指向 [cordis.patch.yml](./cordis.patch.yml) bundle 配置层，`exports` / `files` / `engines` / `keywords` 齐备，dist/ 构建产物随仓库分发（安装零构建脚本，规避 pnpm allowBuilds 拦截）。

## 宿主融合层（Host Fusion）

在规范化之上，插件经 cordis 跨 fiber 事件机制深度融入宿主运行时，从"被动插件"升维为**宿主级认知与安全层**（宿主加载 `@deepseek-ai/dsh-tools` 时自动激活，否则静默降级）：

- **全宿主可观测**（`tools/result`，emit）：观测宿主全部工具调用结果——每次调用经世界模型 `observeArrival` 学习宿主行为节律（增强预见性）；工具失败注入 `host-tool-failure` 信号至哨兵，触发决策链路自愈；同工具连续失败达阈值（默认 3 次）自动升级：高紧急度信号 + 教训沉淀至反思引擎；
- **全宿主安全治理**（`tools/pre-execute`，waterfall）：调度器的安全治理器获得对宿主管线的否决权——Kill Switch 启用时冻结全宿主工具调用（紧急停止从"冻结自身"升级为"冻结宿主"）；调度器自身失败螺旋触发熔断器时 fail-closed 拒绝宿主动作；只读门控（`checkGate`），不消耗限流/预算；
- **安全设计**：观测 fail-open（自身异常绝不破坏宿主管线）、治理 fail-closed（仅显式安全状态拒绝）；自排除调度器自身 18 个桥接 Tool，避免反馈环路；零新增依赖（结构化类型 + 声明合并）。

配置节 `hostFusion`：`enabled` / `observeToolResults` / `governToolCalls` / `failureEscalationThreshold`（默认 `true / true / true / 3`）。

## 项目结构

```
├── cordis.patch.yml              # bundle 配置层（dsh.bundle.patch 指向，全部国产模型零密钥）
├── symbiosis-sankey-demo.html    # 认知生态能量流 Sankey 全景（零依赖自包含）
├── patches/domestic-models/      # 按厂商拆分的可选 patch（9 厂商 + all-domestic.yml）
├── scripts/                      # patch 生成器 + 24 个离线验证脚本
└── src/
    ├── index.ts                  # 插件入口：10 步主链路编排 + 18 个 Tool 注册
    ├── types.ts / errors.ts      # 共享类型层 / 统一错误体系（稳定机器可读 code）
    ├── contracts.ts              # 三支柱接口契约（IMemoryStore / IReflector / IOptimizer）
    ├── llm-client.ts             # LLM 统一调用：超时 / 指数退避 / 并发信号量 / 成本统计
    ├── progress-ws.ts            # 零依赖 WebSocket 进度广播（原生 RFC 6455）
    ├── sentinel.ts               # 信号感知：多源接入 + 聚合窗口
    ├── decision-engine.ts        # 战略决策：四级决策 + 统计学习校准
    ├── model-scheduler.ts        # 模型调度：能力画像 × 记忆加权 × 成本感知 × 能量反哺
    ├── task-executor.ts          # 任务执行：DAG 并行 + 质量反思重试 + 级联触发
    ├── optimizer.ts              # 优化器：经验检索 + 混合检索 + 快路径计划召回
    ├── reflector.ts              # 反思器：复盘 + 记忆更新 + 策略反馈 + 蒸馏
    ├── reflection-engine.ts      # 质量反思引擎：阈值自校准 / 教训提取
    ├── goal-engine.ts            # 目标引擎：洞察 → 目标 → 子任务
    ├── world-model.ts            # 世界模型：到达预测 / 趋势检测 / 校准（MAE）
    ├── curiosity-engine.ts       # 好奇心引擎：知识盲区扫描 / 自适应探索预算
    ├── safety-governor.ts        # 安全治理：限流 / 预算 / 熔断 / 置信度门控 / Kill Switch
    ├── meta-cognition.ts         # 元认知监测
    ├── strategy-evolution.ts     # 策略进化：遗传算法演化决策基因
    ├── autonomy-loop.ts          # 自主循环：11 步心跳编排
    ├── host-fusion.ts            # 宿主融合层：全宿主可观测 + 安全治理
    ├── dsh-host.ts               # DSH 宿主集成：LLM 客户端 / 模型目录 / Key 注入
    ├── core/                     # 质变内核：evidence 3.0 → theorist 11.0 九大内核
    ├── meta/                     # 元认知层：自我建模 + 元认知控制器（双环外环）
    ├── policy/                   # 策略进化器 + 安全沙盒：种群进化 / 金丝雀部署
    ├── symbiosis/                # 认知能量共生经济：账本 / 市场 / 信念市场 / 智能体 / 运行时 / Sankey
    ├── memory/                   # 长期记忆：SQLite/JSON 双后端 + 记忆图 + 别名映射 + 迁移
    ├── consensus/                # Raft 共识
    ├── sync/                     # 分布式同步
    ├── hot-reload/               # 热更新
    ├── security/                 # 加密引擎（AES-256-GCM）
    ├── tenant/                   # 多租户
    ├── benchmark/                # 基准测试
    └── dashboard/                # 可视化面板
```

## 许可

[MIT](./LICENSE)