README.md

metadata

title: Chat Helper
emoji: 💬
colorFrom: blue
colorTo: purple
sdk: docker
pinned: false

💬 智能聊天回复助手 (Chat Helper)

这是一个基于 SiliconFlow (硅基流动) 大模型的智能聊天辅助工具。它可以根据你选择的对象（领导、客户、同事、好朋友、普通朋友），识别聊天内容（支持截图识别或文字粘贴），并生成高情商的回复建议。

✨ 功能特点

• 多角色支持: 针对不同对象定制回复风格。
• 截图识别: 直接上传聊天截图，AI 自动分析上下文（使用 Vision 模型）。
• 移动端适配: 专为手机浏览器设计，可添加到主屏幕作为 App 使用。
• 隐私安全: API Key 存储在本地浏览器，代码开源可控。

🚀 快速开始

第一步：获取 API Key

1. 访问 SiliconFlow 官网 并注册账号。
2. 进入控制台，创建一个新的 API Key。
3. 复制这个 Key，稍后在应用中使用。

第二步：安装与运行

确保你已经安装了 Python (3.8+)。

1. 安装依赖:

   pip install -r requirements.txt
   

2. 启动服务:

   python main.py
   

   看到 Application startup complete 即表示启动成功。

第三步：在 iOS/Android 手机上使用

为了获得最佳体验，请按以下步骤操作：

1. 确保手机和电脑连接同一个 WiFi。
2. 获取电脑 IP 地址:
   • Windows: 打开终端输入 ipconfig，找到 IPv4 地址（例如 192.168.1.5）。
3. 手机访问:
   • 打开手机浏览器（Safari 或 Chrome），访问 http://<你的电脑IP>:8000 (例如 http://192.168.1.5:8000)。
4. 添加到主屏幕 (iOS 推荐):
   • 在 Safari 中，点击底部的“分享”按钮。
   • 下滑找到并点击 “添加到主屏幕”。
   • 现在，你的桌面上就有了一个类似原生 App 的图标，点击即可全屏运行，体验更好！

📱 使用指南

1. 打开应用，点击底部的 "设置 API Key"，粘贴你第一步获取的 Key。
2. 选择聊天对象（如“领导”）。
3. 方式一（推荐）: 手机截图聊天页面，点击“上传聊天截图”。
4. 方式二: 直接粘贴对方发来的文字。
5. 点击“生成回复”，AI 会提供 3 个建议。
6. 点击喜欢的回复即可自动复制，然后切换回微信/钉钉粘贴发送。

🛠️ 技术说明

• 后端: FastAPI + Python
• AI 模型:
  • 文本分析: Qwen/Qwen2.5-7B-Instruct
  • 图片分析: Qwen/Qwen2-VL-7B-Instruct
• 前端: 原生 HTML/JS (无框架依赖)