wind-chime/Pro_llm_correct
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
d421cf87439677c729cd6c9a2ec4a132fc307ae8
Pro_llm_correct/README.md

4.6 KiB
Raw Blame History

AI 作文批改助手 ✨

(＾▽＾)ﾉﾞ 欢迎使用 AI 作文批改助手！这是一款专为教育工作者和学生设计的智能桌面工具，能够像经验丰富的英语老师一样，自动批改手写英文作文图片，并生成专业详细的批改报告。

🎯 应用界面预览

应用界面 设置界面 批改过程 批改报告

✨ 核心特色功能

🤖 双AI引擎智能处理

  • 视觉语言模型(VLM): 专业的手写文字识别(OCR)和书写质量评估，给出精准的卷面分数
  • 大语言模型(LLM): 深度内容分析，提供专业的语法纠错和写作建议
  • 智能作文类型识别: 自动识别应用文(15分制)和读后续写(25分制)两种高考作文类型

⚙️ 极致灵活配置

  • 服务独立配置: VLM和LLM支持完全独立的API服务、密钥和模型配置
  • 评分标准可调: 书写质量"敏感度因子"自由调节，适应不同评分要求
  • Prompt模板开放: 核心批改指令完全可自定义，打造个性化批改风格

🚀 高效并发处理

  • 多线程并发引擎，支持批量处理任意数量的作文图片
  • 智能任务调度，大幅提升批改效率，节省宝贵时间
  • 实时进度显示和详细日志输出，随时掌握处理状态

🔒 企业级安全保障

  • 军事级加密算法保护API密钥，防止敏感信息泄露
  • 本地配置文件加密存储，确保账户安全无忧
  • 透明的Token使用统计，方便成本控制

📊 专业输出格式

  • Markdown源文件: 完整的批改报告，支持进一步编辑和定制
  • HTML可视化报告: 美观易读的网页格式，方便分享和查看
  • 详细错误分析: 语法错误、表达问题、修改建议一应俱全
  • 精准分数评估: 专业的评分体系，符合高考评分标准

📖 使用指南

快速开始

  1. 下载程序: 前往 Releases页面 下载最新版本
  2. 首次配置:
    • 运行程序，自动弹出设置窗口
    • 配置VLM和LLM服务的URL、API密钥和模型名称
    • 点击确定保存，密钥自动加密存储
  3. 开始批改:
    • 在主界面输入作文题目
    • 点击"选择图片"，多选需要批改的作文图片
    • 点击"开始批改"，程序自动进行并发处理
  4. 查看报告: 处理完成后，Markdown和HTML格式报告自动保存在原图片目录

输出文件说明

  • 原文件名_report.md: Markdown格式详细批改报告
  • 原文件名_report.html: HTML可视化批改报告
  • 包含: 作文内容、综合评价、亮点优点、问题建议、分数评估

🛠️ 开发者指南

环境搭建

# 1. 克隆仓库
git clone https://github.com/Eric-Terminal/Pro_llm_correct.git
cd Pro_llm_correct

# 2. 创建虚拟环境（推荐）
python3 -m venv venv
source venv/bin/activate  # Linux/Mac
# venv\Scripts\activate  # Windows

# 3. 安装依赖
pip install -r requirements.txt

# 4. 运行程序
python main.py

项目打包

# 打包为独立可执行文件
pyinstaller --noconsole --onefile main.py

# 打包好的程序在 dist/ 目录

技术架构

  • 前端: Tkinter GUI界面
  • 核心: 双AI引擎架构 (VLM + LLM)
  • 安全: cryptography加密库
  • 并发: threading + concurrent.futures
  • 输出: Markdown + HTML渲染

📝 配置说明

必需配置项

  • VlmUrl: VLM服务地址
  • VlmApiKey: VLM服务密钥（自动加密）
  • VlmModel: VLM模型名称
  • LlmUrl: LLM服务地址
  • LlmApiKey: LLM服务密钥（自动加密）
  • LlmModel: LLM模型名称

可选配置项

  • SensitivityFactor: 书写评分敏感度因子（默认1.5）
  • MaxWorkers: 最大并发数（默认4）
  • MaxRetries: 最大重试次数（默认3）
  • RetryDelay: 重试延迟秒数（默认5）
  • SaveMarkdown: 是否保存Markdown文件（默认True）
  • RenderMarkdown: 是否渲染HTML报告（默认True）

📄 开源协议

本项目采用 MIT License 开源协议。您可以自由地使用、修改和分发本软件，只需保留原始的版权声明即可。

🤝 贡献与支持

如果您在使用过程中遇到问题或有改进建议，欢迎：

由 Eric-Terminal 精心开发。希望这个工具能够帮助更多的教育工作者和学生！(｡･ω･｡)ﾉ♡

Reference in New Issue View Git Blame Copy Permalink