文档

wechatsync 扩展 开发文档

这个项目是什么

wechatsync 是 WechatSync 的一个 Chrome 扩展 fork：一个免费开源的「文章一键多平台同步」工具，把当前页面的内容一键同步到知乎、掘金、CSDN、百家号、微信公众号等 29+ 内容平台，统一走各平台官方创作者后台接口、默认存为草稿，数据只在本机处理——不会经过任何第三方服务器，作者看不到你的内容。

本 fork 在上游基础上补了两块自有能力：公众号多账号保持在线（多个公众号账号同时保活、同步时指定目标账号、Cookie 轮换自动保存），以及常开同步桥接（扩展默认开启一个本地 WebSocket 桥接，供 CLI、MCP、Claude Code 等外部工具发起同步）。

工作原理

技术栈与仓库结构

层 技术
扩展 Chrome MV3（packages/extension，v2.0.0 起为全新 React UI）
核心 TypeScript 5.x、Vite 4、unified/rehype/remark/turndown 内容转换
桥接 本地 WebSocket（CLI / MCP / 外部工具连接）
工程 pnpm（README 命令）+ yarn workspace 脚本（package.json scripts 为 yarn workspace … 形式），engines.node >= 20 
wechatsync/
├── README.md / CHANGELOG.md / CONTRIBUTING.md / LICENSE (GPL-3.0)
├── docs/                    # 使用与开发文档
├── skills/                  # Claude Code 等 AI 工具的 skill 资产（.claude-plugin）
├── packages/
│   ├── extension/           # Chrome 扩展（加载 packages/extension/dist）
│   ├── core/                # 各平台适配器、状态、登录、账号管理
│   │   └── src/content/     # 内容转换模块（统一/rehype/remark，ProseMirror JSON、capabilities.ts）
│   ├── cli/                 # @wechatsync/cli
│   └── mcp-server/          # Model Context Protocol 服务
└── pnpm-workspace.yaml / pnpm-lock.yaml / yarn.lock / tsconfig.json

本地开发

git clone <本仓库地址>
cd wechatsync
pnpm install
pnpm dev              # 构建 packages/extension/dist

Chrome 开启开发者模式 →「加载已解压的扩展程序」→ 选择 packages/extension/dist。Node 版本要求 >=20。

配置项说明

配置 位置 说明
扩展设置 →「MCP 连接」Token 扩展 Options CLI / MCP 连接扩展时必须配置；本 fork 默认内置 Token，改后端需同步
WECHATSYNC_TOKEN shell 环境变量 CLI 使用
MCP_TOKEN MCP 配置 JSON（如 claude_desktop_config.json） MCP 客户端使用
桥接服务器地址 扩展设置页（CLI 桥接地址） 本 fork v2.1.1 起桥接默认开启、始终连接、不可关闭；v2.1.2 起默认地址为 ws://192.168.68.19:9600（默认 Token 内置，CLI 与 MCP 默认端口同为 9600；旧的 localhost:9527 地址已清理）
悬浮同步按钮 扩展设置页 v2.0.6 起可开启，浏览文章时右下角常驻入口，不刷新页面即可同步
文章/图片接口地址 扩展设置页 私有部署时可配置

CLI 与 MCP

npm install -g @wechatsync/cli
export WECHATSYNC_TOKEN=<Token>
wechatsync sync <url> --targets "csdn,zhihu"

{
  "mcpServers": {
    "wechatsync": {
      "command": "npx",
      "args": ["-y", "@wechatsync/mcp-server"],
      "env": { "MCP_TOKEN": "<Token>" }
    }
  }
}

MCP 提供 getSupportedTargets、getUserInfo、syncArticle 等工具；syncArticle 支持 content / markdown 内容、HTML 转 Markdown、图片自动下载上传。仓库还带 .claude-plugin（Claude Code skill，自然语言下达「同步到知乎和掘金」）和 OpenClaw 平台技能接入。

二次开发要点

更新记录（摘自 CHANGELOG.md，本 fork）

相关链接