logo
mdocs
首页
特性
开始
文档
GitHub
首页
特性
开始
文档
GitHub
logo
mdocs

快速开始

安装
第一个知识库

核心概念

所见皆文件
域隔离
文档级邀请
无账户身份识别

使用指南

设置页面概览
Markdown 编辑
流程图生成
草稿与同步
我的文章与邀请
文档收藏
文档评论
受限域成员与模板
CLI Token
恢复码与身份找回

部署与配置

环境要求
配置文件
反向代理示例
FAQ
更新日志
Next Page安装
mdocs

Write freely. Never lose a word.

MIT License
产品
功能特性竞品对比更新日志
资源
文档安装指南
社区
GitHub问题反馈
© 2026 mdocs · Made with ♥ by xuhuafeifei

#版本冲突与合并

当发布时服务端 head 已前进(例如他端编辑、或本机自动发布后又改稿),PUT 可能返回 409 版本冲突。mdocs 会引导你进入 合并 界面,而不是直接覆盖远端。

#三栏分别是什么

位置含义
左(本地)发生冲突时,你本地草稿的正文快照(冻结,不是已提交的 commit 节点)
右(远端)打开合并时,服务器上当前这篇的正文
中(结果)基于共同祖先做的行级对比;每个差异块需点选「采用本地 / 远端 / 保留双方」等,全部处理完才能发布

共同祖先正文由服务端根据提交图计算(merge-context API),用于判断「相对祖先,哪边改了什么」。

#与草稿、发布的关系

  • 平时编辑:正文在 IndexedDB 草稿;元信息(权限、路径等)在内存中的 activeDocMeta(来自 GET)。
  • 发布成功(手动或自动):删除本地草稿 → 再拉取服务器最新内容 → 编辑器与 meta 对齐,避免「自己跟自己冲突」的误报。
  • 有未发布草稿时:不会用后台轮询去提示「落后」,以免和本地副本语义打架;以本地草稿为准,通过 发布 / 合并 与服务器对齐。

#自动发布与冲突

开启「自动同步至云端」后:

  • 每 10 秒 扫描一次本地草稿;
  • 某篇草稿 超过 30 秒 没有新的自动保存,才会尝试自动发布。

若自动发布已成功而本地仍显示冲突,多为旧版本行为;请升级到最新版并重新发布一次。

#相关阅读

  • 草稿与同步
  • 设置 — 开启自动同步、管理未发布草稿