Fractera

Файлы и картинки для каждого элемента вашего узла

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

OpenSource Web4 agent & app starter kit

Как идёт файл

  1. Элемент присылает файл

    Он загружает картинку, видео или документ через элемент базы данных, до 200 МБ.

  2. Хранилище его держит

    Файл и его запись остаются в папке элемента на этом компьютере, никогда в git.

  3. Файл получает адрес

    Адрес указывает на элемент базы данных, поэтому не меняется, когда хранилище переезжает.

  4. Страницы его показывают

    Превью, размытые заглушки и обрезанные видео делаются из того же файла.

Через туннель Cloudflare каждая дверь отвечает 404, с ключом и без.

Работает всегда

Узел никогда не выключает этот элемент: от него зависят остальные. Он запускается вместе с узлом и не засыпает, даже когда памяти мало.

Что меняется для вас

Без негоС объектным хранилищем
Каждый элемент хранил бы файлы по-своемуВсе элементы держат их в одном хранилище с одной дверью
Ссылка на файл ломается, когда сервер переезжаетАдрес остаётся тем же, когда хранилище переезжает
Превью и иконки делаются рукамиХранилище само делает превью, заглушки и иконки сайта
Ваши файлы лежат на чужом сервереОни остаются на вашем компьютере, внутри вашего узла

Чей это файл

Главный агент узла

Открывает все файлы всех элементов и видит, чей каждый.

  • Элемент мамы

    Открывает только файлы её элемента, приватные тоже.

  • Элемент сына

    Открывает только свои файлы.

  • Ваш сайт

    Открывает свои файлы и публичные картинки узла.

Каждый элемент открывает хранилище своим ключом, а файл другого элемента отвечает 404, как несуществующий.

У каждого файла есть владелец и видимость. Файл, загруженный собственным ключом элемента, принадлежит этому элементу. Картинка страницы остаётся публичной; приватный файл выходит, только когда владелец просит его по имени, поэтому ни одна страница его не отдаст.

Глубокая память хранит каждый присланный файл как приватный файл того элемента, через который его сказали. Главный агент открывает их все ключом узла.

Хранилище разделяет двери, а не диск: все файлы лежат в папке этого элемента на вашем компьютере, и все элементы работают от одного пользователя.

Подключите свой элемент

У каждого элемента узла уже есть адрес базы данных и свой ключ. Загрузите картинку и сохраните её адрес:

const form = new FormData()
form.append('file', new Blob([bytes], { type: 'image/png' }), 'logo.png')
form.append('title', 'Logo')
const r = await fetch(`${process.env.REMOTE_DATA_URL}/media/upload`, {
  method: 'POST',
  headers: { 'X-Element-Key': process.env.ELEMENT_KEY },
  body: form,
})
const { item } = await r.json() // item.url — the permanent address of the file

item.url — постоянный адрес файла. Добавьте в форму visibility=private, чтобы файл остался только вашему элементу. PATCH /media/:id меняет его название, а DELETE /media/:id удаляет файл и его запись.

Что под капотом

Медиатека
Файлы и записи в папке элемента (data/media.db, storage/, icons/), никогда в git
Адрес
Указывает на элемент базы данных, поэтому сохранённый адрес не меняется, когда хранилище переезжает
Картинки
Превью 200×200 и размытая заглушка для каждой картинки
Видео
Обрезка по секундам через ffmpeg: копия потока или перекодирование, если срез не попал в ключевой кадр
Иконки сайта
Из одной картинки: favicon, иконки приложения, картинка для соцсетей и манифест
Замок
Собственный ключ элемента открывает его файлы и публичные файлы узла; ключ данных узла или сессия с привилегированной ролью открывают все; через туннель Cloudflare каждая дверь отвечает 404

Свой строитель в комплекте

Каждый элемент узла приходит со своим агентом Claude Code и может получить свой Telegram-бот. Нужно что-то поменять в этом элементе — напишите его боту с телефона, и агент обновит логику или дизайн.

Агент работает только в папке своего элемента и не читает весь узел, поэтому каждая правка стоит меньше токенов. Платит за неё ваша подписка Claude Code.

  • Бот элемента подключается в ядре, на его странице «Telegram».
  • Агент возвращает коммит; вы смотрите его в «Предпросмотре» и принимаете или отклоняете.
  • За компьютером терминал агента — в ядре, в разделе «Сборка» этого элемента.

Открытый код

Сделано Fractera для протокола Lagrix и для любого web2-проекта, которому нужно хранить файлы. Лицензия MIT, код — github.com/Fractera/fractera-storage-starter.

GitHub →

Вопросы и ответы

Какого размера может быть файл?
До 200 МБ, через элемент базы данных.
Сломается ли адрес файла, если хранилище переедет?
Нет. Адрес указывает на элемент базы данных, поэтому сохранённый адрес не меняется.
Можно ли сделать файл приватным?
Да. Добавьте visibility=private при загрузке: файл выходит, только когда владелец просит его по имени, поэтому ни одна страница его не отдаст.
Можно ли делать резервные копии?
Да. Элемент готов к тому, что его агент-программист настроит резервное копирование по расписанию или вручную: скажите об этом агенту элемента в Telegram или в терминале. Сам по себе он копий не делает.