Начните за минуту: установка и настройка

Что вы сможете сделать после изучения

• Установить плагин форматирования таблиц в OpenCode
• Автоматически выравнивать Markdown-таблицы, генерируемые ИИ
• Проверить, работает ли плагин правильно

Ваша текущая проблема

Markdown-таблицы, генерируемые ИИ, часто выглядят так:

| 名称 | 描述 | 状态 |
|--- | --- | ---|
| 功能A | 这是一个很长的描述文本 | 已完成 |
| B | 短 | 进行中 |

Ширина столбцов неровная, выглядит некрасиво. Настраивать вручную? Слишком долго.

Когда использовать этот метод

• Вы часто просите ИИ генерировать таблицы (сравнения, списки, описания конфигураций)
• Вы хотите, чтобы таблицы отображались аккуратно в OpenCode
• Вы не хотите каждый раз вручную настраивать ширину столбцов

🎒 Подготовка перед началом

Предварительные условия

• Установлен OpenCode (версия >= 1.0.137)
• Вы знаете, где находится файл конфигурации .opencode/opencode.jsonc

Делайте вместе со мной

Шаг 1: откройте файл конфигурации

Почему: плагины объявляются через файл конфигурации, OpenCode автоматически загружает их при запуске.

Найдите ваш файл конфигурации OpenCode:

macOS/Linux

# Файл конфигурации обычно находится в корне проекта
ls -la .opencode/opencode.jsonc

# Или в пользовательском каталоге
ls -la ~/.config/opencode/opencode.jsonc

Windows

# Файл конфигурации обычно находится в корне проекта
Get-ChildItem .opencode\opencode.jsonc

# Или в пользовательском каталоге
Get-ChildItem "$env:APPDATA\opencode\opencode.jsonc"

Откройте этот файл в любом редакторе по вашему выбору.

Шаг 2: добавьте конфигурацию плагина

Почему: сообщить OpenCode о необходимости загрузить плагин форматирования таблиц.

Добавьте поле plugin в файл конфигурации:

{
  // ... другие настройки ...
  "plugin": ["@franlol/[email protected]"]
}

Уже есть другие плагины?

Если у вас уже есть массив plugin, добавьте новый плагин в массив:

{
  "plugin": [
    "existing-plugin",
    "@franlol/[email protected]"  // добавьте сюда
  ]
}

Что вы должны увидеть: файл конфигурации успешно сохранён, без ошибок синтаксиса.

Шаг 3: перезапустите OpenCode

Почему: плагины загружаются при запуске OpenCode, после изменения конфигурации требуется перезапуск.

Закройте текущий сеанс OpenCode и запустите его снова.

Что вы должны увидеть: OpenCode запускается нормально, без ошибок.

Шаг 4: проверьте работу плагина

Почему: убедиться, что плагин загружен и работает правильно.

Попросите ИИ сгенерировать таблицу, например, введите:

Помоги мне создать таблицу, сравнивающую особенности трёх фреймворков: React, Vue и Angular

Что вы должны увидеть: ширина столбцов таблицы, сгенерированной ИИ, выровнена, как здесь:

| 框架    | 特点                     | 学习曲线 |
|--- | --- | ---|
| React   | 组件化、虚拟 DOM         | 中等     |
| Vue     | 渐进式、双向绑定         | 较低     |
| Angular | 全功能框架、TypeScript   | 较高     |

Контрольные точки ✅

После выполнения вышеуказанных шагов проверьте следующее:

Пункт проверки	Ожидаемый результат
Синтаксис файла конфигурации	Без ошибок
Запуск OpenCode	Нормальный запуск, без ошибок загрузки плагина
Генерация таблиц ИИ	Ширина столбцов автоматически выровнена, формат разделительной строки единообразен

Предупреждения о подводных камнях

Таблица не форматируется?

1. Проверьте путь к файлу конфигурации: убедитесь, что вы изменили файл конфигурации, который фактически читает OpenCode
2. Проверьте имя плагина: должно быть @franlol/[email protected], обратите внимание на символ @
3. Перезапустите OpenCode: после изменения конфигурации необходимо перезапустить

Видите комментарий "invalid structure"?

Это означает, что структура таблицы не соответствует спецификации Markdown. Частые причины:

• Отсутствует разделительная строка (|---|---|)
• Количество столбцов в строках не совпадает

Подробнее см. в разделе Часто задаваемые вопросы.

Итог урока

• Плагин настраивается через поле plugin в .opencode/opencode.jsonc
• Номер версии @0.0.3 гарантирует использование стабильной версии
• После изменения конфигурации необходимо перезапустить OpenCode
• Плагин автоматически форматирует все Markdown-таблицы, генерируемые ИИ

Предварительный обзор следующего урока

На следующем уроке мы изучим Обзор функций.

Вы узнаете:

• 8 основных функций плагина
• Принцип расчёта ширины в скрытом режиме
• Какие таблицы можно форматировать, а какие нет

---

Приложение: справочник по исходному коду

Нажмите, чтобы раскрыть расположение исходного кода

Время обновления: 2026-01-26

Функция	Путь к файлу	Строки
Точка входа плагина	index.ts	9-23
Регистрация хука	index.ts	11-13
Конфигурация пакета	package.json	1-41

Ключевые константы:

• @franlol/[email protected]: имя npm-пакета и версия
• experimental.text.complete: имя хука, который слушает плагин

Требования к зависимостям:

• OpenCode >= 1.0.137
• @opencode-ai/plugin >= 0.13.7