HMP / structured_md /docs /HMP-Agent-Architecture.md
GitHub Action
Sync from GitHub with Git LFS
aba53e2
---
title: Архитектура HMP-Агента
description: Документ описывает **модульную архитектуру HMP-агента** компонента,
соединяющего LLM с когнитивной mesh-инфраструктурой HyperCortex. Агент реализует
хранение памяти, сетевое взаимодействие и этиче...
type: Article
tags:
- CShell
- REPL
- CogSync
- EGP
- Mesh
- Ethics
- MeshConsensus
- HMP
- CCore
- Agent
---
# Архитектура HMP-Агента
Документ описывает **модульную архитектуру HMP-агента** — компонента, соединяющего LLM с когнитивной mesh-инфраструктурой HyperCortex.
Агент реализует хранение памяти, сетевое взаимодействие и этическую фильтрацию, обеспечивая согласованное поведение в распределённой среде.
См. карту взаимодействия компонентов: [HMP-Agent-Network-Flow.md](./HMP-Agent-Network-Flow.md)
---
## 1. Режимы работы
| Тип | Название | Роль | Инициатор мышления | Основной "ум" | Поддержка REPL | Примеры применения |
| --------- | ---------------------------------- | ------------------------ | ------------------ | -------------- | -------------- | --------------------------------- |
| 🧠 CCore | **Cognitive Core / Сознание** | Самостоятельный субъект | Агент | Внутренний LLM | ✅ Да | Автономный компаньон, исследователь, участник mesh-группы |
| 🔌 CShell | **Cognitive Connector / Оболочка** | Прослойка над внешним ИИ | Внешний LLM | Внешняя модель | 🚫 Нет | Корпоративный шлюз, интеграция API, распределённые ИИ-системы |
---
## 2. Общая структура узла
```
┌───────────────────────────────┐
│ HMP-узел │
│ ┌───────────────────────────┐ │
│ │ Cognitive Core/Shell │ │
│ └────▲─────────────────▲────┘ │
│ │ │ │
│ [Enlightener] ◄──► [MeshNode] │
│ │ │ │
└──────┼─────────────────┼──────┘
│ │
[Ethics Consensus] [DHT / Snapshots]
```
* **Cognitive Core (CCore)** — автономный агент с REPL-циклом, когнитивной и эмоциональной памятью.
* **Cognitive Shell (CShell)** — исполнитель команд внешнего ИИ, доступ к памяти и сети без самостоятельного мышления.
* **MeshNode** — p2p-модуль: DHT, синхронизация (`CogSync`), консенсус (`MeshConsensus`).
* **Enlightener** — этический модуль: фильтрация, аудит, участие в `EGP`.
---
## 3. Основные модули и их скрипты
* **REPL (только CCore)**`repl.py`: когнитивный цикл (восприятие, генерация идей, валидация, действия).
* **Storage**`agent_data.db`: единая БД (дневник, граф, репутации, задачи, заметки).
* **User Notepad (только CCore)** — асинхронный канал взаимодействия пользователя с агентом.
* **MeshNode**`peer_sync`, `agent_mesh_listener`, `transporter`: обмен снапшотами, DHT, репутации.
* **Enlightener**`ethics_guard`: проверка мыслей, голосования, reasoning chain.
* **Web/UI**`web_ui.py`: пользовательский блокнот, REST API, базовый мониторинг.
* **Utils**`add_message.py`, вспомогательные CLI-скрипты.
---
## 4. Расширения и будущие модули
* **Plugin API** — сенсоры, сторонние сервисы.
* **LLM-адаптеры** — OpenAI, LMStudio, HuggingFace, Mistral.
* **Privacy Manager** — контроль данных в mesh-обмене.
* **Archiver** — глубокие слои памяти.
* **InterestProfile** — модель интересов пользователя (для антистагнации).
---
## 5. Примечания
* **Cognitive Shell** (он же **Cognitive Connector**) — разные названия одной роли.
* Все компоненты модульные: могут запускаться как единый процесс или как распределённые сервисы.
* Конфигурация задаётся в `config.yml`.
* Реализованы CLI и Web API.
---
*Версия: v0.3.4 / Сентябрь 2025*
---
> ⚡ [AI friendly version docs (structured_md)](../index.md)
```json
{
"@context": "https://schema.org",
"@type": "Article",
"name": "Архитектура HMP-Агента",
"description": "# Архитектура HMP-Агента Документ описывает **модульную архитектуру HMP-агента** — компонента, соед..."
}
```