Skip to content

cli

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

cli

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
src
src
 
 
README.md
README.md
 
 
package.json
package.json
 
 
tsconfig.json
tsconfig.json
 
 
tsup.config.ts
tsup.config.ts
 
 

README.md

@wechatsync/cli

命令行同步文章到多个内容平台。

安装

npm install -g @wechatsync/cli

快速开始

# 同步文章到知乎和掘金
wechatsync sync article.md --platforms zhihu,juejin

首次使用会提示安装 Chrome 扩展 - 访问 https://wechatsync.com/#install 安装。

命令

sync - 同步文章

# 基本用法
wechatsync sync article.md -p zhihu,juejin

# 指定标题
wechatsync sync article.md -t "我的文章" -p zhihu

# 添加封面
wechatsync sync article.md -p juejin --cover https://example.com/cover.jpg

# 预览（不实际同步）
wechatsync sync article.md --dry-run

platforms - 查看平台

# 列出所有平台
wechatsync platforms

# 显示登录状态
wechatsync platforms --auth
wechatsync ls -a

auth - 检查登录

# 检查所有平台
wechatsync auth

# 检查单个平台
wechatsync auth zhihu

# 强制刷新
wechatsync auth --refresh

extract - 提取文章

# 从浏览器当前页面提取
wechatsync extract

# 保存到文件
wechatsync extract -o article.md

工作原理

┌──────────────┐     WebSocket     ┌───────────────────┐
│  wechatsync  │◄─────────────────►│  Chrome Extension │
│    (CLI)     │    port 9527      │   (同步助手)       │
└──────────────┘                   └───────────────────┘
                                            │
                                            ▼
                                   ┌───────────────────┐
                                   │  目标平台 API      │
                                   │  (知乎/掘金/...)   │
                                   └───────────────────┘

CLI 启动后监听 WebSocket 端口，等待 Chrome 扩展连接。 扩展连接后，CLI 通过 WebSocket 发送请求，扩展执行实际的平台 API 调用。

支持的平台

知乎、掘金、简书、头条、微博、B站、百家号、CSDN、语雀、豆瓣、搜狐、雪球、微信公众号、人人都是产品经理、大鱼号、一点资讯、51CTO、搜狐焦点、慕课网、开源中国、思否、博客园

环境变量

变量 说明 默认值
SYNC_WS_PORT WebSocket 端口 9527
WECHATSYNC_TOKEN 安全验证 token -

远程桥接

CLI 支持在服务器上运行，连接本地电脑上的 Chrome 扩展。适用于在远程开发机或 CI 环境中同步文章，同时利用本地浏览器的登录态。

架构

┌─────────────────┐                        ┌─────────────────────┐
│  远程服务器       │     WebSocket          │  本地电脑            │
│                 │     port 9527           │                     │
│  wechatsync CLI │◄───────────────────────►│  Chrome Extension   │
│  / MCP Server   │                         │  (浏览器登录态)      │
└─────────────────┘                         └─────────────────────┘

配置步骤

1. 服务器端 - 正常启动 CLI 或 MCP Server：

# CLI
WECHATSYNC_TOKEN=your-token wechatsync sync article.md -p zhihu

# MCP Server
MCP_TOKEN=your-token node packages/mcp-server/dist/index.js

服务器默认监听 0.0.0.0:9527（所有网络接口），远程可直接连接。

2. 本地浏览器 - 在 Chrome 扩展设置中：

  1. 开启「同步桥接」开关
  2. 在「服务器地址」输入框填入远程地址，例如 ws://192.168.1.100:9527
  3. 确保 Token 与服务器端一致

扩展会自动连接远程服务器，连接成功后即可远程同步。

注意事项

  • 确保服务器防火墙放行 9527 端口（可通过 SYNC_WS_PORT 自定义）
  • Token 在传输中以明文发送，生产环境建议配合 SSH 隧道或 VPN 使用
  • 每个 Token 只允许一个扩展连接

Claude Code 集成

安装 Skill 插件：

/plugin marketplace add wechatsync/Wechatsync
/plugin install wechatsync

然后在 Claude Code 中可以直接说：

  • "把这篇文章同步到掘金"
  • "帮我看看哪些平台已登录"
  • "从浏览器提取当前文章"

License

MIT