Mobile Pay Bill Ocr
📖 技能介紹
name: mobile_pay_bill_ocr description: 僅在使用者明確提及“支付寶賬單”、“微信支付記錄”、“交易截圖”、“支付明細”、“移動支付賬單”等特定詞彙時觸發，用於識別並結構化提取移動支付交易截圖中的時間、商戶、金額、收支型別等資訊。不適用於通用OCR或非支付類票據識別。 version: 1.0.1 author: SCNet license: MIT tags: - OCR - 移動支付 - 微信支付 - 交易賬單 required_env_vars: - SCNET_API_KEY optional_env_vars: - SCNET_API_BASE primary_credential: SCNET_API_KEY dependencies: - python3 - requests input: - ocrType : 識別型別，可選值見下文 - filePath : 待識別圖片的本地路徑 output: 結構化的 JSON 資料，包含識別結果和置信度
Sugon-Scnet 移動支付賬單識別 OCR 技能
本技能封裝了移動支付賬單識別的 OCR 服務，通過單一介面即可呼叫 1 種識別能力，高效提取智慧解析支付寶和微信支付賬單，結構化提取交易時間、商戶、金額及收支型別。
🚨 重要隱私與安全警告（使用前必讀）
1. 資料外傳性質
本技能會將您提供的移動支付賬單截圖/圖片，通過網路傳輸至第三方服務商（api.scnet.cn） 進行 OCR 處理。圖片資料會離開您的本地裝置，並非在本地離線處理。2. 資料的極高敏感性
移動支付賬單（微信/支付寶）包含以下極度敏感的個人資訊： - 個人身份：真實姓名、使用者ID、手機號（部分賬單）。 - 財務行為軌跡：每筆交易金額、時間、支付方式（銀行卡/零錢/信用卡）。 - 社交關係與消費圖譜：交易對方的暱稱、真實姓名或商戶名稱，以及消費地點（如有），可完整勾勒出您的消費習慣、收入水平、社交圈層。3. 資料用途與保留 - 用途：上傳的資料僅用於本次文本識別請求，服務商不會用於其他目的。 - 保留期限：請查閱服務商（
scnet.cn）官方隱私政策。強烈建議您在獲取識別結果後，立即手動刪除本地和雲端（如有）的圖片副本，以最大程度降低資料暴露風險。4. 法律合規與授權
若賬單中包含他人資訊（如轉賬物件的姓名），您必須確保已獲得該資訊主體的明確授權，方可上傳處理。未經授權處理他人個人資訊可能違反《個人資訊保護法》等相關法律法規。5. 使用者知情同意
使用本技能即表示您已閱讀、理解並同意上述資料處理方式，並願意承擔因未授權處理、資料洩露或不當使用所引發的一切法律責任。
功能特性
- 移動支付賬單識別：支援識別移動支付賬單資訊，高效提取智慧解析支付寶和微信支付賬單，結構化提取交易時間、商戶、金額及收支型別。
前置配置
⚠️ 重要：使用前需要申請 Scnet API Token
申請 API Token
- 訪問 Scnet 官網 註冊/登入
- 在控制台申請 API 金鑰（格式：
sc-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx） - 複製金鑰備用
配置 Token
手動配置（推薦）
1. 在技能目錄下建立 config/.env 檔案，內容如下：
# ===== Sugon-Scnet OCR API 配置 =====
# 申請地址：https://www.scnet.cn
SCNET_API_KEY=your_scnet_api_key_here
# API 基礎地址（一般無需修改）
SCNET_API_BASE=https://api.scnet.cn/api/llm/v1
- 新增：
SCNET_API_KEY=你的金鑰 - 設定檔案許可權為 600（僅所有者可讀寫） ⚠️ 安全警告：切勿將 API Key 直接貼上到聊天對話中，否則可能被記錄或洩露。
Token 更新
Token 過期後呼叫會返回 401 或 403 錯誤。更新方法：重新申請 Token 並替換 config/.env 中的 SCNET_API_KEY。
依賴安裝
本技能需要 Python 3.6+ 和 requests 庫。請執行以下命令：
pip install requests
使用方法
引數說明
| 引數名 | 型別 | 必填 | 描述 |
|---|---|---|---|
| ocrType | string | 是 | 識別型別列舉。必須為以下之一： • MOBILE_PAYMENT_BILL（移動支付賬單） |
| filePath | string | 是 | 待識別圖片的本地絕對路徑。支援 jpg、png、pdf 等常見格式。 |
命令列呼叫示例
python .claude/skills/mobile_pay_bill_ocr/scripts/main.py MOBILE_PAYMENT_BILL /path/to/test.jpg
在 AI 對話中使用
7w4.net小蔥技能站，你的AI助手技能庫。
使用者可以說：
- “幫我識別這張影像中的移動支付賬單資訊，圖片在 /Users/name/Downloads/test.jpg”
AI 會根據 description 中的關鍵詞自動觸發本技能。
AI 呼叫建議
為避免觸發 API 速率限制（10 QPS），請序列呼叫本技能，即等待前一個識別完成後再發起下一個請求。 如果使用 OpenClaw 的 exec 工具，建議設定 timeout 或 yieldMs 引數，讓命令同步執行，避免多個命令同時執行導致併發。
配置選項
編輯 config/.env 檔案：
| 變數名 | 預設值 | 說明 |
|---|---|---|
| SCNET_API_KEY | 必需 | Scnet API 金鑰 |
| SCNET_API_BASE | https://api.scnet.cn/api/llm/v1 | API 基礎地址（一般無需修改） |
輸出
- 標準輸出：識別結果的 JSON 資料，結構與 API 文件一致，位於
data欄位內。 - 識別結果位於 data[0].result[0].elements 中，具體欄位取決於 ocrType。
- 錯誤資訊：如果發生錯誤，會輸出以
錯誤:開頭的友好提示。
注意事項
- 本技能呼叫的 OCR API 有 10 QPS 的速率限制。
- 如果遇到 429 錯誤，請等待 2-3 秒後重試，不要連續發起請求。
- 建議在呼叫前確保圖片已準備就緒，避免因網路問題導致重複呼叫。
故障排除
| 問題 | 解決方案 |
|---|---|
| 配置檔案不存在 | 建立 config/.env 並填入 Token（參考前置配置） |
| API Key 無效/過期 | 重新申請 Token 並更新 .env 檔案 |
| 檔案不存在 | 檢查提供的檔案路徑是否正確 |
| 網路連線失敗 | 檢查網路連線或防火牆設定 |
| 不支援的檔案型別 | 確保副檔名為允許的型別（參考 API 文件） |
| 401/403/Unauthorized | Token 無效或過期，重新申請並配置 |
| 429 Too Many Requests | 請求過於頻繁，技能會自動等待並重試（最多 3 次）。若持續失敗，請降低呼叫頻率或聯絡服務方提高限額。 |
🤖 AI 評測
這個Skill專門用於識別手機支付賬單截圖（如微信、支付寶），功能單一但實用。做得好的地方：文件清晰、有安全提示、錯誤處理友好、使用門檻不高。不足之處：README基本是空模板、新手不知道如何測試（缺示例圖片）、配置檔案需要手動建立。對於有API Key且需要批次識別支付賬單的使用者來說，這個工具比較實用；但普通使用者初次上手可能會感到迷茫。整體質量中上，核心功能紮實，配套文件還需完善。
