Skip to content
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
findsafeskills safety rating

Markdown

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

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.