大家好,我是李同学Lino,专注于AI智能体开发和AI副业变现,带领大家学会使用AI搞钱、提效、并最终成为AI超级个体。
点击下方👇“李同学Lino” 关注公众号
一起在AI时代提效、搞钱、成为超级个体...
如果你之前在 GitHub 上看过各种“AI 自动写作业”、“AI 解题助手”的开源项目,可能都会被一句话劝退:“克隆代码 → 安装依赖 → 本地运行”, 对不少小白来说,这就像在说火星语。
这次,我准备手把手带你把 skid-homework(打滑作业) —— 一个能通过拍照或输入题目,让 AI 自动解题、给出解析的开源项目——从零部署到你的 Win11 电脑 上。 没错,就是你现在用的这台 Windows。
整个教程会围绕 最真实的新手视角 来写:
不会跳步骤,不会一句“你自己 npm i 就好了”,不会默认你会 Node、不会默认你会 Git。
📌 你将学到:
从 GitHub 下载 skid-homework 项目,安装你真正需要的环境(Node、pnpm、Git),本地快速跑通项目(前端+本地服务)。
如何配置你的 AI API Key(Gemini / OpenAI / 兼容接口),提供你能直接复制粘贴的命令。
📌 最终效果就是: 你可以在自己的电脑本地跑起来一个 完整的 AI 作业助手 :
- 支持拍照识别题目
- 支持 PDF/多张图片解析
- 支持 AI 自动给出答案 + 解析
- 支持自定义答案风格
- 一切都开源、免费、可控
如果你本来就打算搭一个自己的 AI 作业系统、或者你想把这个项目魔改成你的同类产品,这篇教程能让你稳稳起步。
skid-homework(打滑作业) 是一个开源的 AI 做题助手,通过浏览器即可使用,不需要安装任何桌面软件。它可以:
✓ 自动解析并回答作业
你可以直接拍照、上传图片、上传 PDF,它会调用 AI 自动识别题目并生成答案。
✓ 支持自定义提示词
例如老师喜欢“步骤清晰版”、你可以写自己的提示词模版。
✓ 支持完全前端运行
安全、无黑盒、无广告、不收集隐私。
✓ 支持多平台
电脑、手机、平板都能访问。
✓ 支持键盘快捷键
非常适合大量做题、快速切换文件的用户。 本篇教程将让你把整个系统 在本地完整跑起来 ,并支持你自己配置 AI 接口(Gemini / OpenAI / Cloudflare / 自建大模型) 。
skid-homework 开源地址:https://github.com/cubewhy/skid-homework
部署 skid-homework 需要以下基础环境:
| 工具 | 作用 |
| Node.js(推荐 18 或以上) | |
| 运行前端项目 | |
| pnpm(推荐) | |
| 速度快、项目用它写的 | |
| Git | |
| 克隆 GitHub 仓库 | |
| VS Code(可选) | |
| 更方便查看代码 | |
其中:Node.js 安装可参考这篇文章:(复制到浏览器查看)https://blog.csdn.net/Little\_Carter/article/details/155107677?fromshare=blogdetail&sharetype=blogdetail&sharerId=155107677&sharerefer=PC&sharesource=Little\_Carter&sharefrom=from\_link
Git 安装可参考这篇文章:(复制到浏览器查看)https://blog.csdn.net/Little\_Carter/article/details/155110165?fromshare=blogdetail&sharetype=blogdetail&sharerId=155110165&sharerefer=PC&sharesource=Little\_Carter&sharefrom=from\_link
使用 cmd 打开终端运行:
npm install -g pnpm
验证pnpm有没有安装成功:
pnpm -v
找一个你喜欢的目录,例如:D:\Open_Source_Project
然后打开终端运行:
git clone https://github.com/cubewhy/skid-homework.git
项目会自动下载到本地。
进入项目文件夹里面:
cd skid-homework
安装依赖:
pnpm i
安装成功后,运行:
pnpm run dev
出现以上的内容说明启动成功了。
浏览器打开:http://localhost:5173/
skid-homework 默认并不内置任何 AI 功能,需要你手动配置自己的 API Key。 你可以前往我提供的 API 中转服务平台:https://linoapi.com.cn/register?aff=sJ68
注册或登录账号后,进入顶部导航栏的 「控制台」 ,在左侧菜单中找到 「API 令牌」 ,然后点击 「添加令牌」 即可生成你的专属 API Key。
这里的名称随便填写,比如我填写:homework,然后在分组中选择“优质gemini”,这个是中转了Google的Gemini,
这边可以设置一下额度,比如我设置了50元,限制这个额度用完为止,当然不缺钱的也可以无限额度哈哈哈,不过记得去“钱包”那边充值才能使用喔~,其它参数可以保持不变,最后点击“提交”即可。
这边就有一个API秘钥,就可以复制到刚刚打开的网站(http://localhost:5173/)了。
然后来到本地部署的网站(http://localhost:5173/),粘贴刚刚复制的APIKey,点击那个“高级选项”,输入API基础地址: https://linoapi.com.cn,然后点击【帮我省时间】进入到项目主页。
来到项目主页之后,你也可以点击设置这里进一步配置API和提示词或者是选择模型。
来到模型配置这里是可以选择自己喜欢的模型,可以是选择消耗token数比较少的模型,或者追求强大的模型可以选择更为强大的Pro模型。
当然你也可以控制一下思考的Tokens,让它不会这么消耗Tokens数量,还可以自定义填写系统提示,然后点击“返回”即可,它能够自动保存的。
点击上传文件: 把某张作业照片一起丢进去,系统会自动展示缩略图。
直接拍照: 如果你的电脑有摄像头,可以直接拍作业题目。
然后点击“开始打滑”,AI就可以通过OCR 识别题目,进行推理,生成结果,展示答案了。
到这里,相信你已经顺利在 Win11 环境 下跑通了 skid-homework,并完成了 API Key 配置、环境安装、项目启动 等全流程。
虽然 skid-homework 本身不自带 AI,需要你手动配置 API,但这也正是它最大的优势:开放、透明、可定制 。对于学生、自学者、老师、开发者来说,它都是一款非常灵活的工具,不管是做题、查题、批改,还是学习辅助,都能显著提升效率。
