一、项目概述
史海拾贝 是一款面向历史爱好者的本地知识问答小工具,以「历史基础知识问答」为核心,支持离线使用、桌面安装,无需联网即可随时随地刷题。项目采用纯前端技术栈(单文件 HTML + Service Worker),零依赖、零构建,开箱即用。
二、核心功能
答题引擎
- 两种模式:练习模式(不限时,从容作答)与挑战模式(限时答题,考验反应)
- 灵活出题设置:可按「范围(中国史/世界史/全部)」「分类」「难度(简单/中等/困难)」「题数(5~30题)」自由组合
- 智能计分:基础分 + 连对加成(连对越多加分越高),难度越高基础分越高
- 即时反馈:答对/答错高亮显示正确答案,并给出解析
题库规模
- 内置约 359 道历史题目,覆盖中高考常见题:
- 中国古代史(先秦、秦汉、三国南北朝、隋唐、宋元、明清)
- 中国近现代史(晚清、民国、新中国)
- 世界史(古代、中世纪至近代、现代)
- 题型包含选择题与判断题两类
结果与复盘
- 答题结束后展示总分、正确率、最大连对,并给出等级评价(博古通今 / 学识渊博 / 略有小成 / 继续努力)
- 支持逐题查看解析,回顾每道题的作答情况
- 历史记录:本地保存最近 50 条答题记录,可查看、清空
三、技术架构
| 组件 | 说明 |
|---|---|
index.html | 单文件应用,含全部样式、题库与逻辑(原生 JS,无框架) |
manifest.json | PWA 清单,声明应用名、图标、主题色,支持「添加到桌面」 |
sw.js | Service Worker,实现离线缓存(Cache Storage) |
server.ps1 | PowerShell 内置 HTTP 服务器(HttpListener),监听 localhost:8000 |
start.vbs / install.vbs | Windows 快捷方式脚本,一键启动/安装到桌面 |
icon.ico | 桌面快捷方式图标 |
技术特点
- 零依赖:不依赖任何第三方库或框架,纯原生 HTML/CSS/JS
- PWA 离线能力:通过 Service Worker 缓存静态资源,断网也能用
- 本地持久化:答题记录通过
localStorage存储 - 轻量部署:仅需 PowerShell 即可启动本地服务器,无需 Node/Python 环境
四、使用方式
- 启动:双击
start.vbs(或直接运行server.ps1),自动打开http://localhost:8000 - 安装到桌面:双击
install.vbs,在桌面生成ShiHaiShiBei快捷方式 - 开始答题:选择模式与出题设置 → 点击「开始答题」→ 逐题作答 → 查看结果与解析

435

被折叠的 条评论
为什么被折叠?



