微信公众号发布工具 - 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）
🚀 快速开始
安装
# 通过 ClawHub 安装
clawhub install wechat-mp-xk
# 或从 GitHub 克隆
git clone https://github.com/xingkongqy/wechat-mp-xk.git
cd wechat-mp-xk
配置（重要！）
方式 1：环境变量（推荐）
# 临时配置（当前终端有效）
export WX_APPID="your_appid"
export WX_SECRET="your_secret"
# 永久配置（添加到 ~/.bashrc）
echo 'export WX_APPID="your_appid"' >> ~/.bashrc
echo 'export WX_SECRET="your_secret"' >> ~/.bashrc
source ~/.bashrc
方式 2：.env 文件
# 复制示例文件
cp .env.example .env
# 编辑 .env 文件，填入真实值
# ⚠️ 不要将 .env 提交到 Git！
一键发布
python3 wechat_mp_xk.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
python3 wechat_mp_xk.py md2html article.md --output-dir .wxgzh
Step 2: 修复 HTML
python3 wxgzh_step_by_step.py fix .wxgzh/article.html
Step 3: 上传封面图
python3 wechat_mp_xk.py cover \
--cover cover.jpg \
--output .wxgzh/cover.json
Step 4: 发布到草稿箱
python3 wechat_mp_xk.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/
├── wechat_mp_xk.py # 主程序（分步流程）
├── publish_kb_theme.py # Knowledge-Base 主题版
├── wechat_mp.py # 核心 API 模块
├── wechat_style_template.py # 排版模板
├── README.md # 使用文档
├── SECURITY.md # 安全说明
├── .env.example # 环境变量示例
├── .gitignore # Git 忽略配置
└── tests/
└── test_publish.py # 测试用例
⚠️ 注意事项
- IP 白名单 - 服务器 IP 需在公众号后台配置
- 作者名限制 - 最多 20 字节（中文约 6-7 字）
- 标题限制 - 最多 64 字节
- Token 缓存 - 自动缓存到 /tmp/wechat_token.json
📝 使用示例
示例 1：一键发布
# 配置环境变量
export WX_APPID="your_appid"
export WX_SECRET="your_secret"
# 发布文章
python3 wxgzh_step_by_step.py article article.md \
--cover cover.jpg \
--title "文章标题"
示例 2：分步发布
# Step 1: 转换
python3 wxgzh_step_by_step.py md2html article.md -o .wxgzh
# Step 2: 修复
python3 wxgzh_step_by_step.py fix .wxgzh/article.html
# Step 3: 封面
python3 wxgzh_step_by_step.py cover --cover cover.jpg -o .wxgzh/cover.json
# Step 4: 发布
python3 wxgzh_step_by_step.py publish --article .wxgzh/article.html --cover cover.jpg
🧪 测试
# 运行测试
python3 -m pytest tests/
📄 License
MIT License
Copyright (c) 2026 九章快手团队
版本： v1.1.0
创建时间： 2026-03-20
作者： 九章快手团队