Настройка, расширение, параметры платформы и справочник API для Pi.

Termux (Android) Настройка

Pi работает на Android через Termux, эмулятор терминала и среду Linux для Android.

Предварительные условия

  1. Установите Termux из GitHub или F-Droid (не из Google Play, эта версия устарела)
  2. Установите Termux:API из GitHub или F-Droid для интеграции буфера обмена и других устройств.

Установка

# 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-clipboard-set и termux-clipboard-get при работе в Termux. Чтобы они работали, необходимо установить приложение Termux:API.

Буфер обмена изображений не поддерживается на Termux (функция вставки изображений ctrl+v не работает).

Пример AGENTS.md для Termux

Создайте ~/.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 "текст" # Копировать
termux-clipboard-get # Вставить
```

## Notifications
```bash
termux-notification -t «Название» -c «Содержимое»
```

## Device Info
```bash
termux-battery-status # Информация о батарее
termux-wifi-connectioninfo # информация о Wi-Fi
termux-telephony-deviceinfo # Информация об устройстве
```

## Sharing
```bash
termux-share -a send file.txt # Поделиться файлом
```

## Other Useful Commands
```bash
termux-toast "message" # Быстрое всплывающее окно с тостом
termux-vibrate # Вибрация устройства
termux-tts-speak "привет" # Преобразование текста в речь
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

Node.js проблемы с установкой

Если npm не работает, попробуйте очистить кеш:

npm cache clean --force