开发实践

管理会话、排队与任务引导

查找和整理会话,区分独立排队与补充当前任务,并核对执行进度。

需要长期维护多个项目与任务的桌面用户约 7 分钟阅读
操作入口
桌面端左侧 → 智能编码 / 智能对话 → 会话列表
完成结果
能定位原会话,正确发送后续任务或引导,确认状态后整理历史。
本篇目录

1. 按任务新建会话

以下操作以桌面端侧栏为准。智能编码按项目组织会话,智能对话显示对应的会话列表。建议一项明确任务使用一个会话;同一问题的补充信息继续放在原会话中,无关任务单独开始。

实际桌面客户端的码哥文档示例项目、项目旁新建按钮与会话条目
真实客户端侧栏:示例项目下的新建会话入口与会话条目。先确认所属项目,再开始任务;本次演示没有发送模型请求。 真实产品界面 · 演示数据
  1. 需要修改项目时进入「智能编码」,先选择正确项目。
  2. 点击项目旁的「新建会话」,或使用侧栏的「新会话」入口。
  3. 发送第一条任务前写清目标、范围和验收条件,确认会话归属。
  4. 保留重要任务的验收结果与未完成事项,便于稍后接续。

2. 用名称和置顶整理任务

名称应便于自己和接续人员识别,避免只写“测试”“问题”。标题只是查找标记,不会替代对话中的业务说明,也不会重命名磁盘中的文件或项目。

实际会话条目旁显示置顶、归档、重命名和删除按钮,演示会话已有置顶标记
真实会话行的悬停操作:从左到右是置顶、归档、重命名和删除;条目旁的置顶标记表示该会话已置顶。 真实产品界面 · 演示数据
  1. 将鼠标移到会话上,点击「重命名」;也可双击会话标题进入编辑。
  2. 输入能说明问题的名称,例如「客户列表:修复筛选分页」,按 Enter 保存;Esc 取消。
  3. 对近期常用会话点击「置顶」,标题旁会显示置顶标记。
  4. 任务不再常用时点击「取消置顶」,保持常用区域简洁。

4. 区分排队新任务与引导当前任务

任务运行时,普通发送仍会创建按顺序执行的独立排队项。希望修改当前任务要求时,可以对尚未执行的排队项点击「引导」,或在输入框更多操作中选择「补充当前任务」。

  1. 先判断新内容是下一项工作,还是对正在执行任务的补充或范围调整。独立任务保持排队即可。
  2. 对需要立即纳入当前任务的排队项点击「引导」,核对原文字与图片,查看「已接收,等待当前步骤结束」提示。
  3. 等待本轮输出与工具调用结束,再检查「已加入当前任务」与后续执行是否采用新要求。当前正在执行的操作不会被这次引导立即打断。
  4. 任务已经结束、切换或停止时,检查是否「已恢复到待执行队列」。未生效的要求会保留,重启后先核对队列再继续。

5. 看懂状态与耗时

  1. 任务卡片中的「耗时明细」可查看模型请求、工具执行和后处理耗时,以及实际使用的模型。
  2. 阅读实时日志时靠近底部会自动跟随;向上阅读后暂停跟随,可返回最新输出。
  3. 断线或切换会话后重新核对恢复的阶段和最终结果。安装、构建、测试的真实失败、超时或取消不能因后面仍有输出而视为成功。
5. 看懂状态与耗时参考表
状态应如何判断
生成参数模型仍在形成工具调用,命令尚未启动。
等待前序任务当前调用在排队,先查看前序任务。
等待授权需要处理工具审批,等待时间与命令执行时间分别记录。
准备执行 / 执行中命令启动后才开始计算执行耗时;长命令可查看最近输出与静默等待状态。

6. 归档与删除分别处理

结束但可能还需要查阅的会话优先归档。点击会话的「归档」后,可从搜索区旁的「查看已归档」进入归档列表,再通过「取消归档」恢复活跃状态。

实际客户端归档视图,包含返回活跃会话、归档搜索框和文档示例会话
真实归档视图:可在归档中继续搜索,也可返回活跃会话列表。图中的「清空」是删除操作,整理历史任务时应优先使用归档。 真实产品界面 · 演示数据
  • 删除前先保存仍需要的任务结论、路径和验证证据。
  • 批量删除时进入多选,逐项核对勾选内容和确认提示。
  • 正在执行的会话先核对停止与清理结果;停止失败或删除超时时保留历史,处理问题后重试。
  • 删除和清空归档不可当作可恢复的整理方式。删除会话不是撤销文件修改;需要恢复代码时按回退指南核对检查点。