SLB 申论帮

核心功能

技术栈

快速部署

方式一:Docker(推荐)

# 1. 克隆仓库
git clone https://github.com/mkih76/SLB.git && cd SLB
# 2. 一键部署(自动安装 Docker、生成 .env、构建启动)
bash deploy.sh
# 3. 编辑 .env 填入 LLM API Key
nano .env # 必填:LLM_API_KEY
# 4. 重启服务
docker compose restart

方式二:手动部署

# 1. 克隆仓库
git clone https://github.com/mkih76/SLB.git && cd SLB
# 2. 安装依赖
python3 -m venv venv && source venv/bin/activate
pip install -r requirements.txt
# 3. 配置环境变量
cp .env.example .env
nano .env # 填入 LLM_API_KEY 等配置
# 4. 初始化数据库
sqlite3 data/slb.db < data/schema.sql
# 5. 导入真题数据(可选,393 套)
sqlite3 data/slb.db < data/seed_papers.sql
sqlite3 data/slb.db < data/seed_phrases.sql
sqlite3 data/slb.db < data/seed_topics.sql
# 6. 启动
python src/app.py # 开发模式
gunicorn -w 4 -b 0.0.0.0:8790 src.app:app # 生产模式

Caddy 反向代理(HTTPS)

# /etc/caddy/Caddyfile
slb.19990419.top {
 reverse_proxy localhost:8790
}

systemctl reload caddy

环境变量

项目结构

SLB/
├── src/ # 后端源码
│ ├── app.py # Flask 入口 + 路由注册
│ ├── config.py # 环境变量配置 + 动态 LLM 配置
│ ├── api/ # API 蓝图(RESTful)
│ │ ├── auth.py # 认证(注册/登录/签到)
│ │ ├── papers.py # 试卷查询
│ │ ├── submissions.py # 提交批改
│ │ ├── phrases.py # 好词好句
│ │ ├── weak.py # 薄弱点
│ │ ├── drill.py # 题型训练
│ │ ├── diagnosis.py # 能力诊断
│ │ ├── simulation.py # 模拟考试
│ │ ├── plan.py # 备考计划
│ │ ├── topic.py # 时政热点
│ │ ├── community.py # 社区
│ │ └── admin.py # 管理后台 API
│ ├── services/ # 业务逻辑层
│ └── crawler/ # 爬虫模块
│ ├── fenbi_public.py # 粉笔公开资料下载
│ └── fenbi_tiku.py # 粉笔题库真题(需账号)
├── templates/ # 前端模板(29 个页面)
│ ├── base.html # 基础布局(导航栏 + 移动端菜单 + 返回顶部)
│ ├── index.html # 首页
│ ├── papers.html # 卷库
│ ├── exam.html # 答题页
│ ├── result.html # 批改结果
│ ├── diagnosis.html # 能力诊断
│ ├── profile.html # 个人中心(图表 + 学习数据)
│ ├── admin/ # 管理后台(8 个页面)
│ └── ...
├── static/ # 静态资源
│ ├── css/
│ │ ├── variables.css # 设计令牌(色彩/字体/间距/阴影)
│ │ ├── interactions.css # 交互动效(滚动进场/toast/焦点环)
│ │ ├── components.css # 组件库(21 个组件)
│ │ ├── main.css # 基础样式 + 布局
│ │ └── admin.css # 管理后台样式
│ └── js/
│ ├── components.js # 组件交互 + Chart.js 封装
│ ├── app.js # 全局逻辑(认证/Toast/API)
│ └── exam.js # 答题页逻辑
├── data/
│ ├── schema.sql # 建表语句
│ ├── seed_papers.sql # 试卷种子数据
│ ├── seed_phrases.sql # 好词好句种子数据
│ ├── seed_topics.sql # 时政热点种子数据
│ └── shenlun_zhenti/ # 393 套申论真题原文(Markdown)
├── scripts/ # 工具脚本
│ ├── fenbi_download.py # 粉笔资料一键下载
│ ├── scrape_shenlunhome.com # 申论之家真题爬虫
│ └── auto_update.py # 自动更新
├── DESIGN.md # 设计系统规范(Stripe 风格)
├── AGENTS.md # AI 编码代理构建指引
├── Dockerfile # Docker 镜像定义
├── docker-compose.yml # Docker Compose 编排
├── deploy.sh # 一键部署脚本
└── requirements.txt # Python 依赖

前端组件库

// Toast 通知
SLBToast.success('提交成功');
SLBToast.error('网络错误', '请重试');
// AI 批改进度条
SLBGradingProgress.start();
SLBGradingProgress.nextStep(0); // 踩点分析
SLBGradingProgress.nextStep(1); // 逻辑评估
SLBGradingProgress.finish();
// Chart.js 图表
SLBCharts.radar('canvas-id', {
 labels: ['踩点命中', '逻辑结构', '语言规范', '字数控制', '卷面整洁'],
 data: [80, 65, 72, 90, 60]
});

数据规模

粉笔数据集成

# 一键下载全部公开申论资料(无需登录,约 290MB)
python scripts/fenbi_download.py
# 下载题库真题(需粉笔账号)
python scripts/fenbi_download.py --phone 13800138000 --password xxx
# 扫描发现新目录
python scripts/fenbi_download.py --scan 40000 40100

API 接口

设计系统

License