From 4eea14761914411cbaece035ecc83820bdf7477e Mon Sep 17 00:00:00 2001 From: Nick Shirokov Date: Wed, 29 Jul 2026 22:38:10 +0300 Subject: [PATCH] =?UTF-8?q?docs(db-guide):=20=D1=87=D1=82=D0=BE=20=D0=BF?= =?UTF-8?q?=D0=B5=D1=87=D0=B0=D1=82=D0=B0=D0=B5=D1=82=20=D0=BD=D0=B0=D0=B2?= =?UTF-8?q?=D1=8B=D0=BA=20=D0=B8=20=D0=BA=D0=B0=D0=BA=20=D1=87=D0=B8=D1=82?= =?UTF-8?q?=D0=B0=D0=B5=D1=82=D1=81=D1=8F=20=D0=B2=D1=8B=D0=B2=D0=BE=D0=B4?= =?UTF-8?q?=20=D0=BF=D0=BB=D0=B0=D1=82=D1=84=D0=BE=D1=80=D0=BC=D1=8B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5 (1M context) --- docs/db-guide.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/docs/db-guide.md b/docs/db-guide.md index c48be112..be5e1468 100644 --- a/docs/db-guide.md +++ b/docs/db-guide.md @@ -159,6 +159,28 @@ PowerShell не умеет собирать массив из отдельных - параметр «не своего» движка (`-AdditionalV8Arguments` при выбранном `ibcmd`). Ключи из `.v8-project.json` в этом случае просто не применяются — реестр проекта может описывать оба движка. +## Что печатает навык + +Порядок один и тот же в обоих портах и на обоих движках: + +1. `Running: …` — командная строка запуска (секреты замаскированы, см. ниже); +2. результат операции одной строкой; +3. `--- Log ---` … `--- End ---` — журнал платформы из `/Out` (у `ibcmd` его нет); +4. `--- Вывод платформы ---` … `--- End ---` — то, что платформа написала в консоль. + +Четвёртый блок появляется, только если платформа что-то написала. В пакетном режиме +`1cv8` пишет в `/Out` и молчит в консоли, поэтому обычно блока нет; он всплывает при +аварийном завершении, когда сообщение проходит мимо `/Out`. `ibcmd`, наоборот, весь свой +вывод (`[INFO] …`) шлёт именно туда. + +Кодировка определяется по факту: UTF-8, при неудаче — cp866. Гадать нельзя — `ibcmd` +пишет UTF-8, а аварийный текст `1cv8` приходит в OEM. + +Путевые параметры прощают обрамляющие кавычки, пробелы по краям и хвостовой разделитель. +Навыки, работающие с готовой базой, проверяют её наличие до запуска и говорят +«information base not found at X» вместо платформенного «Неверные или отсутствующие +параметры соединения». + В строке `Running: …` значения секрето-опасных ключей (`/P`, `/UC`, `--password`, `--token`) заменяются на `***`. Ограничения разбора, о которых стоит знать: