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

快速开始

安装
第一个知识库

AI 与 Agent

智能助手(AI)
Agent 开发闭环
CLI Token

核心概念

所见皆文件
工作空间
文档级邀请
无账户身份识别

使用指南

设置页面概览
Markdown 编辑
HTML 文档
流程图生成
知识图谱
草稿与同步
我的文章与邀请
文档收藏
文档评论
受限工作空间成员与模板
恢复码(兼容)

部署与配置

环境要求
配置文件
反向代理示例
客户端壳(Android / 桌面)
FAQ
更新日志
Next Page安装
mdocs

Write freely. Never lose a word.

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

#版本冲突与合并

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

#三栏分别是什么

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

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

#与草稿、发布的关系

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

#自动发布与冲突

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

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

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

#相关阅读

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