Termux（安卓）设置

Pi 通过Termux（适用于 Android 的终端模拟器和 Linux 环境）在 Android 上运行。

1. 从 GitHub 或 F-Droid 安装 Termux（不是 Google Play，该版本已弃用）
2. 从 GitHub 或 F-Droid 安装 Termux:API 以进行剪贴板和其他设备集成

# Update packages
pkg update && pkg upgrade

# Install dependencies
pkg install nodejs termux-api git

# Install pi
npm install -g --ignore-scripts @earendil-works/pi-coding-agent

# Create config directory
mkdir -p ~/.pi/agent

# Run pi
pi

在 Termux 中运行时，剪贴板操作使用 termux-clipboard-set 和 termux-clipboard-get。必须安装 Termux:API 应用程序才能正常工作。

Termux 不支持图像剪贴板（ctrl+v 图像粘贴功能将不起作用）。

创建~/.pi/agent/AGENTS.md来帮助智能体了解Termux环境：

# Agent Environment: Termux on Android

## Location
- **OS**: Android (Termux terminal emulator)
- **Home**: `/data/data/com.termux/files/home`
- **Prefix**: `/data/data/com.termux/files/usr`
- **Shared storage**: `/storage/emulated/0` (Downloads, Documents, etc.)

## Opening URLs
```bash
termux-open-url“https://example.com”
```

## Opening Files
```bash
termux-open file.pdf # 使用默认应用程序打开
termux-open --chooser image.jpg # 选择应用程序
```

## Clipboard
```bash
termux-clipboard-set "text" # 复制
termux-clipboard-get # 粘贴
```

## Notifications
```bash
termux-通知 -t“标题”-c“内容”
```

## Device Info
```bash
termux-battery-status # 电池信息
termux-wifi-connectioninfo # WiFi 信息
termux-telephony-deviceinfo # 设备信息
```

## Sharing
```bash
termux-share -a send file.txt # 共享文件
```

## Other Useful Commands
```bash
termux-toast "message" # 快速 toast 弹出窗口
termux-vibrate # 振动设备
termux-tts-speak "hello" # 文本转语音
termux-camera-photo out.jpg # 拍照
```

## Notes
- Termux:API app must be installed for `termux-*` commands
- Use `pkg install termux-api` for the command-line tools
- Storage permission needed for `/storage/emulated/0` access

• 无图像剪贴板：Termux剪贴板API仅支持文本
• 没有本机二进制文件：一些可选的本机依赖项（例如剪贴板模块）在 Android ARM64 上不可用，并且在安装过程中会被跳过
• 存储访问：要访问/storage/emulated/0中的文件（下载等），请运行一次termux-setup-storage以授予权限

确保两个应用程序均已安装：

1. Termux（来自 GitHub 或 F-Droid）
2. Termux:API（来自GitHub或F-Droid）

然后安装CLI工具：

pkg install termux-api

运行一次以授予存储权限：

termux-setup-storage

如果npm失败，请尝试清除缓存：

npm cache clean --force