@weibaohui/dsh-gaokao
⚠️ 知识产权说明：知识卡内容为通用高中课程知识点（事实/公式/定义/性质）的原创表述，不含来源出处、教材原文或例题。任何人可贡献自己的知识卡，导入时请确保内容为原创或公共领域。
梦回高三：右下角浮着一块可拖拽的小黑板，粉笔字写着"距离高考还有 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，语数英物化生历地政齐全），无需任何配置。
使用
- 打开 Web UI → 右下角找到 小黑板，点它翻开知识卡（首次自动抽一张）；拖住黑板可挪位置
- 双击黑板收成竖条（只写天数数字），再双击展开；⚙ 里也能切
- 🎲 随机：从当前学科范围再抽一张；⏮/⏭ 在看过的卡之间前进后退
- ❤ 收藏：重点知识点收藏；⭐ 打开收藏夹回看
- ⚙ 挑纸张底色与格线、正文字号、缩放黑板、导入本地知识卡文件夹、勾选重点学科、改高考日期；🔔 开关事件联动；💬 提建议（直达 GitHub Issues）
知识卡格式（贡献指南）
一条知识点 = 一个 .md 文件，目录层级即学科 / 分类：
data/
物理/力学/牛顿第一定律.md
物理/精要/摩擦力.md # 手写精炼卡放"精要"分类
数学/必修/函数的零点.md
化学/溶液/溶解度.md
---
title: 牛顿第一定律 # 可选，缺省取正文第一个 # 一级标题
subject: 物理 # 可选，缺省取第一级文件夹名
grade: 力学 # 可选，缺省取第二级文件夹名（即分类）
tags: [力学, 运动学] # 可选
related: [牛顿第二定律] # 可选，写卡片标题或 id 均可
---
# 牛顿第一定律
**内容**：一切物体总保持匀速直线运动状态或静止状态……
关联知识点用 [[牛顿第二定律]] 写在正文里也行，会自动变成可点击链接。
规则只有几条：
- 跳过
README.md、. 开头文件和 _ 开头目录，其余 .md 全部加载
- frontmatter 全部可选；关联（
related 或 [[wikilink]]）按标题或 id 解析，解析不到的灰显
- 卡片 id 默认是相对路径（如
物理/高一/牛顿第一定律），也可用 frontmatter id: 指定
- 改了文件后
curl "http://127.0.0.1:3080/dsh-gaokao/api/reload" 热刷新，不用重启
导入自己的知识库
插件配置支持两种方式——dataDir 整体替换内置种子库，extraDirs 外挂追加（种子库照常在）：
config:
dataDir: /Users/you/my-knowledge-base # 可选：替换内置种子库
extraDirs: # 可选：外挂追加任意多个目录
- /Users/mac/Desktop/课本/知识点 # 例：数理化自学丛书精读产物（880+ 张）
外挂目录同样是 学科/分类/卡.md 结构即可被自动扫描；目录里的大文件（章节总览）也会成为一张"总览卡"。改动文件后调 GET /dsh-gaokao/api/reload 热加载。
开发
npm run build:client # 重建 client/bundle-mc.js
npm run check # 语法检查
npm test # smoke 测试
HTTP API（/dsh-gaokao/api/*）：/draw 随机抽一张、/bundle?n=30 批量抽取、/card?id= 取整张、/feed?after=N 会话事件流、/status（含高考倒计时）、/reload。
发版：npm version patch && git push --follow-tags，再 gh release create vX.Y.Z --generate-notes 触发 npm Trusted Publishing（OIDC 免 token）。
致谢
骨架复用自 dsh-code-poem（代码如诗）。
联系我 :飞书群
link
版本兼容性
本插件与 DeepSeek Harness（@deepseek-ai/dsh）的版本对应关系：
| 插件版本 | 适配 dsh 版本 | 备注 |
|---|
| 0.4.2 | 0.1.7-rc.2 | 当前版本，已在 @deepseek-ai/dsh@0.1.7-rc.2 下验证运行 |
发版约定：每次发布新版本时，请在上表追加一行，记录该插件版本实际验证所用的 @deepseek-ai/dsh 版本。package.json 的 engines.dsh 声明最低支持版本；本表记录实际验证版本，二者配合使用。
