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
- 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)
- 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
piHỗ trợ bảng nhớ tạm
Các thao tác trong bảng nhớ tạm sử dụng termux-clipboard-set và termux-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` accessHạ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ạytermux-setup-storagemộ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:
- Termux (từ GitHub hoặc F-Droid)
- Termux:API (từ GitHub hoặc F-Droid)
Sau đó cài đặt công cụ CLI:
pkg install termux-apiQuyề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-storageNode.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