本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 查看转换作业历史记录
<a name="transformation-job-history"></a>

Amazon Q 会全面汇总您的 Java 转换作业历史记录，支持您在 IDE 和命令行中跟踪、查看转换作业详情。

转换作业历史记录包含有关作业的以下信息：
+ **日期**：转换作业的执行时间
+ **项目名称**：已转换项目的名称
+ **状态**：转换作业的当前状态
+ **持续时间**：转换作业的完成时长
+ **任务 ID**：转换作业的唯一标识符
+ **差异补丁**：指向包含所有代码更改的最终差异补丁文件的链接或路径
+ **摘要**：指向包含变更详情的转换摘要文件的链接或路径

**注意**  
作业历史记录中仅显示该功能发布后执行的转换作业。有关功能发布日期，请参阅 [《Amazon Q 开发者版用户指南》文档历史记录](doc-history.md)。

## 在 IDE 中查看作业历史记录
<a name="ide-job-history"></a>

**注意**  
目前此功能仅在 Visual Studio Code 中可用。

Visual Studio Code 中的“转换中心”会全面展示您的 Java 转换作业历史记录。

转换中心的表格会列出过去 30 天内最新的 10 条转换作业。从表格中，您可访问转换构件，也可刷新作业状态以跟踪进度、获取缺失的构件。

### 检索转换构件
<a name="retrieve-artifacts"></a>

在作业历史记录表格中，您可访问转换构件（如差异补丁文件、摘要文件）。选择对应的链接，即可在 IDE 中打开差异补丁或摘要。

这些构件会本地存储在 `.aws/transform` 目录中，因此您也可直接从该目录访问过往作业中已下载的转换构件。

### 刷新作业状态
<a name="refresh-jobs"></a>

您可以刷新作业历史记录表中的作业状态。刷新失败的作业可从服务器端获得可能尚未同步到服务器的更新状态（例如在 Amazon Q 能够恢复失败的作业时）。您也可以刷新已完成的作业，以下载尚未显示的构件。

### 如何针对在 IDE 中运行的作业存储作业历史记录
<a name="ide-history-storage"></a>

在 Visual Studio Code 中，所有转换作业信息及构件均本地存储在 `.aws/transform` 目录中。存储的组织结构如下：

```
.aws/transform/
├── [project-name-1]/
│   ├── [job-id-1]/
│   │   ├── diff.patch
│   │   ├── [summary-1]/
│   │   │   └── summary.md
│   │   │   └── buildCommandOutput.log
│   └── [job-id-2]/
│       ├── diff.patch
│       ├── [summary-2]/
│       │   └── summary.md
│       │   └── buildCommandOutput.log
└── [project-name-2]/
    └── [job-id-3]/
        ├── diff.patch
        ├── [summary-3]/
        │   └── summary.md
        │   └── buildCommandOutput.log
```

## 在命令行中查看作业历史记录
<a name="cli-job-history"></a>

对于通过命令行执行的转换作业，可使用 **qct history** 命令查看转换作业历史记录，并支持自定义选项。

对于 CLI，转换作业的历史信息均本地存储在 `.aws/qcodetransform/history/` 目录中。

### 使用 qct history 命令
<a name="cli-history-command"></a>

查看转换作业历史记录的基础命令如下：

```
qct history
```

默认情况下，该命令会显示最新的 10 条转换作业，同时包含所有暂停或进行中的作业。

您还可通过 **--limit** 标志指定要显示的作业历史记录条目数。例如，要显示 20 条作业，请运行以下命令：

```
qct history --limit 20
```