Настройки

Настройки приложения собраны в одном окне: внизу левого списка, под «Добавить доску», кнопка «Настройки» с шестерёнкой. Они действуют на все доски. Разделы:

• «Приложение» — тема, язык, справка и обратная связь;
• «ИИ» — переключатель «Агенты работают с карточками», агенты и прокси, см. «Подключение агентов»;
• «Обновления» — версия приложения и переход на новую, см. «Обновления»;
• «Люди» — кто есть на сервере и кто им управляет; раздел виден только администратору, см. «Свой сервер»;
• «Импорт и экспорт» — экспорт и импорт архива досок, см. «Перенос»;
• «Прочее» — «Доступ для других приложений» и сведения об установке. Раздела нет, когда ИИ выключен (см. «ИИ-агенты»).

Разделы, которые эта сборка не поддерживает, не показываются: на машине без агентов остаются «Приложение», «Обновления», «Импорт и экспорт» и «Прочее».

Агенты обоих видов — программы на этом компьютере и модели по ключу — подключаются в разделе «ИИ», там же их список и прокси: см. «Подключение агентов» и «Программы-агенты: адаптеры, npx и Node.js».

Приложение: тема, язык, справка

• Светлая или тёмная — «Светлая», «Тёмная», «Как в системе». Оформление у приложения одно; применяется сразу, подробно — «Светлая и тёмная».
• Язык — список языков приложения. Если язык не выбирали, действует язык системы. Шаблоны досок показываются на выбранном языке. Доска, созданная из шаблона, получает названия колонок и полей на том языке, который был выбран при её создании, и при смене языка не меняется — это ваши данные.
• Справка — «Руководство», кнопка «Открыть»: открывает это руководство. Ниже — «Дать обратную связь», кнопка «Написать»: открывает почтовую программу с адресом hello@deffun.com. Адрес написан и рядом с кнопкой — его можно скопировать, если почтовая программа не открылась.

ИИ-агенты

Переключатель «Агенты работают с карточками» в разделе «ИИ» включает и выключает в приложении всё, что связано с агентами. По умолчанию он включён.

Когда он выключен, приложение — обычная канбан-доска:

• в ⋯-меню доски нет «Папки…» и «Системный промпт доски…», в разделе «ИИ» — списка агентов;
• перенос карточки в колонку ничего не запускает;
• на карточке нет полей агентов — папки и ветки; в поле исполнителя предлагаются только люди;
• нет уведомлений агентов и точки на значке рядом с часами;
• в настройках нет раздела «Прочее», на телефоне — вкладки «Ждут».

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

Переключатель виден только в сборке, где агенты вообще есть.

Всё это доступно и до создания первой доски. Выбранные тема и язык хранятся самой установкой и переживают перезапуск.

Уведомления агента

Переключатель «Сообщать, когда агент ждёт ответа» — в разделе «ИИ», под переключателем агентов. Уведомление несёт сам вопрос и кнопки ответа: отвечать можно прямо из него, не открывая карточку.

Когда приложение свёрнуто или закрыто другим окном, уведомление приходит от системы: в нём видно, какой агент спрашивает и по какой карточке. Нажатие открывает карточку, и это же считается «я про вопрос знаю».

В выключенном состоянии переключатель убирает только уведомления. Янтарный значок на карточке остаётся, и точка на значке приложения рядом с часами — тоже: они показывают, что агент ждёт, и никого не прерывают.

На macOS разрешение на уведомления система спрашивает один раз — когда первый агент действительно чего-то ждёт. Если разрешение не дано, остаются уведомления в окне доски и значок рядом с часами.

Значок рядом с часами

Приложение держит значок в строке меню (в Windows и Linux — в системном лотке). На нём появляется янтарная точка, пока хотя бы один агент ждёт человека.

Нажатие открывает меню:

• «Открыть» — вернуть окно доски, даже если оно свёрнуто или закрыто.
• Список ждущих агентов, по одному на строку: имя агента и карточка. Нажатие открывает эту карточку. Если ждущих больше шести, последняя строка — «…и ещё N»: сколько агентов не поместилось.
• «Выход» — закрыть приложение целиком.

Значок не выключается: он ничего не прерывает и нужен именно тогда, когда на доску никто не смотрит.

Закрытое окно — это не выход

Окно доски можно закрыть: приложение продолжает работать, агенты — тоже. Агент доводит работу до конца, источники приносят карточки, уведомления приходят. На месте остаётся значок рядом с часами — он и говорит, что приложение работает, и возвращает окно обратно.

Возвращается то же окно с той же доской, а не заново загруженная страница. На macOS для этого годится и значок в Dock.

Выйти по-настоящему — «Выход» в меню значка (или ⌘Q, пока окно открыто). Выход останавливает работающих агентов: если агент не успел сказать, чем всё кончилось, карточка останется в своей колонке, а причина будет написана на ней.

Доступ для других приложений

Другое приложение может брать карточки одной колонки как свои задачи — так делает XXVI: колонка доски становится у него источником входящих. Для этого ему нужен токен.

1. Откройте раздел «Прочее» и в блоке «Доступ для других приложений» нажмите «Выдать токен».
2. Под блоком появится токен. Он показывается один раз: хранится только его хэш. Нажмите «Скопировать» и вставьте токен в другое приложение.
3. В другом приложении укажите доску и колонку по названию, как они написаны на доске.

Приложение с токеном может только читать карточки колонки: название, колонку, значения полей и время последнего изменения. Двигать и менять карточки оно не может.

• «Новый токен» выдаёт токен заново; прежний сразу перестаёт действовать.
• «Отозвать» закрывает доступ всем, у кого был токен.

Карточки отдаёт само приложение, поэтому на этой машине оно должно быть запущено. Если Pourquoi Pas? закрыт, другое приложение сообщит, что Pourquoi Pas? не запущен.

Файл настроек

Часть настроек агентов в окно не вынесена: их меняют редко, и правятся они руками в файле. Он лежит в каталоге установки:

• macOS — ~/Library/Application Support/pourquoipas/acp/config.json;
• Windows — %AppData%\pourquoipas\acp\config.json;
• Linux — ~/.config/pourquoipas/acp/config.json (или $XDG_CONFIG_HOME).

Приложение при правке файла лучше закрыть: оно перечитывает его при запуске.

Ключ	Что задаёт
maxConcurrent	сколько сессий работает одновременно на этой машине (по умолчанию 3)
sessionTimeoutMinutes	сколько может длиться один ход агента (15)
testTimeoutMinutes	сколько может длиться один прогон тестов (30)
sessionIdleMinutes	сколько сессия ждёт между ходами (30)
autoAllowTools	какими инструментами агент пользуется без подтверждения. У сессии, запущенной карточкой, спросить некого, поэтому всё, чего нет в списке, ей запрещено
worktreeMode	что делать в репозитории на доске, которую об этом не спрашивали: always — отдельное рабочее дерево на карточку, never — ветка в этой же папке.
artifactsDir	куда складываются скриншоты и отчёты тестовых прогонов

Колонок в этом файле нет: они — свойство самой доски и уезжают вместе с ней в экспорт и в шаблон.

Чего здесь нет

Настройки конкретной доски — папки и инструкции агентам — спрашиваются в ⋯-меню самой доски, по одному пункту на вопрос.