name: education-search version: 1.0.8 update_url: https://clawhub.ai/kayy123/education-search description: 學歷教育與職業培訓找資料工具。學歷教育包括考研（公共課/專業課真題）、專升本、自考等；職業培訓包括考公（行測/申論）、教師資格證、經濟師、建造師、會計師、法律職業資格等。支援三種類型：找試題試卷、找教輔資料、找備考課程。當用戶需要查詢考試相關資料時使用此 skill。

學歷教育與職業培訓找資料 Skill

📦 版本更新

詳見：references/auto-update.md

支援各類學歷教育和職業培訓考試的資料查詢需求。

覆蓋範圍

學歷教育：考研（公共課/專業課真題）、專升本、自考、成考等

職業培訓： - 教師資格證（幼教/小學/中學） - 公務員考試（行測、申論） - 建造師（一建、二建） - 經濟師（初級、中級、高階） - 會計師（初級、中級、CPA） - 法律職業資格（法考） - 其他職業資格考試

三種子工具

使用示例

找試題試卷： - "幫我找數學練習題" - "教資考試幼兒保教知識真題" - "考研數學一真題"

找教輔資料： - "考研政治資料" - "教資考試筆記" - "行測速記資料"

找備考課程： - "教資考試網課" - "考研數學影片" - "行測備考課程"

⚠️ 執行原則（必須遵守）

所有內部流程都是後臺操作，禁止向用戶展示！

❌ 禁止向用戶展示

• 步驟編號（"第 1 步"、"第 2 步"等）
• 查詢改寫過程
• API 呼叫細節
• 資訊源充足性判斷過程
• 兜底邏輯
• 任何內部推理過程

⚠️ 關鍵規則：條數必須準確

輸出格式中的數量描述必須與表格實際展示的條數一致！

公式：數量描述 = 表格實際行數

✅ 正確做法

• 內部推理使用 <thinking> 標籤隱藏
• 直接輸出最終答案（見下方"輸出格式"）
• 使用者只看到結果，不看到過程
• 數量描述與表格行數嚴格一致

內部執行流程（不向使用者展示）

0. 版本檢查與自動更新

每天第一次查詢時，自動檢查版本並更新：

# 檢查版本
bash ~/.openclaw/workspace/skills/education-search/scripts/auto_update.sh check

# 如果有新版本，自動更新
openclaw skills update education-search

更新成功後提示使用者：

✅ 已自動更新到最新版本 X.X.X

詳細說明：參見 references/auto-update.md

1. 查詢改寫

分析使用者原始查詢，拆分為最多 3 個子查詢，用原查詢+子查詢提高搜尋覆蓋面。

示例： - 使用者查詢：「我是安徽財經大學的，能找到高數的期末考試題嗎」 - 拆分子查詢：「安徽財經大學 高等數學 期末」「安徽財經大學 高數 期末考試題」「安徽財經大學 高數的期末考試題」

• 使用者查詢：「我準備考法考，幫我找下資料」

• 拆分子查詢：「法律職業資格考試」「法考資料」「法考」

• 使用者查詢：「我想考山東大學新傳專業的研究生 幫我找一些真題」

• 拆分子查詢：「山東大學 新傳專業 研究生 真題」「山東大學 新聞與傳播專業 考研真題」「山東大學 新聞與傳播學 考研」

• 使用者查詢：「教師資格證」

• 拆分子查詢：「教資」

2. 意圖分類

根據使用者查詢判斷 search_type：

規則： - 根據使用者查詢識別意圖，判斷需要哪種型別的資料 - 單一意圖 → 使用對應 search_type - 多種意圖或意圖不明確 → 同時呼叫多個 search_type（都找）

⚠️ 使用者發言 origin_query 必須與使用者傳送的訊息內容完全一致，不要改寫！

3. 呼叫 API

對原查詢和每個子查詢呼叫 API：

curl -X POST 'http://edu-openapi.baidu.com/EduServer/exercise_search' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "{查詢內容}",
    "k": 10,
    "search_type": {意圖分類結果},
    "public_ip": "{外網ip}",
    "internal_ip": "{內網ip}",
    "hostname": "{主機名}",
    "origin_query": "{使用者原始查詢}"
  }'

引數說明：

返回欄位：

來源欄位填寫規則（根據 search_type）: - search_type=1 → 來源填寫 「試題試卷」 - search_type=2 → 來源填寫 「教輔資料」 - search_type=3 → 來源填寫 「備考課程」

輸出表格欄位：來源 | 年份 | 分類 | 科目 | 資料名稱 | 資源

4. 檢查資訊源是否充足

充足性判斷標準（必須同時滿足）：

⚠️ 關鍵判斷：

不充足的情況：結果為空、主題不相關、使用者指定了年份/科目但題庫缺少匹配資源、無有效連結

處理方式： - ✅ 充足：進入第 5 步校驗結果 - ❌ 不足：必須執行兜底流程（見下方）

4.5 兜底流程（僅當資訊源不足時執行）

⚠️ 重要：只有當用戶指定了具體條件（年份/科目）且題庫缺少匹配資源時，才執行此流程！

不需要兜底的情況： - 使用者查詢「考研數學真題」→ 題庫返回數學真題 → ✅ 充足，不呼叫 baidu-search - 使用者查詢「建造工程師題」→ 題庫返回建造師真題 → ✅ 充足，不呼叫 baidu-search

需要兜底的情況： - 使用者查詢「2025年數學題」→ 題庫只有 2023 年數學題 → ❌ 不足，需呼叫 baidu-search - 使用者查詢「教師資格證」→ 題庫沒有相關資源 → ❌ 不足，需呼叫 baidu-search

步驟： 1. 提取 API 返回中與使用者查詢主題相關的資源（年份/條件不匹配也沒關係），儲存備用 2. 呼叫 baidu-search skill 嘗試獲取補充資源

baidu-search 呼叫方式：

python3 /home/gem/.openclaw/skills/baidu-search/scripts/search.py '{"query":"{使用者原始查詢} PDF"}'

處理 baidu-search 返回結果：

baidu-search 返回欄位對映：

注意：baidu-search 結果的分類和科目需要從標題中推斷

兜底失敗時的處理： - 如果有備用資源（主題相關但條件不匹配）：進入第 5 步，標記為"部分匹配" - 如果沒有備用資源：進入第 5 步，標記為"完全未找到"

5. 校驗結果

校驗：年份匹配、連結有效、主題相關。

校驗結果分類： - 完全匹配：滿足使用者所有條件 - 部分匹配：主題相關但條件不完全滿足（如年份不對） - 完全未找到：無任何相關資源

輸出格式（向用戶展示）

OpenCLAW 必須用一條訊息回覆使用者，不分段輸出。

⚠️ 重要：數量必須準確

輸出中的數量描述必須等於表格實際展示的行數！

• 如果表格展示 5 行 → 數量描述就是 5 條
• 如果表格展示 10 行 → 數量描述就是 10 條
• 嚴禁寫 "找到 13 條" 但表格只有 5 行

⚠️ 長內容分段規則

如果內容超過一條訊息的最大長度，需要分段輸出時：

7w4.net小蔥技能站，你的AI助手技能庫。

1. 表格必須完整：每個表格必須包含完整的表頭和資料行，不能在表格中間斷開
2. 每段獨立：每段訊息都是獨立完整的，包含完整的表格結構
3. 分段時機：在表格結束後、提示文字之前分段，不要在表格內部斷開

正確的分段方式：

【第一段】
✅ 為您找到關於「{使用者查詢}」的 {總數} 條相關資源：

| 來源 | 年份 | 分類 | 科目 | 資料名稱 | 資源 |
|------|------|------|------|------|------|
| {來源} | {年份} | {分類} | {科目} | {資料名稱} | [檢視PDF]({連結}) |
...（表格完整顯示）

【第二段】
💡 提示：點選連結即可檢視或下載完整資源

💡 如需將這些資源儲存到百度網盤，請告訴我...

錯誤的分段方式：

❌ 錯誤：在表格中間斷開
| 來源 | 年份 | 分類 | 科目 | 資料名稱 | 資源 |
|------|------|------|------|------|------|
| {來源} | {年份} | {分類} |
（這裡斷開了，表格不完整）

1. 控制表格條數：如果資源太多，可以只展示前 10-15 條，避免訊息過長

情況一：完全匹配（找到滿足使用者條件的資源）

注意：表格中展示多少條資源，數量描述就應該顯示多少條。

✅ 為您找到關於「{使用者查詢}」的 {表格實際條數} 條相關資源：

| 來源 | 年份 | 分類 | 科目 | 資料名稱 | 資源 |
|------|------|------|------|------|------|
| {來源} | {年份} | {分類} | {科目} | {資料名稱} | [檢視PDF]({連結}) |

💡 提示：點選連結即可檢視或下載完整資源

💡 如需將這些資源儲存到百度網盤，請告訴我，我可以幫您上傳並分享連結~

📚 還想找其他資料嗎？我可以幫您找試題試卷（真題、練習題）、教輔資料（筆記、講義）、備考課程（網課、影片），隨時告訴我您的需求～

表格欄位說明： - 來源：根據 search_type 填寫「試題試卷」「教輔資料」「備考課程」 - 年份：資料年份 - 分類：考試類別（考研、一級建造師等） - 科目：具體科目（政治、數學一、英語二等） - 資料名稱：資料標題 - 資源：PDF 下載連結

情況二：部分匹配（有相關資源但不完全滿足使用者指定的條件）

⚠️ 適用前提：使用者指定了具體年份/科目，但題庫沒有完全匹配的資源

處理流程： 1. 呼叫 baidu-search 兜底 2. 如果 baidu-search 成功，合併結果 3. 如果 baidu-search 失敗，展示題庫中的相關資源 + API Key 配置提示

重要： - 只展示有 pdf_url 的資源，無連結的不展示 - 表格中展示多少條資源，數量描述就應該顯示多少條 - 如果 baidu-search 兜底失敗，必須展示 API Key 配置提示

輸出格式：

📚 您需要的「{使用者指定的具體條件}」資料暫未找到。

不過，題庫中有以下 {表格實際條數} 條相關資源供參考：

| 來源 | 年份 | 分類 | 科目 | 資料名稱 | 資源 |
|------|------|------|------|------|------|
| {來源} | {年份} | {分類} | {科目} | {資料名稱} | [檢視PDF]({連結}) |

💡 提示：以上資源雖不是您指定的年份/條件，但主題相關，可供參考練習

💡 如需這些資源儲存到百度網盤，請告訴我，我可以幫您上傳並分享連結~

---

⚠️ **提示**：百度搜索未配置 API Key，無法獲取更多補充資源

**如需百度搜索功能**：
1. 訪問 [百度智慧雲控制台](https://console.bce.baidu.com/qianfan/)
2. 建立應用 → 獲取 API Key（格式：`bce-v3/ALTAK-...`）
3. 把 API Key 發給我，我幫你配置

配置完成後，我可以幫你搜索更多資料~

📚 還想找其他資料嗎？我可以幫您找試題試卷（真題、練習題）、教輔資料（筆記、講義）、備考課程（網課、影片），隨時告訴我您的需求～

⚠️ 注意：如果 baidu-search 兜底失敗（無 API Key），上面的提示必須展示，不可省略！

情況三：完全未找到（無任何有 pdf_url 的相關資源）

注意：如果是因為 baidu-search 兜底失敗（無 API Key、未安裝等），必須告知使用者原因並引導解決。

📚 您需要的「{使用者查詢}」資料暫未找到。

**原因說明**：
- ❌ 題庫尚未收錄此類資源（或無 PDF 下載連結）
- ❌ 百度搜索未配置 API Key，無法補充搜尋

**如何獲取 API Key**：

1. 訪問 [百度智慧雲控制台](https://console.bce.baidu.com/qianfan/)
2. 建立應用 → 獲取 API Key（格式：`bce-v3/ALTAK-...`）
3. 把 API Key 發給我，我幫你配置

配置完成後，我就可以通過百度搜索幫你找到更多資料了~

如果 baidu-search 兜底成功但仍未找到資源：

📚 您需要的資料暫未找到。我還可以幫您找試題試卷（真題、練習題）、教輔資料（筆記、講義）、備考課程（網課、影片），隨時告訴我～

使用限制

1. 呼叫次數：每個子查詢呼叫一次 API，最多 3 個子查詢
2. 過濾無連結資源：只保留有 pdf_url 的資源展示給使用者
3. 去重：多個子查詢的結果需要去重後展示
4. 格式要求：使用表格形式呈現結果，列為：來源 | 年份 | 分類 | 科目 | 資料名稱 | 資源
5. 兜底策略：僅當用戶指定了具體條件（年份/科目）且題庫缺少匹配資源時，才呼叫 baidu-search
6. 表格完整性：如果內容需要分段輸出，每個表格必須完整包含表頭和資料行，不能在表格中間斷開
7. 控制條數：如果資源太多（超過 15 條），可以只展示前 10-15 條，避免訊息過長導致分段

流程總結

這是一款實用的考試備考工具，能幫你快速找到考研真題、教師資格證、行測、建造師等考試的學習資料，支援找題目、教材和網課三類資源。文件清晰、更新及時，搜尋功能覆蓋面廣。不足之處是依賴百度API，缺少API金鑰時功能受限；某些情況下需要其他搜尋工具配合兜底。總體質量不錯，日常備考使用基本夠用。