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

smixs08ee8001e200
diff --git a/README.md b/README.md
index bc9bc65..5795b9d 100644
--- a/README.md
+++ b/README.md
@@ -12,6 +12,37 @@
---
+## 📑 Оглавление
+
+- [Зачем это нужно](#зачем-это-нужно)
+- [Как это работает](#как-это-работает)
+- [Словарь терминов](#-словарь-терминов)
+- [Что понадобится](#что-понадобится)
+- **Часть 1: Подготовка на компьютере** ⏱ 30-50 мин
+ - [1.1 Установите Git и VS Code](#11-установите-git-и-vs-code)
+ - [1.2 Создайте аккаунт на GitHub](#12-создайте-аккаунт-на-github)
+ - [1.3 Сделайте Fork проекта](#13-сделайте-fork-проекта)
+ - [1.4 Клонируйте Fork на компьютер](#14-клонируйте-fork-на-компьютер)
+ - [1.5 Заполните ваши цели](#15-заполните-ваши-цели)
+ - [1.6 Настройте профиль](#16-настройте-профиль)
+ - [1.7 Настройте систему под себя](#17-настройте-систему-под-себя-важно)
+ - [1.8 Сохраните изменения в GitHub](#18-сохраните-изменения-в-github)
+- **Часть 2: Получите токены** ⏱ 15 мин
+ - [2.1 Telegram Bot Token](#21-telegram-bot-token)
+ - [2.2 Ваш Telegram ID](#22-ваш-telegram-id)
+ - [2.3 Deepgram API Key](#23-deepgram-api-key)
+ - [2.4 Todoist API Token](#24-todoist-api-token)
+- **Часть 3: Настройка VPS** ⏱ 40-70 мин
+ - [3.1 Купите VPS и подключитесь](#31-купите-vps-и-подключитесь)
+ - [3.2 Создайте пользователя](#32-создайте-пользователя)
+ - [3.3 Установите всё необходимое](#33-установите-всё-необходимое)
+ - [🚀 Перейти к запуску](#-всё-стоп-дальше-claude-code-сделает-сам)
+- [Часть 4: Использование](#часть-4-использование)
+- [Часть 5: Синхронизация](#часть-5-синхронизация)
+- [FAQ](#faq)
+
+---
+
## Зачем это нужно
Это GTD-система (Getting Things Done) на стероидах. Один раз настроите - и у вас всегда под рукой понимание, что происходит в жизни.
@@ -94,6 +125,23 @@
---
+## 📖 Словарь терминов
+
+Если какие-то слова незнакомы — вот короткий словарь:
+
+| Термин | Что это значит |
+|--------|----------------|
+| **VPS** | Удалённый мини-компьютер в интернете. Как ваш ПК, но работает 24/7 и находится в дата-центре |
+| **SSH** | Способ подключиться к VPS через терминал. Как удалённый рабочий стол, но текстом |
+| **Token** | Пароль для сервиса. Длинная строка букв и цифр, которую нельзя никому показывать |
+| **Repo** | Репозиторий — папка проекта на GitHub. Там хранятся все файлы и история изменений |
+| **.env** | Файл с секретами и настройками. Лежит только на сервере, никуда не публикуется |
+| **systemd** | Автозапуск на сервере. Следит чтобы бот работал, перезапускает если упал |
+| **Fork** | Ваша личная копия проекта. Можете менять как хотите, оригинал не затронете |
+| **Clone** | Скачать проект на компьютер. После этого можете открыть его в VS Code |
+
+---
+
## Что понадобится
| Компонент | Зачем | Стоимость |
@@ -115,7 +163,7 @@
---
-# Часть 1: Подготовка на компьютере
+# Часть 1: Подготовка на компьютере ⏱ 30-50 мин
### 1.1 Установите Git и VS Code
@@ -384,7 +432,19 @@ vault → .claude → skills → dbrain-processor → references → about.md
---
-## Часть 2: Получите токены
+### ✅ Контрольная точка: Часть 1 завершена
+
+| Что проверить | Ожидаемый результат | Если не работает |
+|---------------|---------------------|------------------|
+| У тебя есть свой репозиторий | Открой `github.com/ТВОЙ_ЛОГИН/agent-second-brain` — видишь свои файлы | Вернись к шагу 1.3 и сделай Fork |
+| Репозиторий приватный (опционально) | В настройках репо стоит Private | Settings → Change visibility → Private |
+| На компе открывается папка проекта | В VS Code слева видно папки `vault`, `src` и файлы | Вернись к шагу 1.4 и клонируй заново |
+| Цели заполнены | Открой `vault/goals/` — там твои цели, не шаблон | Вернись к шагу 1.5 |
+| Изменения в GitHub | На github.com видны твои коммиты | Вернись к шагу 1.8, нажми Sync Changes |
+
+---
+
+## Часть 2: Получите токены ⏱ 15 мин
Соберите все ключи заранее. Сохраните в надёжное место.
@@ -436,18 +496,20 @@ vault → .claude → skills → dbrain-processor → references → about.md
---
-### 2.5 Чек-лист
+### ✅ Контрольная точка: Часть 2 завершена
-Перед следующим шагом убедитесь, что у вас есть:
+| Что проверить | Ожидаемый результат | Если не работает |
+|---------------|---------------------|------------------|
+| Telegram Bot Token | Строка вида `7123456789:AAH...` | Напиши `/newbot` в @BotFather |
+| Telegram ID | Число вида `123456789` | Напиши что угодно в @userinfobot |
+| Deepgram API Key | Длинная строка букв и цифр | Зайди на console.deepgram.com → API Keys |
+| Todoist API Token | Строка из 40 символов | Todoist → Settings → Integrations → Developer |
-- [ ] Telegram Bot Token
-- [ ] Ваш Telegram ID
-- [ ] Deepgram API Key
-- [ ] Todoist API Token
+> 💾 **Сохрани все токены** в надёжное место (заметки, менеджер паролей). Они понадобятся на VPS.
---
-## Часть 3: Настройка VPS
+## Часть 3: Настройка VPS ⏱ 40-70 мин
### 3.1 Купите VPS и подключитесь
@@ -534,66 +596,79 @@ claude auth login
---
-# 🎉 ВСЁ! ДАЛЬШЕ РУКАМИ НИЧЕГО ДЕЛАТЬ НЕ НУЖНО!
+### ✅ Контрольная точка: Часть 3.3 завершена
-> ✅ **Поздравляем!** Вы установили Claude Code и авторизовались.
->
-> **Теперь Claude Code сам настроит всё остальное.**
->
-> Вам не нужно читать и выполнять инструкции ниже — это техническая документация для Claude Code. Он сам её прочитает и всё сделает.
+| Что проверить | Ожидаемый результат | Если не работает |
+|---------------|---------------------|------------------|
+| Подключение к VPS | `ssh user@IP` работает без ошибок | Проверь IP и пароль из письма хостера |
+| Claude установлен | Команда `claude --version` показывает версию | Повтори `npm install -g @anthropic-ai/claude-code` |
+| Claude авторизован | `claude auth status` показывает `Logged in` | Выполни `claude auth login` заново |
-## Что делать дальше
+---
-### Шаг 1: Перейдите в папку проекта
+<h1 align="center">🛑 ВСЁ! СТОП!</h1>
+
+<p align="center">
+<strong>Вы установили Claude Code и авторизовались.</strong><br>
+Дальше читать инструкцию не нужно — Claude Code сам всё настроит.
+</p>
+
+<p align="center">
+<a href="#-первый-запуск-бота">
+<img src="https://img.shields.io/badge/🚀_ПЕРЕЙТИ_К_ЗАПУСКУ-blue?style=for-the-badge&logoColor=white" alt="Перейти к запуску"/>
+</a>
+</p>
+
+---
+
+## 🚀 Первый запуск бота
+
+Это простой сценарий из 4 действий. Каждый шаг — одна команда.
+
+### Действие 1: Скачайте проект
```bash
-cd ~/projects
-git clone https://github.com/ВАШ_ЛОГИН/agent-second-brain.git
-cd agent-second-brain
+cd ~ && mkdir -p projects && cd projects && git clone https://github.com/ВАШ_ЛОГИН/agent-second-brain.git && cd agent-second-brain
```
> ⚠️ **Замените `ВАШ_ЛОГИН`** на ваш логин GitHub!
-### Шаг 2: Запустите Claude Code
+### Действие 2: Запустите Claude Code
```bash
claude
```
-### Шаг 3: Отправьте ему этот промпт
-
-Скопируйте и вставьте:
+### Действие 3: Скопируйте и вставьте этот промпт
```
Помоги мне настроить этот проект на VPS.
-
-Инструкция здесь: https://github.com/smixs/agent-second-brain
-
-Я уже:
-✅ Установил Claude Code
-✅ Авторизовался
-✅ Клонировал репозиторий
-✅ Настроил цели и about.md на своём компьютере
-
-Теперь мне нужно:
-- Настроить .env файл (попроси у меня токены)
-- Запустить бота
-- Настроить автозапуск
-
-Веди меня пошагово, спрашивай что нужно.
+Я уже установил Claude Code и авторизовался.
+Мне нужно: настроить .env, запустить бота, настроить автозапуск.
+Веди пошагово, спрашивай токены когда нужно.
```
-### Шаг 4: Следуйте инструкциям Claude
+### Действие 4: Отвечайте на вопросы Claude
-Claude Code:
-- Прочитает README и поймёт что делать
+Claude Code сам:
- Попросит у вас токены (Telegram, Deepgram, Todoist)
- Создаст .env файл
- Запустит бота
- Настроит автозапуск
- Проверит что всё работает
-**Вы просто отвечаете на его вопросы и даёте токены когда попросит.**
+---
+
+### ✅ Контрольная точка: Бот работает
+
+| Что проверить | Ожидаемый результат | Если не работает |
+|---------------|---------------------|------------------|
+| Бот отвечает на /start | В Telegram видны кнопки меню | Проверь TELEGRAM_BOT_TOKEN в .env |
+| Голосовые транскрибируются | Бот отвечает текстом на голосовое | Проверь DEEPGRAM_API_KEY в .env |
+| Автозапуск настроен | `sudo systemctl status d-brain-bot` → `active (running)` | Claude поможет настроить systemd |
+| Бот работает после перезагрузки | Перезагрузи VPS, бот снова отвечает | `sudo systemctl enable d-brain-bot` |
+
+**Готово!** Переходите к [Часть 5: Синхронизация](#часть-5-синхронизация).
---