Расширения и аддоны

Problet понимает два вида дополнений: расширения Chrome (в том числе прямо из Chrome Web Store) и собственные аддоны Problet. Оба управляются в Настройки → Расширения.

Чем они отличаются

Расширения ChromeАддоны Problet
ОткудаChrome Web Store или папка с manifest.jsonКаталог ProbletAddons, ссылка на addon.json или архив
СовместимостьРаботают не все API Chrome: недостающие заменены заглушками, сложные расширения могут работать не полностьюСделаны под Problet, работают полностью
Что могутЧто позволяет ChromeБольше: файлы, запуск программ, сеть без ограничений CORS — но спрашивают разрешения
КнопкаУ каждого расширения своя кнопка, открывает его окошкоСвоя кнопка, если аддон её объявил

Кнопки и тех и других ставятся на любую панель в Настройки → Панели, как встроенные.

Расширения Chrome

Из Chrome Web Store

Два способа:

Из папки

Настройки → Расширения → Расширения Chrome → «Добавить» и выбери папку с распакованным расширением — ту, где лежит manifest.json. Удобно для своих расширений и для отладки.

Что работает

Например, работает «Claude in Chrome»: и в боковой панели, и в связке с claude --chrome из терминала, когда боковая панель закрыта.

Если расширение работает не полностью, скорее всего, ему нужен API, которого нет в Electron. Напиши об этом в Issues с названием расширения.

Аддоны Problet

Аддон — папка с файлом addon.json и файлами рядом. Устанавливается в Настройки → Расширения → «Добавить аддон Problet», дальше одно из трёх:

Перед установкой Problet показывает, что аддон сможет делать. Установленные аддоны видны в том же списке, что и расширения Chrome; там же их настройки и удаление.

Каталог аддонов

АддонЧто делает
Тёмные сайтыТёмная тема для выбранных сайтов, картинки и видео в своих цветах.
Время чтенияСколько минут читать длинную статью.
Наборы вкладокСохранить открытые вкладки набором и открыть снова.
Страница в MarkdownСохранить страницу в файл .md.
Скорость видеоКлавиши скорости и перемотки для любого видео.
Быстрая командаВыполнить команду в системе прямо с панели.
Режим чтенияЧистый текст статьи без меню и рекламы, размер шрифта, ширина и тема.
Скачать картинки и видеоСписок картинок и видео страницы, сохранение выбранных в папку.
JSONJSON-страницы деревом: сворачивание, поиск, копирование значения и пути.

Разрешения аддонов

Аддон заявляет разрешения в addon.json, и получает только их. Чем опаснее разрешение, тем строже Problet спрашивает:

Когда спрашиваетРазрешения
Не спрашивает (достаточно заявить)storage — свои данные до 5 МБ; notifications — уведомления; tabs — список вкладок, открыть, закрыть, переключить, перезагрузить, сообщения своим скриптам на страницах.
При первом использовании, ответ запоминаетсяpages — выполнять код на любой открытой странице; network — запросы к любым сайтам без ограничений CORS; bookmarks — читать и добавлять закладки; history — читать историю; clipboard — буфер обмена.
При каждом действии, с подробностями (можно ответить «Разрешать всегда»)files — читать и записывать файлы (файл, который ты сам выбрал в окне выбора, не спрашивается); exec — запускать программы и команды.

Что аддону разрешено и запрещено, видно в списке расширений; кнопка «Сбросить разрешения» забывает все ответы, и он спросит заново.

Как написать свой аддон

Минимальный аддон — один файл:

{
	"id": "hello",
	"name": "Привет",
	"version": "1.0.0",
	"icon": "👋",
	"content": [{ "matches": ["<all_urls>"], "js": ["hello.js"] }]
}

Полное описание формата addon.json (скрипты на страницах, фон, кнопка с окошком, страница настроек, переводы) и всего API problet для аддонов — в README каталога ProbletAddons. Коротко:

problet.storage.get(key) / set(key, value)
problet.tabs.list() / open(url) / eval(id, code)
problet.fetch(url, { method, headers, body })
problet.files.pick({ save }) / read(path) / write(path, data)
problet.exec(command)
problet.on('buttonClick', fn)

Чтобы аддон попал в каталог, положи его папку в репозиторий ProbletAddons и добавь запись в index.json (через pull request).