MoKao — 粉笔模考采集 Chrome 扩展

一款面向公考备考的 Chrome 扩展工具，自动从粉笔模考页面提取完整试卷（题目/选项/解析/图片/材料），生成带 YAML Frontmatter 的结构化 Markdown 笔记，一键直存 Obsidian 知识库。

• 🎯 一键提取 — 自动采集完整试卷（题干、选项、答案、解析），支持懒加载滚动与材料页
• 🖼️ 图片支持 — 提取题干/选项/解析/材料图片，公式图片自动内联；可选 Base64 内嵌或保留 URL
• 📊 分数爬取 — 自动识别考试成绩（多策略兜底），可手动编辑
• 🏷️ 笔记属性面板 — 可编辑 title / date / source / tags / score，自动生成 YAML Frontmatter
• 📖 Obsidian 直存 — 三级降级：本地服务器直写 Vault → obsidian:// URI 剪贴板 → 本地下载
• 🔧 输出可配置 — 图片模式、材料开关、答案/解析开关、题目分隔符均可设置

1. 下载最新的 mokao_vX.X.X.zip 并解压
2. 打开 Chrome，访问 chrome://extensions/
3. 开启右上角 开发者模式
4. 点击 加载已解压的扩展程序，选择解压后的文件夹
5. 扩展图标出现在工具栏，安装完成

1. 打开粉笔模考解析页 — 访问 spa.fenbi.com 的模考解析（solution）或报告（report）页面
2. 点击扩展图标 — 弹出 MoKao 面板，自动检测页面
3. 点击「提取题目」 — 自动滚动加载并提取全部题目/材料/分数
4. 编辑笔记属性 — 修改标题、标签、分数等（提取后自动展开）
5. 保存 — 保存到 Obsidian（直存或剪贴板），或下载 Markdown 文件

扩展设置页（扩展图标 → ⚙️ 设置）包含两个 Tab：

• 通用设置 — 图片处理（Base64/URL/跳过）、题目分隔符、导出内容开关（统计/材料/我的答案/解析）
• Obsidian 直存 — 本地服务器配置（地址、Vault 路径、保存文件夹、文件名模板、启用开关）

mokao-chrome-extension/
├── manifest.json               # 扩展配置（Manifest V3）
├── content.js                  # 页面注入脚本（DOM 提取逻辑）
├── popup.js                    # 弹窗交互逻辑
├── popup.html                  # 弹窗 UI
├── settings.html               # 设置页面
├── settings.js                 # 设置逻辑（配置统一存 mokao_props）
├── mokao_obsidian_server.py    # 可选：Obsidian 直存本地服务器
├── vault_config.json           # 服务器配置文件（自动生成）
├── icon16.png / icon48.png / icon128.png
└── crawl-template.json         # 爬取模板配置

默认无需后端，使用 obsidian:// URI + 剪贴板即可保存（需本机安装 Obsidian）。

如需服务器直写 Vault（不依赖 Obsidian 协议）：

python mokao_obsidian_server.py --vault "你的Obsidian库路径"

服务器只监听 localhost:8765，不暴露外网。首次运行会要求选择 Vault 目录，配置保存在 vault_config.json。

在设置页「Obsidian 直存」中勾选"启用直存"后，点「保存到 Obsidian」会先尝试服务器直存（文件直接写入 Vault，不占剪贴板、无大小限制）；服务器离线或未设置 Vault 时自动降级为 obsidian:// URI 剪贴板方式。

• Manifest V3 — 符合 Chrome 最新扩展标准
• Content Script — 运行在粉笔页面上下文，自动复用浏览器登录态（Cookie）
• 选择器适配层 — content.js 顶部 SELECTORS 常量集中管理全部 DOM 选择器，粉笔改版时单点维护
• 分数提取 — 三策略兜底：/100 兄弟节点 → "我的得分"容器 → 全文正则
• 设置持久化 — 统一存储在 localStorage['mokao_props']，设置页与弹窗共享

MIT License

本工具仅供个人学习使用，请遵守粉笔网站的使用条款。提取的内容版权归原网站所有。