報備郵件臺賬登記工具

將 .eml 郵件檔案（zip壓縮包或目錄）自動解析為標準報備郵件臺賬 Excel，一鍵完成登記。支援基於現有臺賬模板追加新記錄、自動去重。

適用場景

• 使用者傳送了報備郵件的 zip 壓縮包，要求整理登記
• 使用者要求按報備郵件臺賬欄位完成郵件登記
• 使用者需要將多封 .eml 郵件批次整理為臺賬
• 使用者提供了現有臺賬 xlsx，要求追加新郵件記錄
• 使用者提到"報備臺賬"、"郵件臺賬"、"報備登記"、"整理郵件"等關鍵詞

核心工作流

Step 1：確認輸入

使用者通常會隨訊息傳送郵件附件（zip壓縮包），有時還會提供現有臺賬模板。

識別以下輸入：

• 郵件檔案：zip壓縮包或包含 .eml 檔案的目錄路徑（必填）
• 臺賬模板：現有的 .xlsx 臺賬檔案（可選，用於追加記錄或保持格式一致）

如果使用者同時傳送了 zip 和 xlsx 檔案，xlsx 視為已有臺賬，新解析的記錄將追加到其中（按郵件主題去重）。

Step 2：執行解析指令碼

python3 <skill_dir>/scripts/parse_emails.py \
  --input '<郵件zip或目錄路徑>' \
  --output '<輸出xlsx路徑>' \
  [--template '<已有臺賬xlsx路徑>']

引數說明：

• --input / -i：必填，郵件zip壓縮包或包含eml檔案的目錄
• --output / -o：必填，輸出的Excel臺賬路徑
• --template / -t：可選，已有臺賬xlsx。提供時，指令碼會讀取其中的記錄，將新解析結果追加（按郵件主題去重），保留原有格式

指令碼會自動完成：

1. 解壓zip並掃描所有 .eml 檔案
2. 逐封解析：提取傳送時間、發件人、主題、收件人、抄送人
3. 智慧分類報備型別（14種類型自動識別）
4. 提取供應商/渠道名稱
5. 生成主要事由摘要（200字內）
6. 識別審批人
7. 如有模板，合併去重後輸出
8. 按時間排序，生成格式化Excel臺賬（首行凍結、自動篩選、待補充標黃）

Step 3：上傳並提供下載

使用 uploader 技能上傳生成的 xlsx 檔案：

python3 <uploader_skill_dir>/scripts/upload_media.py '<輸出xlsx路徑>'

將返回的 downloadUrl 提供給使用者。

Step 4：結果彙報

向用戶彙報：

• 共解析郵件數量
• 報備型別分佈統計
• 如有模板，說明合併情況（新增N條、已有N條）
• 如有待補充項（供應商名稱/審批人無法自動識別），提醒使用者（Excel中已標黃）

臺賬欄位

報備型別

指令碼支援以下 14 種報備型別的自動識別：

• 商務結果報備
• 陽光承諾書免籤申請
• 指定供應商申請
• 新增簡易供應商/陽光承諾書特批
• 白名單申請
• 授權自採申請
• 費用變更報備
• 特殊入庫報備
• 供應商新增審批
• 審批類報備

  7w4.net收錄了海量優質技能外掛。

• 採購方式報備
• 採購申請
• 一般報備
• 其他報備

去重規則

當提供已有臺賬模板時，按 郵件主題 + 傳送時間 進行去重：

• 主題完全相同且傳送時間一致的郵件視為重複，不重複錄入
• 新記錄追加到已有記錄之後
• 最終按傳送時間統一排序

標黃提示

以下情況會在 Excel 中標黃，提示使用者人工補充：

• 供應商/渠道名稱無法從郵件中自動提取 → 顯示"（需補充）"並標黃
• 審批人無法從郵件中自動推斷 → 顯示"（需補充）"並標黃

注意事項

• 解析僅提取郵件正文主內容，自動去除原始郵件引用（-----原始郵件-----）和簽名部分
• 如果郵件主題模式有新增，可在指令碼的 CATEGORY_PATTERNS 列表中新增匹配規則
• 輸出檔案預設命名：報備郵件臺賬_已登記.xlsx，儲存在 workspace 目錄
• 如使用者未指定輸出路徑，使用預設路徑並告知使用者

參考文件

指令碼詳細技術說明見 references/parsing_rules.md（如需修改提取規則可參考）。

這款工具質量不錯，能自動從郵件中提取資訊並生成整齊的表格。文件清晰容易理解，程式碼邏輯明確，支援追加已有表格和自動去重。智慧分類和格式化輸出是亮點，但供應商和審批人的自動識別可能不準確，需要人工檢查補充。整體適合有大量報備郵件需要整理的使用者。