Read in:
Русский
English

Как работает trip2g

Ваше хранилище Obsidian становится сайтом в момент синхронизации. Это основа trip2g. Всё остальное — публикация в Telegram, монетизация, AI-ассистент, федерация — тот же механизм, работающий в более широком контексте.

На этой странице описан полный путь заметки: от написания в Obsidian до прочтения читателем или AI-агентом.

Общая схема

Хранилище Obsidian
    ↓ плагин синхронизации
Сервер trip2g (ваш инстанс)
    ↓ рендеринг
Сайт (HTML-страницы, sitemap, RSS)
    ↓ дополнительные каналы
Telegram-канал  ·  MCP-сервер  ·  AI-ассистент

Каждый этап независим. Можно остановиться на «сайте» и не подключать Telegram или AI. Или использовать всё сразу.

Этап 1: написание в Obsidian

Вы пишете заметки как обычно. Единственное, что добавляет trip2g, — frontmatter: YAML в начале файла.

---
title: "Моя заметка"
free: true
---

free: true делает заметку видимой всем, включая анонимных посетителей. Без этого флага видимость зависит от того, кто читает:

Frontmatter Анонимный Подписчик Администратор
free: true ✓ ✓ ✓
(нет флагов) ✗ ✓ ✓
subgraphs: tier-name ✗ только при подписке на tier-name ✓

Заметка без free: и без subgraphs: считается «общими знаниями» — скрыта от анонимных посетителей, но доступна любому аутентифицированному подписчику. Чтобы ограничить заметку конкретным уровнем подписки, используйте subgraphs:. Администратор видит всё всегда.

Рабочий процесс в Obsidian не меняется.

Вики-ссылки ([[Другая заметка]]) становятся внутренними ссылками на опубликованном сайте. trip2g резолвит их по имени файла, поэтому переорганизация папок не ломает ссылки.

Этап 2: синхронизация

Плагин trip2g для Obsidian загружает заметки из хранилища на ваш инстанс. Нажмите Sync — или настройте автоматическую синхронизацию. Плагин отправляет только изменившиеся файлы: при первой синхронизации — всё хранилище, потом — инкрементальные изменения.

Что загружается:

  • Текст заметок и frontmatter
  • Вложения (изображения, PDF, аудио)
  • Структура папок

Что остаётся локально:

  • Настройки и плагины Obsidian
  • Файлы хранилища за пределами настроенной папки синхронизации

Этап 3: рендеринг

На сервере каждая заметка проходит через конвейер рендеринга.

  1. Парсинг frontmatter — title, видимость, layout, настройки Telegram, MCP-флаги
  2. Конвертация Markdown в HTML — включая вики-ссылки, embed, callout и блоки кода
  3. Резолвинг вики-ссылок — [[Имя заметки]] превращается в кликабельную ссылку на нужную страницу
  4. Применение шаблона — хедер, сайдбар, футер и структура страницы по настройкам
  5. Обновление поискового индекса — полнотекстовый и векторный индекс для AI-ассистента

Результат — стандартная HTML-страница по стабильному URL. URL формируется из имени файла или из поля slug во frontmatter, если нужен кастомный путь.

Этап 4: сайт

Ваш сайт — полноценный веб-сайт.

  • Каждая заметка — HTML-страница по стабильному URL
  • Навигация задаётся заметками _header, _sidebar и _footer
  • Главная страница — _index.md
  • Sitemap и RSS-лента генерируются автоматически
  • Полнотекстовый поиск встроен

Читатели открывают сайт в браузере. Заметки с free: true доступны всем. Заметки без этого поля требуют входа — их видят только подписчики или вы как администратор, в зависимости от настроек доступа.

Этап 5: Telegram (опционально)

Публикацию в Telegram-канал управляют поля frontmatter каждой заметки.

---
tg_post: true
tg_date: 2025-12-01 09:00
---

trip2g конвертирует содержимое заметки в текст с Telegram-разметкой и отправляет его в ваш канал в назначенное время. Изображения, видео и аудио в заметке становятся медиавложениями в посте.

Вы пишете в Obsidian. trip2g берёт на себя конвертацию и расписание.

Подробнее о форматировании и расписании: Публикация в Telegram.

Этап 6: AI-ассистент через MCP (опционально)

Каждый инстанс trip2g предоставляет MCP-эндпоинт (Model Context Protocol) по адресу /_system/mcp. Любой MCP-совместимый AI-клиент — Claude Desktop, Cursor, Claude Code, GitHub Copilot — может к нему подключиться.

Когда читатель или агент задаёт вопрос:

  1. MCP-сервер выполняет векторный поиск по вашим заметкам
  2. Возвращает наиболее релевантные заметки с указанием раздела
  3. AI-клиент составляет ответ на основе вашего контента
  4. Источники цитируются со ссылками на ваш сайт

Поведение AI и структура базы знаний задаются через специальные заметки:

  • Заметка с mcp_method: instructions — правила поведения AI
  • Заметка с mcp_method: schema — описание структуры базы знаний

AI-ассистент отвечает только по опубликованным заметкам. Доступа к внешним источникам у него нет, если вы не настроили федерацию.

Подробнее о настройке: MCP-сервер.

Узел базы знаний

Один инстанс trip2g — это больше чем сайт. Это узел базы знаний: контент, поисковый индекс, инструкции для AI, управление доступом и машиночитаемый интерфейс — всё в одном.

Каждый узел может быть:

  • Публичным — открытым для любого читателя или агента
  • Приватным — с контролем доступа, для команды или платных подписчиков
  • Личным — ваши приватные заметки, доступные только вашему AI-агенту
  • Платным — контент с доступом через подписку Patreon или Boosty

Агенты взаимодействуют с узлом через стандартный набор MCP-методов, независимо от содержимого:

Метод Что делает
search(query) Векторный поиск по заметкам
note_html(note_id) Полная заметка или отдельный раздел
similar(note_id) Похожие заметки
instructions() Правила поведения AI, заданные автором
schema() Структура базы знаний

Федерация: объединение узлов (опционально)

Несколько инстансов trip2g можно объединить в сеть. AI-агент указывает на ваш хаб; от него он прозрачно ищет по базам-пирам — публичным справочникам, приватным корпоративным вики, внешним адаптерам для GitHub или Telegram — через один вызов federated_search.

Ваш агент
    ↓
Ваш trip2g хаб
    ↓──────────────────┐──────────────────┐
Публичная база     Приватный пир      Внешний адаптер
(без auth)         (HMAC-ключ)        (HMAC-ключ)

Каждая база-пир сохраняет свой контроль доступа. Можно дать коллеге доступ к одному подграфу ваших заметок, не открывая всё остальное.

Подробнее о настройке: MCP Federation.

Итог

Что делаете вы Что делает trip2g
Пишете заметку в Obsidian Ничего
Нажимаете Sync Загружает изменённые заметки на инстанс
Добавляете free: true Делает заметку публично доступной
Добавляете tg_post: true + дату Планирует публикацию в Telegram
Добавляете mcp_method: instructions Задаёт поведение AI-ассистента
Создаёте KB-заметку с mcp_federation_kb_url Регистрирует базу-пир для федерации

Сайт — это основа. Telegram, AI и федерация — каналы поверх тех же заметок, которые вы уже пишете.