Skip to content

clever-max/Learning-Assistant

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

自动化学习助手 (Learning Assistant)

🚀 专为网课挂机、学术图表绘制、LaTeX 论文转换打造的三合一神器。

这是一款基于 Vite + React 开发的前端落地页,搭配配套的 Chrome/Edge 浏览器扩展(Extension),帮助学生和研究人员节省宝贵时间。通过完全自研的跨 Iframe DOM 嗅探引擎底层事件模拟技术,无视主流网课平台的防挂机检测和自定义 UI 组件限制。

✨ 核心功能模块

1. 🤖 自动挂机与表单填充 (搭配扩展程序)

  • 网课自动连播:采用无感跨域 iframe 轮询检测,精确捕捉视频 <video> 和“下一集”按钮,解决嵌套播放器无法连播的痛点。
  • 自定义表单填涂:支持问卷星、Element UI 等自定义表单组件的自动填写。采用真实模拟点击(Dispatch Event),不依赖原生的 checked 属性。
  • 配置实时下发:通过落地页调整配置(播放速度、填题策略、静音控制),利用 window.postMessage 与浏览器扩展进行通信,即时生效。

2. 📈 物理实验绘图 (Physics Plot)

  • 学术级排版:内置了符合实验报告规范的数据边框(学号、姓名、实验信息)。
  • 专业字体支持:默认使用 Times New Roman(西文)和仿宋(中文)的严谨排版。
  • 最小二乘拟合:自带最小二乘法的计算引擎,提供详细的推导公式(KaTeX 渲染)与相关系数 $r$
  • 高保真导出:突破 html2canvas 无法渲染最新 CSS oklch 颜色的问题,基于 html-to-image 实现 SVG foreignObject 原理的高清 (DPI 300+) 无损导出。
  • 高自由度交互:基于 ECharts,支持使用鼠标拖拽图表、按住 Ctrl 缩放,图表比例和坐标轴分度完全自适应。

3. 📝 LaTeX 转 Word 文档

  • 精准 AST 词法分析:使用自定义正则表达式引擎,剔除多余的导言区(preamble),提取核心 \begin{document} 内容。
  • 原生公式支持:抛弃了老旧的 MathType 方案,使用 docx 库和 Math 原生对象,将 LaTeX 完美转化为 Office 2016+ 支持的内嵌公式。
  • 列表转化:将 \begin{itemize}\begin{enumerate} 无缝转化为 Word 中的原生段落编号。

🛠️ 技术栈

  • 前端框架: React 18 + Vite
  • UI & 样式: Tailwind CSS v4 (采用 Apple 官网毛玻璃 Glassmorphism 设计风格)
  • 图表绘制: ECharts (echarts-for-react)
  • 公式渲染: KaTeX (react-katex)
  • 文档生成: docx + file-saver
  • 图片导出: html-to-image
  • 浏览器扩展: Manifest V3 + Shadow DOM (实现无污染常驻悬浮 UI)

📦 如何使用和部署

由于项目是纯静态前端应用,您可以选择极其简单的部署方式。

安装与运行本地开发环境

git clone https://github.com/clever-max/Learning-Assistant.git
cd Learning-Assistant/landing-page
npm install
npm run dev

一键部署 (Vercel)

推荐使用 Vercel 进行一键免费部署:

  1. 登录 Vercel,选择 Add New Project
  2. 绑定此 GitHub 仓库。
  3. 框架预设保持默认的 Vite,点击 Deploy 即可。

扩展程序安装

  1. 下载仓库 landing-page/public/ 目录下的 extension.zip 并解压。
  2. 打开 Chrome/Edge 浏览器的 chrome://extensions/ 页面。
  3. 开启右上角的 开发者模式
  4. 点击 加载已解压的扩展程序,选择解压后的文件夹。

🤝 参与贡献

欢迎提交 Issue 和 Pull Request,我们非常乐意看到功能的拓展(例如支持更多网课平台的特定识别逻辑)。

📄 许可证

MIT License

About

这是一款专为解决当代大学生在学术与学习中高频痛点的浏览器扩展及网页端工具集。它包含三大核心功能:网课与表单自动化挂机(录制与回放)、基于 Recharts 与 KaTeX 的物理实验数据一键制图与最小二乘拟合、以及纯前端实现的 LaTeX 转 Word 原生公式文档生成器。

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors