薇星幻海
103 lines
8.7 KiB
Markdown
103 lines
8.7 KiB
Markdown
# 谊安学助手 2.0
|
|
|
|
一个可直接安装的油猴脚本，集成岗位题库搜索、自动选择答案、允许复制文字，以及原有 CSV / JSON / TXT 导出功能。题库在浏览器本地解析和保存，内置 JSZip，无 CDN 依赖。
|
|
|
|
## 安装和更新
|
|
|
|
1. 在 Chrome / Edge 中安装并启用油猴（Tampermonkey）。
|
|
2. 新建脚本，将 `谊安学助手 2.0.user.js` 的全部内容粘贴进去，保存。脚本显示名称为“谊安学助手 2.0”。升级时替换原脚本全文，不要同时启用新旧两份脚本。
|
|
3. 刷新网页，点击右下角“题库助手”入口展开面板。
|
|
4. 选择“主操 / 班长 / 副操”，点击“导入题库”，选择 ZIP、CSV 或 JSON 文件。
|
|
|
|
脚本使用 `@match *://*/*` 和 `@match file:///*`，不固定域名、IP、端口或网址路径，换地址后无需修改脚本。普通网页均显示可折叠入口；`chrome://` 等浏览器限制页面无法注入。访问本地 HTML 时，需在扩展设置中开启“允许访问文件网址”。
|
|
|
|
**网址通用不等于所有平台都能自动答题。** 自动选择适配提供的谊安学桌面练习页，以及明确为 `flag=test`、完整加载并且仍可作答的桌面考试页。未知模式、移动端虚拟翻页试卷、已提交或计时结束的考试不会自动选择。`file:` 保存网页只用于搜索、复制和核对；原练习页可导出，不执行自动选择。
|
|
|
|
## 导入题库与搜索答案
|
|
|
|
仓库已提供按岗位合并的题库，可直接下载并导入，文件内已标注岗位：
|
|
|
|
| 岗位 | 合并文件 | 记录数 |
|
|
|---|---|---:|
|
|
| 副操 | [副操_合并题库.csv](题库/副操_合并题库.csv) | 1,560 |
|
|
| 主操 | [主操_合并题库.csv](题库/主操_合并题库.csv) | 1,620 |
|
|
| 班长 | [班长_合并题库.csv](题库/班长_合并题库.csv) | 2,340 |
|
|
|
|
可选单个岗位文件，也可同时选择三个文件导入。合并保留全部原记录、课程名称、原题号、参考答案和来源网址，并增加岗位及来源文件列；不同课程的重复题或答案差异保留。详细来源和重新生成方法见 [题库说明](题库/README.md)。
|
|
|
|
- ZIP 内按“主操 / 班长 / 副操”目录自动归类；成功导入后全量替换已有题库。提供的 `题库.zip` 已核对为 28 个 CSV、5,520 条记录：主操 1,620、班长 2,340、副操 1,560。
|
|
- 单个或多个 CSV / JSON 建议先选择岗位；文件缺少岗位信息时，使用当前选择的岗位。导入会更新相同岗位、课程和来源的数据，保留其他岗位及其他来源。
|
|
- 所有文件先解析和验证，再保存。题干、选项或参考答案无效时，会提示文件及题目位置，原题库保留。
|
|
- 油猴存储在同一浏览器中跨网址共享题库及岗位设置，刷新后无需重新导入。无油猴存储 API 时，回退为当前网站的本地存储，面板会明确提示；此模式不能跨网址共享。
|
|
|
|
搜索时先选择岗位，可再按课程筛选。输入题干、选项文字或关键词后点击“搜索”；多个关键词用空格分开，结果须同时包含所有关键词。也可选中网页题目文字后点击“用选中文字搜索”。切换岗位会保留当前搜索词并重新查询。
|
|
|
|
结果显示完整题干、选项、正确答案及课程来源，支持“复制题目与答案”和分页。相同题目、选项及答案合并来源；答案冲突分别展示并标记。遇到冲突，选择对应课程核对。
|
|
|
|
## 两个功能开关
|
|
|
|
**自动选择答案：默认关闭，每次刷新或进入另一份考试后需手动开启。** 先导入题库、选择岗位，并进入已加载完成的兼容练习或桌面考试页，再开启。脚本按岗位、题型、完整题干和全部选项文字精确匹配，优先结合课程来源消歧；以题库正确答案全文定位网页当前选项，支持选项换序。自动匹配只清理排版空白和不可见字符，保留大小写、单位、指数、数字、否定词和标点。关键词及宽松搜索结果不会直接用于自动选择。无匹配、冲突未消除、图片题或选项无法唯一对应时，跳过并显示原因。
|
|
|
|
脚本点击网页真实选项，网站会按正常逻辑保存作答记录。练习单选、判断可能点击后立即判分并锁定；练习多选显示“待确认”，由用户在网页中确认。考试单选、判断可改选，考试多选按当前集合取消多余选项并补选正确项，回读确认完整选中内容与题库答案一致后处理下一题。
|
|
|
|
“查看答案核对”折叠区显示已处理题目的题干、题库课程、正确答案全文与网页当前选项字母；未匹配等题目显示在未处理清单中。关闭开关或检测到手动作答时立即停止后续操作，已生效的选择保留。重新开启会重新读取选中状态并核对；切换岗位、题库或页面时取消旧任务。
|
|
|
|
## 桌面考试适配
|
|
|
|
考试题干中的分值（例如“（2分）”“（4分）”）和难度属于独立显示元素，提取时按 DOM 标记移除；题目自身的括号和数字保持原文。考试没有“查看答案”按钮不再被误判为锁定。
|
|
|
|
提供的考试样本“1-1安全生产方针和目标”共有 40 题：15 单选、10 多选、15 判断；页面参考答案为空，答案来自已导入的岗位题库。清理分值与难度后，三岗位均可精确匹配全部 40 题，其中 20 题的正确字母与题库中不同。例如题库 `B. 技术` 对应考试 `D. 技术`，脚本核对“技术”全文后选择网页 D。
|
|
|
|
此次适配桌面全题 DOM 页面，按顺序选择并回读核对，不操作移动端翻页。不自动点击“查看答案”或交卷；完成后检查核对结果并自行交卷。点击交卷确认、页面提交中或倒计时到零时停止自动选择。网页原有的缓存、接口保存及到时自动交卷逻辑继续生效。
|
|
|
|
**允许复制文字：首次使用默认开启，后续保留设置。** 开启后解除已适配的文字选择、复制和右键限制；关闭后恢复网页原有 `body` 限制属性和相关样式。搜索结果的复制按钮独立可用。
|
|
|
|
## 网页题目导出
|
|
|
|
“导出题库”是独立的折叠开关，每次刷新默认关闭，升级前的自动导出设置也不会使它自动开启。关闭时导出区收起，自动下载和手动导出均禁用。
|
|
|
|
开启“导出题库”后展开 CSV / JSON / TXT 按钮。在兼容练习页中，题目和参考答案加载完整后会自动下载一次 CSV，也可点击格式按钮手动导出。再次关闭后停止后续导出；主动重新开启可再次下载当前题库。导出直接读取网页中的参考答案，包括隐藏答案，不用导入题库补全缺失答案。
|
|
|
|
考试页参考答案为空，不提供考试题库导出；可使用岗位题库搜索和答案核对。
|
|
|
|
- CSV 使用 UTF-8 BOM，可用 Excel 打开；JSON 保留结构化选项和图片地址；TXT 便于阅读。
|
|
- 缺题或缺答案时不自动下载；手动导出会标记不完整。没有答题卡总数时，只能核对当前页面内容。
|
|
- 分页或滚动后才加载的题目，需要先加载或逐页导出。同一次页面运行中，相同练习内容只自动下载一次。
|
|
- 图片以链接导出，不打包图片文件。保存网页的相对图片地址按原始网址解析，离线时可能无法访问。
|
|
|
|
从下载的网页导出，也可使用原有独立工具：
|
|
|
|
1. 解压网页压缩包。
|
|
2. 双击 `离线导出题库.html`，保持它与 `question-bank-core.js` 在同一目录。
|
|
3. 选择解压后的 HTML 文件，查看完整性提示，再点击导出格式。
|
|
|
|
离线工具只解析 HTML 文本，不运行原网站脚本、不连接原网站，不需要登录或 Node.js。
|
|
|
|
## 开发与验证
|
|
|
|
`question-bank-core.js` 负责网页提取和导出；`bank-store.js`、`answer-matcher.js` 负责本地题库和匹配搜索；`assistant-panel.js`、`copy-controller.js`、`answer-runner.js` 分别负责面板、复制开关和真实选项点击；`practice-exporter.js` 负责页面识别及功能协调。发布脚本已构建，安装时只需一个 `.user.js` 文件。
|
|
|
|
修改源码后重新构建：
|
|
|
|
```powershell
|
|
npm run build
|
|
```
|
|
|
|
安装开发依赖并运行验证，需要本机 Chrome：
|
|
|
|
```powershell
|
|
npm install
|
|
npm test
|
|
```
|
|
|
|
使用本机 Edge 时可先设置：
|
|
|
|
```powershell
|
|
$env:PLAYWRIGHT_CHANNEL = 'edge'
|
|
npm test
|
|
```
|
|
|
|
验证使用本地模拟页面，不连接谊安学服务器；真实登录后的线上使用仍需在实际环境验收。本地存在题库 ZIP 或保存网页样本时，还会核对对应内容。原始 ZIP、解压网页及临时导出由 `.gitignore` 排除；`题库/` 中的三个岗位合并 CSV 随仓库提供。
|
|
|
|
远程仓库：`ssh://git@192.168.10.31:2222/qishizhe/yianxue-shauti.git`。
|