MyZero

AI 学术写作助手 — 文本润色、AIGC 降重与综合优化

中文 | English

---

📑 目录

• ✨ 特性
• 📸 界面预览
• 🚀 快速开始
• ⚙️ 配置说明
• ⌨️ 快捷键
• 📁 项目结构
• 🤝 参与贡献
• 📄 许可证

---

✨ 特性

功能	说明
✍️ 文本润色	提升语言表达与学术写作质量
🛡️ AIGC 降重	降低文本的 AI 检测率
🔄 综合优化	一键完成润色 + 降重
📊 Mermaid 图表	用 AI 生成与编辑 Mermaid 流程图/示意图
🧮 LaTeX 转换	将自然语言描述转换为 LaTeX 公式
📝 模板编辑器	自定义提示词模板
📜 历史记录	保存处理记录，支持差异对比
📂 文件上传	支持 .txt、.docx、.md、.pdf、.ppt、.pptx 及常见图片格式
💾 导出结果	复制或下载文本；Mermaid 图表导出 SVG/PNG

---

📸 界面预览

• 首页

• 最近记录

• 润色详情界面

---

🚀 快速开始

环境要求

• Python 3.10+
• Node.js 18+
• OpenAI 兼容的 API Key

1. 启动后端

cd backend
pip install -r requirements.txt
cp .env.example .env
# 编辑 .env — 填入你的 API Key 和服务商地址
python -m app.main

2. 启动前端

cd frontend
npm install
npm run dev

打开 http://localhost:5173

Windows 快捷启动

双击 start-backend.bat 和 start-frontend.bat 即可快速启动前后端服务。

---

⚙️ 配置说明

可通过应用内的「设置」页面配置，或直接编辑 backend/.env：

变量	说明	默认值
OPENAI_API_KEY	API 密钥	(必填)
OPENAI_BASE_URL	API 接口地址	https://api.openai.com/v1
OPENAI_MODEL	默认模型	gpt-3.5-turbo
POLISH_MODEL	润色专用模型	默认使用 OPENAI_MODEL
HUMANIZE_MODEL	降重专用模型	默认使用 OPENAI_MODEL

任何 OpenAI 兼容的 API 均可使用，只需修改接口地址与模型名称。

---

⌨️ 快捷键

快捷键	功能
Ctrl + Enter	提交优化
Esc	取消 / 关闭弹窗

---

📁 项目结构

点击展开

MyZero/
├── backend/
│   ├── app/
│   │   ├── main.py          # FastAPI 入口
│   │   ├── config.py        # 配置项 (pydantic-settings)
│   │   ├── database.py      # SQLAlchemy 数据库
│   │   ├── models.py        # 数据模型
│   │   ├── schemas.py       # Pydantic 校验模式
│   │   ├── routers/         # API 路由
│   │   └── services/        # 业务逻辑
│   ├── requirements.txt
│   └── .env.example
├── frontend/
│   ├── src/
│   │   ├── components/      # React 组件
│   │   ├── pages/           # 页面路由
│   │   ├── App.jsx
│   │   └── index.css
│   ├── tailwind.config.js
│   └── vite.config.js
├── assets/
│   └── logo.png
├── LICENSE
└── README.md

---

🤝 参与贡献

1. Fork 本仓库
2. 创建功能分支 (git checkout -b feature/my-feature)
3. 提交更改 (git commit -m '添加新功能')
4. 推送到分支 (git push origin feature/my-feature)
5. 发起 Pull Request

---

📄 许可证

本项目基于 GNU General Public License v3.0 开源。