wechat-publisher

微信公众号文章自动创作与发布工具:从选题搜索、撰写、AI 配图、排版到发布草稿箱,一条命令搞定。可作为 Claude Code / Codex / Cursor 的 Skill,也可独立命令行调用。

• 全网素材搜索:围绕话题多轮搜索、交叉验证,筛选最新案例与权威观点
• AI 写作:3000–5000 字深度长文,多种结构按题材选择,内置反 AI 味规则
• AI 配图:scripts/generate_image.py 为每章生成风格统一的手绘信息图,支持 OpenAI / Gemini 后端
• 微信排版:Markdown → 微信兼容 HTML,样式全内联,内置 15 套主题,粘贴不丢样式
• 一键发布:封面、标题、摘要、作者自动填好,直达草稿箱
• 反 AI 检测 gate:ai_score.py 5 维打分,发布前自动拦截高 AI 味稿件

作为 Skill 安装(通过 skills.sh):

npx skills add jiji262/wechat-publisher

或手动安装到 Agent 客户端(推荐软链接,更新仓库即自动生效):

git clone https://github.com/jiji262/wechat-publisher.git
cd wechat-publisher
pip install requests pyyaml

# Claude Code / Codex / OpenClaw 任选其一:
ln -s "$(pwd)" ~/.claude/skills/wechat-publisher
ln -s "$(pwd)" ~/.codex/skills/wechat-publisher
ln -s "$(pwd)" ~/.openclaw/skills/wechat-publisher

安装后重启客户端或新开会话让 skill 被发现。

复制模板并填入凭证:

cp wechat-publisher.yaml.example wechat-publisher.yaml

default: main
accounts:
  main:
    name: "我的公众号"
    app_id: "wx..."
    app_secret: "..."
    author: "作者名"

image_generation:
  generator: "baoyu-image-gen"      # 或 baoyu-danger-gemini-web(Web 登录版 Gemini)
  gemini_proxy:
    base_url: "https://generativelanguage.googleapis.com"
    api_key: "AIza..."
    image_model: "gemini-2.5-flash"

integrations:
  wechatsync_mcp_token: ""

在微信公众平台 → 设置与开发 → 基本配置 获取 AppID / AppSecret,并把 curl ifconfig.me 得到的公网 IP 加入「IP 白名单」(否则报 40164)。验证连接:

python3 scripts/wechat_api.py list-accounts

使用 /wechat-publisher 写一篇关于"大模型 Agent 最新进展"的公众号文章

Skill 自动执行 7 阶段:搜索素材 → 选结构 → 撰写 → 人味化改写 → 生成配图 → 排版转换 → AI 味自检 →发布草稿 →(可选)多平台同步。完整流程见 SKILL.md。

# 一键发布:Markdown → 草稿箱
python3 scripts/publish.py --account main --input article.md \
  --cover cover.jpg --title "标题" --digest "摘要"

# 只转排版:Markdown → 微信 HTML
python3 scripts/html_converter.py article.md --theme refined-blue -o article.html

# 单独跑 AI 味检测
python3 scripts/ai_score.py article.md --threshold 45

publish.py 会从 wechat-publisher.yaml 读 author / theme,依次做图片处理 → HTML 转换 → AI 味 gate(默认阈值 45)→ 封面上传 → 创建草稿。每个脚本 --help 查看完整参数。

内置 15 套主题(assets/themes/*.json):正文 ~15.5px、行高 ~1.85、纯 inline style、无外部依赖。打开 assets/theme-previews/index.html 可在手机宽度 frame 里并排对比、按分类筛选。

refined-blue · main 默认,AI / 产品 / 深度分析	minimal-mono · tech 默认,技术 / 工程
news-bold · 新闻 / 热点 / 速读	ink-wash · 人文 / 随笔 / 文化

新增主题:复制任意 assets/themes/*.json 改名改键即可,无需改代码。详见 assets/theme-previews/README.md。

• 文章发布到草稿箱,不会自动群发
• access_token 有效期 2 小时,脚本自动缓存与刷新
• 正文图走 uploadimg(不占素材名额),封面走 add_material(占用永久素材名额)

pip install pytest
python3 -m pytest tests/ -v

测试不依赖真实微信凭证(网络调用全部 mock),覆盖配置解析、AI 味打分与 HTML 转换安全性。

MIT