Расширение Visual Studio Code (Beta)

Наше расширение для VS Code может использовать ИИ для более точного распознавания (OCR) математических уравнений с учетом контекста для пользователей, пишущих на LaTeX в VS Code. Это руководство по использованию; разработчикам просьба посетить наш репозиторий.

ПРЕДУПРЕЖДЕНИЕ: РАСШИРЕНИЕ НАХОДИТСЯ В СТАДИИ АКТИВНОЙ РАЗРАБОТКИ И НЕ ПРЕДОСТАВЛЯЕТ НИКАКИХ ГАРАНТИЙ. ИСПОЛЬЗУЙТЕ НА СВОЙ СТРАХ И РИСК. СМ. ЛИЦЕНЗИЮ. В настоящее время для использования этого расширения у вас должна быть рабочая конфигурация API от стороннего поставщика.

Функции

Расширение WriteTex для VSCode обеспечивает более точные результаты OCR, передавая модели ИИ контекст текущего документа. Пользователь может просто писать на своем iPad/планшете, и результаты будут вставлены в позицию курсора в VSCode. Контекст строится на основе строк в определенном радиусе от курсора.

Установка

ПРЕДУПРЕЖДЕНИЕ: УСТАНАВЛИВАЙТЕ РАСШИРЕНИЕ ТОЛЬКО В ТОМ СЛУЧАЕ, ЕСЛИ ВАШЕ УСТРОЙСТВО НАХОДИТСЯ ЗА БРАНДМАУЭРОМ. ВКЛЮЧАЙТЕ РАСШИРЕНИЕ ТОЛЬКО В ДОВЕРЕННОЙ СЕТИ. НЕ УСТАНАВЛИВАЙТЕ НА СЕРВЕР.

• Для пользователей Microsoft Visual Studio Code: Найдите «WriteTex» на странице расширений или установите из VS Code Marketplace.
• Для форков VSCode (Cursor, Trae, Antigravity, Kiro, Qoder, Void, VSCodium, Windsurf, Codex и т. д.): Попробуйте найти «WriteTex» на странице расширений вашего форка. Если оно не найдено, скачайте наш файл .vsix со страницы релизов и установите его вручную через расширения -> 3 точки в правом верхнем углу -> Установить из VSIX.

Вам не нужно устанавливать настольную версию WriteTex для использования расширения VSCode. Требуется только мобильное приложение на вашем iPad/планшете.

Настройка параметров

После установки наша иконка появится на боковой панели. Нажмите на нее, чтобы настроить параметры.

Конфигурация AI API

Эта часть аналогична настройке на других платформах. Простой пример показан ниже:

Параметр	Значение
Конечная точка API	https://api.openai.com/v1
Модель	gpt-5
Ключ API	sk-...

Пользовательские инструкции Некоторые дополнительные подсказки для управления моделью ИИ. Например, вы можете добавить: «Используйте \mathbb{i} для мнимой единицы».

Контекст

• Радиус строк контекста (Context Line Radius) Здесь вы можете управлять радиусом контекста. Число 10 означает, что контекст строится из 10 строк до и 10 строк после курсора.
• Лимит символов контекста (Context Char limit) Максимальное количество символов в контексте. Число 1000 означает, что контекст ограничен 1000 символами.

Управление сервисом

Статус сервера отображается вверху. Вы можете запустить/остановить сервер, нажав соответствующие кнопки. Запустите сервер, чтобы мобильное приложение WriteTex могло подключиться к этому экземпляру VSCode. ОДНОВРЕМЕННО МОЖЕТ РАБОТАТЬ ТОЛЬКО ОДИН СЕРВЕР. Если вы запустили сервер в одном экземпляре VSCode, вы должны остановить его перед запуском в другом экземпляре.

Подключение к расширению

Убедитесь, что ваше расширение включено и сервер запущен. Убедитесь, что сервер расширения запущен только в одном проекте.

С iPhone/iPad

Убедитесь, что расширение включено и сервер запущен. На устройстве iOS перейдите в Настройки AI API -> Расширение VSCode. Включите Использовать VSCode, найдите имя вашего устройства в списке обнаружения и выберите его. Если ваше устройство не указано в списке, попробуйте подключиться вручную, введя IP-адрес вашего компьютера в поле Другое....

Для версий приложения iOS до v2.1: узнайте IP-адрес компьютера, на котором запущено расширение VSCode. Откройте Диспетчер задач, перейдите в раздел сеть и найдите IPv4-адрес. В настройках установите AI API следующим образом:

Параметр	Значение
Конечная точка API	http://ip-вашего-компьютера:50905/v1
Модель	ваша модель
Ключ API	writetex

С Android

Узнайте IP-адрес компьютера, на котором запущено расширение VSCode. Откройте Диспетчер задач, перейдите в раздел сеть и найдите IPv4-адрес. В настройках установите AI API следующим образом:

Параметр	Значение
Конечная точка API	http://ip-вашего-компьютера:50905
Модель	ваша модель
Ключ API	writetex

С Windows/MacOS

В настройках установите AI API следующим образом:

Параметр	Значение
Конечная точка API	http://127.0.0.1:50905
Модель	ваша модель
Ключ API	writetex

Использование

1. Откройте документ с поддерживаемым расширением файла: .tex .latex .markdown .md .rmd .qmd .ipynb
2. Установите курсор в документе
3. Подключите свой iPad/планшет к расширению VS Code
4. Начните писать, результаты OCR появятся в VS Code в позиции вашего курсора

Отладка

Общий контрольный список

• Расширение VS Code включено
• Сервер запущен только в одном открытом окне VS Code
• Курсор установлен в открытом редакторе с одним из следующих расширений файлов: .tex .latex .markdown .md .rmd .qmd .ipynb
• Ваш iPad/планшет подключен к той же сети, что и ваш компьютер
• Брандмауэр вашего компьютера разрешает входящие соединения
• Ваша сеть не блокирует связь между устройствами
• Если вы используете плагин Obsidian на компьютере, убедитесь, что Obsidian закрыт. В текстовом редакторе допускается только один экземпляр расширения WriteTex.

Результаты появляются на iPad, но не в VS Code

Убедитесь, что курсор установлен в VS Code. Проверьте, не открыто ли другое окно VS Code с запущенным сервером расширения. Если да, закройте его.

Не удается найти устройство в списке обнаружения на iPad

Проверьте, подключен ли ваш iPad/планшет к той же сети, что и ваш компьютер.

Если ваше устройство все еще не указано в списке, попробуйте подключиться вручную, введя IP-адрес вашего компьютера в поле Другое....