Skip to content

An always-on second brain you talk to. Voice notes in Telegram → typed, linked knowledge in your Obsidian vault. Runs 24/7 on the Claude subscription you already have.

docs: обновить README

smixsdb7eac6ea714
diff --git a/README.md b/README.md
index 00e537f..28d3814 100644
--- a/README.md
+++ b/README.md
@@ -1,44 +1,102 @@
# Agent Second Brain
-**Голосовой личный ассистент в Telegram с интеграцией Obsidian и Todoist**
+**Персональный AI-ассистент с долговременной памятью**
-Записываешь голосовые → бот транскрибирует → сохраняет в Obsidian → создаёт задачи в Todoist → присылает отчёты.
+Записывайте голосовые в Telegram — агент сам разберётся что с ними делать: создаст задачи, сохранит мысли, обновит прогресс по целям.
---
-## Что умеет бот
+## Что это и зачем
-| Функция | Описание |
-|---------|----------|
-| 🎤 Голосовые | Транскрибирует через Deepgram (русский язык) |
-| 💬 Текст | Сохраняет как есть |
-| 📷 Фото | Сохраняет с подписью |
-| ⚙️ Обработка | Классифицирует записи, создаёт задачи, сохраняет мысли |
-| 📅 Недельный дайджест | Анализирует неделю, показывает прогресс по целям |
-| ✨ Произвольные запросы | "Перенеси задачи", "Покажи на сегодня" |
+Вы отправляете боту всё подряд: голосовые заметки, скриншоты, пересланные сообщения, ссылки. Бот сохраняет это в один файл за день.
-### Интерфейс
+Вечером (по расписанию или вручную) запускается Claude — он читает ваши записи и:
+- Создаёт задачи в Todoist (с приоритетами и датами)
+- Сохраняет ценные мысли в Obsidian (идеи, выводы, инсайты)
+- Связывает новые записи с вашими целями
+- Присылает отчёт в Telegram: что сделал, что предстоит
+
+В конце недели — автоматический дайджест: прогресс по целям, что получилось, что нет.
+
+<!-- TODO: Скриншот итогового отчёта в Telegram -->
+
+---
+
+## Как это выглядит
```
-┌──────────────────────────────────────┐
-│ 🎤 [Голосовое сообщение] │
-│ │
-│ ✓ Сохранено: 14:30 [voice] │
-│ "Надо обсудить проект с командой" │
-├──────────────────────────────────────┤
-│ [📊 Статус] [⚙️ Обработать] [📅 Неделя] │
-│ [✨ Запрос] [❓ Помощь] │
-└──────────────────────────────────────┘
+Вы в течение дня:
+┌────────────────────────────────────┐
+│ 🎤 "Надо обсудить проект с Лёшей" │
+│ 📷 [скриншот ошибки] │
+│ 💬 "Идея для лендинга: ..." │
+│ ↪️ [переслал чат с клиентом] │
+└────────────────────────────────────┘
+ ↓
+Claude вечером:
+┌────────────────────────────────────┐
+│ ✅ Создано 3 задачи в Todoist │
+│ 📝 Сохранена идея: лендинг │
+│ 🎯 Связь с целью: Запуск продукта │
+│ 📊 Прогресс недели: 65% │
+└────────────────────────────────────┘
```
---
+## Архитектура
+
+```
+┌──────────────┐ ┌──────────────┐ ┌──────────────┐
+│ Telegram │────▶│ VPS-сервер │────▶│ GitHub │
+│ (ввод) │ │ (бот+агент) │ │ (backup) │
+└──────────────┘ └──────────────┘ └──────────────┘
+ │
+ ┌─────────────┼─────────────┐
+ ▼ ▼ ▼
+ ┌──────────┐ ┌──────────┐ ┌──────────┐
+ │ Todoist │ │ Obsidian │ │ Claude │
+ │ (задачи) │ │ (заметки)│ │ (AI) │
+ └──────────┘ └──────────┘ └──────────┘
+```
+
+**Почему так:**
+- **Telegram** — самый удобный способ записать мысль на ходу
+- **VPS** — бот работает 24/7, не зависит от вашего компьютера
+- **GitHub** — автоматический backup + синхронизация с компьютером
+- **Todoist** — задачи в одном месте, уведомления, мобильное приложение
+- **Obsidian** — полный контроль над данными, связи между заметками
+
+---
+
## Требования
-- Компьютер с VS Code и Git
-- VPS с Ubuntu 22.04+ (минимум 1GB RAM)
-- Аккаунты: Telegram, Deepgram (бесплатно $200), Anthropic (Claude)
-- Опционально: Todoist
+### Обязательно
+
+| Компонент | Зачем | Стоимость |
+|-----------|-------|-----------|
+| **Claude Max/Pro** | AI-агент для обработки записей | от $20/мес |
+| **VPS-сервер** | Хостинг бота 24/7 | от $4/мес |
+| **GitHub** | Бесплатный backup и синхронизация | бесплатно |
+| **Deepgram** | Транскрипция голосовых | бесплатно ($200 на старт) |
+
+### Рекомендуется
+
+| Компонент | Зачем | Стоимость |
+|-----------|-------|-----------|
+| **Todoist** | Управление задачами | бесплатно / $4/мес Pro |
+| **Obsidian** | Просмотр заметок на компе | бесплатно |
+
+### Важные замечания
+
+**Claude:** Минимальная подписка за $20/мес — достаточно. Это в 5 раз лучше ChatGPT для работы с кодом и структурированными данными.
+
+**VPS:** Нужен сервер НЕ в РФ/РБ (блокировка Claude по территории). Рекомендую:
+- [Contabo](https://contabo.com) — от $4/мес, простая регистрация
+- [OVH](https://ovhcloud.com) — от $3/мес, без паспорта
+- [Hetzner](https://hetzner.com) — от $4/мес, немецкое качество
+
+**Deepgram:** $200 на счёт при регистрации. Хватает на ~500 часов голосовых сообщений.
---
@@ -46,7 +104,7 @@
Сначала настраиваем проект локально, потом переносим на сервер.
-## Шаг 1: Установка Git и VS Code
+## 1.1 Установка Git и VS Code
### Windows
@@ -55,11 +113,14 @@
3. Скачайте [VS Code](https://code.visualstudio.com/)
4. Установите
+<!-- TODO: Скриншот установки Git на Windows -->
+
### Mac
-1. Откройте Terminal (Cmd+Пробел → "Terminal")
-2. Введите `git --version` — если не установлен, система предложит установить
-3. Скачайте [VS Code](https://code.visualstudio.com/)
+1. Откройте Terminal (`Cmd + Пробел` → наберите "Terminal")
+2. Введите `git --version`
+3. Если не установлен — система предложит установить Xcode Command Line Tools, соглашайтесь
+4. Скачайте [VS Code](https://code.visualstudio.com/)
### Linux
@@ -70,263 +131,306 @@ sudo apt install git
---
-## Шаг 2: Клонирование проекта
+## 1.2 Клонирование проекта
1. Откройте VS Code
2. Нажмите `Ctrl+Shift+P` (Windows/Linux) или `Cmd+Shift+P` (Mac)
-3. Введите "Git: Clone"
-4. Вставьте URL: `https://github.com/smixs/dbrain.git`
-5. Выберите папку, куда сохранить (например, Documents)
+3. Введите "Git: Clone" и выберите эту команду
+4. Вставьте URL:
+ ```
+ https://github.com/smixs/agent-second-brain.git
+ ```
+5. Выберите папку (например, Documents)
6. Нажмите "Open" когда спросит
+<!-- TODO: Скриншот клонирования в VS Code -->
+
Теперь у вас открыт проект в VS Code.
---
-## Шаг 3: Очистка чужих данных
+## 1.3 Очистка демо-данных
-В левой панели VS Code найдите и **удалите** содержимое этих папок:
+В левой панели VS Code найдите и **удалите** содержимое этих папок (это мои демо-записи, вам они не нужны):
```
-vault/daily/ ← удалить все файлы внутри
-vault/thoughts/ideas/ ← удалить все файлы
+vault/daily/ ← удалите все файлы внутри
+vault/thoughts/ideas/ ← удалите все файлы
vault/thoughts/projects/
vault/thoughts/learnings/
vault/thoughts/reflections/
-vault/summaries/ ← удалить все файлы
-vault/attachments/ ← удалить все папки внутри
+vault/summaries/ ← удалите все файлы
+vault/attachments/ ← удалите все папки внутри
```
**Как удалить:** правый клик на файл → Delete
----
-
-## Шаг 4: Заполнение целей (с AI-помощником)
-
-Это самый важный шаг! Бот будет использовать ваши цели для приоритизации задач.
-
-### Вариант A: С помощью ChatGPT/Claude
-
-1. Откройте ChatGPT или Claude в браузере
-2. Скопируйте туда содержимое файла `vault/goals/0-vision-3y.md`
-3. Напишите:
-
-```
-Ты мой личный коуч. Помоги мне заполнить этот шаблон 3-летнего видения.
-Задавай мне вопросы по одному, чтобы понять:
-- Где я хочу быть через 3 года в карьере?
-- Какое здоровье и энергия мне нужны?
-- Какие отношения я хочу?
-- Что для меня финансовая свобода?
-- Что приносит мне радость?
-
-После каждого моего ответа задавай уточняющие вопросы.
-В конце сформируй заполненный шаблон.
-```
-
-4. Ответьте на вопросы AI
-5. Скопируйте результат обратно в файл
-
-Повторите для:
-- `vault/goals/1-yearly-2026.md` — годовые цели
-- `vault/goals/2-monthly.md` — приоритеты на месяц
-- `vault/goals/3-weekly.md` — фокус на неделю
+<!-- TODO: Скриншот файловой структуры в VS Code -->
-### Вариант B: Самостоятельно
-
-Откройте каждый файл в VS Code и заполните своими целями.
-
-**Важно:** В файле `3-weekly.md` есть секция "ONE Big Thing" — это ваш главный фокус на неделю. Бот показывает его в каждом отчёте.
+**Не трогайте:**
+- `vault/goals/` — шаблоны целей (заполните своими)
+- `vault/MOC/` — индексы для навигации
+- `vault/.claude/` — настройки AI-агента
+- `vault/templates/` — шаблоны
---
-## Шаг 5: Настройка профиля
-
-Откройте файл:
-```
-vault/.claude/skills/dbrain-processor/references/about.md
-```
-
-Замените информацию на свою:
-- Имя
-- Чем занимаетесь
-- Основные проекты
-- Приоритеты
-
-Это поможет боту понимать контекст ваших записей.
-
----
+## 1.4 Создание своего репозитория на GitHub
-## Шаг 6: Создание своего репозитория
+Нужно создать свой репозиторий, чтобы ваши записи хранились у вас, а не у меня.
-1. Зайдите на [GitHub](https://github.com)
+1. Зайдите на [github.com](https://github.com)
2. Войдите или создайте аккаунт
3. Нажмите "+" → "New repository"
-4. Имя: `my-second-brain` (или любое)
+4. **Имя:** `my-second-brain` (или любое другое)
5. **Важно:** Оставьте все галочки пустыми (без README, без .gitignore)
6. Нажмите "Create repository"
-7. Скопируйте URL вашего репозитория (например: `https://github.com/YOUR_NAME/my-second-brain.git`)
----
+<!-- TODO: Скриншот создания репозитория на GitHub -->
-## Шаг 7: Публикация в свой репозиторий
+7. Скопируйте URL вашего репозитория:
+ ```
+ https://github.com/ВАШ_ЛОГИН/my-second-brain.git
+ ```
+
+---
-В VS Code:
+## 1.5 Публикация в свой репозиторий
-1. Откройте Terminal: меню View → Terminal (или `Ctrl+``)
-2. Введите команды:
+1. В VS Code откройте Terminal: меню `View → Terminal` (или `Ctrl+``)
+2. Введите команду (замените URL на свой):
```bash
-git remote set-url origin https://github.com/YOUR_NAME/my-second-brain.git
+git remote set-url origin https://github.com/ВАШ_ЛОГИН/my-second-brain.git
```
3. В левой панели нажмите на иконку с веткой (Source Control)
-4. Вы увидите список изменённых файлов
-5. Нажмите "+" рядом с "Changes" чтобы добавить все файлы
-6. В поле "Message" напишите: `Initial setup with my goals`
-7. Нажмите кнопку "Commit"
-8. Нажмите "Sync Changes" или "Publish Branch"
+4. Нажмите "+" рядом с "Changes" чтобы добавить все файлы
+5. В поле "Message" напишите: `Initial setup`
+6. Нажмите кнопку "Commit"
+7. Нажмите "Sync Changes" или "Publish Branch"
-Если спросит логин — введите ваш GitHub логин и пароль (или Personal Access Token).
+<!-- TODO: Скриншот коммита в VS Code -->
-**Готово!** Ваш проект с вашими целями теперь в вашем репозитории.
+Если спросит логин — введите свой GitHub логин и пароль (или Personal Access Token, если включена двухфакторка).
+
+**Готово!** Проект теперь в вашем репозитории.
---
# Часть 2: Получение токенов
-Перед настройкой сервера получите все нужные токены.
+Перед настройкой сервера соберите все нужные ключи. Сохраните их в надёжное место.
-## Telegram Bot Token
+## 2.1 Telegram Bot Token
1. Откройте Telegram
-2. Найдите `@BotFather`
+2. Найдите бота `@BotFather`
3. Отправьте `/newbot`
-4. Введите имя бота: `My Second Brain`
-5. Введите username: `my_brain_bot` (должен заканчиваться на `bot`)
+4. Введите имя бота: `My Second Brain` (любое)
+5. Введите username: `my_brain_777_bot` (должен заканчиваться на `bot`, должен быть уникальным)
6. Скопируйте токен:
```
7123456789:AAHdN8J2K4m5N6o7P8q9R0s1T2u3V4w5X6y
```
+<!-- TODO: Скриншот BotFather с токеном -->
+
**Сохраните токен!**
-## Ваш Telegram ID
+---
+
+## 2.2 Ваш Telegram ID
+
+Бот будет отвечать только вам. Для этого нужен ваш ID.
-1. Найдите `@userinfobot` в Telegram
+1. Найдите бота `@userinfobot` в Telegram
2. Отправьте любое сообщение
-3. Скопируйте ваш ID: `123456789`
+3. Скопируйте свой ID: `123456789`
**Сохраните ID!**
-## Deepgram API Key
+---
+
+## 2.3 Deepgram API Key
+
+Deepgram транскрибирует голосовые сообщения. При регистрации дают $200 — хватает надолго.
1. Зайдите на [console.deepgram.com](https://console.deepgram.com/)
-2. Зарегистрируйтесь (бесплатно, $200 на старте)
-3. Settings → API Keys → Create API Key
-4. Скопируйте ключ (показывается один раз!)
+2. Зарегистрируйтесь (можно через Google)
+3. Перейдите в Settings → API Keys
+4. Нажмите "Create API Key"
+5. Скопируйте ключ (показывается только один раз!)
+
+<!-- TODO: Скриншот создания ключа Deepgram -->
**Сохраните ключ!**
-## Todoist API Token (опционально)
+---
+
+## 2.4 Todoist API Token (опционально)
+
+Если хотите, чтобы бот создавал задачи в Todoist:
-1. [todoist.com](https://todoist.com) → Settings → Integrations → Developer
-2. Скопируйте API token
+1. Зайдите на [todoist.com](https://todoist.com)
+2. Settings → Integrations → Developer
+3. Скопируйте API token
+
+**Без Todoist** бот всё равно будет работать — просто не будет создавать задачи автоматически.
+
+---
+
+## 2.5 Итоговый чек-лист токенов
+
+Перед следующим шагом убедитесь, что у вас есть:
+
+- [ ] Telegram Bot Token: `7123456789:AAH...`
+- [ ] Ваш Telegram ID: `123456789`
+- [ ] Deepgram API Key: `abc123def456...`
+- [ ] (опционально) Todoist API Token
---
# Часть 3: Настройка VPS
-Теперь переносим проект на сервер.
+Теперь переносим проект на сервер, чтобы бот работал 24/7.
+
+## 3.1 Покупка VPS
+
+**Contabo (рекомендую):**
+1. Зайдите на [contabo.com](https://contabo.com/en/vps/)
+2. Выберите "Cloud VPS S" (~$5/мес)
+3. Region: любой кроме Russia
+4. ОС: Ubuntu 22.04
+5. Оплатите картой
+6. Получите на почту: IP-адрес и пароль root
-## Шаг 1: Покупка VPS
+**Альтернативы:**
+- [OVH Starter](https://ovhcloud.com/en/vps/) — от $3/мес
+- [Hetzner Cloud](https://hetzner.cloud/) — от $4/мес
-Рекомендую [Contabo](https://contabo.com) — дёшево и надёжно.
+<!-- TODO: Скриншот выбора VPS на Contabo -->
+
+---
-- Выберите Cloud VPS
-- ОС: Ubuntu 22.04
-- Минимум: 1GB RAM (лучше 2GB)
-- Получите: IP адрес и пароль root
+## 3.2 Подключение к серверу
-## Шаг 2: Подключение к серверу
+### Windows
-**Windows:** Скачайте [PuTTY](https://www.putty.org/) или используйте Windows Terminal
+1. Скачайте [Windows Terminal](https://apps.microsoft.com/detail/9n0dx20hk701) из Microsoft Store
+2. Или используйте PowerShell
+3. Введите:
+```bash
+ssh root@ВАШ_IP_АДРЕС
+```
-**Mac/Linux:** Откройте Terminal
+### Mac/Linux
+Откройте Terminal и введите:
```bash
ssh root@ВАШ_IP_АДРЕС
```
-Введите пароль (символы не отображаются — это нормально).
+**Первое подключение:** спросит про fingerprint — напишите `yes`.
+**Пароль:** вводите пароль из письма (символы не отображаются — это нормально).
+
+<!-- TODO: Скриншот подключения по SSH -->
-## Шаг 3: Создание пользователя
+---
+
+## 3.3 Создание пользователя
+
+Работать под root небезопасно. Создадим обычного пользователя:
```bash
-# Создаём пользователя
+# Создаём пользователя (запомните пароль!)
adduser myuser
# Даём права sudo
usermod -aG sudo myuser
-# Переключаемся
+# Переключаемся на нового пользователя
su - myuser
```
-## Шаг 4: Установка всего необходимого
+<!-- TODO: Скриншот создания пользователя -->
+
+---
+
+## 3.4 Установка необходимого ПО
-Копируйте и вставляйте эти команды по одной:
+Копируйте и вставляйте эти команды по одной. Каждый блок — отдельное действие.
+### Обновление системы
```bash
-# Обновление системы
sudo apt update && sudo apt upgrade -y
+```
-# Базовые инструменты
+### Базовые инструменты
+```bash
sudo apt install -y git curl wget build-essential
+```
-# Python 3.12
+### Python 3.12
+```bash
sudo apt install -y software-properties-common
sudo add-apt-repository -y ppa:deadsnakes/ppa
sudo apt update
sudo apt install -y python3.12 python3.12-venv python3.12-dev
+```
-# uv (менеджер пакетов Python)
+### uv (быстрый менеджер пакетов Python)
+```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
source ~/.bashrc
+```
-# Node.js 20
+### Node.js 20
+```bash
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
+```
-# Claude CLI
+### Claude CLI
+```bash
npm install -g @anthropic-ai/claude-code
+```
-# Авторизация Claude (следуйте инструкциям)
+### Авторизация в Claude
+```bash
claude auth login
```
-## Шаг 5: Клонирование ВАШЕГО репозитория
+Следуйте инструкциям: откроется ссылка → авторизуйтесь в браузере → скопируйте код → вставьте в терминал.
+
+<!-- TODO: Скриншот авторизации Claude -->
+
+---
+
+## 3.5 Клонирование ВАШЕГО репозитория
```bash
cd ~
mkdir -p projects
cd projects
-# Замените URL на ваш репозиторий!
-git clone https://github.com/YOUR_NAME/my-second-brain.git dbrain
+# Замените URL на ВАШ репозиторий!
+git clone https://github.com/ВАШ_ЛОГИН/my-second-brain.git dbrain
cd dbrain
# Установка зависимостей
uv sync
```
-## Шаг 6: Настройка .env
+---
+
+## 3.6 Создание файла .env
```bash
nano .env
```
-Вставьте (замените на ваши токены):
+Вставьте (замените на свои токены):
```bash
TELEGRAM_BOT_TOKEN=7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxx
@@ -336,25 +440,37 @@ VAULT_PATH=./vault
ALLOWED_USER_IDS=[123456789]
```
-Сохраните: `Ctrl+O`, `Enter`, `Ctrl+X`
+**Сохранение:** `Ctrl+O` → `Enter` → `Ctrl+X`
-## Шаг 7: Тестовый запуск
+<!-- TODO: Скриншот редактирования .env -->
+
+---
+
+## 3.7 Тестовый запуск
```bash
uv run python -m d_brain
```
-Откройте Telegram, найдите вашего бота, отправьте `/start`.
+Откройте Telegram, найдите своего бота, отправьте `/start`.
+
+**Если работает** — увидите приветствие и кнопки. Нажмите `Ctrl+C` для остановки.
+
+**Если не работает** — проверьте:
+- Правильный ли токен в .env?
+- Совпадает ли ваш ID в ALLOWED_USER_IDS?
+
+---
-Если работает — `Ctrl+C` для остановки.
+## 3.8 Настройка автозапуска
-## Шаг 8: Автозапуск
+Чтобы бот работал постоянно, даже после перезагрузки сервера:
```bash
sudo nano /etc/systemd/system/d-brain-bot.service
```
-Вставьте (замените `myuser`):
+Вставьте (замените `myuser` на имя вашего пользователя):
```ini
[Unit]
@@ -373,122 +489,545 @@ RestartSec=10
WantedBy=multi-user.target
```
+Сохраните и запустите:
+
```bash
sudo systemctl daemon-reload
sudo systemctl enable d-brain-bot
sudo systemctl start d-brain-bot
+```
-# Проверка
+Проверьте статус:
+```bash
sudo systemctl status d-brain-bot
```
+Должно показать `active (running)`.
+
+<!-- TODO: Скриншот статуса systemd -->
+
---
-# Часть 4: Синхронизация с Obsidian
+## 3.9 Настройка автоматической обработки
+
+Бот может обрабатывать записи автоматически каждый день в 21:00.
+
+### Создание таймера
-## На компьютере
+```bash
+sudo nano /etc/systemd/system/d-brain-process.timer
+```
-Ваш репозиторий уже клонирован (из Части 1). Откройте папку `vault` как хранилище в Obsidian.
+```ini
+[Unit]
+Description=Daily processing at 21:00
-## Автоматическая синхронизация
+[Timer]
+OnCalendar=*-*-* 21:00:00
+Persistent=true
-Создайте скрипт для синхронизации каждый час:
+[Install]
+WantedBy=timers.target
+```
-**Mac:** Создайте файл `~/sync-brain.sh`:
+### Создание сервиса обработки
```bash
-#!/bin/bash
-cd ~/Documents/my-second-brain # путь к вашему репозиторию
-git pull --rebase
-git add -A
-git commit -m "Auto-sync: $(date '+%Y-%m-%d %H:%M')" 2>/dev/null || true
-git push 2>/dev/null || true
+sudo nano /etc/systemd/system/d-brain-process.service
```
+```ini
+[Unit]
+Description=d-brain Daily Processing
+
+[Service]
+Type=oneshot
+User=myuser
+WorkingDirectory=/home/myuser/projects/dbrain
+ExecStart=/home/myuser/.local/bin/uv run python -c "
+import asyncio
+from d_brain.services.processor import ClaudeProcessor
+from d_brain.services.git import VaultGit
+from d_brain.config import Settings
+from datetime import date
+
+async def main():
+ settings = Settings()
+ processor = ClaudeProcessor(settings.vault_path)
+ git = VaultGit(settings.vault_path)
+
+ result = await processor.process_daily(date.today())
+ print(result.get('report', 'No report'))
+
+ if git.has_changes():
+ git.commit_and_push(f'chore: daily processing {date.today()}')
+
+asyncio.run(main())
+"
+```
+
+### Активация
+
```bash
-chmod +x ~/sync-brain.sh
+sudo systemctl daemon-reload
+sudo systemctl enable d-brain-process.timer
+sudo systemctl start d-brain-process.timer
+
+# Проверка
+sudo systemctl list-timers | grep d-brain
```
-Добавьте в cron:
+---
+
+## 3.10 Настройка Git push
+
+Чтобы сервер мог пушить изменения в GitHub:
+
```bash
-crontab -e
-# Добавьте строку:
-0 * * * * ~/sync-brain.sh
+cd ~/projects/dbrain
+
+# Настройка имени и email
+git config user.name "My Bot"
+git config user.email "[email protected]"
+```
+
+### Создание токена для Git
+
+1. Зайдите на GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic)
+2. Generate new token (classic)
+3. Выберите scope: `repo`
+4. Скопируйте токен
+
+### Сохранение токена
+
+```bash
+git remote set-url origin https://ТОКЕН@github.com/ВАШ_ЛОГИН/my-second-brain.git
```
-**Windows:** Используйте Task Scheduler с аналогичным bat-файлом.
+Замените:
+- `ТОКЕН` — ваш Personal Access Token
+- `ВАШ_ЛОГИН` — логин на GitHub
+
+Теперь сервер сможет пушить изменения автоматически.
---
-## Команды бота
+# Часть 4: Персонализация
+
+Самая важная часть! Бот использует ваши цели для приоритизации задач.
+
+## 4.1 Иерархия целей
+
+Система работает от большого к малому:
+
+```
+3-летнее видение (куда я иду?)
+ ↓
+Годовые цели (что достичь за год?)
+ ↓
+Месячные приоритеты (фокус этого месяца)
+ ↓
+Недельный план (ONE Big Thing)
+ ↓
+Ежедневные задачи (создаются автоматически)
+```
+
+---
-| Команда | Описание |
-|---------|----------|
-| `/start` | Начать работу |
+## 4.2 Заполнение целей с помощью AI
+
+Рекомендую заполнять цели через диалог с Claude/ChatGPT — так получается глубже.
+
+### Видение на 3 года
+
+1. Откройте `vault/goals/0-vision-3y.md` в VS Code
+2. Откройте Claude или ChatGPT
+3. Напишите:
+
+```
+Ты мой персональный коуч. Помоги заполнить 3-летнее видение жизни.
+Задавай вопросы по одному, глубоко. Области:
+- Карьера и бизнес
+- Здоровье и энергия
+- Отношения и семья
+- Личностный рост
+- Финансы
+- Радость и хобби
+
+После каждого ответа — уточняющие вопросы.
+В конце сформируй заполненный документ.
+```
+
+4. Ответьте на вопросы
+5. Скопируйте результат в файл
+
+### Годовые цели
+
+Повторите процесс для `vault/goals/1-yearly-2025.md`:
+
+```
+На основе моего 3-летнего видения помоги поставить годовые цели на 2025.
+Вот моё видение: [вставьте содержимое 0-vision-3y.md]
+
+Для каждой цели определи:
+- Чёткий измеримый результат
+- Квартальные вехи
+- Первый конкретный шаг
+```
+
+### Месячные приоритеты
+
+Для `vault/goals/2-monthly.md`:
+
+```
+Исходя из годовых целей, какие 3 приоритета на этот месяц?
+Вот мои годовые цели: [вставьте]
+```
+
+### Недельный фокус
+
+Для `vault/goals/3-weekly.md`:
+
+```
+ONE Big Thing на эту неделю — если я сделаю только это,
+неделя будет успешной. Что это?
+
+Мои месячные приоритеты: [вставьте]
+```
+
+<!-- TODO: Скриншот заполненного weekly файла -->
+
+---
+
+## 4.3 Настройка профиля
+
+Откройте `vault/.claude/skills/dbrain-processor/references/about.md` и заполните информацию о себе:
+
+```markdown
+# About User - System Profile
+
+## Core Identity
+
+**Иван Петров, 35** — Продакт-менеджер
+
+- Работаю в fintech-стартапе
+- Основные клиенты: B2B SaaS
+- 10 лет в IT
+- Строю продукты от идеи до масштабирования
+
+## Primary Operating Mode
+
+- Мыслю системами и фреймворками
+- Предпочитаю данные интуиции
+- Ценю краткость и конкретику
+- Лучше работаю утром
+
+## Strategic Focus
+
+1. Запуск нового продукта до Q2
+2. Построение пассивного дохода
+3. Баланс работа/семья
+
+## Work Domains
+
+| Domain | Examples |
+|--------|----------|
+| **Работа** | продукт, метрики, команда, клиенты |
+| **Обучение** | AI, no-code, инвестиции |
+| **Идеи** | стартапы, автоматизация, контент |
+| **Личное** | здоровье, семья, путешествия |
+```
+
+Это поможет агенту понимать контекст ваших записей.
+
+---
+
+## 4.4 Настройка классификации
+
+Если хотите изменить, как бот классифицирует записи, отредактируйте:
+
+`vault/.claude/skills/dbrain-processor/references/classification.md`
+
+Там можно добавить:
+- Ключевые слова ваших проектов
+- Имена клиентов (→ приоритет p1)
+- Домены для автоматической категоризации
+
+---
+
+# Часть 5: Использование
+
+## 5.1 Основные команды
+
+| Команда | Что делает |
+|---------|------------|
+| `/start` | Показать клавиатуру |
| `/status` | Сколько записей сегодня |
-| `/process` | Обработать записи |
+| `/process` | Обработать записи сейчас |
| `/weekly` | Недельный дайджест |
| `/do [текст]` | Произвольный запрос |
-### Примеры /do
+---
+
+## 5.2 Что можно отправлять
+
+**Голосовые** — основной способ. Говорите как думаете:
+- "Надо написать Пете по проекту"
+- "Идея: сделать лендинг с калькулятором"
+- "Сегодня понял, что важно делегировать мелочи"
+
+**Текст** — короткие заметки:
+- Ссылки
+- Цитаты
+- Быстрые мысли
+
+**Фото** — скриншоты, фото досок, документы
+
+**Пересланные сообщения** — из других чатов с контекстом
+
+---
+
+## 5.3 Команда /do
+
+Универсальный способ попросить что-то сделать:
```
/do покажи задачи на сегодня
/do перенеси просроченные на понедельник
/do что я записывал вчера?
+/do создай задачу: позвонить в банк завтра
+/do покажи прогресс по целям
```
+Можно просто написать `/do` — бот спросит, что сделать.
+
---
-## Полезные команды VPS
+## 5.4 Ежедневный цикл
+
+**Утро:**
+- Откройте Todoist — там задачи на сегодня
+
+**В течение дня:**
+- Записывайте мысли голосом
+- Пересылайте важные сообщения
+- Делайте скриншоты
+
+**Вечер (21:00 автоматически или /process):**
+- Бот обрабатывает записи
+- Создаёт задачи
+- Сохраняет мысли
+- Присылает отчёт
+
+**Воскресенье:**
+- Автоматический недельный дайджест
+- Прогресс по целям
+- Рекомендации на следующую неделю
+
+---
+
+## 5.5 Пример отчёта
+
+```html
+📊 <b>Обработано: 27 дек</b>
+
+<b>📥 Входящие</b>
+• 3 голосовых, 2 текста, 1 фото
+
+<b>✅ Создано задач: 4</b>
+• [p1] Позвонить клиенту → сегодня
+• [p2] Подготовить презентацию → пт
+• [p3] Изучить новый инструмент → сл. нед
+• [p4] Идея для блога → когда-нибудь
+
+<b>📝 Сохранено мыслей: 2</b>
+• [[ideas/лендинг-калькулятор]]
+• [[learnings/делегирование]]
+
+<b>🎯 ONE Big Thing</b>
+Запустить MVP до конца недели
+
+<b>📈 Прогресс недели: 65%</b>
+```
+
+---
+
+# Часть 6: Синхронизация с Obsidian
+
+## 6.1 Настройка на компьютере
+
+1. Откройте папку с репозиторием на компьютере
+2. Запустите Obsidian
+3. Open folder as vault → выберите папку `vault`
+
+Теперь вы видите все свои заметки в красивом интерфейсе Obsidian.
+
+<!-- TODO: Скриншот Obsidian с открытым vault -->
+
+---
+
+## 6.2 Автоматическая синхронизация
+
+Чтобы изменения с сервера автоматически появлялись на компьютере:
+
+### Mac
+
+Создайте файл `~/sync-brain.sh`:
```bash
-# Логи
-sudo journalctl -u d-brain-bot -f
+#!/bin/bash
+cd ~/Documents/my-second-brain # путь к вашему репозиторию
+git pull --rebase
+git add -A
+git commit -m "sync: $(date '+%Y-%m-%d %H:%M')" 2>/dev/null || true
+git push 2>/dev/null || true
+```
-# Перезапуск
-sudo systemctl restart d-brain-bot
+Сделайте исполняемым:
+```bash
+chmod +x ~/sync-brain.sh
+```
-# Обновление
-cd ~/projects/dbrain
-git pull
-uv sync
-sudo systemctl restart d-brain-bot
+Добавьте в cron (запуск каждый час):
+```bash
+crontab -e
+# Добавьте строку:
+0 * * * * ~/sync-brain.sh
+```
+
+### Windows
+
+1. Создайте файл `sync-brain.bat`:
+```batch
+cd C:\Users\ВАШЕ_ИМЯ\Documents\my-second-brain
+git pull --rebase
+git add -A
+git commit -m "sync: %date% %time%"
+git push
```
+2. Откройте "Планировщик заданий"
+3. Создайте задачу → Триггер: каждый час → Действие: запуск sync-brain.bat
+
+---
+
+## 6.3 Мобильный доступ (опционально)
+
+Для просмотра заметок на телефоне:
+
+1. Установите Obsidian на телефон
+2. Используйте Obsidian Sync ($8/мес) или
+3. Используйте Working Copy (iOS) / GitJournal (Android) для Git-синхронизации
+
---
-## Решение проблем
+# FAQ
-**Бот не отвечает:**
+## Общие вопросы
+
+**Можно без Todoist?**
+Да! Оставьте `TODOIST_API_KEY` пустым в .env. Бот будет сохранять мысли, но не создавать задачи.
+
+**Можно без Obsidian?**
+Да! Заметки хранятся как обычные .md файлы. Смотрите их на GitHub или в любом текстовом редакторе.
+
+**Сколько стоит в месяц?**
+- Claude: $20
+- VPS: $4-5
+- Deepgram: бесплатно ($200 хватает на год+)
+- **Итого: ~$25/мес**
+
+**Это безопасно?**
+- Все данные на вашем сервере и в вашем GitHub
+- Бот отвечает только на ваш Telegram ID
+- Токены хранятся в .env (не в коде)
+
+---
+
+## Технические вопросы
+
+**Бот не отвечает**
```bash
+# Проверьте статус
sudo systemctl status d-brain-bot
+
+# Посмотрите логи
sudo journalctl -u d-brain-bot -n 50
```
-**Не транскрибирует:**
-Проверьте DEEPGRAM_API_KEY в .env
+**Не транскрибирует голосовые**
+- Проверьте DEEPGRAM_API_KEY в .env
+- Убедитесь, что не закончились $200 кредита
-**Ошибка Claude:**
+**Claude не работает**
```bash
+# Проверьте авторизацию
claude auth status
-# Если не авторизован:
+
+# Переавторизуйтесь
claude auth login
```
+**Изменения не пушатся в GitHub**
+```bash
+cd ~/projects/dbrain
+git status
+git push # посмотрите ошибку
+```
+
+---
+
+## Обновление
+
+Когда выйдет новая версия:
+
+```bash
+cd ~/projects/dbrain
+
+# Сохраните свои изменения
+git stash
+
+# Получите обновления (замените URL на оригинальный репозиторий)
+git remote add upstream https://github.com/smixs/agent-second-brain.git
+git fetch upstream
+git merge upstream/main
+
+# Верните свои изменения
+git stash pop
+
+# Обновите зависимости
+uv sync
+
+# Перезапустите бот
+sudo systemctl restart d-brain-bot
+```
+
---
-## FAQ
+## Полезные команды VPS
+
+```bash
+# Логи в реальном времени
+sudo journalctl -u d-brain-bot -f
+
+# Перезапуск бота
+sudo systemctl restart d-brain-bot
+
+# Статус всех таймеров
+sudo systemctl list-timers
-**Можно без Todoist?** — Да, оставьте TODOIST_API_KEY пустым.
+# Ручной запуск обработки
+cd ~/projects/dbrain
+uv run python -m d_brain.services.processor
+```
+
+---
-**Можно без Obsidian?** — Да, файлы можно смотреть на GitHub или в любом редакторе.
+# Поддержка
-**Сколько стоит?**
-- Deepgram: бесплатно $200
-- Claude: ~$20/месяц при активном использовании
-- VPS: от $5/месяц
+- **Вопросы:** [@aimastersme](https://t.me/aimastersme)
+- **Баги:** [GitHub Issues](https://github.com/smixs/agent-second-brain/issues)
---
-*Made with 🧠 for people who think out loud*
+*Made with 🧠 by [@smixs](https://t.me/smixs)*