Skip to content

README.zh.md

Latest commit

 

History

History
118 lines (82 loc) · 6.25 KB

README.zh.md

File metadata and controls

118 lines (82 loc) · 6.25 KB
Raw

pi-web (Remote Control Your Pi)

从您的手机、平板或笔记本电脑上驱动 pi 编程助手 — 无论在您的网络内任何地方，还是通过 Tailscale 远程访问。

它是一个完整的 PWA，因此您可以安装它，像原生应用一样在任何设备上使用。把它想象成您个人的 AI 工作空间 — 类似于 Claude 的 Cowork，但可以使用不同的模型 — 跨模型对话，从手机编写代码，或将其变成一个运行在您机器上的个人助理。

把它变成您的专属工具：切换主题和字体，使用您自己的语言 — pi-web 自带多种语言，您还可以添加自己的语言。更多功能即将推出，但它不会变得臃肿：任何您不需要的功能都可以在设置中关闭。

Warning

pi-web 目前处于 beta 阶段。一切都可能发生变化和故障！

Tip

新用户？阅读用户指南 → 获取完整的功能介绍、安装步骤和使用技巧。（其他语言 →）

截图

桌面端
桌面端

移动端 PWA
移动端 PWA

架构概览

 pi (终端)                      浏览器 (手机 / 平板 / 笔记本电脑)
      │                                │
      │  写入 JSONL                    │  HTTP + SSE
      ▼                                ▼
 ~/.pi/agent/sessions/  ←───  pi-web (Go HTTP 服务)
                                      │
                    ┌─────────────────┼─────────────────┐
                    │                 │                 │
              pi --mode rpc      fsnotify         tailscale serve
            (每个会话          (实时重载)         (远程 HTTPS
             的聊天 worker)                        通过 MagicDNS)
  • pi 在工作时将对话 JSONL 写入 ~/.pi/agent/sessions/。
  • pi-web 是一个 Go 服务，它读取这些文件，在浏览器中渲染它们，并通过 SSE 推送实时更新。
  • pi --mode rpc worker 处理来自浏览器的聊天 — 每个会话一个，空闲 10 分钟后回收。
  • fsnotify 监控会话目录，以便浏览器在新输出产生的几毫秒内重载。
  • Tailscale Serve 将本地服务发布为您 tailnet 上的 HTTPS 端点。

安装

pi install npm:@ygncode/pi-web@beta

就这些 — 它会下载匹配的二进制文件，设置自动启动，并注册 /web、/pi-web、/remote 和 /refresh 命令。

安装完成后，在浏览器中打开 http://127.0.0.1:31415。在 pi 中，使用 /web 可立即在浏览器中打开当前会话。如果您的机器上运行着 Tailscale，pi-web 会自动在您的 tailnet 上发布一个 HTTPS 端点 — 在 pi 中使用 /remote 即可获取 QR 码和 URL，以便 tailnet 上的任何设备访问。

**macOS 远程访问：**以交互方式安装并打开 Tailscale，批准管理员提示并登录。然后运行 /pi-web restart，再运行 /remote。

有关手动安装、二进制下载或从源码构建，请参阅 user-docs/install.md。

Pi 集成

运行 pi install npm:@ygncode/pi-web@beta 后，您将获得：

命令 功能描述
/web 在浏览器中打开当前会话（支持 SSH 感知：跳过浏览器仅显示 URL）
/pi-web 显示状态、版本、启动/停止/重启服务或更新
/remote 显示用于通过 Tailscale 远程访问的 QR 码和 URL
/refresh 将远程浏览器写入的新消息拉回终端会话中

会话自动标题内置于 pi-web 中，可在 /settings 页面配置。它默认开启，会自动为会话命名。您可以选择：

  • 何时生成标题 — 每个会话仅一次，或在每条新消息时生成（默认）。
  • 标题模型 — 默认使用免费、即时的内置词语启发式算法（无 AI），或选择一个模型（例如小型/快速的模型）来获得更智能的、由模型编写的标题。

该包还会将 pi-web 二进制文件安装到 ~/.pi/agent/bin/pi-web，并设置登录时自动启动。

登录时自动启动

pi install npm:@ygncode/pi-web@beta 命令会自动完成此设置：

操作系统 机制
macOS launchd plist，位于 ~/Library/LaunchAgents/com.pi-web.plist
Linux systemd 用户服务，位于 ~/.config/systemd/user/pi-web.service

要设置远程访问令牌，请创建 ~/.config/pi-web/env：

PI_WEB_TOKEN=your-token-here

更多细节（手动设置、自定义端口、非环回绑定），请参阅 user-docs/install.md。

开发

make setup   # 安装前端依赖并下载 Go 模块
make check   # 前端测试/构建 + Go 测试/审查
make build   # 如有需要则先 setup，构建前端，然后构建 ./pi-web