weibaohui/dsh-gaokao 预览 preview

weibaohui/dsh-gaokao

dsh 插件 · 梦回高三:桌面小黑板高考倒计时(双击收成竖条),AI 干活时随机抽背知识点卡;Markdown 开放知识卡框架——按 学科/分类 放 md 即自动加载,支持关联跳转/收藏/重点学科/导入自己的知识库。

Project Overview项目介绍

dsh-gaokao is a native plugin built specifically for the DeepSeek Harness (DSH) Web client, marketed under the "dreaming back to senior year" (梦回高三) theme. Its centerpiece is a draggable little blackboard widget that floats at the lower right corner of the DSH web UI and counts down the days until the next gaokao (June 7, automatically rolling forward after June 10). Installation is a single command, dsh plugin --profile web add @weibaohui/dsh-gaokao -w, followed by a restart of dsh web; the package ships with 1,109 built-in Markdown knowledge cards across nine high-school subjects (math 396, physics 402, chemistry 289, plus Chinese, English, history, geography and politics) so no extra configuration is required before first use. The compatibility table in the README pins 0.4.2 to @deepseek-ai/dsh@0.1.7-rc.2, and releases are pushed via npm Trusted Publishing with OIDC.

The plugin listens to DSH session events and pops a card at well-timed moments: end-of-round triggers a "recap" prompt, tool errors open a "stuck? flip the textbook" card, round aborts trigger a "ten-minute break" prompt, and a fellow agent's question has a 25% chance of triggering a "teacher's quiz time" card. It ships a three-piece anti-harassment set: a 90-second global throttle between auto-pops, a 16-second auto-collapse on idle, and a 🔔 toggle that immediately disables the integration, achieving zero polling when the toggle is off or the page is hidden. It is clearly aimed at gaokao candidates and self-learners who want bite-sized revision; users open the Web UI, drag or double-click the blackboard, then use the gear (⚙) panel to switch to vertical-bar mode, scale between 30% and 150%, pick one of seven eye-protection paper colors and four grid styles, select focus subjects, edit the exam date, or import local knowledge-card folders.

Dependencies are minimal: it needs @deepseek-ai/dsh@0.1.7-rc.2 or newer in its web profile, and the config block accepts either dataDir (replaces the seed library) or extraDirs (appended on top). Folders are scanned recursively following the convention 学科/分类/卡.md; README.md, dotfiles, and underscore-prefixed directories are skipped, and every frontmatter field is optional with id defaulting to the relative path. After editing files on disk, calling GET /dsh-gaokao/api/reload hot-refreshes the index without restarting, and the same prefix exposes /draw, /bundle?n=30, /card?id=, /feed?after=N, and /status (which also returns the countdown). Knowledge-card content is original phrasing of generic curriculum facts and formulas, knowledge pools are batch-fetched once every five minutes (30 cards at a time) so the random draw rarely hits the network, and there is a built-in shuffle-without-repeat mode that only reshuffles when the deck drops to two cards.

dsh-gaokao 是面向 DeepSeek Harness(DSH)Web 端的一款原生插件,以"梦回高三"小黑板为核心视觉元素,右下角浮出一块可拖拽的小黑板,显示距高考天数并支持双击切换为教室黑板右侧竖条形态。安装通过 dsh plugin --profile web add @weibaohui/dsh-gaokao -w 一行命令完成,装完重启 dsh web 即生效;插件打包自带 1109 张覆盖九大学科(数学 396、物理 402、化学 289 及语文英语史地政)的 Markdown 知识卡,无需任何额外配置即可使用。版本兼容矩阵显示 0.4.2 已在 @deepseek-ai/dsh@0.1.7-rc.2 下验证运行,并通过 npm Trusted Publishing 自动发版。

插件在会话回合结束、工具报错、回合中止或道友提问等事件触发时自动抽背知识点,配有 90 秒节流、16 秒自动收起与 🔔 一键关闭三件套防打扰,关闭或页面不可见时零轮询。它面向备战高考的高三学生与希望随时复习巩固的自学者,提供双形态黑板、护眼底色与格线样式、30%–150% 缩放、🎲/⏮/⏭ 随机前后浏览、洗牌式不重复抽卡、❤ 收藏与 [[wikilink]] 关联跳转。工作流是打开 Web UI → 拖动或双击黑板 → ⚙ 中切换竖条、调整缩放、挑选底色格线、勾选重点学科、改高考日期或导入本地知识卡文件夹。

依赖与限制方面,插件要求 @deepseek-ai/dsh@0.1.7-rc.2 或更高 Web 版,配置文件支持 dataDir 整体替换种子库或 extraDirs 外挂追加任意多目录,扫描 学科/分类/卡.md 结构,跳过 README 与点/下划线开头的文件。知识卡 frontmatter 全部可选,id 默认是相对路径,改文件后调用 GET /dsh-gaokao/api/reload 可热刷新;HTTP API 还包括 /draw、/bundle?n=30、/card?id=、/feed?after=N、/status。首发内置 1109 张均为原创通用高中知识点表述,含高考倒计时(自动指向下一届 6 月 7 日,考完 10 日滚到下一届),可自定义日期与重点学科范围。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 3 warnings3 项注意
  • No license declared - all rights reserved by default; ask the author before commercial use or redistribution未声明开源许可证 —— 默认「保留所有权利」,商用或再分发前先问作者
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
  • Desktop client: installation downloads an executable - verify the publisher and checksums桌面客户端:安装会下载可执行文件,请核对发布者与校验和
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add @weibaohui/dsh-gaokao -w

把 weibaohui/dsh-gaokao 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

@weibaohui/dsh-gaokao

⚠️ 知识产权说明:知识卡内容为通用高中课程知识点(事实/公式/定义/性质)的原创表述,不含来源出处、教材原文或例题。任何人可贡献自己的知识卡,导入时请确保内容为原创或公共领域。

DSH plugin npm version

梦回高三:右下角浮着一块可拖拽的小黑板,粉笔字写着"距离高考还有 N 天"(双击可收成教室黑板右缘那行竖字)——AI 干活的间隙它自己一震,为你翻开一张练习本知识卡,抽背一个知识点。

黑板倒计时 · 双形态 · 护眼底色 · 抽背知识点

事件联动

知识卡通过会话事件流感知你在做什么,在恰好的时机递上一张:

会话事件 弹卡缘起
回合结束 【讲完这题,抽背一个知识点——】
工具报错 【卡壳了?翻翻课本压压惊——】
回合中止 【课间十分钟,来一题——】
道友提问 (25% 概率)【老师提问时间到——】

防打扰三件套:90 秒内最多自动弹出一次、16 秒无操作自动收起、页脚 🔔 随时可关。联动关闭或页面不可见时零轮询,开启时也只 30 秒一轮轻量事件流。

核心功能

  • 双形态小黑板:默认是完整黑板(距高考天数,≤100 天数字变红);双击黑板或在 ⚙ 里切换成竖条收起——像真正高三教室黑板最右侧那行竖字,只写天数数字,几乎不占地方;形态记忆
  • 倒计时日历:自动指向下一届 6 月 7 日(考完 6 月 10 日滚到下一届),⚙ 里可自定义日期;按住黑板可拖到任意位置

竖条收起形态

  • 缩放自由:⚙ 里 30%–150% 滑杆等比缩放(默认 60%),持久化
  • 练习本纸张:卡头只有标题;正文底色可选 7 种流行护眼色(豆沙绿/青草绿/杏仁黄/秋叶褐/胭脂红/海天蓝/银河白),格线 4 种样式(横线/方格/点阵/空白),组合出你的专属练习本
  • 知识卡:点黑板翻开练习本,Markdown 渲染(标题/列表/代码/引用/粗体),卡头学科章 + 年级 + 倒计时徽章;右下角拖拽调大小(自动记住)
  • 🎲 随机 / ⏮ 上一个 / ⏭ 下一个:沿浏览历史前进后退,到顶自动再抽新卡;整副洗牌式抽卡——一副牌内绝不重复,抽到只剩 2 张才重洗,小知识库也能每轮见遍所有卡
  • ❤ 收藏:重点卡片收藏,⭐ 收藏夹回看;localStorage 持久化
  • 关联跳转:卡片底部"关联知识点" chips 与正文 [[wikilink]] 都可点击翻卡,知识库里还没有的卡灰显提示
  • 重点学科:⚙ 勾选想主攻的学科,随机只出选中的;学科章低饱和素色,端庄不花哨
  • 导入知识卡:⚙ 里"选择文件夹"批量导入本机 md 知识卡(按 学科/分类 结构归档,同名跳过),立即生效
  • 开放知识卡框架:插件只提供运行骨架,内容全是普通 Markdown 文件——按文件夹放好、符合格式就自动加载,任何人可贡献或导入自己的知识库
  • 低频批量拉取:每 5 分钟一次批量取 30 张存本地池,抽卡基本不产生请求压力

安装

dsh plugin --profile web add @weibaohui/dsh-gaokao -w

装完重启 dsh web 即生效。内置 1109 张知识卡(9 学科:数学 396、物理 402、化学 289,语数英物化生历地政齐全),无需任何配置。

使用

  1. 打开 Web UI → 右下角找到 小黑板,点它翻开知识卡(首次自动抽一张);拖住黑板可挪位置
  2. 双击黑板收成竖条(只写天数数字),再双击展开;⚙ 里也能切
  3. 🎲 随机:从当前学科范围再抽一张;⏮/⏭ 在看过的卡之间前进后退
  4. ❤ 收藏:重点知识点收藏;⭐ 打开收藏夹回看
  5. ⚙ 挑纸张底色与格线、正文字号、缩放黑板、导入本地知识卡文件夹、勾选重点学科、改高考日期;🔔 开关事件联动;💬 提建议(直达 GitHub Issues)

知识卡格式(贡献指南)

一条知识点 = 一个 .md 文件,目录层级即学科 / 分类:

data/
  物理/力学/牛顿第一定律.md
  物理/精要/摩擦力.md      # 手写精炼卡放"精要"分类
  数学/必修/函数的零点.md
  化学/溶液/溶解度.md
---
title: 牛顿第一定律        # 可选,缺省取正文第一个 # 一级标题
subject: 物理              # 可选,缺省取第一级文件夹名
grade: 力学                # 可选,缺省取第二级文件夹名(即分类)
tags: [力学, 运动学]       # 可选
related: [牛顿第二定律]     # 可选,写卡片标题或 id 均可
---

# 牛顿第一定律

**内容**:一切物体总保持匀速直线运动状态或静止状态……

关联知识点用 [[牛顿第二定律]] 写在正文里也行,会自动变成可点击链接。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-wsl-env 下一个 Next donsetch-dsh →