diff --git a/README.md b/README.md index cf7e9b9..c6433db 100644 --- a/README.md +++ b/README.md @@ -1,151 +1,241 @@ -[English](README_EN.md) | 中文 +
+ 🔍 一键截屏,自动解题 - 线上考试,从未如此简单 +
-## ✨ 项目简介 +
+
+
+
+
+
++ 核心特性 • + 快速开始 • + 使用指南 • + 技术架构 • + 高级配置 • + 常见问题 • + 获取帮助 +
-### 📞 代部署支持 +
+
+
|
+ 📞 代部署支持 + 如果您不擅长编程,需要专业的代部署服务 + 请联系:zylanjian@outlook.com + |
+
+ 📱 跨设备协同+
|
+
+ 🧠 多模型AI支持+
|
+
+ 🔍 精准识别+
|
+
+ 🌐 全球无障碍+
|
+
+ 💻 全平台兼容+
|
+
+ ⚙️ 高度可定制+
|
+
+ 1️⃣ 首次配置+点击右上角⚙️设置图标,配置API密钥和首选项 + |
+
+ 2️⃣ 截图解题+点击"截图"按钮 → 裁剪题目区域 → 选择分析方式 + |
+
+ 3️⃣ 查看解答+实时查看AI分析过程和详细解答,包含思考路径 + |
+
+确保截图清晰,包含完整题目和必要上下文。对于数学公式,建议使用Mathpix OCR以获得更准确的识别结果。 +
+
+1. 检查防火墙设置是否允许5000端口
+2. 确认设备在同一局域网内
+3. 尝试重启应用程序
+4. 查看控制台日志获取错误信息
+
+1. API密钥可能无效或余额不足
+2. 网络连接问题,特别是国际API
+3. 代理设置不正确
+4. API服务可能临时不可用
+
+1. 调整系统提示词,添加特定学科的指导
+2. 根据问题复杂度选择合适的模型
+3. 对于复杂题目,使用"深度思考"模式
+4. 确保截取的题目包含完整信息
+
-
-## 🌟 Core Features
-
-- 🖼️ **One-click Screenshot**: Use a hotkey (Alt+Ctrl+S, customizable) to remotely monitor your computer screen
-- 🌐 **LAN Sharing**: Deploy once, use everywhere — all devices on the same network can access
-- 🔍 **OCR Text Recognition**: Support for Mathpix API to recognize mathematical formulas and text in images
-- 🧠 **Multiple Model Support**: Simultaneous support for GPT-4o, Claude-3.7, DeepSeek, and other AI models
-- 🔐 **VPN Proxy Support**: Customizable VPN proxy, supports users in regions with limited access to AI models
-- 🌓 **Theme Switching**: Light and dark theme support to protect your eyes
-- 💻 **Cross-Platform Support**: Works on Windows, MacOS, Linux, with mobile access through browsers
-
-## 🛠️ Technical Architecture
-
-- **Backend**: Flask + SocketIO, providing Web services and WebSocket real-time communication
-- **Frontend**: HTML + CSS + JavaScript, providing an intuitive user interface
-- **AI Interfaces**:
- - GPT-4o: OpenAI's image and text understanding model (without reasoning)
- - Claude-3.7: Anthropic's advanced thinking model (includes reasoning by default)
- - DeepSeek: Alternative model support
- - Mathpix: Professional mathematical formula and text recognition service
-
-## 📋 Prerequisites
-
-1. **API Keys**:
- - [OpenAI API Key](https://openai.com) (for GPT-4o)
- - [Anthropic API Key](https://anthropic.com) (for Claude-3.7, optional)
- - [Mathpix API Key](https://mathpix.com) (for OCR text recognition, optional)
-
-2. **Running Environment**:
- - [Python](https://www.python.org/downloads/) 3.x version
- - Required Python dependencies
-
-## 🚀 Quick Start
-
-1. **Clone the project**:
- ```bash
- git clone https://github.com/zippland/Snap-Solver.git
- ```
-
-2. **Activate virtual environment**:
- ```bash
- .venv/Scripts/activate
- ```
-
-3. **Install dependencies**:
- ```bash
- pip install -r requirements.txt
- ```
-
-4. **Start the application**:
- ```bash
- python app.py
- ```
-
-5. **Access the service**:
- - Local access: Open browser, visit http://localhost:5000
- - Mobile device access: Use phones/tablets on the same LAN to visit http://[server-IP]:5000
-
-## 💡 Usage Guide
-
-### 1. First-time Setup
-
-When using for the first time, click the ⚙️ settings icon in the top right corner to configure:
-- AI model API keys (at least one required)
-- OCR recognition settings (optional)
-- Proxy settings (if needed)
-- System prompt (customizable)
-
-### 2. Screenshot-based Problem Solving
-
-1. Press the `Screenshot` button on your phone or tablet
-2. Your computer screen will automatically display on your mobile device
-3. Crop the problem area you want to solve on your mobile device
-4. Choose "Send image to AI" (direct image analysis) or "Extract text from image" (OCR then analysis)
-5. Wait for the system to process and view the detailed solution
-
-### 3. Text-based Problem Solving
-
-If you already have the problem text, or want to modify the recognized text:
-1. Use the "Extract text from image" feature
-2. Edit the content in the text box
-3. Click "Send text to AI" to get the solution
-
-## ⚙️ Advanced Configuration
-
-You can customize multiple parameters in the settings panel:
-
-- **AI Model**: Choose different AI models (GPT-4o, Claude-3.7, DeepSeek, etc.)
-- **Language**: Set the preferred language for AI responses
-- **Temperature**: Adjust the randomness of AI responses (lower values are more precise, higher values more creative)
-- **System Prompt**: Customize basic instructional prompts for the AI
-- **Proxy Settings**: Configure HTTP proxy for users in regions with limited access
-
-## 📞 Get Help
-
-- For bug issues: Please submit an Issue in this repository
-- For **deployment help**, contact: [zylanjian@outlook.com](mailto:zylanjian@outlook.com)
-
-## 🔧 Common Issues
-
-### 1. Screenshot function not responding?
-- Ensure the application is run with administrator privileges
-- Check if screen recording permissions have been granted
-- Confirm that the Python process is running
-
-### 2. Cannot connect to the service?
-- Check firewall settings
-- Confirm mobile devices are on the same network as the computer
-- Verify the server IP address is correct
-
-### 3. API call failed?
-- Check if API Keys are correctly set
-- Confirm network connection is normal
-- If using a proxy, check if proxy settings are correct
-
-## 🔐 Security Tips
-
-- Your API keys are stored locally and not uploaded to any server
-- Only use this service on trusted local networks
-- Regularly update the system and dependencies to ensure security
-
-## 🤝 Contribution
-
-Welcome to submit Issues and Pull Requests!
-
-1. Fork this repository
-2. Create a feature branch (`git checkout -b feature/AmazingFeature`)
-3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
-4. Push to the branch (`git push origin feature/AmazingFeature`)
-5. Submit a Pull Request
-
-## 📜 License
-
-This project is licensed under the [Apache](LICENSE) license.
-
----
-
-⭐ If this project helps you, please give it a Star! Thanks for your support!
\ No newline at end of file
diff --git a/server/instance/app.db b/server/instance/app.db
new file mode 100644
index 0000000..2ae6bb8
Binary files /dev/null and b/server/instance/app.db differ