[Github] Wechatsync – 开源多平台文章同步助手

Github发现2026-09-10发布 WarpEdit

Wechatsync（文章同步助手）是一款开源免费的浏览器扩展，帮助作者把公众号或网页文章同步到知乎、掘金、CSDN 等内容平台，并自动转存正文图片。它最实用的用途，是把一篇已经写好的文章送进多个平台的草稿箱，省下反复复制、粘贴和传图的操作；各平台的标题、封面、排版和发布确认，仍应留到草稿生成后逐一检查。

先看同步到哪里

官方目前列出 29+ 平台，包括微信公众号、知乎、头条号、小红书、掘金、CSDN、B站专栏等。这个数字表示项目提供的平台适配范围，不代表每个账户、每种文章格式都已通过本文测试。文章同步助手更适合已有多个创作账户、经常分发同一篇原创内容的个人作者和技术博主。

不同目标的交付方式并不相同，尤其不要把列表中的 Hexo、Hugo 理解成已经替你完成静态站部署。

目标	使用方式	同步后的工作
知乎、掘金、CSDN 等	浏览器扩展调用目标平台的网页接口，官方默认流程为保存草稿	打开目标草稿，检查内容并确认发布
WordPress、Typecho 等自建博客	使用项目提供的对应站点接入能力	按站点配置连接，核对文章状态与图片
Hexo、Hugo	下载 Markdown 与图片 ZIP	把文件放入自己的站点工程，再执行原有构建部署流程

如果当前任务主要是调整公众号排版，可以先查看 Doocs Markdown Editor 的导航介绍；排版完成后，再考虑跨平台分发。两步分开处理，更容易定位问题发生在源稿还是目标平台的格式转换中。

安装入口要选对

普通用户从官网 https://www.wechatsync.com/ 的安装区进入即可。官方优先推荐 Chrome 网上应用店，便于获得扩展更新；不能使用商店时，也提供 ZIP 包加载方式。项目说明支持 Chrome、Edge 等 Chromium 内核浏览器，本文未核验 Firefox 或 Safari 版本。

从官网进入应用商店，核对扩展名称为“文章同步助手”；若走 ZIP 路径，使用官网当前提供的下载包。
将 ZIP 解压到固定目录，在浏览器扩展管理页打开开发者模式，选择“加载已解压的扩展程序”，选中包含扩展清单的目录。
在同一个浏览器中正常登录要同步的目标平台，再打开自己的文章页面。

官网版本与 GitHub Releases 要分开看。截至 2026 年 9 月 10 日核验，官网和 README 提供 v2.0.9，更新日期为 2026 年 3 月 24 日；GitHub Releases 最新条目仍是 2021 年的 1.0.10。安装时优先沿官网现行入口操作，不要因为旧 Release 挂在仓库中，就把它当成当前推荐扩展包。

第一次先同步一篇

项目依赖浏览器中已有的目标平台登录态。按官方说明，扩展从浏览器向各平台发送请求，不通过文章同步助手的中转服务器。这里的“本地”指执行位置和连接方式，文章及图片仍然需要传给你选择的目标平台。

Wechatsync 从浏览器登录、扩展同步到平台草稿和人工检查的流程示意 — 文章同步的基本流程示意：扩展连接目标平台，生成草稿后检查；CLI 与 MCP 入口仍依赖浏览器扩展。

准备一篇结构清楚的测试稿。包含标题、普通段落、一张图片；技术文章再加入代码块，便于发现格式兼容问题。
打开文章并选择目标。点击扩展入口，确认提取的标题、正文和封面，第一次只选一到两个已登录的平台。
执行同步并查看结果。扩展负责分发内容和上传图片。同步完成后，进入相应平台的草稿箱查找文章。
检查后再发布。核对标题层级、图片顺序、链接、代码缩进和封面；分类或其他平台必填项以目标编辑器为准。

先做小范围试投的意义，是确认你的内容格式和目标账户能正常配合。公众号里的复杂排版、特殊组件或平台专属内容，不应预期在其他编辑器中保持完全相同。项目默认草稿流程也不等于代替目标平台审核。

Markdown 与 CLI

除了直接分发，Wechatsync 还提供网页正文提取和 Markdown 下载，可以把文章与图片打包为 ZIP。对需要保留本地源稿、迁移到静态博客的作者，这条路径比复制网页富文本更便于后续编辑；提取结果仍要检查是否混入导航或遗漏正文。

已有本地 Markdown 稿件的用户，可以使用官方 CLI。它不是一个脱离浏览器运行的发布器：CLI 通过 WebSocket 连接扩展，由扩展执行平台请求，浏览器和相关登录态仍是前置条件。

npm install -g @wechatsync/cli
wechatsync platforms --auth
wechatsync sync article.md --dry-run
wechatsync sync article.md -p zhihu,juejin

运行前，先在扩展设置中启用 MCP 连接或同步桥接，并配置与扩展一致的 WECHATSYNC_TOKEN 环境变量。上面的 --dry-run 用于预览、不实际同步；最后一条命令会执行同步。先检查平台登录状态，再发送文章，排错时更容易分辨连接问题和内容问题。

项目也提供 MCP Server，可供兼容客户端调用平台列表、登录检查、文章提取及草稿同步等工具。普通作者不需要为了多平台发文先搭建 MCP；当稿件已经进入命令行或 AI 工作流时，再接入更合适。AI 客户端如何处理文章数据，取决于所用客户端及模型服务，不能把扩展的本地连接说明直接推广到整条 AI 链路。

失败时查这几项

目标平台未识别：先在使用扩展的浏览器中打开目标创作后台，确认账户确实处于登录状态；CLI 可执行 wechatsync auth --refresh 刷新检查。
CLI 等待连接：检查扩展开关、Token 是否一致，以及 WebSocket 端口是否被占用。CLI 文档默认端口为 9527。
草稿有内容但格式不对：用简单段落和单张图片复核，再逐步增加代码块、表格等元素。仓库最近提交就是针对 CSDN JSON 代码块的修复，说明平台适配仍会遇到具体格式问题。
单个平台失败：先保留已成功的草稿，检查失败平台的登录、必填内容和当前适配情况，避免不加区分地重复全量同步。

远程桥接属于进一步配置。CLI 文档说明其服务可监听所有网络接口，并提醒普通 WebSocket 连接中的 Token 为明文传输；有远程需求时应按官方建议使用 SSH 隧道或 VPN，不应把桥接端口直接开放到公网。只在本机使用的作者没有必要为第一次同步引入这一层。