70 lines
2.3 KiB
Markdown
70 lines
2.3 KiB
Markdown
# AGENTS.md — Verstak Official Plugins
|
||
|
||
## Назначение
|
||
|
||
Монорепозиторий официальных плагинов Верстака. Каждый плагин — полноценный динамический плагин, проходящий тот же lifecycle, что и сторонние.
|
||
|
||
## Состав
|
||
|
||
```
|
||
verstak-official-plugins/
|
||
AGENTS.md
|
||
plugins/
|
||
platform-test/ — тестовый плагин для проверки runtime
|
||
files/
|
||
notes/
|
||
markdown-editor/
|
||
markdown-preview/
|
||
file-preview/
|
||
activity/
|
||
journal/
|
||
browser-inbox/
|
||
search/
|
||
secrets/
|
||
templates/
|
||
packages/
|
||
shared-ui/
|
||
test-harness/
|
||
plugin-sdk/ — временно, пока SDK не выделен
|
||
package.json
|
||
tsconfig.json
|
||
```
|
||
|
||
## Правила для всех плагинов
|
||
|
||
1. Каждый плагин имеет plugin.json с полным manifest.
|
||
2. Плагины зависят от capabilities, а не от plugin ID.
|
||
3. Нет скрытого privileged path для official плагинов.
|
||
4. disable не удаляет пользовательские данные.
|
||
5. Отсутствие optional capability — degraded mode, не ошибка.
|
||
6. Plugin Manager показывает статус каждого плагина.
|
||
|
||
## Первый минимальный набор
|
||
|
||
- `platform-test` — для отладки runtime
|
||
- `official.files` — файловый менеджер
|
||
- `official.notes` — заметки
|
||
- `official.markdown-editor` — редактор
|
||
- `official.markdown-preview` — предпросмотр
|
||
- `official.activity` — активность
|
||
- `official.browser-inbox` — браузерный inbox
|
||
|
||
Все они должны быть настоящими динамическими плагинами, даже если поставляются вместе с приложением.
|
||
|
||
## Структура плагина
|
||
|
||
```
|
||
plugin-id/
|
||
plugin.json — обязательный manifest
|
||
frontend/
|
||
index.js — entry point
|
||
style.css
|
||
backend/ — опционально
|
||
plugin-linux-amd64
|
||
plugin-windows-amd64.exe
|
||
migrations/ — опционально
|
||
001_init.sql
|
||
assets/
|
||
README.md
|
||
```
|