Архитектура и состав Home Ψ Lab¶
Home Ψ Lab состоит не только из физического мини-ПК. Это связка оборудования, базовой среды Proxmox VE и двух изолированных гостевых операционных систем. Такой состав принят и работает как версия 1.0.
Устройство версии 1.0¶
flowchart TB
hardware["Beelink — физические вычисления, память, диски и сетевые интерфейсы"]
proxmox["Proxmox VE — базовая ОС и гипервизор"]
gateway["Psi Gateway — Debian<br/>сетевой периметр и доступ"]
nexus["DETai Nexus — Ubuntu<br/>знания, модели и агентный runtime"]
hardware --> proxmox
proxmox --> gateway
proxmox --> nexus
| Уровень | Реализация | Ответственность |
|---|---|---|
| Физическая основа | Мини-ПК Beelink | Предоставляет вычислительные, дисковые и сетевые ресурсы лаборатории |
| Базовая среда | Proxmox VE | Управляет виртуальными ресурсами, изоляцией и жизненным циклом гостевых систем |
| Сетевой контур | Psi Gateway, Debian | Завершает внешний сетевой вход, применяет сетевую политику и обеспечивает локальный доступ |
| Вычислительный контур | DETai Nexus, Ubuntu | Предоставляет Linux-среду для моделей, знаний, retrieval, enrichment и прикладных компонентов |
Формулу «операционная система, которая создаёт операционные системы» полезно понимать как простую метафору. Proxmox — установленная на физическом узле Linux-среда и гипервизор: он создаёт виртуальные машины, выделяет им ресурсы и запускает внутри каждой собственную гостевую ОС. Поэтому один компьютер может поддерживать несколько логически отдельных систем.
Почему Gateway и Nexus разделены¶
Psi Gateway и DETai Nexus различаются не только названиями, но и классом ответственности.
- Gateway относится к базовой связности: его задача — предсказуемо и безопасно соединять локальную лабораторию с внешними сетями.
- Nexus относится к вычислительной и смысловой работе: модели, индексы, обработка знаний и агентные процессы могут развиваться быстрее и чаще меняться.
Изоляция не устраняет все общие риски одного физического хоста, но сокращает область влияния программных изменений. Эксперимент или обновление в Nexus не должны автоматически менять сетевую политику Gateway. Сетевой компонент, в свою очередь, не получает прикладные данные и функции только потому, что обе системы используют одно оборудование.
После фиксации Home Ψ Lab v1.0 эти контуры имеют отдельные циклы развития: общая лаборатория отвечает за физическую основу и Proxmox, Psi Gateway — за сеть и защищённую связность, DETai Nexus — за вычислительную и агентную среду.
DETai Nexus как вычислительная среда¶
DETai Nexus размещает компоненты нескольких самостоятельных систем. Он не объединяет их репозитории и не забирает их ответственность:
| Слой | Владелец | Содержимое |
|---|---|---|
| Продуктовый смысл | соответствующий продукт | Правила, contracts и human review |
| LLM-исполнение | intelligence-runtime | Сценарии, model roles, adapters, validators и traces |
| Общие живые процессы | ecosystem-runtime | API, боты, workers и runtime-данные |
| Каноническое знание | Knowledge Substrate | Документы, knowledge pipelines, retrieval и detai_core |
| Машина и deployment | Infrastructure | Ресурсы, сервисы, модели, данные и backup |
Репозитории остаются самостоятельными источниками истины, а Infrastructure связывает их на конкретной машине.
Как продукты подключаются к LLM¶
Продукт передаёт собственные правила и contracts. Intelligence Runtime создаёт для него проектную проекцию: технический сценарий, который связывает эти правила с доступными LLM и проверками. Модели и inference runtime размещаются в Nexus, а результат возвращается продукту для предусмотренного human review.
Подробнее эта граница объяснена на странице intelligence-runtime.
Данные и память¶
PostgreSQL и Qdrant имеют отдельные постоянные области данных и не смешиваются с Git checkout или scenario cache.
- knowledge-данные принадлежат Knowledge Substrate;
- общие operational schemas принадлежат
ecosystem-runtime; - product-specific schemas принадлежат соответствующим продуктам;
- Qdrant хранит векторные проекции по versioned retrieval contracts, а не неструктурированные копии runtime cache.
Веса моделей и inference binaries являются общими машинными ресурсами. Код сценария ссылается на model roles, поэтому физическую модель можно менять через конфигурацию и benchmark без переноса продуктовой семантики.
Архитектурные принципы¶
Собственная основа без изоляционизма¶
Лаборатория не ставит цель самостоятельно воспроизвести каждый облачный сервис или отказаться от внешних моделей. Её задача — сделать зависимости явными и управляемыми. Критически важные знания, версии, правила и данные должны сохранять переносимость, а внешние компоненты — иметь понятную границу и, где это практически возможно, путь замены.
Техника подчинена смыслу и ответственности¶
Инфраструктура психотерапевтической экосистемы не нейтральна: способы хранения, доступа, поиска и автоматизации влияют на то, какие различия система замечает и кому отдаёт право решения. Поэтому собственная вычислительная среда важна не сама по себе. Она создаёт место, где команда может осознанно проектировать технологию вокруг метода, человеческой субъектности и профессиональной ответственности.
Инфраструктура — длительное обязательство¶
Готовность версии 1.0 означает, что базовая архитектура собрана и работает, а не что работа завершена навсегда. Узел требует обновлений, мониторинга, резервного копирования, проверки восстановления, управления доступом и документирования изменений. Эти процессы относятся к эксплуатации и не раскрываются на публичной странице.
Home Ψ Lab остаётся частью распределённой Infrastructure. Перенос stateful- сервиса включает проверяемый backup, изолированный restore, отдельный cutover и ограниченный период read-only fallback; создание копии данных само по себе не является cutover.
Граница документа¶
Публично фиксируются назначение уровней, операционные системы, разделение ответственности и устойчивые архитектурные принципы. Hostnames, IP-адреса, учётные данные, ключи, точная сетевая топология, конфигурации, команды и журналы работ остаются во внутренних системах ClickUp и Infrastructure согласно документационной архитектуре DETai.