HeartFlow 架构真机校验
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_fdb96f95/heartflow-architecture-optimization。
技能介绍
问题从哪来
HeartFlow 这类多引擎 Node 项目在大量合并或模板生成后,很容易出现:语法能通过 node --check,但运行时才是「假引擎」——src/planner/ 里对象键里塞了非法正则、公式引擎仍留着 TODO、同理检索只是空壳,module.exports 名字还和 require 侧对不上。若带着这些状态进入训练或 AI-人协作联调,排障成本会指数上升。
技能如何推进清理
这套流程按可验证顺序收口,而不是泛泛「重构架构」:
- 语法扫描:遍历全部
.js,识别模板泄漏导致的非法 token(例如 planner stub 里对象键含 regex),整文件用合法 stub 类覆盖,而不是零散 patch。 - 动态加载检查:对核心引擎做真实
require/实例化,确认不是只过静态检查。 - 占位审计与替换:按优先级处理——
src/formula/formula-engine.js(约 76/88/100 行 TODO)、src/emotion/emotion-optimizer.js(同理检索)、其余 warn-only stub 可放低优先级;同理检索可参考已有路径:models/build_empathy_model.py→models/empathy_retrieval.json→ 在 optimizer 中接入generateEmpatheticResponse。 - 导出/导入对齐:例如将错误的
DecisionOptimizer导出改为与调用方一致的DecisionEngine,消除X is not a constructor。
用户偏好用紧凑表格汇总步骤与状态,而不是冗长逐步复述。
边界与注意点
- 批量公式生成后若出现大量
f(params)占位,需单独清理(与 heartflow-batch-upgrade 中的 Pitfall 9 相关),本技能会提醒但不要求一次做完所有批量升级。 - 低优先级 stub 若仅为 warn-only,可暂不替换;重点是训练/测试前公式引擎与情感相关路径必须能真跑。
- Stub 文件若含非法 token,应 write 整文件,避免 patch 残留坏片段。
使用场景
- 大分支合并后 planner 目录新增大量 stub,需要在加 AI-人协作能力前确认各引擎能真实 require 并实例化
- 用户明确要求「先优化架构,保证引擎和代码真实有效运行」时,按语法扫描→动态加载→占位审计顺序出检查表
- 训练或全链路测试前发现 formula-engine 多处 TODO 或 emotion-optimizer 同理检索未实现,需按文件优先级逐项替换占位
- 运行时出现 `X is not a constructor`,怀疑导出类名与 require 侧不一致,需要对照全项目 exports/imports 统一命名
适合人员
- 维护 HeartFlow 多引擎仓库的 Node 开发者,合并后要对 planner/formula/emotion 模块做上线前真机校验
- 接手含大量模板生成 stub 的代码库的技术负责人,需要在接入新能力前堵住「仅语法通过」的技术债
- 负责情感/公式子系统的工程师,要把 empathy 模型构建与 `generateEmpatheticResponse` 接入从文档步骤落到可测代码
- 做发布门禁的工程师,希望在 CI 或人工检查清单里固定「动态加载 + 导出对齐」而不仅跑 linter