SiYuan v3.3.3 版本更新详解数据库功能增强、导出优化与 mermaid.js 升级【免费下载链接】siyuanAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间让人与智能体在此协作项目地址: https://gitcode.com/GitHub_Trending/si/siyuanSiYuan思源笔记v3.3.3 是一次以细节打磨为主的迭代版本重心放在数据库AV/属性视图能力的补全、块编辑与标题折叠交互的改进、导出兼容性的修复以及 mermaid.js 依赖从 11.6.0 升级到 11.11.0。读完本文你可以完整掌握该版本的每一项变更记录理解各项改进对应的功能场景并能在当前开源仓库中定位到相关实现文件进行源码级验证。版本概述根据官方变更记录 v3.3.3_zh_CN.md 的描述此版本“改进了一些细节”变更内容分为三大类改进功能30 项涵盖数据库资源字段筛选、数据库汇总/关联字段、块引用导出、标题折叠、Mermaid 升级、浏览器剪藏扩展、移动端等修复缺陷10 项集中在数据库属性面板、日期字段默认值、移动端数据库字段菜单、代码块排版、大纲拖动等开发者1 项为面包屑解锁/锁定按钮标签增加属性。由于该版本属于补丁级迭代以下逐项展开说明每项变更的实际技术含义与对应功能场景便于读者判断升级收益。改进功能逐项详解数据库AV 属性视图相关增强数据库是 SiYuan 中基于 SQLite 的结构化数据视图v3.3.3 对数据库做了本版本最密集的一组改进数据库资源字段支持筛选此前数据库中的资源Asset即附件/图片等文件字段无法参与查询条件本版本补齐了该字段类型的筛选能力使资源字段可以与其他字段一样用于过滤视图数据。数据库分组视图性能提升数据库支持表格、看板、画板画廊等视图形态分组视图在数据量大时渲染开销较高本版本针对分组视图做了性能优化。数据库菜单渲染改进优化了数据库上下文中各类菜单的渲染逻辑。数据库汇总Rollup字段支持使用关联字段汇总字段原本只能直接引用目标数据源的字段本版本允许汇总链路的中间环节是“关联Relation”字段即通过 A 表的关联字段指向 B 表再从 B 表汇总出数值打通了“关联 → 汇总”的组合用法。数据库汇总字段计算中增加“显示唯一值”汇总计算结果可以按去重后的唯一值展示避免重复计数造成的误导。数据库汇总复选框字段改进优化了复选框Checkboxes类型字段参与汇总统计时的行为。数据库关联字段不允许编辑未绑定块的图标关联字段指向的块图标若该块尚未绑定则禁止直接编辑避免出现悬空引用。数据库关联字段支持复制已有关联可以复制一条记录中已建立的关联值快速粘贴到其他记录减少重复关联操作。数据库交互细节改进对数据库整体交互体验做了一轮细节打磨。结合仓库结构可以看到数据库能力由 kernel/av/ 目录如 av.go、layout_table.go、relation.go与 kernel/sql/av.go、kernel/sql/av_kanban.go 等 SQL 查询层共同实现前端渲染与交互代码位于 app/src/protyle/ 与 app/src/card/ 目录下读者可沿这些路径对照上述改进点查看实现。编辑器块与标题交互改进折叠标题后新建的块为同级标题折叠一个标题后在其下方新建块时新块会被错误地创建为更深层级。本版本修正为新建块必须与被折叠标题同级保证大纲层级符合用户预期。增加标题展开与折叠的场景扩充了标题可被展开/折叠的场景范围使更多标题节点支持折叠操作。改进复制/剪切/删除“标题与下方块”菜单针对“标题及其下方块”作为整体进行复制、剪切、删除的菜单行为做了修正。移动文档后刷新界面数据在文件树中移动文档后界面中依赖文档位置的派生数据如面包屑、大纲等现在会随之刷新。在代码块开头使用退格键时改进交互优化了光标位于代码块首行按退格键时的行为避免误删或行为不符合直觉。改进字体加载对前端字体加载流程做了改进。仓库中内置了多套字体资源如 app/appearance/fonts/ 下的 JetBrains Mono、Noto COLRv1 等字体加载策略直接影响渲染性能。改进文档动态加载防止特定情况下持续自动加载修复了特定场景下编辑器动态加载机制可能陷入持续自动加载的问题。改进可编辑块的判断和 HTML 块的转义处理对“哪些块内容可编辑”的判定逻辑以及 HTML 块内容的转义处理做了修正降低特殊内容导致的渲染异常风险。改进图表和数学编辑对话框的拖拽图表Mermaid与数学公式编辑对话框的拖拽行为得到改进。改进打开文档兼容性提升打开文档时对各类内容的兼容性。导出与剪藏相关改进块引用元素导出时保留原有样式块引用Block Ref元素在导出时保留其原有样式避免导出结果中引用块样式丢失。导出 Markdown 行内代码时尽量去除末尾零宽空格SiYuan 的行内代码在编辑器内部会在末尾附加零宽空格用于排版保护导出 Markdown 时本版本会尽量剥离该字符得到更干净的导出结果。改进 HTML 代码块剪藏优化浏览器扩展剪藏 HTML 页面中代码块的处理。改进 HTML 剪藏 base64 图片剪藏含 base64 内嵌图片的 HTML 内容时对图片的处理做了改进。浏览器剪藏扩展支持“路径搜索时目录优先显示”剪藏扩展中选择保存路径时搜索结果中目录会优先展示提升路径选择效率。该图标能力可对照 app/src/mobile/menu/search.ts 中路径搜索菜单的图标引用如#iconInclude理解其 UI 结构。依赖升级与平台适配mermaid.js 从 11.6.0 升级到 11.11.0SiYuan 内置 Mermaid 图表渲染引擎本次升级跨度 5 个次版本通常带来图表语法支持增强与渲染缺陷修复。仓库中该依赖以前置打包形式存在于 app/stage/protyle/js/mermaid/mermaid.min.js另附有 app/stage/protyle/js/mermaid/mermaid-zenuml.min.js 提供 ZenUML 时序图扩展。此前 mermaid.js 在 v3.1.32 曾从旧版升级到 11.6.0见 v3.1.32_zh_CN.md本次继续跟进上游版本。Microsoft Store 支持 arm64 版本桌面端打包层面Microsoft Store 渠道新增 arm64 架构支持适配 Windows on ARM 设备。打包配置可参考 app/appx/AppxManifest-arm64.xml 与 app/electron-builder-arm64.yml。桌面端界面等待内核启动时间延长桌面端 UI 等待内核Go 编写的 kernel/main.go 启动的服务进程就绪的超时时间被延长缓解内核冷启动较慢导致的界面等待失败。改进关闭笔记本后重新打开的交互优化笔记本关闭再打开过程中的交互体验。新增图标iconInclude新增一枚 SVG 图标iconInclude用于“包含子项”之类的操作提示。该图标的 symbol 定义可查 app/appearance/icons/litheness/icon.js图标展示页面为 app/appearance/icons/index.html并已在 app/src/mobile/menu/search.ts 等前端菜单代码中被引用。修复缺陷清单v3.3.3 共修复 10 项缺陷逐条说明其影响面编辑器切换时光标未跟随编辑器在不同视图/文档间切换时光标位置现在会正确跟随不再停留在旧位置。数据库属性面板更新选择字段后点击其他选择字段无响应属性面板中修改某个选择Select字段后其余选择字段点击失效的问题被修复。数据库日期字段启用“默认填充创建时间”后自动填充的时间值不正确日期字段的“默认填充创建时间”配置产生的时间值此前有误现已修正为正确的创建时间。移动端数据库关联和汇总字段菜单未显示关联数据库名和字段名移动端配置数据库关联/汇总字段时菜单中不显示所指向的数据库名与字段名现已补齐显示方便用户确认指向关系。导出图片时代码块行号显示为 0将文档导出为图片时代码块行号被渲染为 0 的问题得到修复。文件历史无法加载数据库块的正确视图通过文件历史版本恢复功能加载数据库块时无法还原其正确视图的问题被修复。代码块包含 时“优化排版”异常代码块内容本身含有三个反引号时执行“优化排版”会解析异常本版本已处理该边界情况。“添加到数据库”会显示不在文档中的数据库文档操作中的“添加到数据库”入口此前会列出文档内不存在的数据库造成误选现已修正为只展示文档中实际存在的数据。鼠标点击插入标签时报错通过鼠标点击方式插入标签时触发报错的问题被修复。大纲拖动功能异常大纲面板中拖拽节点的行为异常得到修复。开发者变更为面包屑解锁/锁定按钮标签增加属性Pull Request #15820为面包屑上的解锁/锁定按钮标签元素补充了属性标记便于插件或自定义逻辑通过属性选择器定位该按钮属于面向插件生态的可扩展性改进。版本验证与仓库对照完整中文变更记录见 app/changelogs/v3.3.x/v3.3.3/v3.3.3_zh_CN.md英文版见 app/changelogs/v3.3.x/v3.3.3/v3.3.3.mdMermaid 依赖实体文件位于 app/stage/protyle/js/mermaid/可确认 11.11.0 的前置打包产物新增图标iconInclude的 SVG symbol 定义位于 app/appearance/icons/litheness/icon.js可在图标展示页 app/appearance/icons/index.html 中查看效果数据库AV功能的内核实现分布于 kernel/av/、kernel/sql/av.go 等文件移动端菜单交互位于 app/src/mobile/ 目录可用于核对上述改进与修复的前后端分工。小结v3.3.3 没有引入大型新功能而是集中补强了数据库能力链资源字段筛选、汇总链支持关联字段、唯一值显示、复制关联、标题与代码块等编辑器交互细节、导出与剪藏的边界问题并将 mermaid.js 跟进到 11.11.0。对于重度使用数据库视图和 Mermaid 图表的用户以及 Windows on ARMMicrosoft Store arm64设备用户本次更新值得升级。升级后可对照上文逐项验证各改进与修复是否生效。【免费下载链接】siyuanAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间让人与智能体在此协作项目地址: https://gitcode.com/GitHub_Trending/si/siyuan创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考