wechat-mp-xk（微信 mp xk）

微信公众号发布工具 - 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 主题

🔒 安全最佳实践

❌ 不要

• 在代码中硬编码 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       # 测试用例

⚠️ 注意事项

1. IP 白名单 - 服务器 IP 需在公众号后台配置
2. 作者名限制 - 最多 20 字节（中文约 6-7 字）
3. 标题限制 - 最多 64 字节
4. 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 作者： 九章快手团队