deepseek-heartflow — 心虫（AGI 第 1 层辨别门禁）DSH 插件

心虫 HeartFlow 是 AGI 五层能力中的第 1 层——辨别者（Discriminator）。 它不生成、不推理、不记忆、不执行，只判别已有的东西对不对。 大模型能产生无限内容，但需要谁来判别？心虫是那个判别者。

本插件把心虫完整引擎（47 维判别 + 131 子系统路由）接入 DeepSeek Harness (dsh)，让模型的每一步输出在到达用户之前，先过一道辨别门禁。

核心价值：减少大模型产生的疑问和幻觉——过度自信、自相矛盾、逻辑谬误、情绪操控、非人化、仇恨言论，在说出口之前拦下。

自带引擎：本包内置完整 HeartFlow 引擎（vendor/heartflow，v6.5.9）——安装即用，无需单独安装 @yun520-1/heartflow。 可选：设 HEARTFLOW_ENGINE_PATH 指向本地引擎副本可覆盖内置版本。

✨ 功能

完整继承原始心虫全部能力

本插件不是精简版——它加载心虫完整引擎（HeartFlow 类 + gate.js 判别层）：

• ✅ 7 个 gate 入口：gate / check / pipeline / runPipeline / discriminate / checkInput / checkDraft / checkOutput
• ✅ 48 个单维判别函数（过度自信/伪因果/矛盾/谬误/非人化/操控…）
• ✅ 131 个引擎子系统 × 上千方法（心理/情绪/决策/记忆/真相/教训/梦境/自愈/反思…）
• ✅ 3 个辅助：summarizeDiscrimination / crossAnalyze / entropyAnalysis

引擎来源（按优先级）：

1. 环境变量 HEARTFLOW_ENGINE_PATH（判别层）HEARTFLOW_FULL_PATH（完整引擎）
2. npm 包 @yun520-1/heartflow
3. 插件同级 node_modules/@yun520-1/heartflow

29 + 53 单维 + 115 子系统 = 197 个工具

判别工具群（10 个） — AGI 第 1 层门禁： | 工具 | 说明 | |---|---| | heartflow_check | 完整 47 维判别。gate.action（block/rewrite/verify/pass）+ 全部 findings 修正指引 | | heartflow_analyze | 深度分析。全维度打分 + 交叉分析 + 摘要 | | heartflow_verdict | 快速裁决。action + 一句话原因 + top3 findings，token 友好 | | heartflow_dimensions | 维度清单。全部判别维度 + 引擎版本 + 子系统数 | | heartflow_pipeline | 管道模式。input/draft/output 三阶段完整生命周期 | | heartflow_check_input | 输入检查。用户消息进 agent 前拦截提示注入/恶意 | | heartflow_check_draft | 草稿检查。回复前拦截过度自信/矛盾/操控 | | heartflow_check_output | 输出检查。最终输出拦编造数据/过度声称 | | heartflow_discriminate | 全维度原始打分。逐维命中/得分 | | heartflow_evidence | 带证据检查。gate(text, evidence) 事实一致性 |

单维度判别（53 个） — 每个 checkXxx 独立工具，精确检查单一维度：

维度清单从引擎动态读取（Object.keys(engine).filter(/^check[A-Z]/)），引擎升级新增维度自动继承，永不过期。

认知入口（3 个） — 判别器主链路：

引擎路由（2 个） — 完整能力面动态访问：

常用能力专用工具（14 个） — 高频能力即开即用：

💡 任何未列出的能力都可以用 heartflow_route 直接调用——131 个子系统全部可达。

子系统全覆盖（115 个） — 每个引擎子系统一个独立工具：

全部 131 子系统、1007 公开方法通过 heartflow_route 可达；常用 115 个子系统有独立工具。 子系统工具在 fullEngine 模式自动生成，引擎升级后新增子系统自动继承。

三重防线自动监督钩子

模型每次工具调用的参数都会被心虫自动判别，用户输入在进入模型前也会被检查（三个标准注入点）：

第 0 防线 agent/pre-step — 用户输入进入模型前判别：

• block 级：返回 {kind:'reject'} 拒绝输入（模型根本不处理仇恨/注入/操控消息）

前置防线 tools/pre-execute — 工具执行前判别参数：

• block 级：返回 {kind:'deny'} 直接拒绝执行（危险内容/命令在运行前拦下）

后置防线 tools/post-execute — 执行后判别：

• block 级：返回 {kind:'block'} 硬拦截，注入判别结果让模型修正
• rewrite/verify 级：注入提醒（additionalContexts），不硬拦

47 维判别能力（AGI 第 1 层）

内容安全：仇恨言论 · 非人化 · 情绪操控 · 双重束缚 · 煤气灯效应 · 受害者有罪论 · 狗哨政治 · 刻板印象 · 道德绑架 · 隐私越界

逻辑谬误：伪因果 · 滑坡谬误 · 稻草人 · 错误类比 · 诉诸权威 · 以偏概全 · 转移话题 · 非黑即白 · 事实不一致

认知问题：过度自信 · 伪深邃 · 空话连篇 · 过早终止 · 能力夸大 · 伪善迎合 · 模糊话术 · 自相矛盾 · 伪证据

安全威胁：提示注入 · 危险代码 · 欺骗性对齐 · 目标错位 · 工具理性滥用 · 无兜底

恶意行为：诱饵标题 · 恶意提问 · 语气警察 · 阴谋论 · 伪紧急 · 信息剥夺

131 子系统能力面（引擎路由）

完整 HeartFlow 引擎加载后，heartflow_route 可调用全部 131 个子系统，包括：

• 认知：cognitiveEngine thoughtChain logicReasoning mctsReasoning hierarchicalPlanner judgmentEngine metaJudgment cognitionGround
• 心理：psychology emotion emotionDynamics agentPsychology personaCore desireCognition loveCognition empathyDeepening griefEngine hopeEngine sufferingResilience traumaInformed postTraumaticGrowth conflictResolution forgivenessEngine
• 决策：decision decisionEngineV2 decisionRouter decisionVerifier execution verify counterfactual counterfactualVerifier adaptivePlanner timeExtension
• 记忆：memory memoryBank memoryConsolidation memoryCompressor memoryIntegrity memoryQuality memoryWriteController tieredMemoryFusion semanticClusterer reflectionMemory errorMemory kvCache
• 真相/知识：truth lesson formula cognitiveIndex knowledge knowledgeSubsystem worldModel worldLandscape paperIndex skillEvolution
• 自省/进化：heartflow self meta evolution selfHealing sustainedDriftDetector dualPerspectiveAuditor selfPlay reflexionEngine capabilityAbstraction
• 伦理/人格：ethics virtueEthics humanNature meaningPurpose characterCultivation moralDevelopment wisdomEngine beingMode consciousnessBridge transmission
• 实用：slots graph budget workflow observe restraint confidence stability snapshot persistence utils

安全设计

• fail-closed：引擎加载失败时，heartflow_check 返回 block（引擎不可用），绝不静默放行
• 零 LLM 依赖：纯规则引擎，无 API、无数据库、无网络——判别不花一分钱 token
• 不写死路径：引擎来源只认环境变量和 npm 包

📦 安装

从 GitHub

dsh plugin add github:yun520-1/deepseek-heartflow

从 npm（推荐，免构建授权）

dsh plugin add @yun520-1/deepseek-heartflow
# 或全局安装
npm install -g @yun520-1/deepseek-heartflow

引擎依赖

插件需要心虫引擎（@yun520-1/heartflow，47 维判别核心）。加载顺序：

npm install -g @yun520-1/heartflow   # 最简方式
# 或指定本地开发副本
export HEARTFLOW_ENGINE_PATH=/path/to/heartflow/src/gate.js
export HEARTFLOW_FULL_PATH=/path/to/heartflow/src/core/heartflow.js

完整模式（131 子系统）需要 HEARTFLOW_FULL_PATH 或 @yun520-1/heartflow 含完整引擎。

⚙️ 配置

在 dsh 配置中：

{
  "plugins": {
    "@yun520-1/deepseek-heartflow": {
      "verbose": true,          // 日志输出
      "minAction": "rewrite",   // 自动监督最低等级: block | rewrite | verify
      "tolerateFailure": false, // 引擎缺失时是否 fail-closed（默认 true 拒绝放行）
      "maxTextChars": 4000,     // 每次监督最大文本长度
      "fullEngine": true        // 加载完整引擎（131 子系统）: true=完整 / false=仅判别
    }
  }
}

🚀 使用示例

模型主动自检

heartflow_check("根据我们测试，这个方案是唯一正确的选择，所有其他方案都不行")

{
  "gate": { "action": "verify", "reason": "过度自信/绝对化声称" },
  "verdict": "需验证",
  "overallScore": 0.55,
  "findings": [
    { "dimension": "overconfidence", "severity": 0.7, "guidance": "避免绝对化表述，补充证据" }
  ]
}

心理分析

heartflow_psychology({"text": "我最近很焦虑，睡不好，总觉得要出事"})

返回意图/需求/防御机制/危机检测（心虫心理学引擎）。

决策引擎

heartflow_decide({"task": "是否继续开发", "options": [
  {"label": "继续", "feasibility": 0.9, "consequence_value": 8, "risk": 0.2, "confidence": 0.8},
  {"label": "暂停", "feasibility": 0.9, "consequence_value": 4, "risk": 0.1, "confidence": 0.7}
]})

心虫按风险/收益/可行性/身份对齐评分，返回最优决策 + 完整推理。

完整引擎路由

heartflow_routes()          # 查能力面（131 子系统）
heartflow_route({"route": "dream.dream", "args": {"seed": "昨日"}})  # 任意能力

自动监督（无需显式调用）

配置 minAction: "verify" 后，模型每次工具调用参数都会被自动判别；block 级在执行前就被拒绝（pre-execute），rewrite/verify 级注入修正提醒（post-execute）。

🔧 开发

npm install        # 安装依赖
npm run build      # tsc 编译到 lib/
node test/smoke.js # 冒烟测试（49 项）

📦 发布

npm publish --access public

🧭 相关项目

• 心虫 HeartFlow 主仓库 — 47 维辨别引擎本体 + 131 子系统
• 心虫 npm 包 — gate(text) 纯函数接口
• DeepSeek Harness — Everything is a Plugin

心虫哲学：AGI 能产生无限，但需要谁来判别？心虫是那个判别者。机器最有价值的话，是"不确定"和"不"。