@marcfargas/pi-heartbeat
为Pi智能体提供非阻塞定时器与心跳，替代sleep
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@marcfargas/pi-heartbeat。 它的用途是：为Pi智能体提供非阻塞定时器与心跳，替代sleep 完整的 Skill 内容见：https://321skill.com/skills/marcfargas-pi-heartbeat/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我在当前Pi智能体项目里引入@marcfargas/pi-heartbeat，实现30秒间隔的非阻塞心跳上报”，它会自动完成包安装、导入语句添加，并生成符合要求的心跳回调模板。
对AI说：“把代码里所有sleep实现的定时等待替换成pi-heartbeat的非阻塞定时器”，它会定位所有sleep调用，逐一替换为对应API并调整逻辑避免阻塞。
介绍
不少开发者在开发Pi智能体时，习惯使用sleep实现定时等待、心跳保活逻辑，但sleep属于阻塞式调用，会卡住智能体主事件循环，导致其他并发任务无法及时响应，难以支撑多任务并行的智能体运行需求。 该工具以npm包形式分发，引入项目后可快速创建非阻塞的定时任务、心跳检测实例，无需复杂的异步代码改造，只需调用对应API即可配置触发间隔、回调函数，心跳异常时还支持自动触发预设的告警或重连逻辑。 适合基于Pi框架开发智能体的Node.js开发者、需要搭建常驻运行自动化智能体服务的技术人员、负责智能体长连接保活与定时任务调度的工程团队。 使用前需确认当前项目的Pi框架版本与包的兼容要求，心跳间隔建议根据业务实时性需求合理配置，避免间隔过短产生不必要的性能开销。
核心特点
不同于通用Node.js定时库或原生sleep的阻塞式实现，它专门适配Pi智能体的运行模型，所有定时、心跳逻辑完全不阻塞主事件循环，无需开发者额外封装异步调度逻辑。
注意事项
仅适配Pi框架下的智能体开发场景，无法直接用于非Pi体系的通用Node.js服务。
常见问题
这个包可以在普通Node.js项目中使用吗？
它专为Pi智能体设计，普通Node.js项目建议使用通用定时库。
使用这个包需要自己编写业务逻辑吗？
它仅封装了非阻塞调度能力，触发后的业务回调逻辑仍需自行实现。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/marcfargas-pi-heartbeat/raw/index.md 读取 @marcfargas/pi-heartbeat 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/marcfargas-pi-heartbeat/raw/index.md（查看排版版本）