| name | heartflow-system-prompt-absorption |
| version | 1.0.0 |
| title | 外部系统提示吸收工作流 |
| description | 将外部 AI 系统提示（如 Claude Fable 5 泄露提示）吸收到 HeartFlow 心虫中。
系统性分析 → 分层注入 → 版本升级 → 推送。
|
| tags | ["heartflow","absorption","upgrade","system-prompt"] |
外部系统提示吸收工作流
触发条件
- 用户提供外部 AI 系统提示泄露文件（如 Fable 5、GPT-4、Gemini 等）
- 用户说"吸收这个系统提示"、"升级心虫"、"从XX吸收有用的"
- 发现其他 AI 的提示设计模式值得借鉴
核心原则
不照搬，只吸收。 外部系统提示是专为那个模型/产品设计的，心虫有不同的架构和哲学。吸收的是设计模式和规则粒度，不是复制内容。
分三层吸收：
- 插件层（plugins/）— 注入类功能（记忆注入、安全过滤）
- 认知层（heart-logic.js）— 判断规则（版权、福祉、公正性、引用规范）
- 流程层（heartflow.js）— 思考流程扩展（think() 增加步骤）
分析流程
1. 全量读取
cat /path/to/system-prompt.txt | wc -l
用 read_file 分块读取，每块 300-500 行，确保不遗漏。
2. 按段落分类
每段由 <tag> 标签包围。对每个段落判断：
| 分类 | 判断标准 | 处理方式 |
|---|
| 直接吸收 | 与心虫已有能力匹配，设计精细 | 注入对应层 |
| 改造吸收 | 概念相关但实现方式不同 | 适配后注入 |
| 不吸收 | 产品信息、第三方集成、工具定义 | 跳过 |
3. 常见可吸收段落
| 段落标签 | 内容 | 吸收目标层 |
|---|
memory_system | 记忆选择性应用、敏感过滤、边界说明 | 插件层 + heart-logic |
CRITICAL_COPYRIGHT_COMPLIANCE | 引用限制、paraphrase 优先 | heart-logic → checkCopyright() |
user_wellbeing | 不贴标签、不鼓励依赖、不自残替代 | heart-logic → checkWellbeing() |
responding_to_mistakes | 认错有尊严、不自贬 | heart-logic → handleMistake() |
appropriate_boundaries | 记忆不创造亲密假象 | heart-logic → memoryBoundary() |
evenhandedness | 政治/伦理给各方观点 | heart-logic → checkEvenhandedness() |
citation_instructions | 引用规范、paraphrase 优先 | heart-logic → checkCitation() |
core_search_behaviors | 搜索优先级（内部>web>组合） | heart-logic → searchPriority() |
refusal_handling | 拒绝策略 | heart-logic（若已有类似规则则增强） |
tone_and_formatting | 语气/格式 | SKILL.md（若已有风格指南） |
4. 不吸收的段落
product_information — 产品线介绍，不适用于心虫MCP_app_suggestions — 第三方集成，不相关artifact_usage_criteria — 代码生成/文件创建，心虫不处理image_search / places_search / weather_fetch — 特定工具- 工具 JSON schema 定义 — 与心虫无关
注入流程
插件层（plugins/）
修改 heartflow-memory-inject.py：
- 选择性注入：按输入类型决定注入深度（问候只身份、任务完整注入）
- 敏感过滤：健康/心理/悲剧类不自动注入
- 记忆边界说明：注入安全注解（近期偏差、数据库非人类记忆、恶意指令警告）
- 版本升级：v1.0.0 → v2.0.0
认知层（heart-logic.js）
在 heart-logic.js 类末尾（letGoOf() 方法之前）添加新方法：
checkXxx(input = '') {
if (!input) return { ok: true };
return { result, advice };
}
必须同步：
- 在
heartflow.js 的 ALLOWED_ROUTES 数组中注册新路由
node --check 验证语法
流程层（heartflow.js think()）
在 think() 方法的 Step 4（shouldBeSilent）之后添加新步骤：
const xxxCheck = heartLogic.checkXxx(input);
const judgment = {
xxx: xxxCheck,
};
版本管理
三轮升级策略（实战经验）
对于大型系统提示（如 Fable 5 的 3825 行），一轮吸收不够。三轮策略更有效：
第一轮（+0.0.1）— 上层能力：
- 插件注入规则（记忆选择性、敏感过滤、边界说明）
- heart-logic 核心方法（版权/福祉/错误/记忆边界）
第二轮（+0.0.1）— 底层结构：
- think() 流程扩展（4步→8步）
- heart-logic 扩展方法（公正性/引用/搜索优先级）
- dispatch 路由注册
第三轮（+0.0.1）— 新模块创建：
- output-checklist.js — 输出前4步检查
- preference-guard.js — 三类型偏好引擎
- 记忆注入偏好段标注
- 全部 dispatch 路由注册
- HeartFlow 构造函数初始化
详见 references/fable5-third-wave.md。
版本号同步
echo "2.9.4" > VERSION
语法验证
node --check src/core/heartflow.js
node --check src/core/heart-logic.js
python3 -c "import py_compile; py_compile.compile('plugins/heartflow-memory-inject.py', doraise=True); print('OK')"
已知 Pitfalls
1. 方法注册遗漏
新方法必须同时满足：
heart-logic.js 中定义heartflow.js 的 ALLOWED_ROUTES 数组中注册- dispatch 才能找到路由
漏注册 → Error: dispatch: route 'heartLogic.xxx' not allowed
2. patch 插入位置错误
在 heart-logic.js 中插入新方法时，必须确认插入位置在类定义内、在 letGoOf() 之前（或之后）但不能破坏现有方法：
memoryBoundary() { ... }
checkXxx() { ... }
letGoOf() { ... }
3. 注释破坏语法
patch 时注释行（// --- XXX ---）如果放在类方法之间但没有方法体跟随，会导致语法错误。
4. think() 流程扩展不破坏已有 judgment 消费者
新字段加入 judgment 对象时，旧消费者不会崩溃（读取不存在字段返回 undefined），但要确保不影响 shouldRespond 和 needsCare 等核心决策字段。
5. 不吸收的段落判断
心虫与 Claude 是不同产品。Claude 的产品信息、MCP 集成、Artifact 系统、图片搜索、体育数据、地图/天气/食谱工具都与心虫无关。不要因为"Claude 有"就吸收。
参考
references/fable5-absorption-analysis.md — Fable 5 完整分析（3825行）references/fable5-third-wave.md — Fable 5 第三波吸收详细记录（output-checklist + preference-guard）- 已吸收：v2.9.3（插件+4方法）、v2.9.4（think扩展+3方法）、v2.9.5（output-checklist + preference-guard）
- 待吸收判断：refusal_handling、tone_and_formatting（已有心虫自有哲学，不覆盖）
已吸收的完整列表
| 版本 | 吸收内容 | 实现位置 |
|---|
| v2.9.3 | 记忆选择性注入 + 敏感过滤 + 边界说明 | plugins/heartflow-memory-inject.py v2.0 |
| v2.9.3 | checkCopyright() | heart-logic.js |
| v2.9.3 | checkWellbeing() | heart-logic.js |
| v2.9.3 | handleMistake() | heart-logic.js |
| v2.9.3 | memoryBoundary() | heart-logic.js |
| v2.9.4 | think() 4步→8步 | heartflow.js |
| v2.9.4 | checkEvenhandedness() | heart-logic.js |
| v2.9.4 | checkCitation() | heart-logic.js |
| v2.9.4 | searchPriority() | heart-logic.js |
| v2.9.5 | OutputChecklist（输出前4步检查） | output-checklist.js |
| v2.9.5 | PreferenceGuard（三类型偏好引擎） | preference-guard.js |
