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` | | `Status: Остановлен` | Apache не запущен — публикации в `httpd.conf` есть, но URL-ы не отвечают. Поднимается повторным `/web-publish` |
| `Port: 9191 (не отвечает)` | Порт из `httpd.conf` не слушается. При `Status: Запущен` — процесс жив, но сервер не поднялся: смотри ошибки ниже (занятый порт, битый конфиг) | | `Port: 9191 (не отвечает)` | Порт не слушается — URL-ы не откроются. Вместе с `Status: Запущен` значит, что сервер не поднялся (занятый порт, битый конфиг): смотри секцию ошибок |
| `[WARN] Обнаружен сторонний Apache` | На машине работает чужой экземпляр — может держать порт; наши команды им не управляют | | `[WARN] Обнаружен сторонний Apache` | На машине работает чужой экземпляр — может держать порт; наши команды им не управляют |
| `[WS HTTP OData]` | Что опубликовано для базы: SOAP-сервисы, HTTP-сервисы, стандартный OData | | `[WS HTTP OData]` | Что опубликовано для базы: SOAP-сервисы, HTTP-сервисы, стандартный OData |
| `+ext` (`WS+ext`) | Публикуются и сервисы, поставляемые расширениями конфигурации | | `+ext` (`WS+ext`) | Публикуются и сервисы, поставляемые расширениями конфигурации |
| `(нет публикаций)` | Apache стоит, но ни одна база не опубликована — нужен `/web-publish` | | `(нет публикаций)` | Apache установлен, но ни одна база не опубликована — нужен `/web-publish` |
| `(ошибок нет)` / `(нет файла)` | Норма, а не сбой: ошибок в журнале нет или он ещё не создан | | `(ошибок нет)` / `(нет файла)` | Норма, а не сбой: ошибок в журнале нет или он ещё не создан |
Секция ошибок — последние 5 записей уровня `error` и выше. `notice` (строки старта), `warn` В ошибках — последние записи уровня `error` и выше, информационные строки отфильтрованы. Журнал не
(штатный шум `winnt_accept` на Windows) и `AH02538` (след нашего же рестарта Apache) отсеиваются, ротируется, поэтому запись может быть полугодовой давности: смотри дату, прежде чем считать её
иначе они вытесняют содержательное. Записи могут быть давними — смотри дату в строке. Путь к причиной текущей проблемы. Рядом печатается путь к журналу — нужен полный контекст, прочитай файл.
журналу печатается рядом: нужен полный контекст или отсеянные уровни — читай файл напрямую.
Проверяется только TCP-порт Apache. Публикация в списке не означает, что база отвечает: состав Строка публикации говорит «так настроено», а не «база отвечает»: проверяется доступность самого
берётся из `httpd.conf` и дескрипторов, сами URL-ы не опрашиваются. Причина не в лени: запрос к Apache, но не публикаций. Убедиться в конкретной базе можно запросом к её URL — но учти, что такой
`/{AppName}` поднимает сеанс веб-клиента 1С и занимает лицензию, а публикаций может быть много. запрос поднимает сеанс 1С и занимает лицензию.
Нужно убедиться в конкретной базе — дёрни её URL осознанно, помня про лицензию.
## Примеры ## Примеры
+3 -3
View File
@@ -84,9 +84,9 @@ powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/web-publish.ps1" <
3. Если нужно протестировать сервис — помоги составить запрос 3. Если нужно протестировать сервис — помоги составить запрос
4. Если база не зарегистрирована — предложи `/db-list add` 4. Если база не зарегистрирована — предложи `/db-list add`
Публикуются и сервисы расширений — по `publishExtensionsByDefault` в дескрипторе. Если сервис Сервисы расширений публикуются наравне с сервисами конфигурации. Если сервис расширения всё же
расширения всё же отдаёт 404 (HTTP) или 500 «Сервис не найден» (SOAP), расширение не применено отдаёт 404 (HTTP) или 500 «Сервис не найден» (SOAP) расширение не применено к базе данных:
к базе данных: `/db-update -Extension <имя>`. `/db-update -Extension <имя>`.
## Примеры ## Примеры