环境安装
- 安装 Python:PostSync 是基于 Python 开发的,你需要确保系统中已经安装了 Python 环境,建议使用 Python 3.7 及以上版本。你可以从 Python 官方网站 下载并安装适合你操作系统的版本。
- 安装依赖库:打开命令行工具,使用以下命令安装所需的依赖库:
pip install -r requirements.txt
其中 requirements.txt
是项目中列出依赖库的文件。
配置文件设置
- 创建配置文件:在项目目录下找到
config.yaml
文件,这是 PostSync 的核心配置文件,用于指定浏览器信息、平台账号信息等。以下是一个简单的配置示例:
browser:type: chromeuser_data_dir: /path/to/your/chrome/user/dataplatforms:juejin:name: 掘金cookie: your_juejin_cookiecnblogs:name: 博客园cookie: your_cnblogs_cookie
browser
部分:指定浏览器类型(如chrome
)和用户数据目录,这是为了让 PostSync 能够获取浏览器中登录的平台账号信息。platforms
部分:列出要同步的平台,每个平台需要提供平台名称和对应的cookie
。你可以在浏览器登录相应平台后,通过开发者工具获取cookie
。
同步文章操作
- 准备文章文件:PostSync 支持
md
、html
、docx
等文件格式。将你要同步的文章文件准备好,放在指定的目录中。 - 执行同步命令:打开命令行工具,进入 PostSync 项目目录,使用以下命令进行文章同步:
python post_sync.py --input /path/to/your/article/files --platforms juejin,cnblogs
--input
参数:指定文章文件所在的目录路径。--platforms
参数:指定要同步到的平台,多个平台用逗号分隔。
高级配置与使用
- 自定义默认配置:你可以在
config.yaml
文件中对一些默认配置进行自定义,例如设置文章的标签、分类、专栏、封面、摘要等信息。
default_config:tags: ["技术", "编程"]category: 技术文章column: 编程学习cover: https://example.com/cover.jpgsummary: 这是一篇关于编程技术的文章。
- 多协程异步上传:PostSync 支持多协程异步上传,可提高同步效率。你可以在代码中调整相关参数来控制并发数量。
注意事项
- Cookie 有效期:平台的
cookie
有一定的有效期,当cookie
过期后,需要重新获取并更新到配置文件中。 - 平台规则:不同平台有不同的文章发布规则和限制,在同步文章时要确保遵守这些规则,避免文章被拒绝或账号受到处罚。