5.4 KiB

Raw Permalink Blame History

Расширение Верстака для браузера

Отправляйте страницы, выделенный текст, ссылки и файлы из браузера в Верстак.

English · Русский

Alpha-версия. Используйте с совместимой alpha-сборкой Verstak Desktop.

Расширение Верстака захватывает страницы, выделенный текст, ссылки и выбранные файлы и отправляет их в локальный приёмник «Входящие из браузера».

Расширение не знает внутреннего устройства Заметок, Файлов, Активности или Журнала. Оно только отправляет события захвата через публичный протокол локального приёмника. Если приёмник недоступен, захваты остаются в очереди расширения.

Сборка

npm ci
npm test
npm run build

Результат сборки:

dist/chromium
dist/firefox

Загрузите dist/chromium как распакованное расширение в браузеры на базе Chromium или временно загрузите dist/firefox в Firefox при разработке.

Пассивный учёт активности по доменам

Пассивный учёт выключен по умолчанию. При первом использовании расширение объясняет, что оно записывает; пользователь должен явно включить его в настройках.

Когда учёт включён, расширение наблюдает только за активной вкладкой и отправляет ограниченные интервалы как каноническое доменное имя плюс длительность. Оно никогда не отправляет URL-пути, заголовки страниц, текст страниц, выделенный текст, нажатия клавиш, историю посещений или время неактивных вкладок.

Ручные действия «Отправить страницу», «Отправить выделенный текст», «Отправить ссылку» и «Отправить файл» отделены от пассивного учёта. Они создают записи во «Входящих из браузера», а не дела или записи журнала.

Загрузка и обновления в Firefox

Подписанный XPI публикуется на странице GitHub Releases. Скачайте Firefox-ассет verstak-firefox-<версия>.xpi из последнего релиза и откройте его в Firefox для установки.

После первого публичного релиза установленные копии проверяют GitHub Releases на наличие обновлений через ассет updates.json релиза.

Сопряжение

В Verstak Desktop откройте настройки «Входящих из браузера».
Скопируйте адрес приёмника и токен сопряжения.
Вставьте оба значения в настройки расширения и сохраните.

Смена токена в Desktop делает недействительным значение, сохранённое в расширении.

Язык

Настройки расширения предлагают выбор языка: System / English / Russian. System следует языку интерфейса браузера: русская локаль выбирает русский, остальные — английский.

Расширение и desktop-приложение хранят выбор языка независимо. Изменение одного не меняет другой.

Протокол локального приёмника

Эндпоинт по умолчанию:

POST http://127.0.0.1:47731/api/browser-inbox/v1/captures

Заголовки:

Content-Type: application/json
X-Verstak-Receiver-Token: <токен> — обязателен, когда приёмник в paired mode

Поддерживаемые виды захвата:

page — страница (url, title, domain)
selection — выделенный текст
link — ссылка (url, опционально текст)
file — файл (имя, base64 или текст до 8 МБ)

5.4 KiB Raw Permalink Blame History Unescape Escape