Back to search
quiz-bank-page
SkillWorks with Claude CodeGitHub
把课程题库(docx/txt/md/xlsx/PDF/图片)生成为单文件离线刷题网页:整套试卷 + 逐题闯关、选项每题乱序、错题自动加频、可导出答题情况给 AI 安排下一轮。当用户说“把这份题库做成刷题网页 / 自测网页 / 答题系统”“备考刷题”“错题反复练”“导出答题情况”时使用。
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/slowburn1701--quiz-bank-page)HTML
<a href="/listings/slowburn1701--quiz-bank-page"><img src="/api/listings/slowburn1701--quiz-bank-page/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 138 lines
- ---
- name: quiz-bank-page
- description: 把课程题库(docx/txt/md/xlsx/PDF/图片)生成为单文件离线刷题网页:整套试卷 + 逐题闯关、选项每题乱序、错题自动加频、可导出答题情况给 AI 安排下一轮。当用户说“把这份题库做成刷题网页 / 自测网页 / 答题系统”“备考刷题”“错题反复练”“导出答题情况”时使用。
- ---
- # Quiz Bank Page(题库 → 离线刷题页)
- 把一份题库变成**一个 HTML 文件**:双击就能在任何电脑上刷题,不联网、不装环境、不发服务器。
- 成品包含「整套试卷」和「逐题闯关」两种模式,选项每题重新洗牌,错题自动加频,答题记录存在本机。
- 本 skill 目录下的资产:
- - `assets/template.html`:完整页面模板(CSS/JS 引擎 + `__BANK__` / `__META__` 占位符)
- - `scripts/build.py`:校验 `questions.json` 并注入模板,产出最终 HTML
- - `scripts/test_quiz.js`:无头 Chrome 端到端自检(需要本机 Chrome)
- - `references/parse-guide.md`:docx / xlsx / PDF / 图片题库的提取与清洗套路
- - `examples/sample-questions.json`:`questions.json` 的结构示例(含 2–6 个选项的混合题)
- ## 何时用
- 用户给了一份题库/试卷/课后题,想反复自测、看错题、按轮次复习时;或者没有题库、只给了教材/讲义/笔记,需要先按资料出题再做成网页。典型说法:
- “把这个题库做成网页”“生成一个刷题系统”“可以导出答题情况给你,再继续问下一轮”“我没有题库,你按这份资料出题”。
- 不做:多选题(一题多个正确项)、填空题、主观题、需要自动判作文的题。**多选题必须明确告诉用户当前引擎只支持单选**,让用户二选一:拆成多道单选,或换题型后再做。不要假装支持多选。
- ## 流程
- ### 1. 先对齐输入
- 确认这几件事,缺什么问什么,不要自行猜测:
- - 题库文件路径(可能有多个文件/多个学期)
- - 课程名(页面标题与导出文件名用),例如「工业设计史」「计算机网络」
- - 题目数量是否与文件一致(先数一遍,后面要和构建输出对数)
- - 有没有判断题/多选题/答案缺失的题
- 判断/正误题可以做成两个选项(`["正确", "错误"]`),这是单选的合法特例,可以直接支持。
- ### 2. 提取成 questions.json
- 按 `references/parse-guide.md` 的方法读原文件,生成:
- ```json
- {
- "meta": {
- "title": "工业设计史",
- "key": "gongye-shejishi",
- "source": "你的 docx 题库(67 题)",
- "fileBase": "工业设计史"
- },
- "questions": [
- {"id": 1, "q": "题干文字", "opts": ["选项A", "选项B", "选项C", "选项D"], "ans": 2}
- ]
- }
- ```
- 规则:
- - `id`:保持原题号最省事;没有题号就按出现顺序 1..N。页面上的「原题 NN」就是它。
- - `ans`:正确项在 `opts` 里的下标,**从 0 开始**。不是 ABCD 字母。
- - 选项按原文件顺序放入,**不要在这里打乱**——页面每次渲染会自己洗牌,并保证不与原顺序完全相同。
- - 题干与选项保留原文;只允许修正明显的 OCR 错字(例如“家員业”→“家具业”),并在交付说明里讲清改了哪些、题意答案未动。
- - 答案拿不准的题:**不要猜**。要么回原文核对,要么单独列出来问用户,宁可少一题也不编答案。
- ### 2b. 没有现成题库:按资料出题
- 用户只给资料(教材章节 / 讲义 / 笔记 / 大纲)时,**不要凭空编题**。先按资料写成 `questions.json`,规则:
- 1. **每题可回溯**:先在资料里找到支撑这句话的原句,记下章节 / 页码;题目只考这句里的信息。
- 2. **不引入资料外知识**:数字、年份、人名、术语以资料为准;资料没写的不补。
- 3. **一题一个考点**:题干给足条件,选项互斥;错误项要“明确错”,不要“可能对”。
- 4. **不用含糊选项**:“以上都对 / 都不对 / 全部正确”一律改写或删掉;`build.py` 会对这类表述给警告。
- 5. **不乱码**:全程 UTF-8;`�`、`Ã`、`â€` 等乱码特征会被 `build.py` 直接拦下。中文标点也要检查。
- 6. **写完逐题自检**:问自己“答案在资料哪一句”,答不上来的删掉或问用户。题少一点没关系。
- 7. 交付时说明每题来源(章节 / 页码),请用户抽查 3 题。
- 详细方法见 `references/parse-guide.md` 的「从资料生成题目」。
- ### 3. 校验数量与答案
- 构建脚本会强校验:题干非空、题干不重复、2–8 个选项、选项不重复、`ans` 越界、id 重复;题干或选项含乱码特征(`�`、`Ã`、`â€` 等)会直接失败。它还会打印选项数分布和答案分布(A/B/C/D),并对“以上都对”这类含糊表述给警告。
- 再人工核对三件事:
- 1. 题目数 == 原文题数(少了多半是题号粘连或跨行被吞)。
- 2. 答案分布是否离谱(全 A / 全 C 通常是解析错位,而不是题库真这样)。
- 3. 随机抽 3 题,回原文对照题干与答案。
- ### 4. 构建
- ```bash
- python scripts/build.py questions.json "输出目录/课程名_刷题练习.html"
- ```
- 默认模板就是 `assets/template.html`,一般不用传 `--template`。
- 生成后确认:文件里没有 `http(s)://` 外链,没有残留 `__BANK__` / `__META__`。
- ### 5. 自检(必须做)
- ```bash
- node scripts/test_quiz.js "输出目录/课程名_刷题练习.html" questions.json "输出目录/自检"
- ```
- 它会用无头 Chrome 自动跑:题量、选项乱序、整套作答→提交→满分、试卷总览红绿状态与跳题、上一题回看、导出 txt、错题卷、逐题键盘作答、刷新持久化、移动端横向溢出、控制台报错,并留下 4 张截图。
- - **Windows 上 DSH 的 workspace-write 沙箱里 Chrome 起不来**(mojo 命名管道被拒),需要 `sandbox_permissions: danger-full-access` 跑这一步。
- - 结果必须是 `RESULT: ALL PASS`。有 FAIL 先修,不要带着失败交付。
- - 打开 `shot-paper-top.png` / `shot-mobile.png` 亲眼看一下版式,别只看日志。
- ### 6. 交付
- 把 HTML 用 `present` 交付(单文件,直接发文件即可)。同时告诉用户:
- - 拷到任何电脑双击打开,离线可用;记录存在该浏览器本地,换电脑/清缓存会重置(先导出 txt 可留档)。
- - 两种模式怎么用;「已掌握」= 连续答对 2 次。
- - 下一轮怎么接:做完点「导出答题情况」把 txt 发回来,或直接点「再练错题 / 重新开一套」(错题加权)。
- ## 引擎行为(不要改坏)
- - **整套试卷**:一次排 N 题,全题库覆盖;选项乱序且避开原顺序;可改答案、底部固定栏实时计数;右侧「试卷总览」按题号显示对(绿)/错(红)/未答(无色),点题号跳转;提交后锁定、给分、逐题标正确答案,错选标红;可导出/复制答题情况 txt。
- - **逐题闯关**:一次一题,答完立即判对错,答错给正确答案并把这题插回队列 1–3 题后;答过的题可用「上一题」回看,回看不重复计分;每轮全题库各抽一次,按 `weight = (1+2.6*wrong)/(1+0.45*min(right,4))` 加权,错题更频繁;键盘 A–D(最多 A–H)/ 1–8 作答,回车下一题,← 上一题。
- - 选项乱序:`shuffleOrder` 重试至多 40 次避开原顺序;判分按「展示位置 → 原选项下标」映射,不要用字母直接判。
- - 状态存 `localStorage`,键为 `quizbank_v1:<meta.key>`;**不同课程必须给不同 `key`**,否则记录会串。
- - 页面无外链、无 fetch,纯 file:// 可用。
- ## 视觉
- 包豪斯/风格派底子:纸色 `#f4f1ea`、墨 `#141414`、红 `#d8422f`、蓝 `#23508f`、黄 `#f0b429`,硬阴影 8px。所有颜色在模板 `:root` 里,换课程想换色只改变量,不要改结构。移动端已做单栏、计分 2×2、底部栏换行。
- ## 交付前 checklist
- - [ ] `build.py` 题目数与原文一致,答案分布正常
- - [ ] 若为资料出题:每题能指回资料原句,没有资料外知识,含糊题已改写
- - [ ] 乱码拦截通过,没有 `�` / `Ã` / `â€` 之类字符
- - [ ] `test_quiz.js` 输出 `ALL PASS`
- - [ ] 看过桌面与移动端截图,底栏不遮内容
- - [ ] 无外链、无占位符残留
- - [ ] 告诉用户记录在本机、换机前导出、下一轮怎么接
README.md · README · 140 lines
- # quiz-bank-page
- **把课程题库变成一份单文件、离线可用的刷题网页。**
- 输入一份题库(docx / xlsx / PDF / 截图 / 文本),输出一个 `.html`:双击就能在任何电脑、平板或手机上刷题,不联网、不用装环境、不用起服务器。没有现成题库时,也可以只给资料,按资料出题——规则见下文。
- 它原本是一个 DeepSeek Harness(DSH)技能:把提取、校验、构建、自检四步固化下来,换课程只换题库,页面不用重做。
- 
- ## 特性
- - **两种模式**:整套试卷(一页排完全部题,提交后给分、逐题标出正确答案)和逐题闯关(一次一题,答错立刻给答案,1–3 题后重现)。
- - **试卷总览**:整套试卷页右侧按题号列出全部题目,答对变绿、答错变红、未答无色,点题号直接跳到该题。
- - **上一题回看**:逐题闯关里可以退回看已经答过的题和当时的判题结果,回看不重复计分。
- - **选项每题乱序**:每次渲染重新洗牌,并保证不与题库原顺序相同;判分按「展示位置 → 原选项下标」映射,不靠字母。
- - **错题自动加频**:答错次数越多,之后出现越频繁;连续答对 2 次记为「已掌握」。
- - **可导出的答题情况**:整套提交后可导出 / 复制 txt(得分、错题明细、逐题作答、错题 ID),发给 AI 就能安排下一轮。
- - **全离线单文件**:无外链、无 fetch、无依赖,`file://` 直接打开;记录存在浏览器 `localStorage`。
- - **支持 2–8 个选项**:判断题用 `["正确", "错误"]` 两个选项即可。
- - 键盘作答(A–H / 1–8,回车下一题,← 上一题),移动端单栏适配。
- ## 快速开始
- ### 直接试示例
- 仓库自带一份 7 题的演示页(计算机网络基础),双击 `examples/demo.html` 即可;开了 Pages 也可以在线看。
- **[▶ 在线试玩(7 题演示)](https://slowburn1701.github.io/quiz-bank-page/examples/demo.html)**
- ### 用现成题库构建
- ```bash
- python scripts/build.py questions.json "计算机网络基础_刷题练习.html"
- ```
- 只需要 Python 3(无第三方依赖)。生成的文件可以随意改名、拷走、发给别人。
- ### 没有现成题库:按资料出题
- 给它教材章节、讲义、笔记或课程大纲,按「只依据资料、每题可回溯、不编造」的规则先写成 `questions.json`,再走同一个构建流程。完整规则与自检清单见 `SKILL.md` 的「没有现成题库」一节和 `references/parse-guide.md`。
- ### 装成 DSH 技能
- 把整个仓库目录放到 DSH 的 skills 目录下,命名 `quiz-bank-page`(例如 `~/.dsh/skills/quiz-bank-page`,Windows 视 `DSH_HOME` 而定)。之后直接说「把这份题库做成刷题网页」即可触发。
- ### 自检(可选,需要本机 Chrome)
- ```bash
- node scripts/test_quiz.js "计算机网络基础_刷题练习.html" questions.json 自检输出目录
- ```
- 会用无头 Chrome 跑完整流程:题量、选项乱序、整套全对、试卷总览红绿状态、上一题回看、导出 txt、错题卷、逐题键盘、刷新持久化、移动端溢出、控制台错误,并留下 4 张截图。输出 `RESULT: ALL PASS` 才算通过。
- ## 题库格式
- ```json
- {
- "meta": {
- "title": "计算机网络基础",
- "key": "net-basics",
- "source": "你的 docx 题库(120 题)",
- "fileBase": "计算机网络基础"
- },
- "questions": [
- {"id": 1, "q": "OSI 参考模型分为几层?", "opts": ["5 层", "7 层", "4 层"], "ans": 1},
- {"id": 2, "q": "IPv4 地址长度为 32 位。", "opts": ["正确", "错误"], "ans": 0}
- ]
- }
- ```
- | 字段 | 说明 |
- | --- | --- |
- | `meta.title` | 页面标题、导出 txt 标题 |
- | `meta.key` | `localStorage` 键后缀,**不同课程必须不同**,否则记录会串 |
- | `meta.source` | 页面「说明」里的题库来源 |
- | `meta.fileBase` | 导出文件名前缀 |
- | `meta.ocrNote` | 可选,`false` 时隐藏页面里的 OCR 修正说明 |
- | `questions[].id` | 原题号或顺序号;页面显示为「原题 NN」 |
- | `questions[].q` | 题干 |
- | `questions[].opts` | 选项原文,按原顺序放,**不要在这里打乱** |
- | `questions[].ans` | 正确项下标,从 **0** 开始 |
- 构建脚本会校验:题干非空且不重复、选项 2–8 个且不重复、`ans` 合法、id 唯一;发现乱码特征(`�`、`Ã`、`â€` 等)直接报错;遇到「以上都对」这类含糊表述给出警告。它还会打印题目数、选项数分布和答案分布,方便和原文件对数。
- ## 从题库到 JSON
- `references/parse-guide.md` 里有 docx / xlsx / PDF / 图片题库的提取方法与常见坑:
- - docx 常见「上一题 D 选项和下一题题干粘在同一段」,需要在题号前补换行;
- - 答案可能写在题干末尾、括号里,或卷末答案表;
- - 扫描件 OCR 必须人工核对选项字母和答案字母;
- - 答案拿不准的题**不要猜**,列出来问用户,宁可少一题也不编。
- 提取完先跑构建,再肉眼抽 3 题对照原文,然后跑自检。
- ## 从资料出题(没有题库)
- 只依据用户给的资料,不引入资料外的知识:
- 1. 每个考点在资料里找到原句,题目必须能指回那一句;找不到出处的题不写。
- 2. 不编数字、年份、人名、书名;资料里没有的干扰项不硬凑。
- 3. 一题只考一个点,题干给足条件;选项互斥,错误项要「明确错」,不要「可能对」。
- 4. 不用「以上都对 / 都不对」这类选项;含糊的题改写或删掉。
- 5. 输出后逐题复核:答案是否被资料支持、选项是否只有一个对、有没有歧义。
- 6. 交付时说明每题大致来源(章节/页码),请用户抽查 3 题。
- ## 目录结构
- ```
- quiz-bank-page/
- ├── SKILL.md # DSH 技能说明(完整工作流)
- ├── assets/template.html # 页面模板:CSS + 刷题引擎 + 占位符
- ├── scripts/build.py # 校验 questions.json 并注入模板
- ├── scripts/test_quiz.js # 无头 Chrome 端到端自检
- ├── references/parse-guide.md # 题库提取、清洗与按资料出题指南
- ├── examples/sample-questions.json
- ├── examples/demo.html # 由示例题库构建好的演示页
- └── docs/screenshots/ # 桌面 / 移动端 / 提交结果截图
- ```
- ## 截图
- | 整套试卷 | 提交结果 |
- | --- | --- |
- |  |  |
- | 错题明细 | 移动端 |
- | --- | --- |
- |  |  |
- ## 限制
- - **只支持单选**:一题多个正确项的题型不支持。请拆成多道单选,或排除这些题——不要只保留一个正确项当单选,那会教错。
- - 无后端、无账号:记录只存在当前浏览器的 `localStorage`,换电脑或清缓存会重置(先导出 txt 可留档)。
- - 页面字体使用系统字体,不同系统观感略有差异。
- ## License
- MIT
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.