@fffattiger/pix-cli

中文文档
0.3.23发布于 2026/11/03TypeScriptES Module近 30 天下载 3936

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

中文使用文档
文档目录6 节
  1. 为什么像素
  2. 快开始
  3. 视窗( 预览)
  4. 如何运作
  5. 发展
  6. 许可证

像素

当地网站工作站 毕 编码代理 .

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

为什么像素

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

快开始

22.19节点和工作室 毕 设置(模型和提供者来自您现有的 ~/.pi 配置).

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

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

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

管理运行中的服务 :

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硬化. 见 文件/窗口。 。 。 .

如何运作

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。完整架构、变化和软件包布局在 文件/内容/建筑结构 财务报告和审定财务报表 一般事务人员(其他职等)。 。 。 .

发展

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。 。 。 .

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

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。 。 。 .

版本与发布记录

@fffattiger/pix-cli 共发布 30 个版本,首次发布于 2026/09/18;过去 12 个月发布了 30 个版本。

版本发布日期距今
0.3.23latest2026/11/0311 天前
0.3.222026/10/2916 天前
0.3.212026/10/2817 天前
0.3.202026/10/2718 天前
0.3.192026/10/2619 天前
0.3.182026/10/2322 天前

关于 @fffattiger/pix-cli 的常见问题

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