zimai233/dsh-exam-countdown

dsh-exam-countdown

为 DeepSeek Harness 提供的中国考试倒数日插件。

内置 64 场中国主要考试（高考、考研、国考、四六级、教资、CPA、法考、一建、软考、护士执业……），
把纯日期计算封装成两个 agent 可调用的工具。日期一旦过去，自动顺延到下一年（循环滚动）；
四六级等按「每年 6 月/12 月第二个周六」、JLPT 按「每年 7 月/12 月第一个周日」精确计算。

纯 ESM，零构建步骤 —— 发布的 npm 包本身就是运行时代码。

为什么需要它

DSH 生态里 教育 / 考试类目非常单薄：现成的插件多集中在工具链、媒体与设计领域，
没有任何一个提供中国考试的日程数据与倒数计算。这个插件补上了这块空白：
把「考程」网页应用（china-exam-countdown）的数据与日期数学移植为服务端工具，
agent 可以直接回答「高考还有多少天」「下一次 CPA 是什么时候」这类问题。

功能特性

- 64 场内置考试，覆盖 9 大分类：升学考试、公务员、英语考试、教师资格、会计金融、法律工程、医学健康、计算机、其他
- 精确规则日期：2nd-sat（第二个周六）与 1st-sun（第一个周日）由纯日期数学计算
- 循环滚动：日期已过自动顺延到下一年同一天，days >= 0 只返回未过期的场次
- 灵活查询：按 id 精确查找、按名称关键字模糊搜索、按分类筛选，结果按临近排序
- 两个工具：exam_countdown（倒数查询）+ exam_categories（分类清单）
- 零构建、零 DOM/localStorage —— 纯服务端数据 + 日期数学

安装

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

使用

直接用自然语言让 agent 查询，例如：

「高考还有多少天？」

agent 会调用 exam_countdown，例如：

{
"id": "gaokao"
}

返回：

[
{
"id": "gaokao",
"name": "高考",
"cat": "升学考试",
"dateLabel": "6月7日",
"days": 327,
"nextOccurrence": "2027-06-07"
}
]

再如：

「帮我看看最近要考的英语类考试，列出 5 个」

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

「有哪些考试分类？」

agent 调用 exam_categories，返回各分类及其考试数量，用来发现 category 参数的合法取值。

工具参考

| 工具 | 参数 | 说明 |
|---|---|---|
| exam_countdown | id (string, 可选) — 精确 slug，如 gaokao、kaoyan、cpa、cet-6；query (string, 可选) — 名称/id/备注子串匹配；category (string, 可选) — 分类名；limit (number, 可选, 默认 10) | 返回 JSON 数组，每项 { id, name, cat, dateLabel, days, nextOccurrence }，按剩余天数升序，仅含未过期场次 |
| exam_categories | 无 | 返回 [{ category, count }]，按考试数量降序 |

可用的 id（64 场）

gaokao zhongkao kaoyan kaoyan-2 chengkao zikao-4 zikao-10 zsb guokao shengkao
wendui xuanxiao shiye cet-6 cet-12 tem4 tem8 pets-3 pets-9 putonghua
jlpt-7 jlpt-12 topik jzb-3 jzb-9 jzm-1 jzm-5 chuji gaoji zhongji
cpa sws jjs zcpg sjs yinhang jijin zq fakao-k fakao-z
yjzs ejzs zjzs xf jzs ytjg jl zx gh yishi-b
yishi-j hushi yaoshi weish sg rk-5 rk-11 ncre-3 ncre-9 catti-6
catti-11 chuban zhuanli daoyou

日期说明

- 固定日期的考试按全国统一日期收录；时间不固定的（如考研、省考、事业单位）使用历年典型日期
- 四六级 = 每年 6 月 / 12 月第二个周六；JLPT = 每年 7 月 / 12 月第一个周日，由程序精确计算
- 所有日期仅供参考，最终以各考试主办方官方公告为准

开发

npm install
npm test          # 纯核心逻辑测试（ruleDate / nextOccurrence / queryExams / 数据集）

License

MIT

dsh-exam-countdown

为 DeepSeek Harness 提供的中国考试倒数日。

将 考程 / china-exam-countdown
应用移植为 DSH 工具插件：64 场考试数据集与纯日期数学，暴露为
agent 可调用的工具。无 UI，无 DOM —— 只有服务端的数据 + 倒数计算。

为什么
DSH 插件生态系统的教育类别很薄弱：大多数插件面向工具、媒体和设计。没有任何插件提供中国考试时间表或倒计时计算。本插件填补了这一空白，使智能体能够直接从对话中回答诸如“距离高考还有多少天？”或“下一次 CPA 考试是什么时候？”之类的问题。

功能特性

- 64 个内置考试，涵盖 9 个类别：升学考试、公务员、英语考试、教师资格、会计金融、法律工程、医学健康、计算机、其他
- 精确的规则日期：2nd-sat（第二个星期六）和 1st-sun（第一个星期日）通过纯日期数学计算得出（CET-4/6、JLPT）
- 滚动循环：一旦某个日期过去，它会滚动到明年的同一日期；只返回即将到来的（days >= 0）结果
- 灵活的查询：精确的 id、针对名称/id/备注的子字符串 query，或 category 过滤，按天数升序排序
- 两个工具：exam_countdown + exam_categories
- 零构建步骤——纯 ESM，发布的包就是运行时代码

安装

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

用法

用自然语言向智能体提问：

“距离高考还有多少天？”

智能体调用 exam_countdown，参数为：

{ "id": "gaokao" }

结果：

[
{
"id": "gaokao",
"name": "高考",
"cat": "升学考试",
"dateLabel": "6月7日",
"days": 327,
"nextOccurrence": "2027-06-07"
}
]

更多示例：

“列出 5 个即将到来的英语考试”

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

“你们有哪些考试类别？”

智能体调用 exam_categories，它会返回每个类别及其考试数量——用它来发现有效的 category 值。

工具参考

| 工具 | 参数 | 描述 |
|---|---|---|
| exam_countdown | id（字符串，可选）——精确的 slug，例如 gaokao、kaoyan、cpa、cet-6；query（字符串，可选）——针对名称/id/备注的子字符串匹配；category（字符串，可选）——类别名称；limit（数字，可选，默认 10） | 返回一个 JSON 数组，包含 { id, name, cat, dateLabel, days, nextOccurrence }，按天数升序排序，仅包含即将到来的考试 |
| exam_categories | — | 返回 [{ category, count }]，按数量降序排序 |

可用的 id（64 个）

gaokao zhongkao kaoyan kaoyan-2 chengkao zikao-4 zikao-10 zsb guokao shengkao
wendui xuanxiao shiye cet-6 cet-12 tem4 tem8 pets-3 pets-9 putonghua
jlpt-7 jlpt-12 topik jzb-3 jzb-9 jzm-1 jzm-5 chuji gaoji zhongji
cpa sws jjs zcpg sjs yinhang jijin zq fakao-k fakao-z
yjzs ejzs zjzs xf jzs ytjg jl zx gh yishi-b
yishi-j hushi yaoshi weish sg rk-5 rk-11 ncre-3 ncre-9 catti-6
catti-11 chuban zhuanli daoyou

日期

- 固定日期的考试使用全国统一日期；灵活的考试（考研、省考、事业单位）使用近年来的典型日期
- CET-4/6 = 6 月/12 月的第二个星期六；JLPT = 7 月/12 月的第一个星期日——精确计算
- 所有日期仅供参考——请务必以官方公告为准

开发

npm install
npm test          # 运行纯核心测试（ruleDate / nextOccurrence / queryExams / dataset）

许可证

MIT