textmachine/docs/BACKEND_DEEPSEEK_REPIN_SESSION_PROMPT.md

69 lines
7.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Промт: бэкенд, вендор-сессия — пере-пин цен DeepSeek (строка 172; цены меняются 16.08 16:00 UTC)
> Выдан оркестратором №17 15.08.2026 по слову владельца («надо запостить отдельную сессию, пусть
> сходит в интернет и перечитает, что у DeepSeek обновилось»). Лёгкий класс: короткий промт,
> инлайн-приёмка; самопроверка исполнением обязательна — это путь у денег.
## 0. Какую проблему решаем
Движок резервирует и считает деньги по ручной таблице цен `backend/configs/models.yaml`
(`prices_checked: "2026-07-10"`). Вендор DeepSeek объявил с **16.08.2026 16:00 UTC** рост цен
×2.34.7 и введение time-based прайсинга (пик/офф-пик; пик 0104 и 0610 UTC, офф-пик = 50%).
Наша схема цены плоская и time-based не выражает. Пока таблица старая: потолки трат перестают
защищать (резерв считается по заниженной цене), леджер пишет неправду, сметы врут. Гейт свежести
(120 дней) промолчит до ноября — он сторожит возраст записи, не факт смены цен.
Твой результат: **таблица цен снова верна консервативной стороной** + доклад владельцу по
вариантам time-based схемы. Решение «строить ли scheduler по времени суток» НЕ твоё — только
фактура и рекомендация.
## 1. Онбординг
`CLAUDE.md` (гардрейлы: зона записи ТОЛЬКО `backend/`, ты НЕ коммитишь, `.env` не читать) →
`docs/experiments/00-provider-quirks.md` (шапка: правило двух направлений — аномалию сверяем с
вендор-докой, интерпретацию без сверки не абсорбируем) → `backend/internal/ledger/pricing.go`
(как цены едут в резерв/settle) → `backend/configs/models.yaml` (текущий пин; шапка файла несёт
ссылки на вендор-доки). Контекст решения: строка 172 единого бэклога (`docs/PROGRESS.md`).
**Эхо-протокол:** ≤10 строк «что я понял: скоуп / инварианты / не-делать» ДО работы.
## 2. Задача
1. **Вендор-чек интернетом (обязателен, это и есть заказ):** перечитай ОФИЦИАЛЬНЫЕ источники
DeepSeek — `api-docs.deepseek.com/quick_start/pricing`, страницу news/changelog об изменении
16.08, и **условия использования (ToS/Terms), если они менялись тем же релизом**. Зафиксируй
в отчёте: точные цены пик/офф-пик для `deepseek-v4-flash` и `deepseek-v4-pro` (input / output /
cache-hit / cache-write, за 1M токенов), окна времени, дату вступления, дословные цитаты с URL.
Расхождение с прогнозом строки 172 — норма, вендор первичен.
2. **Пере-пин `models.yaml` — консервативно ПИКОМ** (ратифицировано направлением, D39.136):
в плоскую схему пишутся ПИКОВЫЕ цены — потолки срабатывают раньше, а не позже; офф-пик
переплата резерва — осознанная цена простоты. `prices_checked` — на дату твоего факт-чека.
Комментарии в файле — свежими цитатами/URL (по образцу текущей шапки).
3. **Проверь исполнением, что правка данных не двигает провод:** цены живут в леджере, НЕ в
снапшоте/request_hash — `cd backend && make battery` EXIT=0 и **голден бит-в-бит** обязаны
пройти без re-capture. Если какой-то тест пинит конкретные цены фикстурой — почини фикстуру
теста (это данные теста, не гейт), но НЕ трогай голдены; красный голден = СТОП и пинг.
4. **Доклад по time-based схеме (только фактура, не стройка):** два варианта — оставить
консервативный пин пиком (текущее) против scheduler-aware волн в долины (строка 60 бэклога;
её ценность теперь ×2 COGS). Назови: какие поля схемы цен понадобились бы, где считается
резерв, что двигается. Рекомендацию дай, решение — владельца.
5. **Вахта поведением (опция, потолок $0.05):** прецедент D39.61 — DeepSeek менял ВЕСА под тем же
слагом. После 16:00 UTC 16.08 допустима мини-проба: риг классификатора из
`docs/archive/reports/EFFORT_HANDLE_2026-08-02.md` §Д8 (11 вызовов, ~$0.01) — сверить, что
поведение уровней low/high не уехало вместе с ценами. Не успеваешь/нет ключа — явно скажи в
отчёте, не молчи.
6. **ToS-изменения, если есть:** ТОЛЬКО доложить владельцу цитатами (решение по ToS — его,
правило двух направлений: интерпретацию в доки не абсорбировать).
## 3. Границы
- Зона записи: `backend/configs/models.yaml` + при нужде фикстуры тестов цен. Код НЕ трогать.
- Снапшоты/голдены/промпты не двигаются. Дерево НЕ коммитить — лендит оркестратор.
- «Заявление = команда»: каждое число отчёта — с URL-источником или командой.
- Самопроверка исполнением: батарея + пере-чтение своего диффа с установкой опровергать.
- Отчёт — пингом в `docs/PROGRESS.md` секция «Бэкенд», ТОЛЬКО append своей записи
(`git status` перед правкой; чужие секции и CURRENT-STATE не трогать).
## 4. Канал вопросов
Непонятно / вендор-факты противоречат промту → пинг оркестратору через владельца, НЕ интерпретация.