现行文档里,产品概念「域」已改称 工作空间。下面各版本仍按当时的叫法记录。
> [!NOTE]@fgbg/lobe-editor@1.0.0-fork.44升级:mdocs update 或 npm i -g @fgbg/mdocs@3.1.16;服务器亦可 pack 覆盖。
.job:欢迎页 / 侧栏可新建定时任务;树中可见,服务端权威(无草稿、无 sync-status 轮询)job_append_data、联网工具).job 存 Job/Monitor 配置;运行流水与采集点落 SQLite升级:mdocs update 或 npm i -g @fgbg/mdocs@3.1.13;服务器亦可 pack 覆盖。
engram.md 使用说明;系统提示补「先搜再写」记忆指引;记忆数据落 tenant/<访客>/plugins-data/engramdiff-hunk 会被 Merge 桥吃爆;现压掉 hunk、拉前刷盘,并用合并页 ErrorBoundary 兜底升级:mdocs update 或 npm i -g @fgbg/mdocs@3.1.7;服务器亦可 pack 覆盖。
曾 stage 未正式上架;能力并入 v3.1.7。
[meme:id];单条消息最多 5 张create_user_skill 只打包指令;需要 clone/安装走插件流水线- 开头;目录段不能是纯 -)升级:mdocs update 或 npm i -g @fgbg/mdocs@3.1.5;服务器亦可 pack 覆盖。
git@ / ssh://)与 https;禁止交互登录(BatchMode / 清 credential helper)升级:mdocs update 或 npm i -g @fgbg/mdocs@3.1.4。
engram.pipeline.yaml 时曾种成只有 extract;现内嵌完整母版,启动时自动修复 stub,并拷贝 bundled 进 dist升级:本机/服务器 pack 覆盖;或稍后 npm i -g @fgbg/mdocs@3.1.3。
plugins-home/<name>/;租户 plugins-data / mcp / skills;Engram 连接时绑访客 ENGRAM_DATA_DIRplugins-home(相对 dest,仅 https)install_pipeline 可顺手安装;query_skill / list_plugin_home / run_plugin_cli(白名单 CLI,相对路径)HOME 控写路径;MDOCS_PLUGIN_* 仅合约信号(见 ADR 018)升级:本机/服务器 pack 覆盖(GitHub 超前于 npm 时);或稍后 npm i -g @fgbg/mdocs@3.1.2。
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。
react-markdown 只读预览升级:服务器包更新,或稍后 npm i -g @fgbg/mdocs@3.0.2。
/ 与 /doc/:id 不再各挂一份 App;预览加错误边界,切版本保留旧预览@fgbg/lobe-editor → 1.0.0-fork.30)pending diff; resolve before applying more ops升级:mdocs update 或 npm i -g @fgbg/mdocs@3.0.1。
大版本:智能助手 × Lobe Inline Diff 审阅写文,以及可配置上传上限。
.md / Lexical)update_slot / insert_after_slot / remove_slot / overwrite_all(整篇 LCS)经 SSE 写入当前打开编辑器,物化为红绿 DiffHunkget_document_lexical_lines 供 Agent 看外层块;HTML / sheet 不走 Lobe Diff(HTML 仍用落盘覆写;表用 sheet_*)overwrite_document / append_document / replace_document_markdown 与 Diff 两套并存(后续可能按 mode 裁剪工具集)1.0.0-fork.28(slot Diff API + 相邻红绿 hunk 贴紧)MDOCS_MAX_UPLOAD_BYTES;落盘 ~/.mdocs/server-settings.jsonGET/PUT /api/server-settings升级:mdocs update 或 npm i -g @fgbg/mdocs@3.0.0。
listitem 下直接挂文字(无 paragraph)时不再导出成空的 -;get_document(format=md) 能还原正文1.0.0-fork.27(选中图片可下载)升级:mdocs update 或 npm i -g @fgbg/mdocs@2.1.10。
:hover 撑开)升级:mdocs update 或 npm i -g @fgbg/mdocs@2.1.9。
升级:mdocs update 或 npm i -g @fgbg/mdocs@2.1.8。
suggest-merge-resolutions)suggest-merge-message(不再复用普通发布说明)get_editor_draft 按需静默取浏览器本地草稿(SSE+requestId);再 suggest_document_merge / suggest_document_merge_message升级:mdocs update 或 npm i -g @fgbg/mdocs@2.1.7。
升级:mdocs update 或 npm i -g @fgbg/mdocs@2.1.6。
>:MD↔Lexical 往返保留;避免 replace 后丢块升级:mdocs update 或 npm i -g @fgbg/mdocs@2.1.5。
auto / manual / agent / cli);自动发布固定「自动发布」update --message(source=cli)append / replace / overwrite 成功后,若正打开该文则清草稿并灌入服务端最新升级:mdocs update 或 npm i -g @fgbg/mdocs@2.1.4。
lexicalJsonToMarkdown);convert 反向不再是纯文本近似get_document 默认 format=md:读文即 Markdown;仍可选 text / jsonreplace_document_markdown:在 MD 源码层找换再写回,避免局部改把全文格式冲掉;提示优先片段替换而非整篇覆写升级:mdocs update 或 npm i -g @fgbg/mdocs@2.1.3。
升级:mdocs update 或 npm i -g @fgbg/mdocs@2.1.2。
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。
升级:mdocs update 或 npm i -g @fgbg/mdocs@2.1.0(国内可用淘宝镜像 --registry=https://registry.npmmirror.com)。
append_document / replace_document_markdown:.md 文末追加、纯文本层精确替换片段(无整篇覆写选择卡)DOCUMENT_CHANGED,提示重新 get_document,不把全文塞进上下文agent-dock-left)升级:mdocs update 或 npm i -g @fgbg/mdocs@2.0.10。
overwrite / 选择类卡片置顶到输入框上方,出卡强制滚到底,避免埋在长思考里超时get_document / web_search / web_fetch 写入 session,下一轮可复用,少重复调用升级:mdocs update 或 npm i -g @fgbg/mdocs@2.0.9。
web_search / web_fetch(官方 Search/Fetch API)升级:mdocs update 或 npm i -g @fgbg/mdocs@2.0.8。
remoteCommitId 再 409;merge PUT 204 后补 GET 详情再关界面升级:mdocs update 或 npm i -g @fgbg/mdocs@2.0.7。
升级:npm i -g @fgbg/mdocs@2.0.2 或已安装环境执行 mdocs update。
目录 + 100vw)升级:npm i -g @fgbg/mdocs@2.0.1 或已安装环境执行 mdocs update。
本版重心:智能助手能收图片和文件,对话里可预览;表格冲突改为整表二选一。
升级:npm i -g @fgbg/mdocs@2.0.0 或已安装环境执行 mdocs update。
本版重心:智能助手 / 帮写可后台跑完,关面板不再掐断对话;配套超时、重连回放与一批体验修补。
cancel409 RUN_ACTIVEinterrupted(不跨进程续跑)get_user_skill:按名读取完整正文与 updatedAtupdate_user_skill:改为直接写入(带 expectedUpdatedAt 防覆盖),不再弹修改表单卡;新建仍用表单卡on_download 落到系统下载目录(不再误开系统浏览器丢 Content-Disposition)升级:npm i -g @fgbg/mdocs@1.4.0 或已安装环境执行 mdocs update。
set_thinking_level 可代改默认配置/#/doc/<id> 链接sheet_append_rows(表末追加)、sheet_update_row(改已有行)、sheet_insert_rows_at(插在 afterRowId 后);移除混用的 sheet_upsert_row / sheet_insert_rowstool_call(running / done / error + 摘要),替代零散 tool_noticeget_now:返回服务器当前时刻(iso / local / 时区);问时间日期须调工具mode=coding 标题为「mdocs 帮写助手」,空态介绍与引导 chip 与 Ask 区分domainId;历史按工作空间折叠;旧会话懒迁移到 default思考 Ns › 折叠样式;思考中文字渐变;智能助手与帮写共用AgentChatPanel(mode=coding),右侧仍为 diffContent-Type(避免 .js 被标成 octet-stream)mdocs update:原生模块改为探测后再 rebuild——require('better-sqlite3') 成功则跳过;仅绑定缺失/损坏时才编译。依赖安装仍是保留 node_modules 的增量同步mdocs update:升级后检测并必要时 npm rebuild better-sqlite3(及已安装的 node-llama-cpp),避免保留「有包无 .node」导致启动报 Could not locate the bindings fileversion / update 不再预加载服务端 DB,sqlite 半残时仍可跑 mdocs update 自救同 v1.3.25(npm 上 1.3.25 卡在 processing,改发此版本)。
@fgbg/lobe-editor@1.0.0-fork.23text/plain(仅残留 **粗体**)抢走 Markdown 确认框而变成扁文本@fgbg/lobe-editor@1.0.0-fork.22(Enter 靠近视口底部时光标跟随滚动;代码块内粘贴跳过 Markdown 确认,避免取消后双份内容)session.json 读改写改为 Manager 方法级串行队列 + 原子写;读失败时从 *.jsonl 恢复索引mdocs agent session repair --dry-run|--confirm(可加 --visitor / --kind),把孤儿 transcript 补回列表~/.mdocs/embedding/(随 MDOCS_DATA_DIR);旧 ~/.fgbg/shared/embedding/ 仅作已下载文件回退MDOCS_LOG_LEVEL 可改);路径仍为 ~/.mdocs/logs/;无前台管理页MDOCS_DISABLE_EMBEDDING=1:小内存机器可整路关闭语义(仅关键词 FTS)node-llama-cpp 时日志给出重装指引;mdocs update 同步新依赖并补装该包同 v1.3.20(npm 上 1.3.20 卡在 processing,改发此版本)。
<mark> 高亮;可区分标题 / 正文 / 语义来源node-llama-cpp)异步下载加载;失败不挡关键词 FTSsearch_documents 增加 mode(auto / keyword / semantic)list_semantic_index、rebuild_semantic_index(可读文档即可)同 v1.3.18(npm 上 1.3.18 卡在 staged,改发此版本)。
full);仅靠单篇邀请进入的成员不能访问图谱mdocs update 后命令可执行:覆盖安装时给 package.json 里的 bin 加上可执行位,避免升级后 /usr/bin/mdocs Permission deniedapplication/octet-stream + Content-Disposition: attachment同 v1.3.13(npm 上 1.3.13 卡在 staged,改发此版本)。
YYYY-MM-DD,操作列「邀请」次要、「打开」主按钮query_my_documents:原 list_my_documents 改名;可按域/创建者筛选、分组,并用 offset/limit 翻页(与设置页「我的文章」对齐)search_documentsprivate < restricted < public;更封闭返回 400set_domain_permission 走同一规则invite_document_user:按文档邀请访客(read / edit)query_my_documents 的前身已支持筛选参数×)⋯ 三点菜单(竖排卡片,与文档页三点菜单一致)pnpm build,也不进 npm 包z-index 提升)#F2F3F5 背景 + 白色滑块)#FAFAFA,主内容区 #FFFFFF,空间层次更清晰.bineditor 列,改为按 fileType 分派编辑器;新增 aiWrite / comments 能力列详见 HTML 文档。
.html 文档时误传 Markdown 格式导致失败;现在按文件类型传对应格式(HTML 传原文),助手也不再声称「不支持写 HTML」get_document 返回 fileType;create_document 可直接建 HTML;list_tree 结果含 HTMLHiframe + sandbox="",不执行脚本);可手动切编辑(textarea 源码)/ 预览contentKind=html 存原文);乐观锁 / 冲突 merge 走原文三路,不经 Lexical 桥GET ?format=text 返回 HTML 原文详见 HTML 文档。
deepseek-flash(V4.1 Flash);旧 deepseek-v4-flash / deepseek-v4.1-flash 等别名保存时归一;默认上下文 1M;deepseek-v4-pro 仍可选(将路由至 Flash)/doc/<id>,自动转到 HashRouter 的 #/doc/<id>@fgbg/lobe-editor@1.0.0-fork.21)@fgbg/lobe-editor@1.0.0-fork.21file_type 为 dir 时误标成 doc,导致轮询 not_found、进度条闪退(后台其实在跑)force: false,干净缓存可复用;脏数据才会重抽anthropic 自动切换 Anthropic 协议~/.mdocs/secrets/,文件权限 0600mdocs update 抗缓存:查最新版本与 npm pack 使用临时空 --cache,不再被本机 ~/.npm 里旧的 packument 钉死(--prefer-online 仍可能读到缓存)domainId / 打开中的 documentId 写入 system(不预拉全文;读正文仍走 tool)mdocs update:查最新版本时加 --prefer-online,避免本机 npm 缓存把 latest 钉在旧版<span style="color: …"> / background-color),再导入时还原;段落与表格单元格均支持,代码块内忽略(依赖 @fgbg/lobe-editor@1.0.0-fork.20)@fgbg/lobe-editor@1.0.0-fork.20currentMd 为准mdocs version:CLI 输出当前安装包版本(亦支持 -v / --version)GET /api/documents/folder/:folderId/tree 返回精简树(目录/文章 + id/标题)list_user_skills / create_user_skill / update_user_skill / delete_user_skill;新建与修改弹出带倒计时的表单卡mdocs update:全局安装后从淘宝 npmmirror 原地升级,保留已有 node_modules,依赖走 --prefer-offline(已缓存的不再重复下载)@meta2d;有图 / 插入图 / 打开编辑时再加载@fgbg/lobe-editor@1.0.0-fork.19)@meta2d / canvas2svg 单独拆成 meta2d chunkMDOCS_INDEX_INITIAL_DELAY_MS 调整),减轻 HTML TTFB 被 CPU 拖慢index.html 增加「mdocs 加载中…」占位,减少白屏感@fgbg/lobe-editor@1.0.0-fork.17get_document 工具,按当前访客读权限读取文档正文(与 HTTP 鉴权一致,无额外特权)prepack 现会执行完整 pnpm build,避免只升版本号却打出旧 dist(此前 0.8.12/0.8.13 缺文档拖拽移动、可拖动助手入口等)ENOTEMPTY、低内存 npm install -g)children: [] 打开时补空段落,避免 editor 全局崩溃ENOTEMPTY、低内存 npm install -g)POST /api/documents/:id/movechildren: [] 会在打开时补空段落,避免编辑器整页崩溃move_document 工具tenant/<id>/agent/session),多轮续聊;回答引用手册页面链接;思考中三点动画;跟随滚动仅在贴底时生效@fgbg/lobe-editor@1.0.0-fork.16——导出 INSERT_MARKMAP_COMMAND,斜杠 Markmap 使用正式 command APIsetDocument 重挂,减轻 Mermaid 等块导致的跳动@fgbg/lobe-editor@1.0.0-fork.15——仅当反引号之间有内容时才转为行内代码,避免空 `` 抢占导致无法输入 fenced 代码块;并补充 Meta2d 斜杠插入后自动打开编辑器setDocument 重挂,避免 Mermaid 等块因 DOM 重建导致视觉窗口跳动@fgbg/lobe-editor@1.0.0-fork.14(Mermaid 渲染结果缓存与加载占位,减轻重挂场景下的高度塌陷)___desc___.md 现在与普通文档一样写入首版 commit 和 headCommitId;升级后启动时会为历史上缺少 head 的目录描述从磁盘补迁移,修复「无法发布:缺少版本基准」publishError,自动扫描会跳过重试;可在设置页「未发布草稿」查看失败原因并手动重试或另存@fgbg/lobe-editor@fork.13,Shiki 语法高亮仅保留约 40 种常用语言(见下方列表),dist/web 资源文件减少;冷门语言代码块以纯文本显示,内容不丢失compression),JS/CSS 等响应带 Content-Encoding: gzip,首屏传输量显著下降/assets/*(带 hash 的文件)设置 Cache-Control: public, max-age=31536000, immutable,二次打开更快npm install -g 后访问 / 显示 Cannot GET /——前端静态目录改为相对安装包路径解析,不再依赖启动时的当前工作目录MDOCS_HOST 从 127.0.0.1 改为 0.0.0.0,服务器部署后外网可直接访问(本地仅本机可设 MDOCS_HOST=127.0.0.1)bin/mdocs.js 无执行权限导致 npm install -g 后 mdocs: Permission denied 的问题activeDoc 对象GET .../merge-context 提供合并祖先(LCA)正文,用于三路对比documentId 为主键,保存正文与开编基准 commit(baseCommitId),并在首次编辑落盘时携带文档快照信息,后续自动保存只更新内容相关字段public_read 文档 + invite(edit) 的编辑判定(被邀请编辑者现在可正常发布).mdocs-comment-content 增加 white-space: pre-wrap,发出的评论保留输入时的换行和空格,不再被折叠成一坨resize: vertical(只能从右下角往下拖),改用 React state + 自定义顶部 handle,textarea 高度由 state 接管fgbg-docs/comments-panel-resize.mdfgbg-docs/comments-layout-optimization.mdDocumentEditor 挂载时主动检查 IndexedDB 草稿,若内容与服务器版本不同则自动恢复草稿内容和标题useAutoSave Hook 中 useCallback 依赖循环导致监听器反复注册的性能问题optimizeDeps 配置,优化首次冷启动速度@fgbg/lobe-editor 至 1.0.0-fork.12
listItem markdown reader 通过 children.map() 返回数组,解析器的 .flat() 将数组展平导致单个 list item 被拆成多个独立节点1. **开关关闭时**:不查询果切任务 时,有序列表被拆成两个 listItem(value=1 和 value=2)fgbg-docs/references/listitem-parsing-bugfix.md@fgbg/lobe-editor 至 1.0.0-fork.9
.editor_table_scrollable_wrapper 增加 min-width: 0,解决 flex 布局下宽表格撑开父容器的经典问题.image / .blockImage 样式中增加 img { max-width: 100% !important; },防止大图片横向撑开编辑器minWidth: 0,确保左侧目录树展开时,大纲不会被宽表格挤出视野@fgbg/lobe-editor 至 1.0.0-fork.10(仍属 v0.7.4 产品线,仅上游编辑器迭代;mdocs 应用包版本号未改):
---markmap--- 正确注册 IMarkdownShortCutService;嵌套 textarea 粘贴不再走主编辑器 Markdown 粘贴链路;预览区按钮可右下角;新增一键展开/折叠全部节点,节点数超过 30 个时默认全部折叠;修复左侧 markdown 编辑器无法全选问题(Cmd/Ctrl+A 事件被 Lexical 全局拦截,需 stopPropagation)getLatest 报错(改为 read + $getNodeByKey);EDIT_LINK_COMMAND 移至 LinkNode.ts```markmap 代码块中输入 Markdown 即可渲染为可交互思维导图
@fgbg/lobe-editor 至 1.0.0-fork.7.mdocs-editor-content-area img { max-width: 100% !important; } 样式规则,覆盖 Antd Image 组件的内联样式,防止大图片横向撑开编辑器容器/visitors/login 到豁免路径白名单,解决登录时提示 missing visitor token 的错误visitor_sessions 会话表,支持多个设备同时登录同一账号,互不干扰1234,登录后可自行修改background: '#fff' 但未重置文字颜色,暗色主题下所有按钮(撤销/重做/删除/适应/100%/关闭)白底白字。加 color: '#000' 修复registerLocale() 改为深合并,避免插件注册 {codemirror:{...}} 时覆盖已有 meta2d.editor 等嵌套 key---meta2d--- 或粘贴插入后,自动创建空白段落并定位光标,不再卡在图片后无法继续输入useEditorState 在 selection 为 null(如 ColorPicker popup 导致编辑器失焦)时错误清空了 textColor/bgColor,现改为保留上一次检测到的颜色值,避免无选区时误判格式状态ReactEditor 和 useEditor 增加 destroy() cleanup,配合 pendingDestroyRef + queueMicrotask 兼容 StrictMode remountisShowChild=false 的 pens,高大预览图自动居中并支持滚动useOutlineActionItem,工具栏可一键展开/折叠大纲面板@lobehub/editor 的 ReactEditor 组件创建编辑器实例后从不调用 destroy(),且 DocumentEditor 使用 key 强制重新挂载导致每次切换都泄漏一个完整的编辑器实例(含 CodeMirror、Meta2d Canvas、图片等 DecoratorNode 资源)。上游 ReactEditor 和 useEditor() hook 已增加 destroy() cleanup,mdocs 侧移除多余的 key 并增加防御性清理editor.destroy() 后重新挂载导致 DataSource for type "json" is not registered 报错。采用 pendingDestroyRef + queueMicrotask 延迟取消模式:cleanup 中把 destroy 排队到 microtask,若紧接着是 StrictMode remount 则同步取消,真正卸载时才执行销毁CommentsPanel、SettingsPage、DraftListPage、RecoveryDialog、DocumentEditor 的异步请求增加卸载保护。CommentsPanel 采用 expectedDocumentIdRef 竞态保护丢弃旧请求;其余组件采用 mountedRef 模式防止卸载后 setStateURL.createObjectURL 未 revokeObjectURL 的问题;修复 actions.ts 文件选择器在 Safari 中取消后 DOM 节点未移除的问题(增加 5s 兜底超时);修复 Playground 卸载后 window.editor 和 debounce 定时器未清理的问题useAutoSave Hook 中 useCallback 依赖循环问题,使用 useRef 保存频繁变化的值,避免 Lexical 监听器反复注册注销,减少不必要的性能开销documentId 不匹配的问题,新增 expectedDocIdRef 竞态检查机制CommentsPanel 评论列表渲染从 O(n*m) 优化为 O(n),使用 useMemo + Map 单次遍历完成根评论与回复分组,同时顺便计算未删除评论总数DocumentEditor.handleInit 中重复的 JSON.parse 逻辑,直接复用已预计算的 contentType@deprecated 的 deleteFolderApiV0 函数(已被递归删除目录的 deleteFolderApi 替代)getDocument() 现在返回 invitedEdit 标记,前端 canEdit 计算补充 invite 检查canEditDocument() 在 private 域各权限档位下补充 document_invites 检查,被 invite edit 的非创建者现在可正常编辑<table>),标题/域/作者/收藏时间四列对齐;新增名称搜索框和域筛选下拉;每行新增📖快速打开按钮;操作按钮支持即时 tooltip;标题超长时自动截断并显示原生 tooltip;取消收藏有淡出动画Intl.RelativeTimeFormat 相对时间(自动适配中英文)visitor_name 增加数据库 UNIQUE 约束,避免同名混淆pnpm mdocs visitor migrate --from Alice --to Bob,不再需要输入 UUIDcreate / update 默认使用 contentFormat: 'markdown'https://github.com/xuhuafeifei/mdocs-cli,提供 search、get、create、update、domains、mkdir 六个命令,Token 在设置页创建x-cli-token 认证头,继承访客所有权限window.confirmfile_type('dir' / 'md')和 parent_id,目录不再是路径切割的产物~/.mdocs/files/docs/{domain_id}/),不同域同名文件不再冲突desc.md 改为 ___desc___.md,避免与用户创建的文件冲突POST /api/folders,创建目录时自动创建 ___desc___.mdparent_id 一次查询建树,不再递归切割路径private → domain_read → domain_write → public_read → public_write),invite 从档位改为独立叠加层