dsh-figma-browser
Manifest valid★ 2Figma design data and true renders for DeepSeek Harness through your own signed-in Chrome — no Figma API token, paid seat, or Dev Mode.
dsh-figma-browser
Русский | English
Плагин для DeepSeek Harness, который отдаёт агенту макеты Figma точными данными и настоящими рендерами через твой собственный Chrome с уже открытой сессией. Без токена Figma, без платного места, без Dev Mode и без API-лимитов.
figma_node { "nodeId": "25:148", "render": true, "scale": 2 }
→ PNG кадра, экспортированный самой Figma
→ Inter Bold 19.51px, заливка #33435E, радиус 12, автолейаут 16/24/4, …
Зачем
Публичный Figma REST API упирается в токен и тариф, Figma MCP — в OAuth, allowlist клиентов и десктопное приложение, Dev Mode — в платное место. При этом веб-редактор Figma держит внутри страницы настоящий plugin API — window.figma с getNodeById, root, currentPage, exportAsync, variables. Плагин открывает файл в Chrome под твоей сессией, подключается к вкладке по Chrome DevTools Protocol и читает документ через этот API. Поэтому работает и на бесплатном тарифе.
Как это работает
- Chrome запускается с
--remote-debugging-portна копии профиля (Local State,Cookies,Local Storage,IndexedDB, …). С Chrome 136 отладочные ключи игнорируются на дефолтном каталоге данных, поэтому копия — единственный способ сохранить куки и авторизацию. - Headless-запуск подставляет обычный Chrome User-Agent: CDN Figma отвечает
403 Request blockedна токенHeadlessChrome. - Плагин подключается к вкладке редактора по CDP (встроенный
WebSocketплатформы) и выполняет небольшой сериализатор противwindow.figma. - Рендеры отдаёт
node.exportAsync, то есть картинку рисует сама Figma.
Никаких рантайм-зависимостей: без Playwright, без Puppeteer, без скачивания браузеров.
Установка
# из npm
dsh plugin add dsh-figma-browser
# из локального клона
dsh plugin add /path/to/dsh-figma-browser
В веб-интерфейсе: Plugins → Add plugin → имя пакета или путь к каталогу. Бандл host-only: сборка не нужна.
Дальше в новой сессии:
figma_browser { "action": "open", "url": "https://www.figma.com/design/<file>?node-id=25-147" }
Инструменты
| Инструмент | Параметры | Результат |
|---|---|---|
figma_browser | action: status | start | stop | open, url | состояние браузера или открытая вкладка |
figma_list | action: pages | search | selection, query, limit | страницы файла, найденные узлы, текущее выделение |
figma_node | nodeId, depth, render, format, scale | геометрия, заливки, градиенты, эффекты, автолейаут, текст и шрифт, дети; опционально PNG/SVG |
figma_view | nodeId?, format? | скриншот редактора, при необходимости с выделенным узлом |
figma_eval | expression | только при allowEval: true |
nodeId принимает 25:147, 25-147 или полную ссылку Figma; ссылка ещё и откроет нужный файл.
Настройка
| Поле | По умолчанию | Значение |
|---|---|---|
port | 9333 | порт DevTools, слушается только 127.0.0.1 |
headless | false | запуск без окна; в headless не видно действий агента |
autoStart | true | поднимать браузер самому, если его нет |
allowEval | false | регистрировать figma_eval (произвольный JS в странице) |
chromePath | автоопределение | путь к Chrome/Chromium |
sourceProfile | автоопределение | каталог реального профиля, копируемый один раз |
profileDir | ~/.dsh/figma-browser/profile | где живёт копия профиля |
outputDir | ~/.dsh/figma-browser/out | куда пишутся JSON и рендеры |
userAgent | автоопределение | User-Agent для headless |
startupTimeoutMs | 20000 | сколько ждать запуска браузера |
extraArgs | [] | дополнительные ключи Chrome, например --no-sandbox в контейнере |
Если окно не нужно, поставь headless: true; если у машины нет дисплея, плагин сам откатится на headless.
Локальные настройки живут в профильном патче и переживают обновление плагина:
# ~/.dsh/profiles/<name>/cordis.patch.yml
- override:
- id: figma-browser
config:
headless: true
allowEval: true
Проверка
npm run check # синтаксис всех модулей
npm test # smoke-тест против браузера, слушающего :9333
Ограничения
- Только Figma; копия профиля выделена под плагин, это не твоё живое окно Chrome.
window.figma— внутренний механизм Figma, а не публичный API. Если его уберут, останутся скриншоты канваса.- Копия делается один раз. Когда сессия истечёт, удали
profileDirпри закрытом Chrome и запусти заново. - Все сессии на машине делят один экземпляр браузера и один порт.
- Плагин ничего не меняет в файле сам: запись возможна только если агент прямо попросят, а
figma_evalпо умолчанию выключен.
Безопасность
- В копии профиля лежат твои куки. Не коммить её и не выкладывай.
- Пока порт открыт, любой локальный процесс может управлять этим браузером. Закончил —
figma_browser { "action": "stop" }. - Если не хочешь копировать куки всех сайтов, сделай отдельный профиль Chrome для Figma.
Структура
src/cdp.js CDP-клиент на встроенном WebSocket
src/browser.js жизненный цикл Chrome, копия профиля
src/figma.js операции внутри редактора (window.figma)
src/index.js регистрация инструментов
test/smoke.mjs smoke-тест против живого браузера
Лицензия
MIT
Comments
Loading…
From the same category
by awesome-dsh-plugin
A curated list of plugins for DeepSeek Harness (dsh) · DeepSeek Harness 插件精选列表
★ 25k
CC0-1.0
Python
Nov 17, 2026
by woniuniuniu
DeepSeek Harness 自媒体工作台插件:一句话记灵感,一键生成脚本、封面、配图和分镜
★ 1.5k
↓ 8.2k/wk
MIT
JavaScript
Nov 15, 2026
dsh plugin --profile web add dsh-media-deskby 0xsline
DeepSeek Harness (DSH) ecosystem: curated plugins, tools, and infrastructure from dsh-external/hub and the public dsh-plugin topic.
★ 1.4k
CC0-1.0
Python
Nov 6, 2026
by keli-wen
Hire Google's Antigravity CLI (agy) as a fast Gemini staffer for Claude Code, OpenAI Codex, and DeepSeek Harness.
★ 888
MIT
JavaScript
Nov 16, 2026
dsh plugin --profile agent add agy-staffby Roland0511
MarkText (muya) WYSIWYG Markdown editor for the DeepSeek Harness right sidebar
★ 762
↓ 2.8k/wk
MIT
JavaScript
Nov 7, 2026
dsh plugin --profile web add dsh-marktextby SAOS-3624
Scene-aware storyboard for DeepSeek Harness: 9-16 numbered cells with timestamps + transcript + an audio envelope, packed into ONE image (384 tokens). Two tools: video_storyboard and video_zoom.
★ 568
↓ 17k/wk
MIT
JavaScript
Nov 16, 2026
dsh plugin --profile web add dsh-video-storyboard