| name | wechat-publisher-personal |
| description | Personal Multi-Platform Publisher — 一文多发工具，将 Markdown 文章同时发布到内容运营平台和社交内容平台。微信端通过 wenyan-cli + 自建服务器代理，社交内容平台端通过浏览器自动化。 |
| metadata | {"openclaw":{"emoji":"✍️","requires":{"bins":["node","npx","python3"]},"primaryEnv":"WECHAT_APP_ID"}} |
个人版一文多发工具 — 内容运营平台 + 社交内容平台
写一篇 Markdown，同时发布到内容运营平台和社交内容平台。微信端通过 wenyan-cli 渲染精美排版，社交内容平台端自动适配短文案 + 图片格式。无需依赖第三方 SaaS 平台，数据完全自主可控。
集成 ClawHub hi-yu/xhs v1.2.5 社交内容平台 Skill 能力
支持平台
| 平台 | 发布方式 | 内容格式 |
|---|
| 📱 内容运营平台 | wenyan-cli + 微信 API → 草稿箱 | 长文章 + 精美排版 |
| 📕 社交内容平台 (RedNote) | Playwright 浏览器自动化 → 直接发布 | 短笔记 + 图片 + 话题标签 |
Agent 人格标识
本 Skill 遵循 SoulHub Agent 规范，包含完整的人格身份定义：
核心人格: ✍️ 一文多发助手 — 独立自主的内容发行人，一篇 Markdown 同时覆盖微信和社交内容平台。极简高效、数据自主、一键搞定。
与 agent-publisher 的区别
| 特性 | agent-publisher (SaaS版) | wechat-publisher-personal (个人版) |
|---|
| 部署方式 | 使用共享后端服务 | 用户自己的服务器 |
| 数据存储 | 存在后端数据库 | 本地文件 + 微信平台 |
| 用户管理 | 多用户、邮箱注册 | 单用户、直接使用 |
| AI 生成 | 内置 AI Agent 生成内容 | 用户自己写内容或由 AI 辅助编写 |
| 依赖 | Python + 后端 API | Node.js (wenyan-cli) + Python 辅助脚本 |
| IP 白名单 | 使用共享服务器 IP | 用户自己服务器的公网 IP |
Prerequisites
内容运营平台（必需）
- Node.js >= 18（用于运行 wenyan-cli）
- Python >= 3.10（用于辅助脚本）
- 一台有固定公网 IP 的服务器（用作微信 API IP 白名单代理）
- 内容运营平台 的 AppID 和 AppSecret
社交内容平台（可选，启用一文多发）
- Python playwright —
pip install playwright && playwright install chromium
- 社交内容平台账号 — 通过扫码登录
- AI 封面生成（可选） — 配置
GEMINI_API_KEY / IMG_API_KEY / HUNYUAN_API_KEY 之一
快速开始
Step 1: 安装 wenyan-cli
npm install -g @wenyan-md/cli
验证安装：
wenyan --help
Step 2: 配置内容运营平台凭证
设置环境变量（推荐写入 ~/.bashrc 或 ~/.zshrc）：
export WECHAT_APP_ID="your_wechat_app_id"
export WECHAT_APP_SECRET="your_wechat_app_secret"
Step 3: 获取 AppID 和 AppSecret
如果用户还没有内容运营平台凭证：
- 登录 微信开发者平台
- 进入 "我的业务与服务" → "公众号" → "基础信息"
- 复制 AppID
- 点击 AppSecret 旁的 "重置" 生成新密钥（⚠️ 仅显示一次，立即保存！）
Step 4: 配置 IP 白名单
有两种模式，根据用户情况选择：
模式 A: 本地模式（有固定公网 IP）
如果你的本地网络有固定公网 IP：
- 获取你的公网 IP：
curl ifconfig.me
- 在微信开发者平台 → "API IP白名单" → 点击 "编辑" → 添加你的 IP
模式 B: Server 模式（推荐，无固定 IP 时使用）
在你的云服务器上部署 wenyan server 作为代理：
python3 {baseDir}/scripts/wechat_publish.py setup-server --host your_server_ip
这会指导你：
- 在服务器上安装 wenyan-cli 并启动
wenyan serve
- 将服务器公网 IP 加入微信白名单
- 配置本地 CLI 连接服务器
然后设置 server 环境变量：
export WENYAN_SERVER="http://your_server_ip:7788"
export WENYAN_API_KEY="your_api_key"
Step 5: 发布第一篇文章
准备一个 Markdown 文件，顶部包含 frontmatter：
---
title: 我的第一篇文章
cover: ./cover.jpg
author: 你的名字
---
# 正文内容
这是正文...
然后发布：
python3 {baseDir}/scripts/wechat_publish.py publish article.md
All Commands
📦 一文多发（推荐）
一条命令同时发布到微信 + 社交内容平台：
python3 {baseDir}/scripts/wechat_publish.py multi-publish article.md
社交内容平台使用草稿模式（推荐首次使用）：
python3 {baseDir}/scripts/wechat_publish.py multi-publish article.md --xhs-draft
批量一文多发：
python3 {baseDir}/scripts/wechat_publish.py multi-publish article1.md article2.md
📱 内容运营平台
发布文章
直接发布 Markdown 到内容运营平台草稿箱：
python3 {baseDir}/scripts/wechat_publish.py publish article.md
指定主题发布：
python3 {baseDir}/scripts/wechat_publish.py publish article.md --theme github
通过 Server 模式发布（本地无固定 IP 时）：
python3 {baseDir}/scripts/wechat_publish.py publish article.md --server http://your_server:7788 --api-key your_key
批量发布多篇文章：
python3 {baseDir}/scripts/wechat_publish.py publish article1.md article2.md article3.md
渲染预览
渲染 Markdown 为 HTML（不发布，仅预览）：
python3 {baseDir}/scripts/wechat_publish.py render article.md
渲染并保存到文件：
python3 {baseDir}/scripts/wechat_publish.py render article.md --output article.html
主题管理
列出所有可用主题：
python3 {baseDir}/scripts/wechat_publish.py themes
预览某个主题效果：
python3 {baseDir}/scripts/wechat_publish.py render article.md --theme elegant --output preview.html
Server 管理
检查 server 连接状态：
python3 {baseDir}/scripts/wechat_publish.py server-status
部署/配置 wenyan server（交互式引导）：
python3 {baseDir}/scripts/wechat_publish.py setup-server --host your_server_ip
配置检查
检查当前环境配置是否正确：
python3 {baseDir}/scripts/wechat_publish.py check
输出：wenyan-cli 安装状态、环境变量、IP 白名单建议、server 连接等。
社交内容平台命令
登录社交内容平台
首次使用需要扫码登录：
python3 {baseDir}/scripts/xhs_publish.py login
浏览器会自动打开，使用社交内容平台 APP 扫描二维码即可。Cookie 会自动保存，后续无需重复登录。
发布到社交内容平台
将 Markdown 文件发布为社交内容平台笔记：
python3 {baseDir}/scripts/xhs_publish.py publish article.md
草稿模式（填写内容但不自动点击发布）：
python3 {baseDir}/scripts/xhs_publish.py publish article.md --draft
无头模式（后台运行）：
python3 {baseDir}/scripts/xhs_publish.py publish article.md --headless
预览社交内容平台适配效果
查看 Markdown 转换为社交内容平台格式后的效果：
python3 {baseDir}/scripts/xhs_publish.py adapt article.md
这会显示：标题裁剪（≤20字）、正文转换、图片提取、话题标签等。
检查社交内容平台环境
python3 {baseDir}/scripts/xhs_publish.py check
一文多发命令
同时发布到微信 + 社交内容平台
一条命令，Markdown 同时发布到两个平台：
python3 {baseDir}/scripts/wechat_publish.py publish article.md
python3 {baseDir}/scripts/xhs_publish.py publish article.md
💡 内容自动适配：微信端保持完整长文排版，社交内容平台端自动转换为短笔记 + 图片 + 话题标签格式。同一篇 Markdown，两个平台各自呈现最佳形态。
Environment Variables
内容运营平台
| Variable | Description | Default |
|---|
WECHAT_APP_ID | 内容运营平台 AppID | — (必填) |
WECHAT_APP_SECRET | 内容运营平台 AppSecret | — (必填) |
WENYAN_SERVER | wenyan server URL（Server 模式） | — (可选) |
WENYAN_API_KEY | wenyan server API Key（Server 模式） | — (可选) |
WENYAN_THEME | 默认渲染主题 | github |
社交内容平台
| Variable | Description | Default |
|---|
XHS_COOKIE_FILE | 社交内容平台 Cookie 文件路径 | ~/.xhs-cookies.json |
GEMINI_API_KEY | Gemini API Key（AI 封面生成） | — (可选) |
IMG_API_KEY | 图片生成 API Key（AI 封面生成） | — (可选) |
HUNYUAN_API_KEY | 腾讯混元 API Key（AI 封面生成） | — (可选) |
Typical Workflow
首次使用
- 安装 wenyan-cli →
npm install -g @wenyan-md/cli
- 安装 playwright →
pip install playwright && playwright install chromium
- 环境检查 →
wechat_publish.py check + xhs_publish.py check
- 配置微信白名单 → 本地模式或
setup-server Server 模式
- 登录社交内容平台 →
xhs_publish.py login（扫码登录）
- 写文章 → 用 Markdown 编写，添加 frontmatter（title、cover、tags）
- 预览 →
wechat_publish.py render + xhs_publish.py adapt（分别查看两端效果）
- 一文多发 →
wechat_publish.py publish + xhs_publish.py publish
- 登录公众号后台 → 检查草稿箱，点击发布
- 发布后校验 → 在 搜狗微信搜索 搜索文章标题，确认文章已被收录
日常使用（一文多发）
- 写 Markdown → 任意编辑器
- 发布微信 →
wechat_publish.py publish article.md
- 发布社交内容平台 →
xhs_publish.py publish article.md
- 去公众号后台发布 → 检查、发布
- 发布后校验 → 去 搜狗微信搜索 搜索文章标题，确认可被搜到
AI 辅助写作 + 一文多发
- 让 AI 生成 Markdown 内容 → 包含 frontmatter（title、cover、tags）
- 预览两端效果 →
render 看微信排版 + adapt 看社交内容平台适配
- 修改调整 → 可让 AI 继续修改
- 一键多发 → 先
wechat_publish.py publish，再 xhs_publish.py publish
- 发布后校验 → 用户确认在公众号后台发布后，去 搜狗微信搜索 搜索验证
Markdown 文件格式
每篇文章的 Markdown 文件顶部必须包含 frontmatter：
---
title: 文章标题（必填）
cover: 封面图路径或URL（可选，推荐）
author: 作者名（可选）
source_url: 原文链接（可选）
tags: 标签1, 标签2, 标签3（可选，用于社交内容平台话题标签）
---
社交内容平台内容适配规则
Markdown 发布到社交内容平台时会自动适配：
| 项目 | 内容运营平台 | 社交内容平台 |
|---|
| 标题 | 完整标题 | 截取前 20 字 |
| 正文 | HTML 精美排版 | 纯文本，emoji 标注段落 |
| 图片 | 嵌入文章内 | 作为笔记图片上传 |
| 代码块 | 语法高亮 | 💻 代码片段: 文本化 |
| 链接 | 保留超链接 | 仅保留链接文字 |
| 标签 | 不使用 | frontmatter tags → #话题 |
| 长度 | 无限制 | ≤1800 字，超长自动截断 |
图片支持
- 本地图片：
 — 自动上传到微信图床
- 网络图片：
 — 自动下载并上传
- 封面图：在 frontmatter 的
cover 字段指定
发布后校验
当用户告知草稿已在公众号后台正式发布后，需要进行最后一步校验：
- 打开 搜狗微信搜索
- 搜索文章标题或公众号名称
- 确认文章能被搜索到
注意：文章从发布到被搜狗收录通常需要一段时间（几小时到一天不等）。如果刚发布就搜不到，可以稍后再试。
这一步是整个发布流程的最终校验，确保文章不仅进入了草稿箱、在公众号后台发布成功，还能被外部搜索引擎正常索引和检索。
Notes
内容运营平台
- wenyan-cli 会自动将文章中的图片上传到微信素材库
- 发布后文章进入草稿箱，需要登录公众号后台手动发布
- 封面图建议尺寸：900x383 或 2.35:1 比例
- 如果使用 Server 模式，只需在服务器上配置 IP 白名单，本地 IP 随意变动
- 支持数学公式（LaTeX）、代码高亮、链接自动转脚注等
社交内容平台
- 社交内容平台笔记必须包含至少一张图片，建议在 frontmatter 中设置
cover 字段
- 封面图建议尺寸：1080x1440（3:4 竖屏）或 1080x1080（正方形）
- 正文会自动从 Markdown 转换为社交内容平台友好的纯文本格式
- 标题限制 20 字以内，超长会自动截取
- 正文建议 1800 字以内，超长会自动截断并附加公众号引导语
- Cookie 有效期通常为 7-30 天，过期需要重新
login 扫码
- frontmatter 中的
tags 字段会自动转为社交内容平台 #话题标签
- 建议使用
--draft 模式先预览，确认无误后再正式发布
