W LinuxДокументация

Ассистент ИИ

W поставляет ассистента ИИ, который работает в терминале и может управлять машиной через собственные инструменты W — читать раскладку экранов, переключать профиль питания, смотреть логи. Он опционален в полном смысле: от него ничего не зависит, и он ничего не делает, пока вы не настроите для него модель.

Super+W открывает палитру вопроса; ввод вопроса там передаёт его в полноценную сессию. w-ai в терминале — то же самое, а w-ai status печатает, что сейчас настроено.

Профили

Хаб → ИИ — это список профилей. Профиль — сохранённое сочетание какая программа ведёт сессию ассистента, с какой моделью она говорит и сколько она может сделать без спроса. Нажатие на неактивный профиль сразу делает его активным; активный несёт галочку.

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

Шеврон на строке разворачивает редактор. Каждое изменение применяется в момент выбора — кнопки сохранения нет, — и ничего из этого не спрашивает ваш пароль: это личная настройка, как раскладка клавиатуры.

Хост, провайдер и модель

  • Хост — программа, которая на самом деле ведёт сессию. W поставляет один встроенный; остальные — сторонние CLI со своим входом и своим обновлятором, поэтому они устанавливаются по запросу, на пользователя.
  • Провайдер — сервис за моделью. Что предлагает выпадающий список, зависит от выбранного хоста — для CLI с собственным входом по подписке он предлагает подписка, что означает: W вообще не передаёт API-ключ, а счёт выставляет вендор по вашему плану, а не за токены.
  • Модель — идентификатор модели. Он обязателен для встроенного хоста — оставьте пустым, и сессия не запустится. Для CLI-провайдера он помечен как необязательно, потому что этот CLI выбирает модель сам.

Когда выбранному хосту чего-то не хватает, прямо под ним появляется строка, которая об этом говорит — не установлен с кнопкой Установить, или не выполнен вход с кнопкой Войти. Обе открывают терминал и делают шаг за вас. Установка хоста не требует вашего пароля: она попадает в ваш собственный аккаунт.

Если сессия не запускается, w-ai ready в терминале отвечает почему одним словом.

Сторонние CLI, с которыми умеет работать W, — Claude Code, Codex и OpenCode. Свои инструменты и свою идентичность W передаёт им только когда запускает их сам — запустите claude, codex или opencode вручную в своём проекте, и это будет обычный инструмент, без чего-либо от W. OpenCode — единственный со своей подпиской (Zen) и одновременно прямым доступом к десяткам других провайдеров: выбирайте подписка для Zen, один из провайдеров, для которых W уже хранит ключ, либо настройте что угодно ещё прямо в OpenCode (opencode auth login).

Некоторые паки приносят ассистенту собственные инструменты — пак graphics, например, даёт ему рисовать в Inkscape и править внутри GIMP, а пак 3d — строить сцены в Blender. Они доезжают так же, при запуске, до любого хоста — в Goose они выключены, пока запросу не понадобится это приложение, так что обычные вопросы не несут их вес; w-ai status перечисляет их в строке MCP extra. Помеченный missing установлен на машине, но ещё не настроен для вашего аккаунта: w-pack setup <пак> (без пароля) и новая сессия.

API-ключи

Где провайдеру нужен ключ, развёрнутый профиль показывает строку API- ключ: хранится ли он, замаскированное поле, чтобы вставить новый, и кнопку, чтобы его удалить. Ключ уходит в системный keyring, никогда в файл на диске, и принадлежит провайдеру, а не профилю — каждый профиль, использующий этого провайдера, делит его. Из терминала то же самое — w-ai key set.

Одна ловушка, которую стоит назвать: если вы используете CLI со входом по подписке, не храните для него ещё и API-ключ. При наличии ключа CLI переключается на оплату по токенам.

Режим: сколько он делает сам

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

Это настройка удобства, а не граница безопасности. Всё, что касается системы от имени администратора, останавливается на собственном запросе пароля или отпечатка W, независимо от выбранного режима — авто не может авторизовать привилегированное изменение за вас. По той же причине собственные тулы W (включая те, что добавляет установленный пак — помощники Inkscape или GIMP) никогда не ждут подтверждения хоста на каждый вызов: ассистент обращается к ним напрямую, а всё привилегированное всё равно останавливается на том же запросе. Серверы MCP, зарегистрированные вами вручную, сохраняют обычный порядок подтверждений хоста.

Набор тулов рядом с ним управляет тем, сколько собственных инструментов W предложено ассистенту. Оставьте авто.

Продвинутое

Раздел Продвинутое добавляет возможности, которым нужен дополнительный софт: Веб-поиск, Экстрактор (загрузка и чтение страницы), Семантическая память (поиск по собственной памяти по смыслу, а не по ключевым словам) и Локальные модели.

Они приходят из опционального набора. До его установки все четыре строки серые, с пометкой Требуется пак ai-extra и одной кнопкой Установить, которая делает всё за вас — см. раздел о наборах. После этого каждая строка включается независимо, а те, что W не может включить сама, сообщают почему: что локальный движок моделей не запущен, или что модель ещё нужно скачать. Выбор brave для веб-поиска открывает собственное поле API-ключа, которое работает точно как описанное выше.

Ничего из этого не требуется для обычного чата — это разница между ассистентом, который умеет что-то искать, и тем, что может только отвечать.

ComfyUI

Генерация изображений и видео — отдельный опциональный набор, см. раздел о наборах. Он ставит ComfyUI как системный сервис: node-редактор и бэкенд в одном процессе, на http://127.0.0.1:8188/. Откройте его из меню приложений (пункт сам запускает сервис, в первый раз спросит пароль администратора и откроет браузер) или запустите сами: systemctl start comfyui.

  • Подбор под видеокарту: движок ставится с драйвером, который нужен вашему железу (nvidia / amd / intel Arc / cpu), определяется автоматически.
  • Установка нод: менеджер нод встроен в движок и уже включён, поэтому недостающий набор нод ставится прямо из интерфейса — ничего клонировать и доустанавливать руками не нужно. Работает это, только пока ComfyUI отвечает на 127.0.0.1: если открыть движок в сеть, менеджер перестаёт что-либо устанавливать — это его собственное правило безопасности, а не ограничение W.
  • Общее хранилище моделей: модели скачиваются в /var/lib/w/ai-models — исключённое из снимков хранилище, общее для всей машины; писать туда может каждый аккаунт, для которого настроен набор. Ollama из набора ai-extra хранит там же свои модели — в ollama/.
  • Куда попадает результат: /var/lib/w/comfyui/data/output — внутри каталога движка, где бы тот ни был установлен. Эту папку можно открыть в файловом менеджере, забирать оттуда рендеры и класть исходники в соседнюю input/: доступ даёт группа w-ai, в которую набор вас добавляет, и она вступает в силу со следующего входа в систему.
  • Обновление: обновление системы движок не трогает; w-pack outdated покажет новый релиз, а sudo w-pack upgrade comfyui поставит его и вернёт прежний, если новый не стартует — см. поддержание паков актуальными.
  • Ассистент может помочь с воркфлоу ComfyUI, размещением моделей и сервисом — загружает пак знаний comfyui, когда речь заходит о локальной генерации.

InvokeAI

Второй, независимый набор генерации с другим интерфейсом: InvokeAI работает на многослойном холсте (инпейнтинг, аутпейнтинг, региональные промпты) с галереей и досками, тогда как ComfyUI строит граф нод. Работает как системный сервис на http://127.0.0.1:9090/; откройте InvokeAI в меню приложений или выполните systemctl start invokeai.

  • Подбор под видеокарту: сборка PyTorch выбирается под ваше железо при установке (nvidia / amd / intel Arc / cpu), так же как для ComfyUI.
  • Те же модели, что у ComfyUI: каждый файл модели в общем хранилище (/var/lib/w/ai-models/checkpoints, loras, vae, …) регистрируется в InvokeAI на месте — ничего не копируется. Добавили файл? Выполните sudo systemctl reload invokeai, и после короткой проверки он появится. Файлы, которые InvokeAI использовать не умеет, тихо пропускаются.
  • Собственные загрузки со вкладки Model Manager попадают в /var/lib/w/ai-models/invokeai. Удаление модели внутри InvokeAI стирает файл только оттуда; модель из общего хранилища просто скрывается до следующего запуска.
  • Куда попадает результат: /var/lib/w/invokeai/data/outputs — доступно из файлового менеджера через ту же группу w-ai (со следующего входа).
  • Тонкая настройка (лимиты памяти, attention, точность) — в /var/lib/w/invokeai/data/invokeai.yaml; пример рядом перечисляет все ключи.
  • Обновление: так же, как у ComfyUI — sudo w-pack upgrade invokeai; он заранее говорит, приносит ли новый релиз новый PyTorch (большая загрузка), и возвращает прежнюю версию с её базой данных, если новая не поднялась.

Изменить эту страницу на GitHub