From fc2d460b579e210d704a702fef542bf67ec77acc Mon Sep 17 00:00:00 2001 From: Nick Shirokov Date: Sat, 8 Aug 2026 15:48:32 +0300 Subject: [PATCH] =?UTF-8?q?docs(web-info,web-publish):=20=D1=83=D0=B1?= =?UTF-8?q?=D1=80=D0=B0=D1=82=D1=8C=20=D0=B4=D0=B5=D1=82=D0=B0=D0=BB=D0=B8?= =?UTF-8?q?=20=D1=80=D0=B5=D0=B0=D0=BB=D0=B8=D0=B7=D0=B0=D1=86=D0=B8=D0=B8?= =?UTF-8?q?=20=D0=B8=D0=B7=20=D0=B8=D0=BD=D1=81=D1=82=D1=80=D1=83=D0=BA?= =?UTF-8?q?=D1=86=D0=B8=D0=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit В «Как читать вывод» протекли внутренности фильтра журнала (коды сообщений Apache, что именно отсеивается и почему) и обоснование правки. Модели, использующей навык, нужны сигналы и действие по ним, а не устройство. В web-publish по той же причине убрано имя атрибута дескриптора. Co-Authored-By: Claude Opus 5 (1M context) --- .claude/skills/web-info/SKILL.md | 18 ++++++++---------- .claude/skills/web-publish/SKILL.md | 6 +++--- 2 files changed, 11 insertions(+), 13 deletions(-) diff --git a/.claude/skills/web-info/SKILL.md b/.claude/skills/web-info/SKILL.md index 6b43eaeb..d39bd336 100644 --- a/.claude/skills/web-info/SKILL.md +++ b/.claude/skills/web-info/SKILL.md @@ -43,22 +43,20 @@ powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/web-info.ps1" <па | В выводе | Что значит | |----------|------------| | `Status: Остановлен` | Apache не запущен — публикации в `httpd.conf` есть, но URL-ы не отвечают. Поднимается повторным `/web-publish` | -| `Port: 9191 (не отвечает)` | Порт из `httpd.conf` не слушается. При `Status: Запущен` — процесс жив, но сервер не поднялся: смотри ошибки ниже (занятый порт, битый конфиг) | +| `Port: 9191 (не отвечает)` | Порт не слушается — URL-ы не откроются. Вместе с `Status: Запущен` значит, что сервер не поднялся (занятый порт, битый конфиг): смотри секцию ошибок | | `[WARN] Обнаружен сторонний Apache` | На машине работает чужой экземпляр — может держать порт; наши команды им не управляют | | `[WS HTTP OData]` | Что опубликовано для базы: SOAP-сервисы, HTTP-сервисы, стандартный OData | | `+ext` (`WS+ext`) | Публикуются и сервисы, поставляемые расширениями конфигурации | -| `(нет публикаций)` | Apache стоит, но ни одна база не опубликована — нужен `/web-publish` | +| `(нет публикаций)` | Apache установлен, но ни одна база не опубликована — нужен `/web-publish` | | `(ошибок нет)` / `(нет файла)` | Норма, а не сбой: ошибок в журнале нет или он ещё не создан | -Секция ошибок — последние 5 записей уровня `error` и выше. `notice` (строки старта), `warn` -(штатный шум `winnt_accept` на Windows) и `AH02538` (след нашего же рестарта Apache) отсеиваются, -иначе они вытесняют содержательное. Записи могут быть давними — смотри дату в строке. Путь к -журналу печатается рядом: нужен полный контекст или отсеянные уровни — читай файл напрямую. +В ошибках — последние записи уровня `error` и выше, информационные строки отфильтрованы. Журнал не +ротируется, поэтому запись может быть полугодовой давности: смотри дату, прежде чем считать её +причиной текущей проблемы. Рядом печатается путь к журналу — нужен полный контекст, прочитай файл. -Проверяется только TCP-порт Apache. Публикация в списке не означает, что база отвечает: состав -берётся из `httpd.conf` и дескрипторов, сами URL-ы не опрашиваются. Причина не в лени: запрос к -`/{AppName}` поднимает сеанс веб-клиента 1С и занимает лицензию, а публикаций может быть много. -Нужно убедиться в конкретной базе — дёрни её URL осознанно, помня про лицензию. +Строка публикации говорит «так настроено», а не «база отвечает»: проверяется доступность самого +Apache, но не публикаций. Убедиться в конкретной базе можно запросом к её URL — но учти, что такой +запрос поднимает сеанс 1С и занимает лицензию. ## Примеры diff --git a/.claude/skills/web-publish/SKILL.md b/.claude/skills/web-publish/SKILL.md index 11f07aa8..25c973bd 100644 --- a/.claude/skills/web-publish/SKILL.md +++ b/.claude/skills/web-publish/SKILL.md @@ -84,9 +84,9 @@ powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/web-publish.ps1" < 3. Если нужно протестировать сервис — помоги составить запрос 4. Если база не зарегистрирована — предложи `/db-list add` -Публикуются и сервисы расширений — по `publishExtensionsByDefault` в дескрипторе. Если сервис -расширения всё же отдаёт 404 (HTTP) или 500 «Сервис не найден» (SOAP), расширение не применено -к базе данных: `/db-update -Extension <имя>`. +Сервисы расширений публикуются наравне с сервисами конфигурации. Если сервис расширения всё же +отдаёт 404 (HTTP) или 500 «Сервис не найден» (SOAP) — расширение не применено к базе данных: +`/db-update -Extension <имя>`. ## Примеры