“Naeel”
c9a881aa84
- value_list → читаемый текст (Допустимые значения) - regex → описание формата - пустые описания → заполнять из MAN - группы map-fixed → 1 предложение о содержимом - операции без описания → шаблоны - MAN-контекст для params/ops файлов - max_tokens 4096 → 8192 - вывод в docs_llm/ вместо перезаписи docs/
36 lines
1.6 KiB
Markdown
36 lines
1.6 KiB
Markdown
# Sonnet: финальный план P1 — 05_generate_docs_llm.py
|
||
|
||
## Пайплайн на один сервис
|
||
|
||
```
|
||
docs/Name.md ─┐
|
||
docs/Name_params_create.md ─┤ LLM → docs_llm/Name.md
|
||
docs/Name_params_modify.md ─┤ docs_llm/Name_params_create.md
|
||
docs/Name_ops.md ─┤ docs_llm/Name_params_modify.md
|
||
docs/Name_example.md ─┘ docs_llm/Name_ops.md
|
||
docs_llm/Name_example.md
|
||
|
||
docs/Name_outputs.md ─── copy → docs_llm/Name_outputs.md
|
||
docs/Name_params.md ─── copy → docs_llm/Name_params.md
|
||
docs/Name_subresource*.md ─── copy → docs_llm/Name_subresource*.md
|
||
```
|
||
|
||
## Ключевые детали
|
||
|
||
### MAN-контекст
|
||
- Извлекается из `docs/Name.md` (raw HTML) функцией `extract_man()`
|
||
- Передаётся в том же сообщении что и params/ops файлы
|
||
- Для главной страницы (Name.md) и примеров (_example.md) — без MAN
|
||
|
||
### Параметры LLM
|
||
- `max_tokens`: 4096 → **8192**
|
||
- `temperature`: 0.15 (без изменений)
|
||
- `model`: gpt-oss-120b (без изменений)
|
||
|
||
### Интеграция с 04_build_and_publish_docs.sh
|
||
Вариант A: DOCS_GEN_DIR → `docs_llm/`. Скрипт копирует guides/, 30_registry/, index.md в docs_llm/.
|
||
|
||
## Вопрос: subresource-страницы обрабатывать LLM?
|
||
postgres_user.md, postgres_database.md, postgres_backup.md — их структура как у _params_create.md.
|
||
Пока копировать as-is или тоже через LLM?
|