# paper-helper-tool

**Repository Path**: ghostmice/paper-helper-tool

## Basic Information

- **Project Name**: paper-helper-tool
- **Description**: 论文助手工具v1.0.0
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-01
- **Last Updated**: 2025-12-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 论文辅助工具

**开发商：重庆寰宇硬核科技有限公司**

一款帮助软件开发同学写论文提效的专业工具，支持数据库三线表生成、API 测试用例自动生成、接口实际测试、性能测试、论文格式批量修改等功能。

## 快速开始

### 方式一：直接运行（推荐）
下载 `论文辅助工具.exe`，双击运行即可，无需安装任何依赖。

### 方式二：源码运行
```bash
pip install -r requirements.txt
python main.py
```

## 登录信息

- **默认密码**: `admin123`

## 功能特性

### 1. 📊 数据库三线表生成
- 导入 SQL 文件，自动解析表结构
- 生成符合论文规范的三线表格式
- 支持导出 Word、PDF、Excel 格式

### 2. 🧪 API 测试用例生成
- 支持导入 Word/Markdown 格式的系统设计文档
- 智能识别文档中的 API 接口信息
- 通过 AI 大模型自动生成测试用例
- 测试用例包含：接口API、描述、请求类型、请求体、预期响应、测试结果

### 3. 🔗 接口实际测试
- 支持导入 Swagger/OpenAPI/Knife4j 接口文档
- 配置服务器根地址（公网/本地）
- 实际调用接口进行测试
- 记录测试结果（状态码、响应时间、响应内容）
- 结合 AI 生成详细测试报告

### 4. 🚀 性能测试
- 支持并发用户数配置
- 支持爬坡时间设置
- 详细的性能统计（响应时间、吞吐量、P95/P99等）
- 生成专业的性能测试报告
- 支持导出 Word/PDF 格式报告

### 5. 📝 论文格式批量修改
- **正文格式**：字体、字号、行距、段落间距、首行缩进
- **表格格式**：水平/垂直居中、表格位置、行距
- **标题格式**：各级标题字体、字号、对齐方式
- **批量更新**：表格/图片编号
- **域更新**：目录、交叉引用等
- 数字和英文自动设置为 Times New Roman

### 6. 📄 多格式导出
- **Word**: 三线表格式，符合论文规范
- **PDF**: 直接生成 PDF 文档
- **Excel**: 便于后续编辑和管理

### 7. 🤖 AI 服务支持
- **DeepSeek**（推荐，性价比高）
- **OpenAI** (GPT-3.5/GPT-4)
- **通义千问** (阿里云)
- **智谱 AI** (GLM-4)
- **Ollama** (本地部署)

### 8. 其他功能
- 🔐 登录密码保护
- 📜 全局日志查看
- ⚙️ 配置持久化

## 使用方法

### 数据库三线表生成
1. 点击「数据库三线表」标签页
2. 点击「选择文件」导入 SQL 文件
3. 在左侧列表选择要查看的表
4. 点击导出按钮选择导出格式

### API 测试用例生成
1. 首先在「设置」页面配置 AI 服务（API Key 等）
2. 点击「API测试用例」标签页
3. 点击「选择文档」导入系统设计文档（Word/Markdown）
4. 在接口列表中勾选需要生成测试用例的接口
5. 点击「AI 生成测试用例」按钮
6. 等待生成完成后，导出为所需格式

### 接口实际测试
1. 点击「接口测试」标签页
2. 配置服务器地址（如 http://localhost:8080）
3. 导入 Swagger JSON 文档或手动添加接口
4. 选择要测试的接口
5. 点击「运行测试」
6. 查看测试结果并导出

### 性能测试
1. 点击「性能测试」标签页
2. 配置服务器地址
3. 添加要测试的接口
4. 设置并发用户数和请求次数
5. 点击「开始测试」
6. 查看测试报告并导出

### 论文格式批量修改
1. 点击「论文格式」标签页
2. 添加要处理的 Word 文档
3. 配置正文、表格、标题格式
4. 选择预设（论文标准格式/期刊格式）或自定义
5. 点击「应用格式」

## 项目结构

```
tools/
├── main.py                    # 程序入口
├── requirements.txt           # 依赖管理
├── README.md                  # 说明文档
├── core/                      # 核心功能模块
│   ├── sql_parser.py          # SQL 解析器
│   ├── doc_parser.py          # 文档解析器（Word/Markdown）
│   ├── api_extractor.py       # API 接口提取器
│   ├── api_tester.py          # 接口测试器
│   ├── performance_tester.py  # 性能测试器
│   ├── word_formatter.py      # Word 格式化器
│   ├── ai_service.py          # AI 大模型服务
│   ├── testcase_generator.py  # 测试用例生成器
│   └── logger.py              # 日志模块
├── ui/                        # UI 模块
│   ├── main_window.py         # 主窗口
│   ├── login_dialog.py        # 登录对话框
│   ├── db_table_widget.py     # 数据库三线表功能页
│   ├── api_testcase_widget.py # API测试用例生成页
│   ├── api_test_widget.py     # 接口测试页
│   ├── performance_widget.py  # 性能测试页
│   ├── format_widget.py       # 论文格式修改页
│   ├── log_widget.py          # 日志查看页
│   └── settings_widget.py     # 设置页
└── export/                    # 导出模块
    ├── word_exporter.py       # Word 导出
    ├── pdf_exporter.py        # PDF 导出
    └── excel_exporter.py      # Excel 导出
```

## AI 服务配置

### DeepSeek（推荐）
- API Key: 从 [DeepSeek](https://platform.deepseek.com/) 获取
- 模型: deepseek-chat, deepseek-coder

### OpenAI
- API Key: 从 [OpenAI](https://platform.openai.com/) 获取
- 模型: gpt-3.5-turbo, gpt-4, gpt-4-turbo

### 通义千问
- API Key: 从 [阿里云](https://dashscope.console.aliyun.com/) 获取
- 模型: qwen-turbo, qwen-plus, qwen-max

### 智谱 AI
- API Key: 从 [智谱 AI](https://open.bigmodel.cn/) 获取
- 模型: glm-4, glm-4-flash, glm-3-turbo

### Ollama (本地)
- 无需 API Key
- 需要先安装并运行 [Ollama](https://ollama.ai/)
- 模型: llama3, qwen2, mistral 等

## 更新日志

### v1.0.0 (2025-12-01)
- 🎉 初始版本发布
- 📊 数据库三线表生成
- 🧪 AI 测试用例生成
- 🔗 接口实际测试（Swagger/Knife4j）
- 🚀 性能测试与报告
- 📝 论文格式批量修改
- 📄 Word/PDF/Excel 多格式导出
- 🤖 多种 AI 服务支持（DeepSeek/OpenAI/通义千问/智谱AI/Ollama）
- 🔐 登录密码保护
- 📜 全局日志记录
- 📦 支持打包为独立 exe 运行

## 技术支持

如有问题或建议，请联系开发商。

## License

© 2025 重庆寰宇硬核科技有限公司 版权所有