WeHot Helper - 微热小助手

项目简介

WeHot Helper 是一款轻量级、带可视化前后端的公众号自动发文系统，专为个人及中小团队公众号运营设计。系统可定时采集网络高热度热点 / 科技资讯，基于无版权 API 自动匹配配图，并通过微信官方 API 实现图文内容的全自动发布，全程可视化配置，无需编写代码，无需人工干预，7×24 小时稳定运行。

功能特性

可视化配置中心：网页端一键配置公众号密钥、定时时间、热点筛选规则，所有配置实时生效，无需修改代码
精准热点采集：实时采集今日头条高热度热点，支持采集数量、热度阈值自定义筛选
智能无版权配图：基于 Pixabay API 自动匹配热点相关配图，所有图片支持商用，无版权纠纷
官方接口发布：全程调用微信公众号官方 API，无第三方中转，从根本上避免封号风险
动态定时任务：网页端直接修改定时发文时间，即时生效，无需重启服务
实时日志系统：所有操作（采集/配图/发布/报错）均记录到日志，网页端 5 秒自动刷新
配置持久化：所有配置自动保存到本地 JSON 文件，服务重启后配置不丢失
轻量易部署：无需数据库，单文件核心程序，本地/服务器均可运行
平台扩展中：后续会逐步支持其他平台自动发送，有问题欢迎提 issue

技术栈

模块	技术/库	核心优势
后端框架	FastAPI + Uvicorn	高性能异步框架，自动生成接口文档
前端页面	Jinja2 + Bootstrap 5	无需打包工具，CDN 直引资源，响应式布局
定时调度	APScheduler	支持动态增删改定时任务，适配 FastAPI 异步环境
配置存储	JSON 文件	无需数据库，轻量易迁移
公众号对接	wechatpy	完美封装微信公众号所有 API，自动处理 Token 刷新
网络请求	requests	轻量稳定，支持超时/异常捕获
时区处理	pytz	精准处理北京时间，避免定时任务时区偏差

快速开始

前置准备

公众号配置：需拥有认证后的公众号（服务号/订阅号均可），在微信公众号后台「设置与开发→基本配置」获取 AppID 和 AppSecret
Pixabay API Key：在 Pixabay API 官方页面免费注册账号，获取 API Key
运行环境：安装 Python 3.8+（推荐 3.9/3.10）

环境搭建


# 1. 克隆项目
git clone https://github.com/your-username/WeHotHelper.git
cd WeHotHelper

# 2. 安装依赖
pip install -r requirements.txt

启动服务


# 进入核心程序目录
cd app

# 启动后端服务
python main.py

服务启动成功后，打开浏览器访问 http://localhost:8000 即可进入可视化配置页面。

快速使用步骤

配置填写：访问 http://localhost:8000，填写公众号 AppID/Secret、Pixabay API Key
定时开启：设置定时发文时间，勾选「开启定时任务」，点击「保存配置并应用」
功能测试：点击「立即测试发布」，访问 http://localhost:8000/log 查看日志验证流程
正式运行：测试正常后，修改为目标定时时间，保持服务运行即可

项目结构


cloudWeHot/
├── app/                          # 核心程序目录
│   ├── main.py                  # 应用入口文件
│   ├── config/                  # 配置模块
│   │   ├── __init__.py
│   │   └── database.py          # 数据库配置和操作
│   ├── routes/                  # 路由模块
│   │   ├── __init__.py
│   │   ├── admin.py             # 管理员相关路由
│   │   ├── articles.py          # 文章管理路由
│   │   ├── auth.py              # 认证相关路由
│   │   └── dashboard.py         # 仪表板路由
│   ├── services/                # 业务服务层
│   │   ├── __init__.py
│   │   ├── ai_content.py        # AI内容生成服务
│   │   ├── content_filter.py    # 内容过滤服务（违禁词检测）
│   │   ├── email.py             # 邮件服务
│   │   ├── geetest.py           # 极验验证服务
│   │   ├── hotspot.py           # 热点采集服务
│   │   ├── publish.py           # 发布服务
│   │   ├── scheduler.py         # 定时任务调度
│   │   ├── verification.py      # 验证码服务
│   │   └── wechat.py            # 微信公众号服务
│   ├── templates/               # 前端模板目录
│   │   ├── base.html            # 基础模板
│   │   ├── admin/               # 管理员页面
│   │   │   ├── settings.html    # 系统设置页面
│   │   │   └── users.html       # 用户管理页面
│   │   ├── dashboard/           # 仪表板页面
│   │   │   ├── index.html       # 主配置页面
│   │   │   ├── ai_models.html   # AI模型管理
│   │   │   ├── articles.html    # 文章管理
│   │   │   └── log.html         # 日志查看
│   │   └── public/              # 公共页面
│   │       ├── landing.html     # 首页
│   │       ├── login.html       # 登录页面
│   │       ├── register.html    # 注册页面
│   │       └── install.html     # 安装向导
│   ├── static/                  # 静态资源目录
│   ├── models/                  # 数据模型
│   ├── utils/                   # 工具函数
│   ├── wehot.db                 # SQLite数据库文件
│   └── app.log                  # 应用日志文件
├── docs/                        # 文档目录
│   ├── architecture.md          # 架构设计文档
│   └── database.md              # 数据库设计文档
├── README.md                    # 项目说明文档
├── LICENSE                      # MIT开源许可证
├── requirements.txt             # 项目依赖清单
└── .gitignore                   # Git忽略文件配置