Что поставить, в каком порядке работать, чем ревьюить и на какие грабли не наступать второй раз.
2026-08-07 · собрано по итогам сборки дека Levitan (слайды 1–5)
npm i -g @higgsfield/cli
higgsfield auth login # откроет браузер, порт 8765
higgsfield workspace list # покажет id
higgsfield workspace set <workspace_id>
higgsfield account status # проверка: email, план, кредитыinvalid_request: redirect_uri does not match. CLI использует зарегистрированный
клиент и фиксированный порт — проходит с первого раза. Это не обход, а их же рекомендованный путь.
Проверка, что связь живая, — не «Connected» в списке серверов, а реальный ответ
higgsfield account status с планом и балансом.
cd /tmp/hf-skills && npx -y skills@latest add higgsfield-ai/skills -y
# скиллы окажутся в ./.agents/skills — скопировать нужные:
cp -R .agents/skills/higgsfield-generate ~/.claude/skills/
cp -R .agents/skills/higgsfield-brandkit ~/.claude/skills/
cp -R .agents/skills/higgsfield-websites ~/.claude/skills/
cp -R .agents/skills/higgsfield-product-photoshoot ~/.claude/skills/Из девяти скиллов репозитория для дека нужны эти четыре. Остальные (game-generation,
marketplace-cards, youtube-thumbnail, soul-id,
video-explainer) только съедают контекст каждой сессии.
higgsfield-brandkit — главный для этой задачи: он умеет палитру, знак, типографику
и деки, причём собирает их локально и детерминированно. В нём прямо запрещено просить картиночную
модель нарисовать «похожее на слайд» — текст остаётся текстом.
brew install imagemagick librsvg
brew install --cask libreoffice # нужен только для пути через PPTX| Инструмент | Зачем |
|---|---|
rsvg-convert | растр из SVG для просмотра знака |
magick | обрезка знака по контенту, нарезка слайдов, контактные листы |
soffice | рендер PPTX в PDF для проверки — только если идёте в PowerPoint |
| Google Chrome | рендер слайдов в PNG и печать в PDF, headless |
python3 + Pillow | скрипты brandkit, обработка ассетов |
| Кандидат | Почему мимо |
|---|---|
| Отдельный ключ Meshy | Meshy 6, Tripo и Hunyuan3D доступны внутри Higgsfield на тех же кредитах |
mcp-image / Gemini API | у Gemini генерация картинок только на платном тарифе, бесплатного нет вообще; Higgsfield уже оплачен |
| Blender + blender-mcp | нужен только под запечённые 3D-рендеры в PPTX; для веба свет и камера задаются кодом |
| Spline MCP | архивирован, у Spline нет публичного API |
| Gamma / Canva MCP | нужны, только если требуется готовый .pptx и есть бренд-кит |
| Office-PowerPoint-MCP-Server | архивирован в марте 2026 |
textutil -convert txt -output out.txt in.docx для .docx./higgsfield-brandkit. Строго по порядку: палитра → знак → типографика. Каждый шаг утверждается отдельно, состояние пишется в brandkit/state.json. Смена палитры обнуляет знак, смена типографики — нет.logo-inspect для фингерпринта, потом logo-export: он снимает полноэкранный фон и отдаёт чистый SVG + PNG 2048.CH="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
"$CH" --headless=new --disable-gpu --hide-scrollbars \
--window-size=1920,5400 --virtual-time-budget=9000 \
--screenshot=full.png "file://$PWD/deck.html"
for i in 1 2 3 4 5; do y=$(( (i-1)*1080 ))
magick full.png -crop 1920x1080+0+$y +repage "slide-0$i.png"; done<style> добавить @page{size:1920px 1080px;margin:0} и
@media print{.slide{break-after:page}}, затем:
"$CH" --headless=new --disable-gpu --no-pdf-header-footer \
--virtual-time-budget=9000 --print-to-pdf=deck.pdf "file://$PWD/deck.html"Ревью-страница с коммент-слоем: слайды в масштабе 70% плюс два способа оставить замечание.
пин 62.4% / 31.8%. Нужен потому, что штриховку или ветку схемы выделить как текст нельзя.Комменты лежат в localStorage браузера, ключ по document.title, никуда не уходят.
build-review.py читает
deck.html, вынимает CSS, defs и секции слайдов и заворачивает их в оболочку с коммент-слоем.
Правим дек — пересобираем одной командой, и ревью не расходится с исходником:
python3 build-review.pyПолный список — в скилле landing-copy. Самое частое, что придётся выкорчёвывать:
| Маркер | Что делать |
|---|---|
| «не X, а Y» | маркер номер один. Переписать прямым утверждением или сценой: «занят вашими способностями, пока остальные модели заняты вашей работой» |
| «без X» | заменить на «вместо X» либо убрать |
| «революция», «трансформация», «синергия», «контур», «эффективность» | запрещены |
| абстракция вместо сцены | «практически не научились масштабировать развитие человека» → «развитие человека осталось ручным» |
| превосходная степень без базы | «самая измеримая способность» → «измеряется точнее любой другой» |
| эмодзи, восклицательные знаки | в основном тексте нет |
Авторские формулировки заказчика не трогать, даже если нарушают правила. Если сомневаешься — спросить.
| Где | Что происходит | Как правильно |
|---|---|---|
Recraft, параметр colors | падает на формате {"rgb":[...]} | массив hex-строк: ["#6E5BFF","#A99BFF"] |
| Знак после Recraft | лежит на квадратном холсте с большими полями, в вёрстке выглядит вчетверо мельче заданного | magick logo.png -trim +repage logo-trim.png |
<img> в колоночном flex | растягивается по ширине контейнера и искажает пропорции | align-items:flex-start на контейнере |
Блочное правило position:relative | перебивает absolute у подписей, они уезжают в угол | исключать их из селектора либо оборачивать контент отдельным слоем |
| Chrome headless screenshot | снимает только вьюпорт, остальные слайды пустые | --window-size на полную высоту страницы |
Регулярка на body{...} | по границе слова цепляет .cover-body и p.body, вёрстка рассыпается | лукбехайнд (?<![\w.\-])body\s*\{ |
npx skills add | ставит в текущую папку как в проект, глобально не умеет | запускать из нейтральной папки и копировать в ~/.claude/skills/ |
| Засечные шрифты в кириллице | на тёмном фоне волосяные штрихи выцветают, средние кегли плывут | для тёмных деков одно семейство без засечек, иерархия масштабом и весом |
| Проверка кириллицы у Google Fonts | grep по комментарию /* cyrillic */ врёт: комментарии отдаются только под браузерным User-Agent | искать U+0400 в unicode-range |
| Путь в PPTX | PowerPoint подменяет шрифты своими | шрифты установить в систему до экспорта |
Кредиты Higgsfield, реальные ответы higgsfield generate cost:
| Модель | Кредитов | Под что |
|---|---|---|
text2image_soul_v2 | 0.12 | атмосферные фоны, черновые прогоны |
nano_banana_2 | 2 | быстрые итерации |
gpt_image_2 | 7 | текст внутри кадра, финальные ключевые кадры |
recraft_v4_1 (вектор) | 10 | кандидаты знака |
kling3_0 | 10 | видео |
python-pptx или PptxGenJS, рендер проверки через soffice --headless --convert-to pdf и pdftoppm. Нужен, когда просят именно файл для PowerPoint.meshy_v6_text_to_3d, tripo_3d). Blender не нужен.