# @aliou/pi-processes 中文文档

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

版本：0\.13\.5
npm 元数据更新时间：2026-11-03T22:00:31.808Z
中文译文更新时间：2026-11-06T07:00:12.868Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40aliou/pi-processes
原文对照：https://npmcn.com/package/%40aliou/pi-processes/?lang=original
项目主页：https://github.com/aliou/pi-processes#readme
源码仓库：https://github.com/aliou/pi-processes

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

- 包体积（解压后）：516 kB，123 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.19\.0
- 运行依赖：3 个
- peer 依赖：typebox \*，@earendil-works/pi-ai \*，@earendil-works/pi-tui \*，@earendil-works/pi-coding-agent \>=1\.4\.0
- 首次发布：2026-01-25T21:44:28.539Z
- 最新版本发布：2026-11-03T22:00:31.527Z
- 近 30 天下载量：4242（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：54（近 12 个月 54 个）

## 中文简介

![banner](https://assets.aliou.me/github/aliou/pi-processes/banner-v0.10.x.png)

## 安装

```sh
npm install @aliou/pi-processes
```

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

## README

![banner](https://assets.aliou.me/github/aliou/pi-processes/banner-v0.10.x.png)

# pi 进程

管理来自 Pi 的背景进程而不阻碍对话 .

这个扩展让Pi在对话持续期间保持了长期运行的命令活性. 它对dev服务器,测试监视器,本地API,构建,和日志尾巴都有用.

## 让皮在进程运行时继续工作

当任务需要长期运行的指令时,Pi可以自己在背景中启动,并不断帮助其他工作.

[![Pi starts a long-running process and keeps working](https://assets.aliou.me/pi-extensions/demos/processes/v0.10.0/agent-starts-processes.gif)](https://assets.aliou.me/pi-extensions/demos/processes/v0.10.0/agent-starts-processes.mp4)

也就是说Pi可以:

-   启动 dev 服务器并保持编码
-   在测试监视器修正失败时保持运行
-   在检查日志时运行本地 API
-   在不屏蔽对话的情况下监视构建输出

然后,您可以检查, 钉住,停止, 或从UI清除这些过程.

## 安装

从 npm :

```bash
pi install npm:@aliou/pi-processes
```

从 gi:

```bash
pi install git:github.com/aliou/pi-processes
```

## 皮如何保持循环

Pi 不等待背景进程 。 在它开始之后,它继续帮助 其余的工作, 并被自动带回来 当一些事情发生:

-   在日志中显示准备状态标记( 服务器打印“ 准备” )
-   在日志中出现错误(构建打印出类型错误)
-   进程退出,无论是成功还是失败,还是被杀死

这样,Pi就可以启动dev服务器,然后继续编码,或者运行一个测试监视器,并在测试失败时作出反应,而不睡觉或投票. 如果一只表起火太频繁,皮可以不重启过程而安静.

## 打开进程面板

使用 `/ps` 打开主进程面板。 它显示运行和完成的进程,并有最新的输出预览. 预览会在最新的一页上打开,这样就可以在不滚动的情况下看到活的活动.

从那里你可以:

-   查看运行和完成的进程
-   检查最近的产出
-   将进程刻入码头
-   杀死正在运行的进程
-   清除已完成的条目

## 检查日志

使用 `/ps:logs [id]` 打开一个进程的日志覆盖。 查看器是每个进程缓存的,因此切换分页保留了滚动位置并遵循模式.

当 Pi 启动服务器、 监视器或本地 API 时, 这是有用的, 您想要更详细地跟踪它正在做的事情 .

## 控制码头

使用 `/ps:dock [expand|collapse|close]` 来控制码头的能见度,或者单击码头在倒塌和被扩展之间切换.

码头给你一个紧凑的现场视野 而不离开对话.

## Pin 1 进程

使用 `/ps:pin [id]` 使码头专注于一个过程.

当一个进程比其他进程更重要时,例如dev服务器或测试监视器时,这样做是有用的.

没有争吵,皮会显示一个拾取者.

## 停止和明确程序

使用 `/ps:kill [id]` 停止运行过程,以及 `/ps:clear` 从面板中删除已完成的条目,并释放日志存储.

`/ps:kill` 等待进程实际退出(或超时),所以它报告的结果反映了所发生的情况. 没有争吵,皮会显示一个拾取者.

`/ps:clear` 从不接触活的过程.

## 保持状态行查看

启用状态部件 `/ps:settings` 以显示编辑器下方的紧凑行。 Live 进程显示为状态点加名称; 完成进程折叠为 `✓ N done`, (中文(简体) ), `! N failed`,以及 `■ N killed` 摘要(在下一个进程开始之前,最近的失败按名称显示). `+N more` 当线不合适时会出现溢出.

默认已禁用 。 当进程列表为空时, 部件会重排大小并清除它 .

## 向进程发送输入

使用 `process` 工具为 `action: "write"` 将字节发送给运行中进程的 stdin。 这就是您如何驱动交互服务器,REPLs,以及期望在启动后输入的CLI.

过 `input` 用于编写字节并设定 `end: true` 以关闭 stdin(例如将 EOF 信号给等待进程).

## 调整设置

使用 `/ps:settings` 以配置扩展名。 项目设置 `.pi/extensions/processes.json` 只在 Pi 信任工程后应用 . 未信任的项目文件保持不变, 本地标签显示 “ 项目不可信”而不是可编辑设置 。 使用 `/trust` 并重新启动 Pi 用于应用工程设置 。 全球和记忆设置仍然可用.

可用的设置包括:

-   shell 路径覆盖
-   屏蔽外壳背景图案( e)`&`, (中文(简体) ), `nohup`, (中文(简体) ), `disown`, (中文(简体) ), `setsid`)在bash calls中,将Pi重定向到进程工具上
-   状态部件切换
-   进程面板大小
-   日志覆盖大小、历史限制、跟踪模式和自动隐藏
-   站点默认状态和行数
-   工具曝光( e)`direct`, (中文(简体) ), `model-only`, (中文(简体) ), `codemode`, (中文(简体) ), `deferred`,或 `hidden`; 全局标签, 在下次会话开始时应用)

## 平台支持

-   macOS: 已支持
-   Linux: 已支持
-   视窗: 不支持

## 类似但不同

Pi拥有多个进程,终端,和背景任务扩展. pi-进程侧重于明确的LLM管理背景流程,日志检查,能唤醒毒剂的手表,Pi UI表面用于 `/ps`,日志,码头,和状态.

见 [pi. dev/包装](https://pi.dev/packages) 用于完整注册 Pi 扩展.

### 背景命令管理器

这些软件包最接近当您想要 shell 命令, Dev 服务器, 监视器, 或日志在 Pi 继续对话时继续运行时.

-   [pi 背景任务](https://pi.dev/packages/pi-background-tasks): 耐用背景外壳任务外加授权的儿童 Pi工作流程.
-   [@ 99%的人/皮-背地任务](https://pi.dev/packages/%4099percentpeople/pi-background-tasks):背景命令和可附加的PTY/TUI会话,有SSH远程集成.
-   [@richardgill/皮-后地-bash](https://github.com/richardgill/pi-extensions/tree/main/extensions/background-bash): 替换 `bash` 与会场所属的本地流程组并添加 `bash_process` 名单 偷看 杀人.
-   [p-bash-bg](https://pi.dev/packages/pi-bash-bg)页:1 `&` 支持 Pi 的 bash 工具, 解析背景进程并让输出远离上下文窗口 .
-   [皮-天-背-地-地-地](https://pi.dev/packages/pi-tian-background-terminals): 将 Pi 的内置 Bash 替换为自动背景生成、 完成通知和 a `/ps` 观者.
-   [更好的背景任务](https://pi.dev/packages/pi-better-background-tasks):耐用背景外壳任务,监视器,日志,以及状态检查.
-   [pi -patty -bg -任务](https://pi.dev/packages/pi-patty-bg-tasks): Claude Code 风格的背景任务,具有自动背景,附加,文件后置输出,以及合作引导等功能.
-   [@ mjakl/ pi- 进程](https://pi.dev/packages/%40mjakl/pi-processes): 剥去的 pi- processes 叉 `process` 工具,单个 `/ps` 重叠,一个紧凑状态行,并减少命令/设置.
-   [@haemmid/ pi- 进程](https://pi.dev/packages/%40haemmid/pi-processes): pi-web-聚焦 pi-processes for dev-server 自动化的分叉,带有 `ensure`, (中文(简体) ), `restart`,以及 `wait` astro/Vite类工作流程的动作.
-   [pi- processes- git- bash (英语)](https://pi.dev/packages/pi-processes-git-bash):通过Git Bash为Windows用户提供pi-processes分叉.

### 终端和外壳替换

这些软件包在您需要不同的 shell 底盘, PTY 行为, 或平台特定终端支持时更适合使用.

-   [pi 统一执行](https://pi.dev/packages/pi-unified-exec): Codex风格的长寿命 shell会话,包含stdin,PTY,REPL,SSH,dev-server,和磁盘-log支持.
-   [活-死](https://pi.dev/packages/pi-live-terminal): tmux 后置命令跑取器,带有活的终端部件.
-   [@aliaksei-raketski/pi-tmux-bash (英语)](https://pi.dev/packages/%40aliaksei-raketski/pi-tmux-bash): 在管理的 tmux 窗口中运行模型化 shell 命令 .
-   [@ 4fu/ pi- pwsh (英语)](https://pi.dev/packages/%404fu/pi-pwsh):持续为 Pi 在Windows 上的PowerShell任务,包含 ConPTY会话和用户请求.
-   [pi-pwsh- 通知( i)](https://pi.dev/packages/pi-pwsh-notify): PowerShell shell 有背景任务和完成/服务器准备通知.

### 监测器、调度器和能见度

这些软件包更多的是观察,唤醒,或者表面过程状态,而不是直接替换pi过程.

-   [pi -事件监测器](https://pi.dev/packages/pi-event-monitor): 事件驱动 shell 流和文件监视器在进程退出,匹配输出或文件写入时将会话唤醒.
-   [pi- 监视器- 插件](https://pi.dev/packages/pi-monitor-plugin):背景工作,显示器,回路,时刻表,和闲置意识通知.
-   [双线线](https://pi.dev/packages/pi-tripwire): 代理喷发的本地主机服务器的页脚能见度;而不是进程运行器本身.
-   [@ cortexkit/ aft- pi](https://pi.dev/packages/%40cortexkit/aft-pi): 更广泛的 Agent 文件工具包, 包括背景bash任务, PTY会话, 以及输出压缩和代码分析工具 .

## 实例

[`examples/`](https://npmcn.com/package/%40aliou/pi-processes/examples) 有扩展片段可以复制到 `~/.pi/agent/extensions/` 并适应。 见 [`examples/README.md`](https://npmcn.com/package/%40aliou/pi-processes/examples/README.md) 为每个人的行为.

## 特性演示

**监视文件备份日志并从错误中恢复**

[![Watch a file-backed log and recover from an error](https://assets.aliou.me/pi-extensions/demos/processes/v0.10.0/debug-from-log.gif)](https://assets.aliou.me/pi-extensions/demos/processes/v0.10.0/debug-from-log.mp4)

**打开日志覆盖并检查输出**

[![Open the log overlay and inspect output](https://assets.aliou.me/pi-extensions/demos/processes/v0.10.0/inspect-logs.gif)](https://assets.aliou.me/pi-extensions/demos/processes/v0.10.0/inspect-logs.mp4)

**停止和明确程序**

[![Stop and clear processes](https://assets.aliou.me/pi-extensions/demos/processes/v0.10.0/stop-and-clear.gif)](https://assets.aliou.me/pi-extensions/demos/processes/v0.10.0/stop-and-clear.mp4)

**向运行的进程发送输入**

[![Send input to a running process](https://assets.aliou.me/pi-extensions/demos/processes/v0.10.0/send-input.gif)](https://assets.aliou.me/pi-extensions/demos/processes/v0.10.0/send-input.mp4)

## 捐款

关于开发、测试、文件生成和扩展内部,见 [捐款额](https://npmcn.com/package/%40aliou/pi-processes/CONTRIBUTING.md)。 。 。 .

## 许可证

麻省理工学院

## 常见问题

### 如何安装 @aliou/pi-processes？

在项目目录运行 npm install @aliou/pi-processes，或使用 pnpm add / yarn add / bun add。

### @aliou/pi-processes 支持 TypeScript 吗？

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

### @aliou/pi-processes 支持 ESM 还是 CommonJS？

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

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

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

### @aliou/pi-processes 可以商用吗？

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

### @aliou/pi-processes 的下载量有多少？

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

### @aliou/pi-processes 还在维护吗？

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