# Pi-Harness
English ·
简体中文 ·
繁體中文 ·
日本語 ·
한국어 ·
Русский ·
Français ·
Deutsch
Operational Superset для Pi Coding Agent
Native Pi с визуальной рабочей областью, управлением запусками, восстановлением и командами агентов.
Pi Coding Agent ⊂ Pi-Harness
Скачать ·
Создать своё оформление ·
Скриншоты
## Зачем нужен Pi-Harness?
Pi-Harness переносит Pi Coding Agent в настольную рабочую область для macOS, Windows и Linux. Управляйте разговорами, проектами, файлами, Git, моделями и Skills в одном месте, проверяйте запуски, задавайте бюджеты, восстанавливайте работу и координируйте команды агентов.
Агентов запускает Native Pi. Сессии, конфигурация, инструменты, Skills и расширения сохраняют совместимость с Pi; им можно пользоваться и вне настольного приложения.
## Native Pi и Pi-Harness
Pi-Harness — операционное надмножество Pi Coding Agent: к возможностям Native Pi добавлены наблюдение, управление, восстановление, координация агентов и визуальная рабочая область.
| Возможность | Native Pi | Pi-Harness |
| ------------------------ | --------- | -------------------------- |
| Agent Runtime | Да | Native Pi |
| Agent Loop | Да | Native Pi |
| Sessions | Да | Да + визуальное управление |
| Context | Да | Да + просмотр |
| Compaction | Да | Да + визуальное управление |
| Steering | Да | Да |
| Follow-up | Да | Да |
| Models | Да | Да + менеджер |
| Thinking | Да | Да + визуальное управление |
| Tools | Да | Да + выбор и политики |
| Skills | Да | Да + менеджер |
| Extensions | Да | Да + менеджер |
| Packages | Да | Да + менеджер |
| MCP / Codemode | Да | Да + выбор и политики |
| Runs | — | Да |
| Trace | — | Да |
| Replay | — | Да |
| Run Compare | — | Да |
| Evaluation | — | Да |
| Policy | — | Да |
| Budget | — | Да |
| Checkpoints | — | Да |
| Recovery | — | Да |
| Diagnostics | — | Да |
| Regression | — | Да |
| Artifacts | — | Да |
| Multi-Agent | — | Да |
| Task DAG | — | Да |
| Handoff | — | Да |
| Review Gates | — | Да |
| Worktree isolation | — | Да |
| Project architecture map | — | Да |
## Возможности
### Рабочая область, файлы и Git
Начните отдельный чат или откройте проект и продолжите сессию Pi. Просматривайте потоковые ответы, рассуждения, вызовы инструментов, изображения и изменения файлов; выбирайте модель, уровень рассуждений и инструменты, сжимайте контекст разговора. Инструменты рабочей области открывают Harness и агентов, сохраняя разговор и неотправленный черновик.
Доступны поиск и просмотр файлов, предпросмотр медиа и документов, лёгкий текстовый редактор с подсветкой синтаксиса, номерами строк, поиском, отменой/повтором, явным сохранением и защитой от конфликтов внешних изменений. Git предлагает различия, историю, графики активности, коммиты, необязательную генерацию сообщений коммитов с ИИ и worktree.
### Провайдеры и модели
Настройте совместимые с Pi провайдеры по шаблонам или собственным адресам, управляйте данными доступа, получайте список моделей там, где это поддерживается, проверяйте подключение и выбирайте модель чата. Поддерживаемые модели изображений позволяют создавать и редактировать изображения, а затем скачивать результат.
### Skills, расширения, пакеты и MCP
В центре возможностей просматривайте и редактируйте встроенные и локальные Skills, управляйте пакетами и расширениями Pi. Введите `@` в поле сообщения для поиска и вызова установленного Skill. Подключайте MCP через поддерживаемые пакеты. Дополнения [Superpowers](https://github.com/obra/superpowers) и [Odai](https://github.com/orziz/odai) можно устанавливать, обновлять и удалять по своему выбору.
### Harness: наблюдение, управление и восстановление
Просматривайте Runs, Trace, Replay, временную шкалу и действия инструментов. Сравнивайте запуски, отслеживайте ветвления и повторы в Run Tree, проверяйте токены, стоимость, длительность, артефакты и статистику проекта.
Задавайте политики инструментов и бюджеты запусков, создавайте контрольные точки, продолжайте, ветвите и повторяйте работу. Оценка, диагностика и базовые запуски для проверки регрессий помогают проверять результаты и находить причины сбоев по записанным данным.
### Команды агентов и координация задач
Координируйте агентов Pi с помощью повторно используемых команд и шаблонов. Назначайте зависимости, приоритеты и исполнителей, запускайте задачи вручную, последовательно или параллельно, передавайте результаты и артефакты, применяйте этапы проверки. Worktree разделяют изменения агентов; бюджеты, подсказки о конфликтах, пауза, продолжение, остановка, повтор, пропуск и переназначение помогают управлять работой.
### Локальная история разговоров
Просматривайте историю Claude Code, Codex (включая настольное приложение и архив), Cursor, Cursor Agent, Gemini CLI, OpenCode и Pi вместе. Доступны поиск, фильтры по источнику, проекту и датам, а также собственные папки истории.
Исходный разговор доступен только для чтения. Проверьте передачу задачи и отредактируйте следующую инструкцию, затем продолжите в новом чате Pi в том же проекте. Просмотр, локальный предпросмотр и повторное сканирование не расходуют токены модели. Необязательная сводка с ИИ использует настроенную модель только по запросу.
### Архитектура проекта
Откройте Architecture в рабочей области для просмотра модулей, зависимостей, точек входа и ссылок на исходный код. Фильтруйте пакеты, выделяйте модуль, переключайте страницы карты, меняйте масштаб и включайте полный экран. Сохраняйте снимки анализа, проверяйте уведомления об изменениях исходников и экспортируйте JSON, автономный HTML или текущий вид в PNG.
Локальный анализ не расходует токены модели; описания ИИ необязательны. Связи импортов JavaScript, TypeScript и Vue анализируются локально, для других поддерживаемых языков доступен файловый индекс. Область охвата и ограничения анализа указаны явно.
### Темы и собственное оформление
Выбирайте классические палитры, Ming, Starship Cockpit, фоны macOS 27 или импортированное оформление. Новые установки используют тёмную тему. Настраивайте имена в чате, значок приложения, локальный фон, свечение окна и экрана, эффект пламени в поле ввода. Проверка среды сопровождается стартовой анимацией; версия без маскота сохраняет общие настройки оформления.
### Среда и настройки приложения
Проверяйте Node.js, npm, PATH, Pi Coding Agent и текущую конфигурацию. В поддерживаемых средах устанавливайте, обновляйте и восстанавливайте Pi; используйте диагностику, резервные копии конфигурации и проверку обновлений приложения. Интерфейс доступен на восьми языках.
## Создайте собственное оформление
Используйте [шаблон оформления Pi-Harness](https://github.com/wangmiaozero/pi-harness-skin-starter) для создания нужного стиля.
1. Используйте репозиторий как шаблон или скачайте его.
2. Откройте его с агентом для программирования и опишите стиль в готовом запросе.
3. Импортируйте результат через **Настройки → Тема → Импортировать тему**.
Многоязычный шаблон содержит рекомендации по цветам, превью, фону и необязательному изображению персонажа. Обновляйте и распространяйте оформление в отдельном репозитории.
## Скриншоты
Интерфейсы сгруппированы по темам. Дополнительные виды доступны в [полном указателе скриншотов](docs/README.md).
### Классическая тема
#### Рабочая область
[](docs/%E5%8A%9F%E8%83%BD%E7%95%8C%E9%9D%A2/%E7%BB%8F%E5%85%B8%E4%B8%BB%E9%A2%98/%E5%B7%A5%E4%BD%9C%E5%8C%BA.png)
Git · Провайдеры и модели · Центр возможностей · Harness · Архитектура проекта
#### Git
[](docs/%E5%8A%9F%E8%83%BD%E7%95%8C%E9%9D%A2/%E7%BB%8F%E5%85%B8%E4%B8%BB%E9%A2%98/Git.png)
#### Провайдеры и модели
[](docs/%E5%8A%9F%E8%83%BD%E7%95%8C%E9%9D%A2/%E7%BB%8F%E5%85%B8%E4%B8%BB%E9%A2%98/Provider%E4%B8%8E%E6%A8%A1%E5%9E%8B-1.png)
#### Центр возможностей
[](docs/%E5%8A%9F%E8%83%BD%E7%95%8C%E9%9D%A2/%E7%BB%8F%E5%85%B8%E4%B8%BB%E9%A2%98/%E8%83%BD%E5%8A%9B%E4%B8%AD%E5%BF%83-1.png)
#### Harness
[](docs/%E5%8A%9F%E8%83%BD%E7%95%8C%E9%9D%A2/%E7%BB%8F%E5%85%B8%E4%B8%BB%E9%A2%98/%E5%B7%A5%E5%85%B7Harness-1.png)
#### Архитектура проекта
[](docs/%E5%8A%9F%E8%83%BD%E7%95%8C%E9%9D%A2/%E7%BB%8F%E5%85%B8%E4%B8%BB%E9%A2%98/%E9%A1%B9%E7%9B%AE%E6%9E%B6%E6%9E%84-1.png)
### Интерфейсы Ming
Общие настройки · Темы и оформление
#### Общие настройки
[](docs/%E5%8A%9F%E8%83%BD%E7%95%8C%E9%9D%A2/%E5%A4%A7%E6%98%8E/%E9%80%9A%E7%94%A8%E8%AE%BE%E7%BD%AE.png)
#### Темы и оформление
[](docs/%E5%8A%9F%E8%83%BD%E7%95%8C%E9%9D%A2/%E5%A4%A7%E6%98%8E/%E4%B8%BB%E9%A2%98%E7%9A%AE%E8%82%A4%E5%BA%93.png)
### Галерея тем
Ming · Чиновник среди снегов · Ming · Флейтистка в снежную ночь · Ming · Книжница при луне · Starship Cockpit · macOS 27 · Liquid Ether
#### Ming · Чиновник среди снегов
[](docs/%E4%B8%BB%E9%A2%98%E5%B1%95%E7%A4%BA/%E5%A4%A7%E6%98%8E/%E9%9B%AA%E5%A2%83%E6%9C%9D%E8%87%A3.png)
#### Ming · Флейтистка в снежную ночь
[](docs/%E4%B8%BB%E9%A2%98%E5%B1%95%E7%A4%BA/%E5%A4%A7%E6%98%8E/%E9%9B%AA%E5%A4%9C%E7%AC%9B%E5%A7%AC.png)
#### Ming · Книжница при луне
[](docs/%E4%B8%BB%E9%A2%98%E5%B1%95%E7%A4%BA/%E5%A4%A7%E6%98%8E/%E6%9C%88%E5%9F%8E%E4%B9%A6%E5%A7%AC.png)
#### Starship Cockpit
[](docs/%E4%B8%BB%E9%A2%98%E5%B1%95%E7%A4%BA/%E6%98%9F%E8%88%B0/%E9%9C%9C%E6%98%9F%E9%A2%86%E8%88%AA.png)
#### macOS 27 · Liquid Ether
[](docs/%E4%B8%BB%E9%A2%98%E5%B1%95%E7%A4%BA/macOS%2027/Liquid%20Ether.png)
## Скачать
Скачайте опубликованный установщик на [GitHub Releases](https://github.com/wangmiaozero/pi-harness/releases), выбрав файл для своей платформы.
| Платформа | Установщик |
| ------------------- | --------------------------- |
| macOS Apple Silicon | `.dmg` · `arm64` |
| macOS Intel | `.dmg` · `x64` |
| Windows x64 | `.exe` · Установщик Windows |
| Linux x64 | `.AppImage` |
Пользователям готового приложения не нужно клонировать репозиторий или устанавливать pnpm. В поддерживаемых средах приложение помогает установить Pi и настроить его окружение.
> Сборки сообщества для macOS могут быть не подписаны. Если первый запуск заблокирован, используйте **Системные настройки → Конфиденциальность и безопасность → Всё равно открыть**.
## Начало работы
1. Запустите Pi-Harness и проверьте среду на странице обзора.
2. Настройте провайдера, проверьте подключение и выберите модель.
3. Начните отдельный чат или откройте проект.
4. Начните или продолжите сессию Pi и работайте с разговорами, файлами и Git.
5. Для управления запусками и командами откройте инструменты рабочей области.
## Требования
Приложение поддерживает macOS Apple Silicon, macOS Intel, Windows x64 и Linux x64. В поддерживаемых средах Pi Coding Agent можно установить или восстановить из приложения. Для запуска из исходников нужны Node.js ≥ 22.22.2 и pnpm 9.12.1.
## Документация
- [Указатель скриншотов](docs/README.md)
- [История изменений](CHANGELOG.md)
## Благодарности и автор
Pi-Harness создан вокруг официальных [Pi Coding Agent и Pi Agent Harness](https://github.com/earendil-works/pi).
Автор и сопровождающий: [wangmiao](https://github.com/wangmiaozero) · [tuziling84@gmail.com](mailto:tuziling84@gmail.com).
## Лицензия
Pi-Harness распространяется по лицензии [GNU Affero General Public License v3.0 only](LICENSE) (`AGPL-3.0-only`).
Copyright © 2026 [wangmiao](https://github.com/wangmiaozero).