前言¶

在 DSH（DeepSeek Harness）中擴展教育/考試能力時，常見需求不是先做一套網頁界面，而是讓 agent 能直接查詢考試日期並計算剩餘天數。dsh-exam-countdown 針對這個問題：內置 64 場中國主要考試數據，並用純日期計算支持按年滾動查詢。

這是什麼¶

zimai233/dsh-exam-countdown 是一個 MIT 許可證的 DSH 插件，定位爲教育/考試類插件。

它內置 64 場中國主要考試，覆蓋 9 大分類：升學考試、公務員、英語考試、教師資格、會計金融、法律工程、醫學健康、計算機、其他。

插件採用純 ESM、零構建步驟，發佈的 npm 包本身可作爲運行時代碼。實現上是純服務端數據與日期計算，不依賴 DOM 或 localStorage。

GitHub 地址：

https://github.com/zimai233/dsh-exam-countdown

核心功能¶

數據範圍¶

• 內置 64 場中國主要考試。
• 覆蓋 9 大分類：升學考試、公務員、英語考試、教師資格、會計金融、法律工程、醫學健康、計算機、其他。
• 固定日期考試按全國統一日期收錄。
• 考研、省考、事業單位等時間不固定考試使用歷年典型日期。
• 插件說明所有日期僅供參考，最終以各考試主辦方官方公告爲準。

日期計算¶

• 日期過期後自動順延到下一年。
• 查詢時僅返回 days >= 0 的未過期場次。
• 支持精確規則日期計算，例如 CET-4/6 按每年 6 月/12 月第二個週六、JLPT 按每年 7 月/12 月第一個週日計算。

查詢接口¶

插件提供兩個工具：

• exam_countdown：倒數查詢工具。支持可選參數 id、query、category、limit，其中 limit 默認值爲 10。可按 id 精確查找、按名稱/關鍵詞模糊搜索、按 category 分類篩選，結果按剩餘天數升序排序。
• exam_categories：分類清單工具。無參數，返回格式爲 [{ category, count }]，按考試數量降序排序，可用於發現 category 參數的合法取值。

安裝與檢查¶

1、按資料給出的安裝命令，將插件加入指定 profile：

dsh plugin --profile myprofile add dsh-exam-countdown

資料未說明 --profile myprofile 是否爲必填參數。命令中的 myprofile 是資料給出的 profile 示例值。

2、檢查 package.json 中聲明的依賴與 DSH 打包配置：

{
  "dependencies": {
    "@deepseek-ai/dsh-tools": "^0.0.1-rc.1"
  },
  "peerDependencies": {
    "@deepseek-ai/cordis": "^4.0.0"
  },
  "dsh": {
    "bundle": {
      "patch": "./cordis.patch.yml"
    }
  }
}

這些聲明會影響安裝與運行時的配套依賴。安裝前可以結合源碼覈對依賴範圍和補丁文件。

典型用法¶

1、查單個考試。

用戶問：

高考還有多少天？

agent 調用 exam_countdown，參數示例爲：

{
  "id": "gaokao"
}

這個參數用於按 id 精確查找考試場次。

2、查某一類考試。

用戶問：

幫我看看最近要考的英語類考試，列出 5 個

agent 調用 exam_countdown，參數示例爲：

{
  "query": "英語",
  "limit": 5
}

這裏通過名稱/關鍵詞進行模糊搜索，並用 limit 控制返回數量。

3、查看可用分類。

用戶問：

有哪些考試分類？

agent 調用 exam_categories。該工具無參數，返回各分類及考試數量，按考試數量降序排序，便於後續把分類名傳給 category。

適用場景與注意¶

適合需要讓 DSH agent 直接查詢中國考試倒數的場景，例如升學考試、公務員、英語考試、教師資格、會計金融、法律工程、醫學健康、計算機等分類下的日程問答。

使用時需要注意：

• 日期數據僅供參考，最終以各考試主辦方官方公告爲準。
• 考研、省考、事業單位等時間不固定考試使用歷年典型日期，不等同於當期官方日期。
• 插件以當前 dsh 進程權限運行。安裝前應檢查 GitHub 源碼和 MIT 許可證，確認其數據與日期計算邏輯符合預期。

結尾¶

dsh-exam-countdown 把中國考試日程和倒數計算封裝爲 DSH 可調用的服務端工具：用 exam_countdown 查詢考試場次，用 exam_categories 查詢分類清單。

GitHub：

https://github.com/zimai233/dsh-exam-countdown