# zhixue-courseware

**Repository Path**: chen-bohan3000/zhixue-courseware

## Basic Information

- **Project Name**: zhixue-courseware
- **Description**: 智学互动课件：AI 驱动的高中全学科交互式学习平台。输入公式自动渲染可交互动画（2D/3D 双渲染引擎），AI 一键生成数学、物理、语文等 9 学科课件，内置自适应学习、错题本与学习中心。基于 Electron + Canvas/WebGL，支持 PWA 离线使用
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-09-14
- **Last Updated**: 2026-09-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 智学互动课件（Zhixue Interactive Courseware）

> AI 驱动的高中全学科交互式学习平台:输入公式自动渲染可交互动画，AI 一键生成九学科课件、练习卷与摸底测评卷，内置自适应学习、错题本、学习周报与桌面提醒。

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![Platform: Electron](https://img.shields.io/badge/Electron-30-47848F.svg)](https://www.electronjs.org/)
[![PWA](https://img.shields.io/badge/PWA-supported-success.svg)](manifest.json)

## 功能特性

- **双渲染引擎**:数学公式 2D（Canvas）/3D（WebGL）双引擎，AI 只输出一行核心公式，引擎自动完成图形、特殊点、参数滑块与实时计算；不支持 WebGL 时自动降级 2D。
- **AI 一键生成**:基于大模型 Function Call，自然语言生成交互式课件、普通练习卷、AI 阅卷摸底卷；支持豆包、DeepSeek、OpenAI、Ollama 本地模型。
- **九大学科模板**:数学函数、物理仿真、化学结构、生物流程、地理地图、历史时间轴、政治概念图、语文/英语富文本交互。
- **自适应学习闭环**:答题数据本地采集，四维学情分析（正确率/稳定性/进步度/难度适配），薄弱点驱动课件推荐与智能组卷。
- **学习工具箱**:错题本（艾宾浩斯复习调度）、学习周报、打卡日历、桌面提醒、手写画板 AI 阅卷。
- **113 个现成课件**:数学 33 个、物理 24 个（含高二选择性必修 13 个、高考专题 3 个）、其余七学科各 8 个，覆盖高中全阶段，另含高考数学/物理专题复习课件。
- **离线可用**:Electron 桌面端 + PWA Service Worker 双离线方案，课件 HTML 自包含可单独分发。

## 技术栈

- 桌面框架:Electron 30（主进程 / preload / 渲染进程三层）
- 前端:原生 HTML5、Canvas 2D、WebGL、Service Worker，无重型框架依赖
- AI 接入:OpenAI 兼容协议（豆包火山方舟 / DeepSeek / OpenAI / Ollama），SSE 流式 + Function Call
- 移动端:Capacitor 5（Android，通用配置在 `mobile/`，本机打包脚本已忽略）
- 部署:静态站点直传 / Netlify / Gitee Pages，配置见 `netlify.toml`

## 目录结构

- `src/`:Electron 应用源码（`main.js` 主进程、`preload.js` 安全桥接、`ai/` AI 服务层、`learning/` 学习引擎、`renderer/` 编辑工具与学习中心页）
- `templates/`:课件模板引擎（`engine.js` JSON→HTML、`equation-engine.js` 2D 引擎、`equation-3d-engine.js` 3D 引擎、九学科 `*.json` Schema、`base.html` 骨架）
- `math/ physics/ chemistry/ biology/ chinese/ english/ history/ geography/ politics/`:113 个现成课件（数学 33、物理 24、其余七学科各 8）
- `assets/`:公共样式、AI 对话面板、PWA 图标
- `mobile/`:Capacitor 安卓打包通用配置
- `manifest.json`、`sw.js`:PWA 清单与离线缓存

## 快速开始

### 环境要求

- Node.js 18 及以上（推荐 20 LTS）
- Windows 用户可直接双击根目录 `启动工具.bat`，脚本会自动下载便携版 Node 并安装依赖

### 启动桌面端

```bash
npm install
npm start
```

首次启动后，在应用「设置」中填写你自己的大模型 API Key（豆包 / DeepSeek / OpenAI 任选其一），即可使用 AI 生成课件与试卷。API Key 仅保存在本机用户目录的 `ai-config.json`，不会上传、不入库。

### 仅使用静态课件（无需 Node）

用浏览器直接打开 `index.html`，或将整个仓库部署为静态站点即可学习全部现成课件；支持 PWA 安装到桌面离线使用。

### 打包 Windows 安装包

```bash
npm run build
```

或双击 `打包工具.bat`（自动配置国内镜像、禁用代码签名），产物在 `dist/` 目录。

## 配置说明（重要）

- 本仓库**不包含任何 API Key**。AI 功能需要用户自行申请模型服务并在应用设置中填写。
- 本地私有配置 `ai-config.json`、`.env`、依赖目录 `node_modules/`、构建产物 `dist/`、便携环境 `.node-cache/` 均已通过 `.gitignore` 排除。
- `mobile/一键打包APK.bat` 含开发者本机 JDK 绝对路径，未纳入版本库；安卓打包请参考 `mobile/` 内通用配置自行准备 JDK 17 与 Android SDK。

## 开源协议

[MIT License](LICENSE) © 2026 陈博汉