Joplin 桌面端版本演进全解析从 v0.10 到 v3.7 的核心功能与实现原理【免费下载链接】joplinJoplin - the privacy-focused note taking app with sync capabilities for Windows, macOS, Linux, Android and iOS.项目地址: https://gitcode.com/GitHub_Trending/jo/joplin本篇技术指南以 Joplin 桌面端官方 Changelogreadme/about/changelog/desktop.md为骨架系统梳理桌面应用从 v0.10.19 到 v3.7.18 的关键功能演进、同步与加密机制、编辑器体系、插件 API 以及安全修复脉络并对照当前仓库源码说明各模块的实际落点。读完本文你将掌握 Joplin 桌面端的整体架构演化史并能依据版本记录快速定位 packages/app-desktop 中对应功能模块的实现文件。一、版本记录概览与阅读方法Joplin 桌面端 Changelog 按版本号倒序排列共覆盖约 200 个发布版本时间跨度从 2017 年 11 月的 v0.10.19 一直到 2026 年 9 月的 v3.7.18。每个版本条目按New新功能、Improved改进、Fixed缺陷修复、Security安全修复四类标签组织部分版本还附有Breaking Changes与Deprecated说明。从源码结构看桌面端主体位于 packages/app-desktop其中 gui 目录承载全部界面组件编辑器、侧边栏、同步向导、加密配置等核心业务逻辑同步目标、数据库、加密、模型集中在 packages/lib跨端编辑器内核位于 packages/editorCodeMirror 与 ProseMirror 两个子目录。阅读 Changelog 时可将其作为功能索引先看版本记录中新增了什么能力再到对应包目录中寻找实现文件。二、编辑器体系Markdown、富文本与所见即所得的三代演进2.1 早期Ace Editor 与 CodeMirror 的并存与替换Changelog 显示桌面端编辑器经历了多轮替换。v1.0.217 引入选择 CodeMirror 作为代码编辑器的选项v1.1.1 正式将 CodeMirror 设为默认代码编辑器并同步支持 Vim/Emacs 键位模式v1.0.173 Add keyboard modes to editor (vim, emacs)。此后 CodeMirror 一直承担 Markdown 编辑职责当前实现位于 packages/editor/CodeMirror共 130 个 TypeScript 文件。2.2 v1.0.216 起的编辑器重写与 WYSIWYGv1.0.216 是一次里程碑式重构This release includes a rewrite of the note editor component新增Code View按钮在 WYSIWYG 编辑器与 Markdown 编辑器之间切换并将标签栏移到笔记编辑面板顶部。这条记录解释了当前 gui/NoteEditor 目录中NoteEditor.tsx、NoteBody/、NoteTitle/等组件的分工来源。2.3 v2.13.2 起的 CodeMirror 6 新编辑器v2.13.2 引入基于 CodeMirror 6 的全新 beta Markdown 编辑器随后 v3.1.1 将其设为默认编辑器v3.6.3 默认启用编辑器内渲染in-editor rendering。当前 packages/editor/CodeMirror 即是 CodeMirror 6 的集成层其包依赖持续升级如 v3.7.10 升级 CodeMirror View 至 6.43.6。2.4 富文本编辑器TinyMCE 与 ProseMirror富文本编辑器Rich Text Editor方面v1.0.195 首次加入实验性 WYSIWYG 编辑器后基于 TinyMCE 构建v3.3.1 Upgrade to TinyMCE v6。当前 packages/editor/ProseMirror 显示富文本内核正逐步向 ProseMirror 演进。Changelog 中大量条目围绕富文本编辑的粘贴、表格、嵌套列表、KaTeX 公式保真等细节展开例如 v3.7.13 修复Rich Text 编辑器输入后立即切换笔记导致文本丢失、v2.14.12 修复粘贴富文本产生无效标记。2.5 表格与列表编辑的持续打磨Markdown 表格与列表是编辑器高频痛点。Changelog 中相关条目包括v3.7.1 添加表格增删行列命令、v3.7.10 支持 Ctrl/Cmd点击打开表格中的链接、v3.2.1 修复Markdown 编辑器列表重新编号重置为 1、v2.14.6 实现Markdown 编辑器与查看器双向同步滚动。这些功能在 packages/editor/CodeMirror 中均能找到对应的扩展实现。三、同步体系多目标支持与同步可靠性3.1 同步目标的时间线从 Changelog 可梳理出同步目标支持的完整时间线版本同步目标说明v0.10.38文件系统首个本地同步目标v0.10.51NextcloudBeta基于 WebDAVv0.10.60WebDAV通用 WebDAV 目标v0.10.81Dropbox—v1.0.233AWS S3Betav3.3.1 移出 Betav2.0.8Joplin Cloud官方云服务v2.8.2多配置文件支持多个 profile当前仓库中这些目标分别对应 packages/lib/SyncTargetWebDAV.ts、SyncTargetNextcloud.ts、SyncTargetDropbox.ts、SyncTargetAmazonS3.js、SyncTargetJoplinCloud.ts、SyncTargetJoplinServer.ts、SyncTargetFilesystem.ts 等统一注册于 SyncTargetRegistry.ts。3.2 同步可靠性的关键修复Changelog 中同步相关修复数量庞大按主题可归纳为几类WebDAV 兼容性v3.7.18 修复升级后 WebDAV 同步出现 409 错误、修复Protocol https: not supported重定向问题v3.5.7 支持 Apache Tomcat WebDAVv2.1.3 优化与 Joplin Server 的首轮同步。避免数据丢失v3.7.13 修复长 delta 步骤期间允许变更丢失的竞态v2.14.10 防止本地删除未同步v1.4.18 重启用 ASAR 打包以改善启动速度间接影响同步稳定。同步锁与版本升级v1.0.241 引入锁定并升级同步目标机制升级后仅新版本客户端可同步v2.14.12 允许设置同步目标的最低应用版本v3.2.3 曾尝试移除同步锁需求。资源下载v2.12.10 优化资源下载队列v3.7.18 修复同步完成但存在错误时无警告图标的问题。3.3 同步状态界面v3.6.10 在侧边栏新增同步状态图标与可折叠同步报告v3.0.3 允许在同步状态中标记错误为已忽略。对应界面实现在 gui/StatusScreen 与 gui/Sidebar。此外 v3.7.10 让同步向导将 Joplin Cloud 设为首选同步选项实现在 gui/SyncWizard。四、加密与安全E2EE 演进与 XSS 防护4.1 端到端加密E2EE时间线v0.10.41首次加入端到端加密支持E2EE。v1.0.193/v1.0.192默认加密方法切换为 CCM。v2.11.11加密方法升级到 AES-256。v2.12.12因性能问题临时回退到 AES-128。v3.2.1新增基于原生加密库的新加密方法。v3.4.1将新加密方法设为默认。相关实现集中在 packages/lib/services/EncryptionService.ts 及 gui/EncryptionConfigScreen主密码对话框在 gui/MasterPasswordDialog。Changelog 还记录了 v3.7.13 修复加密验证时防止密码检查死循环、v2.12.12 修复主密码更新可能被重置等问题。4.2 安全修复清单Changelog 中Security条目是桌面端安全演化的重要史料典型包括XSS 系列v2.12.10 消毒粘贴进富文本编辑器的 HTMLv2.12.9 安全模式下消毒渲染输出v2.11.5 禁用 SVG 标签防 XSSv1.8.5 过滤 NOSCRIPT 标签CVE-2021-33295v2.9.17 修复渲染器 XSSv3.7.13 修复 HTML 笔记中的 XSS 漏洞#15435。CVE 修复v3.0.8 修复 PDF.js 任意 JavaScript 执行CVE-2024-4367v2.10.19 修复 XSS 注入CVE-2023-33726与潜在 RCECVE-2023-33727v1.0.233 修复 Clipper API 路径穿越CVE-2020-15844。CSP 强化v3.6.3 Strengthen Content-Security-Policyv3.5.4 修复insecure content security policy警告。当前安全相关的渲染隔离与消毒逻辑分布在 packages/rendererMarkdown 到 HTML 渲染管线与 packages/lib/htmlUtils.ts。五、插件体系从 v1.3.18 起步到富 API插件支持于 v1.3.18 首次引入Add support for application plugins此后 API 持续扩充命令系统v1.3.18 简化命令服务并加入命令面板Command Palettev2.1.1 允许插件调用 gotoAnything。视图 APIv1.4.12 引入菜单、对话框、面板与 webview APIv3.3.1 新增joplin.shouldUseDarkColors、joplin.settings.globalValues。编辑器插件v3.2.1 新增编辑器插件支持editor pluginsv3.7.8 新增joplin.ai.getEmbeddings()、joplin.ai.getIndexStatus()插件 APIv3.7.3 新增语义搜索插件 APIjoplin.ai.search。文件与数据 APIv1.7.10 新增joplin.plugins.require、plugins.dataDirv3.6.4 新增joplin.fs.archiveExtract。剪贴板 APIv3.5.4 新增write()方法。插件加载与管理的实现位于 packages/app-desktop/services/plugins 与 packages/lib/services/plugins。Changelog 同时记录了兼容性策略如 v3.2.3 Do not load plugin if it is disabled、v3.4.2 Allow editor plugins to support multiple windows、v2.7.6 Throttle plugins that make too many API calls。六、AI 与前沿能力Chat、MCP、语义搜索、OCR 与白板6.1 AI Chat 面板与语义搜索v3.7 系列v3.7.3 集中引入三大新能力AI Chat 后端与插件 API、MCP 服务器、笔记嵌入索引器note embeddings indexer。v3.7.8 新增面向当前笔记的 AI Chat 面板并支持多窗口v3.7.12 让 Chat 面板支持读取图片、将语义搜索接入侧边栏与 GotoAnythingv3.7.13 提高语义搜索最低相关性阈值v3.7.18 修复 MCP 通知请求应返回 202、允许 OpenAI 推理模型配合工具使用。实现证据AI 面板在 gui/ChatPanel嵌入索引依赖 sqlite-vecv3.7.4/v3.7.6 修复了 sqlite-vec 扩展路径与渲染器崩溃循环问题语义搜索 API 定义在 packages/lib/services/ai。注意 v3.7.12 明确将 AI 功能标记为 Beta相关状态提示可见于 gui/AiDegradedNotice.tsx。6.2 OCRv2.14.6 起v2.14.6 引入 OCR 支持v3.3.1 默认启用 OCR 处理v3.4.10 增加高亮当前行与手写转录开关说明。相关能力在 packages/lib/services/ocr 与 packages/transcribe。Changelog 记录了多项 OCR 修复如 v3.7.13 限制存储 OCR 文本最大尺寸、v3.4.10 修复 OCR 无限循环、v2.14.12 优先使用 PDF 已有文本。6.3 白板Whiteboardv3.7.1 起v3.7.1 新增白板支持其后多个版本持续增强v3.7.3 支持分组与文件拖放v3.7.8 支持颜色、双击编辑连线标签v3.7.10 支持选择共享锚点的箭头v3.7.13 改空白画布双击添加笔记v3.7.18 补充Add note to whiteboard菜单项。白板实现位于 packages/app-desktop/gui/Whiteboard可从 gui 目录结构印证。6.4 Mermaid 与 KaTeX 渲染Mermaidv1.0.135 首次实验性支持 Mermaid 图此后持续升级v2.14.6 至 10.6.1v3.4.2 至 11.4.1并支持暗色模式v2.14.6与导出 PNG/SVGv2.8.2。KaTeXv0.10.60 加入数学排版支持v1.3.18 增加化学方程式 mhchemv3.6.3 升级至 0.16.22。渲染管线位于 packages/renderer/MdToHtml其中 MarkupToHtml.ts 是统一入口可同时输出 HTML 与资源清单。七、导入导出ENEX、OneNote、Obsidian 与 Markdown7.1 Evernote ENEX 导入ENEX 导入是历史最悠久的导入链路Changelog 中相关修复贯穿始终v1.0.168 支持以 HTML 形式导入v2.12.9 支持导入 Evernote 任务列表v3.7.12 支持在部分场景下导入跨笔记链接v3.5.5 支持导入未指定编码的资源。相关代码在 packages/lib/import-enex.ts 及 import-enex-md-gen.ts。7.2 OneNote 导入v3.2.3 起v3.2.3 新增 OneNote 导入器其后数十个版本持续完善支持.one直接导入与 Windows 下.onepkgv3.5.5、导入墨迹ink笔迹、XPS 打印件、跨页链接、时间戳保留v3.6.11、大型附件v3.6.11、手写识别改进v3.6.3等。实现为独立 Rust 包 packages/onenote-converterparser 与 renderer 两个子 crateTypeScript 集成层在 packages/lib/services/interop。7.3 Obsidian 导入v3.7.13 起v3.7.13 新增从 Obsidian 导入笔记的支持#16136/#15223实现于同一互操作框架内。7.4 Markdown 与 Front Matterv2.5.4 新增 Markdown Front Matter 导出/导入器v2.14.8 支持 Notesnook 风格时间戳v3.6.3 支持笔记内 FrontMatter 区块渲染v3.7.3 修复 Front Matter 查看器长行换行。导出器位于 packages/lib/services/interop/InteropService_Importer_Md.ts 与对应的 Exporter 文件。八、桌面端独有体验多窗口、多配置与系统集成多窗口Secondary Windowv3.2.1 支持多窗口v3.3.3 新增从文件菜单打开次实例。v3.7 系列多次修复次窗口白板不可用、关闭时崩溃等问题。实现在 gui/WindowCommandsAndDialogs。多配置文件Profilesv2.8.2 支持多配置文件v3.5.10 用图形界面管理配置文件v3.7.1 允许删除默认配置。实现在 gui/ProfileEditor.tsx。系统托盘与快捷键v0.10.60 增加 Windows/macOS 托盘图标v3.5.4 点击托盘图标显示/隐藏主窗口v3.6.10 新增显示/隐藏 Joplin 的全局快捷键。主题体系内置 Aritim、Dracula、Nord、Solarized 等主题v1.0.199 加入 Aritim-Darkv1.0.173 加入 Nordv1.0.170 加入 Dracula主题文件位于 packages/lib/themes桌面端样式在 packages/app-desktop/style。九、如何利用本 Changelog 做技术决策定位功能实现将 Changelog 条目中的功能名与 packages/app-desktop/gui、packages/lib、packages/editor 三个目录对照绝大多数功能都能找到同名或近义目录/文件。判断升级风险关注Breaking Changes如 v1.4.12 的 Clipper API 破坏性变更、插件 manifestid/app_min_version变为必填与CAUTION标注如 v2.3.3 的同步目标升级须知。追踪安全基线Security条目中带 CVE 编号的记录是评估历史版本漏洞面的第一手资料。了解性能改进如 v3.4.2 Faster startup and smaller application size、v3.7.6 Cap ONNX embedding batch size to prevent renderer OOM、v1.0.127 Optimised loading speed of notes 2-3 times faster 等条目可作为性能调优的参照。十、结语Joplin 桌面端从 2017 年末至今的 Changelog是一部完整的隐私优先笔记应用工程演化史编辑器从单一 Markdown 走向 CodeMirror 6 富文本双轨同步从本地文件系统扩展到 WebDAV/Nextcloud/Dropbox/OneDrive/S3/Joplin Server 全谱系安全能力在持续对抗 XSS 与 CVE 中沉淀AI 时代则快速补齐了 Chat、MCP、语义搜索与白板等新形态。对开发者而言这份 Changelog 既是最可靠的版本间差异参考也是进入 packages/app-desktop 与 packages/lib 源码世界的精准导航图。【免费下载链接】joplinJoplin - the privacy-focused note taking app with sync capabilities for Windows, macOS, Linux, Android and iOS.项目地址: https://gitcode.com/GitHub_Trending/jo/joplin创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Joplin 桌面端版本演进全解析：从 v0.10 到 v3.7 的核心功能与实现原理
Joplin 桌面端版本演进全解析从 v0.10 到 v3.7 的核心功能与实现原理【免费下载链接】joplinJoplin - the privacy-focused note taking app with sync capabilities for Windows, macOS, Linux, Android and iOS.项目地址: https://gitcode.com/GitHub_Trending/jo/joplin本篇技术指南以 Joplin 桌面端官方 Changelogreadme/about/changelog/desktop.md为骨架系统梳理桌面应用从 v0.10.19 到 v3.7.18 的关键功能演进、同步与加密机制、编辑器体系、插件 API 以及安全修复脉络并对照当前仓库源码说明各模块的实际落点。读完本文你将掌握 Joplin 桌面端的整体架构演化史并能依据版本记录快速定位 packages/app-desktop 中对应功能模块的实现文件。一、版本记录概览与阅读方法Joplin 桌面端 Changelog 按版本号倒序排列共覆盖约 200 个发布版本时间跨度从 2017 年 11 月的 v0.10.19 一直到 2026 年 9 月的 v3.7.18。每个版本条目按New新功能、Improved改进、Fixed缺陷修复、Security安全修复四类标签组织部分版本还附有Breaking Changes与Deprecated说明。从源码结构看桌面端主体位于 packages/app-desktop其中 gui 目录承载全部界面组件编辑器、侧边栏、同步向导、加密配置等核心业务逻辑同步目标、数据库、加密、模型集中在 packages/lib跨端编辑器内核位于 packages/editorCodeMirror 与 ProseMirror 两个子目录。阅读 Changelog 时可将其作为功能索引先看版本记录中新增了什么能力再到对应包目录中寻找实现文件。二、编辑器体系Markdown、富文本与所见即所得的三代演进2.1 早期Ace Editor 与 CodeMirror 的并存与替换Changelog 显示桌面端编辑器经历了多轮替换。v1.0.217 引入选择 CodeMirror 作为代码编辑器的选项v1.1.1 正式将 CodeMirror 设为默认代码编辑器并同步支持 Vim/Emacs 键位模式v1.0.173 Add keyboard modes to editor (vim, emacs)。此后 CodeMirror 一直承担 Markdown 编辑职责当前实现位于 packages/editor/CodeMirror共 130 个 TypeScript 文件。2.2 v1.0.216 起的编辑器重写与 WYSIWYGv1.0.216 是一次里程碑式重构This release includes a rewrite of the note editor component新增Code View按钮在 WYSIWYG 编辑器与 Markdown 编辑器之间切换并将标签栏移到笔记编辑面板顶部。这条记录解释了当前 gui/NoteEditor 目录中NoteEditor.tsx、NoteBody/、NoteTitle/等组件的分工来源。2.3 v2.13.2 起的 CodeMirror 6 新编辑器v2.13.2 引入基于 CodeMirror 6 的全新 beta Markdown 编辑器随后 v3.1.1 将其设为默认编辑器v3.6.3 默认启用编辑器内渲染in-editor rendering。当前 packages/editor/CodeMirror 即是 CodeMirror 6 的集成层其包依赖持续升级如 v3.7.10 升级 CodeMirror View 至 6.43.6。2.4 富文本编辑器TinyMCE 与 ProseMirror富文本编辑器Rich Text Editor方面v1.0.195 首次加入实验性 WYSIWYG 编辑器后基于 TinyMCE 构建v3.3.1 Upgrade to TinyMCE v6。当前 packages/editor/ProseMirror 显示富文本内核正逐步向 ProseMirror 演进。Changelog 中大量条目围绕富文本编辑的粘贴、表格、嵌套列表、KaTeX 公式保真等细节展开例如 v3.7.13 修复Rich Text 编辑器输入后立即切换笔记导致文本丢失、v2.14.12 修复粘贴富文本产生无效标记。2.5 表格与列表编辑的持续打磨Markdown 表格与列表是编辑器高频痛点。Changelog 中相关条目包括v3.7.1 添加表格增删行列命令、v3.7.10 支持 Ctrl/Cmd点击打开表格中的链接、v3.2.1 修复Markdown 编辑器列表重新编号重置为 1、v2.14.6 实现Markdown 编辑器与查看器双向同步滚动。这些功能在 packages/editor/CodeMirror 中均能找到对应的扩展实现。三、同步体系多目标支持与同步可靠性3.1 同步目标的时间线从 Changelog 可梳理出同步目标支持的完整时间线版本同步目标说明v0.10.38文件系统首个本地同步目标v0.10.51NextcloudBeta基于 WebDAVv0.10.60WebDAV通用 WebDAV 目标v0.10.81Dropbox—v1.0.233AWS S3Betav3.3.1 移出 Betav2.0.8Joplin Cloud官方云服务v2.8.2多配置文件支持多个 profile当前仓库中这些目标分别对应 packages/lib/SyncTargetWebDAV.ts、SyncTargetNextcloud.ts、SyncTargetDropbox.ts、SyncTargetAmazonS3.js、SyncTargetJoplinCloud.ts、SyncTargetJoplinServer.ts、SyncTargetFilesystem.ts 等统一注册于 SyncTargetRegistry.ts。3.2 同步可靠性的关键修复Changelog 中同步相关修复数量庞大按主题可归纳为几类WebDAV 兼容性v3.7.18 修复升级后 WebDAV 同步出现 409 错误、修复Protocol https: not supported重定向问题v3.5.7 支持 Apache Tomcat WebDAVv2.1.3 优化与 Joplin Server 的首轮同步。避免数据丢失v3.7.13 修复长 delta 步骤期间允许变更丢失的竞态v2.14.10 防止本地删除未同步v1.4.18 重启用 ASAR 打包以改善启动速度间接影响同步稳定。同步锁与版本升级v1.0.241 引入锁定并升级同步目标机制升级后仅新版本客户端可同步v2.14.12 允许设置同步目标的最低应用版本v3.2.3 曾尝试移除同步锁需求。资源下载v2.12.10 优化资源下载队列v3.7.18 修复同步完成但存在错误时无警告图标的问题。3.3 同步状态界面v3.6.10 在侧边栏新增同步状态图标与可折叠同步报告v3.0.3 允许在同步状态中标记错误为已忽略。对应界面实现在 gui/StatusScreen 与 gui/Sidebar。此外 v3.7.10 让同步向导将 Joplin Cloud 设为首选同步选项实现在 gui/SyncWizard。四、加密与安全E2EE 演进与 XSS 防护4.1 端到端加密E2EE时间线v0.10.41首次加入端到端加密支持E2EE。v1.0.193/v1.0.192默认加密方法切换为 CCM。v2.11.11加密方法升级到 AES-256。v2.12.12因性能问题临时回退到 AES-128。v3.2.1新增基于原生加密库的新加密方法。v3.4.1将新加密方法设为默认。相关实现集中在 packages/lib/services/EncryptionService.ts 及 gui/EncryptionConfigScreen主密码对话框在 gui/MasterPasswordDialog。Changelog 还记录了 v3.7.13 修复加密验证时防止密码检查死循环、v2.12.12 修复主密码更新可能被重置等问题。4.2 安全修复清单Changelog 中Security条目是桌面端安全演化的重要史料典型包括XSS 系列v2.12.10 消毒粘贴进富文本编辑器的 HTMLv2.12.9 安全模式下消毒渲染输出v2.11.5 禁用 SVG 标签防 XSSv1.8.5 过滤 NOSCRIPT 标签CVE-2021-33295v2.9.17 修复渲染器 XSSv3.7.13 修复 HTML 笔记中的 XSS 漏洞#15435。CVE 修复v3.0.8 修复 PDF.js 任意 JavaScript 执行CVE-2024-4367v2.10.19 修复 XSS 注入CVE-2023-33726与潜在 RCECVE-2023-33727v1.0.233 修复 Clipper API 路径穿越CVE-2020-15844。CSP 强化v3.6.3 Strengthen Content-Security-Policyv3.5.4 修复insecure content security policy警告。当前安全相关的渲染隔离与消毒逻辑分布在 packages/rendererMarkdown 到 HTML 渲染管线与 packages/lib/htmlUtils.ts。五、插件体系从 v1.3.18 起步到富 API插件支持于 v1.3.18 首次引入Add support for application plugins此后 API 持续扩充命令系统v1.3.18 简化命令服务并加入命令面板Command Palettev2.1.1 允许插件调用 gotoAnything。视图 APIv1.4.12 引入菜单、对话框、面板与 webview APIv3.3.1 新增joplin.shouldUseDarkColors、joplin.settings.globalValues。编辑器插件v3.2.1 新增编辑器插件支持editor pluginsv3.7.8 新增joplin.ai.getEmbeddings()、joplin.ai.getIndexStatus()插件 APIv3.7.3 新增语义搜索插件 APIjoplin.ai.search。文件与数据 APIv1.7.10 新增joplin.plugins.require、plugins.dataDirv3.6.4 新增joplin.fs.archiveExtract。剪贴板 APIv3.5.4 新增write()方法。插件加载与管理的实现位于 packages/app-desktop/services/plugins 与 packages/lib/services/plugins。Changelog 同时记录了兼容性策略如 v3.2.3 Do not load plugin if it is disabled、v3.4.2 Allow editor plugins to support multiple windows、v2.7.6 Throttle plugins that make too many API calls。六、AI 与前沿能力Chat、MCP、语义搜索、OCR 与白板6.1 AI Chat 面板与语义搜索v3.7 系列v3.7.3 集中引入三大新能力AI Chat 后端与插件 API、MCP 服务器、笔记嵌入索引器note embeddings indexer。v3.7.8 新增面向当前笔记的 AI Chat 面板并支持多窗口v3.7.12 让 Chat 面板支持读取图片、将语义搜索接入侧边栏与 GotoAnythingv3.7.13 提高语义搜索最低相关性阈值v3.7.18 修复 MCP 通知请求应返回 202、允许 OpenAI 推理模型配合工具使用。实现证据AI 面板在 gui/ChatPanel嵌入索引依赖 sqlite-vecv3.7.4/v3.7.6 修复了 sqlite-vec 扩展路径与渲染器崩溃循环问题语义搜索 API 定义在 packages/lib/services/ai。注意 v3.7.12 明确将 AI 功能标记为 Beta相关状态提示可见于 gui/AiDegradedNotice.tsx。6.2 OCRv2.14.6 起v2.14.6 引入 OCR 支持v3.3.1 默认启用 OCR 处理v3.4.10 增加高亮当前行与手写转录开关说明。相关能力在 packages/lib/services/ocr 与 packages/transcribe。Changelog 记录了多项 OCR 修复如 v3.7.13 限制存储 OCR 文本最大尺寸、v3.4.10 修复 OCR 无限循环、v2.14.12 优先使用 PDF 已有文本。6.3 白板Whiteboardv3.7.1 起v3.7.1 新增白板支持其后多个版本持续增强v3.7.3 支持分组与文件拖放v3.7.8 支持颜色、双击编辑连线标签v3.7.10 支持选择共享锚点的箭头v3.7.13 改空白画布双击添加笔记v3.7.18 补充Add note to whiteboard菜单项。白板实现位于 packages/app-desktop/gui/Whiteboard可从 gui 目录结构印证。6.4 Mermaid 与 KaTeX 渲染Mermaidv1.0.135 首次实验性支持 Mermaid 图此后持续升级v2.14.6 至 10.6.1v3.4.2 至 11.4.1并支持暗色模式v2.14.6与导出 PNG/SVGv2.8.2。KaTeXv0.10.60 加入数学排版支持v1.3.18 增加化学方程式 mhchemv3.6.3 升级至 0.16.22。渲染管线位于 packages/renderer/MdToHtml其中 MarkupToHtml.ts 是统一入口可同时输出 HTML 与资源清单。七、导入导出ENEX、OneNote、Obsidian 与 Markdown7.1 Evernote ENEX 导入ENEX 导入是历史最悠久的导入链路Changelog 中相关修复贯穿始终v1.0.168 支持以 HTML 形式导入v2.12.9 支持导入 Evernote 任务列表v3.7.12 支持在部分场景下导入跨笔记链接v3.5.5 支持导入未指定编码的资源。相关代码在 packages/lib/import-enex.ts 及 import-enex-md-gen.ts。7.2 OneNote 导入v3.2.3 起v3.2.3 新增 OneNote 导入器其后数十个版本持续完善支持.one直接导入与 Windows 下.onepkgv3.5.5、导入墨迹ink笔迹、XPS 打印件、跨页链接、时间戳保留v3.6.11、大型附件v3.6.11、手写识别改进v3.6.3等。实现为独立 Rust 包 packages/onenote-converterparser 与 renderer 两个子 crateTypeScript 集成层在 packages/lib/services/interop。7.3 Obsidian 导入v3.7.13 起v3.7.13 新增从 Obsidian 导入笔记的支持#16136/#15223实现于同一互操作框架内。7.4 Markdown 与 Front Matterv2.5.4 新增 Markdown Front Matter 导出/导入器v2.14.8 支持 Notesnook 风格时间戳v3.6.3 支持笔记内 FrontMatter 区块渲染v3.7.3 修复 Front Matter 查看器长行换行。导出器位于 packages/lib/services/interop/InteropService_Importer_Md.ts 与对应的 Exporter 文件。八、桌面端独有体验多窗口、多配置与系统集成多窗口Secondary Windowv3.2.1 支持多窗口v3.3.3 新增从文件菜单打开次实例。v3.7 系列多次修复次窗口白板不可用、关闭时崩溃等问题。实现在 gui/WindowCommandsAndDialogs。多配置文件Profilesv2.8.2 支持多配置文件v3.5.10 用图形界面管理配置文件v3.7.1 允许删除默认配置。实现在 gui/ProfileEditor.tsx。系统托盘与快捷键v0.10.60 增加 Windows/macOS 托盘图标v3.5.4 点击托盘图标显示/隐藏主窗口v3.6.10 新增显示/隐藏 Joplin 的全局快捷键。主题体系内置 Aritim、Dracula、Nord、Solarized 等主题v1.0.199 加入 Aritim-Darkv1.0.173 加入 Nordv1.0.170 加入 Dracula主题文件位于 packages/lib/themes桌面端样式在 packages/app-desktop/style。九、如何利用本 Changelog 做技术决策定位功能实现将 Changelog 条目中的功能名与 packages/app-desktop/gui、packages/lib、packages/editor 三个目录对照绝大多数功能都能找到同名或近义目录/文件。判断升级风险关注Breaking Changes如 v1.4.12 的 Clipper API 破坏性变更、插件 manifestid/app_min_version变为必填与CAUTION标注如 v2.3.3 的同步目标升级须知。追踪安全基线Security条目中带 CVE 编号的记录是评估历史版本漏洞面的第一手资料。了解性能改进如 v3.4.2 Faster startup and smaller application size、v3.7.6 Cap ONNX embedding batch size to prevent renderer OOM、v1.0.127 Optimised loading speed of notes 2-3 times faster 等条目可作为性能调优的参照。十、结语Joplin 桌面端从 2017 年末至今的 Changelog是一部完整的隐私优先笔记应用工程演化史编辑器从单一 Markdown 走向 CodeMirror 6 富文本双轨同步从本地文件系统扩展到 WebDAV/Nextcloud/Dropbox/OneDrive/S3/Joplin Server 全谱系安全能力在持续对抗 XSS 与 CVE 中沉淀AI 时代则快速补齐了 Chat、MCP、语义搜索与白板等新形态。对开发者而言这份 Changelog 既是最可靠的版本间差异参考也是进入 packages/app-desktop 与 packages/lib 源码世界的精准导航图。【免费下载链接】joplinJoplin - the privacy-focused note taking app with sync capabilities for Windows, macOS, Linux, Android and iOS.项目地址: https://gitcode.com/GitHub_Trending/jo/joplin创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考