# Termux（Android）配置

> 在 Android 的 Termux 环境中安装并运行 pi，含剪贴板与存储权限说明。

---

LLMS 索引： [llms.txt](/llms.txt)

---

Pi 可以通过 [Termux](https://termux.dev/) 在 Android 上运行。Termux 是一个面向 Android 的终端模拟器和 Linux 环境。

## 前置条件 {#prerequisites}

1. 从 GitHub 或 F-Droid 安装 [Termux](https://github.com/termux/termux-app#installation)（不要从 Google Play 安装，那个版本已弃用）
2. 从 GitHub 或 F-Droid 安装 [Termux:API](https://github.com/termux/termux-api#installation)，用于剪贴板和其他设备集成

## 安装 {#installation}

```bash
# 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
```

## 剪贴板支持 {#clipboard-support}

在 Termux 中运行时，剪贴板操作使用 `termux-clipboard-set` 和 `termux-clipboard-get`。这些功能需要安装 Termux:API 应用。

Termux 不支持图片剪贴板（`ctrl+v` 图片粘贴功能无法使用）。

## Termux 的 AGENTS.md 示例 {#example-agentsmd-for-termux}

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

````markdown
# 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          # Opens with default app
termux-open --chooser image.jpg      # Choose app
```

## Clipboard
```bash
termux-clipboard-set "text"   # Copy
termux-clipboard-get          # Paste
```

## Notifications
```bash
termux-notification -t "Title" -c "Content"
```

## Device Info
```bash
termux-battery-status         # Battery info
termux-wifi-connectioninfo    # WiFi info
termux-telephony-deviceinfo   # Device info
```

## Sharing
```bash
termux-share -a send file.txt # Share file
```

## Other Useful Commands
```bash
termux-toast "message"        # Quick toast popup
termux-vibrate                # Vibrate device
termux-tts-speak "hello"      # Text to speech
termux-camera-photo out.jpg   # Take photo
```

## 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
````

## 限制 {#limitations}

- **没有图片剪贴板**：Termux 剪贴板 API 只支持文本
- **存储访问**：要访问 `/storage/emulated/0` 中的文件（Downloads 等），请先运行一次 `termux-setup-storage` 授予权限

## 故障排除 {#troubleshooting}

### 剪贴板不可用 {#clipboard-not-working}

确保两个应用都已安装：

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

然后安装 CLI 工具：

```bash
pkg install termux-api
```

### 共享存储权限被拒绝 {#permission-denied-for-shared-storage}

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

```bash
termux-setup-storage
```

### Node.js 安装问题 {#nodejs-installation-issues}

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

```bash
npm cache clean --force
```

---

反链：

- [快速开始](/book/pi/quickstart/)