YuqueSync:
一款跨平台的语雀文档同步工具。支持实时监控、多格式导出、知识库完整备份,确保您的知识资产安全无忧。

主要特性:
- • 智能同步引擎:实时监控语雀文档变更,自动更新本地备份
- • 多格式导出:支持 PDF 和 Markdown 两种导出格式
- • 知识库整体同步:一次性同步整个知识库,无需逐个操作
- • 智能变更检测:精准识别文档更新,避免重复下载
- • 保留原文档格式:完整保留原始文档样式和结构
- • Docker 部署:开箱即用,支持容器化部署
准备
部署前需要先获取语雀凭证,打开你需要同步的知识库网址(例如:https://www.yuque.com/david-gshie/nasbox)

按 F12 右侧就会出现开发者工具,切换到网络(Network)

刷新页面会出现很多信息,点击搜索按钮

搜索 yuque_ctoken 和 _yuque_session(两个都在一起的,搜索其中一个就行),回车确定就能找到了

选择出现在 Cookie 里的,复制 Cookie 到空文本里

在里面找到 yuque_ctoken 和 _yuque_session 两个参数的值

安装
Docker Compose
services:
yuque-sync:
image: heizi**/yuque-sync:latest
container_name: yuque-sync
environment:
- YUQUE_TOKEN=你的token
- YUQUE_SESSION=你的session
volumes:
- ./data:/data
restart: always
参数说明(更多参数建议去看文档)
:::YUQUE_TOKEN(环境变量):语雀 Token
YUQUE_SESSION(环境变量):语雀 Session
YUQUE_BASE_URL(环境变量,可选):语雀网站地址
SAVE_PATH(环境变量,可选):文档保存路径
MONITOR_INTERVAL_MINUTES(环境变量,可选):同步间隔(分钟)
EXPORT_FORMAT(环境变量,可选):导出格式 (pdf/markdown)
:::
使用
目前还没有可视化界面,只能看容器的运行日志

能看到已经识别到知识库,并且开始下载了

来到映射的目录,知识库的文档都同步下载

整体效果还是很不错,排版和代码都没乱,图片这些也都全(不过行与行之间空格间距有点问题)

总结
总的来说,这款语雀文档本地同步工具还是非常实用的,平时部署放着就能自动将云端文档同步到本地。云端服务再怎么安全,也比不上保存在本地来的踏实放心,多一个备份还是很有必要的。上面我演示下载的是 pdf 格式,基本上是没有什么问题的,但如果改为 md 格式的话,会有文档里引用的图片是链接,而不是本地图片的问题。希望开发者后面可以加上可视化操作界面,配置参数也能更加方便,还有就是优化 md 格式下载的问题,毕竟都是希望数据可以完全离线的。
综合推荐:⭐⭐⭐⭐(语雀用户推荐部署)
使用体验:⭐⭐⭐(想法很好,不过还不完善)
部署难易:⭐⭐(简单)︎
︎