Delibera v10.3.0 — Что нового

Статус: ✅ Выпущен — Июль 2026 402 модульных теста пройдено (337 Core + 65 Server). Нарушающие изменения — см. руководство по миграции ниже.

Этот документ описывает три крупных функции и нарушающие изменения в Delibera v10.3.0. Полный список изменений см. в CHANGELOG.md. Дорожную карту см. в docs/ROADMAP.md.

Содержание#

• P-01 — Нарушающие изменения
• S-01 — Распределённые дебаты
• S-03 — Кэширование результатов
• Delibera.Server — ASP.NET Core сервис
• Очистка перед релизом

P-01 — Нарушающие изменения#

v10.3.0 удаляет устаревшие API, помеченные [Obsolete] начиная с v10.1. При обновлении с v10.2.x внесите следующие изменения:

Исправление WeightedVotingStrategy.ResolveWeight#

ResolveWeight теперь использует ballot.Weight в качестве отката вместо defaultWeight конструктора. Пошаговые веса работают как описано в документации.

S-01 — Распределённые дебаты#

Delibera теперь поддерживает распределённую оркестрацию дебатов. Абстракция IDebateOrchestrator отделяет выполнение дебатов от транспортного уровня, обеспечивая как локальные, так и Redis-развертывания.

Основной интерфейс#

public interface IDebateOrchestrator
{
    Task<DebateResult> ExecuteAsync(ICouncilBuilder builder, CancellationToken ct = default);
    Task<DebateHandle> EnqueueAsync(string debateId, ICouncilBuilder builder, CancellationToken ct = default);
    Task<DebateHandle?> GetStatusAsync(string debateId, CancellationToken ct = default);
    IAsyncEnumerable<DebateRoundEvent> StreamAsync(string debateId, CancellationToken ct = default);
    Task<bool> CancelAsync(string debateId, CancellationToken ct = default);
}

Локальный режим (по умолчанию)#

services.AddDelibera(configuration);
// LocalDebateOrchestrator регистрируется по умолчанию

Режим Redis#

services.AddDelibera(configuration);
services.AddRedisDebateOrchestrator(configuration);

События раундов публикуются в Redis Streams, поэтому любой подключённый API-сервер может транслировать их через SSE.

Полная архитектура и конфигурация описаны в docs/distributed-debates.md.

S-03 — Кэширование результатов#

Избегайте повторного выполнения идентичных дебатов. Ключ кэша — SHA-256 хеш вопроса, участников, стратегии и конфигурации.

Режимы кэширования#

Быстрый старт#

// В памяти (разработка)
services.AddDelibera(configuration)
    .UseInMemoryCache(ttl: TimeSpan.FromHours(1));

// Файловый кэш
services.AddDelibera(configuration)
    .UseFileCache(directory: "./debate-cache", ttl: TimeSpan.FromDays(7));

// Redis (продакшн)
services.AddRedisDebateOrchestrator(configuration);
services.UseRedisCache(ttl: TimeSpan.FromHours(24));

Управление кэшем на уровне дебата#

var executor = new CouncilBuilder()
    .WithUserPrompt("Какая архитектура лучше?")
    .AddMember("gpt-4o", provider, "Архитектор")
    .WithCacheBehavior(CacheBehavior.ReadWrite)
    .Build();

var result = await executor.ExecuteAsync();
Console.WriteLine($"Кэш-попадание: {result.CacheHit}");  // true если из кэша
Console.WriteLine($"Ключ кэша: {result.CacheKey}");     // напр. "A3F2B8C1D4E5F6A7"
Console.WriteLine($"Время кэширования: {result.CachedAt}"); // оригинальная метка времени

Полная справка — в docs/caching.md.

Delibera.Server — ASP.NET Core сервис#

Новый проект Delibera.Server предоставляет самохостящийся ASP.NET Core 10 Minimal API:

• REST API: POST /api/v1/debates (синхронно), POST /api/v1/debates/async (фоново), GET /api/v1/debates/{id}, DELETE /api/v1/debates/{id}
• SSE-стриминг: GET /api/v1/debates/{id}/stream — на базе IDebateOrchestrator.StreamAsync()
• Сценарии: POST /api/v1/scenarios для произвольных дебатов
• OpenAPI: Swagger UI на /openapi

Полная справка API — в docs/Server.md.

Очистка перед релизом#

• Удалены DebateStatus.Paused и DebateOrchestrationStatus.Pending — неиспользуемые значения enum
• Исправлено предупреждение CS8618 для DebateRecord.Label (теперь по умолчанию string.Empty)
• DebateResponse теперь включает поля Label, CacheHit и CacheKey
• SseDebateStreamWriter переписан для использования IDebateOrchestrator.StreamAsync() вместо DebateRecord.RoundReader
• DebateOrchestrationService переписан с опроса каждые 200мс на событийно-ориентированный StreamAsync()
• Все предупреждения CS1591/CS1574 XML-doc исправлены в Delibera.Core

Производительность и целостность (Фазы 1–3)#

Исправление утечек памяти#

Потокобезопасность#

• DebateRecord.Status и RedisDebateOrchestrator.DebateEntry.Status используют volatile int + Volatile.Read/Volatile.Write.
• ProviderFactory.CachingFactory использует ConcurrentDictionary<string, T> + GetOrAdd вместо Dictionary + lock.

Корректность async#

• ConfigureAwait(false) добавлен ко всем await в Delibera.Core и Delibera.Redis (~50+ мест).
• Fire-and-forget CancelAsync в DebateOrchestrationService использует Task.Run с try/catch + логированием.

Оптимизации аллокаций#

• SSE writer — JsonSerializer.SerializeToUtf8Bytes + побайтовая запись вместо строковой сериализации.
• Генератор ключей кэша — SerializeToUtf8Bytes избегает промежуточной аллокации string.
• ModelContextWindowRegistry — FrozenDictionary/FrozenSet для O(1) поиска; Register инвалидирует замороженный кэш.
• IDebateCache / IDebateStore / IDebateOrchestrator.GetStatusAsync — ValueTask<T> вместо Task<T>; синхронные бэкенды избегают аллокации Task.
• Расстояние Левенштейна — однорядный DP с Span<int> + stackalloc для строк ≤128 символов.
• TokenCounter — ReaderWriterLockSlim вместо lock для конкурентных чтений.
• RankedOption — readonly record struct вместо sealed record (без аллокации в куче).
• StringBuilder — capacity hints в ToMarkdown() (4096), ToStatisticsMarkdown() (2048), ToLogsMarkdown() (2048).