微信公众号发布工具

微信公众号发布工具 - 安全版 v2.8，支持 Knowledge-Base 主题、分步流程、一键发布，优化表格和 Markdown 渲染

Security Scan

The skill appears to implement a WeChat public-account publisher and the code matches that purpose, but the package/registry metadata does not declare the sensitive environment variables the runtime clearly requires and there are a few minor inconsistencies you should review before installing.

Purpose & Capability

The skill's name, README and runtime files clearly implement publishing to WeChat (WX_APPID/WX_SECRET, token handling, upload/publish flows). However the registry metadata lists no required environment variables or primary credential while the code and SKILL.md require WX_APPID and WX_SECRET — this mismatch is incoherent and should be corrected or explained by the author.

Instruction Scope

SKILL.md and the bundled Python implement the expected steps (md→html, fix, cover, publish). Instructions ask users to set WX_APPID/WX_SECRET via environment or .env, to clone the GitHub repo, and offer commands to run. The runtime caches tokens to /tmp/wechat_token.json and loads a local .env file into os.environ — these behaviors are expected for a publisher but you should be aware they store credentials locally and may persist environment changes if you follow the suggested ~/.bashrc approach.

Install Mechanism

There is no formal install spec (instruction-only skill), but multiple Python source files and a package.json are included. The code depends only on requests (declared in package.json). No downloads from untrusted URLs or archive extraction were observed in the provided files; installation relies on cloning the GitHub repo or using ClawHub as documented.

Credentials

Requesting WX_APPID and WX_SECRET is proportionate to a WeChat publisher. The concern is metadata omission: the skill metadata/registry does not declare these required environment variables or a primary credential while SKILL.md and the code require them and will exit if missing. That discrepancy reduces transparency about what secrets the skill needs.

Persistence & Privilege

The skill does not request elevated platform privileges (always:false). It caches the access token to /tmp/wechat_token.json and suggests adding env vars to ~/.bashrc or .env (user action). These are normal for CLI utilities; there is no evidence the skill attempts to modify other skills or system-wide configuration.

What to consider before installing

What to consider before installing: - The tool legitimately needs your WeChat credentials (WX_APPID and WX_SECRET). Do not paste them into public places; prefer a .env file with chmod 600 or a secrets manager. The registry metadata did not declare these env vars — treat that as a transparency issue and ask the author to fix it. - The code caches tokens to /tmp/wechat_token.json; review that file if you run the tool and remove it if you rotate credentials. - SKILL.md suggests adding exports to ~/.bashrc which makes credentials persistent — avoid that if you don't want long-lived secrets in your shell profile. Use a secured .env or ephemeral environment variables instead. - Review the included Python files (wechat_mp_xk.py and others) yourself or run them in an isolated environment (container or VM) before providing real credentials. Check network endpoints used by the code (the token endpoint in the file is 'https://api.weixin.qq.com/cgi-bin/stable_token' — verify this is an expected/official endpoint for your account flow). - If you need higher assurance, ask the publisher to update the registry metadata to list required env vars and provide a provenance link (official homepage/repository) and sign or checksum releases.

微信公众号发布工具 - 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       # 测试用例

⚠️ 注意事项

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
作者： 九章快手团队