SiYuan v3.1.31 版本技术解读查找替换、块引用锚文本、标题层级与大纲导航的细节打磨【免费下载链接】siyuanAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间让人与智能体在此协作项目地址: https://gitcode.com/GitHub_Trending/si/siyuan导读本文基于 SiYuan思源笔记开源仓库中 v3.1.31 版本的官方变更记录app/changelogs/v3.1.x/v3.1.31/v3.1.31_zh_CN.md逐项解读该版本对编辑器、搜索、块引用、数据库资源字段、大纲导航等核心能力的改进与缺陷修复并结合仓库源码给出实现层面的佐证。读完本文你将清楚 v3.1.31 在细节体验层面动了哪些手术、这些改动背后对应哪些源码模块以及如何验证与使用这些新行为。版本概览一次聚焦细节的小版本迭代官方变更记录对该版本的定位非常朴素——此版本改进了一些细节。与引入重磅新特性的大版本不同v3.1.31 的核心价值在于编辑器与检索链路的稳定性与手感共包含 8 项功能改进与 2 项缺陷修复覆盖前台资源管理器打开、查找替换、块引用动态锚文本、行级元素设置、标题块层级同步、大纲跳转、数据库资源字段排序、本地图片链接参数支持以及嵌入块跳转、Android 授权码黑屏等关键场景。从变更清单的分布看v3.1.31 的重点明显偏向块级数据一致性与跨端可用性——既有内核侧kernel的数据维护逻辑修正也有前端app/src交互细节的优化。改进功能逐项解读1. 在前台打开资源管理器窗口该版本支持在前台打开资源管理器窗口解决的是窗口焦点/层级管理问题当资源管理器文件管理器被唤起时不再被其他窗口遮挡而是直接呈现到前台。这与桌面端 Electron 窗口管理逻辑相关窗口相关实现位于 app/electron/main.js 与 app/src/window 目录。从使用体验看该改动让文档 → 打开资源管理器这类操作的反馈更即时、更符合直觉。2. 改进查找替换功能查找替换是 SiYuan 搜索标签页中的高频能力。该版本针对查找替换功能进行了细节改进对应官方 issue #14840。从源码看查找替换的前端实现集中在 app/src/search/index.ts 与 app/src/search/menu.tsapp/src/search/index.ts 中的updateSearch(text, replace)负责同步搜索输入框内容并根据replace布尔参数区分普通查找与替换两种操作模式app/src/search/menu.ts 中的replaceFilterMenu提供替换类型的过滤配置面板基于Constants.SIYUAN_DEFAULT_REPLACETYPES生成一组开关每个开关通过window.siyuan.languages.replaceTypes[key]取到本地化文案用户勾选后写入config.replaceTypes并持久化到window.siyuan.storage[Constants.LOCAL_SEARCHDATA]。这意味着替换行为哪些类型的内容参与替换是可配置、可记忆的v3.1.31 在这一链路上修正了细节问题使批量替换时的过滤条件更可靠。3. 改进块引用动态锚文本和数据库主键锚文本更新动态锚文本dynamic anchor text是 SiYuan 块引用体系的核心机制当被引用块的内容变化时引用处显示的锚文本可随之动态更新。该版本改进了块引用动态锚文本与数据库主键锚文本的更新逻辑issue #14850确保内容变更后引用侧文本同步更及时、更准确。在内核侧dynamicAnchorText贯穿多个数据维护模块可在以下文件中检索到相关处理逻辑kernel/conf/editor.go —— 编辑器相关配置中维护动态锚文本开关与行为kernel/model/blockinfo.go —— 块信息维护涉及锚文本相关的块数据刷新kernel/model/export.go、kernel/model/import.go —— 导入导出流程中对锚文本的兼容处理kernel/model/search.go —— 搜索结果中锚文本相关的呈现与匹配。数据库主键锚文本则与属性视图Attribute View联动相关块数据更新可参见 kernel/treenode/blocktree.go。本次改进正是针对这类引用侧文本跟随源内容的场景做了进一步打磨。4. 改进行级元素设置行级元素inline element指文档中的加粗、斜体、行内代码、超链接、标记等行内样式。该版本改进了行级元素设置面板issue #14865涉及弹出菜单的交互与光标选区行为。行级元素设置的前端实现主要位于 app/src/menus 目录菜单弹出逻辑与 app/src/protyle 目录块编辑器渲染与选区处理。本次改动属于编辑器手感层面的细节优化例如设置面板的定位、选中范围的反馈等。5. 更新标题块时同步更新其下方块的 parent_id这是一项典型的数据一致性改进issue #14871此前在更新标题块时标题下方子块的parent_id可能未能及时同步导致块的父子层级关系与大纲结构出现错位该版本在更新标题块后会同步更新标题块下方各块的parent_id保证文档树结构始终与所见一致。内核侧与标题块更新、子块层级维护相关的代码位于kernel/model/heading.go —— 标题块操作的入口包含标题更新时的折叠一致性处理当标题位于某个折叠标题下方时会通过treenode.GetParentFoldedHeading找到上层折叠标题并展开再遍历HeadingChildren维护子树状态见 kernel/model/heading.gokernel/treenode/blocktree.go —— 块树BlockTree的父子关系维护parent_id的读写与索引更新在此完成kernel/sql/database.go、kernel/sql/upsert.go —— SQL 层对块父子关系字段的持久化与 upsert。可以推断本次修复的核心是确保标题块路径调整后parent_id的更新能沿着块树正确向下传播避免大纲、面包屑与 SQL 查询出现陈旧数据。6. 改进大纲跳转定位大纲Outline面板用于按标题层级快速导航文档。该版本改进大纲跳转的定位精度issue #14878使点击大纲条目后编辑器能准确滚动并定位到对应标题所在的可视位置避免跳转后出现偏移。大纲相关的内核实现位于 kernel/api/outline.go前端面板位于 app/src/layout/dock 目录。本次改动是对跳转偏移量的细节修正属于长文档场景下的体验优化。7. 改进数据库资源字段值调整排序属性视图数据库中的资源字段Asset用于在记录中存放图片、文件等附件。该版本改进了资源字段值调整排序时的行为issue #14886即在表格/看板/画廊等视图中拖拽调整资源字段顺序时排序结果更稳定、更符合预期。属性视图的排序实现集中在内核的 kernel/av 目录其中 kernel/av/sort.go 负责各类视图的排序逻辑kernel/av/value.go 定义字段值模型kernel/av/layout_table.go 等文件对应各视图布局。本次改进可以推断是对资源字段这类非标量值的排序稳定性做了修正。8. 支持带参数的本地图片链接该版本支持在本地图片链接中携带参数issue #14894即图片资源路径可以附带查询参数如assets/image.png?widthxxx之类的用法使本地图片链接与 Web 图片链接在参数语义上保持一致。资源加载相关的前端逻辑位于 app/src/asset 目录内核侧的资源路径解析可参考 kernel/model/path.go 与 kernel/model/assets.go。带参数本地图片链接的支持为后续基于图片参数的渲染控制如缩放、裁剪指令预留了能力。缺陷修复解读修复块引用和块超链接跳转到嵌入块此前从块引用或块超链接跳转时如果目标是一个嵌入块iframe 块引用跳转落点可能不准确。该版本修复了块引用和块超链接跳转到嵌入块的问题issue #14870确保跳转能正确落到嵌入块本身及其上下文。这与跳转目标解析逻辑相关前端跳转处理可参见 app/src/protyle 目录中的引用跳转实现内核侧块定位可参见 kernel/api/ref.go。修复在 Android 上启用授权码可能会导致黑屏服务端授权码Access Code是 SiYuan 用于保护本地/局域网访问的安全机制。此前在 Android 端启用授权码后可能出现启动黑屏问题issue #14876。该版本修复了此问题保证移动端在启用授权码后仍能正常加载界面。授权码的校验逻辑位于内核 kernel/util/session.go 与 kernel/model/auth.go移动端内核入口可参见 kernel/mobile/kernel.go。可以推断黑屏的根因与授权码校验流程阻塞了前端资源加载有关本次修复理顺了校验与启动流程的时序。如何获取与验证 v3.1.31该版本属于思源笔记 v3.1.x 系列的补丁版本。下载安装请使用官方发布渠道思源笔记官方下载页或 GitHub Releases 中的 v3.1.31 标签页选择与操作系统匹配的安装包Windows / macOS / Linux 桌面端以及 Android 移动端均包含在本版本发布范围内。验证方式建议查找替换在搜索标签页打开替换模式勾选/取消替换类型过滤开关后执行批量替换观察过滤条件是否被正确记忆配置持久化于Constants.LOCAL_SEARCHDATA标题层级同步创建一个标题及若干子块修改标题文本或调整标题级别后通过数据库/大纲检查子块parent_id是否同步更新Android 授权码在 Android 端开启授权码后重启应用确认不再出现黑屏本地图片参数在文档中插入带参数的本地图片链接确认图片能正常加载渲染。小结v3.1.31 虽定位为改进了一些细节的小版本但从源码层面看它涉及了搜索替换配置、动态锚文本同步、标题父子关系一致性、数据库资源字段排序、大纲定位、本地图片参数解析等多条核心链路。这类细节修复的价值在于它们共同保证了 SiYuan 块级知识管理模型在长期使用、跨端切换场景下的数据可靠性与操作一致性。对于关注编辑器内核稳定性的开发者与重度用户而言该版本值得优先升级。【免费下载链接】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），仅供参考 SiYuan v3.1.31 版本技术解读：查找替换、块引用锚文本、标题层级与大纲导航的细节打磨
SiYuan v3.1.31 版本技术解读查找替换、块引用锚文本、标题层级与大纲导航的细节打磨【免费下载链接】siyuanAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间让人与智能体在此协作项目地址: https://gitcode.com/GitHub_Trending/si/siyuan导读本文基于 SiYuan思源笔记开源仓库中 v3.1.31 版本的官方变更记录app/changelogs/v3.1.x/v3.1.31/v3.1.31_zh_CN.md逐项解读该版本对编辑器、搜索、块引用、数据库资源字段、大纲导航等核心能力的改进与缺陷修复并结合仓库源码给出实现层面的佐证。读完本文你将清楚 v3.1.31 在细节体验层面动了哪些手术、这些改动背后对应哪些源码模块以及如何验证与使用这些新行为。版本概览一次聚焦细节的小版本迭代官方变更记录对该版本的定位非常朴素——此版本改进了一些细节。与引入重磅新特性的大版本不同v3.1.31 的核心价值在于编辑器与检索链路的稳定性与手感共包含 8 项功能改进与 2 项缺陷修复覆盖前台资源管理器打开、查找替换、块引用动态锚文本、行级元素设置、标题块层级同步、大纲跳转、数据库资源字段排序、本地图片链接参数支持以及嵌入块跳转、Android 授权码黑屏等关键场景。从变更清单的分布看v3.1.31 的重点明显偏向块级数据一致性与跨端可用性——既有内核侧kernel的数据维护逻辑修正也有前端app/src交互细节的优化。改进功能逐项解读1. 在前台打开资源管理器窗口该版本支持在前台打开资源管理器窗口解决的是窗口焦点/层级管理问题当资源管理器文件管理器被唤起时不再被其他窗口遮挡而是直接呈现到前台。这与桌面端 Electron 窗口管理逻辑相关窗口相关实现位于 app/electron/main.js 与 app/src/window 目录。从使用体验看该改动让文档 → 打开资源管理器这类操作的反馈更即时、更符合直觉。2. 改进查找替换功能查找替换是 SiYuan 搜索标签页中的高频能力。该版本针对查找替换功能进行了细节改进对应官方 issue #14840。从源码看查找替换的前端实现集中在 app/src/search/index.ts 与 app/src/search/menu.tsapp/src/search/index.ts 中的updateSearch(text, replace)负责同步搜索输入框内容并根据replace布尔参数区分普通查找与替换两种操作模式app/src/search/menu.ts 中的replaceFilterMenu提供替换类型的过滤配置面板基于Constants.SIYUAN_DEFAULT_REPLACETYPES生成一组开关每个开关通过window.siyuan.languages.replaceTypes[key]取到本地化文案用户勾选后写入config.replaceTypes并持久化到window.siyuan.storage[Constants.LOCAL_SEARCHDATA]。这意味着替换行为哪些类型的内容参与替换是可配置、可记忆的v3.1.31 在这一链路上修正了细节问题使批量替换时的过滤条件更可靠。3. 改进块引用动态锚文本和数据库主键锚文本更新动态锚文本dynamic anchor text是 SiYuan 块引用体系的核心机制当被引用块的内容变化时引用处显示的锚文本可随之动态更新。该版本改进了块引用动态锚文本与数据库主键锚文本的更新逻辑issue #14850确保内容变更后引用侧文本同步更及时、更准确。在内核侧dynamicAnchorText贯穿多个数据维护模块可在以下文件中检索到相关处理逻辑kernel/conf/editor.go —— 编辑器相关配置中维护动态锚文本开关与行为kernel/model/blockinfo.go —— 块信息维护涉及锚文本相关的块数据刷新kernel/model/export.go、kernel/model/import.go —— 导入导出流程中对锚文本的兼容处理kernel/model/search.go —— 搜索结果中锚文本相关的呈现与匹配。数据库主键锚文本则与属性视图Attribute View联动相关块数据更新可参见 kernel/treenode/blocktree.go。本次改进正是针对这类引用侧文本跟随源内容的场景做了进一步打磨。4. 改进行级元素设置行级元素inline element指文档中的加粗、斜体、行内代码、超链接、标记等行内样式。该版本改进了行级元素设置面板issue #14865涉及弹出菜单的交互与光标选区行为。行级元素设置的前端实现主要位于 app/src/menus 目录菜单弹出逻辑与 app/src/protyle 目录块编辑器渲染与选区处理。本次改动属于编辑器手感层面的细节优化例如设置面板的定位、选中范围的反馈等。5. 更新标题块时同步更新其下方块的 parent_id这是一项典型的数据一致性改进issue #14871此前在更新标题块时标题下方子块的parent_id可能未能及时同步导致块的父子层级关系与大纲结构出现错位该版本在更新标题块后会同步更新标题块下方各块的parent_id保证文档树结构始终与所见一致。内核侧与标题块更新、子块层级维护相关的代码位于kernel/model/heading.go —— 标题块操作的入口包含标题更新时的折叠一致性处理当标题位于某个折叠标题下方时会通过treenode.GetParentFoldedHeading找到上层折叠标题并展开再遍历HeadingChildren维护子树状态见 kernel/model/heading.gokernel/treenode/blocktree.go —— 块树BlockTree的父子关系维护parent_id的读写与索引更新在此完成kernel/sql/database.go、kernel/sql/upsert.go —— SQL 层对块父子关系字段的持久化与 upsert。可以推断本次修复的核心是确保标题块路径调整后parent_id的更新能沿着块树正确向下传播避免大纲、面包屑与 SQL 查询出现陈旧数据。6. 改进大纲跳转定位大纲Outline面板用于按标题层级快速导航文档。该版本改进大纲跳转的定位精度issue #14878使点击大纲条目后编辑器能准确滚动并定位到对应标题所在的可视位置避免跳转后出现偏移。大纲相关的内核实现位于 kernel/api/outline.go前端面板位于 app/src/layout/dock 目录。本次改动是对跳转偏移量的细节修正属于长文档场景下的体验优化。7. 改进数据库资源字段值调整排序属性视图数据库中的资源字段Asset用于在记录中存放图片、文件等附件。该版本改进了资源字段值调整排序时的行为issue #14886即在表格/看板/画廊等视图中拖拽调整资源字段顺序时排序结果更稳定、更符合预期。属性视图的排序实现集中在内核的 kernel/av 目录其中 kernel/av/sort.go 负责各类视图的排序逻辑kernel/av/value.go 定义字段值模型kernel/av/layout_table.go 等文件对应各视图布局。本次改进可以推断是对资源字段这类非标量值的排序稳定性做了修正。8. 支持带参数的本地图片链接该版本支持在本地图片链接中携带参数issue #14894即图片资源路径可以附带查询参数如assets/image.png?widthxxx之类的用法使本地图片链接与 Web 图片链接在参数语义上保持一致。资源加载相关的前端逻辑位于 app/src/asset 目录内核侧的资源路径解析可参考 kernel/model/path.go 与 kernel/model/assets.go。带参数本地图片链接的支持为后续基于图片参数的渲染控制如缩放、裁剪指令预留了能力。缺陷修复解读修复块引用和块超链接跳转到嵌入块此前从块引用或块超链接跳转时如果目标是一个嵌入块iframe 块引用跳转落点可能不准确。该版本修复了块引用和块超链接跳转到嵌入块的问题issue #14870确保跳转能正确落到嵌入块本身及其上下文。这与跳转目标解析逻辑相关前端跳转处理可参见 app/src/protyle 目录中的引用跳转实现内核侧块定位可参见 kernel/api/ref.go。修复在 Android 上启用授权码可能会导致黑屏服务端授权码Access Code是 SiYuan 用于保护本地/局域网访问的安全机制。此前在 Android 端启用授权码后可能出现启动黑屏问题issue #14876。该版本修复了此问题保证移动端在启用授权码后仍能正常加载界面。授权码的校验逻辑位于内核 kernel/util/session.go 与 kernel/model/auth.go移动端内核入口可参见 kernel/mobile/kernel.go。可以推断黑屏的根因与授权码校验流程阻塞了前端资源加载有关本次修复理顺了校验与启动流程的时序。如何获取与验证 v3.1.31该版本属于思源笔记 v3.1.x 系列的补丁版本。下载安装请使用官方发布渠道思源笔记官方下载页或 GitHub Releases 中的 v3.1.31 标签页选择与操作系统匹配的安装包Windows / macOS / Linux 桌面端以及 Android 移动端均包含在本版本发布范围内。验证方式建议查找替换在搜索标签页打开替换模式勾选/取消替换类型过滤开关后执行批量替换观察过滤条件是否被正确记忆配置持久化于Constants.LOCAL_SEARCHDATA标题层级同步创建一个标题及若干子块修改标题文本或调整标题级别后通过数据库/大纲检查子块parent_id是否同步更新Android 授权码在 Android 端开启授权码后重启应用确认不再出现黑屏本地图片参数在文档中插入带参数的本地图片链接确认图片能正常加载渲染。小结v3.1.31 虽定位为改进了一些细节的小版本但从源码层面看它涉及了搜索替换配置、动态锚文本同步、标题父子关系一致性、数据库资源字段排序、大纲定位、本地图片参数解析等多条核心链路。这类细节修复的价值在于它们共同保证了 SiYuan 块级知识管理模型在长期使用、跨端切换场景下的数据可靠性与操作一致性。对于关注编辑器内核稳定性的开发者与重度用户而言该版本值得优先升级。【免费下载链接】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），仅供参考