Skip to content

hawkxtreme/mini-ai-1c

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

189 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Mini AI 1C

Mini AI 1C — нативный десктопный ИИ-ассистент для разработчиков 1C:Предприятие, построенный на базе Tauri 2 и React 19. Работает прямо рядом с открытым Конфигуратором: захватывает код модуля, отправляет его ИИ, получает умные правки и вставляет результат обратно.


⚡ Почему Mini AI 1C?

🆓 Бесплатно через Qwen Code CLI Подключите Qwen Code через OAuth — без API-ключей и без оплаты.
🤝 1С:Напарник как ИИ-провайдер Прямое подключение к code.1c.ai: встроенный поиск по ИТС, документации 1С и коду — без дополнительных MCP.
👥 Несколько аккаунтов Переключайтесь между профилями ИИ в один клик: Qwen (бесплатно), Напарник, Claude, Gemini, GPT — как удобно.
🩺 BSL Language Server Встроенный линтер BSL прямо в редакторе — синтаксические ошибки подсвечиваются до отправки в ИИ.
🔌 Предустановленные MCP-серверы 1С:Справка, 1С:Напарник, 1С:Метаданные, 1С: Поиск по конфигурации — работают «из коробки», без ручной настройки.
🎙️ Голосовой ввод Надиктуйте задачу голосом, не отрывая рук от клавиатуры.

1. Получение кода из Конфигуратора и объяснение кода: Получение кода и объяснение

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

3. Исправление ошибок BSL: Исправление ошибок


📸 Скриншоты

Показать скриншоты

Главный экран

Главный экран

Чат и код

ИИ-чат
ИИ-чат с BSL кодом
Auto-Proof
Auto-Proof и инлайн-диффы

Настройки

LLM профиль
Настройки LLM профиля
MCP серверы
MCP серверы
BSL LS
BSL Language Server

🎯 Для чего предназначен

Mini AI 1C создан для быстрой работы в рамках одного модуля: рефакторинга, генерации процедур, анализа и исправления кода на BSL.

✅ Когда использовать

Задача Пример
Генерация кода «Напиши СКД-запрос для остатков по складу»
Рефакторинг модуля Упростить, переименовать переменные, разбить на функции
Анализ фрагмента «Почему эта процедура работает медленно?»
Исправление ошибок Автоматически через BSL Language Server
Объяснение кода «Что делает этот блок?»
Генерация типовых конструкций Запросы, обходы таблиц, HTTP-запросы, XML и т.д.

❌ Когда НЕ использовать

Important

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

Ограничение Что это значит
Нет анализа всей конфигурации ИИ не знает, какие объекты есть в вашей базе (если не подключён MCP-сервер «1C:Метаданные»)
Нет понимания бизнес-логики ИИ не знает о связях между модулями и их назначении
Нет контекста других модулей Код в других модулях не виден ИИ (частично снимается MCP-сервером «1С: Поиск по конфигурации»)

💡 Вывод: использование MCP-сервера 1C:Метаданные частично снимает эти ограничения, предоставляя ИИ доступ к структуре базы в режиме реального времени.


🚀 Возможности

  • Продвинутый ИИ-чат с контекстом:

    • Обсуждайте ваш код с ИИ, который понимает синтаксис и контекст BSL.
    • Прозрачность: наблюдайте за ходом внутренних рассуждений моделей (extended thinking у Qwen) и выполнением tool calls в реальном времени.
    • Редактирование сообщений: измените запрос и перезапустите чат с нужного места.
  • Интеллектуальная система промптов:

    • Профили поведения: переключайтесь между режимом «Свой код» (свободный рефакторинг) и «Чужой код» (жесткая изоляция правок комментариями).
    • Библиотека правил: создавайте свои шаблоны инструкций для ИИ (например, «Всегда использовать БСП» или «Запрет на использование Сообщить()»).
    • Глобальная роль: настройте системный префикс (System Prompt) под ваш стиль разработки.
  • Умная маркировка изменений:

    • Автоматическое выделение правок комментариями // Доработка START / END.
    • Гибкая настройка шаблонов с использованием переменных: {date}, {datetime}, {newCode}, {oldCode}.
  • Auto-Proof и Интерактивные Диффы:

    • Режим Diff (Search/Replace): ИИ предлагает точечные изменения, что позволяет работать даже с огромными модулями без потери контекста.
    • Инлайн-диффы: визуальное сравнение блоков «ДО/ПОСЛЕ» прямо в чате.
    • Построчное управление: принимайте или отменяйте конкретные части кода прямо в редакторе (кнопки «Принять» / «Отменить» на полях Monaco Editor).
    • Массовое применение: подтверждайте все изменения разом («Принять всё») или выборочно.
    • Отмена: откатите изменения к оригиналу в один клик.
  • Исправление ошибок через BSL LS:

    • После применения кода запустите slash-команду /исправить — ИИ получит диагностики BSL Language Server и исправит синтаксические ошибки.
  • Интеграция с Конфигуратором 1С (Windows):

    • Получить код: мгновенно забирайте текст модуля или выделенный фрагмент из активного окна Конфигуратора.
    • Вставить результат: отправляйте исправленный код обратно в Конфигуратор в один клик.
  • BSL Language Server:

    • Подсветка синтаксиса и линтинг прямо в редакторе Monaco Editor.
    • Управление BSL LS прямо из настроек: включить, проверить статус, перезапустить.
    • Встроенная диагностика: автоматическая проверка доступности Java, JAR-файла и WebSocket-соединения с выводом детальных рекомендаций по устранению проблем.
  • Портативность (True Portability):

    • Приложение работает как одиночный .exe файл, не требующий установки или наличия папок рядом.
    • Все встроенные MCP-серверы и ресурсы встроены в бинарный файл (include_bytes!) и автоматически разворачиваются при первом запуске.
  • Поддержка MCP (Model Context Protocol):

    • Подключайте любые внешние MCP-серверы (stdio/SSE).
    • В приложении предустановлены серверы для работы с 1С.
  • 🆓 Qwen Code CLI — бесплатный доступ к мощному ИИ:

    • Авторизация через официальный OAuth Device Flow (открываете ссылку, подтверждаете в браузере — готово).
    • Токены хранятся в системном Keychain — безопасно, без файлов с секретами.
    • Счётчик использованных запросов отображается прямо в интерфейсе чата и настройках.
  • 1С:Напарник — прямой ИИ-провайдер:

    • Подключитесь к code.1c.ai по API-токену и общайтесь с ИИ, специализированным на 1С.
    • Встроенный поиск по ИТС, документации 1С и коду — без настройки дополнительных MCP-серверов.
    • Профиль отображается в отдельной секции «1С:Напарник» в переключателе профилей с оранжевым badge ИТС.
    • Ограничения: применение диффов и локальные MCP-серверы недоступны (инструменты выполняются на стороне сервера code.1c.ai).
  • Гибкое управление LLM:

    • Поддержка Ollama, LM Studio, OpenAI, Anthropic, DeepSeek, OpenRouter и других OpenAI-совместимых провайдеров.
    • Авто-подгрузка списка моделей и проверка связи.
  • Голосовой ввод (Speech-to-Text):

    • Надиктуйте задачу голосом — ассистент мгновенно преобразует речь в текст.
    • Технология: используется нативный Web Speech API, что обеспечивает высокую скорость и работу без дополнительных API-ключей.
    • Полная поддержка русского языка и потоковый ввод текста.
  • Сохранение истории чатов и положения окна между сессиями.


🔌 Встроенные MCP-серверы

1С:Справка

1C:Справка

Описание: Предоставляет ИИ доступ к официальной справке платформы 1С:Предприятие 8.3. ИИ может мгновенно получать информацию из Синтакс-помощника по методам, свойствам и конструкциям языка BSL, что значительно повышает качество генерации и анализа кода.

Как подключить:

  1. Перейдите в НастройкиMCP Servers.
  2. В карточке 1С:Справка переключите тумблер в состояние Enabled.
  3. При первом запуске приложение автоматически найдет установленную платформу 1С и проиндексирует справку (занимает 1-3 минуты).
  4. После завершения индексации статус сменится на Ready, отобразив версию платформы и количество проиндексированных тем.

1C:Напарник (1C.ai)

1C:Напарник

Описание: Доступ к облачному API 1C.ai. ИИ может объяснять сложные моменты BSL, диагностировать код на ошибки и давать рекомендации по стандартам разработки 1С.

Новое: Напарник теперь доступен и как прямой LLM-провайдер — помимо использования через MCP. Добавьте профиль в НастройкиLLM → группа «1С:Напарник» и общайтесь напрямую с поиском по ИТС из коробки.

Как подключить (MCP-сервер):

  1. Перейдите в НастройкиMCP Servers.
  2. В карточке 1C:Напарник введите ваш персональный API Token (получить на code.1c.ai → Профиль → API токен).
  3. Переключите тумблер в состояние Enabled и нажмите Проверить.

1C:Метаданные

1C:Метаданные

Описание: Даёт ИИ возможность исследовать структуру вашей конкретной базы — состав справочников, документов, реквизиты, табличные части, перечисления. Позволяет генерировать код, который сразу готов к работе с вашими данными. Снимает основное ограничение приложения.

Использует HTTP-сервисы расширения 1c_mcp.

Как подключить:

  1. Установите расширение 1c_mcp в вашу информационную базу.
  2. Опубликуйте базу на веб-сервере (Apache или IIS).
  3. В настройках укажите протокол, адрес сервера и имя публикации.
  4. Введите логин/пароль пользователя 1С.
  5. Нажмите Проверить — статус должен смениться на зелёный чек.

1С: Поиск по конфигурации

1С: Поиск по конфигурации

Описание: Высокопроизводительный сервер для поиска и навигации по исходным кодам конфигураций 1С:Предприятие (выгрузка в файлы). Работает с конфигурациями 20 ГБ+ даже на медленных HDD: поиск символов — 1–23 мс, полнотекстовый grep — ~77 мс.

Как подключить:

  1. Перейдите в НастройкиMCP Servers.
  2. В карточке 1С: Поиск по конфигурации укажите путь к директории с исходниками конфигурации (ONEC_CONFIG_PATH).
  3. Переключите тумблер в Enabled — сервер проиндексирует файлы при первом запуске.

📖 Подробнее: производительность, архитектура, алгоритмы — в документации сервера.


🛠 Технологический стек

Слой Технологии
Frontend React 19, TypeScript, TailwindCSS, Vite, Monaco Editor
Backend/Core Tauri 2 (Rust)
Language Server BSL Language Server (WebSocket/Stdio)
AI Integration MCP Client, OpenAI-совместимый API
Windows Win32 API (интеграция с окнами Конфигуратора)

📋 Требования

  1. Node.js (v18+) — необходим для работы MCP-серверов.
  2. Java Runtime Environment (JRE) (v17+) — необходим для работы BSL Language Server.
  3. Windows 10/11 — для полноценной интеграции с Конфигуратором 1С.

⚡ Установка и Запуск (Development)

# 1. Клонируйте репозиторий
git clone https://github.com/hawkxtreme/mini-ai-1c
cd mini-ai-1c/tauri-app

# 2. Установите зависимости
npm install

# 3. Запустите в режиме разработки
npm run app:dev

📦 Сборка (Production)

npm run app:build

Файлы сборки будут находиться в src-tauri/target/release/bundle.

🔧 Настройка

  • Нажмите иконку Настройки (шестерёнка) в приложении.
  • Настройте профили LLM и укажите пути к Java/BSL LS.
  • В разделе MCP Servers подключите дополнительные инструменты.

⚠️ Известные проблемы

Ошибка «Could not find the WebView2 Runtime»

Причина: Отсутствует Microsoft Edge WebView2 Runtime — компонент для работы Tauri-приложений на Windows.

Решение: Скачайте и установите WebView2 Runtime Evergreen Bootstrapper.

Примечание: WebView2 Runtime устанавливается один раз и работает для всех приложений на базе Tauri/Electron.

📄 Лицензия

Проект распространяется под кастомной лицензией (Attribution Non-Commercial License).

  • Запрещено коммерческое использование.
  • Обязательно указание авторства: @hawkxtreme.

Подробности в файле LICENSE.

🤝 Благодарности

  • Владимир Харин (@vladimir-kharin) — за расширение 1c_mcp, которое легло в основу интеграции с метаданными 1С.
  • @alkoleft — за грамматику tree-sitter-bsl, используемую для парсинга BSL-кода в MCP-сервере поиска по конфигурации.
  • @Arman-Kudaibergenov — за проект bsl-atlas, послуживший источником вдохновения для построения индекса символов и call graph BSL.
  • @SteelMorgan — за проект spring-mcp-1c-copilot, идеи из которого были использованы при разработке MCP 1С Напарника.

📰 Публикации

Infostart

Создано с ❤️ для сообщества 1С · Telegram

About

ИИ-ассистент для разработчиков 1С:Предприятие. Умный чат, анализ кода BSL и бесшовная интеграция с Конфигуратором

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors