Local AI Toolkit

Карта ответственности для небольших изменений

English version

Карта завершает разбор границ в #624 на коммите 78b7da480634313ff97b96b0eb1fbe5ecd32aecc. Шесть файлов ниже остаются рабочими точками входа. Длина файла сама по себе не является причиной переноса кода. Для следующего выделения нужны конкретное изменение поведения, потребитель и проверка наблюдаемой гарантии.

Текущая ответственность и границы изменений

Точка входа Ответственность сейчас Граница небольшого изменения
InstallerWizardViewModel Состояние страниц и выбора, обзор и согласие, запуск установки/восстановления, прогресс и записанные результаты. Состояние UI и согласие остаются в мастере. Тексты завершения/восстановления уже получают неизменяемые факты через InstallerRunMessages. Новый координатор исполнения нужен лишь для конкретного изменения запуска/восстановления: он получает согласованный план и возвращает события/результаты, а представление не получает права выполнять эффекты.
CodeSearchSyncCommand Блокировка репозитория, планирование базы и worktree, семантика перед эмбеддингами, прогресс, проверки изменений дерева, публикация и очистка. Сохраняется один владелец оркестрации и времени жизни блокировки. План фиксирует дерево; фазы создают артефакты для этой идентичности; публикация проверяет и открывает готовый результат. WorktreeGenerationPublications уже владеет ранним указателем, привязанным к эпохе общего указателя. Фаза выделяется только при конкретной потребности.
DurableQueue Приём/дедупликация и порядковые номера, состояние и аренды, проверенные payload, восстановление, архив/карантин и очистка. Метаданные, проверка payload и очистка — разные обязанности внутри одной транзакции mutex. Кеш запросов ограничен текущим владением mutex. Помощник получает этот контекст либо проверенные значения, не вводит отдельную блокировку и не сохраняет payload между операциями. Опрос состояния остаётся без чтения payload.
BrokerModelInstaller Доверенный снимок запросов, проверка подписанного каталога, аренда активной версии, команды launcher, проверка status/pull/preflight, прогресс и точные частичные результаты. Существующие интерфейсы доверия, активной версии и процессов — границы, а не публичный обход проверок. Новое поле протокола может потребовать отдельного узкого парсера/валидатора. Он возвращает факты владельцу пакета операций, сохраняющему доверие, отмену и различие между попыткой, завершением и неизвестным результатом эффекта.
InstallationLayoutLease Получение защищённого Windows layout, удержание дескрипторов и свидетельств identity/ACL, временные версии и публикация, резервирование launcher и очистка собственных изменений. Дополнительное выделение сейчас не выбрано. Конкретный дефект публикации/резервирования может потребовать выделения только соответствующей операции; дескрипторы и свидетельства остаются живы под арендой. Нельзя заменять операции относительно дескрипторов проверкой пути перед незащищённым действием.
IndexBuilder Разделение и переиспользование файлов, чанки по символам, сборка базы/overlay, пакеты эмбеддингов через брокер, восстановление checkpoint, адаптивные лимиты, ожидание backend и прогресс. Дополнительное выделение сейчас не выбрано. Измеренный дефект сборки, повторов или checkpoint может потребовать одного закрытого помощника плана/фазы. Входы сохраняют хеши, chunker, модель/размерность/контекст и порядок. Запись индекса не даёт помощнику права публиковать поколение репозитория.

Последние два решения условны: #624 не задаёт отдельное переписывание защитного кода или индексатора. В этом изменении документации нет абстракций без потребителя, постоянного кеша очереди, миграции хранилища или изменений публичного API.

Связь с существующей работой

Ответственность Задача и выполненное изменение Что остаётся в этой задаче
Исполнение установки и представление результата #615, PR #671 Мастер передаёт записанные факты; смена языка не выполняет установку и не переписывает журнал. Достоверность отмены/эффектов относится к #589, представление результата — к #604.
Планирование, фазы и публикация sync #620, PR #676 Готовность запрошенного worktree и полное обслуживание имеют разные результаты. Общие читатели сохраняют прежнее поколение до подготовки всех нужных worktree. Дублирующая задача рефакторинга sync не создаётся.
Метаданные, payload и очистка очереди #621, PR #677 Переиспользование ограничено одним владением mutex; следующая операция заново проверяет payload на диске. Очистка остаётся под той же блокировкой. Измеренное улучшение не требует разделения всего класса.
Производительность индекса и запросов #619 Идентичность вектора запроса, задержки и качество выдачи остаются этой задачей. Перенос IndexBuilder не заменяет измерение пути запроса.

Карта закрывает координационную работу #624. Она не переоткрывает завершённые задачи и не объявляет завершёнными оставшиеся оптимизации или живую приёмку установщика.

Сохраняемые гарантии

Установщик и модели. Согласие предшествует эффектам. Факты журнала/результата определяют завершённые, неудачные и неизвестные действия; форматирование не меняет их и доступность отката. На протяжении исполнения сохраняются свидетельства проверенного пакета, launcher и активной версии, проверяются каталог/модель/контекст ответа, уже установленные модели проходят preflight, политика размещения не ослабляется автоматически. Существующие проверки: мастер и установщик моделей.

Sync и индексатор. Блокировка репозитория берётся до записи общего состояния и охватывает публикацию. Семантика и корпус описывают одно поколение, дерево и dirty-состояние. Изменившийся worktree не публикует устаревшие артефакты; ранний указатель действует только в записанной эпохе общего указателя. Отмена/ошибка сохраняет доступные опубликованные поколения и готовые checkpoint. Сохраняются совместимость модели и размерности базы/overlay, идентичность chunker и нормализация, включая переиспользование неизменённых файлов. Проверки: активная публикация, эпохи и хранение, продолжение эмбеддингов, восстановление backend, адаптивные пакеты.

Очередь. Общий mutex защищает номера, дедупликацию, согласованность request/state, переходы аренды и восстановление. Проверенные payload не переживают эту аренду, включая выход с исключением. Подмена с прежним размером и временем проверяется следующей операцией; некорректная запись попадает в карантин. Сохраняются durable JSON и смысл архива/очистки. QueueRequestSnapshotTests проверяет границы кеша; сохранённые замеры и конкуренция реальных процессов относятся к измеренному изменению.

Защищённый layout. Каноническая идентичность, проверки ACL/reparse и время жизни дескриптора связаны с операцией. Перед commit/publication выполняется повторная проверка; откат/очистка удаляет только собственные изменения. Строка пути не заменяет удерживаемое свидетельство. Тесты установки пакета включают отказ при опасных существующих ACL без изменения данных; тесты общего корня проверяют допустимое существующее состояние. Это опорные регрессии, а не доказательство отсутствия любых гонок файловой системы.

Приёмка следующего небольшого PR

  1. Указать задачу, потребителя и наблюдаемый сценарий, требующий границы. Один PR меняет одну ответственность и сохраняет точку входа, если задача не требует изменения контракта.
  2. Для нового поведения сначала воспроизвести сбой. Для выделения сохранить наблюдаемые проверки и добавить тест только для непокрытой гарантии. Не проверять помощника лишь потому, что он появился, и не задавать порог скорости машины.
  3. Явно сохранить время жизни блокировок/аренд, отмену, владение данными и право публикации. Сохранить JSON и границы untrusted-content. До принятия оптимизации сравнить результаты на существующем корпусе.
  4. Перед открытием PR выполнить полный прогон: dotnet test LocalAi.slnx --configuration Release --max-parallel-test-modules 1 --timeout 20m. Указать итоги и причины пропусков. Проверки фикстур не подтверждают живую приёмку DPI, доступности или установки.

Для этой карты код и опорные тесты сверены с указанным коммитом. Рабочий код и тесты не изменены. Результат полного прогона и проверка локальных ссылок записываются в PR. Утверждений о производительности моделей или экономии облачных токенов нет.