微信公众号发布工具

微信公众号发布工具 - 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 确保换行生效 ✅ 颜色保护 - 添加 !导入ant 防止微信样式覆盖 ✅ 表格优化 - 所有表格添加自动换行支持 🎉 v2.2 更新（2026-03-28） ✅ 流程图文字居中 - 单列表格/流程图文字自动居中 ✅ 边框对齐优化 - 右侧边框线对齐，形成整体文本框 ✅ 连接线一致 - 表格间连接线对齐统一 ✅ 垂直居中对齐 - 多行内容垂直居中显示 🎉 v2.1 更新（2026-03-28） ✅ 移除 --- 分隔符 - 段落不再显示水平线 ✅ 四级标题支持 - #### 正确渲染为 h4 标题 ✅ 表格加粗无背景色 - 表格第一列加粗仅加粗，无黄色背景 ✅ 表格格式对齐优化 - 表格内容垂直顶部对齐 🎉 v2.0 更新 ✅ 表格 Markdown 渲染修复 - 表格内加粗、斜体、链接正常显示 ✅ 行内格式优化 - 加粗、斜体、代码、链接全面支持 ✅ 推广链接统一 - 使用 JVS Claw 官方推广链接 ✅ 自我优化机制 - 持续改进，不断进步 ⚠️ 配置提示

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

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

# 或从 GitHub 克隆 git clone https://github.com/xingkongqy/wechat-mp-xk.git cd wechat-mp-xk

配置（重要！）

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

# 临时配置（当前终端有效） 导出 WX_应用ID="your_应用id" 导出 WX_SECRET="your_secret"

# 永久配置（添加到 ~/.bashrc） echo '导出 WX_应用ID="your_应用id"' >> ~/.bashrc echo '导出 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/clawd机器人?userCode=d8ptsfvb

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

📋 分步流程 Step 1: Markdown 转 HTML python3 wechat_mp_xk.py md2html article.md --输出-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 \ --输出 .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 加粗 黄色高光笔效果 引用块 浅灰背景，左侧边框 表格 数据库风格 🔒 安全最佳实践 ❌ 不要 在代码中硬编码 应用ID/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 字节 令牌 缓存 - 自动缓存到 /tmp/wechat_令牌.json 📝 使用示例 示例 1：一键发布 # 配置环境变量 导出 WX_应用ID="your_应用id" 导出 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 作者： 九章快手团队