---
title: "查看 OCR 任務的執行紀錄並排查失敗的檔案"
description: "由任務列表逐層查到單一檔案的處理結果、解讀狀態標籤，並依失敗訊息判斷成因與處置"
canonical_url: "https://docs.ardge.com/zh-tw/knowledge/precisemd/ocr-task-history"
---
# 查看 OCR 任務的執行紀錄並排查失敗的檔案

> 由任務列表逐層查到單一檔案的處理結果、解讀狀態標籤，並依失敗訊息判斷成因與處置

## 概觀

任務執行結束後，若輸出資料夾中的檔案數量與預期不符，須逐層查出是哪一份檔案、因何種原因未產出結果。PreciseMD 將執行資訊分為三層：任務列表顯示最近一次的結果，**歷史紀錄** 顯示每一次執行的統計，**檔案詳細資訊** 顯示該次執行中每一份檔案的處理狀態與失敗原因。

本文說明如何從任務列表逐層查到單一檔案的處理結果、如何解讀各項狀態標籤，以及常見失敗訊息的處置方式。

## 你將學會什麼

- 由任務列表逐層查到單一檔案的處理結果
- 解讀執行與檔案兩層的狀態標籤
- 依失敗訊息判斷成因並採取對應處置
- 取消執行中的任務

**預計時間：約 10 分鐘**

## 適用版本

- PreciseMD 1.4.0 及以上版本

## 開始之前

- 已建立 OCR 任務且至少執行過一次。建立方式見[設定排程讓 OCR 任務定時處理資料夾中的檔案](https://docs.ardge.com/zh-tw/knowledge/precisemd/schedule-ocr-tasks)

## 步驟 1：查看最近一次的執行結果

1. 前往 **OCR 任務** 頁面
2. 檢視該任務的 **上次執行** 欄位

該欄位顯示最近一次執行的狀態標籤與完成時間。狀態的意義如下：

<table>
<thead>
  <tr>
    <th>
      標籤
    </th>
    
    <th>
      意義
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        等待中
      </strong>
    </td>
    
    <td>
      已排入佇列，尚未開始
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        處理中
      </strong>
    </td>
    
    <td>
      執行中
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        完成
      </strong>
    </td>
    
    <td>
      所有檔案皆處理成功
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        部分失敗
      </strong>
    </td>
    
    <td>
      部分檔案處理失敗
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        失敗
      </strong>
    </td>
    
    <td>
      執行失敗
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        停止中
      </strong>
    </td>
    
    <td>
      已送出取消請求，正在收尾
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        已停止
      </strong>
    </td>
    
    <td>
      已取消
    </td>
  </tr>
</tbody>
</table>

![任務清單上次執行狀態](https://docs.ardge.com/screenshots/knowledge/zh-tw/precisemd/ocr-task-history/step-1.webp)

## 步驟 2：開啟歷史紀錄

1. 於該任務所在列點擊操作選單
2. 選擇 **歷史紀錄**

**歷史記錄** 頁面每一列代表一次執行，欄位如下：

<table>
<thead>
  <tr>
    <th>
      欄位
    </th>
    
    <th>
      內容
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        開始時間
      </strong>
    </td>
    
    <td>
      該次執行的開始時間
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        完成時間
      </strong>
    </td>
    
    <td>
      該次執行的結束時間
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        觸發方式
      </strong>
    </td>
    
    <td>
      <strong>
        排程
      </strong>
      
       或 <strong>
        手動
      </strong>
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        狀態
      </strong>
    </td>
    
    <td>
      該次執行的狀態標籤
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        進度
      </strong>
    </td>
    
    <td>
      已完成檔案數佔總檔案數的百分比
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        總檔案數
      </strong>
    </td>
    
    <td>
      該次掃描到的檔案總數
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        成功數
      </strong>
    </td>
    
    <td>
      處理成功的檔案數
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        失敗數
      </strong>
    </td>
    
    <td>
      處理失敗的檔案數
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        執行時間
      </strong>
    </td>
    
    <td>
      開始時間至完成時間的耗時
    </td>
  </tr>
</tbody>
</table>

**進度** 欄位在執行結束後改以圖示表示結果：完成顯示勾選圖示，**失敗** 與 **部分失敗** 顯示叉號圖示，**已停止** 與 **停止中** 顯示減號圖示。

![功能選單](https://docs.ardge.com/screenshots/knowledge/zh-tw/precisemd/ocr-task-history/step-2-1.webp)

![歷史紀錄](https://docs.ardge.com/screenshots/knowledge/zh-tw/precisemd/ocr-task-history/step-2-2.webp)

## 步驟 3：查看單一檔案的處理結果

1. 於要檢視的執行紀錄該列點擊 **更多詳情**

**檔案詳細資訊** 視窗每一列代表一份檔案，欄位為 **更新時間**、**檔名**、**狀態**、**耗時**、**頁數** 與 **備註**。

**備註** 欄位依狀態顯示不同內容：

<table>
<thead>
  <tr>
    <th>
      狀態
    </th>
    
    <th>
      備註欄的內容
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        完成
      </strong>
    </td>
    
    <td>
      空白
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        已跳過
      </strong>
    </td>
    
    <td>
      <strong>
        內容未變更
      </strong>
      
      。檔案內容與上次執行相同，本次未重新解析
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        已刪除
      </strong>
    </td>
    
    <td>
      <strong>
        來源已刪除
      </strong>
      
      。來源檔案已不存在
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        失敗
      </strong>
    </td>
    
    <td>
      具體的失敗訊息；無對應訊息時顯示 <strong>
        處理失敗
      </strong>
    </td>
  </tr>
</tbody>
</table>

![檔案詳細資訊、失敗原因](https://docs.ardge.com/screenshots/knowledge/zh-tw/precisemd/ocr-task-history/step-3-1.webp)

![檔案詳細資訊、已跳過](https://docs.ardge.com/screenshots/knowledge/zh-tw/precisemd/ocr-task-history/step-3-2.webp)

## 步驟 4：檢視實際輸出的內容

處理成功的檔案可直接在介面中檢視其 Markdown 輸出。

1. 前往 **OCR 任務** 頁面，點擊該任務的名稱
2. 於 **執行結果** 頁面找到該檔案所在列
3. 點擊 **結果** 欄位的 **查看結果**

**執行結果** 頁面的欄位為 **檔案名稱**、**狀態**、**結果**、**處理時間** 與 **備註**。狀態非 **完成** 的檔案，**結果** 欄位不提供 **查看結果**。

## 步驟 5：取消執行中的任務

1. 於 **歷史記錄** 頁面找到狀態為 **等待中** 或 **處理中** 的執行紀錄
2. 點擊該列的 **取消**

畫面顯示「已送出取消請求」，狀態轉為 **停止中**，收尾完成後轉為 **已停止**。

<warning>

**已結束的執行無法取消：**

若該次執行在請求送出前已經結束，系統回覆「無法取消：任務已不在執行中」。

</warning>

## 疑難排解

下表為 **備註** 欄位可能出現的失敗訊息及其處置方式：

<table>
<thead>
  <tr>
    <th>
      訊息
    </th>
    
    <th>
      可能原因
    </th>
    
    <th>
      處理方式
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        OCR 處理失敗，請確認檔案內容是否正常
      </code>
    </td>
    
    <td>
      該檔案的內容無法完成解析
    </td>
    
    <td>
      於 <strong>
        遊樂場
      </strong>
      
       單獨上傳該檔案試跑，確認是否為檔案本身的問題
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        檔案損毀或無法讀取
      </code>
    </td>
    
    <td>
      來源檔案損毀，或讀取過程中斷
    </td>
    
    <td>
      於來源端重新產生該檔案後再次執行
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        不支援的檔案格式
      </code>
    </td>
    
    <td>
      副檔名雖被接受，實際內容不屬於支援的格式
    </td>
    
    <td>
      確認檔案內容與副檔名相符，支援清單見<a href="https://docs.ardge.com/zh-tw/knowledge/precisemd/formats-and-limits">
        PreciseMD 支援哪些檔案格式與數量限制？
      </a>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        磁碟空間不足，請釋放空間後重試
      </code>
    </td>
    
    <td>
      輸出目標的可用空間不足
    </td>
    
    <td>
      於 NAS 釋放空間後重新執行該任務
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        服務已重啟，請重新執行
      </code>
    </td>
    
    <td>
      執行期間服務重新啟動
    </td>
    
    <td>
      重新執行該任務
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        AI 服務暫時無法回應，請稍後重試
      </code>
    </td>
    
    <td>
      模型服務當下無法回應
    </td>
    
    <td>
      於 AI Model Center 確認模型狀態為 <strong>
        Running
      </strong>
      
       後重新執行
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        NAS 連線中斷，請檢查網路與共用路徑設定
      </code>
    </td>
    
    <td>
      執行期間與 NAS 的連線中斷
    </td>
    
    <td>
      確認網路與共享資料夾設定後重新執行
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        NAS 權限不足
      </code>
    </td>
    
    <td>
      NAS 端帳號對該資料夾的權限不足
    </td>
    
    <td>
      於 NAS 授予來源資料夾的閱讀權限與目標資料夾的寫入權限
    </td>
  </tr>
</tbody>
</table>

下表為操作任務時可能出現的訊息：

<table>
<thead>
  <tr>
    <th>
      訊息
    </th>
    
    <th>
      可能原因
    </th>
    
    <th>
      處理方式
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        已有執行中的任務，請稍後再試
      </code>
    </td>
    
    <td>
      前一次執行尚未結束
    </td>
    
    <td>
      待前次執行結束後再行觸發
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        任務正在執行中，無法操作
      </code>
    </td>
    
    <td>
      對執行中的任務進行編輯或刪除
    </td>
    
    <td>
      待執行結束，或先取消該次執行
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        無法取消：任務已不在執行中
      </code>
    </td>
    
    <td>
      該次執行在請求送出前已結束
    </td>
    
    <td>
      重新整理頁面確認最新狀態
    </td>
  </tr>
</tbody>
</table>

## 相關文章

- [設定排程讓 OCR 任務定時處理資料夾中的檔案](https://docs.ardge.com/zh-tw/knowledge/precisemd/schedule-ocr-tasks)
- [OCR 輸出資料夾中會產生哪些檔案？](https://docs.ardge.com/zh-tw/knowledge/precisemd/ocr-output-files)
- [PreciseMD 支援哪些檔案格式與數量限制？](https://docs.ardge.com/zh-tw/knowledge/precisemd/formats-and-limits)


## Sitemap

See the full [sitemap](https://docs.ardge.com/sitemap.md) for all pages.