Расширения и аддоны
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 Web Store прямо в Problet — рядом с родной кнопкой магазина появится кнопка «Установить в Problet»;
- или вставь ссылку на страницу расширения (или его идентификатор из 32 букв) в Настройки → Расширения → Из Chrome Web Store → «Установить».
Из папки
Настройки → Расширения → Расширения Chrome → «Добавить» и выбери папку с распакованным расширением — ту, где лежит manifest.json. Удобно для своих расширений и для отладки.
Что работает
- скрипты и стили на страницах (content scripts), окошко кнопки (popup), страница настроек;
- фоновый процесс (service worker) и API, которые есть в Electron:
storage,runtime, частьtabsи другие; - боковая панель (
chrome.sidePanel): страница расширения открывается справа от сайта и привязана к своей вкладке; - для расширений из магазина Problet дописывает недостающее: настоящие вкладки и окно в
chrome.tabsиchrome.windows(список, создание, переход, события),chrome.debugger,chrome.offscreen, группы вкладок (имитация: группа видна расширению, но не рисуется на панели), сохранениеchrome.storage.sessionс данными входа между перезапусками.
Например, работает «Claude in Chrome»: и в боковой панели, и в связке с claude --chrome из терминала, когда боковая панель закрыта.
Аддоны Problet
Аддон — папка с файлом addon.json и файлами рядом. Устанавливается в Настройки → Расширения → «Добавить аддон Problet», дальше одно из трёх:
- выбрать аддон из каталога;
- «Добавить по ссылке на addon.json» — остальные файлы браузер скачает рядом сам (подходит и обычная ссылка на файл на GitHub);
- «Загрузить архив» —
.zip, гдеaddon.jsonлежит в корне или в единственной папке.
Перед установкой Problet показывает, что аддон сможет делать. Установленные аддоны видны в том же списке, что и расширения Chrome; там же их настройки и удаление.
Каталог аддонов
| Аддон | Что делает |
|---|---|
| Тёмные сайты | Тёмная тема для выбранных сайтов, картинки и видео в своих цветах. |
| Время чтения | Сколько минут читать длинную статью. |
| Наборы вкладок | Сохранить открытые вкладки набором и открыть снова. |
| Страница в Markdown | Сохранить страницу в файл .md. |
| Скорость видео | Клавиши скорости и перемотки для любого видео. |
| Быстрая команда | Выполнить команду в системе прямо с панели. |
| Режим чтения | Чистый текст статьи без меню и рекламы, размер шрифта, ширина и тема. |
| Скачать картинки и видео | Список картинок и видео страницы, сохранение выбранных в папку. |
| JSON | JSON-страницы деревом: сворачивание, поиск, копирование значения и пути. |
Разрешения аддонов
Аддон заявляет разрешения в 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).