AI 助手与自动化

AI 助手可以协助创建工作区、安装游戏服务、检查日志和维护配置。执行范围由当前账号、工作区权限、会话模式和审批策略共同决定。

开始一个任务

1. 打开目标工作区的会话；创建工作区或安排多个工作区的任务时，使用管理面板会话。
2. 选择可用模型和模式：先了解问题选计划，需要执行操作选 Agent。
3. 写明目标和限制，例如“检查服务器为什么无法启动，修改文件前先让我确认”。
4. 查看助手的结果，按提示回答问题或审批；安装完成后检查控制台并尝试连接游戏。

没有可用模型时，请联系超级管理员完成下面的配置。

在会话的添加菜单中，上传图片将图片加入本次消息；上传文件将任意类型文件保存到资产库，可在那里跟踪或重试上传。当前会话中的文件卡片仅显示上传反馈，不会自动作为消息附件发送给 AI。选择资产用于附加资产库中的已有图片。

可按资产库文件名让助手读取 UTF-8 文本或查看图片，或经审批导入当前工作区。工具结果和导入的文件可由会话参与者查看。

配置可用模型

超级管理员打开智能体管理 → 模型与服务商：

1. 添加服务商，填写服务地址和凭据。
2. 获取模型列表，检查能力并启用所需模型。出现在列表中不代表已经启用。
3. 在模型分工中选择对话、审批、记忆和标题模型。
4. 在运行策略中检查任务预算、审批和记忆设置。

语言风格可设置回复偏好，例如“先给结论，再列操作步骤”，保存后用于新任务。它影响措辞、语气和格式，不改变权限或界面语言。

模型配置补充

• OpenAI compatible、Ollama 等没有预设模型的方案，首次发现的模型需要手动启用。
• 服务商请求超时默认 2 分钟，可设置为 1 秒至 2 小时。流式请求限制等待响应和数据中断时间，整个任务另有运行时限。
• 输入、输出、步骤和按角色设置的每日推理配额中，0 表示不限。

选择会话范围

会话	可见范围	适合的任务
管理面板会话	仅创建者	选择节点、创建工作区、管理工作区元数据
工作区会话	当前具有该工作区访问权限的成员	安装与维护服务、读取日志、修改文件、操作 Shell 和控制台

管理面板会话不能直接操作游戏文件、日志或终端。需要安装、启动或排障时，助手会把任务摘要交接到目标工作区的会话。

一个管理面板任务可以处理多个工作区，并分别交接任务。交接后管理面板任务继续执行；点击交接结果可打开对应工作区会话检查进度。交接成功表示任务已提交，不表示服务器已安装完成或可以连接。

模型、推理强度和模式按会话保存，运行期间不能修改；模型不可用时需要重新选择。

• 计划模式：分析需求并制定步骤，工作区内可使用允许的只读诊断工具。
• Agent 模式：按权限调用工具，执行获准的修改和运行操作。

审批与任务控制

审批方式	行为
手动审批	由本人确认需要审批的操作
替我审批	由审批模型审核授权范围内的操作
完全访问权限	在委托范围内自动执行，仍保留必要的人工审批

可选方式取决于平台设置和账号权限。审批不能扩大权限；助手写入或删除工作区密钥始终需要人工确认，必要时还需验证身份。

确认前检查操作目标、文件差异和影响。收起的问题或审批可从待处理提示重新打开；收起不会提交答案。条件变化时可能需要重新确认。

批准操作并选择替我审批时，按要求完成一次身份验证。切换为手动审批会撤销本人在该会话各登录会话中的交互式授权。

运行中可以补充要求，也可以排队提交独立任务。队列遇到失败、中断或归档会暂停；处理问题后，在未归档会话中点击继续执行队列。停止任务会请求取消进行中的操作，已完成的修改需单独撤销。

已完成的任务可派生新会话以继续探索，派生时会复制会话上下文，工作区文件仍由成员共享。

技能与工作区规则

安装插件后，在输入框键入 @ 选择技能。技能提供操作说明，不能扩大权限。见使用插件。

将启动方式、目录布局等共享约定放在 /workspace/WORKSPACE.md。助手在每个新任务读取一次，修改在下一任务生效；请只写适合工作区成员共享的信息。

管理记忆

在管理面板或工作区会话中打开记忆，可管理当前账号的个人记忆；手机端从会话右上角的更多菜单进入。

个人记忆文档仅本人可直接查看和管理。助手会在管理面板和工作区任务中使用这些记忆，回复可能向工作区成员展示。通过外部插件绑定发起的任务也使用绑定人的记忆，请使用专门账号绑定，并只保存适合共享的信息。

可新增、编辑、合并、下载或导出记忆。已保存的记忆独立于源会话保留，删除会话不会删除对应记忆。清除只影响当前账号，并按平台要求验证身份。

自动生成、保留期限和每位用户的配额由超级管理员管理，外部工具上下文默认不用于生成记忆。关闭记忆功能后仍可管理已有文档。

数据库迁移要求见升级与备份。

创建 AI 定时任务

在工作区中创建一次性或 cron 定时任务，填写目标和运行策略，每次运行会以任务所有者的当前权限和模型策略创建独立工作区会话。

• 默认先停止上一次运行，再开始新运行，也可选择允许继续运行。
• 默认保留最近 10 个运行会话，可设置为 1–100 个；超出数量的旧会话会先停止再删除。
• 无人值守时，询问会采用默认或推荐选项；需要 Secret 或无法安全自动处理的人工审批时，任务以可见的策略错误结束。
• 所有者被停用或失去写权限后，任务不能继续按原权限恢复。关闭定时任务阻止后续运行，取消单次运行不撤销已经完成的操作。

自动审批和完全访问权限还受无人值守策略约束。若某种方式不可选，先检查平台策略；AI 定时任务不能通过 API Key 创建或启动。

遇到模型、队列或审批问题，见常见问题。