$ cat ~/map/pi-client.md

Pi Client

pi 的 Flutter 客户端，一套代码覆盖移动端、桌面端与 Web。

tools✓ 9月2日

事实速查

安装

brew install --cask hu-wentao/tap/pi-client

## 速览

独立的 pi 编码代理 Flutter 客户端：一套代码覆盖 Android、iOS、macOS、Windows、Linux 与 Web，移动端与 Web 仅作连接端，桌面端托管运行时仍在开发中。

$单个 Flutter 工程覆盖 Android、iOS、macOS、Windows、Linux 与 Web，并以经过测试的 PlatformCapabilities 契约区分桌面可托管与移动/Web 仅连接两种角色。
$Android、iOS 与 Web 是仅连接端：它们接入远程 agent host，不得内嵌 Agent 运行时、不得启动宿主工具、也不得获得宿主文件系统权限。
$桌面平台在契约上具备托管能力——这只是执行角色，并不代表当前公开版本已内置托管运行时；独立运行时与传输层仍在积极开发。
$当前 Preview 构建是评估用途的产物，走过渡性的 pi-web 兼容边界，且需要可达的 pi-web 0.8.11 服务。
$macOS Preview（要求 macOS 11 及以上）未签名也未公证，经项目自有的 Homebrew cask 安装；首次启动需在 Finder 中右键点按应用并选择打开，因为 Gatekeeper 会拦下普通的首启动。

Q 手机能直接跑 agent 吗？

不能——Android、iOS 与 Web 都是仅连接端，只负责接入 agent host，不内嵌运行时，也不触碰宿主文件系统。

Q 有 macOS 版本吗？

有——通过项目自有的 Homebrew cask 分发的未签名 macOS Preview（brew install --cask hu-wentao/tap/pi-client），会把 Pi Client.app 装入 /Applications。