File size: 5,903 Bytes
6be0a07
31877c7
f0f3e0e
 
 
6be0a07
6594b52
df7daf4
 
 
a2f9d0c
 
df7daf4
 
 
a2f9d0c
 
6be0a07
 
31877c7
13f52e0
f0f3e0e
 
 
 
13f52e0
 
 
f0f3e0e
13f52e0
f0f3e0e
 
 
 
13f52e0
 
 
f0f3e0e
13f52e0
 
f0f3e0e
 
 
 
 
 
 
 
 
 
 
13f52e0
 
f0f3e0e
 
 
 
13f52e0
 
 
f0f3e0e
13f52e0
f0f3e0e
 
 
 
 
 
 
13f52e0
 
 
 
 
f0f3e0e
 
 
 
 
13f52e0
 
 
f0f3e0e
13f52e0
f0f3e0e
 
 
 
13f52e0
 
 
f0f3e0e
13f52e0
 
6594b52
 
 
 
13f52e0
 
 
 
31877c7
f0f3e0e
13f52e0
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
---
title: Архитектура HMP-Агента
description: Документ описывает **модульную архитектуру HMP-агента**  компонента,
  соединяющего LLM с когнитивной mesh-инфраструктурой HyperCortex.   Агент реализует
  хранение памяти, сетевое взаимодействие и этиче...
type: Article
tags:
- EGP
- HMP
- CogSync
- CCore
- REPL
- MeshConsensus
- Agent
- Ethics
- Mesh
- CShell
---

# Архитектура 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-агента** — компонента, соед..."
}
```