@alivault/pico

中文文档
2.5.0发布于 2026/11/08AGPL-3.0-onlyES Module构建来源已验证近 30 天下载 2092

持久 Pi 编码代理会话的本地浏览器工作空间 .

中文使用文档
文档目录8 节
  1. 所需资源
  2. 安装
  3. 从源头运行
  4. 它会做什么
  5. 远程访问
  6. 多个机器
  7. 发展
  8. 许可证

皮克语Name

持久网络工作空间 Pi 编码代理。 一个节点服务器托管代理运行时间并服务于 反应网络应用.

Pico workspace where an agent runs two subagents, each in its own worktree

Pico workspace in light mode with subagents in the sidebar and the Agent tab

黑暗移动浏览器轻型移动浏览器
Pico mobile browser in dark modePico mobile browser in light mode

所需资源

  • 节点.js 22.19或以后
  • pnpm 10.33(只从源头运行)
  • 基特和外壳
  • 供应商证书 ~/.pi/agent/auth.json,或设置在皮科

安装

npm install -g @alivault/pico
pico-app

或者在没有全局安装的情况下尝试: npx @alivault/pico。 。 。 .

从源头运行

pnpm install
pnpm build
pnpm start

打开 http://127.0.0.1:3141。有用的命令:

pnpm start --no-open --port 3141
pnpm start --data-dir PATH   # default: ~/.pico
pnpm start status
pnpm start stop --wait       # let active turns finish first
pnpm start import-pi         # import Pi sessions as agents (stop Pico first)

它会做什么

  • 耐用剂. 特工和他们的谈话 在一个SQLite上直播 数据库。 崩溃或重启后转动继续 。 副作用工具不会运行两次 .
  • 工作空间. Git 更改和 diffs 、 文件浏览器、 语法突出显示 终端.
  • 幸存的终端重启 . 终端和背景工作运行于 a 小数 pico-pty-host 进程(每个数据目录一个)。 当皮克 服务器重新启动后, 它会用输出再次找到它们 。 宿主来了 10分钟内没有终端和服务器连接; 如果12小时没有服务器,它也会结束任何运行的贝壳. 停下来 皮克和东道主: pico-app stop --pty-host (终点和工作也结束). pico-app serve --no-pty-host 在服务器进程中保留终端.
  • 探员工具. 待办事宜列表、向用户提出的问题、背景工作 报告其退出、终端、 git 工作树中的子代理、 浏览器 自动化,代码模式,网络访问,以及MCP.
  • 工具简介. full, (中文(简体) ), builder, (中文(简体) ), researcher, (中文(简体) ), reviewer, (中文(简体) ), read-only,或你自己的。 (笑声) 单位 reviewer 财务报告和审定财务报表 read-only{\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}击倒在地上 气泡包装沙盒 (Linux): 文件系统只读而无 网络,所以代理无法用脚本更改文件.
  • 安全副剂. 子代理从它的母获得工具配置. 它已经 没有 ask_user 或者说 spawn_subagent 除非父母给予,及其 击倒拒绝 git push 到主线, sudo命令 , 命令 , 命令 列表。 副代理人发出的每一条信息都是一个问题、完成或等待(其 工作结束). 问题和做 进入父母的后续行动 队列; 仅等待显示在 agents 列表动作.
  • 通报. 当一个回合结束或代理商问起时, Web Push and ntfy 一个问题.

使用Pi技能,即时模板,项目指令和证书. 遗留 Pi 扩展未装入 .

远程访问

Pico没有登录。 任何能够到达它的人都可以作为用户运行命令. 使用tailscale,从不将其曝光于公共互联网.

pnpm start --host <tailscale-ip> --no-open

对 HTTPS 使用 Tailscale Service(按键通知需要) .

多个机器

一个Pico可以显示其他计算机的代理,比如一个建筑 服务器。 每台机器运行自己的皮克 127.0.0.1. 你那个皮克 打开(枢机)通过SSH连接到它们,并在侧边栏中显示. 代理、终端和工作在自己的机器上运行,并在 枢纽开始下线.

pico-app machine add ali@workbox      # SSH target, alias, or Tailscale name
pico-app machine list
pico-app machine reconnect workbox    # after a password, key, or check prompt
pico-app machine remove workbox       # Pico keeps running on workbox

machine add 连接您的终端, 因此 SSH 可以请求密码或密码 主机密钥 。 它发现节点22.19+和Pico在远程机器上 在安装 Pico( npm, 输入)之前 ~/.local) (中文(简体) ). 枢机再用你的 SSH 配置, 密钥, 和一个共享连接的代理 。 它从来没有要求 输入; 当SSH需要您时, 机器会显示 请注意 命令改为 运行。 Pico 不存储密码或密钥, 它复制没有设置或 其他机器的证书.

分级作品:使用 MagicDNS 名称或 100.x 作为目标, 带有 OpenSSH 或 Tailscale SSH.

任何能打开枢机的人都可以在其所有的机器上运行命令. 留着 在本地主机上或您的尾网上设置中枢。 枢纽上的特工可以使用代理工具 (单位:千美元)spawn_subagent, (中文(简体) ), agents带有 machine 参数,例如开始 试剂在 workbox。 。 。 .

发展

pnpm dev     # backend on 3141, Vite client on 3142
pnpm check
pnpm build

这是一个pnpm单曲:

  • apps/pico:皮克应用. 客户端代码在 apps/pico/src。服务器代码 进入 apps/pico/server/src。 。 。 .
  • apps/website: 静态站点 pico.aliabas.net (英语)应用它 pnpm website:deploy。 。 。 .

许可证

AGPL-3.0 -仅限. 见 自由主义。 。 。 .

版本与发布记录

@alivault/pico 共发布 56 个版本,首次发布于 2026/05/08;过去 12 个月发布了 56 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.5.0latest2026/11/08今天
2.4.12026/11/07今天
2.4.02026/11/061 天前
2.3.02026/11/052 天前
2.2.02026/11/043 天前
2.1.02026/11/034 天前

关于 @alivault/pico 的常见问题

@alivault/pico 是什么?

持久 Pi 编码代理会话的本地浏览器工作空间 .

如何安装 @alivault/pico?

在项目目录运行 npm install @alivault/pico,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 pico-app,可以用 npx pico-app 直接运行。

@alivault/pico 支持 TypeScript 吗?

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

@alivault/pico 支持 ESM 还是 CommonJS?

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

@alivault/pico 需要什么版本的 Node.js?

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

@alivault/pico 可以商用吗?

@alivault/pico 使用 AGPL-3.0-only 许可。最严格的 Copyleft:除分发外,通过网络向用户提供基于它的服务也需要开源对应源码。闭源 SaaS 使用前务必评估。以上为概括,不构成法律意见,请以许可原文为准。

@alivault/pico 的下载量有多少?

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

@alivault/pico 还在维护吗?

最新版本 2.5.0 发布于 2026/11/08(今天);至今共发布 56 个版本,其中过去 12 个月发布了 56 个;首次发布于 2026/05/08。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。