前言¶
DeepSeek Harness（dsh）是 DeepSeek AI 开源的智能体框架，官方仓库把它的架构概括成一句话：一切皆插件。模型、工具、沙箱、会话存储、界面，都可以用插件替换或叠加。社区里已经有不少界面增强、媒体下载、浏览器自动化一类的扩展，但教育、考试相关的日程数据仍然很少。
维护者 zimai233 在仓库 README 和社区目录页里写过同一段判断：现成插件多集中在工具链、媒体与设计，几乎没有人提供中国考试的日程与倒数计算。dsh-exam-countdown 做的就是这件事——把高考、考研、国考、四六级、CPA、法考等常见场次做成 agent 可调用的工具，对话里直接问「高考还有多少天」。
需要先分清两件事。DeepSeek Harness 本身是官方开源项目；DeepSeek Harness 插件库 是独立的社区目录，和 DeepSeek / 幻方没有官方从属关系。下面按目录详情页、GitHub 仓库源码和官方 dsh CLI 说明整理：这个插件是什么、装什么命令、怎么查、有哪些边界。
这是什么¶
dsh-exam-countdown 是 zimai233 维护的社区插件，目录分类为「趣味」，许可证 MIT，主要语言 JavaScript。仓库 package.json 里的版本是 0.1.0，GitHub 主题标了 deepseek-harness 和 dsh-plugin。截至 2026-08-18，目录页与 GitHub 仓库都显示 2 颗星。
它解决的不是再做一个考试日历网页，而是把倒数计算接到智能体工具层。README 写明：这是作者网页应用「考程」china-exam-countdown 的移植——64 场考试的数据集和纯日期数学，暴露成两个 agent 可调用的工具。没有 UI、不操作 DOM、不读写 localStorage，运行时代码就是发布出去的 ESM 源文件。
目录页的一句话定位是：DeepSeek Harness 的中国考试倒计时插件，内置 64 场考试可查询。源码 src/index.js 里的 EXAMS 数组确实是 64 条，和 README、目录简介一致。
核心功能¶
64 场考试、9 个分类¶
内置数据覆盖 README 列出的 9 类：升学考试、公务员、英语考试、教师资格、会计金融、法律工程、医学健康、计算机、其他。高考、中考、考研初试/复试、国考、省考、英语四六级、教资笔试/面试、初级到 CPA、法考客观题/主观题、一建、软考、护士执业、CATTI 等都在这份名单里。
源码里每条记录有稳定 slug（如 gaokao、cpa、cet-6）、中文名、月份，以及固定日或规则日期，另附一句备注。例如高考写的是全国统一 6 月 7–8 日，中考、省考、专升本则注明各省不同。分类名「英语考试」在数据集里也收了 JLPT、TOPIK 和普通话水平测试，按 category 筛选时要注意这一点。
两个工具¶
插件通过 @deepseek-ai/dsh-tools 的 defineTool 注册两个工具：
| 工具 | 作用 |
|---|---|
exam_countdown |
按 id、关键字或分类查询下一场日期和剩余天数 |
exam_categories |
列出各分类及该分类下的考试数量 |
exam_countdown 的参数在 README 和源码描述里一致：
id（可选）：精确 slug，如gaokao、kaoyan、cpa、cet-6；指定后会覆盖query/categoryquery（可选）：对中文名、id、备注做子串匹配（大小写不敏感）category（可选）：分类名，必须和数据集里的中文分类完全一致limit（可选）：返回条数，默认 10
返回 JSON 数组，每项为 { id, name, cat, dateLabel, days, nextOccurrence }，按剩余天数升序。id 找不到时返回带 error 字段的对象，而不是空数组。
exam_categories 无参数，返回 [{ category, count }]，按数量降序。README 建议先调它，再把合法分类名传给 exam_countdown。
日期怎么算¶
倒数不是去网上抓公告，而是本地日期数学：
- 固定日期：按收录的月、日，在当年拼出日期；已经过去就滚到下一年同一天
- 规则日期：
2nd-sat为当月第二个周六（四六级：每年 6 月 / 12 月），1st-sun为当月第一个周日（JLPT：每年 7 月 / 12 月） - 列表查询只保留
days >= 0的场次
仓库自带测试覆盖了这些规则。例如 2026 年 6 月的第二个周六是 6 月 13 日；以 2026-07-01 为「今天」时，高考会滚到 2027-06-07，6 月四六级会滚到 2027 年 6 月的第二个周六（6 月 12 日）。
插件本身不做报名、准考证或成绩查询，也不保证日期与当年官方公告一致。这一点 README 写得很明确。
安装与启用¶
社区目录详情页给出的安装命令是：
dsh plugin add github:zimai233/dsh-exam-countdown
官方 dsh CLI 的插件管理会把参数转给当前 profile 目录里的 pnpm，习惯写法是带上 --profile。装到默认 Web 配置可以写成：
dsh plugin --profile web add github:zimai233/dsh-exam-countdown
仓库 README 另外给了一条按 npm 包名安装的示例：
dsh plugin --profile myprofile add dsh-exam-countdown
package.json 的包名确实是 dsh-exam-countdown，并声明了 dsh.bundle.patch 指向 ./cordis.patch.yml。目录页与 GitHub 安装入口都以 github:zimai233/dsh-exam-countdown 为准；npm 包名那条以 README 原文为准，安装前仍建议核对该包是否已发布、内容是否与仓库一致。
目录页还提示：如需可复现安装，请固定 commit 哈希。当前 master 最新提交为 54492515553fcf38a48f372e381bbf3252abcc38（2026-08-14，说明为 initial plugin）：
dsh plugin --profile web add github:zimai233/dsh-exam-countdown#54492515553fcf38a48f372e381bbf3252abcc38
这个仓库没有 prepare / 构建脚本，入口就是 src/index.js。官方文档里「Git 安装要放行 pnpm allowBuilds」主要针对带构建步骤的源码包；本插件是纯 ESM，一般不依赖那一步，若本机 pnpm 仍报错，按 CLI 打印的 allowBuilds 提示处理即可。
装好后重启对应 profile。cordis.patch.yml 会插入 id 为 exam-countdown、name 为 dsh-exam-countdown 的一层，并把两个工具挂到当前 agent 上。
典型用法¶
不需要记参数名。README 的用法是直接用自然语言问 agent。
问高考还剩多少天时，agent 会调 exam_countdown：
{
"id": "gaokao"
}
仓库 README 里的示例返回如下（days 和 nextOccurrence 随查询当天变化，不要当成此刻的真实倒数）：
[
{
"id": "gaokao",
"name": "高考",
"cat": "升学考试",
"dateLabel": "6月7日",
"days": 327,
"nextOccurrence": "2027-06-07"
}
]
看最近的英语相关场次，可以让 agent 带上关键字和条数：
{
"query": "英语",
"limit": 5
}
问「有哪些考试分类」时，agent 调用 exam_categories，再用返回的分类名做 category 筛选，例如 "category": "公务员"。
按 id 精确查时，常用 slug 包括：gaokao（高考）、kaoyan（考研初试）、guokao（国考笔试）、cet-6 / cet-12（四六级）、cpa（注册会计师）、fakao-k / fakao-z（法考客观题 / 主观题）、rk-5 / rk-11（软考）。完整 64 个 id 以仓库 README 为准。
适用场景与注意事项¶
适合把考试日程接到对话里的用法：备考时问下一场还剩几天、按分类列出最近场次、给 agent 一个可查询的内置日历，而不是每次让模型去网上猜日期。它不替代教育部、人社部或各行业协会的官方公告，也不处理报名入口、准考证和成绩。
日期边界要单独看。README 写明：全国统一日期的考试按固定日收录；考研、省考、事业单位等时间不固定的，用的是历年典型日期。四六级和 JLPT 由程序按「第几个周几」算，比写死某年某日更稳，但主办方若改规则，插件不会自动更新。源码备注里还有「各省不同」「以当年公告为准」「各地每月安排」这类提示。所有日期仅供参考。
DeepSeek Harness 目前仍是开发者预览，官方 README 标明会有破坏兼容性的变更。社区目录也写了安全提示：插件以当前 dsh 进程的权限运行，安装时可能执行代码。 安装前应检查源代码仓库和许可证；需要可复现环境时固定 commit。本插件依赖 @deepseek-ai/dsh-tools，peer 依赖 @deepseek-ai/cordis，权限模型和其它 DSH 插件相同。
小结¶
dsh-exam-countdown 把 64 场中国考试的倒数做成两个服务端工具，让 DeepSeek Harness 里的 agent 能按 id、关键字或分类回答「还有多少天」。没有网页日历，也没有报名流程，核心就是一份内置数据集加纯日期计算。日期会滚动到下一场未过期的发生日，四六级和 JLPT 按周次规则计算；最终仍以各考试主办方公告为准。
目录页：https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-exam-countdown/
GitHub：https://github.com/zimai233/dsh-exam-countdown
