Nick Shirokov
ddc1641176
При поиске корня конфигурации guard поднимался по дереву вверх и «проскакивал» собственный корень автономной внешней обработки/отчёта (ExternalDataProcessor / ExternalReport), лежащей внутри дерева выгрузки конфигурации. Если у охватывающей конфигурации выключена возможность изменения (G=1), внешний объект ложно блокировался как «объект типовой конфигурации на поддержке», а info-навыки выводили нерелевантную строку «Поддержка: конфигурация read-only». Теперь climb останавливается на границе автономного объекта: если целевой файл или встреченный по пути <каталог>.xml имеет корень ExternalDataProcessor/ExternalReport, подъём прекращается и объект не привязывается к конфигурации. Корень внешнего объекта всегда глубже Configuration.xml, поэтому встречается первым — регрессии для обычных объектов конфигурации нет. Синхронно во всех копиях guard-а (навыки автономны): хук support-state.mjs (decideSupport + findConfigRoot), 16 мутаторов (Assert-EditAllowed), 5 info-навыков и meta-info (Get-SupportStatusForPath / Get-ObjectSupportStatus) — ps1 и py. Для info-навыков строка «Поддержка:» для внешнего объекта опускается. Тесты: hooks/test/run.mjs — секция внешней границы (G=1 + встроенная EPF); tests/skills — кейсы mxl-compile (guard пропускает) и mxl-info (строка опущена). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Хуки: защита конфигураций на поддержке + подсказка навыков
⚠️ Экспериментально, по умолчанию выключено. Эти хуки не подключаются автоматически даже при установке плагина — их нужно включить вручную (см. «Установка» ниже). Базовая защита поддержки уже работает без хуков — встроена в сами навыки-мутаторы; хуки лишь добавляют перехват правок в обход навыков и подсказки. Фича новая, обкатывается; отзывы приветствуются.
Два хука Claude Code, которые помогают безопасно дорабатывать типовые конфигурации 1С:
- Защита от правки «на замке». Если модель пытается напрямую (инструментами
Edit/Write) изменить объект типовой конфигурации, который стоит на поддержке поставщика, редактирование блокируется — иначе оно молча сломает будущие обновления вендора. В отказе сразу даётся, что делать дальше под конкретный случай (доработать в расширении или явно разрешить редактирование). - Подсказка навыков. Когда модель работает с исходниками 1С «вручную» (читает сырой XML или правит его
напрямую), хук ненавязчиво напоминает про профильный навык — и по делу: при чтении ведёт на
*-info(понять структуру), при правке — на мутатор (meta-edit/form-edit/skd-edit/…). Не блокирует, подсказывает не чаще одного раза за сессию на группу и действие.
Это дополнительный слой поверх проверок, которые уже встроены в сами навыки: навыки-мутаторы и так не дадут испортить объект на поддержке. Хуки добавляют защиту для случаев, когда правят файлы в обход навыков.
Хуки — возможность только Claude Code. На других платформах их нет; там работают встроенные в навыки проверки.
Требования
Node.js 18+ (тот же, что нужен для /web-test). Команда node должна быть доступна в PATH.
Установка (ручная — фича экспериментальная)
Хуки сейчас не включаются автоматически ни одним способом установки (плагин их не объявляет в манифесте). Чтобы включить:
- Убедитесь, что каталог
hooks/доступен в проекте. При установке плагином он уже в составе плагина — используйте путь${CLAUDE_PLUGIN_ROOT}/hooks/.... При установке копированием навыков скопируйтеhooks/в проект, например в<проект>/.claude/hooks/, и используйте${CLAUDE_PROJECT_DIR}/.claude/hooks/.... - Добавьте в
<проект>/.claude/settings.json(пути ниже — для варианта с копированием):
{
"hooks": {
"PreToolUse": [
{ "matcher": "Edit|Write|MultiEdit",
"hooks": [{ "type": "command",
"command": "node \"${CLAUDE_PROJECT_DIR}/.claude/hooks/support-guard.mjs\"" }] }
],
"PostToolUse": [
{ "matcher": "Read|Edit|Write|MultiEdit",
"hooks": [{ "type": "command",
"command": "node \"${CLAUDE_PROJECT_DIR}/.claude/hooks/skill-suggester.mjs\"" }] }
]
}
}
Настройка (.v8-project.json)
Поведение настраивается в файле проекта .v8-project.json — глобально и/или по конкретной базе
(databases[].…, переопределяет глобальное):
| Поле | Значения | По умолчанию | Что делает |
|---|---|---|---|
editingAllowedCheck |
deny / warn / off |
deny |
Реакция защиты: блокировать правку объекта на замке / только предупреждать / выключить проверку. |
skillSuggester |
on / off |
on |
Включает/выключает подсказки навыков. |
Источник истины по состоянию поддержки — сама выгрузка конфигурации; .v8-project.json лишь настраивает
реакцию.
Что делать при отказе защиты
Текст отказа сам подсказывает варианты под конкретную ситуацию. Кратко:
- Безопаснее всего — вести доработку в расширении (навыки
cfe-borrow/cfe-patch-method): состояние поддержки менять не нужно, обновления вендора сохраняются. - Либо осознанно разрешить редактирование через навык
support-edit(включить редактирование объекта, снять его с поддержки или включить возможность изменения всей конфигурации). Готовую команду под ваш случай печатает сам отказ.
Проверка
node hooks/test/run.mjs
Прогоняет защиту и подсказку на реальных выгрузках и на временных тестовых данных (в test-tmp/, не
попадает в git; рабочие выгрузки не затрагиваются).