---

type: idea
status: planned
project: telegram-obsidian-bot
created: 2026-01-31
-------------------

# Telegram-бот как посредник между мной и нейронкой (Obsidian-интеграция)

## Краткая суть идеи

Сделать Telegram-бота, который выступает **умным посредником** между мной и нейронкой:

* я отправляю голосовые или текстовые заметки;
* бот + ИИ **понимают смысл**, кратко резюмируют;
* бот **спрашивает меня**, что с этой заметкой делать;
* после подтверждения или правок бот **корректно раскладывает всё в Obsidian**.

Цель — убрать ручную сортировку, снизить когнитивную нагрузку и превратить Obsidian в управляемую систему, а не свалку входящих.

---

## Базовый пользовательский сценарий

1. Я отправляю боту голосовое сообщение.
2. Бот:
   * делает транскрипцию;
   * сохраняет сырую заметку во `📥 Входящие`.
3. Нейронка анализирует текст и возвращает:

   * краткое резюме;
   * предполагаемый тип заметки (идея / задача / баг / покупка и т.д.);
   * список возможных действий.
4. Бот присылает мне сообщение:

   * как он понял заметку;
   * inline-клавиатуру с вариантами, что с ней сделать.

---

## Динамические inline-клавиатуры

* Кнопки **не заготовленные**, а генерируются на лету под конкретную заметку.
* Возможные действия:

  * «Сделать чек-лист»
  * «Добавить в идеи»
  * «В задачи»
  * «В баг-репорты»
  * «Просто сохранить во входящие»
  * «Удалить / отменить»
* Количество и формулировки кнопок зависят от контекста заметки.

---

## Подтверждение и корректировка

После того как бот предложил варианты:

* я могу нажать кнопку **«ОК / применить»**;
* могу нажать **«Исправить»**;
* могу **ответить голосом на сообщение бота** и надиктовать инструкции.

Пример голосовой правки:

> «Размести пункты 1–3 в баг-репорты, пункт 4 — в идеи, сделай чек-лист»

Бот:

* понимает, что это инструкция к предыдущей заметке;
* повторно прогоняет её через ИИ;
* корректно распределяет данные в Obsidian.

---

## Работа с состояниями (FSM)

Каждая заметка имеет жизненный цикл:

1. NEW — получено сообщение
2. TRANSCRIBED — есть текст
3. PROPOSED — ИИ предложил варианты
4. WAITING_CONFIRMATION — ждёт кнопки или голосовой правки
5. APPLIED — разложено в Obsidian
6. CANCELLED — отменено

Это нужно для предсказуемости и отладки.

---

## Принцип безопасности и контроля

* Нейронка **не пишет файлы напрямую**.
* ИИ возвращает **структурные команды** (типа JSON):

  * создать чек-лист
  * переместить заметку
  * добавить теги
  * разделить на несколько заметок
* Бот:

  * валидирует команды;
  * проверяет разрешённые папки и типы;
  * только потом пишет в Obsidian.

---

## Структура Obsidian Vault

* Всегда есть сырая заметка в `📥 Входящие`.
* Обработанная версия кладётся в нужную категорию:

  * `💡 Идеи и мысли`
  * `✅ Задачи и планы`
  * `🐞 Баг-репорты`
  * `🛒 Покупки` и т.д.
* Между ними связь через frontmatter:

  * `source`
  * `processed`

Это позволяет вернуться к исходнику, если ИИ ошибся.

---

## Логи и прозрачность

Обязательно вести:
### 1. Журнал действий бота (audit log)

* дата и время;
* id заметки;
* что сделано;
* куда записано;
* инициатор (авто / кнопка / голосовая правка).
### 2. Дневной отчёт

Отдельная заметка в Obsidian:

* сколько заметок обработано;
* по каким категориям;
* какие случаи были спорные (низкая уверенность);
* ссылки на сырые и итоговые заметки.
---
## Минимальный MVP (чтобы не откладывать)

1. Голос → транскрипция.
2. ИИ возвращает резюме + 3 варианта действий.
3. Inline-клавиатура:

   * «Во входящие»
   * «Сделать чек-лист»
   * «В идеи»
4. Кнопка «Применить как есть».

Даже в таком виде бот уже работает как **умный секретарь**, а не просто приёмник заметок.

---
## Главная ценность идеи

* меньше ручной сортировки;
* меньше мусора в Obsidian;
* решения принимаются в моменте, голосом или кнопкой;
* всегда остаётся контроль и история действий;
* система масштабируется без переписывания логики.

Эта заметка — якорь идеи. Реализацию можно делать по частям, не теряя общий замысел.