专业论文润色与语言优化系统
示例一
修改优化后
例二
修改优化后
GPTZero 检测结果对比
无需安装任何开发环境，下载即可使用！
-
从 Releases 页面下载对应平台的可执行文件：
- Windows:
AI学术写作助手-Windows-vX.X.X.zip - macOS:
AI学术写作助手-macOS-vX.X.X.tar.gz - Linux:
AI学术写作助手-Linux-vX.X.X.tar.gz
- Windows:
-
解压到任意目录
-
首次运行会自动创建
.env配置文件模板，编辑配置文件填入：- API Key（POLISH_API_KEY、ENHANCE_API_KEY 等）
- 管理员密码（ADMIN_PASSWORD）
- JWT 密钥（SECRET_KEY）
-
再次运行程序，将自动打开浏览器
-
访问管理后台（默认用户名
admin，密码见.env）添加用户账户
💡 提示：数据库文件
ai_polish.db和配置文件.env都保存在可执行文件同目录，方便备份和迁移。
.env 配置文件包含以下重要配置项：
# 数据库配置
DATABASE_URL=sqlite:///./ai_polish.db
# 或使用 PostgreSQL: postgresql://user:password@IP/ai_polish
# Redis 配置 (用于并发控制和队列)
REDIS_URL=redis://IP:6379/0
# OpenAI API 配置
OPENAI_API_KEY=KEY
OPENAI_BASE_URL=http://IP:PORT/v1
# 第一阶段模型配置 (论文润色) - 推荐使用 gemini-2.5-pro
POLISH_MODEL=gemini-2.5-pro
POLISH_API_KEY=KEY
POLISH_BASE_URL=http://IP:PORT/v1
# 第二阶段模型配置 (原创性增强) - 推荐使用 gemini-2.5-pro
ENHANCE_MODEL=gemini-2.5-pro
ENHANCE_API_KEY=KEY
ENHANCE_BASE_URL=http://IP:PORT/v1
# 感情文章润色模型配置 - 推荐使用 gemini-2.5-pro
EMOTION_MODEL=gemini-2.5-pro
EMOTION_API_KEY=KEY
EMOTION_BASE_URL=http://IP:PORT/v1
# 并发配置
MAX_CONCURRENT_USERS=7
MAX_CONCURRENT_PER_USER=3
# 流式输出配置（推荐保持默认值）
USE_STREAMING=false # 默认禁用，避免某些API（如Gemini）返回阻止错误
# API 请求间隔 (秒，每段落处理后等待)
API_REQUEST_INTERVAL=6
# 会话压缩配置
HISTORY_COMPRESSION_THRESHOLD=2000
COMPRESSION_MODEL=gemini-2.5-pro
COMPRESSION_API_KEY=KEY
COMPRESSION_BASE_URL=http://IP:PORT/v1
# JWT 密钥
SECRET_KEY=JWT-key
ALGORITHM=HS256
ACCESS_TOKEN_EXPIRE_MINUTES=60
USER_TOKEN_EXPIRE_HOURS=24
# 管理员账户
ADMIN_USERNAME=admin
ADMIN_PASSWORD=admin123
SEGMENT_SKIP_THRESHOLD=15注意:
- 推荐使用 Google Gemini 2.5 Pro 模型以获得更好的效果和更低的 API 费用
- BASE_URL 使用 OpenAI 兼容格式，需要配置支持 OpenAI API 格式的代理服务
- 流式输出默认禁用：为避免某些 API（如 Gemini）返回阻止错误，系统默认使用非流式模式。可在管理后台的"系统配置"中切换
- 用户界面: http://localhost:8000
- 管理后台: http://localhost:8000/admin
- API 文档: http://localhost:8000/docs
- 双阶段优化: 论文润色 + 学术增强
- 智能分段: 自动识别标题，跳过短段落
- 用户管理: 基于 JWT 的账户系统，支持管理员批量创建用户，用户间数据完全隔离
- 并发控制: 全局并发 + 每用户并发限制，支持同一用户并行提交多个任务
- 实时配置: 修改配置无需重启服务
- 数据管理: 可视化数据库管理界面
访问 http://localhost:8000/admin，使用管理员账户登录
- 📊 数据面板: 用户统计、会话分析
- 👥 用户管理: 批量创建用户（用户名+密码）、启停账户
- 📡 会话监控: 实时会话状态监控
- 💾 数据库管理: 查看、编辑、删除数据记录
- ⚙️ 系统配置: 模型配置、并发设置、用户限额
| 配置项 | 说明 | 默认值 |
|---|---|---|
MAX_CONCURRENT_USERS |
最大并发用户数 | 5 |
MAX_CONCURRENT_PER_USER |
每用户最大并发任务数 | 3 |
SEGMENT_SKIP_THRESHOLD |
段落跳过阈值（字符数） | 15 |
HISTORY_COMPRESSION_THRESHOLD |
历史压缩阈值 | 5000 |
USE_STREAMING |
启用流式输出模式 | false（推荐） |
API_REQUEST_INTERVAL |
API 请求间隔（秒） | 6 |
USER_TOKEN_EXPIRE_HOURS |
用户登录有效期（小时） | 24 |
AI_GC/
├── backend/ # FastAPI 后端
│ ├── app/
│ │ ├── routes/ # API 路由
│ │ ├── services/ # 业务逻辑
│ │ ├── models/ # 数据模型
│ │ └── utils/ # 工具函数
│ └── .env # 环境配置
├── frontend/ # React 前端
│ └── src/
│ ├── pages/ # 页面组件
│ └── components/ # 通用组件
└── README.md # 本文件
- 修改
.env中的默认管理员密码 - 生成强 SECRET_KEY (至少 32 字节随机字符串)
- 填写有效的 OPENAI_API_KEY
Q: 端口被占用？
A: 关闭其他占用 8000 端口的程序
Q: 配置修改后未生效？
A: 重启程序使配置生效
Q: 登录失败？
A: 检查 .env 中的 ADMIN_USERNAME 和 ADMIN_PASSWORD。普通用户账户需要在管理后台创建。
Q: AI 调用失败？
A: 检查 API Key 和 Base URL 配置是否正确
Q: Gemini API 返回 "Your request was blocked" 错误？
A: 这是因为 Gemini API 可能阻止流式请求。解决方法：
- 登录管理后台 (
http://localhost:8000/admin) - 进入"系统配置"标签页
- 找到"流式输出模式"开关，确保它是禁用状态（推荐）
- 点击"保存配置"按钮
- 重新运行优化任务
默认配置已经禁用了流式输出，如果仍然遇到此问题，请检查 .env 文件中的 USE_STREAMING 设置是否为 false
系统采用 JWT 认证，管理员在后台批量创建账户，普通用户使用用户名和密码登录。
- 管理员：登录后台后，在"添加用户"面板填写用户名和密码，点击"添加到列表"，可连续添加多个用户，最后点击"批量创建"一次性提交
- 普通用户：使用分配的用户名和密码登录，数据完全隔离，可同时提交多个润色任务
环境要求：Python 3.9+（直接运行） / 3.12+（构建 exe，推荐）、Node.js 18+
如果需要自行构建可执行文件，请参考 package/README.md。
# Linux/macOS
cd package
chmod +x build.sh
./build.sh
# Windows
cd package
.\build.ps1推送以 v 开头的标签会自动触发构建：
git tag v1.0.0
git push origin v1.0.0构建完成后，可在 Releases 页面下载各平台的可执行文件。
# 无 API 测试（认证、会话、并发、数据隔离 — 39 个用例）
cd package/backend && python -m pytest tests/ -k "not integration" -v
# 集成测试（需要真实 API 凭证 — 11 个用例）
BYPASS_AIGC_API_KEY=sk-xxx BYPASS_AIGC_BASE_URL=https://your-proxy/v1 \
BYPASS_AIGC_MODEL=gemini-2.5-pro \
python -m pytest tests/test_integration.py -v -sCC BY-NC-SA 4.0