Автоматическое (почти) конфигурирование папки проекта 1С под Cursor: практический дайджест и проверка «Нано-УТ»
Файлы
ВНИМАНИЕ: Файлы из Базы знаний - это исходный код разработки. Это примеры решения задач, шаблоны, заготовки, "строительные материалы" для учетной системы. Файлы ориентированы на специалистов 1С, которые могут разобраться в коде и оптимизировать программу для запуска в базе данных. Гарантии работоспособности нет. Возврата нет. Технической поддержки нет.
Подписка PRO — скачивайте любые файлы со скидкой до 85% из Базы знаний
Оформите подписку на компанию для решения рабочих задач
Оформить подписку и скачать решение со скидкойВы можете заказать платную доработку или адаптацию этой разработки под вашу конфигурацию на «Бирже заказов».
- 0% комиссии — оплата напрямую исполнителю;
- Исполнители любого масштаба — от отдельных специалистов до команд под проект;
- Прямой обмен контактами между заказчиком и исполнителем;
- Безопасная сделка — при необходимости;
- Рейтинги, кейсы и прозрачная система откликов.
О чём это (в трёх тезисах):
- Мастер
setup-wizard.ps1готовит проект 1С для Cursor: выгружает конфигурацию, пишет профиль базы, настройки IPC и MCP; сам он прикладную логику не создаёт. - Проверки бывают трёх уровней: окружение (
doctor.ps1, 12 OK), синтаксис (платформа, ошибок нет), прикладной сценарий (25 проверок COM-теста). - Вызов инструментов агентом Cursor через MCP в прогонах не выполнялся, но ответ
env_statusнужно сверять с каталогом активного проекта.
Суть статьи:
Сводка по границам проверок мастер-скрипта (Wizard) на учебной «Нано-УТ»: что показал каждый уровень и какие выводы по нему делать нельзя.
Для кого: разработчики 1С, которые готовят проектный каталог (каркас) для Cursor и хотят понимать, что именно подтверждает зелёный результат каждой проверки.
Эта статья - короткая сводка к подробному разбору мастер-скрипта. Здесь только границы: что проверили, что получилось и что осталось непроверенным. Команды запуска, структура каталога и исходники учебной конфигурации разобраны в основной статье «Wizard для 1С и Cursor: настройка проекта и проверка на «Нано-УТ»» и лежат в её архиве.
Стенд: Windows 11 Pro, Intel Core i5-2400 3,1 ГГц, 7,9 ГБ ОЗУ, SATA SSD, платформа 1С:Предприятие 8.3.27.2130, Cursor 3.25.6, Node.js 24.18.0, OneScript 2.2.1.
Что делает мастер-скрипт
Входы мастера: папка проекта, установленная платформа 1С и, при необходимости, существующая база через -IbConnection. Выход: каталог для работы в Cursor.
- Компоненты: ищет Cursor, Node.js, Git и платформу 1С.
- Расширения: проверяет или ставит Platform Tools и MCP-расширение.
- Проект: создаёт Git-репозиторий, копирует
.gitignore,.gitattributes,packagedef. - Конфигурация: создаёт пустую файловую базу либо выгружает указанную в XML (
src/cf/Configuration.xml). - Канал связи: пишет настройки IPC и MCP (
.vscode/settings.json,.cursor/mcp.json). - Инструменты: проверяет OneScript, предлагает
opm install vanessa-runner, настраивает BSL. - Профиль: записывает строку подключения и версию платформы в
autumn-properties.json. - Контроль: проверяет модули, копирует правила агента, запускает
doctor.ps1.
Справочники, документы и проведение мастер не создаёт: это отдельная разработка. Режим -DryRun показывает план без изменений.
Два запуска и что они показали
| Запуск | Команда | Результат |
|---|---|---|
| Пустая папка, новая база | -Project C:\work\nano-ut-empty (или -Yes) |
Пустая конфигурация, doctor 12 OK, синтаксис без ошибок, BSL-модулей ноль |
| Существующая «Нано-УТ» | -Project C:\work\nano-ut-source -IbConnection C:\bases\nano-ut -Yes -SkipMcpCheck |
Выгружены два справочника, один документ, три общих модуля; шесть файлов BSL; ошибок синтаксиса нет; doctor 12 OK; шаг 9 «ВРУЧНУЮ», шаг 10 «ПРОПУЩЕН» |
Пустая база с зелёным doctor подтверждает настройку окружения и ничего не говорит о бизнес-логике. Код возврата 0 допускает статусы «ВРУЧНУЮ» и «ПРОПУЩЕН», поэтому не подтверждает цепочку от агента до базы.
Статусы шагов в build/setup-wizard-report.txt: OK, ВРУЧНУЮ (нужно действие пользователя), ПРОПУЩЕН (отключён ключом), ОШИБКА.
Связка Cursor, MCP и платформа
Порядок проверки:
- Открыть проект:
cursor --classic C:\work\nano-ut-source. - Убедиться, что папка доверенная: иначе Platform Tools не откроет канал для агентов.
- Проверить активный проект и
autumn-properties.json. - Включить MCP-сервер проекта из
.cursor/mcp.json(Customize → MCPs). - Проверить порт:
Test-NetConnection 127.0.0.1 -Port 40241. - Попросить агента вызвать
env_statusи сверить профиль, файл настроек и строку подключения.
Открытый порт и ответ «Успех» не доказывают, что это нужный проект. В нашем примере env_status вернул другой каталог, local-wizard-ps51, открытый предыдущим прогоном. Поэтому полный путь проекта в ответе сверяют отдельно, особенно при нескольких окнах с одинаковым портом.
Что было в исходной «Нано-УТ»
«Нано-УТ (демо для Analyzer 1C)», версия 1.0.0.1: справочники Контрагенты (ИНН) и Номенклатура (артикул), документ ЗаказКлиента, модули ПродажиСервер, СкладСервер, ЦеныСервер. Документов поступления и продажи и регистра остатков не было. В модуле цен для демонстрации Analyzer заложена кольцевая зависимость: синтаксис проходит, а проведение заказа попадает в рекурсивную цепочку. Зелёная проверка синтаксиса не означает, что операция работает.
Учебная торговая база
Для сценария создана отдельная база с документами ПоступлениеТовара и ПродажаТовара: контрагент, табличная часть Товары (номенклатура, количество, цена, сумма), итог документа. Сумма считается при записи с округлением.
Остаток считается по документам, регистра нет: количество в проведённых поступлениях минус количество в проведённых продажах. Складов, партий, себестоимости и налогов нет, это учебная модель, складской учёт она не заменяет. Текущий документ при проверке исключается из расчёта, затем учитывается его новое содержимое, поэтому продажу можно перепроводить без двойного списания. Строки одной номенклатуры суммируются. Поступление нельзя уменьшить или отменить, если проведённые продажи уйдут в минус. Заказ клиента доступность проверяет, остатки не меняет и резерв не создаёт.
COM-тест использует зарегистрированный 32-разрядный V83.COMConnector, для каждого запуска создаёт новую номенклатуру и контрагента и проходит сценарий:
| Шаг | Остаток |
|---|---|
| Поступление 10 | 10 |
| Продажа 3 | 7 |
| Попытка продажи 11 | отказ, остаток 7 |
| Изменение продажи на 2 | 8 |
| Отмена проведения продажи | 10 |
| Итог: поступление 10 и продажа 3 | 7 |
Результат проверяется отдельным запросом по документам и сверяется с ответом функции прикладного модуля.
Набор проверок
| Проверка | Результат |
|---|---|
| Тесты wizard | 18-19 успешных, 0 проваленных, 1 пропущена (порт 40241 уже был занят) |
| Тесты doctor | 5 из 5, в Windows PowerShell 5.1 и PowerShell 7 |
| COM-тест торгового сценария | 25 успешных, включая отказы при нулевом и отрицательном количестве, неверной цене, отсутствии контрагента или товара, пустом документе, повторяющихся строках и обычной записи проведённого документа |
Эти проверки не покрывают серверную базу под нагрузкой, многопользовательскую работу и вызов инструментов агентом Cursor: торговый сценарий выполнен через COM, через MCP он не запускался.
Выводы
- Новый проект: сначала
-DryRun, затем мастер в пустой папке. - Существующая конфигурация: передать базу через
-IbConnection, изучить выгрузку, рабочую базу не менять. - Перед изменениями проверить профиль подключения и завести отдельную учебную базу.
- Подтверждений нужно три:
doctorдля окружения, платформа для синтаксиса, прикладной сценарий для данных и поведения.
Итог
Мастер-скрипт снимает рутину настройки каркаса проекта 1С под управлением Cursor и показывает результат в отчёте по шагам. Окружение, синтаксис и прикладное поведение проверяются разными средствами, и зелёный результат одного уровня ничего не говорит о другом. Цепочка Cursor, MCP и платформа в этих прогонах осталась ручным шагом, а торговая модель по документам пригодна для разбора сценария, но для складского учёта не годится.
Вступайте в нашу телеграмм-группу Инфостарт
