Skip to main content
Obsidian Copilot — это open-source плагин-ассистент ИИ для Obsidian с лаконичным дизайном, ориентированным на конфиденциальность. Он позволяет подключить любой сервис моделей, совместимый с OpenAI, используя собственный ключ API, создавать пользовательские промпты и общаться со всем вашим vault, чтобы получать ответы и инсайты из вашей личной базы знаний. Через APIYI вы можете получить доступ к более чем 400 популярным моделям — GPT, Claude, Gemini, DeepSeek и другим — прямо в Obsidian с одной учётной записью, без необходимости регистрироваться на нескольких платформах.

​
Ключевые возможности

Общайтесь со своим Vault

Режим Vault QA выполняет поиск по всему вашему Vault с помощью векторного индексирования и отвечает на вопросы на основе вашей личной базы знаний

Пользовательские prompt

Встроенные команды для суммаризации, перевода и переписывания, а также пользовательские prompt для обработки выделенного текста в один клик

Конфиденциальность прежде всего

Плагин с открытым исходным кодом, локальное хранение данных и API-ключи, которые хранятся только в вашей локальной конфигурации

Гибкий доступ к моделям

Работает с любым совместимым с OpenAI endpoint — свободно переключайтесь между более чем 400 моделями через APIYI

​
Быстрый старт

​
Шаг 1: Получите свой ключ APIYI

  1. Откройте сайт APIYI и зарегистрируйтесь (или войдите, если у вас уже есть учетная запись)
  2. Перейдите на страницу «Токены» в консоли и создайте новый API-ключ
  3. Скопируйте ключ (он начинается с sk-...) для дальнейшего использования

​
Шаг 2: Установите плагин Obsidian Copilot

1

Установите Obsidian

Скачайте и установите Obsidian с официального сайта: obsidian.md
2

Откройте магазин плагинов сообщества

Перейдите в Obsidian Настройки → Плагины сообщества, отключите «Ограниченный режим» и нажмите «Обзор»
3

Установите и включите Copilot

Найдите Copilot (от Logan Yang), затем установите и включите его

​
Шаг 3: Настройте LLM-модель APIYI

1

Откройте настройки Copilot

Перейдите в Настройки → Copilot и откройте вкладку Модель
2

Добавьте пользовательскую модель

В разделе Chat Models нажмите Добавить пользовательскую модель и заполните:
3

Проверьте и добавьте

Нажмите Проверить, чтобы протестировать подключение, затем нажмите Добавить модель, чтобы завершить настройку
Примечания к настройке
  • Базовый URL должен включать суффикс /v1: https://api.apiyi.com/v1
  • Имя модели должно точно совпадать с моделью, поддерживаемой APIYI — проверьте список моделей
  • Вы можете добавить несколько моделей и переключаться между ними в любое время на панели чата

​
Шаг 4: Настройте embedding-модель (требуется для Vault QA)

Чтобы использовать режим Vault QA (вопросы и ответы по базе знаний), вам также нужна embedding-модель:
  1. В разделе Модели эмбеддингов в настройках Copilot нажмите Добавить пользовательскую модель
  2. Введите имя embedding-модели: рекомендуется text-embedding-3-small (экономичный) или text-embedding-3-large (с более высокой точностью)
  3. Выберите сторонний (openai-format) в качестве поставщика
  4. Укажите Base URL https://api.apiyi.com/v1 и введите свой ключ APIYI
  5. Нажмите Добавить модель, чтобы завершить настройку

​
Шаг 5: Сохраните и начните использовать

Выберите только что добавленную модель по умолчанию, затем нажмите Сохранить и перезагрузить. Теперь вы можете:
  • Нажать значок Copilot на левой боковой панели, чтобы открыть панель чата
  • Общаться с моделью напрямую в режиме Chat
  • Задавать вопросы по всему вашему хранилищу в режиме Vault QA (при первом использовании потребуется дождаться построения индекса)

​
Поддерживаемые модели

Obsidian Copilot поддерживает более 400 популярных AI-моделей через APIYI, включая OpenAI, Claude, Gemini, DeepSeek и китайские модели.

View Latest Model Recommendations

Ознакомьтесь с последними рекомендациями по моделям, сравнениями производительности и советами по использованию. Список моделей постоянно обновляется, чтобы вы всегда использовали самые новые и сильные AI-модели.
Почему мы не перечисляем здесь конкретные модели?AI-модели очень быстро развиваются. Чтобы вы получали самые точные рекомендации, мы поддерживаем актуальный список моделей, данные о производительности и советы по использованию на странице рекомендаций по моделям.
Рекомендации по сценариям
  • Ежедневные вопросы и ответы по заметкам: выберите быструю, недорогую lightweight-модель
  • Длинные сводки / глубокое письмо: выберите флагманскую модель с большим контекстным окном
  • Vault QA embedding: text-embedding-3-small охватывает подавляющее большинство сценариев базы знаний

​
Расширенные возможности

​
Пользовательские команды и prompt

Copilot позволяет сохранять часто используемые операции как пользовательские команды:
  1. Откройте раздел Команды в настройках Copilot
  2. Создайте пользовательский prompt, например «Перепишите выделение как еженедельный отчет»
  3. Выделите текст в редакторе и вызовите его через палитру команд (Ctrl/Cmd + P)

​
Работа с выделенным текстом

Выделите любой фрагмент в заметке и напрямую вызовите встроенные команды:
  • Суммировать: сведите выделение в один клик
  • Перевести: переведите на указанный язык
  • Упростить / Исправить грамматику: упростите формулировки или исправьте грамматику
  • Создать оглавление: создайте TOC

​
Режим совместимости CORS

Если chat-запросы не проходят после настройки, включите опцию CORS при добавлении модели.
При включенном режиме CORS Obsidian не поддерживает вывод в режиме streaming — ответ появляется целиком после завершения генерации. Стандартному эндпоинту APIYI обычно не требуется эта опция; попробуйте ее только если запросы не проходят.

​
Устранение неполадок

  • Проверьте, что Base URL — https://api.apiyi.com/v1 (включая /v1)
  • Убедитесь, что API-ключ скопирован правильно и без лишних пробелов
  • Подтвердите, что на вашем аккаунте достаточно баланса
  • Если по-прежнему не работает, попробуйте включить опцию CORS в настройках модели
  • Имя модели должно точно совпадать с именем, поддерживаемым APIYI (с учетом регистра)
  • Проверьте точное имя модели в списке моделей
  • Убедитесь, что настроена отдельная embedding-модель (LLM-модель не может одновременно использоваться как embedding-модель)
  • Первичное индексирование большого Vault занимает некоторое время — пожалуйста, наберитесь терпения
  • После смены embedding-модели перестройте индекс (Force Re-index)
  • Перейдите на более быструю облегченную модель
  • Уменьшите длину контекста разговора
  • В режиме Vault QA уменьшите число извлекаемых фрагментов

​
Советы

  1. Разделяйте работу между моделями: добавьте несколько моделей — используйте легковесную модель для повседневных вопросов и переключайтесь на флагманскую модель для глубокого написания, чтобы снизить затраты
  2. Ограничьте индекс: исключите вложения и папки шаблонов в настройках Copilot, чтобы снизить стоимость встраиваний и улучшить качество поиска
  3. Используйте пользовательские промпты: превратите часто выполняемые операции (например, «организовать заметки совещания») в команды — настройте один раз и используйте без ограничений
  4. Регулярно перестраивайте индекс: запускайте Force Re-index после крупных изменений в vault, чтобы сохранить точность поиска Vault QA

​
Связанные ресурсы

Рекомендации по моделям

См. актуальный список моделей и рекомендации по сценариям использования

Начало работы

Зарегистрируйте аккаунт APIYI и создайте ключ за 3 минуты

Настройка базового URL

Узнайте, как правильно указать API endpoint в разных инструментах

Cherry Studio

Еще один мощный настольный AI-chat-клиент
Репозиторий с открытым исходным кодом Obsidian Copilot: github.com/logancyang/obsidian-copilot