無料GitHub で公開

wechat-publisher-personal

Personal Multi-Platform Publisher — 一文多发工具，将 Markdown 文章同时发布到内容运营平台和社交内容平台。微信端通过 wenyan-cli + 自建服务器代理，社交内容平台端通过浏览器自动化。

TencentCloud/Octop

インストール方法を見る

含まれるファイル（7）

SKILL.md14.2 KB
IDENTITY.md2.5 KB
manifest.yaml514 B
scripts/setup_server.sh3.9 KB
scripts/wechat_publish.py32.9 KB
scripts/xhs_publish.py20.0 KB
SOUL.md2.9 KB

SKILL.md（原文）

インストールする前に、エージェントに与えられる指示の中身を確認できます。

个人版一文多发工具 — 内容运营平台 + 社交内容平台

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

集成 ClawHub hi-yu/xhs v1.2.5 社交内容平台 Skill 能力

支持平台

平台	发布方式	内容格式
📱 内容运营平台	wenyan-cli + 微信 API → 草稿箱	长文章 + 精美排版
📕 社交内容平台 (RedNote)	Playwright 浏览器自动化 → 直接发布	短笔记 + 图片 + 话题标签

Agent 人格标识

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

文件	说明
`manifest.yaml`	Agent 元数据（名称、分类、标签、版本）
`IDENTITY.md`	身份定义 — 我是谁、我的专长、工作方式
`SOUL.md`	灵魂规范 — 核心原则、行为边界、语气风格

核心人格: ✍️ 一文多发助手 — 独立自主的内容发行人，一篇 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 字，超长自动截断

图片支持

本地图片：![alt](./images/photo.jpg) — 自动上传到微信图床
网络图片：![alt](https://example.com/photo.jpg) — 自动下载并上传
封面图：在 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 模式先预览，确认无误后再正式发布

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

ログインしてレビューを書く

同じリポジトリのスキル

概要と使いどころ

akshare-data

無料

使用 akshare-cli 获取中国及全球金融市场数据（1090+ 个函数）。覆盖股票、基金、期货、债券、外汇、宏观经济、指数、期权、新闻等全领域。当用户需要以下任何一种数据时触发此 skill：股票行情、历史K线、实时报价、涨停跌停池、龙虎榜、板块资金流向、基金/ETF净值、期货行情、债券/可转债、外汇汇率、宏观经济指标（GDP/CPI/PMI）、指数数据、期权数据、财经新闻。关键词触发：akshare、股票、行情、K线、基金、期货、外汇、宏观、国债、可转债、涨停、龙虎榜、板块、资金流向、stock data、market data、financial data、A股、港股、美股。即使用户只是随口提到"看看某个股票"或"最近市场怎么样"，也应触发。

日本語の概要は準備中です。原文の説明を表示しています。