# @fffattiger/pix-cli 中文文档

规范地址：https://npmcn.com/package/%40fffattiger/pix-cli/

版本：0\.3\.23
npm 元数据更新时间：2026-11-03T06:21:34.637Z
中文译文更新时间：2026-11-14T15:28:11.768Z
软件包许可：未声明

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

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

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

- 包体积（解压后）：72.8 MB，4383 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.19\.0
- 运行依赖：44 个
- 首次发布：2026-09-18T03:32:34.044Z
- 最新版本发布：2026-11-03T06:21:34.480Z
- 近 30 天下载量：3936（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：30（近 12 个月 30 个）

## 中文简介

安装并运行pix,为 pi 编码代理的本地网络工作站.

## 安装

```sh
npm install @fffattiger/pix-cli
```

也可以使用：`pnpm add @fffattiger/pix-cli`、`yarn add @fffattiger/pix-cli`、`bun add @fffattiger/pix-cli`

## README

# 像素

当地网站工作站 [毕](https://github.com/earendil-works/pi) 编码代理 .

您的会话生活在本地守护进程, 而不是浏览器标签中 。 关闭窗口,重启网络服务器,把你的笔记本电脑放入睡眠——运行中的代理继续工作,然后从任何浏览器或手机上的pix PWA重新连接. 会话作为普通 JSONL 存储在 `~/.pi`,与 pi CLI 完全共享:在pix中开始对话,从终端继续,或者反之.

## 为什么像素

-   **不随分页而死的会话 .** 网络 UI 仅仅是本地会话守护进程上的窗口; 刷新并重新启动不会杀死运行的代理 .
-   **历史浏览没有代价.** 阅读过去的会话是一个纯粹的只读的投影——在您互动之前没有工人的流程旋转.
-   **直播,结构化运行时间.** 思考 工具调用 shash 输出 和文件 编辑 WebSocket 上的流为已打出的事件, 并且快照完全恢复您所离开的位置 .
-   **真实的工作空间背景 .** 浏览会话项目的文件, git 状态和工作树,而不离开 UI.
-   **可安装 PWA.** 同一客户端安装在您的手机的家用屏幕上,并通过自己的网络与您的机器交谈.

## 快开始

22.19节点和工作室 [毕](https://github.com/earendil-works/pi) 设置(模型和提供者来自您现有的 `~/.pi` 配置).

```bash
npm install -g @fffattiger/pix-cli
pix start
```

`pix start` 服务于 pix 用户界面 `http://127.0.0.1:30141` (编) `--open` 以启动您的浏览器。 它仍然与终端相连——Ctrl+ C在会话持续运行时会停止网页主机——这也是服务管理者(系统化,启动,多克)应该如何运行. 有用的旗帜 :

```bash
pix start --port 30142 --hostname 0.0.0.0 --open
pix start --detach   # run the web host in the background and return once it is ready
```

管理运行中的服务 :

```bash
pix status            # sessiond + background host state, URL and log path
pix logs --follow     # background host output
pix restart           # restart the background host; sessions keep running
pix stop              # stop the background host; sessions keep running
pix stop --all        # also stop the session daemon (ends running sessions)
pix down --all        # stop the session daemon only
```

`pix restart --all` 还重新启动会话守护进程,并且 `pix update --restart` 重新启动新版本的背景主机 .

### 视窗( 预览)

pix在Windows 10/11上运行,具有相同的命令(`npm install -g @fffattiger/pix-cli`,则 `pix start` 在PowerShell或Windows终端中)。 会话守护进程使用一个每个用户命名的管来代替Unix socket,并将其状态保持在用户配置下. Windows支持是一个预览:在真实的Windows跑道上验证启动,而部分单元测试套件仍在为Windows硬化. 见 [文件/窗口](https://npmcn.com/package/%40fffattiger/pix-cli/docs/windows.md)。 。 。 .

## 如何运作

```
Browser / PWA
      │
Web process — Vite static client + Hono API/WS gateway        (restartable)
      │  localhost RPC
pix-sessiond — resident daemon, sole session authority
      │
agent-worker × N — one process per session
      │  AgentRuntimePort
pi SDK (via the anti-corruption layer)
```

网络过程按设计是一次性的; `pix-sessiond` 拥有会话周期,每会话都按自己的工人流程进行。 所有耐用状态都留在 `~/.pi`。完整架构、变化和软件包布局在 [文件/内容/建筑结构](https://npmcn.com/package/%40fffattiger/pix-cli/docs/refactor-architecture.md) 财务报告和审定财务报表 [一般事务人员(其他职等)](https://npmcn.com/package/%40fffattiger/pix-cli/AGENTS.md)。 。 。 .

## 发展

```bash
npm install
npm run check:architecture   # package-boundary and tooling gates
npm run typecheck
npm test
npm run build
```

端到端套房(先建成): `npm run test:e2e:startup`, (中文(简体) ), `test:e2e:runtime`, (中文(简体) ), `test:e2e:sessions`, (中文(简体) ), `test:e2e:lifecycle-sdk`, (中文(简体) ), `test:e2e:lifecycle-browser`, (中文(简体) ), `test:e2e:multi-tab`。 。 。 .

为了发布,更新了根版和《议定书》产品构建版, 然后同步工作空间版本和内部依赖性 :

```bash
node scripts/sync-version.mjs write
npm run release:verify -- --publishable --keep
```

这样会建立一个独立的档案和一个较小的档案 `-npm.tgz` 分配方式 孤立的临时目录。 独立检查覆盖离线安装, 运行时间启动,状态保留 跨越一个升级,和未安装的行为. Npm 归档捆绑 Pix, Pi 的编码代理 SDK, 和补丁插件; npm 通常安装其外部依赖性. SDK 1. 0. 0 捆绑省略 它的缺陷 出版的收缩包装。 用新 npm 测试 npm 归档 安装,然后用 `npm publish <archive-npm.tgz> --access public`。既不是脚本也不是 工作空间目录自动发布.

## 许可证

项目许可证尚未决定。 第三方视觉资产及其麻省理工学院的归属记录如下: [第三次议会 NoTICES.md](https://npmcn.com/package/%40fffattiger/pix-cli/THIRD_PARTY_NOTICES.md)。 。 。 .

## 常见问题

### @fffattiger/pix-cli 是什么？

安装并运行pix,为 pi 编码代理的本地网络工作站\.

### 如何安装 @fffattiger/pix-cli？

在项目目录运行 npm install @fffattiger/pix-cli，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 pix、pix-host、pix-sessiond，可以用 npx pix 直接运行。

### @fffattiger/pix-cli 支持 TypeScript 吗？

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

### @fffattiger/pix-cli 支持 ESM 还是 CommonJS？

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

### @fffattiger/pix-cli 需要什么版本的 Node\.js？

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

### @fffattiger/pix-cli 可以商用吗？

@fffattiger/pix-cli 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @fffattiger/pix-cli 的下载量有多少？

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

### @fffattiger/pix-cli 还在维护吗？

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