任务详情页 (Task Detail Page)

任务详情页是 智码方舟 的核心工作区。在这里，您可以实时监控 AI 生成毕业设计的全过程，与系统交互，并管理生成的代码文件。

界面概览

页面主要分为三个部分：

1. 顶部状态栏：显示任务状态、容器状态及全局操作按钮。
2. 左侧导航栏：切换不同的功能视图。
3. 主内容区：显示当前选中视图的具体内容。

顶部状态栏

状态栏提供了任务的关键信息和控制功能：

• 任务信息：显示任务 ID 和关联的对话。
• 状态标签：
  • 任务状态：如 运行中、已完成、已暂停 等。
  • 阶段状态：显示当前 AI 正处于哪个生成阶段（如需求分析、代码生成、测试等）。
  • 容器状态：显示执行任务的 Docker 容器是否正常运行。
• 连接状态：显示 WebSocket 是否连接。绿点表示实时连接正常，可以接收实时日志和进度。
• 操作按钮：
  • 暂停/继续：在任务运行时暂停或恢复。
  • 取消：终止当前任务。
  • 停止：强制停止容器（仅限特定情况）。
  • 预览：任务完成后，点击可启动预览模式（需消耗预览配额）。

功能视图

通过左侧导航栏可以切换以下视图：

1. 概览 (Dashboard)

显示任务的整体进度和基本信息。当任务正在运行时，这里会显示当前的生成总进度。

2. 检查点 (Checkpoints)

查看和管理项目的文件版本。

• 文件树：浏览项目的目录结构。
• 下载：
  • 项目文件：下载完整的项目源码包。
  • 规划文件：下载 AI 生成的设计文档和规划文件。
• 版本切换：如果任务有多个检查点（Checkpoint），可以在此切换查看不同历史版本。

3. 工作台 (Live Workstation)

这是与生成环境交互的核心区域：

• 实时文件查看：点击文件树中的文件，查看 AI 正在编写的代码内容。
• 文件下载：将当前工作区的所有文件打包为 ZIP 下载。
• 开发服务器控制：
  • 启动/停止前端或后端开发服务器。
  • 查看开发服务器的运行端口和状态。

4. 需求 (Requirements)

回顾当前任务所基于的需求描述。这有助于在生成过程中随时确认 AI 是否偏离了最初的要求。

5. 日志 (Logs)

查看系统生成的详细日志信息。

• 实时日志：通过 WebSocket 实时滚动显示 Docker 容器内的输出。
• 下载日志：将所有日志导出为文本文件，便于排查错误。
• 全部日志：如果日志过多，可以开启"全部日志"模式从服务器拉取完整记录。

常见操作指南

如何下载代码？

1. 切换到 工作台 (Live) 或 检查点 (Checkpoints) 视图。
2. 在 检查点 视图中，选择最新的 Checkpoint，点击下载图标即可获取 ZIP 包。
3. 或者在 工作台 视图中，点击顶部的 "下载工作区" 按钮。

任务卡住了怎么办？

1. 首先检查顶部状态栏的 WebSocket 连接 是否正常。
2. 查看 日志 视图，看是否有报错信息。
3. 如果容器状态异常，可以尝试 暂停 后再 继续，或者使用 停止 按钮重启容器环境。

关于预览模式

当任务状态为 COMPLETED（已完成）时，你可以点击顶部的 预览 按钮。系统会启动一个临时的预览环境，允许你在浏览器中直接访问生成的网页应用。

• 预览模式有时间限制和重启次数限制。
• 预览结束后，环境会被自动回收。

计费与点数

部分操作（如"继续修改"）可能会消耗您的点数余额。如果点数不足，系统会弹出提示引导您进行充值或调整操作。