出差費用自動報核系統 v4.1.3n - Multi-Engine

📖 系統操作手冊 (v4.1.3n)

本手冊詳細記載系統的所有操作邏輯與底層機制。無論您是初次設定，或是遇到解析異常，都能在此找到完整的解答與對策。

1. NVIDIA API Key 申請與配置

1. 請先前往 NVIDIA 官方開發者網站：build.nvidia.com
2. 點擊網頁右上角的「Login」進行註冊，並完成手機簡訊的雙重驗證。
3. 登入成功後，點擊右上角頭像，選擇「API Keys」進入金鑰管理頁面。
4. 點擊「Generate API Key」，系統會產出一組以 nvapi- 開頭的長字串，請將其複製。
5. 回到本系統，將金鑰貼入左側的「NVIDIA NIM API Key」輸入框。系統會自動將其安全地記憶在您的瀏覽器 localStorage 中，下次開啟無須重新輸入。

2. 基礎與進階參數設定

• 出差日期與地點： 系統會以此為基準計算總天數，並自動生成一筆獨立的「生活費」。若 AI 解析單據時無法明確辨識地點，將會自動把此處設定的「出差地點」作為防呆的預設值填入。
• 創意度 (Temperature)： 用於控制 AI 回答的發散程度。數值範圍 0~2，預設為 0.1 以確保財務數據的嚴謹與絕對精準。若您使用千億參數級別的模型進行複雜的邏輯推理，可嘗試微調至 0.3~0.6 以增加其思維靈活度。
• 開啟深度思考 (Enable Thinking)： 專為高階模型（如 Nemotron、DeepSeek）設計的開關。開啟後，AI 在輸出最終 JSON 之前，會在背景進行大量的邏輯推演與草稿運算，能大幅提升複雜數字加總與欄位映射的準確率，但會增加運算時間與伺服器負載。
• 批次與併發： 預設間隔為 0.1 秒。一般文字模型建議 10 筆併發；Nemotron 3 Super／Ultra 建議 20 筆。系統仍會依 API 限流排隊與重試，避免用速度犧牲成功率。
• Vision 影像保護： 文字結構化與圖片 Vision 各自最多 10 筆並行，互不搶占通道。完整 OCR 最長等待 120 秒，僅對暫時性錯誤（含 API 500、限流、逾時與暫時網路中斷）重試 1 次；重試等待會先釋放 Vision 通道再重新排隊。超時會明確記錄在進階分析與診斷 Log。
• Vision 圖像細節：新使用者預設「自動升級」：先以 Low 讀取，僅在共通分流明確回報日期、總額、幣別、路線或水單關鍵欄位看不清時，自動再以 High 覆核。它會納入分析快取簽章、重新轉換鎖定設定與診斷 Log，切換後不會讀取另一細節的舊結果。既有使用者保存的 Low／High 選擇不會被本版變更。
• Vision 擷取規格與比較：正式建議使用「共通分流 v1」，先由 Vision 依畫面判定發票、收據、行程、票根或水單，再依類型保留日期、金額、路線與水單明細的原始標籤；不使用檔名推論。比較測試會並列標準 v1、候選 A3.1 與共通分流 v1；可勾選 3～6 張圖片，有既有標準答案的圖片會自動評分日期、金額、地點、類型等欄位。測試使用正式 OCR 的一次重試機制，且會交錯三組的呼叫順序。測試不會覆蓋報核表、合併結果或正式快取，結果會獨立寫入診斷 Log。
• 檔名前綴協助解析： 預設關閉，避免檔名錯誤影響結果。開啟後僅接受檔名最開頭的固定前綴，作為安全的處理提示；內容辨識、金額與費用分類仍以單據文字／影像為準。點擊右側資訊圖示可查看完整規則與例子。

3. 核心功能按鍵說明

• 🤖 自動配對合併： 點擊後，系統會自動比對主檔（發票、行程單）與副檔（水單）的金額、日期與關鍵字，進行智慧三層階層縫合。水單會保留原幣金額、台幣本金與手續費，主金額以「台幣本金＋手續費」核算；生活費置頂、可報帳項目依日期、純紀錄置底。手動拖曳的順序會在後續匯入與重新解析時保留，直到您主動點擊此按鈕。
• 🔄 重新轉換： 當某幾張單據解析失敗或不如預期時，只需勾選該單據左側的核取方塊，點擊此按鈕即可針對選定單據進行完整重新解析，不影響其他已完成的資料。它會略過完成快取、清除該筆中間 OCR 快取，並鎖定您按下按鈕當下選擇的模型與參數；因此切換模型後一定會實際重新讀取與呼叫新模型。
• 📥 匯出 Excel 報表： 點擊後系統會進行全面檢查，確保沒有紅字缺漏 ⚠️。確認無誤後，會將資料打包下載為標準 .xlsx 財務報表（純紀錄項目會被自動過濾）。
• 📑 合併 PDF 匯出： 將列表中的所有圖檔與文件，統一置中縮放至 A4 畫布，並在右下角自動加蓋 NO. #X 藍色標籤編號，最後合併為單一 PDF 檔，方便列印存查。

4. 表格應用與操作技巧

• 即時編修： 表格內的所有文字與數字（包含憑證日期、起訖點、費用種類、幣別、金額、備註），皆支援滑鼠點擊直接修改。
• 階層式檢視： 主項目（如發票）左側會有展開箭頭 ▶，點擊可展開檢視掛載其下的子項目（如水單），方便核對整筆報帳的組成結構。
• 拖曳排序： 您可以按住單據左側的拖曳把手，自由上下移動調整順序，或是將水單拖入特定的發票中建立父子關聯。

5. 單據分類與智慧推論邏輯

• 自動分類： AI 會根據憑證內容，自動歸類為「交通費」、「住宿費」或「其他」（如保險、通話費、eSIM）。
• 純紀錄 (不報帳)： 單純的搭乘憑證（如登機證、高鐵票根），系統會強制將其歸類為純紀錄，金額設為 0，並自動置放於表格最底部，不列入 Excel 計算。
• 地點與票根佐證： 地點以單據內容中的精確行政區與路線優先（例如中壢不會被泛化成桃園；南沙統一為廣州）。機場接送僅在文字佐證不足時補上住家；同日、同金額且路線唯一的票根可校正主單路線，不能任意覆蓋多個候選。
• 影像與 PDF：可擷取文字的 PDF 先走文字擷取；只有文字不足時才轉影像。照片會進行保守的灰階／裁切前處理，不確定時保留原圖，以正確率為優先。選擇「自動升級」時，Vision 一律先以 Low 解析；只有共通分流回報文件的必要佐證看不清，才對該張影像以 High 覆核。未加前綴、水單、發票與行程圖片會直接完整 OCR；只有 純紀錄_ 會先快篩再決定是否 OCR。進階分析可查看每張單據實際路徑、High 覆核次數與總耗時。

6. 常見錯誤碼與系統對策

7. 問題回報與 Log 追蹤

• 當您發現 AI 解析的數據有誤，請直接勾選該筆單據左側的方塊，並點擊上方功能列的「重新轉換」；它會略過完成結果與中間 OCR 快取，從讀取單據開始重新走完整解析流程。診斷 Log 會記下重新轉換要求的模型設定，便於核對實際執行模型。
• 系統會記錄您當下的狀態與錯誤原因。您也可以隨時在左側「進階參數」中點擊「下載 AI 診斷 Log (.json)」，將底層的端到端耗時與錯誤紀錄提供給開發者排查。

⚡ NVIDIA 推薦模型清單

📝 文字模型 (Text-only)

🖼️ 視覺模型 (Vision / OCR)

⏱️ 單據處理效能分析

🏷️ 檔名前綴協助解析

這是可選的加速提示，預設關閉。只有在左側勾選「啟用檔名前綴協助解析」後，系統才會辨識檔名開頭的前綴；沒有前綴或未勾選時，完全沿用既有完整解析流程。

前綴與範例	用途與流程
水單_上海住宿刷卡通知.jpg	信用卡／銀行水單。直接進 OCR，不走票根快篩；保護為 receipt，保留原幣、台幣本金與手續費。
發票_深圳機場接送.pdf	付款憑證或電子發票。作為發票提示直接進完整 OCR／文字結構化；交通、住宿、其他仍由內容判定。
行程_南沙客運港.pdf	行程單提示，保留日期與路線供自動合併佐證，不會因檔名前綴直接變成純紀錄。
純紀錄_深圳到上海登機證.jpg	提醒模型優先確認是否為搭乘佐證；內容若不是票根，系統不會靜默歸零，而會保留內容結果並提出衝突提示。

水單合併與手續費

1. 水單必須保留為副檔／receipt，不可視為純紀錄。
2. 系統以手動關聯優先，再以行程明細的日期、原幣／金額及唯一性配對。
3. 水單主金額採 台幣本金 + 台幣手續費；原幣金額留在明細，供核對與匯出使用。
4. 找不到對應主檔或資料不足時保留警示，不會刪除水單或自行併入不確定項目。

命名建議：一個檔案只使用一個前綴，前綴後直接接底線與描述，例如 水單_廣州住宿_0705.jpg。不要使用「我的水單_」或把前綴放在中段，這類名稱不會觸發規則。

🧪 Vision 擷取規格比較

正式解析預設使用標準 v1。候選 A2 與 A3.1 僅改變 Vision 如何轉錄影像，文字模型、後處理、水單合併與手續費規則都不變。

1. 在中央清單勾選 3～6 張圖片；圖片以外的檔案、生活費與手動項目不能用於本比較。
2. 按下「比較 v1、A2 與 A3.1」。每張圖片固定使用相同 Vision 模型、圖像細節與文字模型；三組順序會依圖片交錯，降低服務暖機或短暫壅塞造成的偏差。
3. OCR 遇到暫時性錯誤會像正式解析一樣釋放通道後重試一次。右側顯示 Vision、文字與總耗時，以及原始 OCR／最終 JSON。若檔名存在內建標準答案，會自動評分欄位；沒有標準答案的新增圖片仍可人工比對。測試只寫入診斷 Log，不會改動報核表、合併或正式快取。