个人版一文多发工具 — 微信公众号 + 小红书

写一篇 Markdown，同时发布到微信公众号和小红书。微信端通过 wenyan-cli 渲染精美排版，小红书端自动适配短文案 + 图片格式。无需依赖第三方 SaaS 平台，数据完全自主可控。

> 集成 ClawHub hi-yu/xhs v1.2.5 小红书 Skill 能力

支持平台

Agent 人格标识

本 Skill 遵循 SoulHub Agent 规范，包含完整的人格身份定义：

> 核心人格: ✍️ 一文多发助手 — 独立自主的内容发行人，一篇 Markdown 同时覆盖微信和小红书。极简高效、数据自主、一键搞定。

与 agent-publisher 的区别

Prerequisites

微信公众号（必需）

1. Node.js >= 18（用于运行 wenyan-cli）
2. Python >= 3.10（用于辅助脚本）
3. 一台有固定公网 IP 的服务器（用作微信 API IP 白名单代理）
4. 微信公众号 的 AppID 和 AppSecret

小红书（可选，启用一文多发）

5. Python playwright — pip install playwright && playwright install chromium
6. 小红书账号 — 通过扫码登录
7. 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

如果用户还没有微信公众号凭证：

1. 登录 微信开发者平台
2. 进入 "我的业务与服务" → "公众号" → "基础信息"
3. 复制 AppID
4. 点击 AppSecret 旁的 "重置" 生成新密钥（⚠️ 仅显示一次，立即保存！）

Step 4: 配置 IP 白名单

有两种模式，根据用户情况选择：

模式 A: 本地模式（有固定公网 IP）

如果你的本地网络有固定公网 IP：
1. 获取你的公网 IP：curl ifconfig.me
2. 在微信开发者平台 → "API IP白名单" → 点击 "编辑" → 添加你的 IP

模式 B: Server 模式（推荐，无固定 IP 时使用）

在你的云服务器上部署 wenyan server 作为代理：

python3 {baseDir}/scripts/wechat_publish.py setup-server --host your_server_ip

这会指导你：
1. 在服务器上安装 wenyan-cli 并启动 wenyan serve
2. 将服务器公网 IP 加入微信白名单
3. 配置本地 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

微信公众号

小红书

Typical Workflow

首次使用

1. 安装 wenyan-cli → npm install -g @wenyan-md/cli
2. 安装 playwright → pip install playwright && playwright install chromium
3. 环境检查 → wechat_publish.py check + xhs_publish.py check
4. 配置微信白名单 → 本地模式或 setup-server Server 模式
5. 登录小红书 → xhs_publish.py login（扫码登录）
6. 写文章 → 用 Markdown 编写，添加 frontmatter（title、cover、tags）
7. 预览 → wechat_publish.py render + xhs_publish.py adapt（分别查看两端效果）
8. 一文多发 → wechat_publish.py publish + xhs_publish.py publish
9. 登录公众号后台 → 检查草稿箱，点击发布
10. 发布后校验 → 在 搜狗微信搜索 搜索文章标题，确认文章已被收录

日常使用（一文多发）

1. 写 Markdown → 任意编辑器
2. 发布微信 → wechat_publish.py publish article.md
3. 发布小红书 → xhs_publish.py publish article.md
4. 去公众号后台发布 → 检查、发布
5. 发布后校验 → 去 搜狗微信搜索 搜索文章标题，确认可被搜到

AI 辅助写作 + 一文多发

1. 让 AI 生成 Markdown 内容 → 包含 frontmatter（title、cover、tags）
2. 预览两端效果 → render 看微信排版 + adapt 看小红书适配
3. 修改调整 → 可让 AI 继续修改
4. 一键多发 → 先 wechat_publish.py publish，再 xhs_publish.py publish
5. 发布后校验 → 用户确认在公众号后台发布后，去 搜狗微信搜索 搜索验证

Markdown 文件格式

每篇文章的 Markdown 文件顶部必须包含 frontmatter：

---
title: 文章标题（必填）
cover: 封面图路径或URL（可选，推荐）
author: 作者名（可选）
source_url: 原文链接（可选）
tags: 标签1, 标签2, 标签3（可选，用于小红书话题标签）
---

小红书内容适配规则

Markdown 发布到小红书时会自动适配：

图片支持

• 本地图片：![alt](./images/photo.jpg) — 自动上传到微信图床
• 网络图片：![alt](https://example.com/photo.jpg) — 自动下载并上传
• 封面图：在 frontmatter 的 cover 字段指定

发布后校验

当用户告知草稿已在公众号后台正式发布后，需要进行最后一步校验：

1. 打开 搜狗微信搜索
2. 搜索文章标题或公众号名称
3. 确认文章能被搜索到

> 注意：文章从发布到被搜狗收录通常需要一段时间（几小时到一天不等）。如果刚发布就搜不到，可以稍后再试。

这一步是整个发布流程的最终校验，确保文章不仅进入了草稿箱、在公众号后台发布成功，还能被外部搜索引擎正常索引和检索。

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 模式先预览，确认无误后再正式发布