TannerMidd/pi-pocket

选用指南

AI 根据 README 整理 · 2026/10/16 21:31:41

使用方式

通过命令行启动，使用 npm start 运行，启动器会询问设备连接方式并打印地址、登录链接和二维码。

查看 README 依据

Requires Node.js 22.19 or newer. Runs on Linux, macOS, Windows, and Android (Termux); Linux is the most tested. Sign in to a provider with Pi first (`pi`, then `/login`), or later from the app's Providers sheet. ```bash git clone https://github.com/TannerMidd/pi-pocket.git cd pi-pocket npm install npm start ```

The launcher asks how your devices should connect, then prints the address, a sign-in link, and a QR code. Open the link once per browser; the cookie lasts a year. The link is the owner's key, so keep it private. `--rotate-token` replaces it and signs out every device that used the old link; people you invited stay signed in until you remove them under Menu → People. While it runs: **q** quit · **r** restart server · **a** change access · **o** open in browser · **s** show QR code. ## Features

部署要求

需要 Node.js 22.19 或更高版本，支持 Linux、macOS、Windows 和 Android (Termux)，其中 Linux 测试最充分。

查看 README 依据

Requires Node.js 22.19 or newer. Runs on Linux, macOS, Windows, and Android (Termux); Linux is the most tested. Sign in to a provider with Pi first (`pi`, then `/login`), or later from the app's Providers sheet. ```bash git clone https://github.com/TannerMidd/pi-pocket.git cd pi-pocket npm install npm start ```

已知限制

Pi Durable 是实验性的，API 可能变化；仅支持单服务器进程访问数据库；内置浏览器需要 Chromium、Chrome、Brave 或 Edge，且页面内容在重启后不保留。

查看 README 依据

Pi knows where Pi Pocket's own documentation is: [docs/index.md](docs/index.md) starts it, for agents and people who change how Pi works without code ([customizing](docs/customizing.md)), write extensions ([extensions](docs/extensions.md), with [tested examples](docs/examples/)), or change Pi Pocket itself while it runs ([self-editing](docs/self-editing.md)). ## Limitations - Pi Durable is experimental, and its API can change between releases. Versions are pinned in `package.json`. - Only one server process can use the database at a time.

- Forks are separate sessions; there is no branch tree to switch between inside one session. - Pi's own extensions are not supported: Pi Pocket runs its own extensions on Pi Durable, and drop-ins from `~/.pi-pocket/extensions/`. Pi's prompt templates work as slash commands. - A git worktree keeps a session's files apart; it is not a sandbox. Pi can still reach everything you can. - Artifacts run in an opaque-origin sandbox, so `localStorage` and cookies are unavailable inside them.

- The browser needs Chromium, Chrome, Brave, or Edge on the server. Its pages live in memory: a restart opens each one again at its last address, but not what was typed into it. Each session's cookies are its own and last until the page closes. A browser installed as a snap (Ubuntu's Chromium) is used only when there is no other; it cannot open files outside your home folder. The list of servers running on the machine is Linux-only. Tested on Linux and macOS; not yet on Windows. ## Credits