qishizhe/yianxue-assistant
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: add draggable panel and restrict assistant to site directory

Browse Source
This commit is contained in:
薇星幻海
2026-10-12 14:19:31 +08:00
parent 3d7a1ffed0
commit 20abb33740
12 changed files with 968 additions and 77 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+9 -5
View File
@@ -6,12 +6,16 @@
1. 在 Chrome / Edge 中安装并启用油猴（Tampermonkey）。
2. 新建脚本，将 `谊安学助手 2.0.user.js` 的全部内容粘贴进去，保存。脚本显示名称为“谊安学助手 2.0”。升级时替换原脚本全文，不要同时启用新旧两份脚本。
3. 刷新网页，点击右下角“题库助手”入口展开面板。
3. 刷新谊安学网页，点击右下角“题库助手”入口展开面板。拖动顶部标题栏可移动面板，位置会保存。
4. 选择“主操 / 班长 / 副操”，点击“导入题库”，选择 ZIP、CSV 或 JSON 文件。
脚本使用 `@match *://*/*` 和 `@match file:///*`，不固定域名、IP、端口或网址路径，换地址后无需修改脚本。普通网页均显示可折叠入口；`chrome://` 等浏览器限制页面无法注入。访问本地 HTML 时，需在扩展设置中开启“允许访问文件网址”。
脚本仅在 `http://10.119.67.7/clientcn/*` 生效，覆盖 `/clientcn/main`、它的下级路径，以及同目录的 `/clientcn/exam/` 练习和考试页面。其他域名、HTTPS、其他端口、目录外页面及本地文件不显示面板，也不解除复制限制。除油猴 `@match` 外，脚本启动时再次核对网址。
**网址通用不等于所有平台都能自动答题。** 自动选择适配提供的谊安学桌面练习页，以及明确为 `flag=test`、完整加载并且仍可作答的桌面考试页。未知模式、移动端虚拟翻页试卷、已提交或计时结束的考试不会自动选择。`file:` 保存网页只用于搜索、复制和核对；原练习页可导出，不执行自动选择。
同一网页内切换路由离开 `/clientcn/` 时，脚本停止自动选择和导出、隐藏面板并恢复复制限制；返回范围内后重新显示面板，自动选择与导出保持关闭。
标题栏支持鼠标和触屏拖动，展开或收起都可移动；拖拽不会触发展开/收起。按钮、搜索输入和正文滚动保持原操作。刷新或切换页面会恢复保存位置；窗口缩小、面板展开或内容变高时自动调整到可见区域。
自动选择适配提供的谊安学桌面练习页，以及明确为 `flag=test`、完整加载并且仍可作答的桌面考试页。未知模式、移动端虚拟翻页试卷、已提交或计时结束的考试不会自动选择。下载的 HTML 可使用独立的“离线导出题库”工具解析。
## 导入题库与搜索答案
@@ -28,7 +32,7 @@
- ZIP 内按“主操 / 班长 / 副操”目录自动归类；成功导入后全量替换已有题库。提供的 `题库.zip` 已核对为 28 个 CSV、5,520 条记录：主操 1,620、班长 2,340、副操 1,560。
- 单个或多个 CSV / JSON 建议先选择岗位；文件缺少岗位信息时，使用当前选择的岗位。导入会更新相同岗位、课程和来源的数据，保留其他岗位及其他来源。
- 所有文件先解析和验证，再保存。题干、选项或参考答案无效时，会提示文件及题目位置，原题库保留。
- 油猴存储在同一浏览器中跨网址共享题库及岗位设置，刷新后无需重新导入。无油猴存储 API 时，回退为当前网站的本地存储，面板会明确提示；此模式不能跨网址共享。
- 油猴存储在同一浏览器中共享题库、岗位、复制设置及面板位置，站点内切换页面或刷新后无需重新导入。无油猴存储 API 时，回退为当前网站的本地存储，面板会明确提示。
搜索时先选择岗位，可再按课程筛选。输入题干、选项文字或关键词后点击“搜索”；多个关键词用空格分开，结果须同时包含所有关键词。也可选中网页题目文字后点击“用选中文字搜索”。切换岗位会保留当前搜索词并重新查询。
@@ -75,7 +79,7 @@
## 开发与验证
`question-bank-core.js` 负责网页提取和导出；`bank-store.js`、`answer-matcher.js` 负责本地题库和匹配搜索；`assistant-panel.js`、`copy-controller.js`、`answer-runner.js` 分别负责面板、复制开关和真实选项点击；`practice-exporter.js` 负责页面识别及功能协调。发布脚本已构建，安装时只需一个 `.user.js` 文件。
`site-scope.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` 文件。
修改源码后重新构建：