# wxHm

**Repository Path**: kingC/wxHm

## Basic Information

- **Project Name**: wxHm
- **Description**: 微信群二维码活码工具，生成微信群活码，随时可以切换二维码！
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-31
- **Last Updated**: 2025-12-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

---

# WeChat Group Multi-Group Live QR Code Manager

# (微信多群组活码管理系统)

这是一个基于 **Python Flask** 开发的微信群活码工具。它专为解决“微信群二维码 7 天失效”和“多群组同时运营”而设计。通过本工具，你可以为每个群生成一个**永恒不变**的访问链接，管理员只需在后台定期更新图片，无需更换前端推广链接。

---

## ✨ 核心特性

* **多群组支持**：支持同时创建和管理多个不同的群组（如：技术交流群、粉丝福利群）。
* **多码备份与轮转**：每个群组可存放多个历史二维码，系统自动识别并展示最新且有效的一张。
* **自动过期清理**：程序会自动检测图片上传时间，超过 7 天（微信限制）的旧码将被自动物理删除，保持空间整洁。
* **动态视觉引导**：前端页面内置“绿色扫描线”动画特效，增加用户交互感。
* **强制防缓存**：自动在图片 URL 后附加毫秒级随机参数，完美解决微信内置浏览器图片缓存严重的痛点。
* **极简后台**：支持密码保护，无需数据库，通过文件夹结构实现持久化存储。

---

## 📂 项目结构

```text
live_code/
├── app.py                # 后端核心逻辑
├── uploads/              # 自动生成的存储目录（按群组名划分子文件夹）
└── templates/
    ├── index.html        # 微信端用户扫码页
    └── admin.html        # 管理员上传与管理页

```

---

## 🚀 快速开始

### 1. 安装依赖

确保已安装 Python 3.x，然后运行：

```bash
pip install Flask

```

### 2. 启动服务

```bash
python app.py

```

默认会在本地 `http://127.0.0.1:8092` 运行。

### 3. 后台管理

访问 `http://你的IP:8092/admin`：

1. 输入管理密码（默认：`admin123`）。
2. 输入群组名称（如：`校友群`）。
3. 选择该群的最新二维码图片并点击上传。

### 4. 前端投放

将生成的链接投放至公众号、海报或朋友圈：
`http://你的IP:8092/group/校友群`

---

## 🛠️ 进阶配置

### 修改管理密码

在 `app.py` 中找到以下行并修改：

```python
ADMIN_PASSWORD = '你的新密码'

```

### 部署建议

* **公网访问**：建议部署在阿里云/腾讯云等服务器，并配合域名和 Nginx 反向代理。
* **免费托管**：推荐使用 **PythonAnywhere**，它支持持久化文件存储，适合存放上传的图片。
* **SSL支持**：建议开启 HTTPS，以确保二维码在微信内加载的稳定性。

---

## ⚠️ 注意事项

* **物理删除**：程序在检测到图片过期后会自动执行 `os.remove()`，请自行保留二维码原图。
* **文件权限**：确保运行程序的用户对 `uploads` 目录具有读写权限。
* **合规性**：请务必遵守微信公众平台及相关法律法规，严禁用于违规营销。

---
![alt text](a08fd05e25f1b79239ed1527ab733b4d.jpg)