docs(web-info,web-publish): убрать детали реализации из инструкций

В «Как читать вывод» протекли внутренности фильтра журнала (коды сообщений
Apache, что именно отсеивается и почему) и обоснование правки. Модели,
использующей навык, нужны сигналы и действие по ним, а не устройство.
В web-publish по той же причине убрано имя атрибута дескриптора.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Nick Shirokov
2026-08-08 15:48:32 +03:00
co-authored by Claude Opus 5
parent 0d4933f135
commit fc2d460b57
2 changed files with 11 additions and 13 deletions
+8 -10
View File
@@ -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С и занимает лицензию.
## Примеры
+3 -3
View File
@@ -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 <имя>`.
## Примеры