# @huntye1/pi-mobile

[English](README.md)

实验性一体化 Pi Mobile CLI（macOS/Linux），包含 Web、Gateway、TUI Bridge、受控 launcher 和认证本地 supervisor。

## 安装

需要 Node.js `>=22.19.0 <23`，Pi 需另行安装：

```bash
npm install --global @huntye1/pi-mobile
pi-mobile setup
pi-mobile doctor
```

Setup 会通过稳定个人 Pi package 安装内置 Pi Mobile Bridge 并启动 Gateway。已有 TUI 只有在**你自行 `/reload`** 后加载；新 Pi 进程自动加载。不配置项目 trust 或模型认证。受控新建会话还需 tmux。

源码开发时可构建 `apps/pi-mobile-cli/publish`，再安装审查后的目录/tarball。

## 生命周期与安全

支持 setup/start/stop/restart/status/doctor/logs/config/update/rollback/uninstall。默认 loopback；LAN 需 TLS、精确 Host 和显式风险确认。没有应用登录或 OS 自动启动，Windows live/supervisor 未实现。

CLI installer 与选定 runtime 独立：安装 CLI 不会更新运行中的 Gateway；`update --source` 只改变 runtime，不改变 installer 或已加载的 Pi Bridge。日志/恢复有界，PID 文件不授予停止权限。

源码采用 MIT；内置 `THIRD_PARTY_NOTICES.txt` 汇总第三方许可证。不包含应用凭证或 source maps。

详见[安装说明](https://github.com/huntye1/pi-extensions/blob/main/docs/pi-mobile/installation.md)和[运维说明](https://github.com/huntye1/pi-extensions/blob/main/docs/pi-mobile/operations.md)。源码文档在仓库 Private 时需要访问权限。