智恒思政助教智能体

面向初中道德与法治课程（7-9年级）的 AI 教学助手

---

项目简介

智恒（Zhiheng）——"智慧与恒毅"。一个面向广西国门学校初中《道德与法治》课程的 AI 教学助手平台。

系统功能：

• AI 教案生成 — 基于数字化教材与校本知识库的 RAG 驱动生成
• AI PPT 生成 — 从教案自动生成课件
• 语音输入与智能补全 — 极简录入工作流与智能联想补全
• 思维导图与板书设计 — 自动生成知识图谱与手写风格板书
• 考点映射 — 自动将知识点与课程标准、考试大纲对接
• 材料归档 — 导出 Word/PDF/ZIP，支持版本管理
• 校本知识库 — 2026版教材数字化，分块语义标注，知识图谱，RAG 引擎
• 内容审核 — 全流程日志记录、合规追踪、角色权限管理
• 时政推送 — 按课时主题精准推送时政热点内容

目标用户

广西边境地区（中越边境）约 37 所国门学校，覆盖 7-9 年级，共约 350 课时的《道德与法治》课程。

技术栈

• 后端： Python (FastAPI) + SQLAlchemy 2.0
• 前端： Vue 3.5 + Vite（Docusaurus 文档站）
• 大模型： 远程 vLLM 端点（Qwen3 系列）
• RAG： LightRAG（PostgreSQL + pgvector + AGE 图谱）、KohakuRAG（本地）
• 嵌入模型： Qwen3-Embedding-8B via OpenRouter（qwen/qwen3-embedding-8b）
• 对话智能体： DeerFlow（SSE 流式，PPT 生成）
• 认证： JWT + bcrypt + Cloudflare Worker Session Cookie，角色权限控制
• 缓存： Redis 7（速率限制、会话、令牌存储）
• 存储： Shared PVC (zhiheng-user-data-pvc，per-user subPath 隔离)
• 设计系统： DESIGN.md（OKLCH 色彩空间、CJK 优先、Tailwind 导出）
• 国际化： react-i18next（zh 主 / en 辅）

项目结构

zhiheng/
├── backend/              # FastAPI 后端
│   ├── models.py         # SQLAlchemy 模型（User、Lesson、Presentation）
│   ├── routers/          # auth、lessons、knowledge、chat、presentations、internal
│   └── ...
├── frontend/             # Vue 3.5 + Vite 前端
│   ├── src/pages/        # Dashboard、Editor、Materials、Login、Register
│   ├── src/components/   # Sidebar、TopBar、Layout、LessonForm
│   ├── src/locales/      # zh.json、en.json（react-i18next）
│   └── ...
├── nginx/                # 反向代理（Cloudflare Worker 认证）
├── deerflow-data/        # DeerFlow 配置、技能、状态
├── vendors/lightrag/     # LightRAG 仓库分叉（自定义补丁）
├── data/                 # lightrag_inputs、lightrag_prompts、kohakurag 数据
├── docs/                 # 本站（Docusaurus）+ 项目文档
├── DESIGN.md             # 设计系统规范
└── DESIGN.tailwind.json  # Tailwind 令牌导出

团队成员

团队	负责人
LLM 与智能体开发	迟玉鹏、Tang Ba Minh
课程与内容	叶海波、王栋、黄林毅、郑斯文
AIGC 微短剧	杨艺馨、曾柔
VR/AR	深圳慧影

快速开始

后端

cd backend
pip install -r requirements.txt
uvicorn main:app --reload

前端

cd frontend
npm install
npm run dev

文档站（本站）

cd docs
npm install
npm run start