Update README.md

README.md

@@ -1,224 +1,28 @@
-<h1 align="center">Snap-Solver <img src="https://img.shields.io/badge/版本-1.5.1-blue" alt="版本"></h1>
-
-
-<p align="center">
-  <b>🔍 一键截屏，自动解题 - 线上考试，从未如此简单</b>
-</p>
-
-<p align="center">
-  <img src="https://img.shields.io/badge/Python-3.x-blue?logo=python" alt="Python">
-  <img src="https://img.shields.io/badge/Framework-Flask-green?logo=flask" alt="Flask">
-  <img src="https://img.shields.io/badge/AI-Multi--Model-orange" alt="AI">
-  <img src="https://img.shields.io/badge/License-Apache%202.0-lightgrey" alt="License">
-</p>
-
-
-<p align="center">
-  <a href="#-核心特性">核心特性</a> •
-  <a href="#-快速开始">快速开始</a> •
-  <a href="#-新手教程">新手教程</a> •
-  <a href="#-使用指南">使用指南</a> •
-  <a href="#-技术架构">技术架构</a> •
-  <a href="#-高级配置">高级配置</a> •
-  <a href="#-常见问题">常见问题</a> •
-  <a href="#-获取帮助">获取帮助</a>
-</p>
-
-<div align="center">
-  <a href="https://github.com/Zippland/Snap-Solver/releases">
-    <img src="https://img.shields.io/badge/⚡%20快速开始-下载最新版本-0366D6?style=for-the-badge&logo=github&logoColor=white" alt="获取Release" width="240" />
-  </a>
-  &nbsp;&nbsp;&nbsp;&nbsp;
-  <a href="docs/beginner-tutorial.md">
-    <img src="https://img.shields.io/badge/📘%20零基础入门-阅读新手教程-FF9800?style=for-the-badge&logo=bookstack&logoColor=white" alt="阅读新手教程" width="240" />
-  </a>
-  &nbsp;&nbsp;&nbsp;&nbsp;
-  <a href="mailto:zylanjian@outlook.com">
-    <img src="https://img.shields.io/badge/📞%20代部署支持-联系我们-28a745?style=for-the-badge&logo=mail.ru&logoColor=white" alt="联系我们" width="220" />
-  </a>
-</div>
-<!-- <p align="center">
-  <img src="pic.jpg" alt="Snap-Solver 截图" width="300" />
-</p> -->
-
-## 💫 项目简介
-
-**Snap-Solver** 是一个革命性的AI笔试测评工具，专为学生、考生和自学者设计。只需**按下快捷键**，即可自动截取屏幕上的任何题目，通过AI进行分析并提供详细解答。
-
-无论是复杂的数学公式、物理难题、编程问题，还是其他学科的挑战，Snap-Solver都能提供清晰、准确、有条理的解决方案，帮助您更好地理解和掌握知识点。
-
-## 📚 新手教程
-
-第一次使用？按照我们的 [《新手教程》](docs/beginner-tutorial.md) 完成环境准备、模型配置和首次解题演练，全程图文指引，几分钟即可上手。
-
-## 🔧 技术架构
-
-```mermaid
-graph TD
-    A[用户界面] --> B[Flask Web服务]
-    B --> C{API路由}
-    C --> D[截图服务]
-    C --> E[OCR识别]
-    C --> F[AI分析]
-    E --> |Mathpix API| G[文本提取]
-    F --> |模型选择| H1[OpenAI]
-    F --> |模型选择| H2[Anthropic]
-    F --> |模型选择| H3[DeepSeek]
-    F --> |模型选择| H4[Alibaba]
-    F --> |模型选择| H5[Google]
-    F --> |模型选择| H6[Doubao]
-    D --> I[Socket.IO实时通信]
-    I --> A
-```
-
-## ✨ 核心特性
-
-<table>
-  <tr>
-    <td width="50%">
-      <h3>📱 跨设备协同</h3>
-      <ul>
-        <li><b>一键截图</b>：按下快捷键，即可在移动设备上查看和分析电脑屏幕</li>
-        <li><b>局域网共享</b>：一处部署，多设备访问，提升学习效率</li>
-      </ul>
-    </td>
-    <td width="50%">
-      <h3>🧠 多模型AI支持</h3>
-      <ul>
-        <li><b>GPT 家族</b>：OpenAI强大的推理能力</li>
-        <li><b>Claude 家族</b>：Anthropic的高级理解与解释</li>
-        <li><b>DeepSeek 家族</b>：专为中文场景优化的模型</li>
-        <li><b>QVQ 和 Qwen 家族</b>：以视觉推理闻名的国产AI</li>
-        <li><b>Gemini 家族</b>：智商130的非推理AI</li>
-      </ul>
-    </td>
-  </tr>
-  <tr>
-    <td>
-      <h3>🔍 精准识别</h3>
-      <ul>
-        <li><b>OCR文字识别</b>：准确捕捉图片中的文本</li>
-        <li><b>数学公式支持</b>：通过Mathpix精确识别复杂数学符号</li>
-      </ul>
-    </td>
-    <td>
-      <h3>🌐 全球无障碍</h3>
-      <ul>
-        <li><b>VPN代理支持</b>：自定义代理设置，解决网络访问限制</li>
-        <li><b>多语言响应</b>：支持定制AI回复语言</li>
-      </ul>
-    </td>
-  </tr>
-  <tr>
-    <td>
-      <h3>💻 全平台兼容</h3>
-      <ul>
-        <li><b>桌面支持</b>：Windows、MacOS、Linux</li>
-        <li><b>移动访问</b>：手机、平板通过浏览器直接使用</li>
-      </ul>
-    </td>
-    <td>
-      <h3>⚙️ 高度可定制</h3>
-      <ul>
-        <li><b>思考深度控制</b>：调整AI的分析深度</li>
-        <li><b>自定义提示词</b>：针对特定学科优化提示</li>
-      </ul>
-    </td>
-  </tr>
-</table>
-
-## 🚀 快速开始
-
-### 📋 前置要求
-
-- Python 3.x
-- 至少以下一个API Key:
-  - OpenAI API Key
-  - Anthropic API Key (推荐✅)
-  - DeepSeek API Key
-  - Alibaba API Key （国内用户首选）
-  - Google API Key
-  - Mathpix API Key (推荐OCR识别✅)
-
-### 📥 开始使用
-
-```bash
-# 启动应用
-python app.py
-```
-
-### 📱 访问方式
-
-- **本机访问**：打开浏览器，访问 http://localhost:5000
-- **局域网设备访问**：在同一网络的任何设备上访问 `http://[电脑IP]:5000`
-
-### 🎯 使用场景示例
-
-- **课后习题**：截取教材或作业中的难题，获取步骤详解
-- **编程调试**：截取代码错误信息，获取修复建议
-- **考试复习**：分析错题并理解解题思路
-- **文献研究**：截取复杂论文段落，获取简化解释
-
-### 🧩 组件详情
-
-- **前端**：响应式HTML/CSS/JS界面，支持移动设备
-- **后端**：Flask + SocketIO，提供RESTful API和WebSocket
-- **AI接口**：多模型支持，统一接口标准
-- **图像处理**：高效的截图和裁剪功能
-
-## ⚙️ 高级可调参数
-
-- **温度**：调整回答的创造性与确定性（0.1-1.0）
-- **最大输出Token**：控制回答长度
-- **推理深度**：标准模式（快速）或深度思考（详细）
-- **思考预算占比**：平衡思考过程与最终答案的详细程度
-- **系统提示词**：自定义AI的基础行为与专业领域
-
-## ❓ 常见问题
-
-<details>
-<summary><b>如何获得最佳识别效果？</b></summary>
-<p>
-确保截图清晰，包含完整题目和必要上下文。对于数学公式，建议使用Mathpix OCR以获得更准确的识别结果。
-</p>
-</details>
-
-<details>
-<summary><b>无法连接到服务怎么办？</b></summary>
-<p>
-1. 检查防火墙设置是否允许5000端口<br>
-2. 确认设备在同一局域网内<br>
-3. 尝试重启应用程序<br>
-4. 查看控制台日志获取错误信息
-</p>
-</details>
-
-<details>
-<summary><b>API调用失败的原因？</b></summary>
-<p>
-1. API密钥可能无效或余额不足<br>
-2. 网络连接问题，特别是国际API<br>
-3. 代理设置不正确<br>
-4. API服务可能临时不可用
-</p>
-</details>
-
-<details>
-<summary><b>如何优化AI回答质量？</b></summary>
-<p>
-1. 调整系统提示词，添加特定学科的指导<br>
-2. 根据问题复杂度选择合适的模型<br>
-3. 对于复杂题目，使用"深度思考"模式<br>
-4. 确保截取的题目包含完整信息
-</p>
-</details>
-
-## 🤝 获取帮助
-
-- **代部署服务**：如果您不擅长编程，需要代部署服务，请联系 [zylanjian@outlook.com](mailto:zylanjian@outlook.com)
-- **问题报告**：在GitHub仓库提交Issue
-- **功能建议**：欢迎通过Issue或邮件提供改进建议
-
-## 📜 开源协议
-
-本项目采用 [Apache 2.0](LICENSE) 协议。
+---
+title: Snap Solver
+emoji: 🌍
+colorFrom: yellow
+colorTo: indigo
+sdk: docker
+# 【！！！关键修正！！！】 必须添加 app_port 字段
+# Hugging Face Spaces 默认将 PORT 环境变量设置为 7860
+app_port: 7860
+pinned: false
+license: mit
+---
+
+# 🚀 Snap-Solver 部署成功
+
+这是一个基于 **Flask + SocketIO** 的 AI 测评工具。
+该服务通过 Docker 容器部署在 Hugging Face Spaces 上。
+
+**核心技术栈:**
+* **后端:** Flask + SocketIO
+* **依赖:** 见 requirements.txt
+* **AI 接口:** 多模型调用（如 OpenAI, Google Generative AI 等）
+
+**使用指南:**
+请通过浏览器访问本 Space 域名，上传截图进行解题。
+
+**注意:**
+此云端服务不具备本地截图和剪贴板功能，请在客户端（手机/电脑）完成截图后上传。