148 lines
2.7 KiB
Markdown
Executable File
148 lines
2.7 KiB
Markdown
Executable File
---
|
||
name: wechat-publisher-pro
|
||
description: 一键发布文章到微信公众号草稿箱，支持 Markdown/HTML 格式，自动美化排版、上传封面图、中文编码修复。
|
||
---
|
||
|
||
# 微信公众号自动发布技能
|
||
|
||
一键发布文章到微信公众号草稿箱，支持 Markdown/HTML 格式，自动美化排版。
|
||
|
||
## 功能特性
|
||
|
||
✅ **核心功能**
|
||
- 一键发布到草稿箱
|
||
- Markdown/HTML 自动转换
|
||
- 自动上传封面图
|
||
- 美化排版样式
|
||
- 中文编码修复（UTF-8）
|
||
|
||
✅ **技术优势**
|
||
- 解决 Unicode 转义问题
|
||
- 支持长文章（50000 字以内）
|
||
- 自动图片压缩
|
||
|
||
## 配置
|
||
|
||
### 1. 获取微信公众号配置
|
||
|
||
登录微信公众平台：https://mp.weixin.qq.com
|
||
|
||
**路径:** 设置与开发 → 基本配置
|
||
|
||
**需要:**
|
||
- `APPID` (公众号 ID)
|
||
- `APPSECRET` (应用密钥)
|
||
|
||
### 2. 设置环境变量
|
||
|
||
```bash
|
||
WECHAT_APPID=你的 APPID
|
||
WECHAT_APPSECRET=你的 APPSECRET
|
||
```
|
||
|
||
## 使用方法
|
||
|
||
### 方式 1: 命令行发布
|
||
|
||
```bash
|
||
python scripts/wechat_publish.py \
|
||
--article "article.md" \
|
||
--cover "cover.jpg" \
|
||
--title "文章标题"
|
||
```
|
||
|
||
### 方式 2: Python 代码
|
||
|
||
```python
|
||
from wechat_publish import WeChatPublisher
|
||
|
||
publisher = WeChatPublisher(
|
||
appid="你的 APPID",
|
||
appsecret="你的 APPSECRET"
|
||
)
|
||
|
||
result = publisher.publish(
|
||
article_path="article.md",
|
||
cover_path="cover.jpg",
|
||
title="文章标题"
|
||
)
|
||
```
|
||
|
||
## 脚本说明
|
||
|
||
### wechat_publish.py
|
||
|
||
主发布脚本，支持多种选项：
|
||
|
||
```bash
|
||
# 基本用法
|
||
python wechat_publish.py --article article.md --cover cover.jpg --title "标题"
|
||
|
||
# 指定摘要
|
||
python wechat_publish.py \
|
||
--article article.md \
|
||
--cover cover.jpg \
|
||
--title "标题" \
|
||
--digest "摘要"
|
||
```
|
||
|
||
## 常见问题
|
||
|
||
### Q1: Token 获取失败？
|
||
|
||
**原因:** IP 白名单未配置
|
||
|
||
**解决:**
|
||
1. 登录 mp.weixin.qq.com
|
||
2. 设置与开发 → 基本配置 → IP 白名单
|
||
3. 添加你的公网 IP
|
||
|
||
### Q2: 中文乱码？
|
||
|
||
**解决:** 脚本已自动处理 UTF-8 编码
|
||
|
||
### Q3: 图片上传失败？
|
||
|
||
**原因:** 图片格式不支持或太大
|
||
|
||
**解决:**
|
||
- 格式：JPG/PNG
|
||
- 大小：<10MB
|
||
- 尺寸：建议 1200x630px
|
||
|
||
## 最佳实践
|
||
|
||
### 封面图选择
|
||
|
||
- **尺寸:** 1200x630px (2.35:1)
|
||
- **格式:** JPG/PNG
|
||
- **大小:** <10MB
|
||
|
||
### 发布时间
|
||
|
||
**最佳时间:**
|
||
- 工作日：20:00-22:00
|
||
- 周末：10:00-12:00
|
||
|
||
## 更新日志
|
||
|
||
### v3.1.2 (2026-03-13)
|
||
- ✅ 精简代码，减少 token 使用
|
||
- ✅ 优化文件结构
|
||
- ✅ 清理私人信息
|
||
|
||
### v3.1.1 (2026-03-13)
|
||
- ✅ 手机阅读优化
|
||
- ✅ 代码块优化
|
||
- ✅ 表格样式优化
|
||
|
||
### v3.1.0 (2026-03-13)
|
||
- ✅ 官网配图自动下载
|
||
- ✅ 智能过滤图片
|
||
|
||
---
|
||
|
||
*版本：v3.1.2*
|
||
*最后更新：2026-03-13*
|
||
*作者：Robotqu*
|