yun520-1/deepseek-heartflow

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

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

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

---

✨ 功能

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

本插件不是精简版——它加载心虫完整引擎（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

26 个工具

判别工具群（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) 事实一致性

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

工具	说明
heartflow_routes	能力面。列出 131 子系统 × 方法数（动态，随引擎升级自动更新）
heartflow_route	通用路由。调用任意 subsystem.method（如 emotion.process / decision.decide）

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

工具	路由	能力
heartflow_psychology	psychology.analyzePsychology	心理分析：意图/需求/防御/危机
heartflow_emotion	emotion.process	情绪 PAD 三维识别
heartflow_crisis	psychology.checkCrisis	危机检测（自杀/自伤/暴力）
heartflow_decide	decision.decide	决策引擎（风险/收益/身份对齐）
heartflow_verify	verify.verify	执行结果验证
heartflow_confidence	confidence.calibrate	置信度校准
heartflow_truth	truth.checkStatement	事实核查（证据支撑）
heartflow_lesson	lesson.getTopLessons	教训库（最高价值教训）
heartflow_introspect	heartflow.introspect	自我审视（状态/能力/待改进）
heartflow_dream	dream.dream	梦境引擎（认知状态编织）
heartflow_memory_search	memory.search	记忆检索
heartflow_memory_stats	memory.getStats	记忆分层统计
heartflow_restraint	restraint.shouldIntervene	克制判断（话多/应沉默检测）
heartflow_admit	confidence.admit	诚实认错（不确定性识别）

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

双防线自动监督钩子

模型每次工具调用的参数都会被心虫自动判别（tools/pre-execute + tools/post-execute）：

前置防线 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 能产生无限，但需要谁来判别？心虫是那个判别者。机器最有价值的话，是"不确定"和"不"。