@bacnh85/pi-cron

中文文档
0.4.0发布于 2026/10/11MIT近 30 天下载 3417

Pi的排期工作——在Pi运行时向活会话发射快活的克龙式工作,逾期的赶超和Crontab出口满足24/7的需求.

中文使用文档
文档目录4 节
  1. 安装
  2. 使用量
  3. 配置
  4. 页:1

@bacnh85/皮克龙

为 Pi 排定的工作—— 即时启动的克龙式工作 进入现场 第二届会议 在 pi 运行时, 有过期的补尾和 crontab 导出 24/7报道.

安装

pi install @bacnh85/pi-cron

使用量

这个 cron 工具(和 /cron 命令)管理存储在 <agentDir>/cron/jobs.json数字 :

行动它会做什么
add创建任务 : name, (中文(简体) ), schedule (5-场克龙), prompt (作为独立转弯而开火),可选 cwd选项 model 编号 : thinking 针.
remove删除工作 name。 。 。 .
list显示名称、 调度、 下一次/ 最后一次射击、 启用、 最后运行状态( L)[ok] 编号 : [FAIL: reason]),型号针.
run现在就手动解雇一个工作( 也是失败工作的重试) .
enable 编号 : disable切换工作. disable 暂停( 时间表保留; 由勾选和导出跳过); ; enable 重新计算以后的下一起起起火——没有出人意料地赶上起火. add 还接受 enabled:false 创造残疾工作.
test预览一个时刻表接下来的5个起火时间.
logs跟踪一份工作的最新运行日志——看看一个失败的运行打印.
export打印 crontab 线条, 因此工作也会在 pi 关闭时运行( 无头) pi -p --no-session记录 <agentDir>/cron/logs/) (中文(简体) ).

示例 "每天9点检查CI状态 总结失败" – 报告 代理转换为 cron add schedule:"0 9 * * 1-5" prompt:"...",核实 与 test,并添加该词.

执行模式 : a 30s的流程中计时器在后续转折时点燃应完成的工作 在公开会话中;过去到期的工作在下个勾勾上追上一次(如果pi是) (按预定时间关闭)。 工作只在 pi 进程打开时运行 – 使用 export + 系统 crontab 用于未计时调度.

模式和思维针( Hermes- style) : 设定 model:"provider/id" 和(或) thinking:"high" 在工作,它运行 自身 pi 进程中的无头 (单位:千美元)pi -p --no-session --model … --thinking …)而不是现场会议—— 用于廉价/快速模型或孤立运行。 输出记录在下 <agentDir>/cron/logs/ (默认为10分钟,可通过cron.timeoutMs配置)并交付结果 作为后续行动回到会话中. export 包括克龙塔b中的指针 线条。 无头儿童与 PI_CRON_DISABLED=1: cron 排程器为 在他们内部(没有父母/子女种族) jobs.json)和工作变异 (单位:千美元)add编号 :remove编号 :run编号 :enable编号 :disable)被拒绝——被开除的跑道永远不能 计划更多工作.

循环守护 : 30多岁,火力全开, add编号 :remove编号 :run编号 :enable编号 :disable 拒绝。 这是一个时间窗口,而不是飞行中豁免——一发火的转弯运行 超过30s仍然可以变异. 将已发射的提示作为信任输入处理, 与 任何工具呼叫会话.

工作目录 : 未绑定的工作只交付给一个 cwd 匹配的会话 工作记录 cwd在别处开幕的会话跳过火并标记它 [FAIL: cwd mismatch …] (可见于 cron list 编号 : logs)而不是运行 启动错误的项目 。 对于交叉阴道可靠性,针 model编号 :thinking - 被钉住的工作没有头 job.cwd 无论什么 会议先勾选.

每个代理目录的单会话 : 工作商店没有跨进程锁. 运行多个共享代理目录的 pi 会话可以双发任务或 丢失同时编辑 – 每个代理目录使用一个 cron 活动会话, 或给定 每届会议 PI_CODING_AGENT_DIR。 。 。 .

配置

settings.json数字 :

{ "cron": { "enabled": true, "tickMs": 30000, "timeoutMs": 10800000 } }
  • enabled ——调度器全局杀机开关.
  • tickMs ——勾接间隔(已声明为5s-10min).
  • timeoutMs ——无头(被钉住)孩子的硬帽跑步——SIGTERM出道后出道,SIGKILLL出道后为5s恩典(Clammped 1min–24h,默认为10min). 举起它做长期固定的工作.

页:1

  • 每一个被解雇的工作都会把模型符号花在真正的转弯上——保持快感.
  • 时间表验证和火灾时间数学使用 cron-parser。 。 。 .
  • 无头颅儿童与跑 HERDR_ENV 剥去(和 PI_CRON_DISABLED=1)),因此他们从不自动删除到herdr panes——克龙工作的子代理总是在运行过程中.

版本与发布记录

@bacnh85/pi-cron 共发布 13 个版本,首次发布于 2026/09/10;过去 12 个月发布了 13 个版本。

版本发布日期距今
0.4.0latest2026/10/1127 天前
0.3.102026/09/301 个月前
0.3.92026/09/281 个月前
0.3.82026/09/271 个月前
0.3.72026/09/261 个月前
0.3.62026/09/241 个月前

关于 @bacnh85/pi-cron 的常见问题

@bacnh85/pi-cron 是什么?

Pi的排期工作——在Pi运行时向活会话发射快活的克龙式工作,逾期的赶超和Crontab出口满足24/7的需求.

如何安装 @bacnh85/pi-cron?

在项目目录运行 npm install @bacnh85/pi-cron,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:typebox(*)、@earendil-works/pi-coding-agent(>=0.84.3 <1.2.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@bacnh85/pi-cron 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/bacnh85__pi-cron 是否存在。

@bacnh85/pi-cron 可以商用吗?

@bacnh85/pi-cron 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@bacnh85/pi-cron 的下载量有多少?

根据 npm 官方下载统计,@bacnh85/pi-cron 在 2026/10/08 – 2026/11/06 这 30 天内被下载 3,417 次,日均约 114 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@bacnh85/pi-cron 还在维护吗?

最新版本 0.4.0 发布于 2026/10/11(27 天前);至今共发布 13 个版本,其中过去 12 个月发布了 13 个;首次发布于 2026/09/10。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。