> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Obsidian Copilot

> Подключите плагин Copilot в Obsidian к APIYI и общайтесь с вашей личной базой знаний

Obsidian Copilot — это open-source плагин-ассистент ИИ для Obsidian с лаконичным дизайном, ориентированным на конфиденциальность. Он позволяет подключить любой сервис моделей, совместимый с OpenAI, используя собственный ключ API, создавать пользовательские промпты и общаться со всем вашим vault, чтобы получать ответы и инсайты из вашей личной базы знаний.

Через APIYI вы можете получить доступ к более чем 400 популярным моделям — GPT, Claude, Gemini, DeepSeek и другим — прямо в Obsidian с одной учётной записью, без необходимости регистрироваться на нескольких платформах.

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

<CardGroup cols={2}>
  <Card title="Общайтесь со своим Vault" icon="messages-square">
    Режим Vault QA выполняет поиск по всему вашему Vault с помощью векторного индексирования и отвечает на вопросы на основе вашей личной базы знаний
  </Card>

  <Card title="Пользовательские prompt" icon="wand-sparkles">
    Встроенные команды для суммаризации, перевода и переписывания, а также пользовательские prompt для обработки выделенного текста в один клик
  </Card>

  <Card title="Конфиденциальность прежде всего" icon="shield-check">
    Плагин с открытым исходным кодом, локальное хранение данных и API-ключи, которые хранятся только в вашей локальной конфигурации
  </Card>

  <Card title="Гибкий доступ к моделям" icon="plug">
    Работает с любым совместимым с OpenAI endpoint — свободно переключайтесь между более чем 400 моделями через APIYI
  </Card>
</CardGroup>

## Быстрый старт

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

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

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

<Steps>
  <Step title="Установите Obsidian">
    Скачайте и установите Obsidian с официального сайта: `obsidian.md`
  </Step>

  <Step title="Откройте магазин плагинов сообщества">
    Перейдите в Obsidian **Настройки → Плагины сообщества**, отключите «Ограниченный режим» и нажмите «Обзор»
  </Step>

  <Step title="Установите и включите Copilot">
    Найдите **Copilot** (от Logan Yang), затем установите и включите его
  </Step>
</Steps>

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

<Steps>
  <Step title="Откройте настройки Copilot">
    Перейдите в **Настройки → Copilot** и откройте вкладку **Модель**
  </Step>

  <Step title="Добавьте пользовательскую модель">
    В разделе Chat Models нажмите **Добавить пользовательскую модель** и заполните:

    | Поле            | Значение                                             |
    | --------------- | ---------------------------------------------------- |
    | **Имя модели**  | Имя модели, например `gpt-5.2` или `claude-sonnet-5` |
    | **Поставщик**   | Выберите **сторонний (openai-format)**               |
    | **Базовый URL** | `https://api.apiyi.com/v1`                           |
    | **API-ключ**    | Ваш ключ APIYI (`sk-...`)                            |
  </Step>

  <Step title="Проверьте и добавьте">
    Нажмите **Проверить**, чтобы протестировать подключение, затем нажмите **Добавить модель**, чтобы завершить настройку
  </Step>
</Steps>

<Info>
  **Примечания к настройке**

  * Базовый URL должен включать суффикс `/v1`: `https://api.apiyi.com/v1`
  * Имя модели должно точно совпадать с моделью, поддерживаемой APIYI — проверьте [список моделей](https://api.apiyi.com/account/models)
  * Вы можете добавить несколько моделей и переключаться между ними в любое время на панели чата
</Info>

### Шаг 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 и китайские модели.

<Card title="View Latest Model Recommendations" icon="star" href="/ru/api-capabilities/model-info">
  Ознакомьтесь с последними рекомендациями по моделям, сравнениями производительности и советами по использованию. Список моделей постоянно обновляется, чтобы вы всегда использовали самые новые и сильные AI-модели.
</Card>

<Info>
  **Почему мы не перечисляем здесь конкретные модели?**

  AI-модели очень быстро развиваются. Чтобы вы получали самые точные рекомендации, мы поддерживаем актуальный список моделей, данные о производительности и советы по использованию на [странице рекомендаций по моделям](/ru/api-capabilities/model-info).
</Info>

<Tip>
  **Рекомендации по сценариям**

  * **Ежедневные вопросы и ответы по заметкам**: выберите быструю, недорогую lightweight-модель
  * **Длинные сводки / глубокое письмо**: выберите флагманскую модель с большим контекстным окном
  * **Vault QA embedding**: `text-embedding-3-small` охватывает подавляющее большинство сценариев базы знаний
</Tip>

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

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

Copilot позволяет сохранять часто используемые операции как пользовательские команды:

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

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

Выделите любой фрагмент в заметке и напрямую вызовите встроенные команды:

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

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

Если chat-запросы не проходят после настройки, включите опцию **CORS** при добавлении модели.

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

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

<AccordionGroup>
  <Accordion title="Проверка не проходит или чат не отвечает">
    * Проверьте, что Base URL — `https://api.apiyi.com/v1` (включая `/v1`)
    * Убедитесь, что API-ключ скопирован правильно и без лишних пробелов
    * Подтвердите, что на вашем аккаунте достаточно баланса
    * Если по-прежнему не работает, попробуйте включить опцию CORS в настройках модели
  </Accordion>

  <Accordion title="Ошибка: модель не найдена">
    * Имя модели должно точно совпадать с именем, поддерживаемым APIYI (с учетом регистра)
    * Проверьте точное имя модели в [списке моделей](https://api.apiyi.com/account/models)
  </Accordion>

  <Accordion title="Vault QA не работает или индексирование завершается сбоем">
    * Убедитесь, что настроена отдельная embedding-модель (LLM-модель не может одновременно использоваться как embedding-модель)
    * Первичное индексирование большого Vault занимает некоторое время — пожалуйста, наберитесь терпения
    * После смены embedding-модели перестройте индекс (Force Re-index)
  </Accordion>

  <Accordion title="Медленные ответы">
    * Перейдите на более быструю облегченную модель
    * Уменьшите длину контекста разговора
    * В режиме Vault QA уменьшите число извлекаемых фрагментов
  </Accordion>
</AccordionGroup>

## Советы

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

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

<CardGroup cols={2}>
  <Card title="Рекомендации по моделям" icon="star" href="/ru/api-capabilities/model-info">
    См. актуальный список моделей и рекомендации по сценариям использования
  </Card>

  <Card title="Начало работы" icon="rocket" href="/ru/getting-started">
    Зарегистрируйте аккаунт APIYI и создайте ключ за 3 минуты
  </Card>

  <Card title="Настройка базового URL" icon="circle-help" href="/ru/faq/base-url-config">
    Узнайте, как правильно указать API endpoint в разных инструментах
  </Card>

  <Card title="Cherry Studio" icon="cherry" href="/ru/scenarios/chat/cherry-studio">
    Еще один мощный настольный AI-chat-клиент
  </Card>
</CardGroup>

<Info>
  Репозиторий с открытым исходным кодом Obsidian Copilot: `github.com/logancyang/obsidian-copilot`
</Info>