# History — журнал проекта DrHider Хронологический журнал: планы, вопросы/ответы ревьюеров (Sonnet, Opus), реализации фич (по версиям), диагностика, тесты и бенчмарки. **Правило:** любая находка/решение/факт записывается сюда сразу, в момент обнаружения. ## Структура (папки по темам) | Папка | Что внутри | |-------|-----------| | [base/](base/) | Ранняя документация и первоначальная настройка проекта | | [plans/](plans/) | Планы и проектирование (аудит, архитектуры v3/v3.1, планы реализации) | | [sonnet/](sonnet/) | Все вопросы к Sonnet и его ответы (обсуждения, ревью, Q&A) | | [opus/](opus/) | Запросы к Opus и его ответы (валидация MSS-clamping, ревью документации) | | [llm/](llm/) | Всё про LLM-часть: метрики, статистика в UI, чанкинг для полного покрытия | | [sse/](sse/) | SSE-события: отлов отключения клиента, hop-by-hop заголовки | | [infra/](infra/) | Инфраструктура: кластер, ingress, RST-диагностика, HTTP/2, ВМ-буфер | | [ux-frontend/](ux-frontend/) | Фичи фронтенда: таймеры, имена файлов, ZIP-раскрытие, лимиты, прерывание/ETA | | [upload/](upload/) | Загрузка файлов: диагностика, лимиты, стресс-тесты | | [code-fixes/](code-fixes/) | Исправления кода по версиям (баги, оптимизация, безопасность, логирование) | | [tests/](tests/) | Тесты и бенчмарки: замеры UI, обфускация, нагрузка | --- ## base/ — первоначальная настройка - **2026-07-11-initial-setup.md** — создание проекта DrHider на платформе Штурвал (Managed Flask, URL, входные точки). - **2026-07-12-documentation.md** — создание полной документации после рефакторинга (список документируемых файлов). ## plans/ — планы и проектирование - **2026-07-12-audit-and-plan.md** — полный аудит проекта и план рефакторинга под Managed Flask. - **2026-07-12-v3-plan.md** — план v3: универсальная архитектура (убрать жёсткий список типов сущностей). - **2026-07-12-v3-done.md** — итоги v3: переход на Markdown-пайплайн + универсальное LLM-обнаружение. - **2026-07-12-v3.1-plan.md** — план v3.1: пофайловая обработка + прогресс в таблице (решение таймаута). - **2026-08-24-implementation-plan-for-flash.md** — план для агента-кодера (Flash): TTL-фикс, трекинг файлов, прерывание, ETA, UI. - **2026-08-24-folder-select-plan.md** — план для Flash: кнопка «Выбрать папку» (webkitdirectory, рекурсивно, относительный путь сохраняется). ## sonnet/ — обсуждения с Sonnet (вопросы и ответы) **12–13 июля — проектирование:** - **2026-07-12-sonnet-query.md** + **2026-07-12-sonnet-response.md** — вопрос/ответ: универсальная архитектура DrHider (6 вопросов → 6 ответов → карта изменений). - **2026-07-12-sonnet-query-timeout.md** + **2026-07-12-sonnet-response-timeout.md** — диагностика ERR_TIMED_OUT в новом окне браузера (dev-сервер: 6 потоков заняты keep-alive). - **2026-07-12-sonnet-query-v2.md** + **2026-07-12-sonnet-response-v2.md** — улучшение LLM-промпта (двухфазная инструкция). - **2026-07-12-sonnet-query-v3-numbering.md** + **2026-07-12-sonnet-response-v3-numbering.md** — нумерация вместо генерации фейков (прозрачный аудит). - **2026-07-12-sonnet-query-v4-hybrid.md** + **2026-07-12-sonnet-response-v4-hybrid.md** — гибридный формат замен «шаблон + номер» (вариант В). - **2026-07-13-sonnet-query-architecture.md** + **2026-07-13-sonnet-response-architecture.md** — архитектура пофайловой обработки с одним ZIP (вариант А + блокирующий /process). - **2026-07-13-sonnet-query-obfuscation-tokens.md** — запрос: анализ обфускации. - **2026-07-13-sonnet-response-obfuscation-analysis.md** — анализ обфускации (TMP-файлы vs код). - **2026-07-13-sonnet-response-obfuscation-bugs.md** — анализ багов обфускации и их фикс. **20 августа — ревью скорости и сбоев:** - **2026-08-20-sonnet-query-review-speed.md** — промпт: код-ревью drhider (скорость + объяснение сбоев, ограничение файлов). - **2026-08-20-sonnet-query-review-speed-followup.md** — follow-up вопросы по спорным пунктам ревью (В1–В4). - **2026-08-20-sonnet-review-qa.md** — Q&A: вопросы → ответы Sonnet → решения по ревью. **20 августа — LLM-чанкинг:** - **2026-08-20-sonnet-query-llm-pattern.md** — вопрос: как лучше организовать LLM-покрытие всех документов. - **2026-08-20-sonnet-query-llm-followup.md** — 6 уточнений перед внедрением (чанкинг, дедуп, верификация, промпт). - **2026-08-20-sonnet-llm-qa.md** — сводный Q&A по LLM-чанкингу (схема + ответы У.1–У.6 + решение). **20 августа — ускорение:** - **2026-08-20-sonnet-query-honest-speed.md** — честный вопрос: можно ли ускорить без риска устойчивости. ## opus/ — обсуждения с Opus - **2026-07-13-opus-query-mss-clamping.md** — запрос: валидация плана MSS Clamping. - **2026-07-13-opus-response-mss-clamping.md** — ответ: валидация плана MSS Clamping. - **2026-07-13-opus-response-document-review.md** — проверка PROBLEM-AND-SOLUTION.md на ошибки. - **2026-07-13-opus-response-final-review.md** — финальная проверка PROBLEM-AND-SOLUTION.md. ## llm/ — LLM-часть - **2026-08-19-llm-metrics.md** — v0.0.34: вывод токенов и времени LLM. - **2026-08-19-llm-stats-block.md** — v0.0.37: крупный блок статистики LLM в UI. - **2026-08-20-llm-full-chunking.md** — v0.0.57: LLM обрабатывает ВСЕ данные (пофайловый чанкинг 6000/overlap 500, параллельность 4, дедуп + верификация). ## sse/ — SSE-события - **2026-07-14-sse-generator-exit.md** — v0.0.18: отлов отключения клиента SSE (GeneratorExit/BrokenPipe). - **2026-07-14-hop-by-hop-connection.md** — v0.0.21→0.0.22: Waitress запрещает hop-by-hop заголовок `Connection: close`. ## infra/ — инфраструктура - **2026-07-14-browser-rst-debug.md** — диагностика ERR_CONNECTION_RESET в браузере. - **2026-07-15-cluster-dump.md** — снимок кластера (4 ноды, taints, состояние). - **2026-07-15-rst-root-cause.md** — итоговая диагностика ERR_CONNECTION_RESET (v0.0.29). - **2026-08-19-remove-process-names-http2.md** — v0.0.46: удалён process_names + проблема git push через HTTP/2. - **2026-08-21-pattern-vm-buffer-pull-plan.md** — план: перенос паттерна «ВМ-буфер + pull» в drhider. - **2026-08-21-vm-files-api-plan.md** — план: универсальный файловый сервис на ВМ (API). - **2026-08-21-vm-upload-implemented.md** — v0.0.58: ВМ-загрузка реализована (паттерн «ВМ-буфер + pull»). - **2026-08-24-two-clusters-deploy.md** — деплой на двух кластерах: iot-naeel (актуальный, DNS → .151) и naeel-test-3 (не погашен). ## ux-frontend/ — фичи фронтенда - **2026-08-19-live-timer-llm.md** — v0.0.38: живой таймер обработки + индикация ИИ. - **2026-08-19-live-filename.md** — v0.0.40: имя файла в live-блоке + сброс итогов. - **2026-08-19-file-time.md** — v0.0.41: время на конкретный файл в колонке «Статус». - **2026-08-19-zip-expand-frontend.md** — v0.0.33: раскрытие ZIP в таблицу (фронтенд). - **2026-08-19-zip-filter-docs.md** — v0.0.35: фильтр документов при раскрытии ZIP. - **2026-08-19-ux-fixes.md** — v0.0.49: индикатор распаковки, разделение фаз (1/2, 2/2), таймауты SSE. - **2026-08-20-upload-limits.md** — v0.0.50: лимиты загрузки (>100МБ/файл, >1ГБ сумма) + красная подсветка в таблице. - **2026-08-24-interrupt-eta-design.md** — дизайн: TTL-фикс + прерывание с сохранением + оценка времени + UI. - **2026-08-24-interrupt-eta-implemented.md** — v0.0.63: реализовано прерывание с сохранением + ETA + UI-таблица. - **2026-08-24-time-tickers-estimates.md** — v0.0.64–0.0.65: тикер текущего файла на всех этапах, мгновенные оценки времени по файлам и суммарно. - **2026-08-24-folder-select-implemented.md** — v0.0.68: кнопка «Выбрать папку» (webkitdirectory, рекурсивно, относительный путь). - **2026-08-24-folder-zip-not-lost.md** — v0.0.69: архивы из папки без документов не теряются (добавляются как есть); раскрытие zip с документами; склонение счётчика. - **2026-08-24-v074-cancel-extract.md** — v0.0.74: отмена в extract-фазе (не ждём все .doc). - **2026-08-24-v073-security-fixes.md** — v0.0.73: 6 фиксов по ревью Соннета (SSRF, path traversal, слабый SID, proc_error, zip-бомба, self-XSS); 1 отклонено (cleanup), 5 отложено. - **2026-08-24-pull-retry-limit-counter.md** — v0.0.72: ретраи pull из ВМ, корректная ошибка лимита сессии, счётчик дедупа. - **2026-08-24-code-review-sonnet.md** — код-ревью Соннета: 15 багов (SSRF, path traversal, слабый SID, zip-бомба и др.), промпт в docs/code-review-sonnet.md. - **2026-08-24-upload-logic-schema.md** — подробная схема логики загрузки + найденные баги/несоответствия. - **2026-08-24-help-button-limits-text.md** — v0.0.70: заметная кнопка HELP (вместо «?») + пояснение статуса «пропущен» в ограничениях. - **2026-08-24-ui-locks-session-freeze.md** — v0.0.66: блокировки UI (выбор/удаление) на время работы, заморозка сессии + кнопка «Новая сессия». ## upload/ — загрузка файлов - **2026-08-19-upload-delay.md** — диагностика медленной/нестабильной загрузки + v0.0.43 (таймаут 300с). - **2026-08-23-test-upload-only-plan.md** — план: тест-режим «только загрузка» (для Флаша). - **2026-08-23-upload-stress-test.md** — тесты загрузки и стресс (v0.0.59–0.0.60, кластер naeel-test-3). - **2026-08-24-upload-limits.md** — v0.0.62: лимиты 50 МБ на файл, 500 МБ на сессию. ## code-fixes/ — исправления кода (по версиям) - **2026-08-18-fix-review-bugs.md** — v0.0.32: фиксы по ревью обфускатора. - **2026-08-19-replacer-optimization.md** — v0.0.39: оптимизация apply_replacements (однопроходная замена, один regex). - **2026-08-20-logging.md** — v0.0.51: максимальное логирование (LOG_LEVEL env) + детальные логи SSE/воркера. - **2026-08-20-logging-file.md** — v0.0.52: файловый лог /tmp/drhider.log (для kubectl exec). - **2026-08-20-broken-files.md** — v0.0.53: устойчивость к битым файлам (воркер не падает, битые пропускаются). - **2026-08-20-v1-v2-implemented.md** — v0.0.54: В2 (фикс кракозябр имён zip) + В1 (фильтр таблиц, эффект≈0). - **2026-08-20-honest-answer-and-A-implemented.md** — v0.0.55: честный ответ Sonnet + реализация А (threading .doc, кэш regex). - **2026-08-20-csv-out-of-zip.md** — v0.0.56: КРИТИЧНО — mapping.csv (ключ расшифровки) убран из ZIP. - **2026-08-24-zip-name-cyrillic-frontend.md** — v0.0.67: фикс кириллических имён из ZIP на фронте (UTF-8 без флага → CP866-мусор), согласовано с бэком. ## tests/ — тесты и бенчмарки - **2026-08-19-ui-5runs-benchmark.md** — v0.0.49: бенчмарк UI, 5 прогонов DownLoads.zip (18 файлов, замеры времени). - **2026-08-23-obfuscation-tests.md** — тесты реальной обфускации и фикс .doc (v0.0.60–0.0.61, корпус /mnt/y/T). - **2026-08-24-tests-upload-and-obfuscation.md** — тесты загрузки и обфускации (v0.0.62, лимиты, ВМ-буфер). - **2026-08-24-test-batch-v067.md** — тесты v0.0.67: загрузка, лимит 50МБ, ZIP-кириллица, ETA, прерывание с частичным сохранением. --- ## Соглашение об именах `ГГГГ-ММ-ДД-тема.md` (иногда с версией). В начале каждого файла — дата и версия/статус. При сортировке файл относится в папку по главной теме (имя файла/содержание), не по дате.