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

版本： v1.1.0
创建时间： 2026-03-20
作者： 九章快手团队