name: education_certificate_ocr description: 支援識別各類畢業證書，提取姓名、證書編號、專業、院校名稱及畢業時間等。 version: 1.0.0 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 種識別能力，高效提取學歷證書裡核心資訊。

功能特性

• 學歷證書識別：支援識別學歷證書資訊，識別各類畢業證書，提取姓名、證書編號、專業、院校名稱及畢業時間等。

前置配置

⚠️ 重要：使用前需要申請 Scnet API Token

申請 API Token

1. 訪問 Scnet 官網 註冊/登入
2. 在控制台申請 API 金鑰（格式：sc-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx）
3. 複製金鑰備用

配置 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

1. 新增：SCNET_API_KEY=你的金鑰
2. 設定檔案許可權為 600（僅所有者可讀寫） ⚠️ 安全警告：切勿將 API Key 直接貼上到聊天對話中，否則可能被記錄或洩露。

Token 更新

Token 過期後呼叫會返回 401 或 403 錯誤。更新方法：重新申請 Token 並替換 config/.env 中的 SCNET_API_KEY。

依賴安裝

本技能需要 Python 3.6+ 和 requests 庫。請執行以下命令：

   pip install requests

使用方法

引數說明

命令列呼叫示例

   python .claude/skills/education_certificate_ocr/scripts/main.py ACADEMIC_CERTIFICATE /path/to/test.jpg

在 AI 對話中使用

使用者可以說：

• “幫我識別這張影像中的學歷證書資訊，圖片在 /Users/name/Downloads/test.jpg”

AI 會根據 description 中的關鍵詞自動觸發本技能。

AI 呼叫建議

為避免觸發 API 速率限制（10 QPS），請序列呼叫本技能，即等待前一個識別完成後再發起下一個請求。 如果使用 OpenClaw 的 exec 工具，建議設定 timeout 或 yieldMs 引數，讓命令同步執行，避免多個命令同時執行導致併發。

配置選項

編輯 config/.env 檔案：

訪問小蔥技能站7w4.net，解鎖更多實用的AI技能外掛。

輸出

• 標準輸出：識別結果的 JSON 資料，結構與 API 文件一致，位於 data 欄位內。
• 識別結果位於 data[0].result[0].elements 中，具體欄位取決於 ocrType。
• 錯誤資訊：如果發生錯誤，會輸出以 錯誤: 開頭的友好提示。

注意事項

• 本技能呼叫的 OCR API 有 10 QPS 的速率限制。
• 如果遇到 429 錯誤，請等待 2-3 秒後重試，不要連續發起請求。
• 建議在呼叫前確保圖片已準備就緒，避免因網路問題導致重複呼叫。

故障排除