在 Android Termux 中配置 Pi 编码助手

badlogic 发布于 2026-05-21 阅读 9

本文介绍了如何在Android的Termux终端模拟器中安装和配置PI Coding Agent(pi)。包括安装Termux和Termux:API应用、使用pkg安装依赖、通过npm全局安装pi、创建配置文件、以及启用剪贴板支持。还提供了一个示例的AGENTS.md配置,帮助代理理解Termux环境。最后列出了限制和常见问题解答,如图片剪贴板不支持、存储权限设置等。

Pi 通过 Termux 在 Android 上运行,Termux 是一个终端模拟器和 Linux 环境。

前提条件

  1. 从 GitHub 或 F-Droid 安装 Termux(不要从 Google Play 安装,该版本已废弃)
  2. 从 GitHub 或 F-Droid 安装 Termux:API,用于剪贴板和其他设备集成

安装

## 更新包
pkg update && pkg upgrade

## 安装依赖
pkg install nodejs termux-api git

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

## 创建配置目录
mkdir -p ~/.pi/agent

## 运行 pi
pi

剪贴板支持

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

Termux 不支持图像剪贴板(ctrl+v 图像粘贴功能将无法使用)。

Termux 的 AGENTS.md 示例

创建 ~/.pi/agent/AGENTS.md 以帮助 agent 理解 Termux 环境:

## Agent 环境:Android 上的 Termux

### 位置
- **操作系统**:Android(Termux 终端模拟器)
- **家目录**:`/data/data/com.termux/files/home`
- **前缀**:`/data/data/com.termux/files/usr`
- **共享存储**:`/storage/emulated/0`(下载、文档等)

### 打开 URL
```bash
termux-open-url "https://example.com"
```

### 打开文件
```bash
termux-open file.pdf          # 使用默认应用打开
termux-open --chooser image.jpg      # 选择应用
```

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

### 通知
```bash
termux-notification -t "标题" -c "内容"
```

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

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

### 其他有用命令
```bash
termux-toast "消息"        # 快速弹出提示
termux-vibrate                # 设备振动
termux-tts-speak "你好"      # 文本转语音
termux-camera-photo out.jpg   # 拍照
```

### 备注
- 必须安装 Termux:API 应用才能使用 `termux-*` 命令
- 命令行工具通过 `pkg install termux-api` 安装
- 访问 `/storage/emulated/0` 需要存储权限

限制

  • 无图像剪贴板: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

Node.js 安装问题

如果 npm 失败,请尝试清除缓存:

npm cache clean --force
  • 原文链接: github.com/badlogic/pi-m...
  • 登链社区 AI 助手,为大家转译优秀英文文章,如有翻译不通的地方,还请包涵~

相关文章

0 条评论