Встроенный AI AssistantBuilt-in AI Assistant

Assistant связывает контекст Capture, Selector, CV, Screph Code, Automation Runtime и настроек в одном workspace. Это экспериментальный помощник с явными границами: он выключен по умолчанию, работает только через зарегистрированные actions и не получает право на изменение проекта только потому, что сформировал ответ.The Assistant brings Capture, Selector, CV, Screph Code, Automation Runtime and settings context into one workspace. It is an experimental helper with explicit boundaries: it is off by default, operates through registered actions only, and does not gain permission to mutate a project merely by generating an answer.

1. Подготовка и запуск1. Setup and activation

В Настройки LLM создайте или проверьте профиль и назначьте модели ролям assistant и, если нужны соответствующие контекстные flows, cv, codegen и semantic_selection. Для локальной работы можно использовать Ollama или LM Studio.Under LLM Settings, create or test a profile and assign models to assistant and, when those contextual flows are needed, cv, codegen and semantic_selection. Ollama or LM Studio can be used for local operation.
Откройте AI АССИСТЕНТ → AI ассистент и включите ассистента. Базовый режим запуска — Только кнопка; проактивные подсказки включаются отдельно.Open AI ASSISTANT → AI assistant and enable it. The default activation mode is Button only; proactive hints are enabled separately.
В Selector тот же флаг доступен как переключатель AI в шапке. Открывайте помощника кнопкой AI, сочетанием Ctrl+Shift+Space или из контекстной точки входа выбранного объекта.In Selector, the same flag is exposed as the AI header toggle. Open the assistant with the AI button, Ctrl+Shift+Space, or a context entry point for the selected object.
В окне настроек кнопка Assistant находится в строке состояния. Голосовая кнопка Selector передаёт распознанный текст как задачу и требует заранее настроенного speech provider.In the Settings window, the Assistant button is in the status bar. The Selector voice button passes recognized text as a task and requires a configured speech provider.

Настроить LLM и распознавание речи →Configure LLM and speech recognition →

2. Что находится в workspace2. What the workspace contains

ВкладкаTab	НазначениеPurpose
ЧатChat	Задача, ответ модели и selector общей LLM-роли `assistant`. Контекстные CV/codegen/voice flows могут использовать другие назначения из «Настройки LLM».Task input, model response and a selector for the shared `assistant` LLM role. Contextual CV, codegen or voice flows may use other assignments from LLM Settings.
ПодсказкиHints	Проактивные кандидаты: принять, перенести в чат или скрыть.Proactive candidates that can be accepted, moved to chat or dismissed.
Actions	Карточки preview/apply с типом действия, target, policy state и кнопками «Редактировать», «Отклонить», «Подтвердить/Применить» или «Откатить».Preview/apply cards with action kind, target, policy state and Edit, Reject, Confirm/Apply or Revert controls.
Sessions / Timeline	Поиск сессий и хронология turns, подсказок, решений и action results.Session search and a timeline of turns, hints, decisions and action results.
КонтекстContext	Активная поверхность, компетенция, объект и путь проекта — то, на что опирается текущий turn.The active surface, competence, subject and project path used by the current turn.
АртефактыArtifacts	Ссылки на созданные модулями результаты; тяжёлые bodies остаются у модулей-владельцев и не загружаются автоматически.References to module-produced results; heavy bodies remain with their owning modules and are not loaded automatically.
НастройкиSettings	Те же параметры запуска, контекста, компетенций, policy и истории без выхода из workspace.The same activation, context, competence, policy and history controls without leaving the workspace.

3. Компетенции и маршрутизация3. Competencies and routing

Контекстная точка входа выбирает компетенцию, а не даёт модели неограниченный доступ. Доступны Canvas/области, CV, Screph Code, голосовые задачи, Capture/timeline, Tree modules/exports, Automation Runtime, настройки/зависимости, account/crash support и i18n/docs. На вкладке есть переключатели компетенций, но текущий router их не читает: считать их runtime-запретом пока нельзя.A contextual entry point selects a competence; it does not grant unrestricted access. Available competencies cover Canvas/regions, CV, Screph Code, voice tasks, Capture/timeline, Tree modules/exports, Automation Runtime, settings/dependencies, account/crash support and i18n/docs. The page exposes competence toggles, but the current router does not consume them, so they cannot yet be treated as runtime blocks.

Внутренняя assistant-role определяет инструкции и action scope: assistant, canvas, cv, codegen, semantic_selection, capture, tree_modules, automation, settings_dependencies, support или i18n_docs. При выборе LLM-профиля роли cv, codegen и semantic_selection используют одноимённые назначения; остальные компетенции идут через LLM-роль assistant.The internal assistant role determines instructions and action scope: assistant, canvas, cv, codegen, semantic_selection, capture, tree_modules, automation, settings_dependencies, support or i18n_docs. For LLM profile selection, cv, codegen and semantic_selection use their matching assignments; all other competencies use the assistant LLM role.

4. Preview, policy и подтверждение4. Preview, policy and confirmation

Ответ модели может предложить только action с зарегистрированным стабильным идентификатором. Неизвестный action завершается явной ошибкой.A model response may propose only an action with a registered stable identifier. An unknown action fails explicitly.
Router проверяет обязательные входы и policy gate до обращения к adapter.The router validates required inputs and the policy gate before invoking an adapter.
Actions среднего, высокого и destructive-риска, а также actions с отдельным permission flag, блокируются с requires_confirmation до явного подтверждения.Medium-, high- and destructive-risk actions, plus actions carrying a separate permission flag, are blocked with requires_confirmation until explicitly confirmed.
Карточка сохраняет preview и решение пользователя. Если adapter предоставляет revert token, результат можно откатить из workspace.The card persists the preview and the user's decision. If the adapter provides a revert token, the result can be reverted from the workspace.

5. Контекст, вложения и privacy5. Context, attachments and privacy

Базовый payload — Только текст; изображения и артефакты запрещены по умолчанию.The default payload is Text only; images and artifacts are disabled by default.
Для артефактов по умолчанию требуется согласие на каждый turn. Без согласия в handoff передаются только разрешённые данные, а заблокированные references отражаются в отчёте.Artifacts require per-turn consent by default. Without consent, the handoff includes allowed data only and reports blocked references.
Базовая retention policy вложений — Только metadata. Режим thumbnail создаёт локальные миниатюры, а full-project-artifacts копирует разрешаемые файлы в session storage. Понижение режима не удаляет уже созданные копии и thumbnails.The default attachment retention policy is Metadata only. Thumbnail mode creates local thumbnails, while full-project-artifacts copies resolvable files into session storage. Lowering the mode does not delete copies or thumbnails already materialized.
Перед LLM handoff контекст проходит redaction; workspace может показать краткий redaction report.Context is redacted before the LLM handoff; the workspace can show a compact redaction report.

6. Что реально применяют настройки6. What the settings actually apply

ГруппаGroup	Текущая границаCurrent boundary
Запуск и проактивностьActivation and proactive hints	`enabled`, кнопка, workspace gate и proactive priority/cooldown/snooze/repeat имеют consumers и перечитываются соответствующими UI/runtime paths.`enabled`, launcher visibility, the workspace gate and proactive priority/cooldown/snooze/repeat have consumers and are re-read by their UI/runtime paths.
Контекст и action policyContext and action policy	Работают, но часть значений кэшируется при создании runtime. Изменение во встроенной вкладке workspace обновляет текущий runtime; после изменения на отдельной странице Settings безопасная граница — перезапуск Screph.These work, but some values are cached when the runtime is created. Changes made in the workspace's embedded page refresh that runtime; after editing the standalone Settings page, restarting Screph is the safe boundary.
Представление workspaceWorkspace presentation	Default view, long-task routing, timeline/context-chips/cost toggles сейчас только сохраняются. Workspace восстанавливает последний tab из local state и продолжает создавать эти panes.Default view, long-task routing and timeline/context-chip/cost toggles are currently persisted-only. The workspace restores its last tab from local state and still constructs those panes.
Competencies и Assistant LLM routingCompetencies and Assistant LLM routing	Видимые controls сохраняются, но не меняют текущий router. Модель назначайте через общие LLM roles.The visible controls persist but do not alter the current router. Assign models through the shared LLM roles.
История и CV extrasHistory and CV extras	Action-history retention, mirroring и auto-save turn docs считываются при создании runtime. CV auto-save/export-preview controls consumer не имеют. Отдельные ограничения session pruning и project mirror описаны ниже.Action-history retention, mirroring and automatic turn docs are captured when the runtime is created. The CV auto-save/export-preview controls have no consumer. Separate session-pruning and project-mirror limits are described below.

7. История и диагностика7. History and diagnostics

Workspace хранит prompts/responses, сессии, turns, action records, context/timeline metadata и разрешённые attachments в ScrephData/runtime/ai_assistant. history.jsonl применяет сохранённый retention при добавлении событий, но session-directory cleanup сейчас не получает это поле из typed runtime settings и фактически использует 180 дней при создании workspace. Активная сессия и сессии с unresolved confirmation-required actions не удаляются этим проходом.The workspace stores prompts and responses, sessions, turns, action records, context and timeline metadata and permitted attachments under ScrephData/runtime/ai_assistant. history.jsonl applies its saved retention as events are appended, but session-directory cleanup currently does not receive that field through typed runtime settings and effectively uses 180 days when a workspace is created. The active session and sessions with unresolved confirmation-required actions are not removed by that pass.

Project mirror находится в <project>/.screph_ai_assistant и не очищается global 180-day pruning. В текущей реализации переключатель mirroring влияет на action-history store, но generic workspace создаёт свой store с mirroring по умолчанию: этот control нельзя считать способом остановить все новые messages.mirror.jsonl, timeline.mirror.jsonl и actions.mirror.jsonl. Уже созданные записи он также не удаляет.The project mirror lives under <project>/.screph_ai_assistant and is not removed by global 180-day pruning. In the current implementation, the mirroring control affects the action-history store, while the generic workspace creates its own store with mirroring enabled by default: this control cannot be treated as a way to stop all new messages.mirror.jsonl, timeline.mirror.jsonl and actions.mirror.jsonl writes. It does not delete existing records either.

Retention, исключения и полная очистка →Retention, exceptions and complete cleanup →

Если Assistant не запускается, последовательно проверьте: флаг Включить ассистента, Включить workspace, назначение нужной общей LLM-роли, доступность профиля и policy gate действия. Competence toggle сейчас причиной блокировки быть не может, потому что router его не читает. Screph показывает runtime-ошибки явно и не переключает provider или action автоматически.If the Assistant does not start, check the Enable assistant flag, Enable workspace, the required shared LLM-role assignment, profile availability and the action policy gate. A competence toggle cannot currently be the blocking cause because the router does not read it. Screph reports runtime failures explicitly and does not silently switch provider or action.