前言¶
在 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
