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

快速开始

安装
第一个知识库

AI 与 Agent

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

核心概念

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

使用指南

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

部署与配置

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

Write freely. Never lose a word.

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

#更新日志

现行文档里,产品概念「域」已改称 工作空间。下面各版本仍按当时的叫法记录。

#v3.1.16

#编辑器

  • 提示块:斜杠菜单插入 Note / Tip / Important / Warning / Caution。正文写成 GitHub 提示语法,例如 > [!NOTE]
  • 编辑器包 @fgbg/lobe-editor@1.0.0-fork.44

#智能助手

  • 执行轨迹:思考收成「已深度思考」;工具步骤用勾选行。读取、写入的参数可以展开,命令和输出在与步骤齐平的灰底面板里

升级:mdocs update 或 npm i -g @fgbg/mdocs@3.1.16;服务器亦可 pack 覆盖。

#v3.1.13

#定时任务(Job)

  • 新文档类型 .job:欢迎页 / 侧栏可新建定时任务;树中可见,服务端权威(无草稿、无 sync-status 轮询)
  • 秒级 Cron:Watchdog 每秒扫描;到点异步交给执行器,启动专用 Job Agent(含 job_append_data、联网工具)
  • 配置与运行时拆分:.job 存 Job/Monitor 配置;运行流水与采集点落 SQLite
  • Job 面板:配置、折线图、监控规则、运行流水;保存不闪烁

升级:mdocs update 或 npm i -g @fgbg/mdocs@3.1.13;服务器亦可 pack 覆盖。

#v3.1.7

#助手 / 上下文

  • 上下文诊断:与用量圆环同源三桶(系统提示词 / 工具定义 / 会话历史),点开可看正文;固定尺寸弹框,手机全屏
  • Engram 旁路:安装后写入/刷新 engram.md 使用说明;系统提示补「先搜再写」记忆指引;记忆数据落 tenant/<访客>/plugins-data/engram

#文档

  • 三点菜单 · 复制全文:Markdown / HTML 一键复制;表格灰态并提示暂不支持

#修复

  • 拉取更新整页「mdocs 加载中…」:AI Diff / Keep All 后进合并时,草稿残留的 diff-hunk 会被 Merge 桥吃爆;现压掉 hunk、拉前刷盘,并用合并页 ErrorBoundary 兜底

升级:mdocs update 或 npm i -g @fgbg/mdocs@3.1.7;服务器亦可 pack 覆盖。

#v3.1.6

曾 stage 未正式上架;能力并入 v3.1.7。

#v3.1.5

#表情包

  • 内置图库:系统库可从 npm 包整包同步;「我的表情包」可上传(id 系统分配)、改描述、删除
  • 助手发图:正文写 [meme:id];单条消息最多 5 张
  • 设置页:系统图库 / 我的表情包分栏;手机端上传与卡片布局适配

#Agent / Skill

  • 纯 prompt vs Skill+CLI:普通助手用 create_user_skill 只打包指令;需要 clone/安装走插件流水线
  • Skill / 目录名:允许连字符(不能以 - 开头;目录段不能是纯 -)
  • 系统提示词诊断弹框;成员弹窗滚动与移动端修复

升级:mdocs update 或 npm i -g @fgbg/mdocs@3.1.5;服务器亦可 pack 覆盖。

#v3.1.4

#插件流水线 / Agent

  • git_clone:支持 SSH(git@ / ssh://)与 https;禁止交互登录(BatchMode / 清 credential helper)
  • read_plugin_content:读取 plugins-home 内脚本正文,便于装后自测

升级:mdocs update 或 npm i -g @fgbg/mdocs@3.1.4。

#v3.1.3

#修复

  • Engram 系统流水线空壳:打包漏拷 engram.pipeline.yaml 时曾种成只有 extract;现内嵌完整母版,启动时自动修复 stub,并拷贝 bundled 进 dist
  • Engram 下载:只用国内镜像代理,不再回落 GitHub 直连

升级:本机/服务器 pack 覆盖;或稍后 npm i -g @fgbg/mdocs@3.1.3。

#v3.1.2

#插件流水线 / Agent

  • 目录统一:安装实体 plugins-home/<name>/;租户 plugins-data / mcp / skills;Engram 连接时绑访客 ENGRAM_DATA_DIR
  • git_clone 步骤:clone 到 plugins-home(相对 dest,仅 https)
  • Agent:install_pipeline 可顺手安装;query_skill / list_plugin_home / run_plugin_cli(白名单 CLI,相对路径)
  • CLI 落盘:靠 cwd + 假 HOME 控写路径;MDOCS_PLUGIN_* 仅合约信号(见 ADR 018)

升级:本机/服务器 pack 覆盖(GitHub 超前于 npm 时);或稍后 npm i -g @fgbg/mdocs@3.1.2。

#v3.0.3

#修复

  • 整篇 Diff(overwrite_all):编辑器 JSON vs MD 再解析用「同类型 + 纯文本」相等,未改段落不再假红绿;同 hunk 红绿贴紧、不同 hunk 留间距
  • 图片缩放:拖动手柄松手宽度公式与拖动一致;选中/拖动中保持手柄
  • Mermaid / Vite:mermaid 不预构建(避免 sequenceDiagram chunk 假路径);其 CJS 依赖(dayjs、sanitize-url 等)nested optimizeDeps.include
  • 依赖:@fgbg/lobe-editor → 1.0.0-fork.35

升级:mdocs update 或 npm i -g @fgbg/mdocs@3.0.3。

#v3.0.2

#修复

  • 版本历史预览:不再挂第二套 Lobe/Lexical(生产包 Lexical #38 empty state);改为转 Markdown + react-markdown 只读预览

升级:服务器包更新,或稍后 npm i -g @fgbg/mdocs@3.0.2。

#v3.0.1

#修复

  • 版本历史:点历史条目偶发整页「加载中」——/ 与 /doc/:id 不再各挂一份 App;预览加错误边界,切版本保留旧预览
  • 整篇 Diff:未改动的块不再因 MD 回解析 meta 噪声被标红绿(@fgbg/lobe-editor → 1.0.0-fork.30)
  • Pending Diff:再提案前自动 Undo All,不再报 pending diff; resolve before applying more ops

升级:mdocs update 或 npm i -g @fgbg/mdocs@3.0.1。

#v3.0.0

大版本:智能助手 × Lobe Inline Diff 审阅写文,以及可配置上传上限。

#智能助手 × Diff(仅 .md / Lexical)

  • 按块提案:update_slot / insert_after_slot / remove_slot / overwrite_all(整篇 LCS)经 SSE 写入当前打开编辑器,物化为红绿 DiffHunk
  • 审阅:编辑器内 Keep / Undo(及全部接受/拒绝);有未决 Diff 时禁止发布
  • 读门牌:get_document_lexical_lines 供 Agent 看外层块;HTML / sheet 不走 Lobe Diff(HTML 仍用落盘覆写;表用 sheet_*)
  • 落盘写仍在:overwrite_document / append_document / replace_document_markdown 与 Diff 两套并存(后续可能按 mode 裁剪工具集)

#编辑器依赖

  • @fgbg/lobe-editor → 1.0.0-fork.28(slot Diff API + 相邻红绿 hunk 贴紧)

#上传

  • 单文件上限默认 100MiB,可在设置「通用」里改,或环境变量 MDOCS_MAX_UPLOAD_BYTES;落盘 ~/.mdocs/server-settings.json
  • API:GET/PUT /api/server-settings

升级:mdocs update 或 npm i -g @fgbg/mdocs@3.0.0。

#v2.1.10

#Agent / 导出

  • 列表转 Markdown:listitem 下直接挂文字(无 paragraph)时不再导出成空的 -;get_document(format=md) 能还原正文

#编辑器

  • @fgbg/lobe-editor 升到 1.0.0-fork.27(选中图片可下载)

升级:mdocs update 或 npm i -g @fgbg/mdocs@2.1.10。

#v2.1.9

#分屏顶栏 / 标签

  • 收起无残影:分屏隐藏发布栏后不再留细线空隙
  • 取消钉住:点钉子后立刻收起(不再因鼠标还停在条上被 :hover 撑开)
  • 联动吸附:分屏且标签未钉住时,发布栏与标签栏共用热区,一起展开 / 一起收起

升级:mdocs update 或 npm i -g @fgbg/mdocs@2.1.9。

#v2.1.8

#工作区标签 / 回顶

  • PC 最近打开标签:发布栏下方;上/下分屏各一份列表;打开不重排;下栏标签清空自动收合分屏
  • 钉子 / 吸附:默认钉住常驻;取消钉住后收成吸附条,悬停展开(不挡发布栏)
  • 右侧三钮:大纲 · 格式工具栏(Lobe,默认关)· 钉子;偏好记在 localStorage
  • 回顶:正文 / 表格滚过阈值后右下角回到顶端

升级:mdocs update 或 npm i -g @fgbg/mdocs@2.1.8。

#v2.1.7

#冲突合并

  • AI 行级合并:Merge 页「AI 合并」把 git 冲突 Markdown 交给模型,拿回定稿正文(suggest-merge-resolutions)
  • 合并说明:完成合并发布走专用弹窗 + suggest-merge-message(不再复用普通发布说明)
  • 助手:get_editor_draft 按需静默取浏览器本地草稿(SSE+requestId);再 suggest_document_merge / suggest_document_merge_message
  • 不做 CLI ai-merge:浏览器草稿 CLI 读不到

升级:mdocs update 或 npm i -g @fgbg/mdocs@2.1.7。

#v2.1.6

#文档信息

  • 统计写全:阅读时间、行数、汉字/数字、字符(含空白);列表左标签右数值,与创建者等信息同一风格

#目录

  • 右键菜单:贴边自动翻转,不再被侧栏/视口裁切;新建 Markdown / HTML / 表格收入二级子菜单
  • 拖放搬家:拖进目标目录时只高亮,不再自动展开

升级:mdocs update 或 npm i -g @fgbg/mdocs@2.1.6。

#v2.1.5

#助手 / 正文

  • 空引用行 >:MD↔Lexical 往返保留;避免 replace 后丢块
  • 助手写后拉取:灌入远端正文时抑制自动保存,防止中间空态写进草稿把全文盖掉
  • 破坏性 replace:替换结果为空或过短时拒绝写入
  • 贴左助手:不再叠浮动球;发布说明框 Enter 发布 / Shift+Enter 换行

升级:mdocs update 或 npm i -g @fgbg/mdocs@2.1.5。

#v2.1.4

#发布说明

  • commit message / source:每次发布可带说明(auto / manual / agent / cli);自动发布固定「自动发布」
  • 手动发布弹框:可选填写;支持 AI 按「相对最近非自动发布」的 diff 生成建议
  • 版本历史:展示说明;可「隐藏自动发布」(默认关)
  • CLI:update --message(source=cli)

#编辑 / 助手

  • ⌘/Alt+Enter:capture 拦截,只触发发布,不再被编辑器当成软换行
  • 助手写文后自动拉取:append / replace / overwrite 成功后,若正打开该文则清草稿并灌入服务端最新

升级:mdocs update 或 npm i -g @fgbg/mdocs@2.1.4。

#v2.1.3

#智能助手

  • Lexical → Markdown:服务端真导出(lexicalJsonToMarkdown);convert 反向不再是纯文本近似
  • get_document 默认 format=md:读文即 Markdown;仍可选 text / json
  • replace_document_markdown:在 MD 源码层找换再写回,避免局部改把全文格式冲掉;提示优先片段替换而非整篇覆写
  • ⌘/Alt+点击树节点:在下栏打开(分屏)

升级:mdocs update 或 npm i -g @fgbg/mdocs@2.1.3。

#v2.1.2

#编辑

  • PC 上下分屏:树右键「在下方打开」或 Alt+点击,中间正文上下双栏(类型可混、双可编);拖条调比例;顶栏悬停顶缘才展开;下栏关闭收成细线
  • 大纲:默认隐藏;工具栏开关挪到最左

#目录

  • 右键新建:可选 Markdown / HTML / 表格
  • 点空白:只清新建目标选中,不再卸掉当前正文
  • 助手贴左时右侧目录:保留「新建文章 / 新建目录」顶栏(无搜索、图谱)

升级:mdocs update 或 npm i -g @fgbg/mdocs@2.1.2。

#v2.1.1

  • 目录拖动:搬家时不再对无后缀的 dir 路径做磁盘 rename(会误报 must end with .md…);只搬子孙真实文件
  • mdocs update:别名包 @lobehub/editor 安装失败时强制 pack 重试;install 复用 ~/.npm/_prebuilds,避免空 cache 导致 native 重编 OOM

升级:mdocs update 或 npm i -g @fgbg/mdocs@2.1.1。

#v2.1.0

#智能助手

  • 上下文压缩:用量 ≥85% 时可自动 / 手动压缩长会话(会话锁 + UI),避免顶满后卡死 — 见 智能助手
  • 贴左后右侧目录:助手贴左时文档树推到右侧,绿色 peek 与折叠动画 — 同上

#文档与协作

  • 版本历史:文档信息里可预览历史发布;恢复会把该版正文作为新的一次发布(中间记录保留);弹窗内嵌只读 Lobe 预览 — 见 编辑体验
  • 回收站:设置页可查看本人已删文档并恢复(恢复删前最新正文,不回滚整棵版本树) — 见 设置
  • 目录整树移动:文件夹可拖拽搬家,子孙路径一并更新;图谱隐藏文件不搬家、直接清理

#CLI / 身份

  • 多 CLI Token:可同时多枚命名 Token;停用可再启用,删除为硬删(明文永久失效) — 见 CLI Token

升级:mdocs update 或 npm i -g @fgbg/mdocs@2.1.0(国内可用淘宝镜像 --registry=https://registry.npmmirror.com)。

#v2.0.10

#智能助手

  • append_document / replace_document_markdown:.md 文末追加、纯文本层精确替换片段(无整篇覆写选择卡)
  • 写后短提示落盘:overwrite / append / replace 成功后 session 只记 DOCUMENT_CHANGED,提示重新 get_document,不把全文塞进上下文
  • PC 助手贴左:打开助手时可替换左侧目录并拖宽(agent-dock-left)

升级:mdocs update 或 npm i -g @fgbg/mdocs@2.0.10。

#v2.0.9

#智能助手

  • 选择卡吸底:overwrite / 选择类卡片置顶到输入框上方,出卡强制滚到底,避免埋在长思考里超时
  • tool 结果落盘:get_document / web_search / web_fetch 写入 session,下一轮可复用,少重复调用

#编辑器

  • 滚动位置记忆:进程内 LRU(最多 10 篇),切文档再回来回到上次滚轮位置;刷新/重启即丢

升级:mdocs update 或 npm i -g @fgbg/mdocs@2.0.9。

#v2.0.8

#智能助手

  • DeepSeek 网页搜索 / 抓取:配置为 DeepSeek 时可用 web_search / web_fetch(官方 Search/Fetch API)
  • 搜索结果卡可折叠:工具卡内展示标题、站点、摘要与外链,默认可展开/收起

升级:mdocs update 或 npm i -g @fgbg/mdocs@2.0.8。

#v2.0.7

#冲突合并

  • 整表 / 行级 merge 发布前刷新 tip:避免冲突页里过期的 remoteCommitId 再 409;merge PUT 204 后补 GET 详情再关界面
  • 合并页强制覆盖:文档所有者在整表二选一面也可「强制覆盖」(不仅冲突弹窗)
  • Lexical→MD 桥补齐 List/Table 等插件:绿区「别人的」不再截成标题后空白;全盘接收远端时直写 tip Lexical

升级:mdocs update 或 npm i -g @fgbg/mdocs@2.0.7。

#v2.0.2

#智能助手 / AI 帮写

  • 工具调用提前反馈:参数还在流式拼装时就出「准备中」卡片,带 thinking 同款波浪
  • 写工具可滚动预览:覆写 / 帮写正文 / 表格写入等,卡片里可折叠查看正在写或已写内容;帮写为增量生长并平滑跟滚
  • 消息复制:用户与 Agent 消息下方增加复制小按钮(Agent 只复制正文)
  • 选择卡布局:弹出选择卡后助手气泡不再被内容宽度带窄

升级:npm i -g @fgbg/mdocs@2.0.2 或已安装环境执行 mdocs update。

#v2.0.1

#手机端

  • 目录改为 push 跟手:侧栏与正文同轨推开/收回,不再浮层盖住
  • 宽表先滚再开门:sheet / 宽 Markdown 表还能横滑时先滚表,到头再开目录
  • 收拢目录:修正文被挤成左边一条缝(轨道宽按 目录 + 100vw)
  • 首滑卡顿:修「要点一下才能滚」——竖滑优先让出,减少非 passive 手势拖住滚动

升级:npm i -g @fgbg/mdocs@2.0.1 或已安装环境执行 mdocs update。

#v2.0.0

本版重心:智能助手能收图片和文件,对话里可预览;表格冲突改为整表二选一。

#智能助手

  • 附件:上传、粘贴或拖入图片、PDF、Markdown、文本;图片显示缩略图,点击看大图;PDF、MD 等用彩色类型标记
  • 识图:图片按模型视觉输入发送
  • 输入栏:更紧凑,面板可拖宽;当前文档引用称为「文章引用」
  • 搜文:命中文档名是可点击链接,点开即跳到该文
  • 多模型配置:同一访客有多条配置时,启动不再因默认配置唯一约束失败

#表格

  • 发布冲突时整表选择「用我的 / 用别人的」,不再对工作簿 JSON 做行级 diff

#设置

  • 「我的文章」可按文件类型(Markdown / 表格 / HTML)筛选,列表显示类型

升级:npm i -g @fgbg/mdocs@2.0.0 或已安装环境执行 mdocs update。

#v1.4.1

#手机端

  • 左缘右滑开目录:加宽可起滑区域,并避开顶栏拖动手势抢触摸;建议从屏幕左侧稍靠里往右滑,或点左上角目录按钮
  • Android 壳:排除左缘系统返回手势区(需重装 APK)

#v1.4.0

本版重心:智能助手 / 帮写可后台跑完,关面板不再掐断对话;配套超时、重连回放与一批体验修补。

#智能助手 / 帮写(后台运行)

  • 关面板 ≠ 取消:关闭浮层或退出帮写只断开 SSE 订阅,服务端 run 继续跑;重开后自动回放并接上实时流
  • 显式停止:点停止、强关(含未完成的选择卡 / Skill 表单)、新建 / 切换会话会真正 cancel
  • 单会话单活动 run:同会话已有进行中的对话时再发会 409 RUN_ACTIVE
  • 可配超时:模型配置高级选项「单轮超时」(默认 300 秒,范围 60–3600);超时自动结束并提示
  • 进程重启:未完成的 run 标为 interrupted(不跨进程续跑)

#私人 Agent Skills

  • 新增工具 get_user_skill:按名读取完整正文与 updatedAt
  • update_user_skill:改为直接写入(带 expectedUpdatedAt 防覆盖),不再弹修改表单卡;新建仍用表单卡

#桌面壳(macOS)

  • 附件下载改为 WKWebView on_download 落到系统下载目录(不再误开系统浏览器丢 Content-Disposition)

#表格 / 搜索 / 其它

  • 删除工作表前增加确认;页脚「添加工作表」更明显
  • 语义 / FTS 索引覆盖表格等可索引类型(不只 Markdown);补齐缺失 FTS 行
  • 手机侧栏边缘滑动与 FAB 手势冲突再收敛

升级:npm i -g @fgbg/mdocs@1.4.0 或已安装环境执行 mdocs update。

#v1.3.32

#智能助手

  • 思考强度:模型配置可选关 / 低 / 高 / 最大(默认低);工具 set_thinking_level 可代改默认配置
  • 写完文档卡:创建 / 覆写后展示可点开的文档卡与 /#/doc/<id> 链接

#v1.3.31

#智能助手 / 表格

  • 行工具拆分:sheet_append_rows(表末追加)、sheet_update_row(改已有行)、sheet_insert_rows_at(插在 afterRowId 后);移除混用的 sheet_upsert_row / sheet_insert_rows

#v1.3.30

#智能助手 / 帮写

  • 工具调用卡片:对话时间线展示 tool_call(running / done / error + 摘要),替代零散 tool_notice
  • get_now:返回服务器当前时刻(iso / local / 时区);问时间日期须调工具
  • 帮写文案拆分:mode=coding 标题为「mdocs 帮写助手」,空态介绍与引导 chip 与 Ask 区分
  • 手机 FAB:窄屏也可拖动;侧栏边缘滑动忽略 FAB 起点,避免抢手势

#设置 / 表格

  • 设置左侧导航:图标 + 搜索过滤
  • 表格:公式栏(单元格地址 + 内容)、收藏与邀请/权限入口补齐

#v1.3.29

#智能助手 / 会话

  • 会话工作空间:新建会话记录 domainId;历史按工作空间折叠;旧会话懒迁移到 default
  • Pinned / 重命名:置顶为额外入口(原工作空间分组仍保留);支持手动改名
  • 思考条:思考 Ns › 折叠样式;思考中文字渐变;智能助手与帮写共用
  • 对话面板复用:帮写左栏嵌同一套 AgentChatPanel(mode=coding),右侧仍为 diff

#其它

  • 工作空间下拉支持输入过滤
  • 静态资源强制正确 Content-Type(避免 .js 被标成 octet-stream)

#v1.3.28

#升级与原生模块

  • mdocs update:原生模块改为探测后再 rebuild——require('better-sqlite3') 成功则跳过;仅绑定缺失/损坏时才编译。依赖安装仍是保留 node_modules 的增量同步

#v1.3.27

#升级与原生模块

  • mdocs update:升级后检测并必要时 npm rebuild better-sqlite3(及已安装的 node-llama-cpp),避免保留「有包无 .node」导致启动报 Could not locate the bindings file
  • CLI:version / update 不再预加载服务端 DB,sqlite 半残时仍可跑 mdocs update 自救

#v1.3.26

同 v1.3.25(npm 上 1.3.25 卡在 processing,改发此版本)。

#v1.3.25

#编辑器

  • 升级 @fgbg/lobe-editor@1.0.0-fork.23
  • Qwen / 网页渲染 Markdown 粘贴:优先使用剪贴板 rich HTML(标题、列表等),不再被弱 text/plain(仅残留 **粗体**)抢走 Markdown 确认框而变成扁文本
  • Shift 扩展选区 / 全选:视口不再被选区 bounding box 拽动;回车跟滚仍保留

#v1.3.24

#编辑器

  • 升级 @fgbg/lobe-editor@1.0.0-fork.22(Enter 靠近视口底部时光标跟随滚动;代码块内粘贴跳过 Markdown 确认,避免取消后双份内容)

#v1.3.23

#智能助手会话

  • 修复历史会话列表偶发「只剩一条」:session.json 读改写改为 Manager 方法级串行队列 + 原子写;读失败时从 *.jsonl 恢复索引
  • 运维命令:mdocs agent session repair --dry-run|--confirm(可加 --visitor / --kind),把孤儿 transcript 补回列表

#文档信息

  • 新增 字符数:去 Markdown 语法 / HTML 标签后的纯文本总字符(异步统计,回答「写了多少字」)

#语义模型与日志

  • Embedding GGUF 默认目录改为 ~/.mdocs/embedding/(随 MDOCS_DATA_DIR);旧 ~/.fgbg/shared/embedding/ 仅作已下载文件回退
  • 文件日志默认只落 error+(MDOCS_LOG_LEVEL 可改);路径仍为 ~/.mdocs/logs/;无前台管理页

#v1.3.22

#语义索引

  • 构建过程打进度日志(batch / 文档 / chunk 耗时),方便在 console 观察
  • MDOCS_DISABLE_EMBEDDING=1:小内存机器可整路关闭语义(仅关键词 FTS)
  • 缺 node-llama-cpp 时日志给出重装指引;mdocs update 同步新依赖并补装该包

#v1.3.21

同 v1.3.20(npm 上 1.3.20 卡在 processing,改发此版本)。

#v1.3.20

#文档搜索

  • 检索模式:自动 / 仅关键词 / 仅语义;⌘K 浮层与设置页「我的文章」搜索框可选
  • 默认范围:搜索浮层默认「全部」可见工作空间,可用下拉限定某一工作空间
  • 命中高亮:结果标题/片段对命中词做 <mark> 高亮;可区分标题 / 正文 / 语义来源
  • 本地语义索引:nomic GGUF(node-llama-cpp)异步下载加载;失败不挡关键词 FTS
  • 设置 → 语义索引:表格勾选重建;可按工作空间 / 是否已建筛选、列排序、分页;显示文章更新时间与上次语义构建时间

#智能助手

  • search_documents 增加 mode(auto / keyword / semantic)
  • 新增 list_semantic_index、rebuild_semantic_index(可读文档即可)

#v1.3.19

同 v1.3.18(npm 上 1.3.18 卡在 staged,改发此版本)。

#v1.3.18

#文档搜索

  • 侧栏搜索 + ⌘K / Ctrl+K:当前工作空间悬浮搜索浮层,点结果直接打开文章
  • 标题独立索引:标题与正文分两路 FTS;标题命中权重更高,排序更靠前
  • 搜索结果展示作者与最后修改时间
  • 查询侧同步 jieba 分词,修复中文多字词难以命中的问题

#知识图谱

  • 单击文档(doc)节点时直接打开来源文章

#侧栏

  • 操作栏收紧间距并略增宽度,避免新建/搜索/图谱图标换行

#v1.3.17

#侧栏与目录

  • 右键可新建目录:文档树右键除「新建文档」外,恢复「新建目录」
  • 侧栏工作入口:左侧保留「新建文章」「新建目录」;欢迎页主按钮仍是「开始写作」

#删除按钮

  • 删除按钮改为红描边 + 红字,悬停再加深浅红底,默认状态下文字更清楚

#知识图谱权限

  • 读图 / 生成图谱须具备工作空间协作身份(full);仅靠单篇邀请进入的成员不能访问图谱
  • private 工作空间仅主人可访问图谱;接口返回明确错误文案

#图谱构建

  • 目录归纳进度文案改用目录显示名,不再误用 document id

#v1.3.16

#顶栏状态

  • 「编辑中 / 已发布」只跟未发布的本地草稿:没有草稿就是已发布;草稿写入或删除后,顶栏同一轮改字。打开已有草稿时不再先闪一下「已发布」
  • 打字后仍等约 1 秒落盘,才变成「编辑中」

#AI 帮写

  • 桌面端「完成并写回」「取消」改用应用内确认框。系统确认框在桌面壳里不会弹出,所以之前点了没反应
  • 完成时只问「是否回写」:确认写入本地草稿,不自动发布;返回留在帮写界面

#手机端

  • 窄屏阅读顶栏增加拉取更新按钮

#v1.3.15

#升级

  • mdocs update 后命令可执行:覆盖安装时给 package.json 里的 bin 加上可执行位,避免升级后 /usr/bin/mdocs Permission denied

#附件下载

  • 非图片附件一律 application/octet-stream + Content-Disposition: attachment
  • 桌面壳遇到附件链接时交给系统浏览器下载,不再在窗口里打开预览

#手机端

  • 窄屏隐藏「AI 帮写」入口(欢迎页按钮、文档顶栏、助手打开帮写)

#v1.3.14

同 v1.3.13(npm 上 1.3.13 卡在 staged,改发此版本)。

#v1.3.13

#我的文章

  • 筛选区横向排布:搜索框与域/创建者/分组筛选同一行,聚焦态改为细边框,不再整块挤成竖排
  • 表格可读性:标题主次分明,日期 YYYY-MM-DD,操作列「邀请」次要、「打开」主按钮
  • 跳页:页脚支持「跳至」指定页码(回车或点跳转),超出范围自动夹到首尾页

#域管理

  • 改类型:行内分段控件(公开 / 受限 / 私有)+ 勾选确认 / 取消;不能下降的选项置灰,悬停才提示
  • 操作列层级:「成员…」主色按钮,重命名/改类型为文字按钮,删除为危险色;禁用态灰底可辨
  • 内置域:操作列改为「系统预设,不可修改」标签

#智能助手

  • query_my_documents:原 list_my_documents 改名;可按域/创建者筛选、分组,并用 offset/limit 翻页(与设置页「我的文章」对齐)
  • 全文检索仍用 search_documents

#v1.3.12

#域权限

  • 只能升级,不能下降:开放程度 private < restricted < public;更封闭返回 400
  • 有文档的域仍可升级权限;重命名/删除在有文档时继续锁定
  • Agent 工具 set_domain_permission 走同一规则

#我的文章

  • 支持按域、创建者筛选,以及按域/创建者分组(本页)
  • 列表行增加创建者信息;筛选参数均可不传

#附件下载

  • 桌面端 / 手机端点击文件链接可正常下载(Web 拦截 + 服务端强制 attachment + 壳层处理新窗口)

#智能助手

  • invite_document_user:按文档邀请访客(read / edit)
  • query_my_documents 的前身已支持筛选参数

#v1.3.6

#手机端

  • 目录树小三角:点击只展开/收起子目录,不再顺带激活文件夹。此前手机端展开目录时会把整个目录抽屉关掉
  • Markdown 文章顶栏:域选择和发布按钮恢复常驻单行;「可折叠操作栏」只对 HTML 文档生效(HTML 正文另有预览/编辑切换,顶栏更挤)

#目录树

  • 选中的文章常显图谱按钮:不再只在鼠标悬停时出现,「查看图谱」「生成图谱」对选中项保持可见

#v1.3.5

#知识图谱

  • 工具栏重构:左侧「标题 + 退出图谱」,右侧「层级控制 / 视图 / 配置 AI / 重新生成」
  • 退出图谱:红色实心按钮,桌面与手机都常显(此前只有手机端有个 ×)
  • 收纳:展开一级 / 展开到二级 / 全部收起 合并为「层级控制」下拉;「显示其它关系」「显示 doc 节点」合并为「视图」下拉
  • 标题:过长时截断显示省略号,悬停可看全名
  • 手机端:右侧操作全部收进 ⋯ 三点菜单(竖排卡片,与文档页三点菜单一致)

#手机端顶栏

  • 文档顶栏(DocChrome)操作栏改为可折叠:第一行「目录 + 标题 + 展开 + ⋯」,域选择/发布等收进第二行,默认折叠

#仓库

  • 新增 Android WebView 壳(侧载 APK)与 Tauri 2 桌面壳(macOS + Windows)源码,均不参与 pnpm build,也不进 npm 包

#v1.3.4

#登录 / 注册

  • 去 Tab:弹框不再用「注册 | 登录」双 Tab,默认显示登录
  • 登录下方「没有账号?点击注册」进入注册流程;注册流程内保留「已有账号?点击登录」可随时切回

#修复

  • 弹框层级:手机端展开侧边栏后,弹框不再被侧边栏遮挡(z-index 提升)

#智能助手

  • 项目信息:助手现在能回答项目官网和源代码仓库地址

#v1.3.3

#UI 优化

  • 编辑/预览开关:改为 iOS 风格浅色分段控制器(#F2F3F5 背景 + 白色滑块)
  • 顶栏按钮:次要操作(收藏、评论等)统一灰色线性图标,hover 变深灰
  • 侧边栏选中态:去掉绿色边框,改为浅灰背景 + 左侧绿色指示条
  • 布局:侧边栏背景 #FAFAFA,主内容区 #FFFFFF,空间层次更清晰
  • 树行间距:增加行高和内边距,呼吸感提升
  • 空白状态:新增引导图标与文案

#修复

  • HTML 预览模式下右侧不再显示重复的编辑按钮(由分段控制器统一切换)

#v1.3.2

#HTML 文档

  • 手机端顶栏:Header 改为占据空间(docked),与面板贴合,不再悬浮在内容上

#上传

  • 不再限制文件类型:任何扩展名均可上传,未知类型存为 .bin

#v1.3.1

#HTML 文档

  • 手机端默认预览:打开即预览,不再先显示源码
  • 编辑 / 预览切换移入手机端三点菜单

#v1.3.0

#HTML 文档(二期:DocChrome 顶栏)

  • DocChrome:Markdown 与 HTML 共用文档顶栏(标题 / 域选择 / 同步 / 发布 / 删除 / 收藏 / 文档信息 / 评论),窄屏 reader 同壳
  • HTML 帮写开放:工作台仍是 Markdown;进场以 HTML 原文为 seed,完成后写回 HTML 草稿
  • 政策表:删除 editor 列,改为按 fileType 分派编辑器;新增 aiWrite / comments 能力列
  • 修复 HTML「文档信息」面板添加邀请失败

详见 HTML 文档。

#智能助手

  • 修复:覆写 .html 文档时误传 Markdown 格式导致失败;现在按文件类型传对应格式(HTML 传原文),助手也不再声称「不支持写 HTML」
  • 工具:get_document 返回 fileType;create_document 可直接建 HTML;list_tree 结果含 HTML
  • 聊天体验:Mermaid 图不再因输入而重新渲染、切换会话不再闪「渲染中」;长回答上滑时新增「置底」按钮

#其它

  • 域级知识图谱顶层遍历改用文件类型政策表过滤(HTML 等不参与抽取)

#v1.2.2

#HTML 文档(一期)

  • 新建 HTML:侧栏「新建」下拉可选 Markdown / HTML;树中图标为 H
  • 预览与编辑:默认预览(iframe + sandbox="",不执行脚本);可手动切编辑(textarea 源码)/ 预览
  • 草稿与发布:与 Markdown 共用 IndexedDB 草稿壳(contentKind=html 存原文);乐观锁 / 冲突 merge 走原文三路,不经 Lexical 桥
  • 政策:不进全文搜索、不进知识图谱抽取;GET ?format=text 返回 HTML 原文
  • 二期预告:与 Markdown 共用顶栏(标题 / 域选择 / 同步等);AI 帮写是否接入 HTML 另议

详见 HTML 文档。


#v1.2.1

#修复与体验

  • 左侧目录树滚动:头尾固定,仅中间树列表滚动;悬浮层移出主壳,避免整页被正文撑高
  • DeepSeek 模型:默认改为官方名 deepseek-flash(V4.1 Flash);旧 deepseek-v4-flash / deepseek-v4.1-flash 等别名保存时归一;默认上下文 1M;deepseek-v4-pro 仍可选(将路由至 Flash)

#其它

  • 图谱与路径相关小改进

#v1.2.0

#Agent

  • 聊天 Mermaid:助手回复里的 mermaid 围栏默认渲染成图,可切「图谱 / 代码」;只存源码,前端翻译,不存 SVG
  • 图悬浮预览:点击图谱进入悬浮层,可拖动平移、滚轮/按钮缩放
  • PC 全屏对话:宽屏可切换助手面板全屏
  • 图谱焦点 Ask:打开知识图谱时,Ask 引用当前图谱缓存(只读),与文档焦点互斥

#知识图谱与其它

  • 单一焦点:同一时刻只聚焦文档或图谱之一,切换时互清编辑器/图谱主区
  • 文件类型政策:按类型控制读取/覆写(禁止覆写图谱等特殊文件);预留 HTML 类型
  • 设置页表格:收藏 / 我的文档表横向滚动包裹,窄屏更稳

#v1.1.2

#修复与体验

  • 拉取更新 + 本地草稿:落后且有未发布草稿时,「拉取更新」会打开合并视图,而不再静默无反应
  • AI 帮写 diff:接受/拒绝后布局不再因失焦整段 LCS 重算而「旧上新下」错位
  • 路径式文档链接:兼容 /doc/<id>,自动转到 HashRouter 的 #/doc/<id>
  • 手机图谱详情:窄屏下节点详情全屏铺满图谱区,便于阅读关闭
  • 附件上传:放宽 PDF MIME 校验;PDF 强制下载;插入附件文件选择器补上 pdf/zip 等扩展名

#v1.1.1

  • Markdown 粘贴转换:多段落正文不再只剩一级标题;嵌套列表父项与子项可完整保留(依赖 @fgbg/lobe-editor@1.0.0-fork.21)
  • 编辑器依赖:升级 @fgbg/lobe-editor@1.0.0-fork.21

#v1.1.0

#知识图谱

  • 异步生成队列:点「生成图谱」入队后台执行,支持排队 / 进度面板 / 任务日志轮询
  • 按篇进度:目录与域构建按叶子文章上报进度(不再只有「整包 1/1」)
  • 协作式让出:长时间构建会按时间片 yield,避免占满并发槽
  • 修复任务 ID 错位:目录 file_type 为 dir 时误标成 doc,导致轮询 not_found、进度条闪退(后台其实在跑)
  • 生成默认走缓存:force: false,干净缓存可复用;脏数据才会重抽
  • 队列文案:下一位显示「即将开始」,不再出现「前面还有 0 个任务」
  • 目录树图谱入口:悬停操作改为 SVG 图标;长标题省略 + 悬停全名

#体验与其它

  • 手机阅读顶栏:常用操作保留,更多收入菜单,减轻窄屏拥挤
  • CI:GitHub Pages 部署相关 Action 升级到 v5

#v1.0.0

#知识图谱 🧠

  • 三级构建:文章 / 目录 / 域,自下而上 AI 归纳概念与关系
  • 两种节点:文档节点 + 概念节点
  • 四种关系:包含(contains)、相关(related_to)、部分(part_of)、依赖(depends_on)
  • 力导向图可视化:可拖拽、缩放、悬停高亮;右侧详情面板展示节点信息
  • 脏缓存机制:正文改动超过阈值才标脏重算,小改不触发 AI
  • 异步生命周期:删/挪/发布后后台更新图谱,不阻塞主链路
  • 入口:目录树悬停按钮、域侧栏「知识图谱」按钮

#AI 智能助手 🤖

  • 多供应商配置:DeepSeek 预设 + 自定义供应商,一人可存多条配置
  • 极简自定义:只需填 baseUrl / modelId / apiKey 三个字段
  • 协议自动识别:URL 含 anthropic 自动切换 Anthropic 协议
  • apiKey 文件存储:从数据库迁移到 ~/.mdocs/secrets/,文件权限 0600
  • 默认配置切换:多配置时可设默认,一键切换
  • 内嵌配置卡片:助手面板直接填 Key,不用跳转设置页

#其他

  • 设置页 AI 配置全面翻新:列表视图、创建/编辑/删除/设为默认
  • 帮写工作台适配多供应商配置

#v0.8.25

  • mdocs update 抗缓存:查最新版本与 npm pack 使用临时空 --cache,不再被本机 ~/.npm 里旧的 packument 钉死(--prefer-online 仍可能读到缓存)

#v0.8.24

  • 手机正文顶满:窄屏文档左右留白改为约 5px(PC 仍为 50px)
  • 手机助手全屏:窄屏 Agent 面板铺满、FAB 不可拖;PC 浮层拖动不变
  • Ask 挂载上下文:每轮对话把当前 domainId / 打开中的 documentId 写入 system(不预拉全文;读正文仍走 tool)
  • 合并内联 UI:冲突改为单栏红(我的)/ 绿(别人的);接收=用别人的、拒绝=用我的;全部用我的 / 全部用别人的;未决议完只读,决议完再编辑发布

#v0.8.23

  • 手机阅读壳:窄屏侧栏改为抽屉(默认不占宽);文档顶栏浮条/可吸附,隐藏域选择与帮写;设置页同样可收起左侧 Tab
  • 窄屏发布/删除:浮条上提供紧凑发布、删除入口
  • mdocs update:查最新版本时加 --prefer-online,避免本机 npm 缓存把 latest 钉在旧版
  • Markdown 文字颜色往返:编辑器内设置的文字色 / 背景色可写入 Markdown(<span style="color: …"> / background-color),再导入时还原;段落与表格单元格均支持,代码块内忽略(依赖 @fgbg/lobe-editor@1.0.0-fork.20)
  • 编辑器依赖:升级 @fgbg/lobe-editor@1.0.0-fork.20

#v0.8.22

  • 帮写 inline diff:有未接受提案时强制进入 inline diff(不可切回源码);相同行 / 绿增可改提案,红删只读;写回仍以已接受的 currentMd 为准
  • AI 设置滚动:设置页「AI 配置」上下卡片可完整滚动,不再被截断
  • mdocs version:CLI 输出当前安装包版本(亦支持 -v / --version)
  • 目录子树 API:GET /api/documents/folder/:folderId/tree 返回精简树(目录/文章 + id/标题)
  • 停止生成:智能助手与帮写支持中途停止(断开 SSE)

#v0.8.21

  • 思考流可见:智能助手与帮写均展示 DeepSeek thinking(可折叠「思考中」),长时间等待不再像掉线
  • 帮写编辑:接收中与默认均可直接改「我的稿」;有提案时点「查看 diff」进入只读审阅
  • 取消等待:选择卡 / Skill 表单支持取消;有倒计时卡时关闭助手会确认是否强制退出

#v0.8.20

  • 私人 Agent Skills:设置 → AI 可 CRUD 私人提示词宏(名称对本账号唯一,仅英文数字下划线);智能助手 / 帮写可按名称引用,落盘只存引用,请求时再展开进上下文
  • 助手可管理 Skill:list_user_skills / create_user_skill / update_user_skill / delete_user_skill;新建与修改弹出带倒计时的表单卡
  • mdocs update:全局安装后从淘宝 npmmirror 原地升级,保留已有 node_modules,依赖走 --prefer-offline(已缓存的不再重复下载)

#v0.8.19

  • Meta2d 按需加载:文档没有流程图时不下载 @meta2d;有图 / 插入图 / 打开编辑时再加载
  • 流程图属性「Text」输入:防抖写回画布,不再每敲一字全量重绘(依赖 @fgbg/lobe-editor@1.0.0-fork.19)
  • 构建:Vite 将 @meta2d / canvas2svg 单独拆成 meta2d chunk

#v0.8.18

  • 首屏加速:编辑器 / 设置 / 助手 / 帮写按需懒加载;Vite 拆分重型 vendor chunk,入口 JS 从约 6MB 降到约 134KB
  • 更快看到侧栏树:启动时延后全文索引重建(默认约 15s,可用 MDOCS_INDEX_INITIAL_DELAY_MS 调整),减轻 HTML TTFB 被 CPU 拖慢
  • 加载壳:index.html 增加「mdocs 加载中…」占位,减少白屏感

#v0.8.17

  • AI 双模式定位明确:智能助手(Ask)偏低交互——可答疑、搜文、结构操作,也能直接全文覆写;帮写(Coding)偏高交互——左聊右 Diff、按段接受、你拍板后才写回
  • 智能助手:覆写选择卡:有正文时请求写作,弹出三选一:直接覆写 / 打开帮写审阅 / 取消
  • 智能助手:写后同步:覆写成功后若当前打开该文档,自动触发拉取更新逻辑,刷新 headCommitId
  • 帮写欢迎文案:明确「精细改稿请用帮写」,不再说「不协助写作」
  • 官网文档:补充双模式 8 维度对比表,更新首页卖点

#v0.8.16

  • 帮写(coding):编辑器顶栏 / 欢迎页入口进入全屏工作台;左 AI、右纯 Markdown;按段接受/拒绝提案后再写回(已有文进草稿,空白帮写可新建)
  • 帮写上下文:每轮请求携带进场快照与当前工作稿;助手可「读取帮写工作稿」后再「设置帮写正文」,避免盲改
  • 帮写会话:独立于上手助手;按文档隔离(A 文 / B 文各自历史);空白帮写写回成文后会话绑到新文档
  • 附件上传:支持 zip 与常见音频;单文件上限 55MB
  • 编辑器依赖:@fgbg/lobe-editor@1.0.0-fork.17

#v0.8.15

  • 智能助手读文:新增 get_document 工具,按当前访客读权限读取文档正文(与 HTTP 鉴权一致,无额外特权)
  • 助手时间线 UI:对话中按顺序插入工具结果(搜文/域树表格、读文预览卡等),默认折叠;历史重开不回放工具 UI
  • 代码块复制:助手回复里的 Markdown 代码块支持一键复制

#v0.8.14

  • 发布包修复:prepack 现会执行完整 pnpm build,避免只升版本号却打出旧 dist(此前 0.8.12/0.8.13 缺文档拖拽移动、可拖动助手入口等)
  • 手册:补充小服务器安装(Swap、ENOTEMPTY、低内存 npm install -g)

#v0.8.13

  • 修复空文档白屏:空 markdown / Lexical children: [] 打开时补空段落,避免 editor 全局崩溃
  • 手册:补充小服务器安装(Swap、ENOTEMPTY、低内存 npm install -g)

#v0.8.12

  • 文档移动:侧栏可拖拽 Markdown 文档到文件夹 / 同目录文章旁 / 域根;仅创建者后端成功;POST /api/documents/:id/move
  • 上手助手入口:悬浮按钮可按住拖动定位,位置写入本地;支持重置;面板随入口侧移
  • 空文档白屏:AI/空 markdown 创建的 Lexical children: [] 会在打开时补空段落,避免编辑器整页崩溃
  • Agent:建文/建文件夹/移动后刷新侧栏树;新增 move_document 工具

#v0.8.11

  • 上手助手会话:浮层支持「+」新建会话、历史列表切换并回放;标题取自首条用户消息
  • 手册:上手助手(AI) 同步会话管理说明

#v0.8.10

  • 上手助手(AI):左下角浮动入口;设置页「AI」配置个人 DeepSeek Key;按访客落盘会话(tenant/<id>/agent/session),多轮续聊;回答引用手册页面链接;思考中三点动画;跟随滚动仅在贴底时生效
  • 手册:新增 上手助手(AI)

#v0.8.9

  • 编辑器依赖:升级 @fgbg/lobe-editor@1.0.0-fork.16——导出 INSERT_MARKMAP_COMMAND,斜杠 Markmap 使用正式 command API
  • 编辑器顶栏:撤销/重做后新增「文档顶部插入空行」「文档末尾插入空行」
  • 斜杠菜单:增加 Meta2d、Markmap 快捷插入
  • 发布后视口:服务端正文与刚发布内容一致时不再整棵 setDocument 重挂,减轻 Mermaid 等块导致的跳动

#v0.8.8

  • 编辑器依赖:升级 @fgbg/lobe-editor@1.0.0-fork.15——仅当反引号之间有内容时才转为行内代码,避免空 `` 抢占导致无法输入 fenced 代码块;并补充 Meta2d 斜杠插入后自动打开编辑器

#v0.8.7

  • 发布后视口跳动:发布成功后仍会拉取最新 meta / head 并清除本地草稿,但当服务端正文与刚发布内容一致时,不再对编辑器执行整棵 setDocument 重挂,避免 Mermaid 等块因 DOM 重建导致视觉窗口跳动
  • 编辑器依赖:升级 @fgbg/lobe-editor@1.0.0-fork.14(Mermaid 渲染结果缓存与加载占位,减轻重挂场景下的高度塌陷)

#v0.8.5

  • 目录描述版本链:新建文件夹时自动创建的 ___desc___.md 现在与普通文档一样写入首版 commit 和 headCommitId;升级后启动时会为历史上缺少 head 的目录描述从磁盘补迁移,修复「无法发布:缺少版本基准」
  • 自动发布失败打标:任意自动发布失败(缺版本基准、404、API 错误等)都会在 IndexedDB 草稿上写入 publishError,自动扫描会跳过重试;可在设置页「未发布草稿」查看失败原因并手动重试或另存
  • 合并页懒加载:MergeView 改为按需加载,减小首屏主包体积

#v0.8.4

  • 前端体积:升级 @fgbg/lobe-editor@fork.13,Shiki 语法高亮仅保留约 40 种常用语言(见下方列表),dist/web 资源文件减少;冷门语言代码块以纯文本显示,内容不丢失

#v0.8.3

  • 静态资源压缩:Express 启用 gzip(compression),JS/CSS 等响应带 Content-Encoding: gzip,首屏传输量显著下降
  • 静态资源缓存:/assets/*(带 hash 的文件)设置 Cache-Control: public, max-age=31536000, immutable,二次打开更快

#v0.8.2

  • 全局安装 Web UI:修复 npm install -g 后访问 / 显示 Cannot GET /——前端静态目录改为相对安装包路径解析,不再依赖启动时的当前工作目录

#v0.8.1

  • 服务监听地址:默认 MDOCS_HOST 从 127.0.0.1 改为 0.0.0.0,服务器部署后外网可直接访问(本地仅本机可设 MDOCS_HOST=127.0.0.1)

#v0.8.0

  • CLI 全局安装:修复 bin/mdocs.js 无执行权限导致 npm install -g 后 mdocs: Permission denied 的问题

#v0.7.9

  • 前端文档状态重构(activeDocMeta):
    • 当前打开文档的服务端元信息(权限、路径、head、标题等)与正文分离:正文由编辑器 + IndexedDB 草稿承载,不再写入混合的 activeDoc 对象
    • 打开文档:有草稿则只加载草稿正文,否则加载服务器正文;meta 始终来自 GET
    • 发布成功(手动 / 自动):删除本地草稿 → 再 GET → 刷新 meta 与编辑器,修复单用户自动发布后误报版本冲突
    • 按文档串行队列处理自动保存与自动发布,降低 publish 与 save 交错导致的 commit 滞后
    • 有未发布草稿时不做 sync「落后」轮询,减少与本地副本冲突的提示噪声
    • 发布后编辑器仅原地更新内容,避免整页 remount 闪烁
  • 合并(Merge)体验:
    • 409 / diverged 时提供三栏合并界面(本地 / 结果 / 远端),行内处理差异块
    • 服务端 GET .../merge-context 提供合并祖先(LCA)正文,用于三路对比
    • 合并发布成功后同样删草稿并拉取最新文档

#v0.7.8

  • 草稿副本模型收敛:
    • 草稿以 documentId 为主键,保存正文与开编基准 commit(baseCommitId),并在首次编辑落盘时携带文档快照信息,后续自动保存只更新内容相关字段
    • 发布冲突(409)统一进入冲突处理流程,避免普通错误提示与 merge 提示重复弹窗
  • 同步 / 拉取行为简化:
    • 有未发布草稿时,不再执行覆盖式 pull,避免本地副本被意外覆盖
    • 无未发布草稿时,点击「拉取更新」会直接拉取远端最新内容并刷新编辑区
    • 修复“拉取后数据已更新但编辑器 UI 未同步”的问题
  • 权限一致性修复:
    • 前端编辑权限判断回到服务端最新文档元信息,避免草稿旧 meta 造成“看起来可编辑但发布被拒绝”的误判
    • 后端修复 public 域下 public_read 文档 + invite(edit) 的编辑判定(被邀请编辑者现在可正常发布)
  • 错误提示机制统一:
    • API 错误由网络层统一分发,App 全局统一弹窗处理
    • 右下角提示保留为 success/info 反馈,并统一为灰框样式

#v0.7.7

  • 评论功能体验优化:
    • 评论内容保留换行显示:在 .mdocs-comment-content 增加 white-space: pre-wrap,发出的评论保留输入时的换行和空格,不再被折叠成一坨
    • 评论面板宽度可拖动:左边缘新增蓝色拖拽条,支持 280px ~ 600px 自由调整
    • 评论输入框高度可拖动:输入框顶部新增灰色拖拽条,按住向上拖让输入框变高(60px ~ 600px),适合写长评论
    • 实现说明:放弃浏览器原生 resize: vertical(只能从右下角往下拖),改用 React state + 自定义顶部 handle,textarea 高度由 state 接管
    • 详见 fgbg-docs/comments-panel-resize.md
  • 评论输入区布局优化:
    • 字符计数改为浮动显示在输入框右下角,不再独占一行,节省 ~30-40px 垂直空间,评论列表可显示更多内容
    • 输入区域上下 padding 从 16px 精简为 12px,拖拽手柄尺寸缩小为 32×3px,整体更紧凑
    • 详见 fgbg-docs/comments-layout-optimization.md
  • 评论输入框高度自动适配:
    • 输入换行自动撑高输入框,删空自动缩回默认高度(80px),无需手动拖拽
    • 高度上限 300px,超出后显示滚动条
    • 与手动拖拽逻辑不冲突,拖拽后内容变化仍可自动适配

#v0.7.6

  • Demo 模式完善:补全缺失的 Mock API,消除 501 错误
    • 新增书签 Mock API:收藏/取消收藏/收藏列表
    • 新增评论 Mock API:发表/查看/删除评论
    • 新增文档邀请 Mock API:邀请访客/移除邀请/查看邀请
    • 新增我的文档 Mock API:按所有者过滤文档
    • 新增访客目录 Mock API:返回访客列表
  • Demo 模式 UI 优化:
    • 隐藏无意义的退出登录按钮
    • 设置页新增黄色提示条,说明 Demo 模式限制
    • 优化 Demo Banner 文案:"部分功能被禁用,请勿长期存储重要数据"
  • 编辑器收藏状态可视化:在域下拉框右侧新增收藏状态按钮
    • 实心黄色星标 + "已收藏" 文字直观显示当前文档收藏状态
    • 空心灰色星标表示未收藏,点击一键切换
    • 与文档信息菜单的收藏状态双向同步
  • Bug 修复:
    • 修复设置页「我的收藏」列表显示域 ID 而非域名称的问题,现在加载域列表并通过 ID → 名称映射正确显示
    • 修复切换设置页后返回文档丢失编辑内容的问题:DocumentEditor 挂载时主动检查 IndexedDB 草稿,若内容与服务器版本不同则自动恢复草稿内容和标题
    • 修复 useAutoSave Hook 中 useCallback 依赖循环导致监听器反复注册的性能问题
  • Vite 依赖预构建优化:增加 optimizeDeps 配置,优化首次冷启动速度

#v0.7.5

  • 修复 Markdown 粘贴列表时 listItem 被错误拆分:升级 @fgbg/lobe-editor 至 1.0.0-fork.12
    • 根因:listItem markdown reader 通过 children.map() 返回数组,解析器的 .flat() 将数组展平导致单个 list item 被拆成多个独立节点
    • 症状:粘贴 1. **开关关闭时**:不查询果切任务 时,有序列表被拆成两个 listItem(value=1 和 value=2)
    • 修复:reader 改为返回单个节点,嵌套列表和 paragraph children 正确合入同一个 listItem
    • 详见 fgbg-docs/references/listitem-parsing-bugfix.md

#v0.7.4

  • 从上游根本解决编辑器内容溢出问题:升级 @fgbg/lobe-editor 至 1.0.0-fork.9
    • 表格宽度溢出修复:在 .editor_table_scrollable_wrapper 增加 min-width: 0,解决 flex 布局下宽表格撑开父容器的经典问题
    • 图片宽度溢出修复:在 .image / .blockImage 样式中增加 img { max-width: 100% !important; },防止大图片横向撑开编辑器
  • 修复 Outline 大纲被挤出视野:给 Editor + Outline 共享的外层 Block 增加 minWidth: 0,确保左侧目录树展开时,大纲不会被宽表格挤出视野
  • 保留 mdocs 侧补丁作为双重保险:待上游稳定后可移除
  • 升级 @fgbg/lobe-editor 至 1.0.0-fork.10(仍属 v0.7.4 产品线,仅上游编辑器迭代;mdocs 应用包版本号未改):
    • Markmap:---markmap--- 正确注册 IMarkdownShortCutService;嵌套 textarea 粘贴不再走主编辑器 Markdown 粘贴链路;预览区按钮可右下角;新增一键展开/折叠全部节点,节点数超过 30 个时默认全部折叠;修复左侧 markdown 编辑器无法全选问题(Cmd/Ctrl+A 事件被 Lexical 全局拦截,需 stopPropagation)
    • 链接:左键重复打开链接编辑浮层;⌘/Ctrl+单击或中键新标签打开;修复异步场景 getLatest 报错(改为 read + $getNodeByKey);EDIT_LINK_COMMAND 移至 LinkNode.ts

#v0.7.3

  • 新增 Markmap 思维导图支持:在 ```markmap 代码块中输入 Markdown 即可渲染为可交互思维导图
    • 实时预览:编辑 Markdown 时下方实时渲染思维导图
    • 全屏预览:点击图表进入全屏模式,支持缩放、拖拽
    • 错误处理:语法错误时显示友好的红色错误提示
    • 交互一致:与 Mermaid 流程图的交互行为完全相同
    • 升级 @fgbg/lobe-editor 至 1.0.0-fork.7
  • 修复编辑器图片宽度溢出问题:增加 .mdocs-editor-content-area img { max-width: 100% !important; } 样式规则,覆盖 Antd Image 组件的内联样式,防止大图片横向撑开编辑器容器

#v0.7.2

  • 修复登录接口被 auth 中间件拦截的问题:新增 /visitors/login 到豁免路径白名单,解决登录时提示 missing visitor token 的错误

#v0.7.0

  • 新增登录密码功能:解决跨浏览器/跨设备登录痛点,访客可设置密码,在任何设备使用「用户名+密码」登录
    • 注册弹窗改为 Tab 结构:左侧注册、右侧登录,无需跳转页面
    • 注册两步流:输入名称 → 可选设置密码
    • 登录支持两种方式:用户名密码 / 恢复码
    • 设置页新增「登录密码」管理卡片,可随时修改密码
  • 多设备同时在线:新增 visitor_sessions 会话表,支持多个设备同时登录同一账号,互不干扰
  • 向后兼容:未设置密码的访客仍可在原设备正常使用;所有已存在账号默认密码为 1234,登录后可自行修改

#v0.6.9

  • 升级 @lobehub/editor 至 1.0.0-fork.6,同步上游修复:
    • 修复 Meta2d 弹窗按钮暗色模式不可见:DiagramEditor 弹窗硬编码 background: '#fff' 但未重置文字颜色,暗色主题下所有按钮(撤销/重做/删除/适应/100%/关闭)白底白字。加 color: '#000' 修复
    • Meta2d 流程图 SVG 预览导出稳定:SVG 导出优先用当前编辑实例而非隐藏实例重放,修复多 pen 场景部分导出为空
    • 修复划词 ColorPicker 选色后跳回黑色:selection 为 null 时保留上次检测到的颜色值
    • Locale 深合并 + BlockImage 插入光标流:
      • registerLocale() 改为深合并,避免插件注册 {codemirror:{...}} 时覆盖已有 meta2d.editor 等嵌套 key
      • BlockImageNode 通过 ---meta2d--- 或粘贴插入后,自动创建空白段落并定位光标,不再卡在图片后无法继续输入

#v0.6.8

  • 修复划词 ColorPicker 选色后跳回黑色:修复选中文本后通过浮动工具栏的 ColorPicker 设置颜色时,颜色面板立即跳回黑色的问题。根因为 useEditorState 在 selection 为 null(如 ColorPicker popup 导致编辑器失焦)时错误清空了 textColor/bgColor,现改为保留上一次检测到的颜色值,避免无选区时误判格式状态
  • 升级 @lobehub/editor 至 1.0.0-fork.4,同步上游修复:
    • 修复编辑器销毁泄漏:ReactEditor 和 useEditor 增加 destroy() cleanup,配合 pendingDestroyRef + queueMicrotask 兼容 StrictMode remount
    • Markdown 粘贴智能检测:移除评分机制改为始终转换,代码块内粘贴防光标跳转,Mermaid 错误友好提示,空链接 Enter 自动转换
    • Meta2d 流程图预览修复:SVG 预览与下载尺寸对齐,过滤 isShowChild=false 的 pens,高大预览图自动居中并支持滚动
    • 工具栏状态即时更新:移除 500ms debounce,加粗/斜体/颜色等状态立即响应
    • 大纲工具栏切换:新增 useOutlineActionItem,工具栏可一键展开/折叠大纲面板

#v0.6.7

  • 草稿发布失败恢复机制:自动发布遇到服务端文档不存在(404)时,草稿不再静默丢失或无限循环报错,而是标记为发布失败状态并通知用户;用户可在草稿列表页点击「另存为新文档」,通过域选择器 + 目录树选择目标位置,将草稿内容作为全新文档重新发布
  • 修复 Lexical 编辑器内存泄漏:修复切换文档时内存飙升至 40GB 的致命问题。根因为 @lobehub/editor 的 ReactEditor 组件创建编辑器实例后从不调用 destroy(),且 DocumentEditor 使用 key 强制重新挂载导致每次切换都泄漏一个完整的编辑器实例(含 CodeMirror、Meta2d Canvas、图片等 DecoratorNode 资源)。上游 ReactEditor 和 useEditor() hook 已增加 destroy() cleanup,mdocs 侧移除多余的 key 并增加防御性清理
  • 兼容 React StrictMode 的编辑器生命周期:修复 StrictMode 开发环境下 editor.destroy() 后重新挂载导致 DataSource for type "json" is not registered 报错。采用 pendingDestroyRef + queueMicrotask 延迟取消模式:cleanup 中把 destroy 排队到 microtask,若紧接着是 StrictMode remount 则同步取消,真正卸载时才执行销毁
  • 批量修复异步组件卸载泄漏:为 CommentsPanel、SettingsPage、DraftListPage、RecoveryDialog、DocumentEditor 的异步请求增加卸载保护。CommentsPanel 采用 expectedDocumentIdRef 竞态保护丢弃旧请求;其余组件采用 mountedRef 模式防止卸载后 setState
  • 浏览器资源泄漏清理:修复 Playground 中 URL.createObjectURL 未 revokeObjectURL 的问题;修复 actions.ts 文件选择器在 Safari 中取消后 DOM 节点未移除的问题(增加 5s 兜底超时);修复 Playground 卸载后 window.editor 和 debounce 定时器未清理的问题

#v0.6.6

  • 设置页面大改版:重新组织设置导航,新增「我的收藏」和「我的文章」两个独立 Tab
  • 我的收藏表格视图:收藏列表改为表格布局,支持标题搜索,显示域名、作者、收藏时间四列
  • 我的文章列表:集中展示当前访客创建的所有文档,按更新时间倒序排列;支持标题/域名搜索;每篇可直接打开或邀请成员
  • 文档邀请快捷入口:我的文章列表每行新增「邀请成员」按钮,无需打开文档即可配置访问权限

#v0.6.5

  • 自动保存性能优化:修复 useAutoSave Hook 中 useCallback 依赖循环问题,使用 useRef 保存频繁变化的值,避免 Lexical 监听器反复注册注销,减少不必要的性能开销
  • 切换文档竞态修复:修复快速连续切换文档时,旧请求后返回导致编辑器内容与 URL 中 documentId 不匹配的问题,新增 expectedDocIdRef 竞态检查机制
  • 评论列表性能优化:CommentsPanel 评论列表渲染从 O(n*m) 优化为 O(n),使用 useMemo + Map 单次遍历完成根评论与回复分组,同时顺便计算未删除评论总数
  • 编辑器初始化优化:移除 DocumentEditor.handleInit 中重复的 JSON.parse 逻辑,直接复用已预计算的 contentType
  • 代码清理:删除已标记 @deprecated 的 deleteFolderApiV0 函数(已被递归删除目录的 deleteFolderApi 替代)

#v0.6.4

  • 文档邀请成员:编辑器工具栏文档信息菜单新增「邀请成员」入口,可邀请访客以只读或编辑权限协作文档
  • 邀请权限选择:邀请弹窗中右侧已选成员列表新增 MiniSelect 下拉框,可为每个被邀请人独立设置「只读」/「可编辑」权限
  • MiniSelect 组件:新增紧凑型通用下拉组件,支持点击外部关闭、Escape 键、键盘可访问
  • 邀请编辑 Bug 修复:修复了被邀请用户虽然能通过后端鉴权但前端编辑器仍以只读模式渲染的问题 — 后端 getDocument() 现在返回 invitedEdit 标记,前端 canEdit 计算补充 invite 检查
  • 后端权限修正:canEditDocument() 在 private 域各权限档位下补充 document_invites 检查,被 invite edit 的非创建者现在可正常编辑
  • 10 条新增单测:覆盖 invite read/edit 跨所有权限档位(private/domain_read/domain_write/public_read/public_write)

#v0.6.3

  • 文档信息菜单:编辑器工具栏新增三条线菜单按钮,可查看文档元信息(创建者、创建时间、大小、上次编辑),支持快速收藏/取消收藏
  • 文档权限修改入口:文档信息菜单中预留权限修改入口(后续版本开放完整功能
  • 收藏功能:侧边栏新增「我的收藏」入口,支持一键收藏/取消收藏文档,已删除文档的收藏保留显示便于手动取消
  • Lucide SVG 图标:收藏、退出登录按钮统一使用 Lucide SVG 图标替代 emoji,hover 时有缩放和颜色变化的视觉反馈
  • 收藏弹窗大改版:「我的收藏」弹窗重构为表格布局(<table>),标题/域/作者/收藏时间四列对齐;新增名称搜索框和域筛选下拉;每行新增📖快速打开按钮;操作按钮支持即时 tooltip;标题超长时自动截断并显示原生 tooltip;取消收藏有淡出动画
  • 作者与收藏时间显示:后端 LEFT JOIN visitors 表获取文档作者名,前端每行展示作者 + Intl.RelativeTimeFormat 相对时间(自动适配中英文)
  • Cookie 有效期延长:身份 Cookie 从 1 年延长到 10 年,实现"永久"登录体验
  • 登录态稳定性优化:修复因请求头占位符覆盖有效 Cookie 导致刷新后需要重新登录的问题

#v0.6.2

  • 访客名称全局唯一:visitor_name 增加数据库 UNIQUE 约束,避免同名混淆
  • migrate 支持按名称迁移:pnpm mdocs visitor migrate --from Alice --to Bob,不再需要输入 UUID
  • 个人域路径处理移到后端:前端不再需要 visitorId 判断路径,Tree API 自动根据当前访客身份返回美化后的路径
  • 登录态 BUG 修复:修复了因请求头占位符覆盖有效 Cookie 导致刷新后需要重新登录的问题

#v0.6.0

  • 访客恢复码:新增访客身份恢复机制,生成一次性恢复码,丢失浏览器本地 token 后可凭码恢复访客身份及所有文档权限

#v0.5.0

  • 全文搜索:新增 FTS5 搜索引擎,支持中文分词(jieba),在搜索框输入关键词即可按 BM25 相关性排序检索全库文档
  • 后端 Markdown 转 Lexical:编辑器和 API 支持直接传入 Markdown 文本,后端自动转换为 Lexical JSON 存储。CLI 客户端 create / update 默认使用 contentFormat: 'markdown'
  • 域切换持久化:刷新页面后域选择不丢失,自动恢复到上次浏览的域
  • mdocs-cli 命令行客户端:新增独立 CLI 工具仓库 https://github.com/xuhuafeifei/mdocs-cli,提供 search、get、create、update、domains、mkdir 六个命令,Token 在设置页创建

#v0.4.0

  • CLI Token:新增命令行身份令牌,可在设置页创建/重置,支持 x-cli-token 认证头,继承访客所有权限
  • ConfirmDialog 组件:通用确认弹窗,替代原生 window.confirm

#v0.3.0

  • 显式目录模型:引入 file_type('dir' / 'md')和 parent_id,目录不再是路径切割的产物
  • 空目录支持:可以创建没有子文档的空目录
  • 磁盘路径域隔离:每个域拥有独立的磁盘子目录(~/.mdocs/files/docs/{domain_id}/),不同域同名文件不再冲突
  • 目录描述文件改名:从 desc.md 改为 ___desc___.md,避免与用户创建的文件冲突
  • 新建目录接口:新增 POST /api/folders,创建目录时自动创建 ___desc___.md
  • 树构建优化:按 parent_id 一次查询建树,不再递归切割路径

#v0.2.0

  • 权限模型重构:从四级权限升级为五级权限(private → domain_read → domain_write → public_read → public_write),invite 从档位改为独立叠加层
  • 域约束生效:public / restricted 域类型现在限制域内文档可选档位(public 仅 3/4,restricted 仅 1/2)
  • 邀请互斥:域成员不能再被 invite,减少权限混淆
  • 鉴权收拢:所有权限判断集中在统一模块,不再分散在各服务和中间件
  • 受限域(restricted domain)支持

#v0.1.0

  • 项目初始化
  • 基于 Lexical 的富文本编辑器,支持标题、表格、代码块、数学公式
  • Meta2d 流程图拖拽编辑器
  • SQLite + 文件系统存储
  • 无账户访客身份识别(UUID token + SHA-256)
  • 域隔离(公共域 + 个人域)
  • 文档级邀请协作(只读 / 编辑)
  • IndexedDB 本地草稿自动保存
  • 中英文双语界面