Справочное руководство по CLI Pi Agent

Ниже приведён справочник по общим параметрам командной строки Pi Agent.


Параметры режима

Следующие параметры управляют режимом работы Pi Agent. Если они не указаны, по умолчанию открывается интерактивный интерфейс.

ПараметрОписаниеПример
(По умолчанию)Интерактивный режим, терминальный TUI-интерфейспи
-p, --printРежим печати, завершает работу после вывода результатаpi -p "summarize code"
--mode jsonРежим JSON, все события выводятся в виде строк JSONpi --mode json -p "summarize"
--mode rpcРежим RPC, протокол JSONL через stdin/stdoutpi --mode rpc
--export <input> [output]Экспорт сессии в HTML; путь вывода можно опуститьpi --export abc123 session.html

Параметры модели

Следующие параметры используются для указания провайдера, модели и уровня рассуждений; подходят для временного переключения без изменения файлов конфигурации.

ПараметрОписаниеПример
--provider nameУказать провайдера ИИpi --provider anthropic
--model patternID модели, поддерживает форматы provider/id и :thinkingpi --model openai/gpt-4o
pi --model sonnet:high
--api-key keyПередайте API-ключ напрямую, с наивысшим приоритетом; замените значение из примера на свой ключpi --api-key sk-ant-api03-xxxx
--thinking levelУровень рассуждений: off/minimal/low/medium/high/xhigh/maxpi --thinking high
--models patternsСписок моделей через запятую, ограничивает переключение по Ctrl+Ppi --models "claude-*,gpt-4o"
--list-modelsПоказать список всех доступных моделейpi --list-models

Параметры сеанса

Следующие параметры определяют, какой сеанс используется в этом запуске и где сохраняются файлы сеанса.

ПараметрОписаниеПример
-c, --continueПродолжить последнюю сессиюpi -c
-r, --resumeПросмотр и выбор исторического сеансаpi -r
--session path|id使用指定的会话文件或 UUIDpi --session abc123
--fork path|id从指定的会话派生新会话pi --fork abc123
--session-dir dir自定义会话存储目录;默认目录为 ~/.pi/agent/sessions/,此参数会临时替换它pi --session-dir .pi/sessions
--no-session临时模式,不保存会话pi --no-session
-n, --name nameЗадать отображаемое имя сеансаpi --name "Рефакторинг модуля аутентификации"

Параметры инструментов

Следующие параметры управляют доступностью встроенных инструментов и используются для ужесточения разрешений или для чистого общения.

ПараметрОписаниеПример
-t, --tools listВнести указанные инструменты в белый список, через запятуюpi --tools read,bash,edit,write
-xt, --exclude-tools listОтключить указанные инструменты, через запятуюpi --exclude-tools bash
-nbt, --no-builtin-toolsОтключить все встроенные инструменты, оставить инструменты расширенийpi --no-builtin-tools
-nt, --no-toolsОтключить все инструменты, режим чистой беседыpi --no-tools

Параметры ресурсов

Следующие параметры управляют загрузкой расширений, Skills, шаблонов и тем. Параметры с префиксом --no- используются для отключения автообнаружения.

ПараметрОписаниеПример
-e, --extension sourceЗагрузить расширение, можно использовать многократноpi -e ./my-ext.ts -e npm:@foo/bar
--no-extensionsОтключить автообнаружение расширенийpi --no-extensions
--skill pathЗагрузить навык, можно использовать многократноpi --skill ./my-skill
--no-skillsОтключить автообнаружение навыковpi --no-skills
--prompt-template pathЗагрузить шаблон промпта, можно использовать многократноpi --prompt-template ./review.md
--no-prompt-templatesОтключить автообнаружение шаблоновpi --no-prompt-templates
--theme путьЗагрузить тему, можно использовать многократноpi --theme ./my-theme.json
--no-themesОтключить автообнаружение темpi --no-themes
-nc, --no-context-filesОтключить загрузку AGENTS.md/CLAUDE.mdpi -nc

Другие параметры

Следующие параметры переопределяют поведение, такое как системный промпт, доверие к проекту и справочная информация.

ПараметрОписаниеПример
--system-prompt текстЗаменить системный промпт по умолчаниюpi --system-prompt "You are a Python expert"
--append-system-prompt textДобавить к системному промптуpi --append-system-prompt "Reply in Chinese"
--tui-modeРежим интерфейса, например, fullscreen; если не указан, используется обычный режимpi --tui-mode fullscreen
--use-themeУказать тему для загрузки; действует только для текущего запуска, не изменяет конфигурациюpi --use-theme "dark-plus"
--verboseПринудительно отображать подробную информацию о запускеpi --verbose
-a, --approveДоверять локальным файлам проекта для этого запускаpi -a
-na, --no-approveНе доверять локальным файлам проекта для этого запускаpi -na
--Разделитель; содержимое после него передаётся в запрос как естьpi -- @notes.md Кратко изложи эту заметку
-h, --helpПоказать справочную информациюpi -h
-v, --versionПоказать номер версииpi -v

-aи-naВзаимоисключающие; в одном запуске можно указать только один.

Оба ограничены только текущим запуском и не будут записаны в trust.json.


Подкоманды pi

Помимо параметров запуска, pi также предоставляет набор подкоманд для управления пакетами расширений и собственными обновлениями.

ПодкомандаОписание
pi install <source>Установить пакет расширения; добавьте -l для локальной установки в проект
pi remove <source>Удалить установленный пакет расширения
pi uninstall <source>Псевдоним для remove, тот же эффект
pi listПоказать список установленных пакетов расширений
pi updateОбновить сам pi и пакеты расширений; поддерживает --self, --all, --models, --extensions, --extension <source>
pi configВключить или отключить различные ресурсы, предоставляемые пакетами расширений

Связанные переменные среды

Следующие переменные среды влияют на аутентификацию, работу сети и терминала и могут служить дополнительной конфигурацией помимо параметров командной строки.

ПеременнаяНазначениеПример
ANTHROPIC_API_KEYАльтернативный способ аутентификации Anthropic; используется, когда вход не выполнен через подписку /loginsk-ant-api03-xxxx
HTTP_PROXY / HTTPS_PROXYУкажите прокси-сервер для запросов APIhttp://127.0.0.1:7890
NO_PROXYБелый список прокси; совпавшие хосты не проходят через проксиlocalhost,127.0.0.1
COLORTERMОдно из эталонных значений для автоопределения truecolor; если определение не удалось, используйте PI_TRUE_COLOR=1 для принудительного включения или настройте terminal.trueColortruecolor

Для прокси, требующих длительного использования, рекомендуется прописать в~/.pi/agent/settings.jsonзначениеhttpProxy。

Эта конфигурация действует только в глобальном файле конфигурации; запись её на уровне проекта.pi/settings.jsonнедействительна.


Аргументы файлов

Использование@Префикс для обращения к файлам:

$ pi @prompt.md "回答这个问题"
$ pi -p @screenshot.png "图中有什么"
$ pi @src/code.ts @src/test.ts "对比这两个文件"

Взяв вторую команду в качестве примера, вывод будет похож на:

The image is a screenshot of a login page, which includes a username input field, a password input field, and a login button.
Другие расширения