内置 AI Assistant

助手将 Capture、Selector、CV、Screph Code、Automation Runtime 和设置上下文集成到一个工作区中。它是一个具有明确边界的实验性助手：默认情况下它是关闭的，仅通过注册操作进行操作，并且不会仅通过生成答案来获得改变项目的许可。

1. 设置和激活

  1. 在 LLM 设置 下，创建或测试配置文件并将模型分配给 assistant，并且当需要这些上下文流时， cv、codegen 和 semantic_selection。 Ollama 或 LM Studio 可用于本地操作。
  2. 打开 AI ASSISTANT → AI Assistant 并启用它。默认激活模式为仅按钮；主动提示单独启用。
  3. 在 Selector 中，相同的标志暴露为 AI 标头切换。使用 AI 按钮、Ctrl+Shift+Space 或所选对象的上下文入口点打开助手。
  4. 在“设置”窗口中，“助手”按钮位于状态栏中。 Selector 语音按钮将识别的文本作为任务传递，并且需要配置的语音提供程序。

配置 LLM 和语音识别 →

2. 工作区包含什么

选项卡目的
聊天共享 assistant LLM 角色的任务输入、模型响应和选择器。上下文 CV、代码生成或语音流可以使用 LLM 设置中的其他分配。
提示主动候选结果可以接受、移至聊天或关闭。
Actions预览/应用带有操作类型、目标、策略状态和编辑、拒绝、确认/应用或恢复控件的卡片。
Sessions / Timeline会话搜索以及回合、提示、决策和行动结果的时间表。
上下文当前回合使用的活跃面、能力、主题和项目路径。
产物对模块生成的结果的引用；重体仍保留在其所属模块中，并且不会自动加载。
设置无需离开工作区即可进行相同的激活、上下文、权限、策略和历史控制。

3. 能力和路由

上下文入口点选择能力；它不授予无限制的访问权限。可用能力涵盖画布/区域、CV、Screph Code、语音任务、Capture/时间线、树模块/导出、Automation Runtime、 settings/依赖项、帐户/崩溃支持和 i18n/docs。该页面公开了权限切换，但当前路由器不使用它们，因此它们还不能被视为运行时块。

内部助手角色决定指令和动作范围：assistant、canvas、 cv，codegen，semantic_selection， capture、tree_modules、automation、 settings_dependency、support 或 i18n_docs。对于 LLM 配置文件选择，cv、codegen 和semantic_selection 使用它们的匹配赋值；所有其他能力使用 assistant LLM 角色。

4. 预览，政策和确认

  1. 模型响应可能仅建议具有已注册稳定标识符的操作。未知操作明确失败。
  2. 路由器在调用适配器之前验证所需的输入和策略门。
  3. 中、高和破坏性风险操作，以及带有单独权限标志的操作，将被 requires_confirmation 阻止，直到明确确认为止。
  4. 卡保留预览和用户的决定。如果适配器提供恢复令牌，则可以从工作区恢复结果。

5. 上下文、附件和隐私

  • 默认负载为 仅文本；默认情况下禁用图像和产物。
  • 产物默认情况下需要每回合同意。未经同意，移交仅包含允许的数据并报告被阻止的引用。
  • 默认附件保留策略为 仅元数据。缩略图模式创建本地缩略图，而完整项目产物将可解析文件复制到会话存储中。降低模式不会删除已实现的副本或缩略图。
  • 在 LLM 切换之前对上下文进行编辑；工作区可以显示紧凑的修订报告。

6. 这些设置实际适用的内容

群组当前边界
激活和主动提示enabled、启动器可见性、工作区门和主动优先级/冷却/暂停/重复有消费者，并由其 UI/运行时路径重新读取。
上下文和操作政策这些可以工作，但在创建运行时时，某些值会被缓存。在工作区的嵌入页面中所做的更改会刷新运行时；编辑独立设置页面后，重新启动 Screph 是安全边界。
工作区演示默认视图、长任务路由和时间线/上下文芯片/成本切换目前仅保留。工作区从本地状态恢复其最后一个选项卡，并仍然构建这些窗格。
能力和助手 LLM 路由可见控件仍然存在，但不会更改当前路由器。通过共享 LLM 角色分配模型。
历史记录和 CV 附加内容创建运行时时会捕获操作历史记录保留、镜像和自动转向文档。 CV 自动保存/导出-预览控件没有消费者。下面描述了单独的会话修剪和项目镜像限制。

7. 历史和诊断

工作区在 ScrephData/运行时/ai_assistant 下存储提示和响应、会话、回合、操作记录、上下文和时间线元数据以及允许的附件。 history.jsonl 在附加事件时应用其保存的保留，但会话目录清理当前不会通过键入的运行时设置接收该字段，并且在创建工作区时有效使用 180 天。该通道不会删除活动会话和具有未解决的需要确认操作的会话。

项目镜像位于 <project>/.screph_ai_assistant 下，并且不会被全局 180 天修剪删除。在当前实现中，镜像控件影响操作历史记录存储，而通用工作区创建自己的存储并默认启用镜像：此控件不能被视为停止所有新 messages.mirror.jsonl 的方法， timeline.mirror.jsonl 和 actions.mirror.jsonl 写入。它也不会删除现有记录。

保留、例外和完整清理 →

如果助手未启动，请检查 启用助手 标志、 启用工作空间、所需的共享 LLM 角色分配、配置文件可用性和操作策略门。权限切换当前不能成为阻塞原因，因为路由器不读取它。 Screph 明确报告运行时故障，并且不会默默地切换提供程序或操作。