- Startseite
- Plugins
- Tools & Funktionen
- dsh-campus-calendar
dsh-campus-calendar
vertingod/dsh-campus-calendar
Local-first calendar for university competitions and certificate exams: readings are ranked by fit to your declared major, year and region; month, year, timeline and list views; four-level importance can be set per date; ICS export; data stays on this machine.
Installation
dsh plugin --profile web add github:vertingod/dsh-campus-calendarREADME
DSH 大学生赛事与证书日历

提供本地维护的赛事、证书考试与关键日期日历。插件通过 DSH 侧栏「赛事日历」入口打开,桌面默认月历优先,另有全年总览、时间轴与列表三种视图,支持收藏与数据维护。
用着顺手的话,顺手点个 Star 支持一下:https://github.com/Vertingod/dsh-campus-calendar 插件内的「★ 点个 Star」按钮和这条 README 指向同一个仓库地址。
安装与运行
需要 Node.js 20+ 与 DeepSeek Harness 0.2.x。从 dsh 插件市场安装:搜索 dsh-campus-calendar(或作者 Vertingod),点卡片上的「安装」即可,包内已带预构建的 dist/client.js,安装时不需要执行构建脚本。也可以在 dsh 面板「插件 → 发现 → 索引源」里填 https://raw.githubusercontent.com/Vertingod/dsh-campus-calendar/main/market/index.json,直接从本仓库取索引。安装完成后在插件页确认已启用;若 DSH 提示需要重启才能加载新插件,按其提示重启。
如果要改代码,用下面的源码命令:
npm install
npm test
npm run build
npm run preview
npm run build 生成 DSH module-loader client bundle dist/client.js 与 CSS。插件 host API 使用 /campus-calendar 前缀。
改插件前先读 docs/dsh-plugin-development.md:里面固化了 cordis.patch.yml、host/client 半片、defineTool schema(属性级 required 必须提升为数组)、ctx.effect 生命周期与 esbuild 打包的踩坑点。
验证与预览命令(均为本地、离线):
node --test test/*.test.js # 全部 69 项领域、宿主、客户端、CSS 与性能正确性测试
node --test test/performance.test.js # 1,000 条记录、100 次采样并打印 p50/p95(仅作环境观察,不设 CI 时间门槛)
node scripts/preview.mjs # 构建 .preview/ 预览包(使用真实 client bundle)
node scripts/preview-server.mjs # 本地预览:http://127.0.0.1:4178/
test/client.test.js 挂载打包产物,覆盖侧栏、可信度、筛选/搜索、收藏/提醒、编辑器校验、草稿保留、刷新竞态、忙碌与成功反馈、读取失败恢复;test/host.test.js 另外覆盖导入前备份、坏 payload 不动原数据、备份只留最近 10 份;test/layout.test.js 校验桌面两栏、窄屏堆叠、主题 token 与 reduced motion。浏览器实测视口:1280×800 和 390×844,documentElement.scrollWidth 均等于视口宽度。性能基准在 Node.js 本地以 1,000 条记录采样 100 次;实际 p50/p95 记录于本次开发进度文件。
用对话生成一份自己的日历
主路径是生成,不是一条条登记。界面顶部的卡片「让 Agent 生成属于我的日历」有三个按钮,点任意一个都会开一个新对话、把草稿填进输入框(不直接发送,你补完再发):
| 按钮 | 草稿形态 | 适合 |
|---|---|---|
| 开始生成我的日历 | 先问专业 / 年级 / 地区 / 关注方向 / 今年目标,再挑 6-10 项写进日历 | 首次使用、换学期、想重做一份 |
| 按学期排一批 | 给出时间范围 + 已有档案 | 期末、开学前集中铺一批关键节点 |
| 记一个已定的 | /campus-calendar-add + 事项 / 时间 / 链接空档 | 已经确定的一件事,直接记 |
「开始生成」的草稿写明了执行顺序:先问 → 用 campus_calendar_set_profile 存档案 → 再挑事项用 campus_calendar_add_item 逐条写入 → 回报每项的时间精度(到日 / 到月 / 到年 / 待确认)。挑出来的事项会带上 majors / years / regions / interests,日历的「只看适合我」和适配度才有依据。
草稿由 host 端的 GET /campus-calendar/draft?kind=plan\|semester\|add\|ask 生成,带当天日期和查证要求:每一项都先去官网查官方公告再落库,查到具体日子写 exact、只在 note 里写清出处;查不到才降级到 range / month / year,并在 note 说明查过哪些来源。不许用「4 月 1 日」冒充「4 月」。档案里已有的字段会带进草稿,避免重复问。
点按钮时客户端调用宿主 uiWorkspace.startSession(undefined, { prompt, whenDraftExists: 'replace' }) 开新对话;宿主没有这个服务时按钮会给出可读提示,不会静默失败。
自带 skill campus-calendar-add
插件通过 ctx.skills.registerProvider 注册一个随包 skill(skills/campus-calendar-add.md),模型在用户提「生成我的日历 / 赛事日历 / 记到日历」时能命中,也可显式 /campus-calendar-add 调用。它有两条硬规则:日期必须查,不能猜、先写档案再谈「适合我」。流程是先问清学业信息 → campus_calendar_set_profile → 挑 6-10 项 → 逐个联网搜索该赛事的官方公告(组委会官网、省考试院、高校教务处转发的通知优先)→ 逐条 campus_calendar_add_item → 回报。精度(exact / range / month / year)与可信度(official_confirmed / predicted / pending_confirmation / unknown)分开记录;official_confirmed 仍需「具体日期 + http(s) 来源 + 核验日期」齐备,只有真的查不到具体日子才降级。
写入工具
campus_calendar_set_profile:写入学业档案(major/year/province/interests[]/types[])。只写用户亲口说过的字段:没传的保持原值,空值不会清掉已有档案。这是判断「适不适合我」的前提。campus_calendar_add_item:新增单个结构化事项。例如:“把下周校赛报名截止记到日历”。调用方(DSH agent)负责把话语解析为工具参数;插件不接收自由文本、不解析日期表达、不调用模型,也不抓取或访问来源 URL。写入复用本地校验和串行追加逻辑,成功后只保存在本机数据文件中。
日期必须来自查证,不能靠猜。 调用 campus_calendar_add_item 之前应已联网查过该赛事的官方公告:官方写到日就直接写那天(accuracy: "exact")并在 note 写清出处;官方只给窗口就用 range;只有确实查不到具体日子才降级成 month(写该月 1 日作占位)/ year,并配 predicted 且说明「查过哪些来源、哪些是推算」。official_confirmed 仅接受具体日期、HTTP(S) 来源 URL 与最近核验日期三者齐备;URL 只作为记录保存,插件不会替用户访问或核验。工具拒绝多事项数组、无效 payload 和不满足可信度规则的数据;它不会执行删除、覆盖或联网操作。
月历只画确定的日子。 月份精度、以及跨度超过两周的窗口,都不进格子——它们的端点是「不知道哪天」的占位或窗口边界,画进格子会让人误以为那天有事。这类事项走月历上方的「还没落到某一天」横带,只显示月份区间;几乎占满全年的(CISP、CTF、天池这类随时能报的)单独归成「全年滚动」一行。有安排的日子整格上色 + 左侧色条,四档重要程度(一般 / 准备 / 重要 / 截止)可以在详情页里手动改,改完写回数据。导出 ICS 时标题带「(月份待定)」/「(年份待定)」。
数据可信度与隐私
默认示例只标记为“演示数据”,首屏能直接看到界面。没有官方数据 API、自动抓取、自动核验、云端同步或 OS 通知。
站内提醒是插件内的兑现,不是空开关:对点过「设置站内提醒」的事项,只要 7 天内有节点到期,打开插件就会在日历上方列出(侧栏入口带计数),提醒数就是「我设的提醒真的有用」的证据。它仍然不会发系统通知,也不会写进 ICS。
真实事项录入官方确认节点时,必须填写 https:/http: 来源 URL 和最近核验日期;预测日期必须说明依据。待确认与预测日期会显式标注;核验超过 90 天的事项在详情页提示「该重新核对」,超过 180 天的胶囊降级显示。完全没有时间锚点的事项不进入月历格,日历页顶部会提示「还有 N 项没有时间锚点 / 已锚定 P%」并给出补录入口。所有记录存于 $DSH_HOME/campus-events-calendar/state.json,未设置 DSH_HOME 时为 ~/.dsh/campus-events-calendar/state.json。
JSON 导入要求 schema version 1,包含 profile/items;favorites/reminders 可选。导入文件最大 2 MB,结构错误会拒绝且不覆盖原数据。导入前会自动把当前数据备份成 state.backup-import-<时间戳>.json(备份失败就不执行导入),备份只保留最近 10 份。删除事项或备忘后有 8 秒撤销窗口。
发布与推广
本仓库自带一套可复用的发布工具层(tools/release/),任何 dsh 插件把该目录连同 docs/RELEASE.md 拷过去即可复用:
| 命令 | 作用 |
|---|---|
npm run release:check | 发布前自检(dsh.bundle、仓库字段、图标、client 产物、screenshots.json、密钥扫描) |
npm run release:entry | 生成提交给 awesome-dsh-plugin 目录的条目 YAML(market/<owner>__<repo>.yml) |
npm run release:star | 生成插件内 Star 引导入口 src/star-entry.js |
npm run release:pack | npm pack + 安装冒烟,确认随包产物齐全 |
完整六阶段流程(建仓推送 → 配图 → 市场收录 PR → Star 引导 → 发版推广 → 版本迭代)见 docs/RELEASE.md。
Ähnliche Plugins
archify (deepseek-harness)
tt-a1i/archify
WeKnora (dsh-weknora)
tencent/weknora
next-ai-draw-io (dsh-plugin)
dayuanjiang/next-ai-draw-io
weknora
tencent/weknora