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.
Install
# from a prebuilt release tarball
dsh plugin --profile web add "https://github.com/Vertingod/dsh-campus-calendar/releases/download/v0.3.1/dsh-campus-calendar-0.3.1.tgz"
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:Vertingod/dsh-campus-calendar
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
This plugin publishes its README in Chinese only.
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。
Links
More in this category
Tencent/WeKnora#dsh-weknora★ 37546
Four read-only tools over a WeKnora knowledge base: list knowledge bases, hybrid passage search, reassemble one document's chunks in order, and WeKnora's own cited RAG or ReAct-agent answer with a resumable session id.
DayuanJiang/next-ai-draw-io#dsh-plugin★ 36997
Draws draw.io diagrams in DeepSeek Harness through the next-ai-drawio MCP server: the link in the reply opens a live preview in the right sidebar, you can edit the diagram by hand, and each AI change is a version you can restore. Node.js 18+; npx downloads the MCP server on first use.
superdesigndev/treg★ 8164
Tool catalog for agents: search ~2,600 external endpoints (SEO and SERP, backlinks, social, people and company enrichment, ad libraries, scraping) by the task you want done, read each one's parameters and per-call price, then call it with the credential injected server-side. Ships the skill plus an MCP row that stays disabled until TREG_TOKEN is set.
T-Auto/dsh-ops★ 5864
Provides bash, PowerShell 7, and high-performance Rust tools for DSH on Windows to reduce token usage.
sixtysevenlf/dsh-blender-plugin★ 2147
Lets a DSH agent drive a local Blender over a direct TCP channel with 15 tools: viewport frames, custom-angle renders, Python execution, headless and job offload, transaction rollback, and a planning layer of 228 ops across 34 families.
helloHub1212/dsh-windows-mcp★ 1456
Bridges the CursorTouch/Windows-MCP desktop automation server into DSH through the official MCP client bridge, registering its screenshot, UI tree snapshot, mouse and keyboard input, clipboard, process and registry tools as mcp__windows__* tools for the model, and adds a windows_mcp_doctor diagnostic tool. Computer Use is off by default and is switched on from the plugin panel.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.