跳到主要内容

管理 AI 会话

一个会话适合持续完成一个工程目标。把无关目标拆到新会话，可以减少上下文混淆，也更容易核对修改范围。

编辑器中的 AI Command Center 固定作为工作区 Tab 打开；App Hub 则提供独立的 AI 工作区。隐藏界面、切换 Tab 或切换到另一个会话都不会自动停止后台任务。

App Hub 和编辑器界面使用当前操作系统的字体，中文和英文均由系统提供；macOS 下采用灰度抗锯齿显示，包括 AI 会话和输入框。

打开已有会话时，先读取本地历史，无需等待账号、工作区文件监听或 AI 执行环境就绪。读取期间显示静态、淡灰色的 Theseus Logo 背景，不显示转圈、加载文字或空会话提示，历史就绪后直接显示消息；已有会话列表保持可见，发送在会话就绪后恢复。

应用中心也支持普通文件夹：选择打开文件夹或导入普通 Git 仓库后，即可在目录中聊天、操作文件和使用 Git。没有有效 .the 时不提供 Build、Run、打开编辑器及 Theseus 专用项目工作流；目录仍有独立的会话列表和历史。

新建、切换和停止​

新对话与已有对话共用固定在底部的输入框。切换会话、发送首条消息或任务详情自动显隐时，输入框的位置和宽度保持一致；上方的欢迎内容与消息历史独立滚动。AI 配置统一从左下角账号菜单进入系统设置，计费账户仍可在输入框内切换。

深色主题下，页面使用柔和的深灰底色，AI 输入框使用比页面更亮的深灰背景和细灰边框，便于识别输入区域。右侧任务详情面板与侧栏使用相同的炭灰底色、柔和灰字和浅灰悬停态。

右侧任务详情采用紧凑浮动卡片，集中显示修改统计、当前分支和提交或推送入口。点击修改的文件可展开可滚动的文件列表；窗口空间不足时，浮动卡片自动隐藏，避免遮挡聊天内容。

可在左下角账号菜单的主题中切换外观。浅色主题采用白色页面、近白侧栏、浅灰选中态，以及带轻阴影的白色输入框和详情面板。工业柔和使用低饱和灰绿背景与绿色强调；都会夜色使用烟紫背景与珊瑚色强调。输入框、详情面板、悬浮提示和辅助文字随主题统一调整；跟随系统自动使用浅色或深色。

  • App Hub 启动时恢复上次查看的会话，不再显示独立的项目列表页。没有记录时进入新建会话；记录中的会话已删除或归档时，在原项目中新建；项目已移除时，先在标题中选择项目。
  • 侧栏顶部的新对话沿用当前项目进入草稿。离开时停留在新建会话页，下次也回到新建会话页；未发送的草稿正文不跨重启保存。
  • 选择新建后先进入草稿；发送第一条消息时才创建会话并显示在左栏，未发送的草稿不显示为会话条目。
  • 提交消息时，输入框中的文字、引用和图片预览一起立即清空，不等待图片处理或发送确认；仅发送图片也一样。图片准备好后，新会话显示用户消息，AI 开始运行后再显示思考状态。图片读取或发送失败时显示错误；若仍停留在原会话且未修改文字或附件，会恢复原文、引用和图片以便重试，不覆盖新输入的内容。
  • App Hub 新建会话页可直接点击标题中带下划线的项目名切换项目。下拉列表支持按名称或路径搜索，并沿用侧栏的置顶和排列顺序。切换时标题和输入框保持显示，文字草稿保留并可继续编辑；项目准备好后即可发送。文件、Skill 引用和图片需重新添加。发送后会话归属固定，已有会话从侧栏切换；独立编辑器中的会话始终属于该编辑器项目。
  • 每个 App 有独立的会话列表，切换 App 不会混用工程上下文。侧栏以紧凑的单行显示项目和会话，会话标题及“显示更多”与项目名称对齐，选中背景覆盖整行。
  • 可以在项目展开后的会话列表中拖拽会话调整顺序。拖动时原条目变暗，列表保持原位，并显示目标插入线，会话标题的浮动预览跟随鼠标。拖动期间不会触发其他条目的悬停高亮、操作按钮或提示卡片；松开后才完成移动。该顺序会持久化，不会按会话修改时间自动重排。
  • 当前会话执行时可以发送 follow-up；它会在同一会话中排队。
  • 切换到其他会话或项目后，原任务可以继续运行；左栏持续显示运行中、排队或等待输入状态。列表刷新会保留已展开的“显示更多”范围，并确保当前会话仍在可见范围内。
  • 已完成的 AI 回复下方可以选择分叉对话，从该回复创建并打开一个独立会话。新会话标题按同一基名依次使用 name (1)、name (2)，便于和源会话区分。当前轮仍在运行时，之前已经完成的回复仍可分叉；尚未完成的当前回复不能分叉，原会话也不会因此停止。
  • 停止只终止当前选中会话，并清除它尚未执行的排队消息。
  • 当前会话运行时，按一次 Esc 进入停止确认，停止按钮暂时隐藏方块，只保留圆圈；2 秒内再次按 Esc 才会停止，超时恢复原按钮。直接点击停止仍立即停止。
  • 删除运行中的会话会先停止它，再删除本地历史；其他会话不受影响。
  • 未发送草稿会在当前 App 内保留。Enter 发送，Shift+Enter 换行。

不要让两个会话同时修改同一个 Page、QG 或配置文件。必须并行时，先划分互不重叠的文件范围，结束后再检查 Git 差异和 Problems。

快速跳转历史消息​

用户消息超过 5 条时，消息区左侧会显示快速跳转刻度，每条刻度对应一条用户消息。鼠标靠近时，附近刻度随距离平滑放大，并显示该条用户消息及回复摘要；点击即可跳转。移开鼠标后，当前可见区域对应的所有对话轮次会高亮，阅读长回复时仍标记所属的用户消息。刻度较多时可在刻度区滚动；键盘聚焦后可用上下方向键选择，按 Enter 跳转。

用 @ 给出准确上下文​

在输入框键入 @，选择当前 App 的文件或 Skill，例如：

  • 当前 .qp Page 或 .qpc Component；
  • 当前 .qg QG；
  • 当前 Query、Variable 或其他 App 设置；
  • 当前 App 的自定义 Object 能力；
  • 与当前任务匹配的引导流程。

只引用与目标直接相关的内容。引用更多文件不会自动提高质量，过期或无关材料反而会增加歧义。

一个清楚的开场可以是：

先只读检查 @pages/main.qp 和当前 Problems。
目标：解释启动按钮为什么没有调用现有 QG。
这一步不要修改文件，也不要运行设备。
输出：根因、影响范围和最小修复建议。

项目 AI 说明与可复用流程​

Theseus 为 Page、QG、Query 和自定义 Object 能力提供引导流程，团队也可以为项目补充自己的 AI 说明和可复用流程。这些内容用于约束 AI 的工作方式，不能替代当前 App 的真实文件和诊断。

跨会话长期有效的工程约束应由团队维护在项目 AI 说明中，例如命名规则、禁止修改的 Safety 范围和交付检查。专项步骤适合整理为项目可复用流程。

功能包安装、更新或移除后，不必新建会话。让 AI 重新查询当前 Object 能力；会话中的旧查询结果只是历史快照。

模型与上下文​

点击输入框里的模型控件可打开设置浮层。点击浮层上方的模型名称，按名称或 Provider 搜索并更换模型；下方的分档滑块用于调整思考强度，拖动时预览、松开后应用，也可用键盘方向键调整。档位以当前模型实际支持的选项为准；没有可调档位时不显示滑块。切换会话时，模型控件暂时不可操作并保持原有显示，待目标会话加载完成后一起更新模型和思考强度；切换本身不会修改会话设置。发送和停止按钮也保持切换前的显示，加载期间暂不可操作，完成后更新为目标会话的状态。

  • 首页尚未选择项目时也可以查看和选择模型；发送消息前仍需选择项目。新会话会记住为新任务选择的模型和思考强度，切换项目或重启后继续沿用。打开或修改已有会话不会覆盖新会话偏好；已有会话保留自己的模型和思考强度。首次使用时需要明确选择模型。
  • 模型下线、权益变化或 Provider 断开后，旧选择会显示为暂不可用，不会静默切换到另一个模型。
  • 复杂的跨资源任务适合更强推理能力；小范围解释和修复可以优先速度。
  • 输入框旁的上下文圆环显示当前占用；悬停或聚焦可在紧凑浮窗中查看已用和剩余比例，下方显示已用 / 总量 token 数。
  • 接近上下文上限时，会话会自动压缩旧上下文并继续。界面仍保留原始消息，压缩后的首次精确占用可能短暂显示为 ?。

如果会话已经混入多个目标、频繁纠正范围或依赖大量过期结果，新建会话通常比继续追加更可靠。

看懂任务状态​

运行中的会话会显示当前思考、文件操作、检查或命令。多个相关工具动作可能收在一个可展开的活动组中；展开后可查看每一步的成功或失败结果。整轮结束后，默认只保留最后回复和修改总结，中间说明、工具记录和上下文压缩提示收进处理用时一行；点击该行可展开或收起完整过程。复制回复只复制最后回复。

本轮任务结束后，回复下方会一次性显示文件编辑或写入工具更改的文件和增删行数，执行过程中不逐步显示；之前已完成轮次的总结仍保留。同一文件的多处、多次修改合并为最终差异，改回原样的文件不再列出；新文件标记为新增。点击文件行可展开查看差异，重新打开会话后仍可查看当时记录的内容。该汇总不追踪命令行修改和文件删除，也不提供撤销；此前未记录修改内容的历史会话不会补算。

AI 的正文结论不能替代工程证据。完成时至少检查：

  1. 实际修改的文件与最初范围一致。
  2. Problems 没有新增阻塞错误。
  3. AI 验证的是最终保存内容，而不是中间草稿。
  4. 需要时已经完成 Build、Start 或 Debug 验收。
  5. 设备、安全、权限和生产写入中的未验证项已经明确列出。

会话数据与隐私​

使用 AI 前请了解以下行为：

  • 会话完整历史保存在当前设备。升级前未进入当前会话索引的旧记录不会自动出现在列表中。
  • AI Command Center 的新会话和之后发生变化的会话会归档到 Qixin 平台；断网时当前对话仍可继续，归档会在恢复连接后重试。
  • 模型服务是否保留请求数据由所选服务和组织策略决定；Qixin 平台的会话归档使用下述独立规则。
  • 删除本地会话不会删除平台归档。平台归档长期保留，没有自动到期。
  • 普通用户、会话创建者和组织 OWNER/ADMIN 无法查看归档正文。只有平台全局管理员能在审计约束下预览、下载单个原始会话或执行永久合规删除。
  • 平台的预览、下载和删除会记录管理员、目标会话、动作和时间；永久删除后会拒绝同一会话再次上传。

不要在对话中放入密码、API Key、设备授权码、无权上传的客户隐私数据，或必须留在现场的原始生产数据。上线前应由组织确认模型优化用途、授权、访问和删除规则。

一个健康会话如何结束​

要求 AI 最后给出：

  1. 实际修改的资源。
  2. 已运行的诊断和运行检查。
  3. 尚未验证的现场条件。
  4. 需要人工确认的设备、安全、权限或生产写入。
  5. 应写入项目 AI 说明或可复用流程的长期约束。

下一步参见写一个可验收的 AI 工程任务和使用 AI Command Center。