WP-Sync：我用 AI 搭了一个智能同步盘来管理三年的信息债务
一个程序员的信息焦虑
我是一个有 8 年 Python 开发经验的程序员，涉猎很广——后端开发、AI 应用、服务器运维、域名投资、跨境电商协助，什么都干。也正因如此，我积累了大量的笔记、书签、文档、安装包、配置文件，散落在至少 8 个地方：
- Notion（主力笔记，但页面层级混乱）
- OneNote（旧笔记，懒得迁移）
- 微信收藏夹（随手收藏，再也没打开过）
- 苹果备忘录（碎片想法）
- 微信文件传输助手（临时中转站变成了永久仓库）
- 几台电脑桌面的散落 Markdown/TXT
- 百度网盘（各种软件和备份）
- 浏览器书签（上千个，大量死链）
每次想整理，打开 Notion 不知道放哪个页面，想了半天分类，最后随手新建一个页面了事。整理债务越积越高，越高越不想整，恶性循环。
我的技术博客从 2022 年停更至今，不是没东西写，而是写了不知道往哪放，放了不知道怎么分类，分了又觉得不够完美，完美主义直接杀死了行动力。
我需要的不是又一个笔记软件
市面上的笔记工具我几乎都试过了。问题不在工具本身，而在于每个平台都有自己的交互方式——Notion 要打开网页新建页面、书签要右键添加、网盘要打开客户端上传。每多一个平台，就多一份"这个东西该放哪"的决策成本。
我真正需要的是一个像网盘同步盘一样自然的东西——就是一个文件夹，我往里面扔文件，后台自动帮我分类、整理、发布。不需要打开任何网页，不需要做任何决策。
于是我写了 WP-Sync
WP-Sync 是一个 Python 写的命令行工具，核心逻辑很简单：
- 在百度网盘同步盘里建一个
WP-Sync目录，按分类建好子目录 - 用 watchdog 监控文件变化
- 文件扔进
_inbox/目录后，调用 AI 自动识别内容、分类、打标签 - AI 自动排版优化 Markdown 格式
- 通过 WordPress REST API 自动发布到博客
整个流程对我来说就是：Typora 写完笔记 → 保存到 WP-Sync 目录 → 自动变成博客文章。
为什么选 WordPress 做 All-in-One？
最初我想的是多平台管理——书签放浏览器、笔记放 Notion、文件放网盘、博客放 WordPress。后来想明白了：多处维护就是不维护。
WordPress 足够万能：
- 技术博客（公开）——对外展示技术能力
- 内部文档（私密）——合同、客户资料，登录后才可见
- 收藏导航（公开）——替代浏览器书签，还能分享给别人
- 软件推荐（公开）——附上百度网盘链接
- 分类 + 标签 = 多维度检索——一篇文章可以同时属于"DevOps"分类，带有"Docker""Nginx""踩坑"标签
所以最终架构极简：只维护两个平台——WordPress（一切文本和知识）+ 百度网盘（大文件）。
多设备同步怎么解决？
我有 Windows 和 Mac 两台电脑，都装了百度网盘同步盘。WP-Sync 目录就在同步盘里，两台电脑自动同步。
但这带来一个问题：两台电脑都跑 wp-sync 的话，同一个文件可能被发布两次。
解法是用内容哈希去重——每次发布时计算文件的 SHA256，存到 WordPress 文章的自定义字段里。下次发布前先查 WP 上已有的 hash，一样就跳过。Mac 发布后百度同步到 Windows，Windows 查到 hash 一致，自动跳过，不会重复发布。
WordPress 本身就是数据库，不需要本地 SQLite，天然解决了多设备状态一致性的问题。
AI 自动分类有多准？
说实话，比我自己分类还准。
我往 _inbox/ 扔了一篇关于 Docker Compose 部署 FastAPI 的踩坑笔记，AI 返回：
{
"category": "技术参考/DevOps",
"tags": ["Docker", "FastAPI", "部署", "踩坑"],
"suggested_title": "Docker Compose 部署 FastAPI 踩坑记录",
"confidence": 0.92
}
分类准确，标签合理，标题比我随手起的"部署笔记"好得多。置信度低于 0.6 的文件会被移到待确认目录，不会乱分。
AI 自动排版解决了"不够完美就不发"
这是杀死我博客的元凶——总觉得笔记太粗糙，没排版好不想发。WP-Sync 在发布前会自动过一遍 AI 排版：
- 补全标题层级
- 代码块自动标注语言
- 中英文之间加空格
- 生成文章摘要
- 修复 Markdown 语法问题
排版结果直接写回原文件，我在 Typora 里能看到效果，不满意可以手动调。
降低发布门槛比提高内容质量更重要。 一篇 300 字的踩坑记录，只要发出来了，就比躺在桌面上的万字草稿有价值。
技术实现
技术栈
- Python 3.10+
- watchdog：文件系统监控
- OpenAI 兼容 SDK：对接任意大模型（阿里云百炼、DeepSeek、OpenAI 等）
- requests：WordPress REST API
- typer + rich：命令行界面
- python-frontmatter：Markdown 元数据解析
核心模块
项目一共 9 个 Python 文件，每个不超过 200 行：
watcher.py：watchdog 监控 + 静默期机制（文件最后修改 10 分钟后无变化才处理）classifier.py：调用 AI 做内容分类和标签推荐formatter.py：调用 AI 做 Markdown 排版优化publisher.py：WordPress REST API 封装 + hash 去重processor.py：协调以上模块的流水线
使用方式
# 初始化目录和 WP 分类
wp-sync init
# 手动发布
wp-sync push my-note.md
# 后台监控，扔文件自动处理
wp-sync start
我的分类体系
这套分类不是按技术教科书分的，是按"我在干什么"分的：
| 分类 | 说明 | 可见性 |
|---|---|---|
| AI 探索 | LLM/Agent/RAG/MCP，当前主赛道 | 公开 |
| 工具与资源 | 开源项目推荐、效率工具 | 公开 |
| 基础设施 | 服务器、域名、云服务管理 | 私密 |
| 我的项目 | 作品展示 | 公开 |
| 客户与业务 | 公司和客户资料 | 私密 |
| 技术参考 | Python/Web/DevOps/数据库 | 公开 |
| 数字生活 | 网络服务、账号管理 | 私密 |
| 商业与思考 | 创业、行业、自媒体 | 公开 |
| 求职与成长 | 简历、面试、职业规划 | 公开 |
| 收藏导航 | 替代浏览器书签 | 公开 |
分类定位置，标签补细节。一篇关于"用 Docker 部署 FastAPI 的踩坑记录"——分类是"技术参考/DevOps"，标签是"Docker, FastAPI, 踩坑，部署"。想找所有 Docker 相关内容，按标签筛选就行。
写在最后
这篇文章本身就是通过 WP-Sync 发布的。我在 Typora 里写完，保存到 WP-Sync 目录，一条命令发布到 WordPress。
如果你也有类似的信息焦虑——笔记散落各处、博客想写但迟迟不动手、总想等分类方案完美了再开始——我的建议是：先发出来，再说完美的事。
WP-Sync 目前还是 MVP 阶段，后续计划开源。如果你感兴趣，欢迎关注我的博客，我会持续更新开发过程。
本文首发于 zhong-er.com，中二青年的技术博客。