Cấu hình, tùy chỉnh, thiết lập nền tảng và tham chiếu API cho Pi.

Thiết lập Termux (Android)

Pi chạy trên Android thông qua Termux, trình mô phỏng thiết bị đầu cuối và môi trường Linux dành cho Android.

Điều kiện tiên quyết

  1. Cài đặt Termux từ GitHub hoặc F-Droid (không phải Google Play, phiên bản đó không được dùng nữa)
  2. Cài đặt Termux:API từ GitHub hoặc F-Droid cho clipboard và tích hợp thiết bị khác

Cài đặt

# 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

Hỗ trợ bảng nhớ tạm

Các thao tác trong bảng nhớ tạm sử dụng termux-clipboard-settermux-clipboard-get khi chạy trong Termux. Ứng dụng Termux:API phải được cài đặt để ứng dụng này hoạt động.

Bảng nhớ tạm hình ảnh không được hỗ trợ trên Termux (tính năng dán hình ảnh ctrl+v sẽ không hoạt động).

Ví dụ AGENTS.md cho Termux

Tạo ~/.pi/agent/AGENTS.md để giúp tổng đài viên hiểu được môi trường 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 # Mở bằng ứng dụng mặc định
termux-open --chooser image.jpg # Chọn ứng dụng
```

## Clipboard
```bash
termux-clipboard-set "text" # Sao chép
termux-clipboard-get # Dán
```

## Notifications
```bash
termux-thông báo -t "Tiêu đề" -c "Nội dung"
```

## Device Info
```bash
termux-pin-status # Thông tin về pin
termux-wifi-connectioninfo # Thông tin WiFi
termux-telephony-deviceinfo # Thông tin thiết bị
```

## Sharing
```bash
termux-share -a gửi file.txt # Chia sẻ tập tin
```

## Other Useful Commands
```bash
"tin nhắn" termux-toast # Cửa sổ bật lên bánh mì nướng nhanh
termux-vibrate # Rung thiết bị
termux-tts-speak "hello" # Chuyển văn bản thành giọng nói
termux-máy ảnh-photo out.jpg # Chụp ảnh
```

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

Hạn chế

  • Không có khay nhớ tạm hình ảnh: Termux khay nhớ tạm API chỉ hỗ trợ văn bản
  • Không có tệp nhị phân gốc: Một số phần phụ thuộc gốc tùy chọn (như mô-đun clipboard) không có sẵn trên Android ARM64 và bị bỏ qua trong quá trình cài đặt
  • Quyền truy cập bộ nhớ: Để truy cập các tệp trong /storage/emulated/0 (Tải xuống, v.v.), hãy chạy termux-setup-storage một lần để cấp quyền

Khắc phục sự cố

Bảng nhớ tạm không hoạt động

Đảm bảo cả hai ứng dụng đều được cài đặt:

  1. Termux (từ GitHub hoặc F-Droid)
  2. Termux:API (từ GitHub hoặc F-Droid)

Sau đó cài đặt công cụ CLI:

pkg install termux-api

Quyền bị từ chối đối với bộ nhớ dùng chung

Chạy một lần để cấp quyền lưu trữ:

termux-setup-storage

Node.js vấn đề cài đặt

Nếu npm không thành công, hãy thử xóa bộ nhớ đệm:

npm cache clean --force