前言¶
在 Agent 工作流里，常见做法是把「要不要继续、下一步走哪条分支」交给外层编排脚本或宿主 IDE 的规则。若你希望决策逻辑以独立进程常驻、启动尽量快、且不额外拉一堆运行时依赖，就需要一个可单独启停的本地引擎，而不是每次对话里临时拼装。
下面介绍 SkillHub 上的 heartflow（坐标 @user_fdb96f95/mark-heartflow）：官方简介将其定位为 HeartFlow v0.13.163 自主决策引擎，强调零依赖与约 26ms 启动；Skill 包在 SkillHub 当前展示版本为 v11.2.13。
这是什么¶
heartflow 是社区来源（community）的 ai-agent 类 Skill，由发布者 user_fdb96f95 维护。公开资料中的定位可以概括为：在本地以守护进程方式运行 HeartFlow 决策引擎，通过 start.sh 完成启动、状态查看、健康检查与停止。
它主要解决「决策引擎与 Agent 宿主解耦、可脚本化运维」这一类问题：安装后落在固定目录，用一组 shell 子命令管理生命周期，而不是把引擎细节写进每次提示词。
核心功能（据官方页面可核实部分）¶
官方简介与 SkillHub 页面目前能核对到的能力如下，未在资料中出现的行为不作延伸说明。
- 自主决策引擎：HeartFlow v0.13.163，作为 Skill 对外宣称的核心运行时能力。
- 零依赖启动：页面强调零依赖；具体实现细节需以安装包内文件为准，本文不展开未公开的结构。
- 快速启动：官方给出约 26ms 启动量级（为页面文案，非独立 benchmark 报告）。
- 守护进程与运维子命令：通过
start.sh支持 daemon 模式、status、health、stop。 - 无需 API Key：SkillHub 标签为
requires_api_key=false。
安装与启用¶
通过 SkillHub 安装 Skill 包¶
SkillHub 页面提供的安装方式是：让 AI 按 SkillHub 安装说明 安装坐标 @user_fdb96f95/mark-heartflow。可将下面提示词发给支持 Skill 安装的助手：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_fdb96f95/mark-heartflow`。
安装完成后，运行时目录以官方一键启动说明为准：
~/.hermes/skills/ai/mark-heartflow-skill
Cursor、Codex CLI、Claude Code 等宿主若各自有 Skill 加载路径，应以你当前环境安装结果为准；公开页面未逐项区分各 IDE 的差异，此处不臆造配置项。
启动与管理进程¶
进入上述目录后，用 start.sh 管理引擎。下面命令与 SkillHub / API 页面一致。
cd ~/.hermes/skills/ai/mark-heartflow-skill
./start.sh # daemon 模式
./start.sh status # 查看状态
./start.sh health # 健康检查
./start.sh stop # 停止
先做安装，再 cd 到目录执行 ./start.sh 拉起 daemon；日常用 status / health 确认进程是否正常，停服用 stop。
典型用法¶
可复现的最小流程只有两步：安装 Skill，再按官方脚本启停。
- 按 SkillHub 说明安装
@user_fdb96f95/mark-heartflow。 - 执行：
cd ~/.hermes/skills/ai/mark-heartflow-skill
./start.sh
./start.sh health
health 用于确认引擎在守护进程模式下可用；若异常，再用 ./start.sh status 查看状态，必要时 ./start.sh stop 后重新 ./start.sh。
heartflow 遵循通用 SKILL.md 格式；与具体 Agent 的对话编排如何挂接 HeartFlow，应以 Skill 包内文档为准。当前公开页面未给出更长的对话示例或 API 字段表，本文不补充未出现的接口名或配置键。
适用场景与注意¶
适合谁
- 需要在本地常驻一个「自主决策」引擎，并用脚本做健康检查与停启的 Agent 开发者。
- 希望 Skill 侧声明 不需要 API Key（
requires_api_key=false），减少密钥配置步骤的团队或个人。
限制与注意
- 公开资料对决策规则、输入输出协议描述较少；接入业务前应在安装目录阅读 SKILL.md 及随包文档。
- SkillHub 展示包版本（v11.2.13）与简介中的 HeartFlow 引擎版本（v0.13.163）并存，排查问题时建议两者都记下。
- 截至页面信息：分类 ai-agent，社区来源；SkillHub 统计为评分 100000、下载 1140（以 SkillHub 页面为准，会随时间变化）。
结尾¶
heartflow 把 HeartFlow 自主决策引擎收成可一键 daemon 启停的本地 Skill，路径与命令在官方说明里已经写全。若你要在 Agent 栈里加一层独立决策进程，可从 SkillHub 安装 @user_fdb96f95/mark-heartflow，再按 start.sh 做状态与健康检查。
官方入口：
- SkillHub：https://www.skillhub.cn/skills/user_fdb96f95/mark-heartflow
- API：https://api.skillhub.cn/user_fdb96f95/mark-heartflow
