# Workspace — полное описание файловой структуры

Рабочая директория: `/home/node/.openclaw/workspace`

---

## 📁 Корневые файлы

| Файл | Описание |
|---|---|
| `AGENTS.md` | Инструкция для всех агентов: порядок сессий, память, правила работы, heartbeats |
| `SOUL.md` | Личность ассистента Стрим: стиль, ценности, подход к работе |
| `USER.md` | Профиль Славы: имя, интересы, предпочтения в общении |
| `TOOLS.md` | Заметки по конкретной конфигурации инструментов (камеры, SSH, голоса и т.д.) |
| `IDENTITY.md` | Идентичность ассистента: имя, пол, эмодзи, vibe |
| `MEMORY.md` | Долгосрочная память: правила, люди, проекты, принятые решения |
| `HEARTBEAT.md` | Список задач, выполняемых каждые 30–60 минут в фоне |
| `BACKLOG_GENERAL.md` | Общий бэклог идей и задач |
| `BACKLOG_NOISEMAP.md` | Бэклог проекта noisemap (шумовая карта) |

---

## 📁 memory/ — Дневные записи памяти

| Файл | Описание |
|---|---|
| `2026-03-27.md` | События за 27 марта 2026 (текущий день) |

Создаётся `memory/YYYY-MM-DD.md` для каждого дня. Содержит сырые заметки: что делали, что приняли, что решили. Обновляется после компакции контекста.

---

## 📁 data/ — Данные скиллов

### data/telegram-collector/raw/
Сырые дампы сообщений из Telegram-каналов, разделённые по каналу и топику.

- Каналы: `snowbikerussia/`, `snowbike_msk/`, `crossmania/`
- В каждом топике: файлы сообщений (`messages_*.jsonl`), медиафайлы, метаданные

---

## 📁 skills/ — Скиллы (AgentSkills)

### skills/telegram-collector/
Сбор и анализ сообщений из Telegram-каналов через Telethon (пользовательский аккаунт).

- `SKILL.md` — инструкция по запуску
- `scripts/collector.py` — основной скрипт
- `scripts/analyzer.py` — двухпроходный анализ (GPT-4o mini → Claude Sonnet)

### skills/telegram-monitor/
Мониторинг публичных каналов (bots API, чтение через Meilisearch + токенизатор).

### skills/summarize-chat/
Генерация саммари сообщений из Telegram-чатов.

### skills/summarize-pdf/
Извлечение и суммаризация текста из PDF-файлов.

### skills/summarize-url/
Извлечение текста из веб-страниц и его суммаризация.

### skills/weather/
Получение погоды через wttr.in или Open-Meteo.

### skills/rag/
Retrieval-Augmented Generation — поиск по векторной базе.

### skills/openai-image-gen/
Генерация изображений через OpenAI Images API.

---

## 📁 scripts/ — Общие скрипты

| Файл | Описание |
|---|---|
| `scripts/send_video_note.sh` | Pipeline для отправки видео-кружочков (TTS → fal.ai → VEED → Telegram) |

---

## 📁 tasks/ — Задачи и проекты

### tasks/flightradar24/
Проект «Карта шумового загрязнения» — визуализация трёков самолётов над МО.

| Файл | Описание |
|---|---|
| `prototype/app.py` | Flask-сервер (порт 5555) |
| `prototype/index.html` | Карта: OpenLayers, треки, зоны шума |
| `prototype/noise_model.py` | Модель шума (радиус по высоте) |
| `prototype/density_model.py` | Плотность пролётов (рейсов/час) |
| `prototype/fr24_client.py` | Клиент для Flightradar24 API |
| `prototype/fetch_tablo.py` | Скачивание табло вылетов из Яндекс.Расписаний |
| `prototype/fetch_strategy_b.py` | Загрузка рейсов через табло + live-снимки |
| `prototype/fetch_strategy_b_v2.py` | Тот же скрипт, с исправлениями (CLI-дата, sys) |
| `prototype/fetch_airport.py` | Стратегия А: снимки зоны аэропорта |
| `prototype/fetch_tracks.py` | Загрузка трёков по fr24_id |
| `prototype/fetch_svo_tracks.py` | Загрузка трёков SVO (Серпухов) |
| `prototype/generate_sample_data.py` | Генерация тестовых данных |
| `prototype/sample_flights.json` | Пример данных трёков |

**Документация:**
| Файл | Описание |
|---|---|
| `prototype/docs/FR24_API.md` | Описание API Flightradar24 |
| `prototype/docs/ARCHITECTURE.md` | Архитектура приложения |
| `prototype/docs/NOISE_MODEL.md` | Модель шума |
| `prototype/docs/DATA_LOADING.md` | Загрузка данных |
| `prototype/docs/UI.md` | Описание UI карты |
| `prototype/docs/TZ_DENSITY_LAYER.md` | ТЗ слоя плотности |
| `prototype/docs/DEVLOG.md` | dev-журнал |
| `reports/ТЗ_Карта_шумового_загрязнения_Flightradar24.md` | Главное ТЗ |

**Данные:**
- `prototype/data/cache_SVO/` — кэш трёков SVO
- `prototype/data/cache_svo/` — кэш трёков SVO (стратегия А)
- `prototype/data/cache_SVO_b/` — кэш рейсов SVO (стратегия Б)
- `prototype/data/cache_DME/` — кэш трёков DME
- `prototype/data/cache_VKO/` — кэш трёков VKO
- `prototype/data/cache_ZIA/` — кэш трёков ZIA
- `prototype/data/cache_SVO_offset90m/` — кэш SVO, смещение на 90 мин
- `prototype/data/cache_VKO_offset90m/` — кэш VKO, смещение на 90 мин
- `prototype/data/flights_SVO_2026-03-20_offset90m.json` — рейсы SVO за 20 марта
- `prototype/data/flights_SVO_2026-03-21.json` — рейсы SVO за 21 марта
- `prototype/data/flights_DME_*.json` — рейсы DME
- `prototype/data/flights_VKO_*.json` — рейсы VKO
- `prototype/data/flights_ZIA_*.json` — рейсы ZIA
- `prototype/data/flights_SVO_2026-03-21_strategy_b.json` — SVO, стратегия Б
- `prototype/data/flights_SVO_2026-03-26_strategy_b.json` — **пустой файл** (дубль 21.03)
- `prototype/data/tablo_SVO_2026-03-21.json` — табло вылетов SVO
- `prototype/data/tablo_SVO_2026-03-26.json` — табло вылетов SVO (26.03)
- `prototype/data/tablo_need_load.json` — табло, данные для загрузки
- `prototype/data/density_cache*.json/.gz` — кэш слоя плотности (gzip сжатие)
- `prototype/data/raw_*.json` — сырые данные с API

**Кредиты FR24:** потрачены (~16 161 из 120 000 промо), все попытки загрузить 26 марта → HTTP 402.

---

### tasks/snowbike-rag/
RAG-система для базы знаний о сноубайках.

| Файл | Описание |
|---|---|
| `server.py` | Flask-сервер поиска |
| `scripts/parse_messages.py` | Парсинг сообщений |
| `scripts/index_chromadb.py` | Индексация в ChromaDB |
| `scripts/index_meilisearch.py` | Индексация в Meilisearch |
| `scripts/search.py` | Скрипт поиска |
| `start.sh` | Запуск всего |
| `templates/index.html` | UI для поиска |
| `config/docker-compose.yml` | Docker для Meilisearch |
| `data/messages.jsonl` | Сообщения из Telegram |
| `data/chromadb/` | База ChromaDB |
| `data/meilisearch/` | База Meilisearch |
| `bin/meilisearch` | Бинарник Meilisearch |
| `BRD.md`, `TZ.md` | ТЗ и Бизнес-требования |
| `README.md` | Документация |

---

### tasks/snowbike-kb/
Веб-просмотрщик базы знаний о сноубайках.

| Файл | Описание |
|---|---|
| `server.py` | Flask-сервер (порт 5556) |
| `viewer/index.html` | UI просмотра |
| `run_analysis.sh` | Скрипт запуска анализа |

---

### tasks/video-notes/
Видеокружочки (lip sync).

| Файл | Описание |
|---|---|
| `TZ.md` | ТЗ для генерации видео-кружочков |

---

### tasks/legal-agent/
Юрист по законам РФ.

| Файл | Описание |
|---|---|
| `AGENTS.md` | Инструкции для юриста |
| `SOUL.md` | Личность юриста |

---

### tasks/planner-agent/
Агент-планировщик (подготовлен промпт, не развёрнут).

| Файл | Описание |
|---|---|
| `SOUL.md` | Личность планировщика |

---

### tasks/scripts/
| Файл | Описание |
|---|---|
| `token_summary.py` | Суммаризация расходов токенов |
| `usage_summary.py` | Суммаризация использования |

---

### tasks/token-log.md
Лог расхода токенов по задачам (DEV-XXX / XK in / XK out → $X.XX).

---

## 📁 dumps/
Пустая папка (для backup-ов).

---

## 📁 temp/
Пустая папка (временные файлы).

---

## Вне workspace (system)

| Путь | Описание |
|---|---|
| `~/.openclaw/.env` | Секреты: OPENROUTER_API_KEY, TELEGRAM_BOT_TOKEN, OPENSKY_CLIENT_ID/SECRET, YANDEX_API_KEY и др. |
| `~/.openclaw/openclaw.json` | Конфиг OpenClaw: модель, каналы, скиллы |
| `/app/docs/` | Документация OpenClaw |
| `/app/skills/` | Встроенные скиллы (voice-tts, node-connect, healthcheck) |