alpha v.2

USAGE_GUIDE.md

@@ -2,7 +2,7 @@
 
 ## Что это
 
-Linux Command GPT (`lcg`) преобразует описание на естественном языке в готовую Linux‑команду. Инструмент поддерживает сменные провайдеры LLM (Ollama или Proxy), управление системными промптами, историю за сессию, сохранение результатов и интерактивные действия над сгенерированной командой.
+Linux Command GPT (`lcg`) преобразует описание на естественном языке в готовую Linux‑команду. Инструмент поддерживает сменные провайдеры LLM (Ollama или Proxy), управление системными промптами, историю запросов, сохранение результатов, HTTP сервер для просмотра результатов и интерактивные действия над сгенерированной командой.
 
 ## Требования
 
@@ -66,17 +66,21 @@ lcg --file /path/to/context.txt "хочу вывести список дирек
 | Переменная | Значение по умолчанию | Назначение |
 | --- | --- | --- |
 | `LCG_HOST` | `http://192.168.87.108:11434/` | Базовый URL API провайдера (для Ollama поставьте, например, `http://localhost:11434/`). |
+| `LCG_PROXY_URL` | `/api/v1/protected/sberchat/chat` | Относительный путь эндпоинта для Proxy провайдера. |
 | `LCG_COMPLETIONS_PATH` | `api/chat` | Относительный путь эндпоинта для Ollama. |
-| `LCG_MODEL` | `codegeex4` | Имя модели у выбранного провайдера. |
+| `LCG_MODEL` | `hf.co/yandex/YandexGPT-5-Lite-8B-instruct-GGUF:Q4_K_M` | Имя модели у выбранного провайдера. |
 | `LCG_PROMPT` | См. значение в коде | Содержимое системного промпта по умолчанию. |
 | `LCG_API_KEY_FILE` | `.openai_api_key` | Файл с API‑ключом (для Ollama/Proxy не требуется). |
-| `LCG_RESULT_FOLDER` | `$(pwd)/gpt_results` | Папка для сохранения результатов. |
+| `LCG_RESULT_FOLDER` | `~/.config/lcg/gpt_results` | Папка для сохранения результатов. |
 | `LCG_PROVIDER` | `ollama` | Тип провайдера: `ollama` или `proxy`. |
 | `LCG_JWT_TOKEN` | пусто | JWT токен для `proxy` провайдера (альтернатива — файл `~/.proxy_jwt_token`). |
 | `LCG_PROMPT_ID` | `1` | ID системного промпта по умолчанию. |
-| `LCG_TIMEOUT` | `120` | Таймаут запроса в секундах. |
+| `LCG_TIMEOUT` | `300` | Таймаут запроса в секундах. |
 | `LCG_RESULT_HISTORY` | `$(LCG_RESULT_FOLDER)/lcg_history.json` | Путь к JSON‑истории запросов. |
+| `LCG_PROMPT_FOLDER` | `~/.config/lcg/gpt_sys_prompts` | Папка для хранения системных промптов. |
 | `LCG_NO_HISTORY` | пусто | Если `1`/`true` — полностью отключает запись/обновление истории. |
+| `LCG_SERVER_PORT` | `8080` | Порт для HTTP сервера просмотра результатов. |
+| `LCG_SERVER_HOST` | `localhost` | Хост для HTTP сервера просмотра результатов. |
 
 Примеры настройки:
 
@@ -104,7 +108,9 @@ lcg [глобальные опции] <описание команды>
 - `--file, -f string` — прочитать часть запроса из файла и добавить к описанию.
 - `--sys, -s string` — системный промпт (содержимое или ID как строка). Если не задан, используется `--prompt-id` или `LCG_PROMPT`.
 - `--prompt-id, --pid int` — ID системного промпта (1–5 для стандартных, либо ваш кастомный ID).
-- `--timeout, -t int` — таймаут запроса в секундах (по умолчанию 120).
+- `--timeout, -t int` — таймаут запроса в секундах (по умолчанию 300).
+- `--no-history, --nh` — отключить запись/обновление истории для текущего запуска.
+- `--debug, -d` — показать отладочную информацию (параметры запроса и промпты).
 - `--version, -v` — вывести версию.
 - `--help, -h` — помощь.
 
@@ -122,10 +128,14 @@ lcg [глобальные опции] <описание команды>
 - `lcg history delete <id>` (`-d`): удалить запись истории по `index` (с перенумерацией).
 - Флаг `--no-history` (`-nh`) отключает запись истории для текущего запуска и имеет приоритет над `LCG_NO_HISTORY`.
 - `lcg prompts ...` (`-p`): управление системными промптами:
-  - `lcg prompts list` (`-l`) — список всех промптов.
+  - `lcg prompts list` (`-l`) — список всех промптов с содержимым в читаемом формате.
+  - `lcg prompts list --full` (`-f`) — полный вывод содержимого без обрезки длинных строк.
   - `lcg prompts add` (`-a`) — добавить пользовательский промпт (по шагам в интерактиве).
   - `lcg prompts delete <id>` (`-d`) — удалить пользовательский промпт по ID (>5).
 - `lcg test-prompt <prompt-id> <описание>` (`-tp`): показать детали выбранного системного промпта и протестировать его на заданном описании.
+- `lcg serve-result` (`serve`): запустить HTTP сервер для просмотра сохраненных результатов:
+  - `--port, -p` — порт сервера (по умолчанию из `LCG_SERVER_PORT`)
+  - `--host, -H` — хост сервера (по умолчанию из `LCG_SERVER_HOST`)
 
 ### Подробные объяснения (v/vv/vvv)
 
@@ -165,7 +175,7 @@ lcg [глобальные опции] <описание команды>
 
 ### Таймауты
 
-- Стартовые значения: локально с Ollama — **60–120 сек**, удалённый proxy — **120–300 сек**.
+- Стартовые значения: локально с Ollama — **120–300 сек**, удалённый proxy — **300–600 сек**.
 - Увеличьте таймаут для больших моделей/длинных запросов. Флаг `--timeout` перекрывает `LCG_TIMEOUT` на время запуска.
 - Если часто видите таймауты — проверьте здоровье API (`lcg health`) и сетевую доступность `LCG_HOST`.
 
@@ -178,7 +188,17 @@ lcg [глобальные опции] <описание команды>
 
 ## Системные промпты
 
-Встроенные (ID 1–5):
+### Управление промптами
+
+Системные промпты хранятся в папке, указанной в переменной `LCG_PROMPT_FOLDER` (по умолчанию: `~/.config/lcg/gpt_sys_prompts`).
+
+**Логика загрузки:**
+
+- Если файл `sys_prompts` **не существует** — создается файл с системными промптами (ID 1–5) и промптами подробности (ID 6–8)
+- Если файл `sys_prompts` **существует** — загружаются все промпты из файла
+- **Промпты подробности** (v/vv/vvv) сохраняются в том же файле с ID 6, 7, 8
+
+### Встроенные промпты (ID 1–5)
 
 | ID | Name | Описание |
 | --- | --- | --- |
@@ -188,16 +208,61 @@ lcg [глобальные опции] <описание команды>
 | 4 | linux-command-verbose | Команда с подробными объяснениями флагов и альтернатив. |
 | 5 | linux-command-simple | Простые команды, избегать сложных опций. |
 
-Пользовательские промпты сохраняются в `~/.lcg_prompts.json` и доступны между запусками.
+### Промпты подробности (ID 6–8)
+
+| ID | Name | Описание |
+| --- | --- | --- |
+| 6 | verbose-v | Подробный режим (v) - детальное объяснение команды |
+| 7 | verbose-vv | Очень подробный режим (vv) - исчерпывающее объяснение с альтернативами |
+| 8 | verbose-vvv | Максимально подробный режим (vvv) - полное руководство с примерами |
+
+### Веб-интерфейс управления
+
+Через HTTP сервер (`lcg serve-result`) доступно полное управление промптами:
+
+- **Просмотр всех промптов** (встроенных и пользовательских)
+- **Редактирование любых промптов** (включая встроенные)
+- **Добавление новых промптов**
+- **Удаление промптов**
+- **Автоматическое сохранение** в файл `sys_prompts`
 
 ## Сохранение результатов
 
-При выборе действия `s` ответ сохраняется в `LCG_RESULT_FOLDER` (по умолчанию: `./gpt_results`) в файл вида:
+При выборе действия `s` ответ сохраняется в `LCG_RESULT_FOLDER` (по умолчанию: `~/.config/lcg/gpt_results`) в файл вида:
 
 ```text
 gpt_request_<MODEL>_YYYY-MM-DD_HH-MM-SS.md
 ```
 
+## HTTP сервер для просмотра результатов
+
+Команда `lcg serve-result` запускает веб-сервер для удобного просмотра всех сохраненных результатов:
+
+```bash
+# Запуск с настройками по умолчанию
+lcg serve-result
+
+# Запуск на другом порту
+lcg serve-result --port 9090
+
+# Запуск на другом хосте
+lcg serve-result --host 0.0.0.0 --port 8080
+
+# Использование переменных окружения
+export LCG_SERVER_PORT=3000
+export LCG_SERVER_HOST=0.0.0.0
+lcg serve-result
+```
+
+### Возможности веб-интерфейса
+
+- **Главная страница** (`/`) — отображает все сохраненные файлы с превью
+- **Статистика** — количество файлов, файлы за последние 7 дней
+- **Просмотр файлов** (`/file/{filename}`) — отображение содержимого конкретного файла
+- **Современный дизайн** — адаптивный интерфейс с карточками файлов
+- **Сортировка** — файлы отсортированы по дате изменения (новые сверху)
+- **Превью содержимого** — первые 200 символов каждого файла
+
 Структура файла (команда):
 
 - `# <заголовок>` — H1, это ваш запрос, при длине >120 символов обрезается до 116 + `...`.
@@ -264,6 +329,19 @@ lcg health
 lcg models
 ```
 
+1. HTTP сервер для просмотра результатов:
+
+```bash
+# Запуск сервера
+lcg serve-result
+
+# Запуск на другом порту
+lcg serve-result --port 9090
+
+# Запуск на всех интерфейсах
+lcg serve-result --host 0.0.0.0 --port 8080
+```
+
 ## История
 
 `lcg history` выводит историю текущего процесса (не сохраняется между запусками, максимум 100 записей):
@@ -279,6 +357,8 @@ lcg history list
 - Копирование не работает: установите `xclip` или `xsel`.
 - Нет допуска к папке результатов: настройте `LCG_RESULT_FOLDER` или права доступа.
 - Для `ollama`/`proxy` API‑ключ не нужен; команды `update-key`/`delete-key` просто уведомят об этом.
+- HTTP сервер не запускается: проверьте, что порт свободен, используйте `--port` для смены порта.
+- Веб-интерфейс не отображает файлы: убедитесь, что в `LCG_RESULT_FOLDER` есть `.md` файлы.
 
 ## JSON‑история запросов