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