夜雨聆风相信很多家长都有过这样的经历：晚上陪孩子写作业，遇到自己也不会的高年级数学题，查遍手机也找不到清晰的讲解，只能干着急；老师也常常面临这样的困境：每天批改几十本作业，机械性的对错判断占用了大量时间，反而没有精力去关注每个学生的知识漏洞。
今天要介绍的https://github.com/cubewhy/skid-homework，正是一款针对这些痛点设计的开源 AI 教学辅助工具。它不是用来让学生抄作业的 "捷径"，而是一个能帮家长科学辅导、帮老师提高效率的数字化助手。所有代码完全开源，无广告、无强制付费，数据可本地存储，在隐私保护上比很多商业 APP 更让人放心。
一、它能做什么？解决教学中的 3 个核心痛点
这款工具的核心定位是 "辅助" 而非 "替代"，所有功能都围绕 "帮助学生理解知识、帮助家长有效辅导、帮助老师精准教学" 设计。
1. 帮家长：解决 "不会教、教不好" 的辅导焦虑
很多家长不是不想辅导孩子，而是随着年级升高，知识难度加大，自己已经力不从心。这款工具可以：
识别小学到大学全学科的题目，包括手写作业、打印作业、PDF 和 Word 文档 给出分步式解题过程，每一步都有原理说明，而不是只给一个最终答案 标注题目涉及的核心知识点，帮家长快速抓住辅导重点 提供同类题目的解题思路，让家长能举一反三地引导孩子
2. 帮老师：从机械性批改中解放出来
老师的时间应该花在教学设计和个性化辅导上，而不是重复的对错判断。这款工具可以：
批量批改客观题，自动统计正确率和错误率 自动整理班级错题集，按知识点分类，快速找到全班的共性问题 生成班级学习报告，直观展示每个学生的掌握情况 辅助生成教案、PPT 和练习题，节省备课时间
3. 帮学生：养成良好的学习习惯
和很多搜题软件不同，它更注重引导学生思考：
可以设置 "先思考后看答案" 模式，强制学生先自己尝试解题 自动生成个人错题本，标注错误原因，方便针对性复习 提供知识点讲解链接，帮助学生查漏补缺 生成个性化学习建议，引导学生合理安排学习计划
客观来说，这款工具在基础教学场景下已经非常成熟，但也有其局限性，大家可以理性参考：
解题能力
- 基础题：小学到高中的基础题、中等题准确率在 95% 以上，解题步骤清晰规范
- 难题：高考压轴题、大学专业课程的复杂题目准确率约 80%，部分题目可能需要人工核对
- 文科题：语文文言文翻译、英语语法题、历史政治简答题的解答质量较高，作文批改能给出合理的修改建
数据报告质量
个人学习报告：能准确统计各学科的正确率、薄弱知识点、错题类型 班级学习报告：能直观展示全班的知识掌握情况，生成错题分布热力图 所有报告都可以导出为 PDF 格式，方便打印和分享
其他实用功能
作文批改：从语法、逻辑、结构、文采四个维度给出修改建议 PPT 生成：输入教学主题，自动生成完整的课件大纲和内容 实验报告辅助：提供实验报告的标准格式和写作指导 单词背诵：根据艾宾浩斯遗忘曲线生成背诵计划
三、5 分钟快速部署，零技术门槛也能上手
等仓库恢复访问后，按照以下步骤即可在自己的电脑上运行，全程不需要复杂的编程知识：
🟢 方式一：Docker 一键部署（最简单，推荐所有人使用）
不需要安装任何开发环境，一行命令就能启动，适合新手和不想折腾的用户。
第一步：安装 Docker
Windows/Mac：下载 Docker Desktop：https://www.docker.com/products/docker-desktop/，一路下一步安装 Linux：执行以下命令安装
curl -fsSL https://get.docker.com | bash
第二步：启动容器
打开终端或命令提示符，执行：
docker run -d -p 5173:5173 --name skid-homework ghcr.io/cubewhy/skid-homework:latest
第三步：访问使用
打开浏览器访问：http://localhost:5173，即可进入工具界面。
停止和更新
停止容器： docker stop skid-homework更新到最新版本：
docker pull ghcr.io/cubewhy/skid-homework:latest docker restart skid-homework
🟡 方式二：源码编译部署（适合开发者和需要二次修改的用户）
第一步：安装必需的开发环境
- Node.js 20+：https://nodejs.org，下载 LTS 版本，一路下一步安装
- Git：https://git-scm.com，下载安装，用于克隆代码
- pnpm（项目必需的包管理器）：打开终端执行：
npm install -g pnpm
验证安装：
pnpm -v
能看到版本号即表示安装成功。
第二步：克隆项目源码
找一个你喜欢的目录，执行：
git clone https://github.com/cubewhy/skid-homework.git
cd skid-homework
第三步：安装依赖
pnpm install
第四步：启动开发服务器
pnpm dev
第五步：访问使用
打开浏览器访问：http://localhost:5173，即可进入工具界面。
构建生产版本（可选）
如果需要部署到服务器，执行：
pnpm build
生成的dist文件夹就是静态网站，可以部署到任何静态托管服务（如 Vercel、Netlify、腾讯云静态托管等）。
四、大模型支持：灵活选择，兼顾效果与成本
这款工具采用了模块化设计，支持几乎所有主流大模型，家长和老师可以根据自己的需求和预算选择：
推荐使用的国内大模型（无需翻墙，成本低）
本地运行选项（完全保护隐私）
如果担心数据安全，可以通过 Ollama 工具在本地运行开源大模型，如 Qwen 2、Llama 3 等。所有数据都存储在本地电脑上，不会上传到任何服务器，特别适合学校和注重隐私的家庭使用。
如何接入其他大模型？
非常简单，只需在配置文件中添加几行代码即可：
打开 config.json文件在 models数组中添加新的模型配置：
五、对家长和老师的实际价值
对家长：科学辅导，缓解焦虑
不用再因为自己不会解题而感到挫败，也不用盲目给孩子报昂贵的辅导班 可以清晰地了解孩子的学习情况，知道哪些知识点掌握得不好，针对性地进行辅导 节省大量辅导时间，有更多的精力关注孩子的身心健康和综合素质发展
对老师：提高效率，精准教学
从机械性的作业批改中解放出来，把更多时间花在教学设计和课堂教学上 通过班级学习报告，快速发现学生的共性问题，调整教学重点和进度 可以为不同层次的学生提供个性化的学习建议和辅导材料，实现因材施教
六、重要提醒：正确使用才是关键
最后必须强调：任何工具都只是辅助，不能代替老师的教学和家长的陪伴。
对于学生来说，应该先独立思考完成作业，遇到不会的题目再使用工具查看解题思路，看完后自己再做一遍，真正理解知识点 对于家长来说，不要把工具当成 "甩手掌柜"，要引导孩子正确使用，培养孩子的自主学习能力 对于老师来说，不要完全依赖工具的批改结果，对于复杂的主观题和学生的解题思路，还是需要人工进行细致的指导
等仓库恢复访问后，我会第一时间发布详细的实测教程和优化配置方案，包括适合不同年级的大模型参数设置、家长辅导提示词模板和老师班级管理技巧。关注我，到时候第一时间分享给大家。