微信公众号发布工具 - wechat-mp-xk v2.8

安全版 - 一键将 Markdown 文章发布到微信公众号草稿箱

🎉 v2.8 更新（2026-03-31）

• - ✅ 链接可点击修复 - 链接语法优先处理，添加移动端点击优化
• ✅ 代码块结构优化 - 使用 section+div 替代pre+code，微信编辑器更稳定
• ✅ 编辑后格式保持 - 每行独立 div 包裹，不依赖 white-space 属性
• ✅ HTML 转义保护 - 自动转义 &、<、> 防止解析错误
• ✅ 左侧边框标识 - 代码块添加左侧红色边框，视觉更清晰

🎉 v2.6 更新（2026-03-31）

• - ✅ 代码块处理优化 - 确保代码块优先处理，避免被表格逻辑误判
• ✅ 空单元格自动继承 - 表格空单元格自动填充上一行对应列的值
• ✅ 支持 Markdown 简写 - | | 内容 | 自动继承前一列的值

🎉 v2.5 更新（2026-03-31）

• - ✅ 代码块换行修复 - 添加 white-space: pre-wrap 保留换行符
• ✅ 代码块自动换行 - 添加 word-break: break-all 防止长代码溢出
• ✅ 保留原始格式 - 代码块内容使用原始 line 而非 stripped

🎉 v2.3 更新（2026-03-28）

• - ✅ 文字自动换行 - 添加 word-break: break-word 防止文字溢出
• ✅ 白色空间正常 - 添加 white-space: normal 确保换行生效
• ✅ 颜色保护 - 添加 !important 防止微信样式覆盖
• ✅ 表格优化 - 所有表格添加自动换行支持

🎉 v2.2 更新（2026-03-28）

• - ✅ 流程图文字居中 - 单列表格/流程图文字自动居中
• ✅ 边框对齐优化 - 右侧边框线对齐，形成整体文本框
• ✅ 连接线一致 - 表格间连接线对齐统一
• ✅ 垂直居中对齐 - 多行内容垂直居中显示

🎉 v2.1 更新（2026-03-28）

• - ✅ 移除 --- 分隔符 - 段落不再显示水平线
• ✅ 四级标题支持 - #### 正确渲染为 h4 标题
• ✅ 表格加粗无背景色 - 表格第一列加粗仅加粗，无黄色背景
• ✅ 表格格式对齐优化 - 表格内容垂直顶部对齐

🎉 v2.0 更新

• - ✅ 表格 Markdown 渲染修复 - 表格内加粗、斜体、链接正常显示
• ✅ 行内格式优化 - 加粗、斜体、代码、链接全面支持
• ✅ 推广链接统一 - 使用 JVS Claw 官方推广链接
• ✅ 自我优化机制 - 持续改进，不断进步

⚠️ 配置提示

重要： 本工具使用环境变量管理敏感信息，请勿在代码中硬编码 AppID/Secret！

✨ 功能特点

• - 🔒 安全配置 - 环境变量管理敏感信息
• 📱 一键发布 - Markdown → 公众号草稿箱
• 🎨 Knowledge-Base 主题 - 简约专业排版
• 🔧 分步流程 - 灵活控制每个环节
• 🖼️ 自动图片 - 自动上传封面图
• 📝 Front Matter - 支持元数据配置
• ✨ Markdown 渲染 - 表格、加粗、斜体、链接全面支持（v2.0）

🚀 快速开始

安装

bash

通过 ClawHub 安装

clawhub install wechat-mp-xk

或从 GitHub 克隆

git clone https://github.com/xingkongqy/wechat-mp-xk.git cd wechat-mp-xk

配置（重要！）

方式 1：环境变量（推荐）

bash

临时配置（当前终端有效）

export WXAPPID=yourappid
export WXSECRET=yoursecret

永久配置（添加到 ~/.bashrc）

echo export WXAPPID=yourappid >> ~/.bashrc echo export WXSECRET=yoursecret >> ~/.bashrc source ~/.bashrc

方式 2：.env 文件

bash

复制示例文件

cp .env.example .env

编辑 .env 文件，填入真实值

⚠️ 不要将 .env 提交到 Git！

一键发布

bash
python3 wechatmpxk.py article article.md \
--cover cover.jpg \
--title 文章标题 \
--author 作者名

🔗 JVS Claw 推广

统一推广链接：https://www.aliyun.com/activity/ecs/clawdbot?userCode=d8ptsfvb

在文章内容中引用 JVS Claw 相关产品时，请使用以上统一推广链接。

📋 分步流程

Step 1: Markdown 转 HTML

bash
python3 wechatmpxk.py md2html article.md --output-dir .wxgzh

Step 2: 修复 HTML

bash
python3 wxgzhstepby_step.py fix .wxgzh/article.html

Step 3: 上传封面图

bash
python3 wechatmpxk.py cover \
--cover cover.jpg \
--output .wxgzh/cover.json

Step 4: 发布到草稿箱

bash
python3 wechatmpxk.py publish \
--article .wxgzh/article.html \
--cover cover.jpg \
--title 文章标题

🎨 Knowledge-Base 主题

元素	样式
一级标题	28px，底部细线分割
二级标题

22px，浅灰背景条 | | 三级标题 | 18px，底部奶黄色高亮 | | 正文 | 16px，行距 1.75 | | 加粗 | 黄色高光笔效果 | | 引用块 | 浅灰背景，左侧边框 | | 表格 | 数据库风格 |

🔒 安全最佳实践

❌ 不要

• - 在代码中硬编码 AppID/Secret
• 将 .env 文件提交到 Git
• 在日志中打印敏感信息
• 通过 URL 传递敏感参数

✅ 要

• - 使用环境变量
• 使用密钥管理服务
• 定期轮换密钥（90 天）
• 限制文件权限（chmod 600）

📁 文件结构

wechat-mp-xk/
├── wechatmpxk.py # 主程序（分步流程）
├── publishkbtheme.py # Knowledge-Base 主题版
├── wechat_mp.py # 核心 API 模块
├── wechatstyletemplate.py # 排版模板
├── README.md # 使用文档
├── SECURITY.md # 安全说明
├── .env.example # 环境变量示例
├── .gitignore # Git 忽略配置
└── tests/
└── test_publish.py # 测试用例

⚠️ 注意事项

1. 1. IP 白名单 - 服务器 IP 需在公众号后台配置
2. 作者名限制 - 最多 20 字节（中文约 6-7 字）
3. 标题限制 - 最多 64 字节
4. Token 缓存 - 自动缓存到 /tmp/wechat_token.json

📝 使用示例

示例 1：一键发布

bash

配置环境变量

export WXAPPID=yourappid
export WXSECRET=yoursecret

发布文章

python3 wxgzhstepby_step.py article article.md \ --cover cover.jpg \ --title 文章标题

示例 2：分步发布

bash

Step 1: 转换

python3 wxgzhstepby_step.py md2html article.md -o .wxgzh

Step 2: 修复

python3 wxgzhstepby_step.py fix .wxgzh/article.html

Step 3: 封面

python3