LocalSync2026-01-29
🛠️ 通用 WordPress 同步工具规划方案与体系就绪报告
1. 规划方案 (Design Plan)
核心组件:wp_cli.py (统一命令行入口)
我们将创建一个新的 Python 脚本 wp_cli.py,作为所有同步操作的底层执行者。它将接受命令行参数来区分不同的输入源。
命令行接口设计:
# 场景 1:同步 URL (自动调用 scraper 抓取)
python wp_cli.py --mode url --input "https://mp.weixin.qq.com/s/..."
# 场景 2:同步本地文件 (支持 .md, .html, .txt)
python wp_cli.py --mode file --input "c:/path/to/file.md"
# 场景 3:同步文本片段 (直接将文本作为正文)
python wp_cli.py --mode text --input "这是一段需要同步的测试内容..." --title "可选标题"
功能逻辑详解
模式 (--mode) |
处理逻辑 | 依赖模块 |
|---|---|---|
| URL | 1. 调用 WeChatScraper.scrape(url) 抓取内容2. 获取标题、正文(Blocks)、元数据 3. 调用 WordPressService.create_post 发布 |
scraper.pywordpress_service.py |
| File | 1. 识别文件后缀 2. Markdown: 使用 markdown 库转 HTML,提取第一行 # 为标题3. HTML: 使用 BeautifulSoup 提取 title 和 body4. Text: 直接读取内容 5. 构造标准 article_data 结构6. 调用 WordPressService.create_post 发布 |
markdownbs4wordpress_service.py |
| Text | 1. 将文本封装为简单的 HTML (<p>content</p>)2. 自动生成标题 (如 "笔记:2024-01-29") 或使用参数 3. 调用 WordPressService.create_post 发布 |
wordpress_service.py |
2. 体系就绪 (System Ready)
通用 WordPress 同步体系已完成开发并就绪。
已完成工作
-
编写通用入口脚本
wp_cli.py:- 这是一个统一的命令行工具,支持 URL、文件、文本三种模式。
- 包含了错误处理和 Fallback 机制(抓取失败时仅保存链接)。
-
更新 Skill 定义
wp-sync:- Skill 能够理解并处理各种自然语言指令。
- 支持指令示例:
- "同步链接" ->
python wp_cli.py --mode url ... - "同步文件" ->
python wp_cli.py --mode file ... - "发一段笔记" ->
python wp_cli.py --mode text ...
- "同步链接" ->
如何使用
- 同步链接:"帮我同步这篇:https://..."
- 同步文件:"把当前文件同步到 WP"
- 同步文本:"帮我发个笔记:..."
原文链接:

评论