目录

一、skid-homework 是什么？有什么用？

二、部署前准备（Win11 必装环境）

三、安装 pnpm（项目必需）

四、克隆 skid-homework 项目源码

五、进入项目目录并安装依赖

六、本地启动项目（最关键）

七、第一次启动时必须做的：配置 AI Key

八、写在最后：这是一个非常值得部署的开源项目

---

如果你之前在 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 自动给出答案 + 解析

• 支持自定义答案风格

• 一切都开源、免费、可控

一、skid-homework 是什么？有什么用？

skid-homework（打滑作业） 是一个开源的 AI 做题助手，通过浏览器即可使用，不需要安装任何桌面软件。它可以：

✓ 自动解析并回答作业题目

你可以直接拍照、上传图片、上传 PDF，它会调用 AI 自动识别题目并生成答案。

✓ 支持自定义提示词与答案风格

例如老师喜欢“步骤清晰版”、你可以写自己的提示词模版。

✓ 支持完全前端运行

安全、无黑盒、无广告、不收集隐私。

✓ 支持多平台

电脑、手机、平板都能访问。

✓ 支持键盘快捷键

非常适合大量做题、快速切换文件的用户。

本篇教程将让你把整个系统 在本地完整跑起来，并支持你自己配置 AI 接口（Gemini / OpenAI / Cloudflare / 自建大模型）。

skid-homework 开源地址：https://github.com/cubewhy/skid-homework

二、部署前准备（Win11 必装环境）

部署 skid-homework 需要以下基础环境：

工具	作用
Node.js（推荐 18 或以上）	运行前端项目
pnpm（推荐）	速度快、项目用它写的
Git	克隆 GitHub 仓库
VS Code（可选）	更方便查看代码

其中：Node.js 安装在前面的文章写过了，可参考这篇文章：【2025年最新版】Node.js安装及环境配置超详细教程（以win11为例子）

Git 安装也在前面的文章写过，可参考这篇文章：【2025年最新版】Git安装及环境配置超详细教程（以win11为例子）

三、安装 pnpm（项目必需）

使用 cmd 打开终端运行：

npm install -g pnpm

验证pnpm有没有安装成功：

pnpm -v

四、克隆 skid-homework 项目源码

找一个你喜欢的目录，例如：D:\Open_Source_Project

git clone https://github.com/cubewhy/skid-homework.git

项目会自动下载到本地。

五、进入项目目录并安装依赖

进入项目文件夹里面：

cd skid-homework

安装依赖：

pnpm i

六、本地启动项目（最关键）

安装成功后，运行：

pnpm run dev

出现以上的内容说明启动成功了。

浏览器打开：http://localhost:5173/

七、第一次启动时必须做的：配置 AI Key

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数量，还可以自定义填写系统提示，例如：回答要求：

1. 步骤完整、逻辑清晰

2. 尽量使用 初中生/小学生 能理解的语言

3. 文字简洁明确

然后点击“返回”即可，它能够自动保存的。

点击上传文件：把某张作业照片一起丢进去，系统会自动展示缩略图。

或者直接拍照：如果你的电脑有摄像头，可以直接拍作业题目。

然后点击“开始打滑”，AI就可以通过OCR 识别题目，进行推理，生成结果，展示答案了。

八、写在最后：这是一个非常值得部署的开源项目

到这里，相信你已经顺利在 Win11 环境下跑通了 skid-homework，并完成了 API Key 配置、环境安装、项目启动等全流程。

虽然 skid-homework 本身不自带 AI，需要你手动配置 API，但这也正是它最大的优势：开放、透明、可定制。对于学生、自学者、老师、开发者来说，它都是一款非常灵活的工具，不管是做题、查题、批改，还是学习辅助，都能显著提升效率。

如果这篇教程对你有帮助，欢迎分享给需要的小伙伴。你的一点支持，就是我继续输出更多免费开源项目部署教程的动力 ❤️

我们下篇教程见！🚀