# @alivault/pico 中文文档

规范地址：https://npmcn.com/package/%40alivault/pico/

版本：2\.5\.0
npm 元数据更新时间：2026-11-07T19:46:37.179Z
中文译文更新时间：2026-11-07T01:58:02.678Z
软件包许可：AGPL-3\.0-only

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

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

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

- 包体积（解压后）：49.2 MB，569 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.19\.0
- 运行依赖：14 个
- 首次发布：2026-05-08T03:02:03.267Z
- 最新版本发布：2026-11-07T19:46:36.869Z
- 近 30 天下载量：2092（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：56（近 12 个月 56 个）

## 中文简介

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

## 安装

```sh
npm install @alivault/pico
```

也可以使用：`pnpm add @alivault/pico`、`yarn add @alivault/pico`、`bun add @alivault/pico`

## README

# 皮克语Name

持久网络工作空间 [Pi](https://www.npmjs.com/package/@earendil-works/pi-durable) 编码代理。 一个节点服务器托管代理运行时间并服务于 反应网络应用.

![Pico workspace where an agent runs two subagents, each in its own worktree](https://npmcn.com/package/%40alivault/pico/apps/pico/public/screenshots/pico-workspace.png)

![Pico workspace in light mode with subagents in the sidebar and the Agent tab](https://npmcn.com/package/%40alivault/pico/apps/pico/public/screenshots/pico-workspace-alt.png)

| 黑暗移动浏览器 | 轻型移动浏览器 |
| --- | --- |
| ![Pico mobile browser in dark mode](https://npmcn.com/package/%40alivault/pico/apps/pico/public/screenshots/pico-mobile.png) | ![Pico mobile browser in light mode](https://npmcn.com/package/%40alivault/pico/apps/pico/public/screenshots/pico-mobile-alt.png) |

## 所需资源

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

## 安装

```sh
npm install -g @alivault/pico
pico-app
```

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

## 从源头运行

```sh
pnpm install
pnpm build
pnpm start
```

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

```sh
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,从不将其曝光于公共互联网.

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

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

## 多个机器

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

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

## 发展

```sh
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 (英语)](https://pico.aliabbas.net/)应用它 `pnpm website:deploy`。 。 。 .

## 许可证

AGPL-3.0 -仅限. 见 [自由主义](https://npmcn.com/package/%40alivault/pico/LICENSE)。 。 。 .

## 常见问题

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