← 返回
未分类 Key

wechat-file-publish

将本地文件(Markdown/HTML/TXT)一键发布到微信公众号草稿箱,支持根据文案内容动态生成配图
将本地文件(Markdown/HTML/TXT)一键发布到微信公众号草稿箱,支持根据文案内容动态生成配图
ochmdlc
未分类 community v1.0.2 3 版本 99418.6 Key: 需要
★ 0
Stars
📥 171
下载
💾 4
安装
3
版本
#latest

概述

微信公众号文件发布 Skill

功能简介

将本地 Markdown / HTML / TXT 文件一键转换为微信公众号图文消息,并发布到草稿箱。内置动态配图生成器,可根据文章标题、摘要、关键词自动匹配主题配色并生成封面图及配套插图。

触发条件

当用户提出以下意图时,使用本 skill:

  • "发布到公众号" / "发布到微信公众号"
  • "上传草稿箱" / "发布文章到草稿箱"
  • "把这篇文章发到公众号"
  • "生成公众号配图" / "生成封面图"
  • 涉及 publish.pygenerate_article_images.py 的操作

文件结构

wechat-file-publish/
├── SKILL.md                   # 本文件
├── README.md                  # 详细使用说明
├── skill.json                 # Skill 元数据
├── skill.yaml                 # Skill 定义
├── publish.py                 # 核心发布脚本
├── generate_article_images.py # 动态配图生成器
├── generate_cover_performance.py  # 封面性能优化
├── config.json                # 配置文件(需用户配置)
└── config.example.json       # 配置模板

使用流程

第一步:配置公众号凭证

首次使用必须配置 config.json,需要以下信息:

  • appId:微信公众号 AppID(在 公众号后台 → 设置 → 基本配置 中获取)
  • appSecret:微信公众号 AppSecret(同上,需重置获取)
  • defaultAuthor:默认作者名

配置方式(在 skill 目录下执行):

python publish.py config

或直接编辑 config.json

{
  "appId": "your_app_id",
  "appSecret": "your_app_secret",
  "defaultAuthor": "IT老司机Ochmd"
}

> ⚠️ IP 白名单:确保服务器 IP 已添加到微信公众号安全中心 → IP 白名单

第二步:准备文章文件

支持格式:

  • .md — Markdown 文件(推荐)
  • .html — HTML 文件
  • .txt — 纯文本文件

Markdown 文件示例:

# 文章标题

## 小标题

正文内容...

![图片描述](./images/demo.png)

- 列表项1
- 列表项2

代码块

print("Hello World")

第三步:执行发布

方式一:命令行

# 基础发布
python publish.py article.md

# 指定封面图
python publish.py article.md cover.png

方式二:对话式(通过 CodeBuddy)

发布文件到公众号
文件路径:C:/Users/xxx/article.md
封面图:C:/Users/xxx/cover.png

动态配图生成

generate_article_images.py 可根据文章内容自动生成配图,无需手动设计。

主题自动匹配

根据文章关键词自动匹配配色方案:

主题配色触发关键词
------------------------
科技蓝紫蓝紫渐变AI、技术、编程、代码、大模型
活力绿橙绿橙渐变成长、学习、进阶、团队
热情红粉红粉渐变创业、创新、未来、趋势
清新蓝绿蓝绿渐变入门、基础、教程、小白
暖阳金橙金橙渐变感悟、分享、经验、生活
极客深灰深灰渐变极客、黑客、开源、Linux

支持的图片类型

类型函数说明
------------------
covercreate_cover_image()动态封面图(900×383)
ai_toolscreate_ai_tools_image()AI工具协作示意图
multi_agentcreate_multi_agent_image()多智能体协作图
strategycreate_developer_strategy_image()开发者策略卡片图
skill_radarcreate_skill_radar_image()技能雷达图
visioncreate_future_vision_image()未来展望图

调用示例

from generate_article_images import generate_article_images

results = generate_article_images(
    title="2026年AI编程工具全面爆发",
    summary="探讨AI如何改变软件开发行业",
    keywords=["AI", "编程", "Copilot", "效率提升"],
    image_types=["cover", "ai_tools"]  # 可选,默认生成全部
)
# results = {'cover': 'path/to/cover.png', 'ai_tools': 'path/to/ai_tools.png'}

Markdown 转换规则

publish.py 内置 Markdown → HTML 转换器,支持:

Markdown 语法转换结果
-------------------------
# 标题

(居中,深色)

## 标题

### 标题

#### 标题

粗体
斜体
` 行内代码 `(灰色背景)
```代码块`
(深色背景)
!alt(自动上传到微信素材库)
- 列表项
> 引用
(左侧蓝色竖线)
---
(分隔线)
`\表格 \`(完整表格支持)

图片处理规范

要求

  • 格式:JPG / JPEG / PNG / GIF(脚本也支持 BMP / WebP 自动转换)
  • 大小:≤ 2MB(微信接口限制)
  • 封面分辨率:建议 900×383 像素,宽高比 2.35:1 或 16:9

自动处理流程

  1. 扫描 Markdown 中的本地图片路径
  2. 逐张上传到微信素材库(调用 uploadimg 接口,返回 URL)
  3. 将内容中的本地路径替换为微信 URL
  4. 如有封面图,上传为缩略图(thumb,调用 add_material 接口)

常见错误码

错误码原因解决方案
------------------------
40001Token 无效检查 AppSecret 是否正确
40125AppSecret 错误在公众号后台重置 AppSecret
40164IP 不在白名单将服务器 IP 添加到公众号 IP 白名单
41005缺少媒体文件检查图片文件路径是否正确
-1系统繁忙稍后重试

完整工作流示例

用户提供了 article.md
   ↓
读取文件内容,提取标题(H1)
   ↓
扫描本地图片 → 逐张上传到微信 → 替换 URL
   ↓
Markdown → HTML 转换
   ↓
(可选)上传封面图到素材库
   ↓
调用 draft/add API 创建草稿
   ↓
返回 media_id,发布成功 ✅

注意事项

  1. IP 白名单必须配置:微信公众号要求调用接口的服务器 IP 在白名单内
  2. Access Token 有效期 2 小时:脚本每次运行会自动获取新 Token
  3. 图片大小限制:超过 2MB 的图片会被跳过并提示
  4. Markdown 标题提取:默认提取第一个 # 标题 作为文章标题,也可通过参数指定
  5. Pillow 依赖:配图生成功能需要 pip install Pillow,若未安装则跳过配图生成

依赖安装

pip install requests pillow

更新日志

v2.0.0 (2026-04-16)

  • 重构配图生成器为 DynamicImageGenerator
  • 新增 ThemeAnalyzer 主题分析器,根据文案自动匹配主题
  • 支持 6 种主题配色方案
  • 新增 generate_article_images() 统一入口函数
  • 关键词到主题智能映射

v1.0.1 (2026-04-03)

  • 修复配图加载失败问题
  • 添加动态 MIME 类型检测
  • 新增图片验证(大小、格式)
  • 完善错误提示

v1.0.0 (2026-04-02)

  • 初始版本
  • 支持 Markdown/HTML/TXT 发布
  • 支持图片自动上传

版本历史

共 3 个版本

  • v1.0.2 Initial release 当前
    2026-05-18 21:56 安全 安全
  • v1.0.1 Initial release
    2026-04-10 10:16 安全 安全
  • v1.0.0 Initial release
    2026-04-07 11:30 安全 安全

安全检测

腾讯云安全 (Keen)

安全,无风险
查看报告

腾讯云安全 (Sanbu)

安全,无风险
查看报告

🔗 相关推荐

ai-intelligence

Self-Improving + Proactive Agent

ivangdavila
自我反思+自我批评+自我学习+自组织记忆。智能体评估自身工作、发现错误并持续改进。
★ 1,363 📥 319,089
security-compliance

Skill Vetter

spclaudehome
AI智能体技能安全预审工具。安装ClawdHub、GitHub等来源技能前,检查风险信号、权限范围及可疑模式。
★ 1,219 📥 266,904
developer-tools

Github

steipete
使用 `gh` CLI 与 GitHub 交互,通过 `gh issue`、`gh pr`、`gh run` 和 `gh api` 管理议题、PR、CI 运行及高级查询。
★ 672 📥 324,555