Напарник
Чат с 1С:Напарник в боковой панели VS Code
Возможности
- Ответы в реальном времени, кнопка «Стоп»
- Доступ к проекту (кнопка над полем ввода): Напарник смотрит структуру, читает и ищет файлы, предлагает правки — каждая правка открывается как diff и применяется только после подтверждения
- Поиск по ИТС и документации платформы
- История чатов
- Копирование и вставка кода из ответа в редактор
- Контекст редактора: открытый файл или выделенный фрагмент (и ошибки VS Code по нему) автоматически прикладываются к вопросу — чип над полем ввода показывает, что именно; клик по чипу — не прикладывать
- «Спросить Напарника» о выделенном коде из контекстного меню
- Слэш-команды: введите
/ в поле чата — появится список (/init, /rules, /make-rules, /clear, /help и др.)
/init — Напарник изучает проект (README, CLAUDE.md, AGENTS.md, правила Cursor/Copilot и код) и создаёт NAPARNIK.md — описание, которое подставляется в каждый новый чат
- Правила проекта в папке
.rules/: «запомни…» записывает правило, /make-rules собирает правила из текущего чата
Установка
Найдите «Напарник» во вкладке Extensions или установите со страницы Marketplace:
code --install-extension winst0niuss.naparnik-1c-chat
Затем откройте значок чата слева и нажмите «Задать токен». API-токен выдаётся в личном кабинете code.1c.ai.
Нужен VS Code 1.90 или новее.
Настройки
| Настройка |
По умолчанию |
Описание |
naparnik.skillName |
custom |
custom — с поиском по ИТС, raw — только ответ модели |
naparnik.timeoutSeconds |
300 |
Сколько секунд ждать данных от сервера |
naparnik.baseUrl |
https://code.1c.ai |
Адрес API |
naparnik.authFormat |
plain |
Формат заголовка Authorization: plain или bearer |
Разработка
npm install
npm test # unit-тесты, токен не нужен
npm run package # собрать .vsix
Отладка: F5 в VS Code.
Правовая информация
Это неофициальный проект. Он не связан с фирмой «1С», не одобрен и не поддерживается ею. «1С», «1С:Предприятие», «1С:Напарник» — товарные знаки ООО «1С-Софт». Они упоминаются только для того, чтобы указать, с каким сервисом работает расширение.
Для работы нужна собственная учётная запись 1С:Напарник. Расширение не обходит ограничения сервиса, а соблюдение его условий — ответственность пользователя.
Данные. Токен хранится в защищённом хранилище VS Code (связка ключей ОС). Вопросы и код отправляются в сервис 1С:Напарник и обрабатываются по его правилам. При включённом доступе к проекту туда же отправляются структура проекта и файлы, которые читает Напарник; по умолчанию доступ выключен. Пути из .gitignore проекта Напарник не видит в структуре проекта и в поиске. С каждым сообщением отправляется файл, открытый в редакторе (или выделенный фрагмент), — это видно по чипу над полем ввода, клик по нему отключает отправку. История чатов хранится локально. Телеметрии нет. Запросы отправляются с заголовком User-Agent: naparnik-1c-vscode/<версия> (unofficial).
Без гарантий. Расширение предоставляется «как есть». API сервиса публично не документирован и может измениться. Автор расширения не отвечает за содержание ответов.
Формат API изучен по проектам 1c-ai-mcp и spring-mcp-1c-copilot, подробнее — в NOTICE. Лицензия — MIT.