打滑作业平台

ENGLISH README

符合人体工程学设计、人工智能驱动的作业助手

和我们一起交流

我们有 Telegram 群组和 GitHub discussions

可以使用下方链接加入

• Telegram Group (仅接受SFW内容)
• GitHub 讨论区

警告: 破坏性修改

我们已经将服务迁移到 Next.js, 部署时请注意配置差异.

安全提示

Skid-Homework 不会要求你下载桌面软件, 一切东西都在浏览器内运行

如果某个站点要求你下载软件来使用本平台, 可能为病毒

我们只有一个地址和一个仓库。

为什么用 打滑作业

如果你觉得这个工具好用, 可以点一个Star 或者分享给你的朋友!

• 节省时间, 高效工作流
• 无遥测
• 开源, 无黑盒
• 无垃圾电话
• 无需电话号码
• 可通过电脑、平板电脑或手机访问
• 人体工程学设计, 支持纯键盘操作
• 可定制答案风格, 不局限于标准答案
• 支持解析多张图片/PDF 文件
• 左撇子友好
• 支持输出图片 (支持情况)
• 支持本地持久化解析 (实验性, 若遇到问题请清空网页数据)
• 墨水屏友好 (仅浅色模式, 如果配色方案有问题请开 issue)
• ADB 截屏支持 (实验性 需要浏览器支持 WebUSB)

现在尝试

官方实例部署在 https://skid.996every.day

您需要申请一个 Gemini API 密钥或者自备一个OpenAI 兼容API 才能访问 AI。

Google AI Studio

默认快捷键说明

注: 如果浏览器占用了某个快捷键或者感觉快捷键不顺手, 可以在 Skid-Homework 设置中进行修改!

快捷键	说明
Ctrl+1	上传文件
Ctrl+2	拍照
Ctrl+3	将文件提交给AI
Ctrl+4	删除所有文件
Ctrl+5	打开设置页面
Ctrl+X	打开全局提示词编辑器
ESC	关闭设置页面/当前对话框
空格	下一个题目
Shift+空格	上一个题目
Tab/RightArrow	下一个文件
Shift+Tab/LeftArrow	上一个文件
/	改进答案

工具快捷键说明

• JSXGraph

常见问题

画图工具支持情况

注: 部分 AI 有时会输出错误的工具调用, 若遇到问题请反馈

• JSXGraph (unstable)
• Mermaid
• function-plot (逐步弃用, 后续将替换为 JSXGraph)
• SVG

为什么如此之慢

本软件使用 LLM 而并非题库

LLM 响应耗费时间通常比题库长

没有什么特别好的优化方法

不过可以尝试缩小Thinking Budget, 太小的值可能会让AI 输出错误结果

同时, 如果不需要详细的解析可以尝试如下prompt (Ctrl+X 提示词编辑器输入即可)

用中文输出答案
只需要输出答案即可，选择题不需要输出解析(留白即可)

为什么总是失败

• 检查API 是否放开了 Cors 限制
• 检查你的IP 是否被服务商拉黑
• 检查API Key 是否有效
• 检查 Devtools (F12) 日志

我的电脑上没有摄像头, 请帮帮我

我们支持ADB, 可以连接你的安卓手机进行屏幕截图, 需要浏览器支持 WebUSB

此过程在本地进行, 不会窃取隐私。

如果使用苹果手机/postmarketOS 可以尝试 KDE Connect

老师不喜欢我的答案风格/答案风格不符合我的预期

本站点默认不自带默认的答案风格, 和传统题库相比开箱即用没那么强, 但可自定义性高

你可以点击界面中的编辑全局Prompt (Ctrl+X) 来编辑提示词

可以写你特殊的需求, 例如答案风格

如果只是对某一道题目的解答不满意可以按/ (改进答案) 来提出改进需求让AI重写

我没有API Key

Gemini API Key 是免费的, 可以去申请

如果环境不允许没办法, 不过可以用Cloudflare 搞反向代理, 方法请自行查找

请求失败

如果你的API 密钥和地址都正确的话, 大概率是 Cors 干的

这是浏览器的问题, 你可以尝试本地搭建反向代理.

如果是其他问题请携带Devtools (F12) 日志开issue.

OCR 是怎么实现的

现在站点会将图片直接发送给AI

如果你有更好的方案请开pr/issues

比传统软件(例如作业帮)强大在哪里

• 电脑可用
• 有针对写作业场景设计的人体工程学
• 支持绘图
• 开源, 无广告

我还是觉得其他搜题软件好用怎么办

那就接着用你喜欢的工具就可以了, 工具是为人服务的, 用得顺手才适合

Dev mode 是什么

我们在软件里写了一些功能方便我们调试

如果使用没有问题, 请不要打开该选项

功能如下

• 查看原始Markdown

我还有其他问题

如果你发现了Bug, 请到 issues 反馈, 否则请移步讨论区.

请移步 讨论区

Star 历史记录

如果这个项目节省了你的时间, 请务必献上一个 Star!

为什么太多作业不好

• 浪费时间
• 效率低下
• 影响睡眠质量
• 影响心理健康

觉得这违反了道德规范?

如果您这么认为，请不要使用它。

家庭作业旨在帮助学生理解知识， 而不是用来控制学生。

我个人使用可汗学院和维基百科来学习， 既省时又高效。

但学校可能会要求我提交作业... 这个平台只是解决这个问题的一个变通方法。

免责声明

本项目鼓励用户遵守学术诚信, 请勿在考试中使用本软件.

若违规使用, 本项目不承担任何责任

本项目使用 GPLv3 授权, 开发者无权控制软件的分发.

开发

• Clone 本存储库
• 运行 pnpm i
• 运行 pnpm run dev 来预览

欢迎PR

快速部署(使用Vercel)

请点击下方按钮

快速部署(使用Docker)

# Replace <commit_hash> with the actual commit hash
docker run -p 3000:3000 ghcr.io/cubewhy/skid-homework:sha-<commit_hash>

services:
  skidhw:
    # Replace <commit_hash> with the actual commit hash
    image: ghcr.io/cubewhy/skid-homework:sha-<commit_hash>
    ports:
      - 3000:3000

构建 Docker 映像

容器开放 3000 端口.

docker build -t skid-homework .

I18N 类型报错

请在修改i18n 文件之后运行如下命令更新类型

pnpx i18next-cli types

License

This work is licensed under GPL-3.0

You're allowed to use, share and modify.

skid-homework 快速上手指南

skid-homework 是一个符合人体工程学设计、由人工智能驱动的作业助手。它完全在浏览器中运行，支持多模态输入（图片/PDF）、自定义答案风格及绘图功能，旨在提供高效、开源且无遥测的解题体验。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Windows, macOS, Linux (支持桌面端及移动端浏览器访问)
• 运行时依赖：
  • Node.js (推荐 v18 或更高版本)
  • pnpm (包管理工具)
• API 密钥：
  • 您需要一个 Google Gemini API Key 或兼容的 OpenAI API Key。
  • 获取地址：Google AI Studio
• 浏览器要求：
  • 推荐使用最新版的 Chrome 或 Edge 以获得最佳兼容性。
  • 若需使用 ADB 截屏功能，浏览器需支持 WebUSB。

安装步骤

您可以选择本地开发部署或使用 Docker 快速启动。

方式一：本地源码部署（推荐开发者）

1. 克隆仓库

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

2. 安装依赖

   pnpm i
   

3. 启动开发服务器

   pnpm run dev
   

   启动后，通常在 http://localhost:3000 访问应用。

方式二：Docker 部署

如果您希望快速搭建服务，可以使用 Docker。

运行容器：

# 请将 <commit_hash> 替换为实际的提交哈希值，或使用 latest 标签（如果可用）
docker run -p 3000:3000 ghcr.io/cubewhy/skid-homework:sha-<commit_hash>

或使用 Docker Compose： 创建 docker-compose.yml 文件：

services:
  skidhw:
    image: ghcr.io/cubewhy/skid-homework:sha-<commit_hash>
    ports:
      - 3000:3000

然后运行：

docker compose up -d

方式三：一键云部署

点击以下按钮即可在 Vercel 上快速部署实例：

基本使用

部署完成后，打开浏览器访问对应地址即可开始使用。

1. 配置 API

首次使用时，您需要在设置中填入您的 API Key。

• 按下快捷键 Ctrl+5 打开设置页面。
• 输入您的 Gemini API Key 或 OpenAI 兼容接口地址及密钥。
• 按 ESC 关闭设置。

2. 上传题目

支持上传图片、PDF 文件或直接调用摄像头拍照。

• 上传文件：按 Ctrl+1 选择本地文件。
• 拍照：按 Ctrl+2 调用摄像头（若无摄像头可尝试连接安卓设备使用 ADB 截屏功能）。
• 切换文件：使用 Tab / Shift+Tab 或方向键在多个文件间切换。

3. 获取解答

• 提交给 AI：选中文件后，按 Ctrl+3 开始解析并生成答案。
• 浏览结果：按 空格 键查看下一题，Shift+空格 查看上一题。
• 优化答案：如果对生成的答案风格或内容不满意，按 / 键可让 AI 重新改进答案。

4. 自定义提示词 (Prompt)

为了获得更符合您需求的回答（例如只要答案不要解析，或指定语气）：

• 按 Ctrl+X 打开全局提示词编辑器。
• 输入您的指令，例如：

  用中文输出答案
  只需要输出答案即可，选择题不需要输出解析
  

• 保存后，后续所有请求将遵循此风格。

5. 常用快捷键速查

快捷键	功能说明
Ctrl+1	上传文件
Ctrl+2	拍照
Ctrl+3	提交当前文件给 AI
Ctrl+X	编辑全局提示词
空格	下一个题目
/	改进当前答案
ESC	关闭弹窗/设置

注意：本工具仅供学习辅助和效率提升，请遵守学术诚信规范，切勿在正式考试中使用。