前言¶
資金崗、共享中心或實施同事經常遇到同一類事：銀行給的流水是 MT940、各家銀行自己的 Excel，或是 PDF，而目標系統只認固定列名的導入模板。手工複製粘貼容易錯列、漏借貸方向，批量多賬戶時更耗時間。下面介紹 SkillHub 上的社區技能「銀行對賬單處理和轉換」（座標 @user_ac4bcccb/imp-trm-accstmt），由 Agent 按技能說明解析對賬單、做字段映射，並生成 BIPV5、金蝶雲星瀚、保融 ATS、九恆星司庫、用友 NCC 等系統可直接使用的 Excel/xls 文件。
這是什麼¶
這是一份基於通用 SKILL.md 格式的 Agent Skill，發佈在 SkillHub（分類 office-efficiency，來源 community，發佈者 user_ac4bcccb）。頁面當前版本爲 v1.0.3，標籤標明 requires_api_key=false，無需額外 API Key。
定位可以概括爲：解析 MT940 / Excel / PDF 銀行對賬單 → 智能字段映射 → 輸出各目標系統的標準導入模板。官方說明中強調：當用戶需要將上述格式對賬單轉爲 BIPV5、EAS_YXH、FINGARD、NSTC、YYNCC 等模板時，應使用本技能。
官方頁面：
- SkillHub：https://www.skillhub.cn/skills/user_ac4bcccb/imp-trm-accstmt
- API 入口：https://api.skillhub.cn/user_ac4bcccb/imp-trm-accstmt
核心功能¶
輸入格式¶
- MT940：SWIFT 標準銀行對賬單，含 TXT、STA 等常見載體。
- 國內銀行 Excel：資料中列舉的包括招商、中信、興業、浦發、民生、徽商、廣西北部灣、渤海、國開、中原等。
- 國內銀行 PDF：文本型 PDF；圖片型 PDF 可選 OCR。資料中舉例農商行、平安、恆豐、浙商、鄭州等。
目標系統與模板文件¶
默認目標爲 BIPV5。其餘系統通過 target_system 區分，對應 assets/template/ 下的官方模板：
| 系統代碼 | 說明 | 模板文件名 |
|---|---|---|
| BIPV5（默認） | 銀行流水處理 Excel | YYBIPV5_banktransaction.xlsx |
| EAS_YXH | 金蝶雲星瀚離線明細 | eas_yxh_banktransaction.xlsx |
| FINGARD | 保融 ATS 離線信息 | fingard_banktransaction.xls |
| NSTC | 九恆星司庫批量導入銀行明細 | nstc_banktransaction.xls |
| YYNCC | 用友 NCC 數據頁籤 | yyncc_banktransaction.xls |
輸出會盡量貼合各系統要求：例如 EAS_YXH 保留單元格批註與下拉項；FINGARD、NSTC、YYNCC 保留說明 sheet 與對照表。
解析與映射能力（資料已寫明部分）¶
- 餘弦相似度匹配列名，緩解各銀行表頭不一致問題。
- 對方賬號、對方名稱支持多種別名（如對手賬號、收款賬號等）。
- 借貸標識分離、日期與幣種轉換；可從表頭區域提取本方賬號，並清理「賬號（人民幣）」類幣種後綴。
- PDF：合併折行表頭（如「交易時」+「間」→「交易時間」）；用 PyMuPDF 的 X/Y 座標按列重組表格，不依賴固定列數。
- 可配置 JSON 映射文件擴展新銀行格式或新目標系統，官方說明稱無需改代碼即可適配新格式。
- 支持賬號與明細分離的對賬單結構，以及多文件批量轉換合併爲單個導入文件。
輸出位置：默認與輸入文件同目錄，便於與原始對賬單放在一起管理。
模板加載：統一入口爲 scripts/core/template_manager.py 中的 resolve_template(target_system)。若從 clawhub 等無法攜帶二進制模板的市場安裝且本地缺少模板，會從預配置地址自動下載到 assets/template/。
安裝與啓用¶
SkillHub 提供兩種常見方式：CLI 安裝，或讓當前 Agent 按安裝文檔拉取技能。
1. 檢查 SkillHub CLI¶
先確認本機是否已有 skillhub：
command -v skillhub && skillhub --version
未安裝時，可按 SkillHub 安裝文檔執行完整安裝（含默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅安裝 CLI 時：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 安裝到當前 Agent 的 skills 目錄¶
安裝時必須用 --dir 指向當前客戶端識別的 skills 目錄，否則默認落在 ./skills/ 可能不會被加載。常用路徑如下（摘自 SkillHub 安裝說明）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
在 Cursor 中示例：
skillhub install @user_ac4bcccb/imp-trm-accstmt --dir ~/.cursor/skills/
安裝後按所用客戶端要求重啓或刷新技能列表。
3. 通過對話讓 Agent 安裝¶
SkillHub 技能頁提供的提示詞爲：
請根據 https://skillhub.cn/install/skillhub.md，安裝 @user_ac4bcccb/imp-trm-accstmt。
將上述內容發給支持 Skill 的 Agent，由其按 skillhub.md 完成安裝與目錄配置。
典型用法¶
本技能以 自然語言觸發 + Agent 按 SKILL.md 執行腳本 爲主，官方未在公開頁給出單獨的命令行「一鍵轉換」示例。實踐中可按下面步驟與 Agent 協作。
- 準備文件：將 MT940（
.txt/.sta）、銀行 Excel 或 PDF 放在可訪問路徑，並說明目標系統（不寫則默認爲 BIPV5）。 - 發起任務：用與場景匹配的表述，例如「把這份招商銀行 Excel 對賬單轉成金蝶雲星瀚 EAS_YXH 導入模板」「解析 MT940 生成 BIP 導入文件」「PDF 銀行流水轉用友 NCC」。
- 覈對輸出：在同目錄下檢查生成的
.xlsx或.xls，再導入對應財務/司庫系統。
官方列出的必須觸發關鍵詞包括：銀行對賬單轉換、MT940 解析、PDF 對賬單轉換、境外/SWIFT 對賬單、轉換爲金蝶/保融/九恆星/用友 NCC，以及英文表述如 bank statement import、MT940 to BIP、PDF to BIP 等。提到銀行對賬單、MT940、SWIFT、銀行流水、PDF 對賬單或上述廠商名稱時，Agent 應掛載本技能處理。
多文件場景可明確要求「批量轉換多銀行對賬單併合併爲一個導入文件」。
適用場景與注意¶
適合誰
- 需要把多來源銀行流水導入 BIPV5、金蝶雲星瀚、保融 ATS、九恆星司庫或用友 NCC 的財務、資金、實施人員。
- 對賬單格式雜、表頭不統一，希望減少手工列映射的同事。
- 已在使用 Cursor、Claude Code、Codex 等支持 Skill 的 Agent 環境。
使用注意
- 社區來源技能，導入生產前請在測試環境校驗金額、借貸方向與筆數。
- PDF 爲掃描件時依賴可選 OCR，識別率受原件質量影響，需人工抽檢。
- 新銀行版式可通過 JSON 映射擴展；若模板目錄缺失，首次運行可能觸發網絡下載模板（clawhub 等市場場景）。
- SkillHub 統計（以抓取資料爲準）：評分 100000，下載 2041 次；頁面數據會更新，以 SkillHub 爲準。
結尾¶
「銀行對賬單處理和轉換」把 MT940、國內 Excel/PDF 對賬單與五套主流導入模板之間的格式鴻溝收攏到一條 Agent 工作流裏：解析、映射、按系統模板落盤，並支持映射擴展與批量合併。若你正在處理銀行流水導入模板類需求，可從 SkillHub 安裝 @user_ac4bcccb/imp-trm-accstmt：
https://www.skillhub.cn/skills/user_ac4bcccb/imp-trm-accstmt
