# @bacnh85/pi-cron 中文文档

规范地址：https://npmcn.com/package/%40bacnh85/pi-cron/

版本：0\.4\.0
npm 元数据更新时间：2026-10-11T03:32:30.545Z
中文译文更新时间：2026-11-07T17:53:36.934Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40bacnh85/pi-cron
原文对照：https://npmcn.com/package/%40bacnh85/pi-cron/?lang=original
项目主页：https://github.com/bacnh85/pi-extensions/tree/main/pi-cron
源码仓库：https://github.com/bacnh85/pi-extensions

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：51.9 kB，8 个文件
- TypeScript 类型：未声明
- 运行依赖：1 个
- peer 依赖：typebox \*，@earendil-works/pi-coding-agent \>=0\.84\.3 \<1\.2\.0
- 首次发布：2026-09-10T01:37:47.841Z
- 最新版本发布：2026-10-11T03:32:30.366Z
- 近 30 天下载量：3417（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：13（近 12 个月 13 个）

## 中文简介

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

## 安装

```sh
npm install @bacnh85/pi-cron
```

也可以使用：`pnpm add @bacnh85/pi-cron`、`yarn add @bacnh85/pi-cron`、`bun add @bacnh85/pi-cron`

## README

# @bacnh85/皮克龙

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

## 安装

```bash
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`数字 :

```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 是什么？

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 和提交记录判断。