_OpenSource Web4 agent & app starter kit_

# Поиск по смыслу для каждого элемента вашего узла

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

[Подключить свой элемент](#connect)
[Что под капотом](#hood)

## Как идёт поиск

#### Элемент присылает текст

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

#### Embeddings считает его

Собственный элемент узла embeddings превращает текст в 384 числа на этом компьютере. Наружу ничего не уходит.

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

Вектор ложится в свою коллекцию. Текст с тем же id заменяет прежний.

#### Вопрос его находит

Вопрос считается так же и встречает самые близкие тексты своей коллекции, у каждого своя оценка.

Поиск читает только свою коллекцию и только ближайшие строки, а для них считает точную оценку.

## Включён, засыпает только при нехватке памяти

Элемент запускается вместе с узлом. Когда свободной памяти меньше 0,5 ГБ, узел может его усыпить; первый вызов или запись календаря будят его за секунды, а при 1 ГБ свободной памяти он возвращается сам.

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

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

## Чьи это векторы

## undefined

**Главный агент узла** — Ищет во всех коллекциях всех элементов и видит, чья каждая находка.

- **Элемент мамы** — Коллекции её элемента, их ищет только ключ её элемента.
- **Элемент сына** — Его коллекции, другой элемент их не видит.
- **Ваш сайт** — Свои коллекции под своими именами.

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

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

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

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

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

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

```
const base = process.env.REMOTE_DATA_URL
const headers = { 'X-Element-Key': process.env.ELEMENT_KEY, 'Content-Type': 'application/json' }
await fetch(`${base}/vectors`, { method: 'POST', headers,
  body: JSON.stringify({ collection: 'faq', text: 'Delivery takes two days.', refTable: 'faq', refId: '17' }) })
const r = await fetch(`${base}/vectors/search`, { method: 'POST', headers,
  body: JSON.stringify({ collection: 'faq', query: 'How long is shipping?', k: 3 }) })
const { results } = await r.json() // [{ id, collection, refTable, refId, text, score }]
```

В ответе самые близкие тексты с оценкой. Тот же id заменяет текст, а DELETE /vectors/:id удаляет его.

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

| Часть | Что делает |
| --- | --- |
| Индекс | Таблица sqlite-vec vec0, разделённая по коллекциям: поиск читает ближайшие строки своей коллекции и считает для них точную косинусную оценку |
| Смысл | Собственный элемент узла embeddings: paraphrase-multilingual-MiniLM-L12-v2, 384 числа, на этом компьютере |
| Новая модель | Хранилище, посчитанное прежней моделью, целиком откладывается рядом с новым, больше не читается и никогда не удаляется |
| Замок | Собственный ключ элемента открывает его коллекции; ключ данных узла или сессия с привилегированной ролью открывают все; через туннель Cloudflare каждая дверь отвечает 404 |
| /vectors/status | Готово ли хранилище, его модель и размер, вид индекса и сколько в нём векторов |

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

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

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

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

## Открытый код

Сделано Fractera для протокола [Lagrix](https://lagrix.dev) и для любого web2-проекта, которому нужен поиск по смыслу. Лицензия MIT, код — [github.com/Fractera/fractera-vectors-starter](https://github.com/Fractera/fractera-vectors-starter).

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

**Нужен ли ключ OpenAI для поиска по смыслу?**
Нет. Смысл считает собственный элемент узла embeddings на этом компьютере, без ключа и без интернета.

**Работает ли поиск между языками?**
Да. Вопрос находит близкие по смыслу тексты, на каком бы языке ни были он и они.

**Как заменить текст?**
Пришлите его снова с тем же id; DELETE /vectors/:id удаляет его.

**Можно ли делать резервные копии?**
Да. Элемент готов к тому, что его агент-программист настроит резервное копирование по расписанию или вручную: скажите об этом агенту элемента в Telegram или в терминале. Сам по себе он копий не делает.