Ask AI – макрос для взаимодействия с ChatGPT (и другими LLM-сервисами) в FAR

Доступ к сервисам возможен как посредством разнообразных консольных утилит, так и напрямую через REST API.

Каждый из LLM-сервисов имеет свои достоинства и недостатки – выбор за пользователем.

Макрос назначен на Ctrl+B и открывает диалог для ввода запроса и настройки параметров генерации. При этом выделение редактора передаётся в качестве контекста.

Может быть также запущен в качестве скрипта LuaShell.

Вывод ответа осуществляется в отдельном редакторе.

Макросы, активные в окне с выводом:

• Ctrl+Shift+Ins:
  • скопировать выделенный текст, склеив свёрнутые строки обратно в параграфы;
  • при отсутствии выделения ищет и обрабатывает блок кода под курсором.
• Alt+F2 полностью убрать форматирование (свёртку).

Ctrl+B:Double позволяет в любой момент открыть окно с выводом повторно.

Если выделен текст, то нажатие Ctrl+B:Hold продолжает чат без открытия диалога, передавая выделение в качестве нового запроса.

Кроме того, прилагается файл macros.lua.sample с примерами макросов для быстрых действий, см. Профили.

Примечание: составные сочетания типа Ctrl+B:Double/Ctrl+B:Hold предполагают использование модуля MacroEx.
Альтернативно, можно заменить сочетания на простые, см. Опции askai.lua.

Диалог

Диалог служит для ввода запроса и настройки различных параметров.
Ранее набранные приглашения доступны в истории поля ввода.
Для удобного редактирования объёмных/многострочных запросов рекомендуется макрос EditBoxToEditor.

Вместе с запросом передаётся выделенный в редакторе текст.
Если в запросе присутствует шаблон {{%input%}}, то выделенный текст подставляется на его место.
В противном случае выделенный текст добавляется в конец запроса.

Последующие запросы учитывают предыдущий контекст, образуя диалог (сессию), если не настроено иное.

На верхней рамке диалога отображается имя текущего профиля, перейти к нему можно не только курсорными клавишами, но и по CtrlHome.

В поле редактирования запроса можно переместиться с помощью хоткея или нажатием PgUp.

Примечание: повторные нажатия CtrlHome / PgUp переключают фокус между полями профиля / запроса.

Доступны такие настройки:

• Session - по умолчанию (состояние [?]) сессия продолжается, пока открыт редактор с выводом.
  Также сессию можно в любой момент принудительно очистить кнопкой “-”.
• Timeout - предельное время ожидания ответа на запрос (для “нативных” конфигураций).
• Форматирование вывода по заданной границе или по ширине окна (состояние [?]).
  Блоки кода не форматируются.
• Установка различных параметров генерации (в зависимости от выбранного сервиса/утилиты).
  Значения запоминаются в истории и легко доступны для повторного выбора.
  Некоторые параметры специфичны для отдельной конфигурации, другие могут разделяться между разными (посредством общей истории).
• Возможность установки переменных окружения, необходимых для отдельных утилит.

Кнопки:

• [ Utility cfg ] доступна в случае, если используемая активной конфигурацией утилита держит настройки в собственном файле; нажатие кнопки позволяет открыть его в редакторе.
• [ Authorization ] доступна если активной конфигурацией предусмотрена авторизация через браузер.
  Результатом успешной авторизации является заполнение или обновление поля apikey.
• [ Presets - F5 ] позволяет подставить сразу несколько параметров набором (“пресетом”).
  По нажатию кнопки открывается Список пресетов.
  Пресеты также могут реализовывать собственную авторизацию, которая будет инициироваться загрузкой пресета в первый раз (или при очищеном поле apikey).
• [ Models - F6 ] запрашивает список моделей через API, если это предусмотрено конфигурацией, в противном случае кнопка недоступна.
  Также фиксированный список моделей может быть уже предварительно занесён в историю поля ввода (актуально для некоторых пресетов и конфигураций).
• [ Providers - ^B ] или же повторное нажатие Ctrl+B позволяет переключиться на другую конфигурацию, открывая Меню выбора конфигурации провайдера.
• { Go! } или Enter – запуск генерации ответа модели, вывод открывается в отдельном редакторе.

Дополнительные шорткаты:

• Shift+F4 - задать заголовки запроса (для OpenAI-compatible) в виде таблицы Lua или Moonscript (удобно использовать single line table literal).
• Shift+F5 - открыть историю поля apibase.
• Shift+F6 - открыть отсортированный в алфавитном порядке список истории моделей.
• Ctrl+H - переключение между полным и “компактным” режимом диалога (без параметров конфигурации и кнопок).
• Alt+F4 - открывает в редакторе файл активной конфигурации провайдера (*.lua.cfg), например при необходимости изменить набор доступных параметров.

По умолчанию диалог открывается в полном режиме, но это можно изменить параметром compactDlg, см. Опции askai.lua.

Профили

По существу профиль представляет собой именованный набор значений, сохраняемых в истории соответствующих полей ввода.

Профили задуманы как средство для выполнения “быстрых действий” с использованием макросов (см. ниже), и без этого не несут большой ценности, т.к. для обычного свободного чата достаточно штатного выбора из истории.

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

Для обеспечения этого и задуманы профили.

Управление

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

Выбрать существующий профиль можно из выпадающего списка, по Shift+Del в этом списке профиль можно удалить.

Находясь в любом поле ввода с помощью Ctrl+Up можно открыть список истории соответствующего поля из профиля default.

Использование

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

Примеры макросов можно увидеть в macros.lua.sample (для загрузки переименовать в файл с расширением .lua).

Это самый обычный макрофайл, загружаемый штатным образом, а функция askAI доступна в нём как модуль, через require.

В макросе задаётся только имя профиля, а соответствующая роль, запрос (prompt), провайдер и прочее настраиваются уже в диалоге. Введённые значения запоминаются каждый раз при закрытии диалога по Enter/CtrlEnter; также можно сохранить их принудительно нажатием Shift+Enter в любой строке редактирования.

Примечание: заранее создавать профиль нет необходимости, диалог со всеми настройками будет и так открыт при первом вызове макроса (сначала надо будет выбрать провайдера).

Работа с пресетами

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

“Пресет” представляет собой именованный набор параметров, подставляемых в соответствующие поля диалога.
Пресеты хранятся в файлах *.preset и являются Lua-файлами.

Создать новый пресет можно нажав Shift+F4 или Ins.

Над пресетами в списке доступны следующие действия:

• Enter - заполнить поля диалога значениями из пресета.
• F4 - открыть в редакторе.
• F5 - скопировать, F6 - переименовать.
• F8 или Del - удалить.

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

Нажатием Ctrl+H можно принудительно отобразить все пресеты.

См. также: обзор пресетов для сервисов совместимых с OpenAI API.

Установка

• Содержимое архива разместить в отдельной директории, где-то в Macros/scripts.
• Для LuaShell – стандартным образом, т.е. где-то в Macros/utils, или в любой другой директории, доступной через %PATH%.
• Для работы с сетью непосредственно, через “нативные” конфигурации, такие как openai.lua.cfg, необходимы следующие модули:
  • LuaSocket, LuaSec: https://github.com/FarManagerLegacy/LuaBinaries/releases
    и их зависимости: OpenSSL, MS Visual C++ Redist.
  • Практически любой JSON модуль, предоставляющий функции encode/decode.
    • По умолчанию ищется модуль с одним из имён: cjson, rsjson, ljson, dkjson, lunajson, или просто json (см. также lua-users wiki).
      Мною тестировались Lua CJSON и dkjson.
    • Для явного указания имени модуля предусмотрена опция json_module в начале скрипта (см. ниже).
• Также можно работать через сторонние утилиты:
  • Для запуска утилит рекомендуется модуль Piper (положить в modules).
    В случае его отсутствия для запуска будет использована стандартная функция io.popen, в сочетании
    с созданием временных файлов и перенаправлением их в стандартный ввод посредством команд shell.
  • В %PATH% должны быть утилиты, соответствующие имеющимся файлам определений (*.lua.cfg), см. раздел Обзор утилит.
• При работе с профилями, чтобы при удалении профиля очищалась и связанная с ним история, опционально можно установить модуль LuaSQLite3, который присутствует например в дистрибутиве плагина Polygon.

Не являются абсолютно необходимыми, но улучшают опыт использования следующие сторонние скрипты:

• EditBoxToEditor - открытие в редакторе объёмного/многострочного текста из полей ввода.
• MacroEx - составные комбинации для запуска макросов.
• MenuAutoFilter — автоматическая активация фильтра в меню и списках истории.

Настройка

Большая часть конфигураций требует задания некоторых параметров в диалоге.
Наиболее важные параметры - такие как apibase, apikey и model - определяются выбранным сервисов.

Некоторые утилиты используют файл настройки, доступный как из диалога, так и в списке конфигураций (подробнее см. в документации соответствующих утилит).

Опции askai.lua

В начале файла скрипта можно увидеть такие параметры:

• key, keyList, keyOutput, keyReply, keyCopy: сочетания для вызова основных макросов, перечисленных в Описании.
• smallDlg: отображать диалог без полей.
• compactDlg: по умолчанию открывать Диалог в “компактном” режиме, без настроек.
• json_module: имя модуля для работы с json.

Значения этих параметров можно изменить прямо в коде. Но чтобы после каждого обновления скрипта не приходилось вручную восстанавливать изменённые значения, рекомендуется использовать возможности cfgscript из пакета ScriptsBrowser.

Меню выбора конфигурации провайдера

В комплекте идут конфигурации для ряда опробованных мной утилит/сервисов (но легко добавить и новые).

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

• Выбор конфигурации осуществляется через меню, доступное как прямо из диалога, так и отовсюду посредством макроса.
  Выбор запоминается.
• Верхний раздел списка содержит “нативные” конфигурации, работающие с сетью средствами Lua.
  Раздел не будет отображаться, если отсутствуют необходимые модули, см. Установка.
  Стандартные конфигурации (см. обзор): OpenAI-compatible, Cohere, Google: Gemini, Gemini CLI API, Antigravity API.
• Нижний раздел списка содержит определения, использующие внешние утилиты (см. обзор ниже).
  По умолчанию список содержит только установленные утилиты, полный список – по Ctrl+H.
  • Утилиты необходимо скачать самостоятельно (соответствующий сайт открывается по Alt+F1 из меню).
  • Утилитам может требоваться настройка (помимо параметров в диалоге), подробнее см. в их собственной документации.
    Быстрый доступ к файлу с настройками (если применимо) - из меню по F4, или в диалоге по кнопке [ Utility cfg ].
• По Alt+F4 - быстрый доступ к файлу с определением той или иной конфигурации (*.lua.cfg).

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

Однако в некоторых случаях может оказаться проще или удобнее работать и через утилиты, например:

• если соответствующая утилита уже есть (и используется из командной строки);
• если утилита уже содержит настройки провайдеров (как gh models, tgpt, pytgpt);
• если пользователю проще скачать утилиту, чем выполнить другие инструкции по установке.

Обзор утилит

• gh models - GitHub Models extension.
  Инструкции по установке см. на домашней странице.
  Необходим аккаунт GitHub. Действуют лимиты.
• tgpt, pytgpt - не требуют предварительной настройки.
  Недостаток: не гарантирована стабильность (иногда требуется обновление утилит).
• Прочие утилиты - aichat, chatgpt-cli, mods, sgpt, smartcat - работают с OpenAI API (и совместимыми).
  Требуют задания некоторых параметров, прежде всего apibase, apikey и model. Их значения зависят от выбранного сервиса.
  В зависимости от утилиты, параметры или надо установить через файл настроек (как описано выше), или они могут быть доступны сразу в диалоге, если они передаются как аргументы командной строки, или через переменные окружения.
  Для заполнения параметров в диалоге можно использовать пресеты, идущие в комплекте (см. обзор).
• Дополнительно: в директории extra есть конфигурации для ещё нескольких утилит, таких как Gemini CLI, Copilot CLI, …
  При необходимости их можно использовать поместив в основную директорию (лучше сделать ссылку).
  Отделены они поскольку не очень удобны для использования в Ask AI (например долго стартуют).
  Обычно они имеют соответствия в “нативных” конфигурациях.

Обзор онлайн-сервисов

Выбор модели

На данный момент наиболее сильные модели это:

• gpt-5.2, gpt-5.1, gpt-4.1, gpt-4o, o4, o3, o1 (а также модели с суффиксами -mini) от OpenAI;
• gemini-3-pro от Google;
• claude-opus-4.5, -sonnet-4.5 от Anthropic;
• grok-4.1 от xAI;

Из опенсорсных - все что побольше, например:

• gpt-oss-120b от OpenAI;
• из серии Llama от Meta AI: llama-4-maverick, llama-3.1-405b, llama-3.2-90b, llama-3.3-70b;
• Mistral Large 3;
• ряд моделей от китайских разработчиков также демонстрирует хорошие результаты: DeepSeek, Qwen от Alibaba, GLM-4.7 от Zhipu AI, Kimi K2 от Moonshot AI, Baidu ERNIE, MiniMax, LongCat от Meituan, Xiaomi MiMo, Yi от 01.AI.

Ориентироваться можно по рейтингу LMArena.

Обзор провайдеров

• OpenAI – оригинальный разработчик ChatGPT.
  Работа с этим апи возможна как с помощью сторонних утилит, так и с помощью “нативной” конфигурации.
• Другие OpenAI-совместимые: Mistral AI, xAI Grok, и несметное количество других провайдеров.
• Провайдеры с собственным API, такие как Google Gemini, Anthropic Claude, Cohere Command, требуют поддержки посредством соответствующей “нативной” конфигурации.
  Кроме того существуют прокси сервисы для конвертации API в совместимый с OpenAI формат, некоторые доступны онлайн, другие предназначены для локального использования.

В комплекте идут следующие нативные конфигурации:

• OpenAI-compatible
  В комплекте поставки идут готовые пресеты для множества совместимых сервисов, подробнее они рассматриваются в следующем разделе.
• Cohere: бесплатно 1,000 запросов в месяц.
• Google Gemini: бесплатный доступ к моделям уровня до gemini-3-flash-preview.
  Free-tier лимиты непостоянны, и сейчас они у меня например составляют (для каждой модели отдельно) по 20 запросов в день.
  • Gemini CLI API: на основе внутреннего API Gemini CLI; логин через боаузер.
    Предоставляется бесплатный доступ к моделям уровня до gemini-3-pro-preview.
    Дневная квота: 1000 запросов.
  • Antigravity API: использует внутренние API Google Antigravity; логин через боаузер.
    Предоставляется бесплатный доступ к моделям уровня до gemini-3-pro-high, а также claude-sonnet-4-5/claude-opus-4-5-thinking от Anthropic.
    Лимиты изменчивы, и конкретных цифр не указано, но в любом случае больше чем при использовании Google Gemini Free-tier.

Обзор пресетов для сервисов совместимых с OpenAI API

В комплекте со скриптом идёт набор пресетов, содержащих предварительно заданные значения apibase (и начальное значение model).
В большинстве случаев пользователю также требуется самостоятельно получить apikey, адрес сайта для регистрации можно найти в файле пресета (открывается из списка по F4).

С перечисленными ниже пресетами помимо конфигурации openai.lua.cfg совместимы также конфигурации некоторых утилит (кроме тех, которые хранят эти значения в собственных файлах настроек).

• Не требуют ключа (apikey) эти пресеты:
  • ch.at (заявлена gpt-4o)
  • opencode (gpt-5-nano, big-pickle, grok-code, minimax-m2.1-free, glm-4.7-free)
    Доступны и лучшие модели, но уже с ключом и за деньги (Anthropic, Gemini, OpenAI, Kimi, Qwen)
  • Следующие пресеты из поддиректории trial/:
    • deepinfra (всевозможные OpenSource модели): some anonymous usage allowed
    • ovh (gpt-oss-120b, DeepSeek-R1-Distill-Llama-70B, Meta-Llama-3_3-70B-Instruct): Анонимно: 2 запроса в минуту, на IP и на модель.
  • Некоторые пресеты из поддиректории extra/ (см. ниже)
• Для использования других надо зарегистрироваться и получить ключ. Следующие пресеты относятся к бесплатным сервисам (с определёнными лимитами):
  • cloudflare (@cf/openai/gpt-oss-120b, @cf/meta/llama-3.3-70b-instruct-fp8-fast, @cf/deepseek-ai/deepseek-r1-distill-qwen-32b и модели поменьше)
  • cohere (серии command-* и c4ai-aya-*)
  • gemini от Google
  • gitee.ai / moark (DeepSeek, ERNIE, gemma, GLM, gpt-oss, Kimi, MiniMax, Qwen, Yi, …): Бесплатно: 100 запросов в день.
  • github-copilot (модели от OpenAI, Anthropic, Google, xAI)
    Авторизация через браузер.
  • github-models (модели от Cohere, DeepSeek, Meta, Mistral AI, Microsoft, OpenAI, xAI и др.)
  • groq (OpenSource-модели до 120b: gpt-oss, llama-4-maverick, kimi-k2, qwen, …)
  • iflow (китайские OpenSource-модели: DeepSeek, GLM, Kimi, Qwen, TStars)
  • longcat: (LongCat-Flash-Chat, LongCat-Flash-Thinking): 500,000 токенов в день бесплатно.
  • mistral, codestral
  • nvidia (OpenSource-модели: DeepSeek, gpt-oss, Kimi, Llama, MiniMax, Mistral, Qwen, Phi-4, …)
  • poe (все популярные модели + пользовательские “боты”): 3000 поинтов в день на бесплатном плане
  • pollinations.ai (Claude, Gemini, Grok, Llama, Mistral, Nova, OpenAI, Perplexity, DeepSeek, Kimi, Qwen, …)
  • qwen-code-api (qwen3-coder-plus, qwen3-vl-plus): Бесплатно 2000 запросов в день.
    Авторизация через браузер.
  • sambanova (DeepSeek, gpt-oss, Llama, Qwen, …)
  • vercel (модели от Anthropic, Google, Meta, Mistral AI, OpenAI, xAI, и множество других, включая китайские OpenSource модели)
    Для регистрации требуется привязка кредитной карты.
    Free-аккаунты получают ежемесячно кредит $5. Некоторые модели бывают доступны бесплатно (см. в пресете).
• На некоторых сервисах только часть моделей доступна бесплатно:
  • clarifai (бесплатно до 1K запросов/месяц: gpt-oss, DeepSeek, Ministral, Qwen, …)
  • openrouter (до 50 запросов в день к бесплатным “:free” моделям, в том числе gemma, gpt-oss, Mistral, DeepSeek, Kimi, Llama, Qwen, Xiaomi MiMo, …;
    покупкой 10 кредитов лимит можно увеличить до 1000 запросов в день)
  • siliconflow (бесплатно - DeepSeek, Kimi, …)
  • z.ai, zhipu (бесплатно небольшие модели ~ 9B, вида glm-X.Xx-flash, см. в пресетах)
• Дополнительные пресеты расположены в поддиректориях.
  Чтобы они появились в списке, необходимо скопировать нужные из них в основную директорию (лучше сделать ссылку).
  • trial/: сервисы, для которых доступен пробный кредит.
  • paid/: без пробного периода (или кредит < $1).
  • extra/: прочие, среди которых:
    • сервисы, для бесплатного доступа к которым задействован их приватный API (например Cookie и/или другие требуемые данные в заголовках);
    • сервисы неопределённого происхождения.

Кроме того:

• keepass позволяет держать свои собственные пресеты в базе KeePass.
  Подобным образом можно организовать работу и с другими аналогичными утилитами.

---

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

Помимо самостоятельных провайдеров, можно встретить также сервисы не вполне понятного происхождения, не имеющие даже официального сайта. Таким в списке выше является tmrace и некоторые другие пресеты в директории extra.

По причине их неопределённого статуса пользоваться ими следует с осторожностью и не передавать чувствительные данные!

Подобных сервисов довольно много, некоторые например перечислены тут: cool ai stuff!