From 72903ad4265b91dec07d3d82a66d7b45f4de3749 Mon Sep 17 00:00:00 2001 From: neo Date: Tue, 13 Oct 2026 22:00:16 +0500 Subject: [PATCH] =?UTF-8?q?ADR-11:=20=D0=B4=D0=BE=D0=BA=D1=83=D0=BC=D0=B5?= =?UTF-8?q?=D0=BD=D1=82=D1=8B=20Outline=20=3D=20=D0=BE=D0=B1=D0=B7=D0=BE?= =?UTF-8?q?=D1=80=20=D1=82=D0=B5=D1=85=D0=BD=D0=BE=D0=BB=D0=BE=D0=B3=D0=B8?= =?UTF-8?q?=D0=B9=20=D0=B4=D0=BB=D1=8F=20=D0=BF=D1=80=D0=BE=D0=B2=D0=B5?= =?UTF-8?q?=D1=80=D0=BA=D0=B8=20=D0=BD=D0=B0=20=D0=B6=D0=B5=D0=BB=D0=B5?= =?UTF-8?q?=D0=B7=D0=B5,=20=D0=B0=20=D0=BD=D0=B5=20=D0=BE=D0=B1=D1=8F?= =?UTF-8?q?=D0=B7=D0=B0=D1=82=D0=B5=D0=BB=D1=8C=D0=BD=D0=B0=D1=8F=20=D0=B8?= =?UTF-8?q?=D0=BD=D1=81=D1=82=D1=80=D1=83=D0=BA=D1=86=D0=B8=D1=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ARCHITECTURE.md | 35 ++++++++++++++++++++++++++++++----- 1 file changed, 30 insertions(+), 5 deletions(-) diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md index da0ca4c..9071aa6 100644 --- a/ARCHITECTURE.md +++ b/ARCHITECTURE.md @@ -50,7 +50,7 @@ **Решение:** Единое хранилище — текст, векторы, граф, метаданные в Postgres. **Почему:** -- pgvector = семантический поиск (检索增强). +- pgvector = семантический поиск. - AGE = граф связей (сущности, концепты). - Один движок вместо трёх БД. @@ -64,9 +64,9 @@ ## 5. Anvil: контроль прав и репутация (прозрачность правил) -**Решение:** Агент начинает с минимальными правами. Успённое действие → +репутация → расширение прав. Контракты: PermissionRegistry, ReputationOracle, BudgetController, CuriosityReward. +**Решение:** Агент начинает с минимальными правами. Успешное действие → +репутация → расширение прав. Контракты: PermissionRegistry, ReputationOracle, BudgetController, CuriosityReward. -**Цель (главное):** **прозрачность правил** — агент видим, почему ему что-то можно/нельзя. Каждое решение «разрешено/запрещено» записано и объяснимо. +**Цель (главное):** **прозрачность правил** — агент видит, почему ему что-то можно/нельзя. Каждое решение «разрешено/запрещено» записано и объяснимо. **Решение для MVP:** контроль = обычный код + **append-only журнал** (ADR-2). Журнал уже даёт аудируемость: можно пересчитать, какие права были у агента в любой момент и почему. Блокчейн НЕ нужен, пока нет переносимой репутации. @@ -92,7 +92,7 @@ **Решение:** Planner генерирует кандидатов → World Model предсказывает следующее состояние → агент выбирает с наивысшим сходством → верификация после выполнения. -**Почему:** локальные модели плохо планируют на много шагов вперёд. World Model даёт «представление о мире» без реального действия. +**Почему:** локальные плохо планируют на много шагов вперёд. World Model даёт «представление о мире» без реального действия. **Меры надёжности:** - Планирование на один шаг (k=1). @@ -150,12 +150,36 @@ **Решение:** spark-mind = первый слой Alicorn (чаты + память). Alicorn = полная архитектура. -**Почему:** spark-midal уже работает (персона, память, дашборд на :1337). Alicorn строится на этом фундаменте, но с детерминированным runtime'ом. +**Почему:** spark-mind уже работает (персона, память, дашборд на :1337). Alicorn строится на этом фундаменте, но с детерминированным runtime'ом. **Риски:** spark-mind non-deterministic (Python); Alicorn должен быть переписан на Rust. --- +## 11. Как читать документы Outline: обзор технологий, а не инструкция + +**Решение:** Все документы Outline (ветка «autonom agent alikorn») — это **обзор существующих технологий и способов решения задач**, а не обязательная к исполнению спецификация. + +**Мета-позиция:** +- Концепция — это **основная идея** (направление, философия), а не детальные требования. +- Каждый инструмент/технология/фреймворк — **гипотеза**, которую нужно **проверить на железе и реальных задачах**, а не принимать по описанию. +- «Существует проект X, который решает задачу Y» ≠ «мы берём X и всё работает». Реальная ценность — в измерении: как X ведёт себя на 2×3080 Ti, на bge-m3, на локальных моделях с 8K контекстом. + +**Почему:** +- Описания в репозиториях и статьях показывают лучший случай, а не поведение в твоей инфраструктуре. +- Выбор инструментов — эмпирический: gresmcp vs MinerU vs Segnatura, σ-RAG пороги, semantic_density — всё выводится на стенде, а не в спецификации. +- Контекст меняется: то, что актуально сегодня (версия, железо, модели), завтра устаревает. Идея устойчивее инструментов. + +**Как применять:** +1. Прочитать как карту возможностей («что вообще возможно»). +2. Выбрать кандидатов под MVP и реальные задачи. +3. Протестировать на железе: latency, качество, consumption GPU. +4. Отбросить то, что не показывает результат; оставить то, что работает. + +**Пример:** BookRAG (Tree+KG+GT-Link) и RAGA (Read-Search-Verify-Construct) — проверены как близкие к твоей схеме. Kompyla/MetaKGEinrich/EvoMemKG — исследовать на v2, если MVP покажет потребность. + +--- + ## Статус решений | # | Решение | Статус | @@ -170,3 +194,4 @@ | 8 | Observability (OTEL+ClickHouse) | Принято (для full-версии) | | 9 | MVP-стратегия | Принято | | 10 | Связь с spark-mind | Принято | +| 11 | Обзор технологий (не инструкция) | Принято |