使用说明

教材AI学习把教材、课件、论文与图片资料转化为个人学习系统：可学习、可检索、可持续追问。

1. 资料入库

在「我的资料库」上传 PDF / Markdown / TXT / CSV / JSON 或直接粘贴文本。系统会保存原文、抽取正文并切分为带标题与页码的分块。

2. 教材解析

自动生成章节大纲与知识点（配置模型时由模型产出，否则用本地启发式引擎）。可在资料详情页查看章节与知识点。

3. 知识点学习

在「知识点学习」按章节或概念逐点学习，标记已掌握，进度保存在本地浏览器。

4. 资料内检索与课题问答

「资料内检索」在资料范围内定位原文；「课题模式」结合检索结果作答并标注引用页码。

运行配置

存储：本地文件 .data/store.json

模型：deepseek-flash

默认零配置即可运行：未设置 DATABASE_URL 时使用本地文件仓储，并内置两份示例教材。

启用数据库（可选）：

cp .env.example .env
docker compose up -d db
pnpm db:migrate && pnpm db:seed

启用模型（可选，任意 OpenAI 兼容网关 / 算力超市）：

AI_BASE_URL=https://your-gateway/v1
AI_API_KEY=sk-xxx
AI_MODEL=u2-flash

本地开发

pnpm install
pnpm dev          # http://localhost:5000
pnpm ts-check     # 类型检查
pnpm build        # 生产构建

新用户建议从资料库开始，上传一本教材后体验完整链路。