pi-holdpty
提供可监控、可追踪的分离式终端会话管理。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-holdpty。 它的用途是：提供可监控、可追踪的分离式终端会话管理。 完整的 Skill 内容见：https://321skill.com/skills/pi-holdpty/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我启动一个后台进程来执行数据库备份脚本，并在输出中出现‘ERROR’或进程结束时通知我。” 它会引导你使用 pi-holdpty 创建一个分离的PTY会话，设置匹配“ERROR”的正则监控器，并配置退出通知，最后提供集成了事件处理器的代码片段。
介绍
pi-holdpty 解决了在后台运行长时间终端任务时，难以监控其状态、捕获关键输出或管理会话所有权的痛点。它允许你将终端会话（PTY）分离到后台运行，并通过正则表达式监控其输出，在匹配到特定模式或进程退出时发送通知，同时以NDJSON格式记录事件。
使用方式通常是通过npm安装后，在代码中引入并创建会话，为其设置监控规则和事件处理器。它提供了编程接口来启动、管理和响应这些分离的会话活动。
该工具非常适合需要在服务器上部署后台脚本、运行自动化构建或测试流水线，并希望获得结构化事件日志和状态通知的开发者和运维人员。
使用建议是，在需要可靠的后台任务执行和精细状态追踪的自动化场景中集成此工具。注意事项包括需要一定的Node.js编程基础来配置事件监听和处理逻辑，并且其功能深度依赖于对PTY会话的理解。
核心特点
作为 holdpty 的分支，pi-holdpty 核心增强了与 Pi 扩展的集成能力，并内置了基于正则表达式的输出监控和结构化的 NDJSON 事件日志，提供了更精细的会话所有权追踪。
注意事项
不适合需要简单、交互式或一次性命令行任务的场景，对不熟悉 Node.js 和 PTY 概念的初学者有一定上手门槛。
常见问题
pi-holdpty 和原版 holdpty 有什么区别？
主要增加了与 Pi 扩展的集成支持，并强化了事件输出（NDJSON）和所有权跟踪功能。
这个工具需要一直运行一个 Node.js 服务吗？
是的，它通常作为一个 Node.js 服务或模块集成在您的应用中，用于创建和管理后台 PTY 会话。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-holdpty/raw/index.md 读取 pi-holdpty 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-holdpty/raw/index.md（查看排版版本）