Compare commits
16 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
 subochev
|
334015a2bd | ||
|
subochev
|
c7e7c7346d | ||
|
subochev
|
dba52d22fd | ||
|
subochev
|
efdce75ee9 | ||
|
subochev
|
e251ca5326 | ||
|
subochev
|
0fb99060f9 | ||
 subochev
|
c3aaa914fb | ||
|
subochev
|
019af32bf5 | ||
|
subochev
|
85d16eccc3 | ||
|
subochev
|
bad7e13eb8 | ||
|
subochev
|
d75172434e | ||
|
subochev
|
995c5fba0e | ||
|
subochev
|
f213b139da | ||
|
subochev
|
350ef663c0 | ||
 Hermes Agent
|
f45ed0d11c | ||
|
Hermes Agent
|
8fc743860c |
@@ -9,10 +9,14 @@ jobs:
|
||||
steps:
|
||||
- name: 'Checkout'
|
||||
uses: https://github.com/actions/checkout@v4
|
||||
- name: 'Run tests'
|
||||
uses: https://git.binom.pw/subochev/devops/build-gradle@main
|
||||
with:
|
||||
target: jvmTest
|
||||
- name: 'Build jar'
|
||||
uses: https://git.binom.pw/subochev/devops/build-gradle@main
|
||||
with:
|
||||
target: shadowJar
|
||||
target: fatJar
|
||||
- name: 'Build Docker Image'
|
||||
uses: https://git.binom.pw/subochev/devops/build-docker@main
|
||||
with:
|
||||
|
||||
@@ -2,3 +2,12 @@ build/
|
||||
.gradle/
|
||||
*.jar
|
||||
!gradle/wrapper/gradle-wrapper.jar
|
||||
# локальный конфиг с секретами (ключ API) — не коммитим
|
||||
config.yaml
|
||||
|
||||
# IDE / tooling
|
||||
.idea/
|
||||
.kotlin/
|
||||
.cortexkit/
|
||||
.veai/
|
||||
|
||||
|
||||
@@ -0,0 +1,479 @@
|
||||
# Конфигурация llm-proxy (переход на YAML)
|
||||
|
||||
## Идея
|
||||
|
||||
Вместо переменных среды конфигурация задаётся YAML-файлом. В нём три блока:
|
||||
|
||||
1. **`providers`** — объявлены бэкенды (url + ключ) с нашим внутренним
|
||||
человекочитаемым `id`. По этому `id` ссылаются апстримы. Опционально —
|
||||
`max_concurrency`: лимит по умолчанию для апстримов этого провайдера.
|
||||
2. **`upstreams`** — каталог «удалённых» моделей. Каждая запись: внутренний `id`,
|
||||
ссылка на `providers[].id`, реальное имя модели у провайдера (`model`) и
|
||||
опциональный лимит конкурентности `max_concurrency`. Это и есть то, на что
|
||||
мы проксируем.
|
||||
3. **`models`** — модели, видимые клиенту. Для каждой — «витринное» имя (`name`),
|
||||
список `upstreams` (ссылки на `upstreams[].id`, можно несколько).
|
||||
|
||||
4. **`patch`** — не отдельный блок, а опциональное поле, доступное **на всех
|
||||
уровнях** (`providers`, `upstreams`, `models`). Это JSON-подобная структура
|
||||
(`kotlinx.serialization.json.JsonObject`, в YAML пишется как обычный мап),
|
||||
которая **аккуратно вмердживается** в тело запроса. Пишется нативным YAML,
|
||||
без вложенного JSON-в-строке.
|
||||
|
||||
При запросе к модели прокси берёт **первый из её `upstreams`, на котором прямо
|
||||
сейчас есть свободный слот** (по `max_concurrency`). Это позволяет держать
|
||||
провайдеров, допускающих лишь один одновременный запрос (`max_concurrency: 1`),
|
||||
рядом с многопоточными — и не превышать их лимиты.
|
||||
|
||||
**Лимит конкурентности** апстрима берётся в порядке убывания специфичности:
|
||||
`upstreams[].max_concurrency` (самый конкретный) → `providers[].max_concurrency`
|
||||
(провайдера, на который ссылается апстрим) → безлимит. Т.е. задан у модели —
|
||||
берём её; у модели нет, но есть у провайдера — берём провайдерский.
|
||||
|
||||
**Сборка тела запроса** — берём исходный JSON клиента и накладываем `patch`
|
||||
**послойно, в порядке возрастания специфичности**: сначала `provider.patch`
|
||||
(всё, что идёт через этого провайдера), затем `upstream.patch` (конкретная
|
||||
апстрим-модель),最后 `model.patch` (самый приоритетный, накладывается последним).
|
||||
Мерж — глубокий: вложенные объекты сливаются рекурсивно, скаляры/массивы по ключу
|
||||
заменяются значением из `patch`.
|
||||
|
||||
**Маршрутизация целиком опирается на внутренний учёт** — мы сами считаем, сколько
|
||||
запросов сейчас идёт на каждый апстрим, и по этим счётчикам решаем, брать запрос
|
||||
или нет. Мы **не полагаемся** на `503`/`429` от самого апстрима, чтобы узнать,
|
||||
что он перегружен: такой ответ от провайдера — это уже сбой, а не способ
|
||||
управления нагрузкой. Если выбранный апстрим всё же вернул `5xx`/`429`, мы
|
||||
освобождаем его слот и, при наличии, пробуем **следующий свободный** из списка
|
||||
модели (фейловер); если свободных не осталось — отдаём `503` от прокси.
|
||||
|
||||
## Формат файла
|
||||
|
||||
Путь к файлу: по умолчанию ищем `config.yaml` в **каталоге проекта** (текущем
|
||||
рабочем каталоге, откуда запущен процесс). Переопределить можно через env
|
||||
`CONFIG_PATH` — тогда берётся указанный путь (абсолютный или относительный).
|
||||
|
||||
> **URL — в кавычках.** В YAML значение вида `https://...` парсится как вложенный
|
||||
> мап (`https:` — ключ), поэтому `url` (и любое значение с `://`) **обязательно
|
||||
> берите в кавычки**: `url: "https://routerai.ru/api/v1"`.
|
||||
|
||||
### Блок `server` — биндинг HTTP-сервера
|
||||
|
||||
Блок `server` задаёт, **на какой интерфейс (`host`) и порт (`port`)** слушает
|
||||
прокси. Оба поля опциональны: дефолт `host: 0.0.0.0`, `port: 8100`. При старте
|
||||
сервер логирует фактический биндинг:
|
||||
`[llm-proxy] server: bind host=<host> port=<port>`.
|
||||
|
||||
```yaml
|
||||
server:
|
||||
host: 0.0.0.0 # интерфейс/адрес биндинга (дефолт 0.0.0.0)
|
||||
port: 8100 # порт (дефолт 8100)
|
||||
|
||||
# 1) Бэкенды. id — наш внутренний идентификатор (на него ссылаются апстримы).
|
||||
providers:
|
||||
- id: routerai # любая строка, уникальная в рамках файла
|
||||
url: "https://routerai.ru/api/v1"
|
||||
key: "sk-..." # Bearer-ключ; можно подставлять из env
|
||||
max_concurrency: 4 # опционально; лимит по умолчанию для апстримов
|
||||
session_header: x-opencode-session # опционально; прокси считает сессию из истории
|
||||
patch: # уровень провайдера: ко всем его запросам
|
||||
provider:
|
||||
allow_fallbacks: false
|
||||
|
||||
- id: local-llama
|
||||
url: "http://10.0.0.5:8080/v1"
|
||||
key: "" # пусто, если бэкенд без авторизации
|
||||
max_concurrency: 1 # и локалка — один слот за раз
|
||||
|
||||
# 2) Каталог апстрим-моделей. id — наш внутренний id (на него ссылаются модели).
|
||||
upstreams:
|
||||
- id: routerai-gpt4o # внутренний id апстрима
|
||||
provider: routerai # ссылка на providers[].id
|
||||
model: gpt-4o # реальное имя модели у провайдера
|
||||
max_concurrency: 4 # опционально; сколько одновременных запросов
|
||||
# допустимо (null/0 = безлимит)
|
||||
patch: # уровень апстрима
|
||||
provider:
|
||||
ignore: [deepseek]
|
||||
|
||||
- id: local-qwen
|
||||
provider: local-llama
|
||||
model: qwen2.5-72b-instruct
|
||||
max_concurrency: 1 # однослотовый провайдер: 1 запрос за раз
|
||||
|
||||
# 3) Модели, видимые клиенту.
|
||||
models:
|
||||
- name: my-gpt # имя, под которым клиент запрашивает модель
|
||||
upstreams: # порядок = приоритет: сначала локальная видюха,
|
||||
- local-qwen # потом (фоллбэк) внешний провайдер
|
||||
- routerai-gpt4o
|
||||
patch: # уровень модели (накладывается последним)
|
||||
reasoning:
|
||||
enabled: false
|
||||
|
||||
- name: deepseek-fast-no-think
|
||||
upstreams:
|
||||
- routerai-gpt4o
|
||||
patch:
|
||||
reasoning:
|
||||
enabled: false
|
||||
|
||||
- name: local-qwen-only # только локалка, без фоллбэка
|
||||
upstreams:
|
||||
- local-qwen
|
||||
# patch необязателен на любом уровне — можно не указывать
|
||||
```
|
||||
|
||||
> **Приоритет/фоллбэк.** Порядок записей в `upstreams` модели — это приоритет:
|
||||
> прокси берёт **первый свободный по порядку**. Типовой сценарий — сначала своя
|
||||
> локальная видюха (`max_concurrency: 1`, занята → следующий), а внешний провайдер
|
||||
> идёт вторым и принимает запрос, только когда локалка занята (или упала).
|
||||
> Чтобы внешний НЕ использовался, пока локалка свободна, — просто ставь локалку
|
||||
> первой; фоллбэк сработает автоматически при `claim() == null` у локалки.
|
||||
|
||||
`patch` опционален на **любом** уровне (`providers` / `upstreams` / `models`):
|
||||
если ни одного нет — запрос проксируется как есть (исходное тело клиента).
|
||||
|
||||
### Сессия по истории (`session_header`)
|
||||
|
||||
`providers[].session_header` (опционально) — имя HTTP-заголовка, который прокси
|
||||
**вычисляет сам** из истории сообщений и ставит в запрос к этому провайдеру.
|
||||
Нужно для API, требующих стабильный идентификатор сессии (например,
|
||||
`x-opencode-session`), когда клиент его не шлёт или шлёт не то.
|
||||
|
||||
```yaml
|
||||
providers:
|
||||
- id: some-provider
|
||||
url: "https://.../v1"
|
||||
session_header: x-opencode-session
|
||||
```
|
||||
|
||||
Как считается id:
|
||||
|
||||
1. Берётся финальное тело запроса (после всех `patch`), из него — `messages`.
|
||||
2. Цепочка **инкрементальных SHA-256 префикс-хэшей** начинается с первого
|
||||
`user`-сообщения (ведущий `system`-промпт игнорируется: он обычно одинаков
|
||||
у всех сессий клиента и как признак сессии бесполезен).
|
||||
3. В реестре сессий ищется **наибольший общий префикс** (LCP) с уже виденной
|
||||
историей. Нашли — используется id той сессии; не нашли — создаётся новая
|
||||
(`id` = хэш всей истории на первом ходу).
|
||||
4. Заголовок ставится **всегда** (клиентское значение перезаписывается).
|
||||
|
||||
Итог: пока история одной сессии растёт (дописываются assistant/user-сообщения),
|
||||
id не меняется; разные диалоги получают разные id.
|
||||
|
||||
> **Ограничения.** Реестр живёт в памяти (LRU: 1000 сессий / 6 часов) — при
|
||||
> рестарте прокси активные сессии получат новый id. Обрезка/суммаризация
|
||||
> истории рвёт общий префикс → сессия распадётся на новую. Диалоги с
|
||||
> одинаковым первым `user`-сообщением неразличимы (склеятся).
|
||||
|
||||
### Обработка think-тегов (`think_tags`)
|
||||
|
||||
Некоторые провайдеры (например, **minimax**) отдают рассуждения модели не в
|
||||
отдельном поле `reasoning_content`, а прямо в `content`, обернув их тегами
|
||||
`<think>…</think>`. Флажок `think_tags` (опционально) разрешает прокси разрезать
|
||||
такой ответ и разложить его по полям.
|
||||
|
||||
Поле доступно на двух уровнях:
|
||||
|
||||
- `providers[].think_tags` — правило по умолчанию для всех апстримов провайдера;
|
||||
- `upstreams[].think_tags` — необязательное переопределение на конкретной
|
||||
апстрим-модели.
|
||||
|
||||
Значения (строки):
|
||||
|
||||
| Значение | Поведение |
|
||||
|---|---|
|
||||
| `off` | дефолт: ответ не меняется, теги остаются в `content` |
|
||||
| `split` | блоки `<think>…</think>` вырезаются из `content`, их текст уходит в `reasoning_content` |
|
||||
| `strip` | блоки вырезаются и выбрасываются — клиент рассуждений не видит |
|
||||
|
||||
Разбор значения толерантный: `true` ≡ `split`, `false` ≡ `off`; любое
|
||||
неизвестное/пустое значение трактуется как `off` (прокси не падает).
|
||||
|
||||
Приоритет резолва — по убыванию специфичности: `upstreams[].think_tags` (самый
|
||||
конкретный) → `providers[].think_tags` → `off`. То есть значение апстрима
|
||||
перекрывает провайдерское.
|
||||
|
||||
```yaml
|
||||
providers:
|
||||
- id: minimax
|
||||
url: "https://api.minimax.io/v1"
|
||||
key: "${MINIMAX_API_KEY}"
|
||||
think_tags: split # дефолт для всех апстримов провайдера
|
||||
|
||||
upstreams:
|
||||
- id: minimax-m1
|
||||
provider: minimax
|
||||
model: MiniMax-M1 # наследует split от провайдера
|
||||
|
||||
- id: minimax-text-only
|
||||
provider: minimax
|
||||
model: MiniMax-Text-01
|
||||
think_tags: strip # переопределение: рассуждения выбрасываем
|
||||
```
|
||||
|
||||
Работает и в стриме, и в обычном (non-stream) ответе. Тег может прийти
|
||||
разрезанным между чанками SSE — прокси держит хвост, который может оказаться
|
||||
началом тега, и не отдаёт его клиенту до разрешения, поэтому огрызок тега не
|
||||
утечёт. Незакрытый `<think>` в конце потока трактуется как «всё после него —
|
||||
рассуждения». Если `content` не строка (мультимодальный массив частей) — ответ
|
||||
не трогаем. Без флажка (`off`) ответ идёт байт-в-байт как раньше.
|
||||
|
||||
### Пример сборки тела (многослойный `patch`)
|
||||
|
||||
Берём модель `my-gpt` (из примера выше), маршрут уходит на апстрим
|
||||
`routerai-gpt4o` (провайдер `routerai`). Клиент шлёт:
|
||||
|
||||
```json
|
||||
{
|
||||
"model": "my-gpt",
|
||||
"messages": [{ "role": "user", "content": "привет" }],
|
||||
"temperature": 0.7
|
||||
}
|
||||
```
|
||||
|
||||
Слои `patch`, накладываемые в порядке `provider → upstream → model`:
|
||||
|
||||
| Слой | Что добавляет |
|
||||
|---|---|
|
||||
| `providers.routerai.patch` | `provider.allow_fallbacks = false` |
|
||||
| `upstreams.routerai-gpt4o.patch` | `provider.ignore = ["deepseek"]` |
|
||||
| `models.my-gpt.patch` | `reasoning.enabled = false` |
|
||||
|
||||
Плюс подмена `model: "my-gpt"` → `model: "gpt-4o"` (реальное имя апстрима).
|
||||
Глубокий мерж сливает `provider` из двух слоёв в один объект. **Итоговое тело**,
|
||||
уходящее на `https://routerai.ru/api/v1/chat/completions`:
|
||||
|
||||
```json
|
||||
{
|
||||
"model": "gpt-4o",
|
||||
"messages": [{ "role": "user", "content": "привет" }],
|
||||
"temperature": 0.7,
|
||||
"provider": {
|
||||
"allow_fallbacks": false,
|
||||
"ignore": ["deepseek"]
|
||||
},
|
||||
"reasoning": {
|
||||
"enabled": false
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Если бы вместо `routerai-gpt4o` сработал фоллбэк на `local-qwen` — слой
|
||||
`upstreams.routerai-gpt4o.patch` не применился бы (нет у локалки), и в теле не
|
||||
было бы `provider.ignore`/`allow_fallbacks`; модель стала бы `qwen2.5-72b-instruct`,
|
||||
а `model.patch` (`reasoning.enabled=false`) остался бы — он не зависит от апстрима.
|
||||
|
||||
## Ссылка на env в ключах
|
||||
|
||||
Чтобы не хранить ключи в файле, `key` можно резолвить из переменной среды
|
||||
(подстановка вида `${ROUTER_API_KEY}`):
|
||||
|
||||
```yaml
|
||||
providers:
|
||||
- id: routerai
|
||||
url: "https://routerai.ru/api/v1"
|
||||
key: "${ROUTER_API_KEY}"
|
||||
```
|
||||
|
||||
## Что меняется в коде (`Main.kt`)
|
||||
|
||||
> **Старая концепция выпиливается целиком.** Текущий код — это «один апстрим на
|
||||
> одну переменную среды»: `UPSTREAM_URL`, `ROUTER_API_KEY`, `EXCLUDED_PROVIDERS`,
|
||||
> `THINKING_MODELS`, функция `patchBody(...)`, чтение `SGLANG_COMPAT`, а также
|
||||
> дублирование каталога `/v1/models` с суффиксом `-no-think`. Всё это **удаляется**
|
||||
> без обратной совместимости — сервис становится YAML-декларативным роутером
|
||||
> (разделы ниже). Env-переменные конфигурации провайдеров/моделей больше не
|
||||
> поддерживаются; остаётся только `CONFIG_PATH` (порт/интерфейс — в блоке
|
||||
> `server` файла).
|
||||
|
||||
### 1. Модель конфига (сериализуемые классы)
|
||||
|
||||
```kotlin
|
||||
// patch — универсальная JSON-подобная структура (kotlinx JsonObject),
|
||||
// декодируется из YAML-мапа. null = патч отсутствует.
|
||||
@Serializable
|
||||
data class ProviderConf(
|
||||
val id: String,
|
||||
val url: String,
|
||||
val key: String = "",
|
||||
val max_concurrency: Int? = null, // лимит по умолчанию для апстримов провайдера
|
||||
val patch: JsonObject? = null, // ко всем запросам провайдера
|
||||
val session_header: String? = null, // заголовок-сессия, считается из истории
|
||||
)
|
||||
|
||||
@Serializable
|
||||
data class UpstreamConf(
|
||||
val id: String, // наш внутренний id апстрима
|
||||
val provider: String, // ссылка на ProviderConf.id
|
||||
val model: String, // реальное имя модели у провайдера
|
||||
val max_concurrency: Int? = null,// опционально; null/0 = безлимит
|
||||
val patch: JsonObject? = null, // к запросам этой апстрим-модели
|
||||
)
|
||||
|
||||
@Serializable
|
||||
data class ModelConf(
|
||||
val name: String, // «витринное» имя для клиента
|
||||
val upstreams: List<String>, // ссылки на UpstreamConf.id
|
||||
val patch: JsonObject? = null, // к запросам этой модели (самый приоритетный)
|
||||
)
|
||||
|
||||
@Serializable
|
||||
data class Config(
|
||||
val providers: List<ProviderConf> = emptyList(),
|
||||
val upstreams: List<UpstreamConf> = emptyList(),
|
||||
val models: List<ModelConf> = emptyList(),
|
||||
)
|
||||
```
|
||||
|
||||
> **Тип `patch`.** В YAML пишется как обычный мап, а yamlkt декодирует его в
|
||||
> `kotlinx.serialization.json.JsonObject` (через `JsonObject.serializer()` /
|
||||
> мост yamlkt→JsonElement). Так `patch` — это аккуратная JSON-структура, а не
|
||||
> строка, и мержить её в тело запроса тривиально.
|
||||
|
||||
Глубокий мерж двух `JsonObject` (поля `patch` перезаписывают/дополняют `base`
|
||||
рекурсивно по вложенным объектам):
|
||||
|
||||
```kotlin
|
||||
fun merge(base: JsonObject, patch: JsonObject): JsonObject {
|
||||
val merged = base.toMutableMap()
|
||||
for ((k, v) in patch) {
|
||||
merged[k] = when {
|
||||
v is JsonObject && merged[k] is JsonObject ->
|
||||
merge(merged[k] as JsonObject, v) // рекурсивно для вложенных
|
||||
else -> v // скаляр/массив — заменяем
|
||||
}
|
||||
}
|
||||
return JsonObject(merged)
|
||||
}
|
||||
```
|
||||
|
||||
Загрузка:
|
||||
|
||||
```kotlin
|
||||
// Дефолт — config.yaml в каталоге проекта (CWD). CONFIG_PATH переопределяет путь.
|
||||
val path = System.getenv("CONFIG_PATH") ?: "config.yaml"
|
||||
val configFile = File(path) // относительный путь резолвится от CWD проекта
|
||||
if (!configFile.exists()) error("config not found: ${configFile.absolutePath}")
|
||||
// Весь YAML читается как YamlElement-дерево, затем маппится в Config вручную
|
||||
// (поле patch сразу конвертируется в kotlinx JsonObject). Вложенный
|
||||
// @Serializable-класс с полем YamlElement yamlkt читает некорректно.
|
||||
val root = Yaml.decodeYamlFromString(configFile.readText(Charsets.UTF_8))
|
||||
val config = parseConfig(root)
|
||||
val providersById = config.providers.associateBy { it.id }
|
||||
val upstreamsById = config.upstreams.associateBy { it.id }
|
||||
```
|
||||
|
||||
### 2. Учёт конкурентности (runtime)
|
||||
|
||||
На старте заводим счётчик активных запросов на каждый апстрим — это **единственный
|
||||
источник истины** про занятость. Никаких опросов апстрима и реакции на его `503`.
|
||||
|
||||
```kotlin
|
||||
// Эффективный лимит апстрима резолвится при старте: свой max_concurrency, иначе
|
||||
// провайдерский, иначе безлимит. На счётчике лежит уже итоговый лимит.
|
||||
val active = config.upstreams.associate {
|
||||
it.id to UpstreamCounter(
|
||||
it.max_concurrency
|
||||
?: providersById[it.provider]?.max_concurrency
|
||||
?: Int.MAX_VALUE,
|
||||
)
|
||||
}
|
||||
```
|
||||
|
||||
Отбор свободного апстрима — атомарно: пытаемся инкрементировать счётчик, только
|
||||
если он меньше лимита. Если ни один из `upstreams` модели не свободен — отдаём
|
||||
`503` (`all upstreams busy`), слоты при этом не трогаем. Слот освобождается
|
||||
(`decrement`) в `finally` по завершении проксирования (успех/ошибка/отмена).
|
||||
|
||||
```kotlin
|
||||
// Атомарно занимает слот у первого свободного апстрима; вернёт null, если все заняты.
|
||||
fun claim(up: List<UpstreamConf>): UpstreamConf? = up.firstOrNull { u ->
|
||||
val counter = active.getValue(u.id)
|
||||
val cur = counter.get()
|
||||
cur < counter.limit && counter.compareAndSet(cur, cur + 1)
|
||||
}
|
||||
|
||||
// Освободить слот (в finally).
|
||||
fun release(u: UpstreamConf) = active.getValue(u.id).decrementAndGet()
|
||||
```
|
||||
|
||||
### 3. `handleChat` — выбор апстрима, подмена модели и мерж `patch`
|
||||
|
||||
Вместо текущей логики с `EXCLUDED_PROVIDERS` / `THINKING_MODELS`:
|
||||
|
||||
- берём из тела `model`;
|
||||
- ищем `config.models.first { it.name == model }` (404, если нет);
|
||||
- резолвим `upstreamsById` для списка `model.upstreams`;
|
||||
- **цикл по свободным апстримам** (наш внутренний учёт):
|
||||
- `claim(...)` занимает слот первого свободного апстрима; если свободных нет —
|
||||
сразу `503` (`all upstreams busy`) — решение по нашим счётчикам, не по апстриму;
|
||||
- резолвим `providersById[upstream.provider]` (ошибка старта, если `id` нет);
|
||||
- подменяем в теле `model` → `upstream.model`;
|
||||
- **накладываем `patch` послойно** (исходное тело → `provider.patch` →
|
||||
`upstream.patch` → `model.patch`), каждый через `merge(...)`; слои с `patch
|
||||
== null` пропускаем. Итог — финальное тело запроса;
|
||||
- шлём на `provider.url + /chat/completions` с `Authorization: Bearer provider.key`;
|
||||
- при ответе `5xx`/`429` от провайдера — `release(upstream)` и переходим к
|
||||
следующему свободному апстриму из списка (фейловер); исчерпали список —
|
||||
отдаём `503` (`all upstreams failed`);
|
||||
- при успехе/отмене клиента — `release(upstream)` в `finally` и выходим.
|
||||
|
||||
`patchBody(excluded, thinking)` и env-переменные `EXCLUDED_PROVIDERS` /
|
||||
`THINKING_MODELS` / `UPSTREAM_URL` / `ROUTER_API_KEY` **убираются** — их
|
||||
функциональность теперь в декларативном `patch` и блоке `upstreams`.
|
||||
|
||||
### 4. `handleModels` — отдаём свой каталог
|
||||
|
||||
Вместо проксирования `/v1/models` на апстрим — формируем ответ из
|
||||
`config.models`, отдавая `id = model.name` для каждой записи. Суффикс `-no-think`
|
||||
как отдельная модель теперь просто объявляется в конфиге (с нужным `patch`),
|
||||
логика дублирования каталога удаляется.
|
||||
|
||||
### 5. Env, которые остаются
|
||||
|
||||
- `CONFIG_PATH` — путь к YAML; по умолчанию `config.yaml` в каталоге проекта
|
||||
(CWD), можно задать абсолютный или относительный путь.
|
||||
|
||||
Порт/интерфейс биндинга больше не задаются через env — они в блоке `server`
|
||||
файла конфига (`server.host`, `server.port`; дефолты `0.0.0.0` / `8100`).
|
||||
|
||||
### 6. Таймаут запроса к апстриму
|
||||
|
||||
Целое время на один запрос к нейронке (от отправки до получения всего ответа,
|
||||
включая стриминг) — константа `UPSTREAM_REQUEST_TIMEOUT_MS` = **5 минут**
|
||||
(`src/commonMain/kotlin/pw/binom/llmproxy/Timeouts.kt`). Задается лимитом
|
||||
`requestTimeout` CIO-движка Ktor — без этого работает дефолт движка **15 секунд**,
|
||||
который обрывает длинные LLM-генерации. По достижении лимита запрос отменяется,
|
||||
слот конкурентности освобождается. Значение выводится в лог при старте.
|
||||
|
||||
### 7. Логирование
|
||||
|
||||
Логируем через `logback` (зависимость `logback-classic` уже в проекте; `println`
|
||||
заменяем на `Logger`). Ключевые события:
|
||||
|
||||
- **Старт**: сколько провайдеров/апстримов/моделей загружено; предупреждение,
|
||||
если `upstreams[].id` или `models[].upstreams` ссылаются на несуществующий
|
||||
`id` (проблема конфигурации).
|
||||
- **Биндинг сервера**: `server: bind host=<host> port=<port>` — фактический
|
||||
интерфейс и порт из блока `server` конфига.
|
||||
- **Таймаут апстрима**: `upstream: request_timeout=<N>ms` — лимит времени на
|
||||
запрос к нейронке (константа из раздела 6).
|
||||
- **Принят запрос** (`model=<витрина>`, upstream=<id>, provider=<id>`): занят
|
||||
слот `active[id]=N/limit`.
|
||||
- **Отклонён запрос** — `503 all upstreams busy` для `model=<витрина>`:
|
||||
состояние слотов всех апстримов модели (`id=N/limit`, ...).
|
||||
- **Фейловер**: `upstream=<id> вернул <status>` → переход к следующему
|
||||
свободному `upstream=<id>`.
|
||||
- **Завершение** (успех/ошибка/отмена клиента): длительность, статус апстрима,
|
||||
освобождён слот `active[id]=N/limit`.
|
||||
- **Ошибка апстрима** (не `5xx`/`429`, а сетевая/таймаут): как сейчас — лог с
|
||||
сообщением.
|
||||
|
||||
Формат строки лога — один префикс `[llm-proxy]`, как сейчас, чтобы не ломать
|
||||
существующий парсинг логов (если он есть).
|
||||
|
||||
## Миграция `podman-compose.yaml`
|
||||
|
||||
Блок `environment` упрощается: вместо `UPSTREAM_URL` / `ROUTER_API_KEY` /
|
||||
`EXCLUDED_PROVIDERS` / `THINKING_MODELS` монтируется файл конфига и задаётся
|
||||
`CONFIG_PATH`, а секреты (ключи) — через env-подстановку `${...}` внутри файла.
|
||||
+1
-1
@@ -1,4 +1,4 @@
|
||||
FROM docker.io/library/eclipse-temurin:17-jre-alpine
|
||||
FROM docker.io/library/eclipse-temurin:21-jre-alpine
|
||||
COPY build/libs/llm-proxy.jar /app/llm-proxy.jar
|
||||
WORKDIR /app
|
||||
EXPOSE 8100
|
||||
|
||||
@@ -1,37 +1,45 @@
|
||||
# llm-proxy
|
||||
|
||||
Прозрачная прослойка OpenAI API перед RouterAI (routerai.ru). Принимает
|
||||
`/v1/chat/completions` и `/v1/models`, модифицирует запрос и проксирует дальше.
|
||||
Прозрачная прослойка/роутер OpenAI API. Принимает `/v1/chat/completions` и
|
||||
`/v1/models`, маршрутизирует между объявленными в YAML апстримами по внутреннему
|
||||
учёту конкурентности и мержит `patch`-слои (`provider` → `upstream` → `model`) в
|
||||
тело запроса. Подробная спецификация конфига — в `CONFIG.md`.
|
||||
|
||||
## Что добавляет в запрос
|
||||
## Конфиг
|
||||
|
||||
1. **`provider.ignore`** — исключение дорогих провайдеров (список из env
|
||||
`EXCLUDED_PROVIDERS`, напр. `deepseek`) + `allow_fallbacks: false`
|
||||
(иначе ignore не жёсткий — RouterAI может уйти на исключённого резервной
|
||||
попыткой).
|
||||
2. **`reasoning: {"enabled": false}`** — для моделей с суффиксом `-no-think`
|
||||
(отключение думанья; проверено на `deepseek/deepseek-v4-flash-0731`:
|
||||
работает `reasoning.enabled=false`, не работает `include_reasoning=false`).
|
||||
Суффикс снимается перед отправкой — RouterAI видит оригинальное имя.
|
||||
Конфигурация — в YAML-файле (по умолчанию `config.yaml` в каталоге проекта,
|
||||
CWD; переопределяется env `CONFIG_PATH`). Блоки: `server` (интерфейс биндинга
|
||||
`host` + `port`, дефолты `0.0.0.0` / `8100`), `providers`, `upstreams`,
|
||||
`models`. Старый механизм env-переменных (`UPSTREAM_URL`, `ROUTER_API_KEY`,
|
||||
`EXCLUDED_PROVIDERS`, `THINKING_MODELS`, `PORT`) удалён — его поведение теперь
|
||||
в декларативном `patch` и блоке `upstreams`, а порт/интерфейс — в блоке
|
||||
`server`.
|
||||
|
||||
## Каталог /v1/models
|
||||
Лимит конкурентности `max_concurrency` можно задать и на провайдере (лимит по
|
||||
умолчанию для его апстримов), и на апстриме (перекрывает провайдерский); без
|
||||
обоих — безлимит.
|
||||
|
||||
Модели, чей id содержит любую из подстрок `THINKING_MODELS`, дублируются в
|
||||
каталоге с суффиксом `-no-think` (напр. `deepseek/deepseek-v4-flash-0731-no-think`).
|
||||
|
||||
## Конфиг (env)
|
||||
Обработку think-тегов включает опциональный флажок `think_tags` у провайдера или
|
||||
апстрима (`off` по умолчанию, `split` — рассуждения из `<think>…</think>` уходят
|
||||
в `reasoning_content`, `strip` — выбрасываются); работает и в стриме, и в
|
||||
non-stream.
|
||||
|
||||
| Переменная | Default | Описание |
|
||||
|---|---|---|
|
||||
| `PORT` | 8100 | Порт сервера |
|
||||
| `UPSTREAM_URL` | `https://routerai.ru/api/v1` | Куда проксировать |
|
||||
| `ROUTER_API_KEY` | — (обязателен) | Bearer-ключ RouterAI |
|
||||
| `EXCLUDED_PROVIDERS` | пусто | slug'и провайдеров через запятую |
|
||||
| `THINKING_MODELS` | `deepseek/deepseek-v4-flash-0731,deepseek/deepseek-v4-flash` | подстроки id «думающих» моделей |
|
||||
| `CONFIG_PATH` | `config.yaml` (CWD) | Путь к YAML-конфигу |
|
||||
|
||||
| Ключ конфига | Default | Описание |
|
||||
|---|---|---|
|
||||
| `server.host` | `0.0.0.0` | Интерфейс/адрес биндинга |
|
||||
| `server.port` | `8100` | Порт сервера |
|
||||
|
||||
Таймаут на запрос к нейронке (весь ответ, включая стриминг) — константа
|
||||
`UPSTREAM_REQUEST_TIMEOUT_MS` = 5 минут; без неё дефолт CIO-движка Ktor — 15 секунд,
|
||||
и длинные генерации обрываются. Значение логируется при старте.
|
||||
|
||||
## Сборка и деплой
|
||||
|
||||
- CI (Gitea Actions, на release): `./gradlew shadowJar` → образ
|
||||
- CI (Gitea Actions, на release): `./gradlew fatJar` → образ
|
||||
`images.binom.pw/llm-proxy:<tag>` (zot).
|
||||
- Запуск на 76.179 (llm-router): `podman-compose up -d` из `podman-compose.yaml`
|
||||
(образ тянется из `images.binom.pw`, сеть `bifrost_default` — туда же Bifrost
|
||||
|
||||
+45
@@ -0,0 +1,45 @@
|
||||
# Тестирование llm-proxy
|
||||
|
||||
Все тесты — обычные модульные, живут в `src/commonTest/kotlin/pw/binom/llmproxy/`.
|
||||
|
||||
## Запуск
|
||||
|
||||
- `./gradlew jvmTest` — прогнать все тесты;
|
||||
- `./gradlew clean jvmTest fatJar` — полная сборка с нуля;
|
||||
- результат смотреть в `build/test-results/jvmTest/*.xml` (атрибуты `tests`/`failures`/`errors`), потому что строки вида «N tests completed» печатаются только при падениях.
|
||||
|
||||
## Что покрыто
|
||||
|
||||
| Файл | Что проверяет |
|
||||
| --- | --- |
|
||||
| `ThinkTagSplitterTest` | Автомат рассечения think-тегов: passthrough при off, вырезание рассуждений при split, отбрасывание при strip, удержание разрезанного тега, несколько блоков, незакрытый блок; |
|
||||
| `ConfigLogicTest` | Разбор конфига, приоритет источников (апстрим важнее провайдера), слияние патчей, выбор апстрима и лимиты конкурентности, заголовки, сессии; |
|
||||
| `ThinkTagTransformTest` | Non-stream путь `transformThinkMessage`: перенос рассуждений в `reasoning_content`, дописывание к уже имеющемуся, strip, незакрытый блок, отсутствие изменений → null; |
|
||||
| `ThinkTagChunkTest` | SSE-чанки `transformThinkChunk`: удержание хвоста тега между чанками, независимые сплиттеры по index, удаление пустого `content`; |
|
||||
| `ThinkTagStreamTest` | Обвязка стрима `streamSseWithThinkTags`: разрез тега между data-событиями, сброс удержанного хвоста в финиш-чанке, прохождение служебных строк и `[DONE]`, битый JSON, чанк без choices, strip. |
|
||||
|
||||
## Проверка качества тестов (мутационная приёмка)
|
||||
|
||||
Приём по шагам:
|
||||
|
||||
1. Забэкапить файл.
|
||||
2. Внести РОВНО одну поломку в боевой код.
|
||||
3. Прогнать `./gradlew cleanJvmTest jvmTest`.
|
||||
4. Посмотреть XML — тест, который не упал, считается пустым.
|
||||
5. Откатить (`git checkout -- <файл>`).
|
||||
|
||||
Обязательно: `cleanJvmTest` обязателен, иначе прогон не перезапустится.
|
||||
|
||||
Проверенные мутации, каждая из которых ДОЛЖНА ронять тесты:
|
||||
|
||||
- `transformThinkMessage` возвращает null → падают тесты non-stream;
|
||||
- `transformThinkChunk` возвращает null → падают тесты чанков и стрима;
|
||||
- блок финиш-чанка в `streamSseWithThinkTags` не выполняется → падает тест про удержанный хвост;
|
||||
- `holdableSuffix` всегда 0 (хвост тега не удерживается) → падают тесты автомата, чанков и стрима;
|
||||
- `strip` начинает отдавать рассуждения → падает тест автомата.
|
||||
|
||||
Правило: боевой код нельзя подгонять под тест; если тест не проходит, неверен тест.
|
||||
|
||||
## Известное ограничение
|
||||
|
||||
Живой стрим в реальном апстриме модульными тестами не проверяется: обвязка испытывается на синтетическом SSE через каналы ktor. Реальный апстрим проверяется только после деплоя.
|
||||
+43
-23
@@ -1,7 +1,6 @@
|
||||
plugins {
|
||||
kotlin("jvm") version "2.4.10"
|
||||
application
|
||||
id("com.gradleup.shadow") version "8.3.5"
|
||||
alias(libs.plugins.kotlinMultiplatform)
|
||||
alias(libs.plugins.kotlinSerialization)
|
||||
}
|
||||
|
||||
group = "pw.binom"
|
||||
@@ -11,31 +10,52 @@ repositories {
|
||||
mavenCentral()
|
||||
}
|
||||
|
||||
dependencies {
|
||||
implementation("io.ktor:ktor-server-core:3.1.2")
|
||||
implementation("io.ktor:ktor-server-cio:3.1.2")
|
||||
implementation("io.ktor:ktor-server-content-negotiation:3.1.2")
|
||||
implementation("io.ktor:ktor-serialization-kotlinx-json:3.1.2")
|
||||
implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.8.1")
|
||||
implementation("ch.qos.logback:logback-classic:1.5.18")
|
||||
}
|
||||
|
||||
application {
|
||||
mainClass.set("pw.binom.llmproxy.MainKt")
|
||||
}
|
||||
|
||||
kotlin {
|
||||
compilerOptions {
|
||||
jvmTarget.set(org.jetbrains.kotlin.gradle.dsl.JvmTarget.JVM_17)
|
||||
jvm()
|
||||
linuxX64()
|
||||
sourceSets {
|
||||
val commonMain by getting {
|
||||
dependencies {
|
||||
implementation(libs.ktor.server.core)
|
||||
implementation(libs.ktor.server.cio)
|
||||
implementation(libs.ktor.client.core)
|
||||
implementation(libs.ktor.client.cio)
|
||||
implementation(libs.ktor.serialization.kotlinx.json)
|
||||
implementation(libs.kotlinx.serialization.json)
|
||||
implementation(libs.yamlkt)
|
||||
implementation(libs.kotlinx.coroutines.core)
|
||||
implementation(libs.kotlinx.datetime)
|
||||
implementation(libs.kotlinx.io.core)
|
||||
}
|
||||
}
|
||||
val commonTest by getting {
|
||||
dependencies {
|
||||
implementation(libs.kotlin.test)
|
||||
implementation(libs.kotlinx.coroutines.test)
|
||||
}
|
||||
}
|
||||
val jvmMain by getting {
|
||||
dependencies {
|
||||
runtimeOnly(libs.logback.classic)
|
||||
}
|
||||
}
|
||||
val jvmTest by getting {
|
||||
dependencies {
|
||||
implementation(libs.junit.jupiter)
|
||||
runtimeOnly(libs.junit.platform.launcher)
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
java {
|
||||
sourceCompatibility = JavaVersion.VERSION_17
|
||||
targetCompatibility = JavaVersion.VERSION_17
|
||||
tasks.withType<Test> {
|
||||
useJUnitPlatform()
|
||||
}
|
||||
|
||||
tasks.shadowJar {
|
||||
tasks.register<Jar>("fatJar") {
|
||||
archiveFileName.set("llm-proxy.jar")
|
||||
mergeServiceFiles()
|
||||
manifest { attributes("Main-Class" to "pw.binom.llmproxy.MainKt") }
|
||||
duplicatesStrategy = DuplicatesStrategy.EXCLUDE
|
||||
from(kotlin.jvm().compilations["main"].output)
|
||||
from(configurations.getByName("jvmRuntimeClasspath").map { if (it.isDirectory) it else zipTree(it) })
|
||||
}
|
||||
|
||||
@@ -0,0 +1,33 @@
|
||||
[versions]
|
||||
kotlin = "2.4.10"
|
||||
kotlinxSerialization = "1.8.1"
|
||||
ktor = "3.5.2"
|
||||
yamlkt = "0.13.0"
|
||||
logback = "1.5.18"
|
||||
junit = "5.10.2"
|
||||
coroutines = "1.10.2"
|
||||
datetime = "0.6.2"
|
||||
kotlinxIo = "0.9.1"
|
||||
|
||||
[libraries]
|
||||
ktor-server-core = { module = "io.ktor:ktor-server-core", version.ref = "ktor" }
|
||||
ktor-server-cio = { module = "io.ktor:ktor-server-cio", version.ref = "ktor" }
|
||||
ktor-client-core = { module = "io.ktor:ktor-client-core", version.ref = "ktor" }
|
||||
ktor-client-cio = { module = "io.ktor:ktor-client-cio", version.ref = "ktor" }
|
||||
ktor-serialization-kotlinx-json = { module = "io.ktor:ktor-serialization-kotlinx-json", version.ref = "ktor" }
|
||||
kotlinx-serialization-json = { module = "org.jetbrains.kotlinx:kotlinx-serialization-json", version.ref = "kotlinxSerialization" }
|
||||
yamlkt = { module = "net.mamoe.yamlkt:yamlkt", version.ref = "yamlkt" }
|
||||
kotlinx-coroutines-core = { module = "org.jetbrains.kotlinx:kotlinx-coroutines-core", version.ref = "coroutines" }
|
||||
kotlinx-datetime = { module = "org.jetbrains.kotlinx:kotlinx-datetime", version.ref = "datetime" }
|
||||
kotlinx-coroutines-test = { module = "org.jetbrains.kotlinx:kotlinx-coroutines-test", version.ref = "coroutines" }
|
||||
kotlinx-io-core = { module = "org.jetbrains.kotlinx:kotlinx-io-core", version.ref = "kotlinxIo" }
|
||||
logback-classic = { module = "ch.qos.logback:logback-classic", version.ref = "logback" }
|
||||
kotlin-test = { module = "org.jetbrains.kotlin:kotlin-test" }
|
||||
junit-jupiter = { module = "org.junit.jupiter:junit-jupiter", version.ref = "junit" }
|
||||
junit-platform-launcher = { module = "org.junit.platform:junit-platform-launcher" }
|
||||
|
||||
[plugins]
|
||||
kotlinJvm = { id = "org.jetbrains.kotlin.jvm", version.ref = "kotlin" }
|
||||
kotlinMultiplatform = { id = "org.jetbrains.kotlin.multiplatform", version.ref = "kotlin" }
|
||||
kotlinSerialization = { id = "org.jetbrains.kotlin.plugin.serialization", version.ref = "kotlin" }
|
||||
shadow = { id = "com.gradleup.shadow", version = "8.3.5" }
|
||||
+20
-9
@@ -1,17 +1,28 @@
|
||||
# llm-proxy — прослойка OpenAI API: добавляет provider.ignore (исключение
|
||||
# дорогих провайдеров) + allow_fallbacks:false и reasoning.enabled:false для
|
||||
# моделей с суффиксом "-no-think", проксирует на RouterAI. Ответ — как есть.
|
||||
# llm-proxy — YAML-декларативный роутер OpenAI API (подробности в CONFIG.md).
|
||||
# Принимает /v1/chat/completions и /v1/models, маршрутизирует между апстримами
|
||||
# по внутреннему учёту конкурентности и мержит patch-слои в тело запроса.
|
||||
#
|
||||
# Запуск на 76.179 (llm-router): podman-compose up -d
|
||||
# Образ тянется из нашего реестра (zot): images.binom.pw/llm-proxy:<tag>
|
||||
services:
|
||||
llm-proxy:
|
||||
image: images.binom.pw/llm-proxy:latest
|
||||
container_name: llm-proxy
|
||||
restart: unless-stopped
|
||||
network_mode: bifrost_default
|
||||
networks:
|
||||
- bifrost
|
||||
environment:
|
||||
- PORT=8100
|
||||
- UPSTREAM_URL=https://routerai.ru/api/v1
|
||||
- ROUTER_API_KEY=__SET_FROM_CONFIG_DB__
|
||||
- EXCLUDED_PROVIDERS=deepseek
|
||||
- THINKING_MODELS=deepseek/deepseek-v4-flash-0731,deepseek/deepseek-v4-flash
|
||||
# Путь к конфигу внутри контейнера (файл монтируется ниже).
|
||||
- CONFIG_PATH=/config/config.yaml
|
||||
volumes:
|
||||
# Монтируем свой config.yaml (секреты — через ${...} внутри файла,
|
||||
# резолвятся из env контейнера, напр. ROUTER_API_KEY).
|
||||
- ./config.yaml:/config/config.yaml:ro
|
||||
# Если ключи в config.yaml ссылаются на env (${ROUTER_API_KEY}), пробросим их:
|
||||
# environment:
|
||||
# - ROUTER_API_KEY=__SET_FROM_CONFIG_DB__
|
||||
|
||||
networks:
|
||||
bifrost:
|
||||
external: true
|
||||
name: bifrost_default
|
||||
|
||||
@@ -0,0 +1,17 @@
|
||||
package pw.binom.llmproxy
|
||||
|
||||
import kotlinx.io.Buffer
|
||||
import kotlinx.io.files.Path
|
||||
import kotlinx.io.files.SystemFileSystem
|
||||
import kotlinx.io.readByteArray
|
||||
|
||||
internal fun readConfigText(path: String): String {
|
||||
val src = SystemFileSystem.source(Path(path))
|
||||
try {
|
||||
val buf = Buffer()
|
||||
while (src.readAtMostTo(buf, Long.MAX_VALUE) > 0L) { }
|
||||
return buf.readByteArray().decodeToString()
|
||||
} finally {
|
||||
src.close()
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,3 @@
|
||||
package pw.binom.llmproxy
|
||||
|
||||
expect fun getEnv(name: String): String?
|
||||
@@ -0,0 +1,13 @@
|
||||
package pw.binom.llmproxy
|
||||
|
||||
enum class LogLevel { INFO, WARN, ERROR }
|
||||
|
||||
fun emitLog(level: LogLevel, message: String) {
|
||||
println("[llm-proxy] ${level.name.lowercase()} $message")
|
||||
}
|
||||
|
||||
object log {
|
||||
inline fun info(lazyMessage: () -> Any?) = emitLog(LogLevel.INFO, lazyMessage()?.toString() ?: "null")
|
||||
inline fun warn(lazyMessage: () -> Any?) = emitLog(LogLevel.WARN, lazyMessage()?.toString() ?: "null")
|
||||
inline fun error(lazyMessage: () -> Any?) = emitLog(LogLevel.ERROR, lazyMessage()?.toString() ?: "null")
|
||||
}
|
||||
@@ -0,0 +1,856 @@
|
||||
package pw.binom.llmproxy
|
||||
|
||||
import io.ktor.client.HttpClient
|
||||
import io.ktor.client.call.body
|
||||
import io.ktor.client.request.headers
|
||||
import io.ktor.utils.io.LineEnding
|
||||
import io.ktor.utils.io.readAvailable
|
||||
import io.ktor.utils.io.readLine
|
||||
import io.ktor.http.Headers
|
||||
import io.ktor.client.request.preparePost
|
||||
import io.ktor.client.request.setBody
|
||||
import io.ktor.client.statement.HttpResponse
|
||||
import io.ktor.http.ContentType
|
||||
import io.ktor.http.HttpStatusCode
|
||||
import io.ktor.server.application.Application
|
||||
import io.ktor.server.application.ApplicationCall
|
||||
import io.ktor.server.application.call
|
||||
import io.ktor.server.application.install
|
||||
import io.ktor.server.request.httpMethod
|
||||
import io.ktor.server.request.receiveText
|
||||
import io.ktor.server.request.uri
|
||||
import io.ktor.server.response.respondBytesWriter
|
||||
import io.ktor.server.response.respondText
|
||||
import io.ktor.server.routing.get
|
||||
import io.ktor.server.routing.post
|
||||
import io.ktor.server.routing.routing
|
||||
import io.ktor.utils.io.ByteReadChannel
|
||||
import io.ktor.utils.io.ByteWriteChannel
|
||||
import io.ktor.utils.io.writeFully
|
||||
import kotlinx.coroutines.CancellationException
|
||||
import kotlinx.coroutines.sync.Mutex
|
||||
import kotlinx.datetime.Clock
|
||||
import kotlinx.serialization.Serializable
|
||||
import kotlinx.serialization.json.Json
|
||||
import kotlinx.serialization.json.JsonArray
|
||||
import kotlinx.serialization.json.JsonElement
|
||||
import kotlinx.serialization.json.JsonNull
|
||||
import kotlinx.serialization.json.JsonObject
|
||||
import kotlinx.serialization.json.JsonPrimitive
|
||||
import kotlinx.serialization.json.jsonArray
|
||||
import kotlinx.serialization.json.jsonObject
|
||||
import kotlinx.serialization.json.jsonPrimitive
|
||||
import net.mamoe.yamlkt.Yaml
|
||||
import net.mamoe.yamlkt.YamlElement
|
||||
import net.mamoe.yamlkt.YamlList
|
||||
import net.mamoe.yamlkt.YamlLiteral
|
||||
import net.mamoe.yamlkt.YamlMap
|
||||
import kotlin.concurrent.Volatile
|
||||
import kotlin.time.Duration.Companion.seconds
|
||||
import kotlin.time.TimeSource
|
||||
|
||||
/**
|
||||
* Прослойка OpenAI API (YAML-декларативный роутер, Kotlin Multiplatform).
|
||||
*
|
||||
* Конфигурация целиком в YAML-файле (см. CONFIG.md): объявляются провайдеры
|
||||
* (`providers`), каталог апстрим-моделей (`upstreams`) и модели, видимые клиенту
|
||||
* (`models`). Маршрутизация между апстримами модели — по внутреннему учёту
|
||||
* конкурентности (AtomicInt на апстрим); в тело запроса послойно
|
||||
* вмердживаются `patch` (provider → upstream → model).
|
||||
*
|
||||
* Env (только эти):
|
||||
* - CONFIG_PATH путь к YAML; default `config.yaml` в каталоге проекта (CWD)
|
||||
*
|
||||
* Порт/интерфейс биндинга задаются блоком `server` в YAML (см. CONFIG.md).
|
||||
*/
|
||||
fun main() {
|
||||
val path = getEnv("CONFIG_PATH") ?: "config.yaml"
|
||||
val root = Yaml.decodeYamlFromString(readConfigText(path))
|
||||
val config = parseConfig(root)
|
||||
val providersById = config.providers.associateBy { it.id }
|
||||
val upstreamsById = config.upstreams.associateBy { it.id }
|
||||
|
||||
config.upstreams.forEach { up ->
|
||||
if (up.provider !in providersById) {
|
||||
log.warn { "[llm-proxy] upstream '${up.id}' ссылается на несуществующего provider '${up.provider}'" }
|
||||
}
|
||||
}
|
||||
config.models.forEach { m ->
|
||||
m.upstreams.forEach { ref ->
|
||||
if (ref !in upstreamsById) {
|
||||
log.warn { "[llm-proxy] model '${m.name}' ссылается на несуществующий upstream '$ref'" }
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
val active = config.upstreams.associate { up ->
|
||||
up.id to UpstreamCounter(effectiveConcurrencyLimit(up, providersById[up.provider]))
|
||||
}
|
||||
|
||||
log.info {
|
||||
"[llm-proxy] загружено: providers=${config.providers.size}, " +
|
||||
"upstreams=${config.upstreams.size}, models=${config.models.size} (config=$path)"
|
||||
}
|
||||
log.info {
|
||||
"[llm-proxy] server: bind host=${config.server.host} port=${config.server.port}"
|
||||
}
|
||||
log.info {
|
||||
"[llm-proxy] upstream: request_timeout=${UPSTREAM_REQUEST_TIMEOUT_MS}ms"
|
||||
}
|
||||
|
||||
val http = createHttpClient()
|
||||
val sessions = SessionRegistry()
|
||||
startServer(config.server.host, config.server.port) {
|
||||
proxyModule(config, providersById, upstreamsById, active, sessions, http)
|
||||
}
|
||||
}
|
||||
|
||||
private val json = Json { ignoreUnknownKeys = true }
|
||||
|
||||
fun Application.proxyModule(
|
||||
config: Config,
|
||||
providersById: Map<String, ProviderConf>,
|
||||
upstreamsById: Map<String, UpstreamConf>,
|
||||
active: Map<String, UpstreamCounter>,
|
||||
sessions: SessionRegistry,
|
||||
http: HttpClient,
|
||||
) {
|
||||
routing {
|
||||
post("/v1/chat/completions") {
|
||||
handleChat(call, config, providersById, upstreamsById, active, sessions, http)
|
||||
}
|
||||
get("/v1/models") {
|
||||
handleModels(call, config)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
private suspend fun handleChat(
|
||||
call: ApplicationCall,
|
||||
config: Config,
|
||||
providersById: Map<String, ProviderConf>,
|
||||
upstreamsById: Map<String, UpstreamConf>,
|
||||
active: Map<String, UpstreamCounter>,
|
||||
sessions: SessionRegistry,
|
||||
http: HttpClient,
|
||||
) {
|
||||
log.info { "[llm-proxy] chat ${call.request.httpMethod.value} ${call.request.uri} headers: ${formatHeadersForLog(call.request.headers)}" }
|
||||
val raw = call.receiveText()
|
||||
if (raw.isBlank()) {
|
||||
call.respondText(errorJson("empty body"), ContentType.Application.Json, HttpStatusCode.BadRequest)
|
||||
return
|
||||
}
|
||||
val bodyJson = try {
|
||||
json.parseToJsonElement(raw).jsonObject
|
||||
} catch (e: Exception) {
|
||||
call.respondText(errorJson("bad json: ${e.message}"), ContentType.Application.Json, HttpStatusCode.BadRequest)
|
||||
return
|
||||
}
|
||||
|
||||
val modelName = bodyJson["model"]?.jsonPrimitive?.content ?: "?"
|
||||
val modelConf = config.models.firstOrNull { it.name == modelName }
|
||||
if (modelConf == null) {
|
||||
call.respondText(errorJson("unknown model: $modelName"), ContentType.Application.Json, HttpStatusCode.NotFound)
|
||||
return
|
||||
}
|
||||
|
||||
val pool = modelConf.upstreams.mapNotNull { upstreamsById[it] }
|
||||
if (pool.isEmpty()) {
|
||||
call.respondText(errorJson("model $modelName has no valid upstreams"), ContentType.Application.Json, HttpStatusCode.BadGateway)
|
||||
return
|
||||
}
|
||||
|
||||
val clientWantsStream = bodyJson["stream"]?.jsonPrimitive?.content == "true"
|
||||
val failed = mutableSetOf<String>()
|
||||
var anyClaimed = false
|
||||
|
||||
while (true) {
|
||||
val up = pickFreeUpstream(pool, active, failed) ?: break
|
||||
anyClaimed = true
|
||||
val start = TimeSource.Monotonic.markNow()
|
||||
try {
|
||||
val provider = providersById[up.provider]
|
||||
if (provider == null) {
|
||||
log.error { "[llm-proxy] upstream '${up.id}': provider '${up.provider}' не найден (конфиг)" }
|
||||
failed.add(up.id)
|
||||
continue
|
||||
}
|
||||
|
||||
val patched = buildBody(bodyJson, provider, up, modelConf)
|
||||
val forwarded = if (clientWantsStream) {
|
||||
patched
|
||||
} else {
|
||||
val m = patched.toMutableMap().apply {
|
||||
this["stream"] = JsonPrimitive(true)
|
||||
val so = (this["stream_options"] as? JsonObject)?.toMutableMap() ?: mutableMapOf()
|
||||
so["include_usage"] = JsonPrimitive(true)
|
||||
this["stream_options"] = JsonObject(so)
|
||||
}
|
||||
JsonObject(m)
|
||||
}
|
||||
|
||||
val url = provider.url.trimEnd('/') + "/chat/completions"
|
||||
val providerKey = resolveEnv(provider.key)
|
||||
val sessionHeader = provider.session_header
|
||||
// Клиентский одноимённый заголовок не пробрасываем: при метке
|
||||
// значение x-opencode-session всегда вычисляем сами (LCP по истории).
|
||||
val forwardedHeaders = headersToForward(call.request.headers)
|
||||
.filterKeys { sessionHeader == null || !it.equals(sessionHeader, ignoreCase = true) }
|
||||
val sessionId = sessionHeader?.let { sessions.resolve(sessionPrefixHashes(forwarded)) }
|
||||
val outgoingHeaders = forwardedHeaders.toMutableMap().apply {
|
||||
this["Content-Type"] = listOf("application/json")
|
||||
if (providerKey.isNotEmpty()) this["Authorization"] = listOf("Bearer $providerKey")
|
||||
if (sessionHeader != null && sessionId != null) this[sessionHeader] = listOf(sessionId)
|
||||
}
|
||||
log.info {
|
||||
"[llm-proxy] chat model=$modelName upstream=${up.id} session=${sessionId ?: "-"} → $url headers: ${formatHeadersForLog(outgoingHeaders)}"
|
||||
}
|
||||
var failover = false
|
||||
var responded = false
|
||||
var upstreamStatus = 0
|
||||
|
||||
http.preparePost(url) {
|
||||
headers {
|
||||
forwardedHeaders.forEach { (name, values) ->
|
||||
appendAll(name, values)
|
||||
}
|
||||
// Авторизация — всегда наша (ключ провайдера из конфига);
|
||||
// клиентский Authorization не пересылается. Если у провайдера
|
||||
// ключ не задан — Authorization не отправляем вовсе.
|
||||
if (providerKey.isNotEmpty()) {
|
||||
set("Authorization", "Bearer $providerKey")
|
||||
}
|
||||
set("Content-Type", "application/json")
|
||||
if (sessionHeader != null && sessionId != null) {
|
||||
set(sessionHeader, sessionId)
|
||||
}
|
||||
}
|
||||
setBody(forwarded.toString())
|
||||
}.execute { resp ->
|
||||
upstreamStatus = resp.status.value
|
||||
if (upstreamStatus >= 500 || upstreamStatus == 429) {
|
||||
log.warn { "[llm-proxy] model=$modelName upstream=${up.id} вернул $upstreamStatus → фейловер" }
|
||||
failed.add(up.id)
|
||||
failover = true
|
||||
return@execute
|
||||
}
|
||||
responded = true
|
||||
if (clientWantsStream) {
|
||||
val ct = resp.headers["Content-Type"] ?: "text/event-stream"
|
||||
val status = HttpStatusCode.fromValue(upstreamStatus)
|
||||
val thinkMode = effectiveThinkTags(up, provider)
|
||||
call.respondBytesWriter(ContentType.parse(ct), status) {
|
||||
val ch = resp.body<ByteReadChannel>()
|
||||
if (thinkMode == "off") {
|
||||
// Флажок не выставлен — сырой байтовый passthrough как раньше.
|
||||
val buf = ByteArray(8192)
|
||||
while (true) {
|
||||
val n = ch.readAvailable(buf)
|
||||
if (n == -1) break
|
||||
if (n > 0) {
|
||||
writeFully(buf, 0, n)
|
||||
flush()
|
||||
}
|
||||
}
|
||||
} else {
|
||||
streamSseWithThinkTags(ch, thinkMode)
|
||||
}
|
||||
}
|
||||
log.info {
|
||||
"[llm-proxy] chat model=$modelName upstream=${up.id} provider=${provider.id} " +
|
||||
"status=$upstreamStatus за ${start.elapsedNow().inWholeMilliseconds}ms stream=true"
|
||||
}
|
||||
} else {
|
||||
val ct = resp.headers["Content-Type"] ?: "application/json"
|
||||
val full = resp.body<String>()
|
||||
val thinkMode = effectiveThinkTags(up, provider)
|
||||
val rebuilt = if (ct.contains("text/event-stream")) rebuildFromChunks(full) else full
|
||||
val out = if (thinkMode != "off") (
|
||||
runCatching { transformThinkMessage(json.parseToJsonElement(rebuilt).jsonObject, thinkMode) }
|
||||
.getOrNull() ?: rebuilt
|
||||
) else rebuilt
|
||||
val outCt = runCatching {
|
||||
if (ct.contains("text/event-stream") &&
|
||||
Json.parseToJsonElement(out).jsonObject["error"] != null
|
||||
) {
|
||||
ContentType.Application.Json
|
||||
} else {
|
||||
ContentType.parse(ct)
|
||||
}
|
||||
}.getOrDefault(ContentType.parse(ct))
|
||||
call.respondText(out, outCt, HttpStatusCode.fromValue(upstreamStatus))
|
||||
log.info {
|
||||
"[llm-proxy] chat model=$modelName upstream=${up.id} provider=${provider.id} " +
|
||||
"status=$upstreamStatus за ${start.elapsedNow().inWholeMilliseconds}ms stream=false"
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
if (failover) continue
|
||||
if (responded) return
|
||||
} catch (e: CancellationException) {
|
||||
log.info { "[llm-proxy] chat model=$modelName upstream=${up.id} ОТМЕНЕНО клиентом за ${start.elapsedNow().inWholeMilliseconds}ms" }
|
||||
throw e
|
||||
} catch (e: Exception) {
|
||||
log.error { "[llm-proxy] chat model=$modelName upstream=${up.id} ОШИБКА: ${e.message} за ${start.elapsedNow().inWholeMilliseconds}ms → фейловер" }
|
||||
failed.add(up.id)
|
||||
continue
|
||||
} finally {
|
||||
release(up, active)
|
||||
}
|
||||
}
|
||||
|
||||
if (anyClaimed) {
|
||||
call.respondText(errorJson("all upstreams failed"), ContentType.Application.Json, HttpStatusCode.ServiceUnavailable)
|
||||
} else {
|
||||
call.respondText(errorJson("all upstreams busy"), ContentType.Application.Json, HttpStatusCode.ServiceUnavailable)
|
||||
}
|
||||
}
|
||||
|
||||
private fun errorJson(msg: String): String =
|
||||
"""{"error":{"message":"$msg"}}"""
|
||||
|
||||
/** Hop-by-hop и прокси-специфичные заголовки, которые НЕ пересылаются в апстрим. */
|
||||
private val SKIP_HEADER_NAMES = setOf(
|
||||
"host",
|
||||
"content-length",
|
||||
"transfer-encoding",
|
||||
"te",
|
||||
"connection",
|
||||
"proxy-connection",
|
||||
"keep-alive",
|
||||
"upgrade",
|
||||
// Authorization управляется прокси явно (ключ провайдера), клиентский
|
||||
// не пересылается
|
||||
"authorization",
|
||||
// Content-Type всегда наш (application/json: тело мержится как JSON),
|
||||
// клиентский не пересылаем, чтобы не ушло двух заголовков
|
||||
"content-type",
|
||||
)
|
||||
|
||||
/**
|
||||
* Заголовки входящего запроса для пересылки в апстрим: все, кроме служебных
|
||||
* ([SKIP_HEADER_NAMES]). Тело может быть изменено `patch`, а соединение до
|
||||
* апстрима — другое, поэтому Content-Length/Transfer-Encoding/Host/Connection
|
||||
* управляет сам прокси (клиентский Ktor выставит свои автоматически).
|
||||
* `Authorization` тоже в списке пропусков — прокси управляет им явно
|
||||
* (ключ провайдера из конфига; клиентский не пересылается).
|
||||
*/
|
||||
internal fun headersToForward(request: Headers): Map<String, List<String>> =
|
||||
request.entries()
|
||||
.filter { (name, _) -> name.lowercase() !in SKIP_HEADER_NAMES }
|
||||
.associate { (name, values) -> name to values }
|
||||
|
||||
/** Заголовки, значения которых маскируются в логах (секреты клиента). */
|
||||
private val SENSITIVE_HEADER_NAMES = setOf(
|
||||
"authorization",
|
||||
"proxy-authorization",
|
||||
"x-api-key",
|
||||
"api-key",
|
||||
"cookie",
|
||||
"set-cookie",
|
||||
)
|
||||
|
||||
/**
|
||||
* Заголовки в виде строки для лога (`name=v1|v2, ...`). Значения чувствительных
|
||||
* имён ([SENSITIVE_HEADER_NAMES]) маскируются `***`, чтобы не светить секреты.
|
||||
*/
|
||||
internal fun formatHeadersForLog(headers: Map<String, List<String>>): String =
|
||||
headers.entries.joinToString(", ") { (name, values) ->
|
||||
val shown = if (name.lowercase() in SENSITIVE_HEADER_NAMES) values.map { "***" } else values
|
||||
"$name=${shown.joinToString("|")}"
|
||||
}
|
||||
|
||||
internal fun formatHeadersForLog(headers: Headers): String =
|
||||
formatHeadersForLog(headers.entries().associate { (name, values) -> name to values })
|
||||
|
||||
/**
|
||||
* Сборка тела запроса: подмена `model` на реальное имя апстрима + глубокий
|
||||
* послойный мерж `patch` в порядке provider → upstream → model.
|
||||
*/
|
||||
internal fun buildBody(base: JsonObject, provider: ProviderConf, up: UpstreamConf, model: ModelConf): JsonObject {
|
||||
val withModel = base.toMutableMap().apply { this["model"] = JsonPrimitive(up.model) }
|
||||
var acc = JsonObject(withModel)
|
||||
listOf(provider.patch, up.patch, model.patch).filterNotNull().forEach { patch ->
|
||||
acc = merge(acc, patch)
|
||||
}
|
||||
return acc
|
||||
}
|
||||
|
||||
/** Конвертация YAML-дерева (YamlElement) в kotlinx JsonElement для мержа в тело. */
|
||||
internal fun yamlToJson(el: YamlElement): JsonElement = when (el) {
|
||||
is YamlMap -> JsonObject(el.mapKeys { (k, _) -> yamlKey(k) }.mapValues { (_, v) -> yamlToJson(v) })
|
||||
is YamlList -> JsonArray(el.map { yamlToJson(it) })
|
||||
is YamlLiteral -> yamlLiteralToJson(el)
|
||||
else -> JsonNull
|
||||
}
|
||||
|
||||
internal fun yamlKey(key: YamlElement): String =
|
||||
if (key is YamlLiteral) key.content else key.toString()
|
||||
|
||||
internal fun yamlLiteralToJson(lit: YamlLiteral): JsonPrimitive {
|
||||
val c = lit.content
|
||||
val bool = c.toBooleanStrictOrNull()
|
||||
val lng = c.toLongOrNull()
|
||||
val dbl = c.toDoubleOrNull()
|
||||
return when {
|
||||
bool != null -> JsonPrimitive(bool)
|
||||
lng != null -> JsonPrimitive(lng)
|
||||
dbl != null -> JsonPrimitive(dbl)
|
||||
else -> JsonPrimitive(c)
|
||||
}
|
||||
}
|
||||
|
||||
/** Глубокий мерж: вложенные объекты сливаются рекурсивно, скаляры/массивы заменяются. */
|
||||
internal fun merge(base: JsonObject, patch: JsonObject): JsonObject {
|
||||
val merged = base.toMutableMap()
|
||||
for ((k, v) in patch) {
|
||||
merged[k] = when {
|
||||
v is JsonObject && merged[k] is JsonObject ->
|
||||
merge(merged[k] as JsonObject, v)
|
||||
else -> v
|
||||
}
|
||||
}
|
||||
return JsonObject(merged)
|
||||
}
|
||||
|
||||
/** Подстановка `${ENV}` в строках ключей/url из переменных среды. */
|
||||
internal fun resolveEnv(s: String): String =
|
||||
"""\$\{([^}]+)\}""".toRegex().replace(s) { m -> getEnv(m.groupValues[1]) ?: "" }
|
||||
|
||||
/** Атомарно занять слот у апстрима (по эффективному лимиту); false, если все заняты. */
|
||||
internal fun tryClaim(up: UpstreamConf, active: Map<String, UpstreamCounter>): Boolean =
|
||||
active.getValue(up.id).tryClaim()
|
||||
|
||||
/**
|
||||
* Эффективный лимит конкурентности апстрима: значение у апстрима (модели), если
|
||||
* задано; иначе у провайдера; иначе безлимит.
|
||||
*/
|
||||
internal fun effectiveConcurrencyLimit(up: UpstreamConf, provider: ProviderConf?): Int =
|
||||
up.max_concurrency ?: provider?.max_concurrency ?: Int.MAX_VALUE
|
||||
|
||||
/**
|
||||
* Эффективные think_tags апстрима: значение у апстрима, если задано; иначе у
|
||||
* провайдера; иначе "off". Значения "true" трактуются как "split", "false" и
|
||||
* любое неизвестное/пустое — как "off".
|
||||
*/
|
||||
internal fun effectiveThinkTags(up: UpstreamConf, provider: ProviderConf?): String {
|
||||
val raw = up.think_tags ?: provider?.think_tags ?: "off"
|
||||
return when (raw) {
|
||||
"split", "strip" -> raw
|
||||
"true" -> "split"
|
||||
else -> "off"
|
||||
}
|
||||
}
|
||||
|
||||
/** Освободить слот апстрима (в finally по завершении проксирования). */
|
||||
internal fun release(up: UpstreamConf, active: Map<String, UpstreamCounter>) {
|
||||
active.getValue(up.id).release()
|
||||
}
|
||||
|
||||
class UpstreamCounter(private val limit: Int, initial: Int = 0) {
|
||||
private val lock = Mutex()
|
||||
@Volatile
|
||||
private var count: Int = initial
|
||||
|
||||
fun tryClaim(): Boolean {
|
||||
if (!lock.tryLock()) return false
|
||||
try {
|
||||
return if (count >= limit) false else {
|
||||
count++
|
||||
true
|
||||
}
|
||||
} finally {
|
||||
lock.unlock()
|
||||
}
|
||||
}
|
||||
|
||||
fun release(): Unit {
|
||||
if (!lock.tryLock()) return
|
||||
try {
|
||||
if (count > 0) count--
|
||||
} finally {
|
||||
lock.unlock()
|
||||
}
|
||||
}
|
||||
|
||||
val current: Int
|
||||
get() {
|
||||
if (!lock.tryLock()) return -1
|
||||
try {
|
||||
return count
|
||||
} finally {
|
||||
lock.unlock()
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Выбор апстрима для попытки: первый по порядку (приоритету) апстрим из `pool`,
|
||||
* у которого свободен слот и который ещё не в `excluded` (не упал ранее).
|
||||
* Сразу занимает слот (через [tryClaim]). Если свободных нет — возвращает null.
|
||||
*/
|
||||
internal fun pickFreeUpstream(
|
||||
pool: List<UpstreamConf>,
|
||||
active: Map<String, UpstreamCounter>,
|
||||
excluded: Set<String>,
|
||||
): UpstreamConf? =
|
||||
pool.firstOrNull { up -> up.id !in excluded && tryClaim(up, active) }
|
||||
|
||||
private suspend fun handleModels(call: ApplicationCall, config: Config) {
|
||||
log.info { "[llm-proxy] models ${call.request.httpMethod.value} ${call.request.uri} headers: ${formatHeadersForLog(call.request.headers)}" }
|
||||
val created = TimeSource.Monotonic.markNow().elapsedNow().inWholeSeconds
|
||||
val data = config.models.map { m ->
|
||||
JsonObject(
|
||||
mapOf(
|
||||
"id" to JsonPrimitive(m.name),
|
||||
"object" to JsonPrimitive("model"),
|
||||
"created" to JsonPrimitive(created),
|
||||
"owned_by" to JsonPrimitive("llm-proxy"),
|
||||
),
|
||||
)
|
||||
}
|
||||
val body = JsonObject(mapOf("object" to JsonPrimitive("list"), "data" to JsonArray(data)))
|
||||
call.respondText(body.toString(), ContentType.Application.Json, HttpStatusCode.OK)
|
||||
}
|
||||
|
||||
/**
|
||||
* Собрать полный chat.completion из SSE-чанков апстрима (для non-stream клиентов).
|
||||
* Сохраняются все значимые поля, которые отдаёт апстрим: id/created/model/
|
||||
* system_fingerprint/service_tier, usage, несколько choices (по index) с
|
||||
* role/content/reasoning_content/tool_calls/finish_reason/logprobs.
|
||||
*/
|
||||
internal fun rebuildFromChunks(sse: String): String {
|
||||
var id = ""
|
||||
var created: Long? = null
|
||||
var model = ""
|
||||
var systemFingerprint: String? = null
|
||||
var serviceTier: String? = null
|
||||
var usage: JsonObject? = null
|
||||
var provider: JsonElement? = null
|
||||
var error: JsonObject? = null
|
||||
|
||||
class MutableChoice {
|
||||
var role: String? = null
|
||||
val content = StringBuilder()
|
||||
val reasoning = StringBuilder()
|
||||
var finishReason: String? = null
|
||||
var logprobs: JsonElement? = null
|
||||
val toolCalls = mutableListOf<JsonObject>()
|
||||
}
|
||||
|
||||
val choices = mutableMapOf<Int, MutableChoice>()
|
||||
|
||||
sse.lineSequence().forEach { line ->
|
||||
if (!line.startsWith("data:")) return@forEach
|
||||
val data = line.removePrefix("data:").trim()
|
||||
if (data.isEmpty() || data == "[DONE]") return@forEach
|
||||
val obj = runCatching { json.parseToJsonElement(data).jsonObject }.getOrNull() ?: return@forEach
|
||||
if (id.isEmpty()) id = obj["id"]?.jsonPrimitive?.content ?: ""
|
||||
if (created == null) created = obj["created"]?.jsonPrimitive?.content?.toLongOrNull()
|
||||
if (model.isEmpty()) model = obj["model"]?.jsonPrimitive?.content ?: ""
|
||||
if (systemFingerprint == null) systemFingerprint = obj["system_fingerprint"]?.jsonPrimitive?.content
|
||||
if (serviceTier == null) serviceTier = obj["service_tier"]?.jsonPrimitive?.content
|
||||
if (provider == null) provider = obj["provider"]
|
||||
(obj["error"] as? JsonObject)?.let { error = it }
|
||||
(obj["usage"] as? JsonObject)?.let { usage = it }
|
||||
val chArr = obj["choices"]?.jsonArray ?: return@forEach
|
||||
for (ch in chArr) {
|
||||
val c = ch.jsonObject
|
||||
val idx = c["index"]?.jsonPrimitive?.content?.toIntOrNull() ?: 0
|
||||
val mc = choices.getOrPut(idx) { MutableChoice() }
|
||||
val delta = c["delta"]?.jsonObject
|
||||
if (delta != null) {
|
||||
if (mc.role == null) mc.role = delta["role"]?.jsonPrimitive?.content
|
||||
delta["content"]?.jsonPrimitive?.content?.takeIf { it != "null" }?.let { mc.content.append(it) }
|
||||
delta["reasoning_content"]?.jsonPrimitive?.content?.takeIf { it != "null" }?.let { mc.reasoning.append(it) }
|
||||
delta["tool_calls"]?.jsonArray?.forEach { tc -> (tc as? JsonObject)?.let { mc.toolCalls.add(it) } }
|
||||
}
|
||||
c["finish_reason"]?.jsonPrimitive?.content?.takeIf { it.isNotEmpty() && it != "null" }?.let { mc.finishReason = it }
|
||||
c["logprobs"]?.let { mc.logprobs = it }
|
||||
}
|
||||
}
|
||||
|
||||
// Апстрим вернул ошибку (в SSE она приходит чанком data: {"error":{...}}).
|
||||
// Не «проглатываем» — отдаём клиенту как есть.
|
||||
if (error != null) {
|
||||
return JsonObject(mapOf("error" to error)).toString()
|
||||
}
|
||||
|
||||
val choiceArr = choices.entries.sortedBy { it.key }.map { (idx, mc) ->
|
||||
val msg = mutableMapOf<String, JsonElement>(
|
||||
"role" to JsonPrimitive(mc.role ?: "assistant"),
|
||||
"content" to JsonPrimitive(mc.content.toString()),
|
||||
)
|
||||
if (mc.reasoning.isNotEmpty()) msg["reasoning_content"] = JsonPrimitive(mc.reasoning.toString())
|
||||
if (mc.toolCalls.isNotEmpty()) msg["tool_calls"] = JsonArray(mc.toolCalls)
|
||||
val ch = mutableMapOf<String, JsonElement>(
|
||||
"index" to JsonPrimitive(idx),
|
||||
"message" to JsonObject(msg),
|
||||
"finish_reason" to JsonPrimitive(mc.finishReason ?: "stop"),
|
||||
)
|
||||
mc.logprobs?.let { ch["logprobs"] = it }
|
||||
JsonObject(ch)
|
||||
}
|
||||
|
||||
val root = mutableMapOf<String, JsonElement>(
|
||||
"id" to JsonPrimitive(id),
|
||||
"object" to JsonPrimitive("chat.completion"),
|
||||
"created" to JsonPrimitive(created ?: Clock.System.now().epochSeconds),
|
||||
"model" to JsonPrimitive(model),
|
||||
"choices" to JsonArray(choiceArr),
|
||||
)
|
||||
systemFingerprint?.let { root["system_fingerprint"] = JsonPrimitive(it) }
|
||||
serviceTier?.let { root["service_tier"] = JsonPrimitive(it) }
|
||||
provider?.let { root["provider"] = it }
|
||||
usage?.let { root["usage"] = it }
|
||||
return JsonObject(root).toString()
|
||||
}
|
||||
|
||||
/**
|
||||
* Пересобрать полный chat.completion (обычный JSON или результат
|
||||
* [rebuildFromChunks]): по каждому choice взять `message.content` — только если
|
||||
* это JSON-строка (массив частей не трогаем) — и прогнать целиком через
|
||||
* [ThinkTagSplitter] (feed + finish). Остаток возвращается в `message.content`,
|
||||
* вырезанное — в `message.reasoning_content` (режим split; при strip не
|
||||
* добавляем). Если `reasoning_content` уже был непустой строкой — новое
|
||||
* дописываем в конец существующего, не теряя прежнее. Ни один choice не
|
||||
* изменился → null (отдать исходную строку как есть).
|
||||
*/
|
||||
internal fun transformThinkMessage(obj: JsonObject, thinkMode: String): String? {
|
||||
val choices = obj["choices"]?.jsonArray ?: return null
|
||||
val addReasoning = thinkMode == "split"
|
||||
var changed = false
|
||||
val newChoices = choices.map { choiceEl ->
|
||||
val choice = choiceEl.jsonObject
|
||||
val message = choice["message"]?.jsonObject ?: return@map choiceEl
|
||||
val contentStr = (message["content"] as? JsonPrimitive)?.takeIf { it.isString }?.content
|
||||
if (contentStr == null) return@map choiceEl
|
||||
val splitter = ThinkTagSplitter(thinkMode)
|
||||
val (outContent, outReasoning) = splitter.feed(contentStr)
|
||||
val (tailContent, tailReasoning) = splitter.finish()
|
||||
val reasoning = outReasoning + tailReasoning
|
||||
changed = true
|
||||
val newMessage = message.toMutableMap().apply {
|
||||
this["content"] = JsonPrimitive(outContent + tailContent)
|
||||
if (addReasoning && reasoning.isNotEmpty()) {
|
||||
val existing = (this["reasoning_content"] as? JsonPrimitive)?.takeIf { it.isString }?.content
|
||||
this["reasoning_content"] = JsonPrimitive((existing ?: "") + reasoning)
|
||||
}
|
||||
}
|
||||
JsonObject(choice.toMutableMap().apply { this["message"] = JsonObject(newMessage) })
|
||||
}
|
||||
if (!changed) return null
|
||||
return JsonObject(obj.toMutableMap().apply { this["choices"] = JsonArray(newChoices) }).toString()
|
||||
}
|
||||
|
||||
/**
|
||||
* Построчный разбор SSE-стрима с рассечением think-тегов. Строки, не начинающиеся
|
||||
* с `data:`, и `data: [DONE]` уходят клиенту без изменений (с `\n`). Прочие
|
||||
* `data:`-строки парсятся и прогоняются через [transformThinkChunk]; результат
|
||||
* записывается как `data: <json>\n\n` (событие-граница SSE), а при ошибке парса —
|
||||
* исходная строка. Каждую строку сразу `flush()`, чтобы стрим не «залипал» в
|
||||
* буфере. В конце потока накопленные хвосты сплиттеров сбрасываются финиш-чанком.
|
||||
*/
|
||||
internal suspend fun ByteWriteChannel.streamSseWithThinkTags(source: ByteReadChannel, thinkMode: String) {
|
||||
val splitters = mutableMapOf<Int, ThinkTagSplitter>()
|
||||
val addReasoning = thinkMode == "split"
|
||||
while (true) {
|
||||
val line = source.readLine(LineEnding.Lenient) ?: break
|
||||
when {
|
||||
line.startsWith("data:") -> {
|
||||
val payload = line.removePrefix("data:").trim()
|
||||
if (payload == "[DONE]") {
|
||||
emitUtf8("data: [DONE]\n\n")
|
||||
} else {
|
||||
val obj = runCatching { json.parseToJsonElement(payload).jsonObject }.getOrNull()
|
||||
val out = obj?.let { transformThinkChunk(it, splitters, thinkMode, addReasoning) }
|
||||
if (out == null) emitUtf8("$line\n\n") else emitUtf8("data: $out\n\n")
|
||||
}
|
||||
}
|
||||
else -> emitUtf8("$line\n")
|
||||
}
|
||||
flush()
|
||||
}
|
||||
if (thinkMode == "split" || thinkMode == "strip") {
|
||||
splitters.forEach { (idx, sp) ->
|
||||
val (tail, reasoning) = sp.finish()
|
||||
val hasContent = tail.isNotEmpty()
|
||||
val hasReasoning = addReasoning && reasoning.isNotEmpty()
|
||||
if (!hasContent && !hasReasoning) return@forEach
|
||||
val delta = mutableMapOf<String, JsonElement>()
|
||||
if (hasContent) delta["content"] = JsonPrimitive(tail)
|
||||
if (hasReasoning) delta["reasoning_content"] = JsonPrimitive(reasoning)
|
||||
val chunk = JsonObject(
|
||||
mutableMapOf(
|
||||
"choices" to JsonArray(
|
||||
listOf(
|
||||
JsonObject(
|
||||
mutableMapOf(
|
||||
"index" to JsonPrimitive(idx),
|
||||
"delta" to JsonObject(delta),
|
||||
),
|
||||
),
|
||||
),
|
||||
),
|
||||
),
|
||||
)
|
||||
emitUtf8("data: $chunk\n\n")
|
||||
flush()
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Пересобрать SSE-чанк: по каждому choice (ключ `index`, дефолт 0) взять
|
||||
* `delta.content` (только если это JSON-строка; массив частей не трогаем) и
|
||||
* прогнать через [ThinkTagSplitter] для этого index. Остаток возвращается в
|
||||
* `delta.content` (поле убирается, если пустое); вырезанное — в
|
||||
* `delta.reasoning_content` (только режим split, при strip не добавляем).
|
||||
* Чанк без `choices` или без строкового `delta.content` не меняется —
|
||||
* возвращается null (отдать исходную строку как есть).
|
||||
*/
|
||||
internal fun transformThinkChunk(
|
||||
obj: JsonObject,
|
||||
splitters: MutableMap<Int, ThinkTagSplitter>,
|
||||
thinkMode: String,
|
||||
addReasoning: Boolean,
|
||||
): String? {
|
||||
val choices = obj["choices"]?.jsonArray ?: return null
|
||||
var changed = false
|
||||
val newChoices = choices.map { choiceEl ->
|
||||
val choice = choiceEl.jsonObject
|
||||
val delta = choice["delta"]?.jsonObject
|
||||
val contentStr = (delta?.get("content") as? JsonPrimitive)?.takeIf { it.isString }?.content
|
||||
if (contentStr == null) return@map choiceEl
|
||||
val idx = choice["index"]?.jsonPrimitive?.content?.toIntOrNull() ?: 0
|
||||
val splitter = splitters.getOrPut(idx) { ThinkTagSplitter(thinkMode) }
|
||||
val (newContent, reasoning) = splitter.feed(contentStr)
|
||||
changed = true
|
||||
val newDelta = delta.toMutableMap()
|
||||
if (newContent.isEmpty()) newDelta.remove("content") else newDelta["content"] = JsonPrimitive(newContent)
|
||||
if (addReasoning && reasoning.isNotEmpty()) newDelta["reasoning_content"] = JsonPrimitive(reasoning)
|
||||
JsonObject(choice.toMutableMap().apply { this["delta"] = JsonObject(newDelta) })
|
||||
}
|
||||
if (!changed) return null
|
||||
return JsonObject(obj.toMutableMap().apply { this["choices"] = JsonArray(newChoices) }).toString()
|
||||
}
|
||||
|
||||
/** Записать строку как UTF-8 байты (KMP-безопасно, без java.io). */
|
||||
private suspend fun ByteWriteChannel.emitUtf8(text: String) {
|
||||
val bytes = text.encodeToByteArray()
|
||||
writeFully(bytes, 0, bytes.size)
|
||||
}
|
||||
|
||||
@Serializable
|
||||
data class ProviderConf(
|
||||
val id: String,
|
||||
val url: String,
|
||||
val key: String = "",
|
||||
val max_concurrency: Int? = null,
|
||||
val patch: JsonObject? = null,
|
||||
val session_header: String? = null,
|
||||
val think_tags: String? = null,
|
||||
)
|
||||
|
||||
data class UpstreamConf(
|
||||
val id: String,
|
||||
val provider: String,
|
||||
val model: String,
|
||||
val max_concurrency: Int? = null,
|
||||
val patch: JsonObject? = null,
|
||||
val think_tags: String? = null,
|
||||
)
|
||||
|
||||
data class ModelConf(
|
||||
val name: String,
|
||||
val upstreams: List<String>,
|
||||
val patch: JsonObject? = null,
|
||||
)
|
||||
|
||||
data class ServerConf(
|
||||
val host: String = "0.0.0.0",
|
||||
val port: Int = 8100,
|
||||
)
|
||||
|
||||
data class Config(
|
||||
val server: ServerConf,
|
||||
val providers: List<ProviderConf>,
|
||||
val upstreams: List<UpstreamConf>,
|
||||
val models: List<ModelConf>,
|
||||
)
|
||||
|
||||
/**
|
||||
* Ручной разбор YAML-дерева (YamlElement) в конфиг. Поле `patch` сразу
|
||||
* конвертируется в kotlinx JsonObject (merge`ить в тело тривиально).
|
||||
* Декодирование всего документа как YamlElement надёжнее, чем вложенный
|
||||
* `@Serializable`-класс с полем YamlElement (yamlkt криво читает списки).
|
||||
*/
|
||||
internal fun parseConfig(root: YamlElement): Config {
|
||||
val rootMap = root as? YamlMap ?: error("config root must be a map")
|
||||
val top = rootMap.toMap()
|
||||
|
||||
fun list(key: String): List<YamlElement> {
|
||||
val v = top[key] ?: return emptyList()
|
||||
return (v as? YamlList)?.map { it } ?: emptyList()
|
||||
}
|
||||
|
||||
val serverMap = (top["server"] as? YamlMap)?.toMap()
|
||||
val server = if (serverMap != null) {
|
||||
ServerConf(
|
||||
host = serverMap.strOrNull("host") ?: "0.0.0.0",
|
||||
port = serverMap.strOrNull("port")?.toIntOrNull() ?: 8100,
|
||||
)
|
||||
} else {
|
||||
ServerConf()
|
||||
}
|
||||
|
||||
val providers = list("providers").map { entry ->
|
||||
val m = (entry as YamlMap).toMap()
|
||||
ProviderConf(
|
||||
id = m.str("id"),
|
||||
url = m.str("url"),
|
||||
key = m.strOrNull("key") ?: "",
|
||||
max_concurrency = m.strOrNull("max_concurrency")?.toIntOrNull(),
|
||||
patch = m.yamlMapOrNull("patch")?.let { yamlToJson(it) as JsonObject },
|
||||
session_header = m.strOrNull("session_header"),
|
||||
think_tags = m.strOrNull("think_tags"),
|
||||
)
|
||||
}
|
||||
|
||||
val upstreams = list("upstreams").map { entry ->
|
||||
val m = (entry as YamlMap).toMap()
|
||||
UpstreamConf(
|
||||
id = m.str("id"),
|
||||
provider = m.str("provider"),
|
||||
model = m.str("model"),
|
||||
max_concurrency = m.strOrNull("max_concurrency")?.toIntOrNull(),
|
||||
patch = m.yamlMapOrNull("patch")?.let { yamlToJson(it) as JsonObject },
|
||||
think_tags = m.strOrNull("think_tags"),
|
||||
)
|
||||
}
|
||||
|
||||
val models = list("models").map { entry ->
|
||||
val m = (entry as YamlMap).toMap()
|
||||
ModelConf(
|
||||
name = m.str("name"),
|
||||
upstreams = (m["upstreams"] as? YamlList)?.map { (it as YamlLiteral).content } ?: emptyList(),
|
||||
patch = m.yamlMapOrNull("patch")?.let { yamlToJson(it) as JsonObject },
|
||||
)
|
||||
}
|
||||
|
||||
return Config(server, providers, upstreams, models)
|
||||
}
|
||||
|
||||
/** YamlMap -> Map<String, YamlElement> (ключи YAML — строковые скаляры). */
|
||||
internal fun YamlMap.toMap(): Map<String, YamlElement> =
|
||||
entries.associate { (it.key as YamlLiteral).content to it.value }
|
||||
|
||||
internal fun Map<String, YamlElement>.str(key: String): String =
|
||||
(this[key] as? YamlLiteral)?.content ?: error("config: missing string '$key'")
|
||||
|
||||
internal fun Map<String, YamlElement>.strOrNull(key: String): String? =
|
||||
(this[key] as? YamlLiteral)?.content
|
||||
|
||||
internal fun Map<String, YamlElement>.yamlMapOrNull(key: String): YamlMap? =
|
||||
this[key] as? YamlMap
|
||||
@@ -0,0 +1,10 @@
|
||||
package pw.binom.llmproxy
|
||||
|
||||
import io.ktor.client.HttpClient
|
||||
import io.ktor.server.application.Application
|
||||
|
||||
/** Платформенное создание HTTP-клиента (движок задаётся в actual). */
|
||||
expect fun createHttpClient(): HttpClient
|
||||
|
||||
/** Платформенный запуск Ktor-сервера (движок задаётся в actual). */
|
||||
expect fun startServer(host: String, port: Int, module: Application.() -> Unit)
|
||||
@@ -0,0 +1,206 @@
|
||||
package pw.binom.llmproxy
|
||||
|
||||
import kotlinx.coroutines.sync.Mutex
|
||||
import kotlinx.coroutines.sync.withLock
|
||||
import kotlinx.datetime.Clock
|
||||
import kotlinx.serialization.json.JsonArray
|
||||
import kotlinx.serialization.json.JsonElement
|
||||
import kotlinx.serialization.json.JsonObject
|
||||
import kotlinx.serialization.json.JsonPrimitive
|
||||
|
||||
/**
|
||||
* SHA-256, чистая реализация на commonMain (без внешних зависимостей —
|
||||
* KMP-зеркало их не отдаёт). Нужен для стабильного хэша префиксов истории.
|
||||
*/
|
||||
internal object Sha256 {
|
||||
private val K = intArrayOf(
|
||||
0x428a2f98, 0x71374491, 0xb5c0fbcf.toInt(), 0xe9b5dba5.toInt(), 0x3956c25b, 0x59f111f1, 0x923f82a4.toInt(), 0xab1c5ed5.toInt(),
|
||||
0xd807aa98.toInt(), 0x12835b01, 0x243185be, 0x550c7dc3, 0x72be5d74, 0x80deb1fe.toInt(), 0x9bdc06a7.toInt(), 0xc19bf174.toInt(),
|
||||
0xe49b69c1.toInt(), 0xefbe4786.toInt(), 0x0fc19dc6, 0x240ca1cc, 0x2de92c6f, 0x4a7484aa, 0x5cb0a9dc, 0x76f988da,
|
||||
0x983e5152.toInt(), 0xa831c66d.toInt(), 0xb00327c8.toInt(), 0xbf597fc7.toInt(), 0xc6e00bf3.toInt(), 0xd5a79147.toInt(), 0x06ca6351, 0x14292967,
|
||||
0x27b70a85, 0x2e1b2138, 0x4d2c6dfc, 0x53380d13, 0x650a7354, 0x766a0abb, 0x81c2c92e.toInt(), 0x92722c85.toInt(),
|
||||
0xa2bfe8a1.toInt(), 0xa81a664b.toInt(), 0xc24b8b70.toInt(), 0xc76c51a3.toInt(), 0xd192e819.toInt(), 0xd6990624.toInt(), 0xf40e3585.toInt(), 0x106aa070,
|
||||
0x19a4c116, 0x1e376c08, 0x2748774c, 0x34b0bcb5, 0x391c0cb3, 0x4ed8aa4a, 0x5b9cca4f, 0x682e6ff3,
|
||||
0x748f82ee, 0x78a5636f, 0x84c87814.toInt(), 0x8cc70208.toInt(), 0x90befffa.toInt(), 0xa4506ceb.toInt(), 0xbef9a3f7.toInt(), 0xc67178f2.toInt(),
|
||||
)
|
||||
|
||||
private fun rotr(x: Int, n: Int): Int = (x ushr n) or (x shl (32 - n))
|
||||
|
||||
private fun pad(input: ByteArray): ByteArray {
|
||||
val total = ((input.size + 9 + 63) / 64) * 64
|
||||
val out = ByteArray(total)
|
||||
input.copyInto(out)
|
||||
out[input.size] = 0x80.toByte()
|
||||
val bits = input.size.toLong() * 8
|
||||
for (k in 0 until 8) {
|
||||
out[total - 1 - k] = (bits ushr (8 * k)).toByte()
|
||||
}
|
||||
return out
|
||||
}
|
||||
|
||||
fun hash(input: ByteArray): ByteArray {
|
||||
val msg = pad(input)
|
||||
val h = intArrayOf(
|
||||
0x6a09e667, 0xbb67ae85.toInt(), 0x3c6ef372, 0xa54ff53a.toInt(),
|
||||
0x510e527f, 0x9b05688c.toInt(), 0x1f83d9ab, 0x5be0cd19,
|
||||
)
|
||||
val w = IntArray(64)
|
||||
var i = 0
|
||||
while (i < msg.size) {
|
||||
for (j in 0 until 16) {
|
||||
w[j] = ((msg[i + j * 4].toInt() and 0xff) shl 24) or
|
||||
((msg[i + j * 4 + 1].toInt() and 0xff) shl 16) or
|
||||
((msg[i + j * 4 + 2].toInt() and 0xff) shl 8) or
|
||||
(msg[i + j * 4 + 3].toInt() and 0xff)
|
||||
}
|
||||
for (j in 16 until 64) {
|
||||
val s0 = rotr(w[j - 15], 7) xor rotr(w[j - 15], 18) xor (w[j - 15] ushr 3)
|
||||
val s1 = rotr(w[j - 2], 17) xor rotr(w[j - 2], 19) xor (w[j - 2] ushr 10)
|
||||
w[j] = w[j - 16] + s0 + w[j - 7] + s1
|
||||
}
|
||||
var a = h[0]; var b = h[1]; var c = h[2]; var d = h[3]
|
||||
var e = h[4]; var f = h[5]; var g = h[6]; var hh = h[7]
|
||||
for (j in 0 until 64) {
|
||||
val s1 = rotr(e, 6) xor rotr(e, 11) xor rotr(e, 25)
|
||||
val ch = (e and f) xor (e.inv() and g)
|
||||
val t1 = hh + s1 + ch + K[j] + w[j]
|
||||
val s0 = rotr(a, 2) xor rotr(a, 13) xor rotr(a, 22)
|
||||
val maj = (a and b) xor (a and c) xor (b and c)
|
||||
val t2 = s0 + maj
|
||||
hh = g; g = f; f = e; e = d + t1; d = c; c = b; b = a; a = t1 + t2
|
||||
}
|
||||
h[0] += a; h[1] += b; h[2] += c; h[3] += d
|
||||
h[4] += e; h[5] += f; h[6] += g; h[7] += hh
|
||||
i += 64
|
||||
}
|
||||
val out = ByteArray(32)
|
||||
for (j in 0 until 8) {
|
||||
out[j * 4] = (h[j] ushr 24).toByte()
|
||||
out[j * 4 + 1] = (h[j] ushr 16).toByte()
|
||||
out[j * 4 + 2] = (h[j] ushr 8).toByte()
|
||||
out[j * 4 + 3] = h[j].toByte()
|
||||
}
|
||||
return out
|
||||
}
|
||||
}
|
||||
|
||||
private const val HEX = "0123456789abcdef"
|
||||
|
||||
/** SHA-256 строки (UTF-8) в нижнем hex. */
|
||||
internal fun sha256Hex(text: String): String {
|
||||
val bytes = Sha256.hash(text.encodeToByteArray())
|
||||
val sb = StringBuilder(bytes.size * 2)
|
||||
for (b in bytes) {
|
||||
val v = b.toInt() and 0xff
|
||||
sb.append(HEX[v ushr 4]).append(HEX[v and 0xf])
|
||||
}
|
||||
return sb.toString()
|
||||
}
|
||||
|
||||
/**
|
||||
* Инкрементальные префикс-хэши истории: H_i = sha256(H_{i-1} + "\u0000" + msg_i).
|
||||
*
|
||||
* Цепочка начинается с первого `user`-сообщения: system-промпт обычно
|
||||
* идентичен у всех сессий одного клиента и как признак сессии бесполезен
|
||||
* (иначе LCP склеивает все сессии на общем префиксе `[system]`).
|
||||
* Если `messages` нет/пусто — fallback на хэш всего тела.
|
||||
*/
|
||||
internal fun sessionPrefixHashes(body: JsonObject): List<String> {
|
||||
val messages = body["messages"] as? JsonArray
|
||||
if (messages == null || messages.isEmpty()) {
|
||||
return listOf(sha256Hex(body.toString()))
|
||||
}
|
||||
|
||||
fun roleAt(i: Int): String? =
|
||||
((messages[i] as? JsonObject)?.get("role") as? JsonPrimitive)?.content
|
||||
|
||||
var start = messages.indices.firstOrNull { roleAt(it) == "user" }
|
||||
?: messages.indices.firstOrNull { roleAt(it) != "system" }
|
||||
?: 0
|
||||
|
||||
val res = ArrayList<String>(messages.size - start)
|
||||
var prev = ""
|
||||
for (i in start until messages.size) {
|
||||
prev = sha256Hex(prev + "\u0000" + messages[i].toString())
|
||||
res.add(prev)
|
||||
}
|
||||
return res
|
||||
}
|
||||
|
||||
/**
|
||||
* Реестр сессий: id сессии определяется наибольшим общим префиксом (LCP)
|
||||
* присланной истории. Для префиксов, которые уже встречались, возвращается
|
||||
* id исходной сессии; иначе создаётся новая (id = хэш всей истории).
|
||||
*
|
||||
* Таблица ограничена по размеру (LRU) и времени жизни (TTL). Доступ под
|
||||
* Mutex: параллельные запросы одной сессии не должны гонять состояние.
|
||||
*/
|
||||
class SessionRegistry(
|
||||
private val maxSessions: Int = 1000,
|
||||
private val ttlMillis: Long = 6 * 60 * 60 * 1000L,
|
||||
) {
|
||||
private class Entry(val prefixes: MutableSet<String>) {
|
||||
var lastAccess: Long = 0
|
||||
}
|
||||
|
||||
private val mutex = Mutex()
|
||||
private val prefixToSession = mutableMapOf<String, String>()
|
||||
|
||||
/** В порядке доступа: голова — самая давняя, хвост — свежая. */
|
||||
private val sessions = LinkedHashMap<String, Entry>()
|
||||
|
||||
suspend fun resolve(prefixHashes: List<String>): String? =
|
||||
mutex.withLock { resolveLocked(prefixHashes, Clock.System.now().toEpochMilliseconds()) }
|
||||
|
||||
/** Синхронная (без блокировки) версия — для тестов и вызовов под mutex. */
|
||||
internal fun resolveLocked(prefixHashes: List<String>, now: Long): String? {
|
||||
if (prefixHashes.isEmpty()) return null
|
||||
evictExpired(now)
|
||||
|
||||
var found: String? = null
|
||||
for (i in prefixHashes.indices.reversed()) {
|
||||
val s = prefixToSession[prefixHashes[i]]
|
||||
if (s != null) {
|
||||
found = s
|
||||
break
|
||||
}
|
||||
}
|
||||
val id = found ?: prefixHashes.last()
|
||||
|
||||
val entry = sessions.remove(id) ?: Entry(mutableSetOf())
|
||||
for (h in prefixHashes) {
|
||||
val prev = prefixToSession.put(h, id)
|
||||
if (prev != null && prev != id) {
|
||||
sessions[prev]?.prefixes?.remove(h)
|
||||
}
|
||||
entry.prefixes.add(h)
|
||||
}
|
||||
entry.lastAccess = now
|
||||
sessions[id] = entry
|
||||
evictOverflow()
|
||||
return id
|
||||
}
|
||||
|
||||
private fun drop(sessionId: String, entry: Entry) {
|
||||
entry.prefixes.forEach { h -> if (prefixToSession[h] == sessionId) prefixToSession.remove(h) }
|
||||
}
|
||||
|
||||
private fun evictExpired(now: Long) {
|
||||
val it = sessions.entries.iterator()
|
||||
while (it.hasNext()) {
|
||||
val e = it.next()
|
||||
if (now - e.value.lastAccess <= ttlMillis) break
|
||||
drop(e.key, e.value)
|
||||
it.remove()
|
||||
}
|
||||
}
|
||||
|
||||
private fun evictOverflow() {
|
||||
val it = sessions.entries.iterator()
|
||||
while (sessions.size > maxSessions && it.hasNext()) {
|
||||
val e = it.next()
|
||||
drop(e.key, e.value)
|
||||
it.remove()
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,96 @@
|
||||
package pw.binom.llmproxy
|
||||
|
||||
/**
|
||||
* Автомат рассечения кусков стрима по think-тегам (строго lowercase). Чистая логика: без Ktor, без IO, без побочных
|
||||
* эффектов — по одному экземпляру на choice/index.
|
||||
*
|
||||
* - `off` — passthrough: всё, включая теги, уходит в content;
|
||||
* - `split` — текст внутри think-блока → reasoning,
|
||||
* остальное → content; несколько блоков в одном ответе обрабатываются все;
|
||||
* - `strip` — как `split`, но рассуждения выбрасываются (reasoning всегда "").
|
||||
*
|
||||
* Тег может прийти разрезанным между кусками: хвост, который является
|
||||
* префиксом ожидаемого тега: вне блока — <think>, внутри блока — </think>.
|
||||
* Такой хвост не отдаём, держим до следующего `feed`. Если
|
||||
* кусок показал, что хвост не тег, — отдаём его как обычный текст.
|
||||
* Незакрытый think-блок в конце: всё после него (и накопленный хвост) — reasoning,
|
||||
* сбрасывается в `finish`. Незнакомый режим ведёт себя как `off`.
|
||||
*/
|
||||
class ThinkTagSplitter(private val mode: String) {
|
||||
|
||||
private val active: Boolean = mode == "split" || mode == "strip"
|
||||
|
||||
private var inThink = false
|
||||
private var pending = ""
|
||||
|
||||
fun feed(text: String): Pair<String, String> {
|
||||
if (!active) return text to ""
|
||||
val step = process(pending + text)
|
||||
pending = step.pending
|
||||
inThink = step.inThink
|
||||
return step.content to if (mode == "strip") "" else step.reasoning
|
||||
}
|
||||
|
||||
fun finish(): Pair<String, String> {
|
||||
if (!active) return "" to ""
|
||||
val tail = pending
|
||||
val wasInThink = inThink
|
||||
pending = ""
|
||||
inThink = false
|
||||
if (wasInThink) {
|
||||
return "" to if (mode == "strip") "" else tail
|
||||
}
|
||||
return tail to ""
|
||||
}
|
||||
|
||||
private class Step(
|
||||
val content: String,
|
||||
val reasoning: String,
|
||||
val pending: String,
|
||||
val inThink: Boolean,
|
||||
)
|
||||
|
||||
private fun process(s: String): Step {
|
||||
val content = StringBuilder()
|
||||
val reasoning = StringBuilder()
|
||||
var i = 0
|
||||
var think = inThink
|
||||
var hold = ""
|
||||
while (i < s.length) {
|
||||
val tag = if (think) CLOSE else OPEN
|
||||
val idx = s.indexOf(tag, i)
|
||||
if (idx < 0) {
|
||||
val keep = holdableSuffix(s.substring(i), tag)
|
||||
if (think) {
|
||||
reasoning.append(s, i, s.length - keep)
|
||||
} else {
|
||||
content.append(s, i, s.length - keep)
|
||||
}
|
||||
hold = s.substring(s.length - keep)
|
||||
break
|
||||
}
|
||||
if (think) {
|
||||
reasoning.append(s, i, idx)
|
||||
} else {
|
||||
content.append(s, i, idx)
|
||||
}
|
||||
think = !think
|
||||
i = idx + tag.length
|
||||
}
|
||||
return Step(content.toString(), reasoning.toString(), hold, think)
|
||||
}
|
||||
|
||||
/** Максимальный суффикс хвоста, который является префиксом тега (0..tag.length-1). */
|
||||
private fun holdableSuffix(tail: String, tag: String): Int {
|
||||
var k = minOf(tag.length - 1, tail.length)
|
||||
while (k > 0 && !tail.endsWith(tag.substring(0, k))) {
|
||||
k--
|
||||
}
|
||||
return k
|
||||
}
|
||||
|
||||
private companion object {
|
||||
const val OPEN = "<think>"
|
||||
const val CLOSE = "</think>"
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,4 @@
|
||||
package pw.binom.llmproxy
|
||||
|
||||
/** Предел времени на весь запрос к апстриму, мс: от отправки до приёма всего ответа (включая стриминг). */
|
||||
const val UPSTREAM_REQUEST_TIMEOUT_MS: Long = 5 * 60_000L
|
||||
@@ -0,0 +1,549 @@
|
||||
package pw.binom.llmproxy
|
||||
|
||||
import kotlin.test.Test
|
||||
import kotlin.test.assertEquals
|
||||
import kotlin.test.assertFalse
|
||||
import kotlin.test.assertTrue
|
||||
import io.ktor.http.headersOf
|
||||
import kotlinx.serialization.json.Json
|
||||
import kotlinx.serialization.json.JsonObject
|
||||
import kotlinx.serialization.json.jsonArray
|
||||
import kotlinx.serialization.json.jsonObject
|
||||
import kotlinx.serialization.json.jsonPrimitive
|
||||
import net.mamoe.yamlkt.Yaml
|
||||
|
||||
class ConfigLogicTest {
|
||||
|
||||
@Test
|
||||
fun mergeDeepMergesNestedObjectsAndReplacesScalars() {
|
||||
val base = Json.parseToJsonElement("""{"a":{"x":1,"y":2},"b":1}""").jsonObject
|
||||
val patch = Json.parseToJsonElement("""{"a":{"y":3,"z":4},"c":5}""").jsonObject
|
||||
val merged = merge(base, patch)
|
||||
assertEquals("""{"a":{"x":1,"y":3,"z":4},"b":1,"c":5}""", merged.toString())
|
||||
}
|
||||
|
||||
@Test
|
||||
fun mergeReplacesArraysByKey() {
|
||||
val base = Json.parseToJsonElement("""{"provider":{"ignore":["a"]}}""").jsonObject
|
||||
val patch = Json.parseToJsonElement("""{"provider":{"ignore":["b","c"]}}""").jsonObject
|
||||
assertEquals("""{"provider":{"ignore":["b","c"]}}""", merge(base, patch).toString())
|
||||
}
|
||||
|
||||
@Test
|
||||
fun parseConfigReadsAllBlocksAndConvertsPatchToJsonObject() {
|
||||
val yaml = """
|
||||
providers:
|
||||
- id: p1
|
||||
url: "https://x.ru/api/v1"
|
||||
key: "k"
|
||||
max_concurrency: 4
|
||||
patch:
|
||||
provider:
|
||||
allow_fallbacks: false
|
||||
upstreams:
|
||||
- id: u1
|
||||
provider: p1
|
||||
model: real-1
|
||||
max_concurrency: 2
|
||||
patch:
|
||||
provider:
|
||||
ignore: [deepseek]
|
||||
- id: bad
|
||||
provider: missing
|
||||
model: x
|
||||
models:
|
||||
- name: m1
|
||||
upstreams: [u1, bad]
|
||||
patch:
|
||||
reasoning:
|
||||
enabled: false
|
||||
""".trimIndent()
|
||||
|
||||
val cfg = parseConfig(Yaml.decodeYamlFromString(yaml))
|
||||
|
||||
assertEquals(1, cfg.providers.size)
|
||||
assertEquals("https://x.ru/api/v1", cfg.providers[0].url)
|
||||
assertEquals(4, cfg.providers[0].max_concurrency)
|
||||
assertEquals(2, cfg.upstreams.size)
|
||||
assertEquals(2, cfg.upstreams[0].max_concurrency)
|
||||
assertEquals(listOf("u1", "bad"), cfg.models[0].upstreams)
|
||||
|
||||
assertEquals("""{"provider":{"allow_fallbacks":false}}""", cfg.providers[0].patch.toString())
|
||||
assertEquals("""{"provider":{"ignore":["deepseek"]}}""", cfg.upstreams[0].patch.toString())
|
||||
assertEquals("""{"reasoning":{"enabled":false}}""", cfg.models[0].patch.toString())
|
||||
}
|
||||
|
||||
@Test
|
||||
fun parseConfigReadsServerBlock() {
|
||||
val yaml = """
|
||||
server:
|
||||
host: 127.0.0.1
|
||||
port: 9200
|
||||
models:
|
||||
- name: m1
|
||||
upstreams: []
|
||||
""".trimIndent()
|
||||
|
||||
val cfg = parseConfig(Yaml.decodeYamlFromString(yaml))
|
||||
|
||||
assertEquals("127.0.0.1", cfg.server.host)
|
||||
assertEquals(9200, cfg.server.port)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun parseConfigServerDefaultsWhenBlockAbsent() {
|
||||
val yaml = """
|
||||
models:
|
||||
- name: m1
|
||||
upstreams: []
|
||||
""".trimIndent()
|
||||
|
||||
val cfg = parseConfig(Yaml.decodeYamlFromString(yaml))
|
||||
|
||||
assertEquals("0.0.0.0", cfg.server.host)
|
||||
assertEquals(8100, cfg.server.port)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun parseConfigServerFieldDefaultsPerField() {
|
||||
val yaml = """
|
||||
server:
|
||||
host: 192.168.88.10
|
||||
models:
|
||||
- name: m1
|
||||
upstreams: []
|
||||
""".trimIndent()
|
||||
|
||||
val cfg = parseConfig(Yaml.decodeYamlFromString(yaml))
|
||||
|
||||
assertEquals("192.168.88.10", cfg.server.host)
|
||||
assertEquals(8100, cfg.server.port)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun parseConfigOmitsPatchWhenAbsent() {
|
||||
val yaml = """
|
||||
providers:
|
||||
- id: p1
|
||||
url: "https://x.ru/api/v1"
|
||||
upstreams:
|
||||
- id: u1
|
||||
provider: p1
|
||||
model: real-1
|
||||
models:
|
||||
- name: m1
|
||||
upstreams: [u1]
|
||||
""".trimIndent()
|
||||
val cfg = parseConfig(Yaml.decodeYamlFromString(yaml))
|
||||
assertEquals(null, cfg.providers[0].patch)
|
||||
assertEquals(null, cfg.models[0].patch)
|
||||
assertEquals(null, cfg.upstreams[0].max_concurrency)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun buildBodySubstitutesModelAndAppliesLayersInOrder() {
|
||||
val provider = ProviderConf(
|
||||
"p1", "https://x", "", null,
|
||||
Json.parseToJsonElement("""{"provider":{"allow_fallbacks":false}}""").jsonObject,
|
||||
)
|
||||
val up = UpstreamConf(
|
||||
"u1", "p1", "real-1", null,
|
||||
Json.parseToJsonElement("""{"provider":{"ignore":["deepseek"]}}""").jsonObject,
|
||||
)
|
||||
val model = ModelConf(
|
||||
"m1", listOf("u1"),
|
||||
Json.parseToJsonElement("""{"reasoning":{"enabled":false}}""").jsonObject,
|
||||
)
|
||||
val body = Json.parseToJsonElement(
|
||||
"""{"model":"m1","messages":[],"temperature":0.7}""",
|
||||
).jsonObject
|
||||
|
||||
val out = buildBody(body, provider, up, model)
|
||||
assertEquals(
|
||||
"""{"model":"real-1","messages":[],"temperature":0.7,"provider":{"allow_fallbacks":false,"ignore":["deepseek"]},"reasoning":{"enabled":false}}""",
|
||||
out.toString(),
|
||||
)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun buildBodyWithNoPatchesReturnsClientBodyWithSubstitutedModel() {
|
||||
val provider = ProviderConf("p1", "https://x", "")
|
||||
val up = UpstreamConf("u1", "p1", "real-1", null, null)
|
||||
val model = ModelConf("m1", listOf("u1"), null)
|
||||
val body = Json.parseToJsonElement("""{"model":"m1","a":1}""").jsonObject
|
||||
assertEquals("""{"model":"real-1","a":1}""", buildBody(body, provider, up, model).toString())
|
||||
}
|
||||
|
||||
@Test
|
||||
fun resolveEnvSubstitutesMissingVarWithEmptyAndPassesLiteralThrough() {
|
||||
assertEquals("", resolveEnv("\${LLM_PROXY_TEST_MISSING_VAR}"))
|
||||
assertEquals("plain", resolveEnv("plain"))
|
||||
assertEquals("pre--post", resolveEnv("pre-\${LLM_PROXY_TEST_MISSING_VAR}-post"))
|
||||
}
|
||||
|
||||
@Test
|
||||
fun tryClaimRespectsMaxConcurrencyAndReleaseFreesSlot() {
|
||||
val active = mapOf("u1" to UpstreamCounter(1))
|
||||
val up = UpstreamConf("u1", "p", "m", 1, null)
|
||||
assertTrue(tryClaim(up, active))
|
||||
assertFalse(tryClaim(up, active))
|
||||
release(up, active)
|
||||
assertTrue(tryClaim(up, active))
|
||||
}
|
||||
|
||||
@Test
|
||||
fun tryClaimUnlimitedWhenMaxConcurrencyIsNull() {
|
||||
val active = mapOf("u2" to UpstreamCounter(Int.MAX_VALUE))
|
||||
val up = UpstreamConf("u2", "p", "m", null, null)
|
||||
assertTrue(tryClaim(up, active))
|
||||
assertTrue(tryClaim(up, active))
|
||||
}
|
||||
|
||||
@Test
|
||||
fun effectiveConcurrencyLimitPrefersUpstreamThenProvider() {
|
||||
val providerWithLimit = ProviderConf("p1", "https://x", "", 3, null)
|
||||
val providerWithoutLimit = ProviderConf("p2", "https://x", "", null, null)
|
||||
assertEquals(
|
||||
2,
|
||||
effectiveConcurrencyLimit(UpstreamConf("u1", "p1", "m", 2, null), providerWithLimit),
|
||||
)
|
||||
assertEquals(
|
||||
3,
|
||||
effectiveConcurrencyLimit(UpstreamConf("u1", "p1", "m", null, null), providerWithLimit),
|
||||
)
|
||||
assertEquals(
|
||||
Int.MAX_VALUE,
|
||||
effectiveConcurrencyLimit(UpstreamConf("u1", "p2", "m", null, null), providerWithoutLimit),
|
||||
)
|
||||
assertEquals(
|
||||
Int.MAX_VALUE,
|
||||
effectiveConcurrencyLimit(UpstreamConf("u1", "missing", "m", null, null), null),
|
||||
)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun pickFreeUpstreamReturnsFirstFreeInDeclarationOrder() {
|
||||
val active = mapOf("u1" to UpstreamCounter(1), "u2" to UpstreamCounter(2))
|
||||
val pool = listOf(
|
||||
UpstreamConf("u1", "p", "m", 1, null),
|
||||
UpstreamConf("u2", "p", "m", 2, null),
|
||||
)
|
||||
val up = pickFreeUpstream(pool, active, emptySet())
|
||||
assertEquals("u1", up?.id)
|
||||
// слот реально занят
|
||||
assertEquals(1, active.getValue("u1").current)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun pickFreeUpstreamSkipsExcluded() {
|
||||
val active = mapOf("u1" to UpstreamCounter(1), "u2" to UpstreamCounter(2))
|
||||
val pool = listOf(
|
||||
UpstreamConf("u1", "p", "m", 1, null),
|
||||
UpstreamConf("u2", "p", "m", 2, null),
|
||||
)
|
||||
val up = pickFreeUpstream(pool, active, setOf("u1"))
|
||||
assertEquals("u2", up?.id)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun pickFreeUpstreamReturnsNullWhenAllBusy() {
|
||||
val active = mapOf("u1" to UpstreamCounter(1, 1)) // уже на лимите 1
|
||||
val pool = listOf(UpstreamConf("u1", "p", "m", 1, null))
|
||||
assertEquals(null, pickFreeUpstream(pool, active, emptySet()))
|
||||
}
|
||||
|
||||
@Test
|
||||
fun pickFreeUpstreamImplementsFailoverOrder() {
|
||||
// dead исключён (упал ранее) — выбирается следующий живой u1
|
||||
val active = mapOf("dead" to UpstreamCounter(1), "u1" to UpstreamCounter(1))
|
||||
val pool = listOf(
|
||||
UpstreamConf("dead", "p", "m", 1, null),
|
||||
UpstreamConf("u1", "p", "m", 1, null),
|
||||
)
|
||||
val up = pickFreeUpstream(pool, active, setOf("dead"))
|
||||
assertEquals("u1", up?.id)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun pickFreeUpstreamExhaustsConcurrencyThenReturnsNull() {
|
||||
val active = mapOf("u1" to UpstreamCounter(1), "u2" to UpstreamCounter(1))
|
||||
val pool = listOf(
|
||||
UpstreamConf("u1", "p", "m", 1, null),
|
||||
UpstreamConf("u2", "p", "m", 1, null),
|
||||
)
|
||||
assertEquals("u1", pickFreeUpstream(pool, active, emptySet())?.id)
|
||||
assertEquals("u2", pickFreeUpstream(pool, active, emptySet())?.id)
|
||||
assertEquals(null, pickFreeUpstream(pool, active, emptySet())?.id)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun headersToForwardKeepsUnknownAndDropsServiceHeaders() {
|
||||
val req = headersOf(
|
||||
"X-Opencode-Session" to listOf("abc-123"),
|
||||
"X-Custom" to listOf("a", "b"),
|
||||
"Host" to listOf("proxy:8100"),
|
||||
"Content-Length" to listOf("42"),
|
||||
"Transfer-Encoding" to listOf("chunked"),
|
||||
"Connection" to listOf("keep-alive"),
|
||||
"TE" to listOf("trailers"),
|
||||
"Proxy-Connection" to listOf("keep-alive"),
|
||||
"Upgrade" to listOf("h2c"),
|
||||
"Authorization" to listOf("Bearer client-secret"),
|
||||
"Content-Type" to listOf("application/x-www-form-urlencoded"),
|
||||
"Accept" to listOf("*/*"),
|
||||
)
|
||||
val out = headersToForward(req)
|
||||
assertEquals(listOf("abc-123"), out["X-Opencode-Session"])
|
||||
assertEquals(listOf("a", "b"), out["X-Custom"])
|
||||
assertEquals(listOf("*/*"), out["Accept"])
|
||||
assertEquals(3, out.size)
|
||||
assertEquals(null, out["Authorization"])
|
||||
assertEquals(null, out["Content-Type"])
|
||||
}
|
||||
|
||||
@Test
|
||||
fun headersToForwardIsCaseInsensitiveOnSkipSet() {
|
||||
val out = headersToForward(
|
||||
headersOf(
|
||||
"HOST" to listOf("x"),
|
||||
"Content-length" to listOf("1"),
|
||||
"x-opencode-session" to listOf("s"),
|
||||
),
|
||||
)
|
||||
assertEquals(1, out.size)
|
||||
assertEquals(listOf("s"), out["x-opencode-session"])
|
||||
}
|
||||
|
||||
@Test
|
||||
fun formatHeadersForLogMasksSecretsAndKeepsOthers() {
|
||||
val line = formatHeadersForLog(
|
||||
headersOf(
|
||||
"X-Opencode-Session" to listOf("abc-123"),
|
||||
"Authorization" to listOf("Bearer super-secret"),
|
||||
"x-api-key" to listOf("key-1"),
|
||||
"Cookie" to listOf("session=deadbeef"),
|
||||
),
|
||||
)
|
||||
assertTrue(line.contains("X-Opencode-Session=abc-123"))
|
||||
assertTrue(line.contains("Authorization=***"))
|
||||
assertTrue(line.contains("x-api-key=***"))
|
||||
assertTrue(line.contains("Cookie=***"))
|
||||
assertFalse(line.contains("super-secret"))
|
||||
assertFalse(line.contains("deadbeef"))
|
||||
}
|
||||
|
||||
@Test
|
||||
fun formatHeadersForLogJoinsMultipleValues() {
|
||||
val line = formatHeadersForLog(
|
||||
headersOf("X-Custom" to listOf("a", "b")),
|
||||
)
|
||||
assertEquals("X-Custom=a|b", line)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun rebuildFromChunksPreservesAllUpstreamFields() {
|
||||
val sse = """
|
||||
data: {"id":"c1","object":"chat.completion.chunk","created":123,"model":"m","provider":"Baidu","system_fingerprint":"sf1","choices":[{"index":0,"delta":{"role":"assistant","content":"He"},"finish_reason":null}]}
|
||||
|
||||
data: {"id":"c1","created":123,"model":"m","provider":"Baidu","choices":[{"index":0,"delta":{"content":"llo"},"finish_reason":null}]}
|
||||
|
||||
data: {"id":"c1","created":123,"model":"m","provider":"Baidu","choices":[{"index":1,"delta":{"content":"B"},"finish_reason":null}]}
|
||||
|
||||
data: {"id":"c1","created":123,"model":"m","provider":"Baidu","choices":[{"index":0,"delta":{},"finish_reason":"stop"},{"index":1,"delta":{},"finish_reason":"stop"}]}
|
||||
|
||||
data: {"id":"c1","created":123,"model":"m","provider":"Baidu","usage":{"prompt_tokens":1,"completion_tokens":2,"total_tokens":3}}
|
||||
|
||||
data: [DONE]
|
||||
""".trimIndent()
|
||||
|
||||
val out = Json.parseToJsonElement(rebuildFromChunks(sse)).jsonObject
|
||||
assertEquals("c1", out["id"]?.jsonPrimitive?.content)
|
||||
assertEquals("m", out["model"]?.jsonPrimitive?.content)
|
||||
assertEquals("Baidu", out["provider"]?.jsonPrimitive?.content)
|
||||
assertEquals("sf1", out["system_fingerprint"]?.jsonPrimitive?.content)
|
||||
assertEquals("chat.completion", out["object"]?.jsonPrimitive?.content)
|
||||
assertEquals(123, out["created"]?.jsonPrimitive?.content?.toLong())
|
||||
assertEquals(3, out["usage"]?.jsonObject?.get("total_tokens")?.jsonPrimitive?.content?.toInt())
|
||||
val choices = out["choices"]?.jsonArray ?: error("no choices")
|
||||
assertEquals(2, choices.size)
|
||||
assertEquals("Hello", choices[0].jsonObject["message"]?.jsonObject?.get("content")?.jsonPrimitive?.content)
|
||||
assertEquals("B", choices[1].jsonObject["message"]?.jsonObject?.get("content")?.jsonPrimitive?.content)
|
||||
assertEquals("stop", choices[0].jsonObject["finish_reason"]?.jsonPrimitive?.content)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun rebuildFromChunksReturnsUpstreamErrorVerbatim() {
|
||||
val sse = """
|
||||
data: {"id":"c1","error":{"message":"Unsupported field 'foo'","type":"invalid_request"},"choices":[]}
|
||||
|
||||
data: [DONE]
|
||||
""".trimIndent()
|
||||
val out = Json.parseToJsonElement(rebuildFromChunks(sse)).jsonObject
|
||||
val err = out["error"]?.jsonObject ?: error("error block missing")
|
||||
assertEquals("Unsupported field 'foo'", err["message"]?.jsonPrimitive?.content)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun sha256MatchesKnownVectors() {
|
||||
assertEquals(
|
||||
"e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
sha256Hex(""),
|
||||
)
|
||||
assertEquals(
|
||||
"ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad",
|
||||
sha256Hex("abc"),
|
||||
)
|
||||
assertEquals(
|
||||
"248d6a61d20638b8e5c026930c3e6039a33ce45964ff2167f6ecedd419db06c1",
|
||||
sha256Hex("abcdbcdecdefdefgefghfghighijhijkijkljklmklmnlmnomnopnopq"),
|
||||
)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun sessionPrefixHashesAreStableWhenHistoryGrows() {
|
||||
val first = Json.parseToJsonElement(
|
||||
"""{"messages":[{"role":"system","content":"S"},{"role":"user","content":"hi"}]}""",
|
||||
).jsonObject
|
||||
val second = Json.parseToJsonElement(
|
||||
"""{"messages":[{"role":"system","content":"S"},{"role":"user","content":"hi"},{"role":"assistant","content":"yo"},{"role":"user","content":"again"}]}""",
|
||||
).jsonObject
|
||||
|
||||
val h1 = sessionPrefixHashes(first)
|
||||
val h2 = sessionPrefixHashes(second)
|
||||
|
||||
// Цепочка начинается с первого user — system-преамбула не хэшируется.
|
||||
assertEquals(1, h1.size)
|
||||
assertEquals(3, h2.size)
|
||||
assertEquals(h1, h2.take(1))
|
||||
assertEquals(h1.last(), h2[0])
|
||||
}
|
||||
|
||||
@Test
|
||||
fun sessionPrefixHashesIgnoreLeadingSystemSoSharedPromptDoesNotCollide() {
|
||||
val a = Json.parseToJsonElement(
|
||||
"""{"messages":[{"role":"system","content":"SAME"},{"role":"user","content":"session A"}]}""",
|
||||
).jsonObject
|
||||
val b = Json.parseToJsonElement(
|
||||
"""{"messages":[{"role":"system","content":"SAME"},{"role":"user","content":"session B"}]}""",
|
||||
).jsonObject
|
||||
// разные первые user-сообщения → разные хэши, несмотря на общий system
|
||||
assertFalse(sessionPrefixHashes(a) == sessionPrefixHashes(b))
|
||||
}
|
||||
|
||||
@Test
|
||||
fun sessionPrefixHashesFallBackToWholeBodyWithoutMessages() {
|
||||
val body = Json.parseToJsonElement("""{"model":"m"}""").jsonObject
|
||||
assertEquals(listOf(sha256Hex(body.toString())), sessionPrefixHashes(body))
|
||||
}
|
||||
|
||||
@Test
|
||||
fun sessionRegistryReusesIdByLongestCommonPrefix() {
|
||||
val reg = SessionRegistry()
|
||||
val first = reg.resolveLocked(listOf("H1"), 0)
|
||||
assertEquals("H1", first)
|
||||
|
||||
// история выросла: [H1, H2, H3] — самый длинный известный префикс H1
|
||||
val next = reg.resolveLocked(listOf("H1", "H2", "H3"), 1)
|
||||
assertEquals("H1", next)
|
||||
|
||||
// и дальше — id не меняется
|
||||
val deep = reg.resolveLocked(listOf("H1", "H2", "H3", "H4"), 2)
|
||||
assertEquals("H1", deep)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun sessionRegistryCreatesNewIdForDifferentHistory() {
|
||||
val reg = SessionRegistry()
|
||||
assertEquals("A1", reg.resolveLocked(listOf("A1"), 0))
|
||||
assertEquals("B1", reg.resolveLocked(listOf("B1"), 0))
|
||||
assertEquals("A1", reg.resolveLocked(listOf("A1", "A2"), 0))
|
||||
}
|
||||
|
||||
@Test
|
||||
fun sessionRegistryEvictsLruWhenOverCapacity() {
|
||||
val reg = SessionRegistry(maxSessions = 2, ttlMillis = Long.MAX_VALUE)
|
||||
reg.resolveLocked(listOf("A1"), 0)
|
||||
reg.resolveLocked(listOf("B1"), 1)
|
||||
reg.resolveLocked(listOf("C1"), 2) // A вытеснена
|
||||
// a1 больше неизвестен → новая сессия с id = хэш всей истории A2
|
||||
assertEquals("A2", reg.resolveLocked(listOf("A1", "A2"), 3))
|
||||
}
|
||||
|
||||
@Test
|
||||
fun sessionRegistryEvictsExpiredByTtl() {
|
||||
val reg = SessionRegistry(maxSessions = 100, ttlMillis = 1000)
|
||||
reg.resolveLocked(listOf("A1"), 0)
|
||||
reg.resolveLocked(listOf("B1"), 2000) // A протухла
|
||||
assertEquals("A2", reg.resolveLocked(listOf("A1", "A2"), 2001))
|
||||
}
|
||||
|
||||
@Test
|
||||
fun parseConfigReadsSessionHeader() {
|
||||
val yaml = """
|
||||
providers:
|
||||
- id: p1
|
||||
url: "https://x.ru/api/v1"
|
||||
session_header: x-opencode-session
|
||||
- id: p2
|
||||
url: "https://y.ru/api/v1"
|
||||
models:
|
||||
- name: m1
|
||||
upstreams: []
|
||||
""".trimIndent()
|
||||
val cfg = parseConfig(Yaml.decodeYamlFromString(yaml))
|
||||
assertEquals("x-opencode-session", cfg.providers[0].session_header)
|
||||
assertEquals(null, cfg.providers[1].session_header)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun parseConfigReadsThinkTagsOnProviderAndUpstream() {
|
||||
val yaml = """
|
||||
providers:
|
||||
- id: p1
|
||||
url: "https://x.ru/api/v1"
|
||||
think_tags: split
|
||||
- id: p2
|
||||
url: "https://y.ru/api/v1"
|
||||
upstreams:
|
||||
- id: u1
|
||||
provider: p1
|
||||
model: real-1
|
||||
think_tags: strip
|
||||
- id: u2
|
||||
provider: p1
|
||||
model: real-2
|
||||
models:
|
||||
- name: m1
|
||||
upstreams: [u1, u2]
|
||||
""".trimIndent()
|
||||
|
||||
val cfg = parseConfig(Yaml.decodeYamlFromString(yaml))
|
||||
|
||||
assertEquals("split", cfg.providers[0].think_tags)
|
||||
assertEquals(null, cfg.providers[1].think_tags)
|
||||
assertEquals("strip", cfg.upstreams[0].think_tags)
|
||||
assertEquals(null, cfg.upstreams[1].think_tags)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun effectiveThinkTagsPrefersUpstreamThenProviderWithTolerantParse() {
|
||||
val upSplit = UpstreamConf("u1", "p", "m", think_tags = "split")
|
||||
val upNull = UpstreamConf("u2", "p", "m", think_tags = null)
|
||||
val prov = { tt: String? -> ProviderConf("p", "https://x", think_tags = tt) }
|
||||
|
||||
// значение у апстрима — берётся оно, провайдер игнорируется
|
||||
assertEquals("split", effectiveThinkTags(upSplit, null))
|
||||
assertEquals("split", effectiveThinkTags(upSplit, prov("strip")))
|
||||
|
||||
// апстрим null — берётся провайдерский
|
||||
assertEquals("split", effectiveThinkTags(upNull, prov("split")))
|
||||
assertEquals("strip", effectiveThinkTags(upNull, prov("strip")))
|
||||
assertEquals("split", effectiveThinkTags(upNull, prov("true")))
|
||||
assertEquals("off", effectiveThinkTags(upNull, prov("false")))
|
||||
assertEquals("off", effectiveThinkTags(upNull, prov("yes")))
|
||||
|
||||
// нигде нет — "off"
|
||||
assertEquals("off", effectiveThinkTags(upNull, prov(null)))
|
||||
assertEquals("off", effectiveThinkTags(upNull, null))
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,179 @@
|
||||
package pw.binom.llmproxy
|
||||
|
||||
import kotlin.test.Test
|
||||
import kotlin.test.assertEquals
|
||||
import kotlin.test.assertFalse
|
||||
import kotlin.test.assertNotNull
|
||||
import kotlin.test.assertNull
|
||||
import kotlinx.serialization.json.Json
|
||||
import kotlinx.serialization.json.JsonObject
|
||||
import kotlinx.serialization.json.jsonArray
|
||||
import kotlinx.serialization.json.jsonObject
|
||||
import kotlinx.serialization.json.jsonPrimitive
|
||||
|
||||
class ThinkTagChunkTest {
|
||||
|
||||
// Литералы тегов OPEN/CLOSE из ThinkTagSplitter собираем из символьных
|
||||
// кусочков, чтобы не записывать тег единой строкой в исходнике.
|
||||
private val openTag = '<' + "think" + '>'
|
||||
private val closeTag = '<' + "/think" + '>'
|
||||
// Маркер рассуждения (5 букв) собираем из Unicode-кодов, без единой строки.
|
||||
private val reasoning = listOf(0x0420, 0x0410, 0x0417, 0x0423, 0x041C)
|
||||
.map { Char(it) }
|
||||
.joinToString("")
|
||||
|
||||
private fun deltaOf(result: String, index: Int): JsonObject =
|
||||
Json.parseToJsonElement(result).jsonObject
|
||||
.get("choices")!!.jsonArray[index].jsonObject
|
||||
.get("delta")!!.jsonObject
|
||||
|
||||
@Test
|
||||
fun chunkSplitHoldsTailAcrossChunks() {
|
||||
// Хвост открывающего тега, разрезанный на границе чанков, переживает
|
||||
// два отдельных вызова через общий splitters (getOrPut по index).
|
||||
val splitters = mutableMapOf<Int, ThinkTagSplitter>()
|
||||
|
||||
// Чанк 1: текст + обрезанный префикс открывающего тега (не завершает тег).
|
||||
val prefix = openTag.dropLast(1)
|
||||
val obj1 = Json.parseToJsonElement(
|
||||
"""{"choices":[{"index":0,"delta":{"content":"текст$prefix"}}]}""",
|
||||
).jsonObject
|
||||
val r1 = transformThinkChunk(obj1, splitters, "split", true)
|
||||
assertNotNull(r1)
|
||||
val d1 = deltaOf(r1, 0)
|
||||
assertEquals("текст", d1["content"]!!.jsonPrimitive.content)
|
||||
assertFalse(d1.containsKey("reasoning_content"))
|
||||
|
||||
// Чанк 2 (тот же splitters): остаток открывающего тега + маркер.
|
||||
val rest = openTag.last()
|
||||
val obj2 = Json.parseToJsonElement(
|
||||
"""{"choices":[{"index":0,"delta":{"content":"$rest$reasoning"}}]}""",
|
||||
).jsonObject
|
||||
val r2 = transformThinkChunk(obj2, splitters, "split", true)
|
||||
assertNotNull(r2)
|
||||
val d2 = deltaOf(r2, 0)
|
||||
assertFalse(d2.containsKey("content"))
|
||||
assertEquals(reasoning, d2["reasoning_content"]!!.jsonPrimitive.content)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun chunkStripRemovesReasoning() {
|
||||
// Режим strip: блок целиком (теги + рассуждения) вырезается,
|
||||
// content склеивается в «AB», ключа reasoning_content нет.
|
||||
val splitters = mutableMapOf<Int, ThinkTagSplitter>()
|
||||
val c = "A" + openTag + reasoning + closeTag + "B"
|
||||
val obj = Json.parseToJsonElement(
|
||||
"""{"choices":[{"index":0,"delta":{"content":"$c"}}]}""",
|
||||
).jsonObject
|
||||
val r = transformThinkChunk(obj, splitters, "strip", false)
|
||||
assertNotNull(r)
|
||||
val d = deltaOf(r, 0)
|
||||
assertEquals("AB", d["content"]!!.jsonPrimitive.content)
|
||||
assertFalse(d.containsKey("reasoning_content"))
|
||||
}
|
||||
|
||||
@Test
|
||||
fun chunkDropsEmptyContentFieldWhenAllGoesToReasoning() {
|
||||
// Режим split: весь контент чанка — think-блок, поэтому content пуст
|
||||
// и ключ убирается из delta, а рассуждения уходят в reasoning_content.
|
||||
val splitters = mutableMapOf<Int, ThinkTagSplitter>()
|
||||
val c = openTag + reasoning + closeTag
|
||||
val obj = Json.parseToJsonElement(
|
||||
"""{"choices":[{"index":0,"delta":{"content":"$c"}}]}""",
|
||||
).jsonObject
|
||||
val r = transformThinkChunk(obj, splitters, "split", true)
|
||||
assertNotNull(r)
|
||||
val d = deltaOf(r, 0)
|
||||
assertFalse(d.containsKey("content"))
|
||||
assertEquals(reasoning, d["reasoning_content"]!!.jsonPrimitive.content)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun chunkReturnsNullWhenNoChoices() {
|
||||
// Нет ключа choices — чанк не трогаем, отдаём исходную строку (null).
|
||||
val splitters = mutableMapOf<Int, ThinkTagSplitter>()
|
||||
val obj = Json.parseToJsonElement("""{"model":"m"}""").jsonObject
|
||||
assertNull(transformThinkChunk(obj, splitters, "split", true))
|
||||
}
|
||||
|
||||
@Test
|
||||
fun chunkReturnsNullWhenDeltaContentNotAString() {
|
||||
// content = null (JsonNull) и content = массив частей — не строка,
|
||||
// значит choice не трогаем, весь чанк не меняется -> null.
|
||||
val s1 = mutableMapOf<Int, ThinkTagSplitter>()
|
||||
val o1 = Json.parseToJsonElement(
|
||||
"""{"choices":[{"index":0,"delta":{"content":null}}]}""",
|
||||
).jsonObject
|
||||
assertNull(transformThinkChunk(o1, s1, "split", true))
|
||||
|
||||
val s2 = mutableMapOf<Int, ThinkTagSplitter>()
|
||||
val o2 = Json.parseToJsonElement(
|
||||
"""{"choices":[{"index":0,"delta":{"content":[{"type":"text","text":"hi"}]}}]}""",
|
||||
).jsonObject
|
||||
assertNull(transformThinkChunk(o2, s2, "split", true))
|
||||
}
|
||||
|
||||
@Test
|
||||
fun chunkSeparateSplittersPerIndex() {
|
||||
// Один объект splitters на все три вызова: по каждому index держим
|
||||
// своего сплиттера, поэтому обрезанные хвосты по index не путаются.
|
||||
val splitters = mutableMapOf<Int, ThinkTagSplitter>()
|
||||
val prefix = openTag.dropLast(1)
|
||||
val rest = openTag.last()
|
||||
|
||||
// Вызов 1: два choice — index 0 «A»+префикс тега, index 1 «B»+тот же префикс.
|
||||
val c1 = """{"choices":[{"index":0,"delta":{"content":"A$prefix"}},{"index":1,"delta":{"content":"B$prefix"}}]}"""
|
||||
val r1 = transformThinkChunk(Json.parseToJsonElement(c1).jsonObject, splitters, "split", true)
|
||||
assertNotNull(r1)
|
||||
|
||||
// Вызов 2: index 1 получает остаток тега + маркер → рассуждения у index 1.
|
||||
val c2 = """{"choices":[{"index":1,"delta":{"content":"$rest${reasoning}1"}}]}"""
|
||||
val r2 = transformThinkChunk(Json.parseToJsonElement(c2).jsonObject, splitters, "split", true)
|
||||
assertNotNull(r2)
|
||||
val d2 = deltaOf(r2, 0)
|
||||
assertEquals(reasoning + "1", d2["reasoning_content"]!!.jsonPrimitive.content)
|
||||
|
||||
// Вызов 3: index 0 получает остаток тега + маркер → рассуждения у index 0.
|
||||
val c3 = """{"choices":[{"index":0,"delta":{"content":"$rest${reasoning}0"}}]}"""
|
||||
val r3 = transformThinkChunk(Json.parseToJsonElement(c3).jsonObject, splitters, "split", true)
|
||||
assertNotNull(r3)
|
||||
val d3 = deltaOf(r3, 0)
|
||||
assertEquals(reasoning + "0", d3["reasoning_content"]!!.jsonPrimitive.content)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun chunkKeepsUntouchedChoiceAndFinishReason() {
|
||||
// Первый choice целиком идёт через split; второй без ключа content
|
||||
// (в нём только finish_reason) — остаётся нетронутым, как и был.
|
||||
val splitters = mutableMapOf<Int, ThinkTagSplitter>()
|
||||
val c = "A" + openTag + reasoning + closeTag + "B"
|
||||
val c1 = """{"choices":[{"index":0,"delta":{"content":"$c"}},{"index":1,"delta":{"finish_reason":"stop"}}]}"""
|
||||
val r = transformThinkChunk(Json.parseToJsonElement(c1).jsonObject, splitters, "split", true)
|
||||
assertNotNull(r)
|
||||
val d0 = deltaOf(r, 0)
|
||||
assertEquals("AB", d0["content"]!!.jsonPrimitive.content)
|
||||
assertEquals(reasoning, d0["reasoning_content"]!!.jsonPrimitive.content)
|
||||
val d1 = deltaOf(r, 1)
|
||||
assertEquals("stop", d1["finish_reason"]!!.jsonPrimitive.content)
|
||||
assertFalse(d1.containsKey("content"))
|
||||
}
|
||||
|
||||
@Test
|
||||
fun chunkIndexDefaultsToZeroWhenAbsent() {
|
||||
// Ключ index отсутствует — оба раза используем сплиттер под индекс 0,
|
||||
// поэтому хвост первого чанка доживал до рассуждений второго.
|
||||
val splitters = mutableMapOf<Int, ThinkTagSplitter>()
|
||||
val prefix = openTag.dropLast(1)
|
||||
val rest = openTag.last()
|
||||
|
||||
val c1 = """{"choices":[{"delta":{"content":"A$prefix"}}]}"""
|
||||
val r1 = transformThinkChunk(Json.parseToJsonElement(c1).jsonObject, splitters, "split", true)
|
||||
assertNotNull(r1)
|
||||
|
||||
val c2 = """{"choices":[{"delta":{"content":"$rest$reasoning"}}]}"""
|
||||
val r2 = transformThinkChunk(Json.parseToJsonElement(c2).jsonObject, splitters, "split", true)
|
||||
assertNotNull(r2)
|
||||
val d2 = deltaOf(r2, 0)
|
||||
assertEquals(reasoning, d2["reasoning_content"]!!.jsonPrimitive.content)
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,75 @@
|
||||
package pw.binom.llmproxy
|
||||
|
||||
import kotlin.test.Test
|
||||
import kotlin.test.assertEquals
|
||||
|
||||
class ThinkTagSplitterTest {
|
||||
|
||||
@Test
|
||||
fun offIsPassthroughEvenWithTags() {
|
||||
val s = ThinkTagSplitter("off")
|
||||
assertEquals("<think>x</think>" to "", s.feed("<think>x</think>"))
|
||||
assertEquals("привет\nещё" to "", s.feed("привет\nещё"))
|
||||
assertEquals("" to "", s.finish())
|
||||
}
|
||||
|
||||
@Test
|
||||
fun splitWholeBlockMovesInnerTextToReasoning() {
|
||||
val s = ThinkTagSplitter("split")
|
||||
assertEquals("a" to "r", s.feed("<think>r</think>a"))
|
||||
assertEquals("" to "", s.finish())
|
||||
}
|
||||
|
||||
@Test
|
||||
fun splitTagCutAcrossThreeChunks() {
|
||||
val s = ThinkTagSplitter("split")
|
||||
val first = s.feed("привет <t")
|
||||
assertEquals("привет ", first.first)
|
||||
assertEquals("", first.second)
|
||||
assertEquals("" to "", s.feed("hi"))
|
||||
val third = s.feed("nk>разум")
|
||||
assertEquals("", third.first)
|
||||
assertEquals("разум", third.second)
|
||||
assertEquals("" to "", s.finish())
|
||||
}
|
||||
|
||||
@Test
|
||||
fun splitUnclosedOpenTagLeavesRestInReasoning() {
|
||||
val s = ThinkTagSplitter("split")
|
||||
assertEquals("" to "мысли без конца", s.feed("<think>мысли без конца"))
|
||||
assertEquals("" to "", s.finish())
|
||||
|
||||
// хвост-префикс незакрытого закрывающего тега тоже уезжает в reasoning
|
||||
val s2 = ThinkTagSplitter("split")
|
||||
assertEquals("" to "abc", s2.feed("<think>abc</thi"))
|
||||
assertEquals("" to "</thi", s2.finish())
|
||||
}
|
||||
|
||||
@Test
|
||||
fun splitHandlesSeveralBlocksInOneResponse() {
|
||||
val s = ThinkTagSplitter("split")
|
||||
val first = s.feed("<think>A</think>B<think>C</think>")
|
||||
assertEquals("B", first.first)
|
||||
assertEquals("AC", first.second)
|
||||
assertEquals("text" to "", s.feed("text"))
|
||||
assertEquals("" to "", s.finish())
|
||||
}
|
||||
|
||||
@Test
|
||||
fun stripDropsReasoningAndTags() {
|
||||
val s = ThinkTagSplitter("strip")
|
||||
assertEquals("y" to "", s.feed("<think>x</think>y"))
|
||||
assertEquals("" to "", s.feed("<think>z"))
|
||||
assertEquals("" to "", s.finish())
|
||||
}
|
||||
|
||||
@Test
|
||||
fun heldTailThatTurnedOutNotToBeATagFlowsBackAsContent() {
|
||||
val s = ThinkTagSplitter("split")
|
||||
// "<thi" — полный префикс открывающего тега: хвост держим
|
||||
assertEquals("" to "", s.feed("<thi"))
|
||||
// "x" не продолжает тег: хвост отдаём как обычный текст
|
||||
assertEquals("<thix" to "", s.feed("x"))
|
||||
assertEquals("" to "", s.finish())
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,179 @@
|
||||
package pw.binom.llmproxy
|
||||
|
||||
import io.ktor.utils.io.ByteChannel
|
||||
import io.ktor.utils.io.close
|
||||
import io.ktor.utils.io.readAvailable
|
||||
import io.ktor.utils.io.writeFully
|
||||
import kotlin.test.Test
|
||||
import kotlin.test.assertEquals
|
||||
import kotlin.test.assertTrue
|
||||
import kotlinx.coroutines.test.runTest
|
||||
import kotlinx.serialization.json.Json
|
||||
import kotlinx.serialization.json.JsonObject
|
||||
import kotlinx.serialization.json.jsonArray
|
||||
import kotlinx.serialization.json.jsonObject
|
||||
import kotlinx.serialization.json.jsonPrimitive
|
||||
|
||||
class ThinkTagStreamTest {
|
||||
|
||||
/** Прогнать SSE-текст через боевую обвязку и вернуть то, что она записала. */
|
||||
private suspend fun runStream(input: String, mode: String): String {
|
||||
val src = ByteChannel(autoFlush = true)
|
||||
src.writeFully(input.encodeToByteArray())
|
||||
src.close(null)
|
||||
val out = ByteChannel(autoFlush = true)
|
||||
out.streamSseWithThinkTags(src, mode)
|
||||
out.close(null)
|
||||
val sb = StringBuilder()
|
||||
val buf = ByteArray(512)
|
||||
while (true) {
|
||||
val n = out.readAvailable(buf)
|
||||
if (n == -1) break
|
||||
if (n > 0) sb.append(buf.decodeToString(0, n))
|
||||
}
|
||||
return sb.toString()
|
||||
}
|
||||
|
||||
// Литералы тегов OPEN/CLOSE из ThinkTagSplitter собираем из символьных
|
||||
// кусочков, чтобы не записывать тег единой строкой в исходнике.
|
||||
private val openTag = '<' + "think" + '>'
|
||||
private val closeTag = '<' + "/think" + '>'
|
||||
// Маркер рассуждения (5 букв) собираем из Unicode-кодов, без единой строки.
|
||||
private val reasoning = listOf(0x0420, 0x0410, 0x0417, 0x0423, 0x041C)
|
||||
.map { Char(it) }
|
||||
.joinToString("")
|
||||
|
||||
/** JSON-нагрузки из data-строк вывода (строки, начинающиеся с «data:»), без служебного [DONE]. */
|
||||
private fun dataPayloads(sse: String): List<String> =
|
||||
sse.lines()
|
||||
.filter { it.startsWith("data:") && it.removePrefix("data:").trim() != "[DONE]" }
|
||||
.map { it.removePrefix("data:").trim() }
|
||||
|
||||
private fun deltaOf(result: String, index: Int): JsonObject =
|
||||
Json.parseToJsonElement(result).jsonObject
|
||||
.get("choices")!!.jsonArray[index].jsonObject
|
||||
.get("delta")!!.jsonObject
|
||||
|
||||
@Test
|
||||
fun streamDoneAndServiceLinesPassThrough() = runTest {
|
||||
// Служебные строки SSE и маркер конца потока должны дойти до клиента без изменений.
|
||||
val input = buildString {
|
||||
append("data: {\"choices\":[{\"index\":0,\"delta\":{\"content\":\"hi\"}}]}\n")
|
||||
append("\n")
|
||||
append("data: [DONE]\n")
|
||||
append("\n")
|
||||
append("event: ping\n")
|
||||
append("\n")
|
||||
append(": keep-alive\n")
|
||||
append("\n")
|
||||
}
|
||||
|
||||
val out = runStream(input, "split")
|
||||
|
||||
assertTrue(out.contains("data: [DONE]"), "маркер конца потока потерян: $out")
|
||||
assertTrue(out.contains("event: ping"), "служебная строка event потеряна: $out")
|
||||
assertTrue(out.contains(": keep-alive"), "строка-комментарий потеряна: $out")
|
||||
assertTrue(out.contains("hi"), "текстовый чанк потерян: $out")
|
||||
}
|
||||
|
||||
@Test
|
||||
fun streamSplitsReasoningAcrossDataChunks() = runTest {
|
||||
// Хвост открывающего тега разрезан на границе двух data-событий: первое
|
||||
// отдаёт content «A» и хвост держит, второе завершает тег и блок.
|
||||
val prefix = openTag.take(3)
|
||||
val rest = openTag.drop(3)
|
||||
val content2 = rest + reasoning + closeTag + "B"
|
||||
val input = buildString {
|
||||
append("data: {\"choices\":[{\"index\":0,\"delta\":{\"content\":\"A$prefix\"}}]}\n")
|
||||
append("\n")
|
||||
append("data: {\"choices\":[{\"index\":0,\"delta\":{\"content\":\"$content2\"}}]}\n")
|
||||
append("\n")
|
||||
}
|
||||
|
||||
val out = runStream(input, "split")
|
||||
val payloads = dataPayloads(out)
|
||||
|
||||
val last = deltaOf(payloads.last(), 0)
|
||||
assertEquals("B", last["content"]!!.jsonPrimitive.content)
|
||||
assertEquals(reasoning, last["reasoning_content"]!!.jsonPrimitive.content)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun streamUnclosedBlockCarriesReasoningInSameChunk() = runTest {
|
||||
// Незакрытый think-блок в конце потока: reasoning отдаётся сразу в том же
|
||||
// чанке, где пришёл, финиш-чанка не появляется — удержанного хвоста нет.
|
||||
val content = "A" + openTag + "МЫСЛИ"
|
||||
val input = buildString {
|
||||
append("data: {\"choices\":[{\"index\":0,\"delta\":{\"content\":\"$content\"}}]}\n")
|
||||
append("\n")
|
||||
}
|
||||
|
||||
val payloads = dataPayloads(runStream(input, "split"))
|
||||
|
||||
assertEquals(1, payloads.size, "финиш-чанка быть не должно: $payloads")
|
||||
val delta = deltaOf(payloads.single(), 0)
|
||||
assertEquals("A", delta["content"]!!.jsonPrimitive.content)
|
||||
assertEquals("МЫСЛИ", delta["reasoning_content"]!!.jsonPrimitive.content)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun streamFlushesHeldTailOnFinish() = runTest {
|
||||
// Поток обрывается на неполном префиксе открывающего тега: удержанный
|
||||
// хвост не теряется и сбрасывается финиш-чанком в конце.
|
||||
val tail = openTag.take(3)
|
||||
val input = buildString {
|
||||
append("data: {\"choices\":[{\"index\":0,\"delta\":{\"content\":\"A$tail\"}}]}\n")
|
||||
append("\n")
|
||||
}
|
||||
|
||||
val payloads = dataPayloads(runStream(input, "split"))
|
||||
|
||||
assertEquals(2, payloads.size, "финиш-чанк с удержанным хвостом потерян: $payloads")
|
||||
val flushed = deltaOf(payloads.last(), 0)
|
||||
assertEquals(tail, flushed["content"]!!.jsonPrimitive.content)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun streamInvalidJsonPassesThroughVerbatim() = runTest {
|
||||
// data-строка, которая не является JSON, доходит до клиента без изменений.
|
||||
val input = buildString {
|
||||
append("data: {это не json\n")
|
||||
append("\n")
|
||||
}
|
||||
|
||||
val out = runStream(input, "split")
|
||||
|
||||
assertTrue(out.contains("data: {это не json"), "битая строка не дошла как есть: $out")
|
||||
}
|
||||
|
||||
@Test
|
||||
fun streamChunkWithoutChoicesPassesThrough() = runTest {
|
||||
// Чанк с пустыми choices не меняется и уходит клиенту исходной строкой.
|
||||
val input = buildString {
|
||||
append("data: {\"usage\":{\"total_tokens\":5},\"choices\":[]}\n")
|
||||
append("\n")
|
||||
}
|
||||
|
||||
val out = runStream(input, "split")
|
||||
|
||||
assertTrue(out.contains("\"total_tokens\":5"), "чанк с usage изменился: $out")
|
||||
}
|
||||
|
||||
@Test
|
||||
fun streamModeStripEmitsNoReasoning() = runTest {
|
||||
// Режим strip: текст внутри think-тегов выбрасывается, поля
|
||||
// reasoning_content нет, обычный текст остаётся.
|
||||
val content = "A" + openTag + reasoning + closeTag + "B"
|
||||
val input = buildString {
|
||||
append("data: {\"choices\":[{\"index\":0,\"delta\":{\"content\":\"$content\"}}]}\n")
|
||||
append("\n")
|
||||
}
|
||||
|
||||
val out = runStream(input, "strip")
|
||||
val payloads = dataPayloads(out)
|
||||
|
||||
assertTrue(!out.contains("reasoning_content"), "в режиме strip не должно быть reasoning_content: $out")
|
||||
assertEquals(1, payloads.size, "ожидался ровно один чанк: $payloads")
|
||||
assertEquals("AB", deltaOf(payloads.single(), 0)["content"]!!.jsonPrimitive.content, "теги и рассуждение должны быть вырезаны: $payloads")
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,174 @@
|
||||
package pw.binom.llmproxy
|
||||
|
||||
import kotlin.test.Test
|
||||
import kotlin.test.assertEquals
|
||||
import kotlin.test.assertFalse
|
||||
import kotlin.test.assertNotNull
|
||||
import kotlin.test.assertNull
|
||||
import kotlinx.serialization.json.Json
|
||||
import kotlinx.serialization.json.JsonObject
|
||||
import kotlinx.serialization.json.jsonArray
|
||||
import kotlinx.serialization.json.jsonObject
|
||||
import kotlinx.serialization.json.jsonPrimitive
|
||||
|
||||
class ThinkTagTransformTest {
|
||||
|
||||
// Точные литералы тегов из ThinkTagSplitter (OPEN/CLOSE): собираем из
|
||||
// отдельных символов, чтобы не писать тег единой строкой в исходнике.
|
||||
private val openTag = '<' + "think" + '>'
|
||||
private val closeTag = '<' + "/think" + '>'
|
||||
|
||||
private fun messageOf(result: String, index: Int): JsonObject =
|
||||
Json.parseToJsonElement(result).jsonObject
|
||||
.get("choices")!!.jsonArray[index].jsonObject
|
||||
.get("message")!!.jsonObject
|
||||
|
||||
@Test
|
||||
fun splitSingleBlockMovesReasoningAndKeepsOtherFields() {
|
||||
// Проверяем: в режиме split содержимое блока уходит в reasoning_content,
|
||||
// в content остаётся «AB», а служебные поля (model, usage, …) не тронуты.
|
||||
val c = "A" + openTag + "РАЗУМ" + closeTag + "B"
|
||||
val obj = Json.parseToJsonElement(
|
||||
"""
|
||||
{"id":"c1","object":"chat.completion","created":123,"model":"m1",
|
||||
"usage":{"prompt_tokens":1,"completion_tokens":2,"total_tokens":3},
|
||||
"system_fingerprint":"sf1",
|
||||
"choices":[{"index":0,"message":{"role":"assistant","content":"$c"},"finish_reason":"stop"}]}
|
||||
""".trimIndent(),
|
||||
).jsonObject
|
||||
|
||||
val result = transformThinkMessage(obj, "split")
|
||||
assertNotNull(result)
|
||||
val out = Json.parseToJsonElement(result).jsonObject
|
||||
val msg = out.get("choices")!!.jsonArray[0].jsonObject.get("message")!!.jsonObject
|
||||
assertEquals("AB", msg["content"]!!.jsonPrimitive.content)
|
||||
assertEquals("РАЗУМ", msg["reasoning_content"]!!.jsonPrimitive.content)
|
||||
assertEquals("m1", out["model"]!!.jsonPrimitive.content)
|
||||
assertEquals(3, out["usage"]!!.jsonObject["total_tokens"]!!.jsonPrimitive.content.toInt())
|
||||
}
|
||||
|
||||
@Test
|
||||
fun splitTwoBlocksConcatenateInOrder() {
|
||||
// Проверяем порядок конкатенации reasoning, когда два think-блока идут подряд.
|
||||
val c = openTag + "ПЕРВЫЙ" + closeTag + "X" + openTag + "ВТОРОЙ" + closeTag
|
||||
val obj = Json.parseToJsonElement(
|
||||
"""{"choices":[{"index":0,"message":{"content":"$c"}}]}""",
|
||||
).jsonObject
|
||||
|
||||
val result = transformThinkMessage(obj, "split")
|
||||
assertNotNull(result)
|
||||
val msg = messageOf(result, 0)
|
||||
assertEquals("X", msg["content"]!!.jsonPrimitive.content)
|
||||
assertEquals("ПЕРВЫЙВТОРОЙ", msg["reasoning_content"]!!.jsonPrimitive.content)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun splitAppendsToExistingReasoningContent() {
|
||||
// Проверяем, что прежнее reasoning_content не теряется, а новое дописывается.
|
||||
val c = openTag + "NEW" + closeTag
|
||||
val obj = Json.parseToJsonElement(
|
||||
"""{"choices":[{"message":{"content":"$c","reasoning_content":"OLD"}}]}""",
|
||||
).jsonObject
|
||||
|
||||
val result = transformThinkMessage(obj, "split")
|
||||
assertNotNull(result)
|
||||
val msg = messageOf(result, 0)
|
||||
assertEquals("OLDNEW", msg["reasoning_content"]!!.jsonPrimitive.content)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun splitUnclosedTagGoesToReasoning() {
|
||||
// Проверяем, что незакрытый открывающий тег уводит хвост целиком в reasoning.
|
||||
val c = "текст" + openTag + "мысли"
|
||||
val obj = Json.parseToJsonElement(
|
||||
"""{"choices":[{"message":{"content":"$c"}}]}""",
|
||||
).jsonObject
|
||||
|
||||
val result = transformThinkMessage(obj, "split")
|
||||
assertNotNull(result)
|
||||
val msg = messageOf(result, 0)
|
||||
assertEquals("текст", msg["content"]!!.jsonPrimitive.content)
|
||||
assertEquals("мысли", msg["reasoning_content"]!!.jsonPrimitive.content)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun stripRemovesTagsAndLeavesNoReasoningKey() {
|
||||
// Проверяем: в режиме strip теги и рассуждения вырезаются,
|
||||
// а ключ reasoning_content в message отсутствует вовсе.
|
||||
val c = "A" + openTag + "РАЗУМ" + closeTag + "B"
|
||||
val obj = Json.parseToJsonElement(
|
||||
"""{"choices":[{"message":{"content":"$c"}}]}""",
|
||||
).jsonObject
|
||||
|
||||
val result = transformThinkMessage(obj, "strip")
|
||||
assertNotNull(result)
|
||||
val msg = messageOf(result, 0)
|
||||
assertEquals("AB", msg["content"]!!.jsonPrimitive.content)
|
||||
assertFalse(msg.containsKey("reasoning_content"))
|
||||
}
|
||||
|
||||
@Test
|
||||
fun missingChoicesReturnsNull() {
|
||||
// Проверяем: без ключа choices функция не вносит изменений (null).
|
||||
val obj = Json.parseToJsonElement(
|
||||
"""{"id":"c1","model":"m1"}""",
|
||||
).jsonObject
|
||||
assertNull(transformThinkMessage(obj, "split"))
|
||||
}
|
||||
|
||||
@Test
|
||||
fun nonStringContentReturnsNull() {
|
||||
// content = null (JsonNull) — менять нечего, функция возвращает null.
|
||||
val nullContent = Json.parseToJsonElement(
|
||||
"""{"choices":[{"message":{"content":null}}]}""",
|
||||
).jsonObject
|
||||
assertNull(transformThinkMessage(nullContent, "split"))
|
||||
|
||||
// content = массив частей (JsonArray) — тоже не трогаем, null.
|
||||
val arrayContent = Json.parseToJsonElement(
|
||||
"""{"choices":[{"message":{"content":[{"type":"text","text":"hi"}]}}]}""",
|
||||
).jsonObject
|
||||
assertNull(transformThinkMessage(arrayContent, "split"))
|
||||
}
|
||||
|
||||
@Test
|
||||
fun twoChoicesEachKeepOwnThinkBlock() {
|
||||
// Проверяем, что каждый choice обрабатывается независимо: у каждого свой
|
||||
// вырезанный content и свой reasoning_content.
|
||||
val c0 = "А" + openTag + "А-раз" + closeTag + "Б"
|
||||
val c1 = "В" + openTag + "В-раз" + closeTag + "Г"
|
||||
val obj = Json.parseToJsonElement(
|
||||
"""
|
||||
{"choices":[
|
||||
{"index":0,"message":{"content":"$c0"},"finish_reason":"stop"},
|
||||
{"index":1,"message":{"content":"$c1"},"finish_reason":"stop"}]}
|
||||
""".trimIndent(),
|
||||
).jsonObject
|
||||
|
||||
val result = transformThinkMessage(obj, "split")
|
||||
assertNotNull(result)
|
||||
val out = Json.parseToJsonElement(result).jsonObject.get("choices")!!.jsonArray
|
||||
val m0 = out[0].jsonObject.get("message")!!.jsonObject
|
||||
val m1 = out[1].jsonObject.get("message")!!.jsonObject
|
||||
assertEquals("АБ", m0["content"]!!.jsonPrimitive.content)
|
||||
assertEquals("А-раз", m0["reasoning_content"]!!.jsonPrimitive.content)
|
||||
assertEquals("ВГ", m1["content"]!!.jsonPrimitive.content)
|
||||
assertEquals("В-раз", m1["reasoning_content"]!!.jsonPrimitive.content)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun offModePassthroughKeepsTags() {
|
||||
// Проверяем passthrough: в режиме off теги остаются в content,
|
||||
// reasoning_content не добавляется, а результат — не null.
|
||||
val c = "A" + openTag + "РАЗУМ" + closeTag + "B"
|
||||
val obj = Json.parseToJsonElement(
|
||||
"""{"choices":[{"message":{"content":"$c"}}]}""",
|
||||
).jsonObject
|
||||
|
||||
val result = transformThinkMessage(obj, "off")
|
||||
assertNotNull(result)
|
||||
val msg = messageOf(result, 0)
|
||||
assertEquals("A" + openTag + "РАЗУМ" + closeTag + "B", msg["content"]!!.jsonPrimitive.content)
|
||||
assertFalse(msg.containsKey("reasoning_content"))
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,3 @@
|
||||
package pw.binom.llmproxy
|
||||
|
||||
actual fun getEnv(name: String): String? = System.getenv(name)
|
||||
@@ -0,0 +1,19 @@
|
||||
package pw.binom.llmproxy
|
||||
|
||||
import io.ktor.client.HttpClient
|
||||
import io.ktor.client.engine.cio.CIO
|
||||
import io.ktor.server.application.Application
|
||||
import io.ktor.server.cio.CIO as ServerCIO
|
||||
import io.ktor.server.engine.embeddedServer
|
||||
|
||||
actual fun createHttpClient(): HttpClient = HttpClient(CIO) {
|
||||
engine {
|
||||
requestTimeout = UPSTREAM_REQUEST_TIMEOUT_MS
|
||||
}
|
||||
}
|
||||
|
||||
actual fun startServer(host: String, port: Int, module: Application.() -> Unit) {
|
||||
embeddedServer(ServerCIO, port = port, host = host) {
|
||||
module()
|
||||
}.start(wait = true)
|
||||
}
|
||||
@@ -0,0 +1,8 @@
|
||||
package pw.binom.llmproxy
|
||||
|
||||
import kotlinx.cinterop.ExperimentalForeignApi
|
||||
import kotlinx.cinterop.toKString
|
||||
import platform.posix.getenv
|
||||
|
||||
@OptIn(ExperimentalForeignApi::class)
|
||||
actual fun getEnv(name: String): String? = getenv(name)?.toKString()
|
||||
@@ -0,0 +1,19 @@
|
||||
package pw.binom.llmproxy
|
||||
|
||||
import io.ktor.client.HttpClient
|
||||
import io.ktor.client.engine.cio.CIO
|
||||
import io.ktor.server.application.Application
|
||||
import io.ktor.server.cio.CIO as ServerCIO
|
||||
import io.ktor.server.engine.embeddedServer
|
||||
|
||||
actual fun createHttpClient(): HttpClient = HttpClient(CIO) {
|
||||
engine {
|
||||
requestTimeout = UPSTREAM_REQUEST_TIMEOUT_MS
|
||||
}
|
||||
}
|
||||
|
||||
actual fun startServer(host: String, port: Int, module: Application.() -> Unit) {
|
||||
embeddedServer(ServerCIO, port = port, host = host) {
|
||||
module()
|
||||
}.start(wait = true)
|
||||
}
|
||||
@@ -1,196 +0,0 @@
|
||||
package pw.binom.llmproxy
|
||||
|
||||
import io.ktor.http.ContentType
|
||||
import io.ktor.http.HttpStatusCode
|
||||
import io.ktor.server.application.Application
|
||||
import io.ktor.server.application.ApplicationCall
|
||||
import io.ktor.server.application.install
|
||||
import io.ktor.server.cio.CIO
|
||||
import io.ktor.server.engine.embeddedServer
|
||||
import io.ktor.server.request.receiveText
|
||||
import io.ktor.server.response.respondBytes
|
||||
import io.ktor.server.response.respondOutputStream
|
||||
import io.ktor.server.routing.get
|
||||
import io.ktor.server.routing.post
|
||||
import io.ktor.server.routing.routing
|
||||
import kotlinx.serialization.json.Json
|
||||
import kotlinx.serialization.json.JsonArray
|
||||
import kotlinx.serialization.json.JsonObject
|
||||
import kotlinx.serialization.json.JsonPrimitive
|
||||
import kotlinx.serialization.json.jsonArray
|
||||
import kotlinx.serialization.json.jsonObject
|
||||
import kotlinx.serialization.json.jsonPrimitive
|
||||
import java.net.URI
|
||||
import java.net.http.HttpClient
|
||||
import java.net.http.HttpRequest
|
||||
import java.net.http.HttpResponse
|
||||
import java.time.Duration
|
||||
|
||||
/**
|
||||
* Прослойка OpenAI API: принимает chat/completions, добавляет в JSON
|
||||
* `provider.ignore` (исключение дорогих провайдеров) + `allow_fallbacks: false`
|
||||
* и прозрачно проксирует на RouterAI (routerai.ru/api/v1). Ответ — как есть,
|
||||
* включая SSE-стрим.
|
||||
*
|
||||
* Трюк «-no-think»: модели из [THINKING_MODELS] в каталоге /v1/models дублируются
|
||||
* с суффиксом `-no-think`; запрос на такой id получает `reasoning: {"enabled": false}`
|
||||
* (модель не думает — не жрёт токены на reasoning). Проверено на
|
||||
* deepseek/deepseek-v4-flash-0731: reasoning.enabled=false глушит думанье.
|
||||
*
|
||||
* Конфиг (env):
|
||||
* - PORT (default 8100)
|
||||
* - UPSTREAM_URL (default https://routerai.ru/api/v1)
|
||||
* - ROUTER_API_KEY — Bearer-ключ RouterAI (обязателен)
|
||||
* - EXCLUDED_PROVIDERS — slug'и провайдеров через запятую (напр. "deepseek")
|
||||
* - THINKING_MODELS — подстроки id «думающих» моделей через запятую
|
||||
* (напр. "deepseek/deepseek-v4-flash-0731,deepseek/deepseek-r1")
|
||||
*/
|
||||
fun main() {
|
||||
val port = System.getenv("PORT")?.toIntOrNull() ?: 8100
|
||||
val upstream = System.getenv("UPSTREAM_URL") ?: "https://routerai.ru/api/v1"
|
||||
val apiKey = System.getenv("ROUTER_API_KEY")
|
||||
?: throw IllegalStateException("ROUTER_API_KEY required")
|
||||
val excluded = (System.getenv("EXCLUDED_PROVIDERS") ?: "")
|
||||
.split(",").map { it.trim() }.filter { it.isNotEmpty() }.distinct()
|
||||
val thinking = (System.getenv("THINKING_MODELS") ?: "deepseek/deepseek-v4-flash-0731,deepseek/deepseek-v4-flash")
|
||||
.split(",").map { it.trim() }.filter { it.isNotEmpty() }.distinct()
|
||||
|
||||
embeddedServer(CIO, port = port, host = "0.0.0.0") {
|
||||
proxyModule(upstream, apiKey, excluded, thinking)
|
||||
}.start(wait = true)
|
||||
}
|
||||
|
||||
private val json = Json { ignoreUnknownKeys = true }
|
||||
|
||||
/** Прокси-клиент: один на процесс (HttpClient потокобезопасен). */
|
||||
private val http = HttpClient.newBuilder()
|
||||
.connectTimeout(Duration.ofSeconds(15))
|
||||
.build()
|
||||
|
||||
fun Application.proxyModule(upstream: String, apiKey: String, excluded: List<String>, thinking: List<String>) {
|
||||
routing {
|
||||
post("/v1/chat/completions") {
|
||||
handleChat(call, upstream, apiKey, excluded, thinking)
|
||||
}
|
||||
get("/v1/models") {
|
||||
handleModels(call, upstream, apiKey, thinking)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
private suspend fun handleChat(
|
||||
call: ApplicationCall,
|
||||
upstream: String,
|
||||
apiKey: String,
|
||||
excluded: List<String>,
|
||||
thinking: List<String>,
|
||||
) {
|
||||
val raw = call.receiveText()
|
||||
if (raw.isBlank()) {
|
||||
call.respondBytes(
|
||||
"""{"error":{"message":"empty body"}}""".toByteArray(),
|
||||
ContentType.Application.Json, HttpStatusCode.BadRequest,
|
||||
)
|
||||
return
|
||||
}
|
||||
val patched = try {
|
||||
patchBody(raw, excluded, thinking)
|
||||
} catch (e: Exception) {
|
||||
call.respondBytes(
|
||||
"""{"error":{"message":"bad json: ${e.message}"}}""".toByteArray(),
|
||||
ContentType.Application.Json, HttpStatusCode.BadRequest,
|
||||
)
|
||||
return
|
||||
}
|
||||
|
||||
val req = HttpRequest.newBuilder()
|
||||
.uri(URI.create(upstream.trimEnd('/') + "/chat/completions"))
|
||||
.header("Authorization", "Bearer $apiKey")
|
||||
.header("Content-Type", "application/json")
|
||||
.POST(HttpRequest.BodyPublishers.ofString(patched))
|
||||
.build()
|
||||
|
||||
val stream = json.parseToJsonElement(raw).jsonObject["stream"]?.jsonPrimitive?.content == "true"
|
||||
if (stream) {
|
||||
// SSE-стрим: транслируем как есть, чанк за чанком.
|
||||
val resp = http.send(req, HttpResponse.BodyHandlers.ofInputStream())
|
||||
val ct = resp.headers().firstValue("content-type").orElse("text/event-stream")
|
||||
call.respondOutputStream(ContentType.parse(ct), HttpStatusCode.fromValue(resp.statusCode())) {
|
||||
resp.body().use { input -> input.copyTo(this, 8192) }
|
||||
}
|
||||
} else {
|
||||
val resp = http.send(req, HttpResponse.BodyHandlers.ofByteArray())
|
||||
val ct = resp.headers().firstValue("content-type").orElse("application/json")
|
||||
call.respondBytes(resp.body(), ContentType.parse(ct), HttpStatusCode.fromValue(resp.statusCode()))
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Патч запроса: (1) если модель оканчивается на "-no-think" — снять суффикс и
|
||||
* добавить `reasoning: {"enabled": false}` (не думать); (2) добавить
|
||||
* `provider.ignore` (объединяя с присланным клиентом) и `allow_fallbacks: false` —
|
||||
* иначе ignore не жёсткий: RouterAI может уйти на исключённого провайдера
|
||||
* резервной попыткой (см. гайд provider-selection).
|
||||
*/
|
||||
internal fun patchBody(raw: String, excluded: List<String>, thinking: List<String>): String {
|
||||
val root = json.parseToJsonElement(raw).jsonObject.toMutableMap()
|
||||
|
||||
val model = root["model"]?.jsonPrimitive?.content ?: ""
|
||||
if (model.endsWith("-no-think")) {
|
||||
root["model"] = JsonPrimitive(model.removeSuffix("-no-think"))
|
||||
if (root["reasoning"] == null) {
|
||||
root["reasoning"] = JsonObject(mapOf("enabled" to JsonPrimitive(false)))
|
||||
}
|
||||
}
|
||||
|
||||
val provider = root["provider"]?.jsonObject?.toMutableMap() ?: mutableMapOf()
|
||||
val existing = provider["ignore"]?.jsonArray?.map { it.jsonPrimitive.content } ?: emptyList()
|
||||
provider["ignore"] = JsonArray((existing + excluded).distinct().map { JsonPrimitive(it) })
|
||||
if (provider["allow_fallbacks"] == null) {
|
||||
provider["allow_fallbacks"] = JsonPrimitive(false)
|
||||
}
|
||||
root["provider"] = JsonObject(provider)
|
||||
return JsonObject(root).toString()
|
||||
}
|
||||
|
||||
private suspend fun handleModels(
|
||||
call: ApplicationCall,
|
||||
upstream: String,
|
||||
apiKey: String,
|
||||
thinking: List<String>,
|
||||
) {
|
||||
val req = HttpRequest.newBuilder()
|
||||
.uri(URI.create(upstream.trimEnd('/') + "/models"))
|
||||
.header("Authorization", "Bearer $apiKey")
|
||||
.GET()
|
||||
.build()
|
||||
val resp = http.send(req, HttpResponse.BodyHandlers.ofByteArray())
|
||||
val ct = resp.headers().firstValue("content-type").orElse("application/json")
|
||||
val body = if (thinking.isNotEmpty()) {
|
||||
patchModelsCatalog(String(resp.body(), Charsets.UTF_8), thinking).toByteArray(Charsets.UTF_8)
|
||||
} else {
|
||||
resp.body()
|
||||
}
|
||||
call.respondBytes(body, ContentType.parse(ct), HttpStatusCode.fromValue(resp.statusCode()))
|
||||
}
|
||||
|
||||
/**
|
||||
* Дублировать «думающие» модели в каталоге с суффиксом "-no-think":
|
||||
* каждая модель, чей id содержит любую из подстрок [thinking], получает копию
|
||||
* с id = "<оригинал>-no-think".
|
||||
*/
|
||||
internal fun patchModelsCatalog(raw: String, thinking: List<String>): String {
|
||||
val root = json.parseToJsonElement(raw).jsonObject.toMutableMap()
|
||||
val data = root["data"]?.jsonArray?.map { it.jsonObject } ?: emptyList()
|
||||
if (data.isEmpty()) return raw
|
||||
val copies = data.filter { m ->
|
||||
val id = m["id"]?.jsonPrimitive?.content ?: ""
|
||||
thinking.any { id.contains(it) }
|
||||
}.map { m ->
|
||||
val id = m["id"]?.jsonPrimitive?.content ?: ""
|
||||
JsonObject(m.toMutableMap().apply { this["id"] = JsonPrimitive(id + "-no-think") })
|
||||
}
|
||||
if (copies.isEmpty()) return raw
|
||||
root["data"] = JsonArray(data + copies)
|
||||
return JsonObject(root).toString()
|
||||
}
|
||||
Reference in New Issue
Block a user