# @abhishek944/pi-tasks 中文文档

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

版本：0\.15\.0
npm 元数据更新时间：2026-10-24T20:50:31.185Z
中文译文更新时间：2026-11-06T22:10:37.803Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40abhishek944/pi-tasks
原文对照：https://npmcn.com/package/%40abhishek944/pi-tasks/?lang=original

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

- 包体积（解压后）：242 kB，51 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.19\.0
- 运行依赖：0 个
- peer 依赖：typebox \*，@earendil-works/pi-ai \*，@earendil-works/pi-tui \>=0\.85\.1，@earendil-works/pi-coding-agent \>=0\.85\.1
- 首次发布：2026-09-15T09:41:22.851Z
- 最新版本发布：2026-10-24T20:50:31.009Z
- 近 30 天下载量：2275（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：18（近 12 个月 18 个）

## 中文简介

会话范围工作和待办事宜跟踪 Pi.

## 安装

```sh
npm install @abhishek944/pi-tasks
```

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

## README

# pi 任务

用于会话范围工作和待办事宜跟踪的 Pi 扩展名 .

它补充说:

-   `WorkCreate`, (中文(简体) ), `WorkList`, (中文(简体) ), `WorkUpdate`,以及 `WorkDelete`
-   `TodoCreate`, (中文(简体) ), `TodoList`, (中文(简体) ), `TodoUpdate`,以及 `TodoDelete`
-   `TaskTimeExport` 财务报告和审定财务报表 `TaskTimeImport` 用于计量授权工作
-   `/works`,之后模拟的详细浮动仪表板 `pi-loop-monitor`是因为 `/monitors`
-   紧凑的浮上右上方面板,上面有工作名称和待办事宜名称、完成百分比和测量的活动时间
-   主对话指导,将正常要求的工作贯穿每个 Pi 技能,要求每个授权代理在分配工作前建立自己的工作和托多ID

工作和待办事宜跟随活跃的Pi会话分支. 伪造或导航会话树恢复该分支的状态. `/ask` 财务报告和审定财务报表 `/btw` 对话不更新作品,待办事宜,循环,或显示器.

协调模式有意是小的:一个作品是一组具有共同上下文且无地位的任务,一个待办事宜是具有自身地位的具体步骤,一个显示器运行一个长寿的背景指令,一个循环调度一个未来或反复唤醒的时间. 循环和监视器仍为 `pi-loop-monitor`。 。 。 .

跟踪指南需要在全球安装 `implement` (c) 在保留专门技能权限的同时,将技能作为每个跟踪工作,包括工人-当地工作的协调工作流程。 Pi-tasks拥有记录/进展, `implement` 拥有任务所有权决定和工艺品路径,以及 `herdr` 拥有授权代理生命周期。 使用存储器的根状文物 `var/<sessionId>/<workId>/<taskId>/`;孩子将自己的会话/工作/任务路径嵌入到父任务目录下. 每个任务记录 `self` 或者说 `delegate` 有个原因 `taskInfo`。这些是指令,而不是运行时间执行、共享跨会话记录或自动技能安装器。 缺少所需的技能、工具或ID 阻断执行 `/ask`编号 :`/btw` 仍在工作流程之外。 见 [使用指南](https://npmcn.com/package/%40abhishek944/pi-tasks/docs/USAGE_GUIDE.md#shared-workflow-and-artifacts) 和完整的合同.

## 安装

```bash
pi install npm:@abhishek944/pi-tasks
```

重新启动 Pi 或运行 `/reload`。 。 。 .

## 使用

扩展引导 Pi 为开始或继续工作的正常请求自动管理工作. 您也可以直接调用工具 :

```text
WorkCreate workName="Add task tracking" workInfo="Detailed goal, scope, constraints, and expected outcome"
TodoCreate workId="W1" taskName="Implement state" taskInfo="Detailed task context and expected result" status="active"
TodoUpdate taskId="T1" working=true
TodoUpdate taskId="T1" completionPercent=40 taskInfo="The state changes are implemented; rendering and verification remain."
TodoUpdate taskId="T1" status="completed" taskInfo="Implementation is complete; typecheck and build passed."
WorkUpdate workId="W1" workInfo="Task tracking is implemented; state and UI checks passed."
```

运行 `/works` 完全检查 `workInfo` 财务报告和审定财务报表 `taskInfo` 在交互式的覆盖中.

作品是没有地位的收藏. 任务使用四个状态 : `active` (默认), `blocked`, (中文(简体) ), `completed`,以及 `cancelled`启用 `blocked` 一旦下一步必须等待代理输出,审查,外部响应,用户输入,权限,或者其他障碍. 供应 `blockedReason` 当创建被封锁的任务或进入被封锁状态时,解释依赖性并恢复状态; 保留进度。 原因在其他被屏蔽的编辑过程中被保留,离开被屏蔽时被清除. 没有任何理由的旧记录仍然可以读取。 父母委托的任务在等待工人产出时被冻结;工人自己的地方任务可能很活跃。 AgentCreate 在成功创建后自动屏蔽母任务,保留其进度. 对于手工授权,请标记明确被阻断的母任务. 当依赖解决并恢复工作时,将被封锁的任务恢复为活动。 状况本身并没有安排一个觉醒的时间。 遗留任务保存状态 `planned` 财务报告和审定财务报表 `pending` 恢复为活动; 忽略旧的工作状态。 工作工具不再接受状态或状态过滤器. 取消整个工作,取消剩余的任务; WorkDelete仍然删除收藏及其任务.

Pi报告通过现有 `TodoCreate`编号 :`TodoUpdate` 使用可选工具 `completionPercent` (从0到100的整数,或 `null` 页:1 工作进展是未取消任务的平均平均数,四舍五入,而不是已完成任务的一小部分。 例如,任务值100,40,0,0给出工作进度35%. 缺失的估计使工作进度不明(`—`);被封锁的任务保留其估计值. 已完成的任务为100%;报告100个未完成的状况被拒绝。 对于较长的任务,指导要求皮在大约5至10个有意义的工作步骤或里程碑之后列入临时估计数,而不是等待完成。 估计数仍然是可选的,必须有证据支持;这是指导,而不是强制执行的时间表。 这些百分比是估计数,而不是时间预测。 浮动面板将百分比保留在保留右边一栏中,如此长的名称无法隐藏。 现有的键盘控制不变.

### 活动任务时间

小组和 `/works` 储备金 **完成** 财务报告和审定财务报表 **时间** 栏。 选择您正在实际工作的任务 `TodoUpdate taskId="T1" working=true`它必须活跃并且有 `owner: self` 详细内容。 选择另一个任务暂停上一个任务 。 使用 `working=false` 暂停而不改变状态。 在每个新运行的开头再次选择; 仅仅创建或标记一个活动的任务从不启动计时器 .

扩展用途 `Date.now()` 添加工作间隔,包括思考和前景工具。 闲置时间, 代理循环之间的本地重试延迟, 屏蔽用户提示不计数 。 完成, 屏蔽, 取消, 所有权更改, 中止, 关闭自动停止计时器 。 已保存的总数幸存了重新加载和分支导航;恢复的任务被暂停,离线时间从不计数. 运行时间有一个 `▶` 标记。 总和在间隔边界上保存, 而不是每个显示勾选 。 强制进程杀死会失去当前未保存的间隔 。 屏蔽即时排除需要一个 Pi 主机来释放 `ui_prompt_start`编号 :`ui_prompt_end`; 旧主机仍然暂停在代理- loop 边界上 .

新任务开始于 `0s`; 没有显示时间的历史任务 `—` 直到测量, 不试图重建更早的时间。 工作时间是每个任务所衡量的努力的总和,包括被取消的任务;任何未知的任务都使得总和不明. 它不是墙上时间,也不是对剩余时间的估计。 每个受委托的代理人都会为自己的本地任务提供时间. Agent Create提供时间报告路径;工人打电话 `TaskTimeExport` 完成后的任务编号。 父母打电话来 `TaskTimeImport` 拥有授权的任务ID。 母任务和工作包括量度的努力,而不计等待或改变地位。 在进出口之前,下放的工作显示 `—`。重复进口取代了累积快照而不是再次添加快照。 见 [授权时间](https://npmcn.com/package/%40abhishek944/pi-tasks/docs/USAGE_GUIDE.md#delegated-timing)。列表和复制的Markdown包含相同的总数.

小组和 `/works` 前缀带有ID的工作名和带有ID加所有权的任务名,例如 `[W1] Locate subagent restrictions` 财务报告和审定财务报表 `[T1] [self] Inspect the implement skill`任务所有权来自明确 `owner: self` 或者说 `owner: delegate` 在行的开头声明 `taskInfo`; 保存在更新上. 裁决缺失或冲突表明 `[unassigned]`,不重写存储的名字或旧记录。 在赫尔德内部, `AgentCreate` 自动将其任务链接到下划线, 可点击 `[delegate]` 徽章; 打开的动作也下划线。 见 [代表窗格链接](https://npmcn.com/package/%40abhishek944/pi-tasks/docs/USAGE_GUIDE.md#delegate-pane-links) 用于链接和键盘访问.

面板默认为浮上右上方布局. 压缩头不再显示会话ID 。 除了 Copy 外, 还有一个下划线的 Open会话动作, 使用配置的命令打开此代理服务器的文物文件夹, 包括现有的嵌入式授权路径; 如果不存在, 它会创建 `var/<sessionId>/`。现有的 Open 仍然打开仓库。 使用 `/works-panel open-session` 不使用鼠标输入。 窄头缩短最小化/最大化 `[-]`编号 :`[+]`编辑 `/works` 仪表盘标题保持不变。 它的顶端边框中心是当前寄存器的 Git 分支, 以及舞台/ 未舞台/ 未跟踪文件计数, 与一秒缓存同步刷新 。 清理仓库显示 `clean`。在全屏 TUI 模式下,其标题栏有可点击的 Copy, Open, 并最小化/ 最大化动作, 您可以直接用鼠标方向盘滚动溢出行 。 打开默认值到 `cursor .`; 配置 `pi-tasks.openCommand` 用于使用其他工具(参见 [配置](https://npmcn.com/package/%40abhishek944/pi-tasks/docs/USAGE_GUIDE.md#configure-open-and-open-session)) (中文(简体) ). 打开 `/works` 检查键盘上的每行或副本。 使用 `/works-panel minimize`, (中文(简体) ), `/works-panel maximize`,或 `/works-panel open` 当鼠标输入不可用时。 单位 `/works`按钮 `o` 以运行已配置的命令。 切换布局 `/works-panel floating`, (中文(简体) ), `/works-panel widget`,或 `/works-panel off`。 。 。 .

## 任务所属代理人

`AgentCreate`, (中文(简体) ), `AgentList`, (中文(简体) ), `AgentStatus`, (中文(简体) ), `AgentOutput`, (中文(简体) ), `AgentSend`, (中文(简体) ), `AgentInterrupt`, (中文(简体) ), `AgentClose`,以及 `AgentFocus` 直接使用 paneId 的简单 Herdr CLI 包装器。 AgentCreate还注册了pi-loop-monitor并返回ID并加上一个已准备好的任务;确认MonitorList显示已准备好订阅,然后AgentSend it. `onSignal` 提醒父为工人状态变化; 可选 `onDone` 手柄监视终止,而不是任务完成。 没有登记、启动收据、流程检查或自动收回。 创建/关闭需要现代的Pi嵌入调用并更新pi-loop-monitor元数据;不依赖pi-herdr-agents. 见 [代理工具](https://npmcn.com/package/%40abhishek944/pi-tasks/docs/USAGE_GUIDE.md#agent-tools)。 。 。 .

## 可选自动续读

在 Pi 1. 2. 0 或更新时, 启用您的全球或可信任的项目中未完成的工作续作 `settings.json`数字 :

```json
{
  "pi-tasks": {
    "autoContinue": { "enabled": true }
  }
}
```

它默认关闭。 奥米 `maxContinuations` ,或添加正整数,例如 `"maxContinuations": 10` 盖住它。 无限制的续作可以在未完成的记录保留的情况下无限期地消耗令牌;人工中止和其他停止条件仍然适用. 在正常的用户请求运行成功或失败后,Pi会继续,同时当前会话分支上所有Works上的任何任务都会被激活. 被屏蔽,完成或被取消的任务不会引发续作;遗留计划/待完成的任务状态恢复为活作. 逃脱/破坏会停止流动;只有新接受的主交互或RPC会运行重装. 扩展提醒不会重新武装它或者重设限制 。 限制计算每个新主用户运行所要求的续作,而不是美元或工具呼叫. 已排队的引导/后续输入不重设 。 编辑设置后重新装入 .

自动接续使用皮的原生前定居边界,排队后的工作,再试,并收紧. 失败运行不解除它: 在 Pi 的本土重试完成后, 未完成的记录要求再次续作 。 它没有可用的跟踪工具,也没有仅仅因为恢复会话而开始工作。 它从不改变任务状态,也不能独立证明完成。 旧主机保留了没有此功能的普通跟踪.

见 [使用指南](https://npmcn.com/package/%40abhishek944/pi-tasks/docs/USAGE_GUIDE.md) 财务报告和审定财务报表 [参考文献](https://npmcn.com/package/%40abhishek944/pi-tasks/docs/REFERENCE.md)。 。 。 .

## 发展

```bash
npm run lint
npm run typecheck
npm run build
npm run audit:production
```

## 常见问题

### @abhishek944/pi-tasks 是什么？

会话范围工作和待办事宜跟踪 Pi\.

### 如何安装 @abhishek944/pi-tasks？

在项目目录运行 npm install @abhishek944/pi-tasks，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：typebox（\*）、@earendil-works/pi-ai（\*）、@earendil-works/pi-tui（\>=0\.85\.1）、@earendil-works/pi-coding-agent（\>=0\.85\.1）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @abhishek944/pi-tasks 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @abhishek944/pi-tasks 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @abhishek944/pi-tasks 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.19\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @abhishek944/pi-tasks 可以商用吗？

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

### @abhishek944/pi-tasks 的下载量有多少？

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

### @abhishek944/pi-tasks 还在维护吗？

最新版本 0\.15\.0 发布于 2026/10/25（13 天前）；至今共发布 18 个版本，其中过去 12 个月发布了 18 个；首次发布于 2026/09/15。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。