- Go 98.8%
- Shell 1.2%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
Предыдущая модель плохо держала русский («Лох — это честно. Принёс.» — бессмыслица). Longcat пишет заметно живее. Ключевое: модель thinking, и тесный MaxTokens обрывал её на полуслове — reasoning съедал весь бюджет, content приходил null с finish_reason=length. Лимит поднят до 12000: thinking-моделям нужен запас, незанятые токены дешевле сорванного ответа. Таймаут запроса поднят до 180 с. Заодно ужесточена география в промпте: на «как жизнь в Ризене?» модель приплетала Партизанск (БКГ) и НЛО (Нью-Мехико). Теперь выдержки канона подаются с явным указанием страны, а в персоне — требование не переносить детали одной страны в другую. Проверено вживую: «ты лох» → «Зато я знаю лор, а ты — нет»; «как жизнь в Ризене?» → ответ по Жабино, Калибрийскому заливу и Хеллеру. |
||
| cmd/probe | ||
| data | ||
| deploy | ||
| docs | ||
| internal | ||
| .env.example | ||
| .gitignore | ||
| go.mod | ||
| go.sum | ||
| README.md | ||
Скаперблядь
RP-бот для отдельной темы группового чата «Урбанойд». Не ассистент и не справочник, а участник группы: знает канон мира, помнит, что уже происходило, отвечает коротко и со своим мнением, умеет грубить в ответ и иногда сам влезает в разговор.
Отдельный процесс. Своя SQLite. Наружу — только Telegram и модели. Ни шелла, ни файлов сервера, ни тулов: игрокам нечего ломать.
Как это работает
сообщение → [Jev: что тут?] → код решает → контекст из БД → deepseek: реплика
- Jev (System One) — триггер и арбитр, а не генератор. На вход state + типизированные вопросы, на выход Choice/Score/Noul. Выбирает из кандидатов, которых готовит код: триггер, реакцию, экстракт факта, вердикт о конфликте. Текста не порождает и в БД не пишет.
- Код владеет всеми решениями: адресовано ли, влезать ли, ставить ли реакцию, какой факт вытеснить. Jev упал — мир не меняется, сообщение проходит мимо.
- deepseek пишет саму реплику. Один вызов на ответ, без тул-цикла.
Контекст и кеш
Собирается на каждый ответ из БД — истории в процессе нет, сбрасывать нечего. Порядок от стабильного к волатильному, чтобы префикс кешировался:
| слой | что | меняется |
|---|---|---|
| 1 | персона, характер, примеры стиля | руками |
| 2 | дайджест канона (заголовки разделов) | при импорте |
| 3 | реестр игроков | редко |
| 4 | мир-факты | append-only |
| 5 | rolling-саммари | по счётчику сообщений |
| 6 | сырое окно | каждый запрос |
| 7 | выдержки канона и вспомненная переписка | каждый запрос |
Слои 1–4 сериализуются канонически (фиксированный порядок, никаких таймстампов), поэтому основной промпт кешируется. Per-message retrieval уезжает в хвост, а не в начало — иначе кеш рвался бы на каждом сообщении.
Прогрев вместо задержки
Как только сообщение пришло, в фоне считается всё, что стоит внешнего вызова: вектор входящего для вспоминания, эмбеддинги осевших серий переписки, чанки канона. К моменту ответа это уже в памяти — сборка контекста мгновенная. Серии подряд идущих сообщений одного автора эмбеддятся целиком: человек, разбивший мысль на три сообщения, оставил одну мысль.
Длина ответа
Решает модель. Код подаёт длину входящего числом как ориентир и ничего не обрезает постфактум: жёсткие лимиты на практике обрывают генерацию на полуслове.
Факты и откат
Конфликт ищется по паре subject+predicate, разрешается автоматически
(ошибки допустимы). Ничего не удаляется: старый факт получает status=superseded
и valid_to, откат возвращает его. Канон (data/lore/*.md) read-only —
бот его не переписывает, новые события живут отдельным слоем.
Запуск
cp .env.example .env # заполнить
go build -o skaperblyad ./cmd/skaperblyad
./skaperblyad --env=dev --reindex # залить канон в БД и выйти
./skaperblyad --env=dev # запустить
Перед живым запуском удобно прикинуть поведение без Telegram — пробник гоняет тот же конвейер на одном сообщении и печатает решение и реплику:
go run ./cmd/probe -reply "Скаперблядь, что там у Калибрии с заводами?"
Проверки: go build ./... && go vet ./... && go test ./... (сеть не нужна).
Деплой
sudo deploy/install.sh # первый раз: юзер, /opt/skaperblyad, systemd
sudo deploy/update.sh # потом: pull, сборка, переиндексация, рестарт
Раскладка
cmd/skaperblyad |
точка входа, флаги --env, --reindex |
cmd/probe |
прогон конвейера на одном сообщении без Telegram |
deploy/ |
systemd-юнит и скрипты установки/обновления |
internal/config |
окружение, дефолты |
internal/store |
SQLite: сообщения, игроки, факты, сводки, журнал реакций |
internal/lore |
разбор канона на чанки, дайджест, поиск, эмбеддинги |
internal/llm |
Jev (System One) и генератор речи; интерфейсы для тестов |
internal/router |
вопросы Jev о сообщении, вероятность вклинивания |
internal/facts |
экстракт и разрешение конфликтов фактов |
internal/prompt |
сборка контекста по слоям |
internal/reaction |
частота реакций и их лог |
internal/compact |
rolling-саммари по счётчику сообщений |
internal/bot |
тонкий адаптер Telegram |
internal/dialog |
мозг: триггеры → контекст → ответ |
data/lore |
канон мира, перенесён из RP-профиля |
data/persona |
характер |
docs/architecture.md |
решения и обоснования |
Правила
- бот — отдельный процесс, минимум прав, без доступа к чему-либо, кроме своей БД;
- внятные имена; техдолг не копим;
- бинарники в git не кладём.