思源笔记 v3.1.15 版本解读鸿蒙支持落地与编辑器、数据库、搜索体验全面进化【免费下载链接】siyuanAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间让人与智能体在此协作项目地址: https://gitcode.com/GitHub_Trending/si/siyuan导读思源笔记SiYuanv3.1.15 是一个以新平台 细节打磨为双主线的小版本一方面正式将鸿蒙系统纳入支持的移动端平台另一方面围绕编辑器交互、数据库、搜索、导出、剪藏等高频使用场景完成了 20 余项改进与缺陷修复并为开发者新增了文档批量移动 API 与 Protyle 实例级开关方法。读完本文你将完整了解该版本的功能变更清单、关键改进背后的源码实现原理以及可供插件与自动化脚本直接调用的新内核 API 用法。版本概述根据 v3.1.15 更新日志本版本的核心亮点是支持鸿蒙系统HarmonyOS使思源笔记的移动端覆盖范围进一步扩展。除平台支持外该版本还包含若干编辑器、数据库与搜索相关的改进以及一批针对移动端数据历史、同步冲突等问题的缺陷修复。改进功能详解编辑器与窗口交互改进 AltM 隐藏/显示视窗桌面端快捷键AltM用于快速隐藏/显示主窗口本版本优化了该交互的响应逻辑适合需要频繁切换窗口进行对照写作或查阅的场景。改进文件标签添加交互文件标签Tag的添加流程得到优化减少了输入与确认之间的操作摩擦。改进工具提示界面工具提示Tooltip的展示逻辑改进涉及 breadcrumb/index.ts 等前端模块中的菜单交互代码。改进系统字体载入优化了系统字体的加载时机与顺序降低启动阶段字体阻塞渲染的概率。数据库相关改进改进数据库单元格定位和编辑输入框大小属性视图Attribute View表格中单元格的定位精度与编辑输入框尺寸得到调整提升长文本编辑体验。支援数据库日期栏位少于 4 位元的年份日期字段现在可以正确处理少于 4 位数字的年份如123、45这类非标准但合法的年份值。该能力与 attribute_view.go 中基于time包对日期分组av.GroupMethodDateDay/Week/Month/Year/Relative的处理逻辑相互配合日期值的解析与分组不再假设年份必然为 4 位。改进数据库描述的互动属性视图描述区域的交互行为优化。属性面板 - 数据库支持移除目前块在属性面板中操作数据库字段时可以直接移除当前块简化了从数据库中解除某个块关联的操作路径。搜索与引用改进导出块引用块引用导出时的格式与内容组织得到优化。改进搜索高亮搜索结果中的关键词高亮逻辑改进尤其针对包含特殊字符如%的查询与文档内容。简化搜索结果中的文件块路径搜索结果中文件块的路径展示被精简减少冗余层级便于快速定位。改进范本搜索模板Template搜索的匹配与结果排序优化。修复点选行级标签后找不到结果此前在搜索结果中点击行级标签可能无法正确跳转或过滤本版本修复了该问题。剪藏与资源播放改进 HTML 剪藏浏览器剪藏扩展Web Clipper对 HTML 内容的清洗与转换逻辑改进粘贴或剪藏时能更干净地去除冗余样式。浏览器剪藏扩充功能加入了一些实验性功能剪藏扩展新增若干实验性能力可在扩展设置中按需启用。支援 flac 音讯资源播放FLAC 无损音频格式正式纳入资源播放支持。从源码实现看path.go 中的音频资源类型列表SiYuanAssetsAudio已包含.flac同时 serve.go 在 gzip 压缩排除列表中也将.flac排除避免对已压缩的音频流做无意义的二次压缩file.go 的 MIME 类型映射同样覆盖.flac。这意味着 FLAC 文件会被正确识别为音频资源并可通过内置播放器直接播放。其他改进贴上时移除折叠标题的折叠状态粘贴内容时若来源包含折叠标题粘贴结果会自动展开折叠状态避免复制一份折叠中的文档后粘贴到新位置仍保持折叠、内容不可见的困惑。产生包含字符的块引用时导致奇怪的行为修复了块引用文本中包含单引号时引用生成异常的问题该问题与引用 ID 与文本的拼接解析有关。当图像 URL 包含%时无法双击预览修复了图片地址中含百分号URL 编码字符时双击无法打开预览的问题。在 Linux 上使用鼠标中键关闭标签页会触发贴上修复了 Linux 桌面端中键点击关闭标签页时误触发粘贴即中键粘贴行为的冲突。改进设定外观优先权设置中外观Appearance相关配置的优先级判断得到修正涉及 appearanceRuntime.ts 中主题模式明亮/暗黑/跟随系统的切换逻辑。修复缺陷汇总本版本共修复 6 项缺陷覆盖移动端与桌面端缺陷影响场景行动端资料历史中的文件在下滑时关闭移动端数据历史列表滚动时文件意外收起点选行级标签后找不到结果搜索场景下行级标签跳转失效HTML 标签搜寻转义问题搜索 HTML 标签时的转义处理错误汇出至 .docx 的有序列表序号不正确Word 导出时有序列表编号错乱以.结尾的档案名称被视为缺失资源文件名以点结尾时资源识别误判完全手动同步模式导致资料冲突纯手动同步模式下数据一致性受损其中完全手动同步模式导致资料冲突值得注意该修复涉及同步引擎的冲突处理分支sync.go在手动同步模式下需要更加谨慎地处理本地与远端的分叉避免静默覆盖。面向开发者的变更改进选择块或表格单元格后的按键操作选择块或表格单元格后Backspace、Delete、Tab、ShiftTab的按键行为得到系统性改进编辑器的选区删除与表格内焦点移动逻辑更加符合直觉。新增内核 API/api/filetree/moveDocsByID这是本版本对开发者最有价值的新增接口允许通过文档 ID而非路径批量移动文档。该接口的实现位于 filetree.go其核心流程为从请求参数中读取fromIDs源文档 ID 数组与toID目标位置块 ID逐一校验 ID 合法性util.InvalidIDPattern通过model.LoadTreeByBlockID将每个 ID 解析为文档树路径并去重若toID无法解析为树则回退将其视为笔记本 IDmodel.Conf.Box处理最终复用既有的model.MoveDocs完成实际的树移动与索引更新。相比旧的/api/filetree/moveDocs基于fromPaths/toPath/toNotebook路径参数见 filetree.go新接口屏蔽了路径概念调用方只需持有块 ID 即可完成移动显著降低了插件与自动化脚本的使用门槛。接口已同步登记在 API.zh-CN.md 文档中。请求示例{ fromIDs: [20210808180117-6v0mkxr, 20210808180117-czj9bvb], toID: 20211226090932-5lcq56f }为 Protyle 新增disable和enable方法Protyle思源笔记的编辑器渲染实例新增了实例级开关方法实现位于 app/src/protyle/index.tspublic disable() { disabledProtyle(this.protyle); } public enable() { enableProtyle(this.protyle); }这两个方法分别调用disabledProtyle/enableProtyle对实例进行整体禁用与恢复适用于插件在运行时临时接管或锁定编辑器输入的场景。移除编辑器输入控制台日志移除了编辑器输入过程中的控制台调试日志减少开发者模式下的噪声输出避免影响对真实告警信息的排查。下载与升级本版本的发布包可通过思源笔记官网与 GitHub Releases 获取更新日志原文 中的下载一节涵盖桌面端与移动端各平台。升级前建议先备份工作空间Workspace尤其是使用同步功能的用户应等待同步完成后在多个设备上依次升级以确保数据一致性。结语v3.1.15 是思源笔记在横向扩平台、纵向深打磨策略下的一个典型版本鸿蒙系统的支持让移动端生态更加完整编辑器与数据库的交互改进直接作用于日常写作效率而moveDocsByID与 Protyledisable/enable则为插件开发者提供了更简洁、更稳定的扩展接口。如果你正在为思源笔记开发插件或正在评估其作为知识管理平台的成熟度这个版本值得关注。【免费下载链接】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），仅供参考
思源笔记 v3.1.15 版本解读鸿蒙支持落地与编辑器、数据库、搜索体验全面进化【免费下载链接】siyuanAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间让人与智能体在此协作项目地址: https://gitcode.com/GitHub_Trending/si/siyuan导读思源笔记SiYuanv3.1.15 是一个以新平台 细节打磨为双主线的小版本一方面正式将鸿蒙系统纳入支持的移动端平台另一方面围绕编辑器交互、数据库、搜索、导出、剪藏等高频使用场景完成了 20 余项改进与缺陷修复并为开发者新增了文档批量移动 API 与 Protyle 实例级开关方法。读完本文你将完整了解该版本的功能变更清单、关键改进背后的源码实现原理以及可供插件与自动化脚本直接调用的新内核 API 用法。版本概述根据 v3.1.15 更新日志本版本的核心亮点是支持鸿蒙系统HarmonyOS使思源笔记的移动端覆盖范围进一步扩展。除平台支持外该版本还包含若干编辑器、数据库与搜索相关的改进以及一批针对移动端数据历史、同步冲突等问题的缺陷修复。改进功能详解编辑器与窗口交互改进 AltM 隐藏/显示视窗桌面端快捷键AltM用于快速隐藏/显示主窗口本版本优化了该交互的响应逻辑适合需要频繁切换窗口进行对照写作或查阅的场景。改进文件标签添加交互文件标签Tag的添加流程得到优化减少了输入与确认之间的操作摩擦。改进工具提示界面工具提示Tooltip的展示逻辑改进涉及 breadcrumb/index.ts 等前端模块中的菜单交互代码。改进系统字体载入优化了系统字体的加载时机与顺序降低启动阶段字体阻塞渲染的概率。数据库相关改进改进数据库单元格定位和编辑输入框大小属性视图Attribute View表格中单元格的定位精度与编辑输入框尺寸得到调整提升长文本编辑体验。支援数据库日期栏位少于 4 位元的年份日期字段现在可以正确处理少于 4 位数字的年份如123、45这类非标准但合法的年份值。该能力与 attribute_view.go 中基于time包对日期分组av.GroupMethodDateDay/Week/Month/Year/Relative的处理逻辑相互配合日期值的解析与分组不再假设年份必然为 4 位。改进数据库描述的互动属性视图描述区域的交互行为优化。属性面板 - 数据库支持移除目前块在属性面板中操作数据库字段时可以直接移除当前块简化了从数据库中解除某个块关联的操作路径。搜索与引用改进导出块引用块引用导出时的格式与内容组织得到优化。改进搜索高亮搜索结果中的关键词高亮逻辑改进尤其针对包含特殊字符如%的查询与文档内容。简化搜索结果中的文件块路径搜索结果中文件块的路径展示被精简减少冗余层级便于快速定位。改进范本搜索模板Template搜索的匹配与结果排序优化。修复点选行级标签后找不到结果此前在搜索结果中点击行级标签可能无法正确跳转或过滤本版本修复了该问题。剪藏与资源播放改进 HTML 剪藏浏览器剪藏扩展Web Clipper对 HTML 内容的清洗与转换逻辑改进粘贴或剪藏时能更干净地去除冗余样式。浏览器剪藏扩充功能加入了一些实验性功能剪藏扩展新增若干实验性能力可在扩展设置中按需启用。支援 flac 音讯资源播放FLAC 无损音频格式正式纳入资源播放支持。从源码实现看path.go 中的音频资源类型列表SiYuanAssetsAudio已包含.flac同时 serve.go 在 gzip 压缩排除列表中也将.flac排除避免对已压缩的音频流做无意义的二次压缩file.go 的 MIME 类型映射同样覆盖.flac。这意味着 FLAC 文件会被正确识别为音频资源并可通过内置播放器直接播放。其他改进贴上时移除折叠标题的折叠状态粘贴内容时若来源包含折叠标题粘贴结果会自动展开折叠状态避免复制一份折叠中的文档后粘贴到新位置仍保持折叠、内容不可见的困惑。产生包含字符的块引用时导致奇怪的行为修复了块引用文本中包含单引号时引用生成异常的问题该问题与引用 ID 与文本的拼接解析有关。当图像 URL 包含%时无法双击预览修复了图片地址中含百分号URL 编码字符时双击无法打开预览的问题。在 Linux 上使用鼠标中键关闭标签页会触发贴上修复了 Linux 桌面端中键点击关闭标签页时误触发粘贴即中键粘贴行为的冲突。改进设定外观优先权设置中外观Appearance相关配置的优先级判断得到修正涉及 appearanceRuntime.ts 中主题模式明亮/暗黑/跟随系统的切换逻辑。修复缺陷汇总本版本共修复 6 项缺陷覆盖移动端与桌面端缺陷影响场景行动端资料历史中的文件在下滑时关闭移动端数据历史列表滚动时文件意外收起点选行级标签后找不到结果搜索场景下行级标签跳转失效HTML 标签搜寻转义问题搜索 HTML 标签时的转义处理错误汇出至 .docx 的有序列表序号不正确Word 导出时有序列表编号错乱以.结尾的档案名称被视为缺失资源文件名以点结尾时资源识别误判完全手动同步模式导致资料冲突纯手动同步模式下数据一致性受损其中完全手动同步模式导致资料冲突值得注意该修复涉及同步引擎的冲突处理分支sync.go在手动同步模式下需要更加谨慎地处理本地与远端的分叉避免静默覆盖。面向开发者的变更改进选择块或表格单元格后的按键操作选择块或表格单元格后Backspace、Delete、Tab、ShiftTab的按键行为得到系统性改进编辑器的选区删除与表格内焦点移动逻辑更加符合直觉。新增内核 API/api/filetree/moveDocsByID这是本版本对开发者最有价值的新增接口允许通过文档 ID而非路径批量移动文档。该接口的实现位于 filetree.go其核心流程为从请求参数中读取fromIDs源文档 ID 数组与toID目标位置块 ID逐一校验 ID 合法性util.InvalidIDPattern通过model.LoadTreeByBlockID将每个 ID 解析为文档树路径并去重若toID无法解析为树则回退将其视为笔记本 IDmodel.Conf.Box处理最终复用既有的model.MoveDocs完成实际的树移动与索引更新。相比旧的/api/filetree/moveDocs基于fromPaths/toPath/toNotebook路径参数见 filetree.go新接口屏蔽了路径概念调用方只需持有块 ID 即可完成移动显著降低了插件与自动化脚本的使用门槛。接口已同步登记在 API.zh-CN.md 文档中。请求示例{ fromIDs: [20210808180117-6v0mkxr, 20210808180117-czj9bvb], toID: 20211226090932-5lcq56f }为 Protyle 新增disable和enable方法Protyle思源笔记的编辑器渲染实例新增了实例级开关方法实现位于 app/src/protyle/index.tspublic disable() { disabledProtyle(this.protyle); } public enable() { enableProtyle(this.protyle); }这两个方法分别调用disabledProtyle/enableProtyle对实例进行整体禁用与恢复适用于插件在运行时临时接管或锁定编辑器输入的场景。移除编辑器输入控制台日志移除了编辑器输入过程中的控制台调试日志减少开发者模式下的噪声输出避免影响对真实告警信息的排查。下载与升级本版本的发布包可通过思源笔记官网与 GitHub Releases 获取更新日志原文 中的下载一节涵盖桌面端与移动端各平台。升级前建议先备份工作空间Workspace尤其是使用同步功能的用户应等待同步完成后在多个设备上依次升级以确保数据一致性。结语v3.1.15 是思源笔记在横向扩平台、纵向深打磨策略下的一个典型版本鸿蒙系统的支持让移动端生态更加完整编辑器与数据库的交互改进直接作用于日常写作效率而moveDocsByID与 Protyledisable/enable则为插件开发者提供了更简洁、更稳定的扩展接口。如果你正在为思源笔记开发插件或正在评估其作为知识管理平台的成熟度这个版本值得关注。【免费下载链接】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），仅供参考
