ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

思源笔记 v2.8.10 版本全解析:Windows 7/8 最后支持版与插件生态发布前奏

思源笔记 v2.8.10 版本全解析:Windows 7/8 最后支持版与插件生态发布前奏 思源笔记 v2.8.10 版本全解析Windows 7/8 最后支持版与插件生态发布前奏【免费下载链接】siyuanAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间让人与智能体在此协作项目地址: https://gitcode.com/GitHub_Trending/si/siyuan思源笔记 v2.8.10 是一个具有明确承前启后意义的版本它既是最后一个支持 Windows 7、8 和 Server 2012 的发布也是 v2.9.0 插件系统正式发布前对集市包配置、事件总线与插件 API 进行大规模铺垫的热身版本。本文以仓库内 v2.8.10_zh_CN.md 官方变更记录为骨架逐项解读该版本的编辑器改进、缺陷修复、性能优化与开发者 API 变更并结合kernel/Go 内核与app/src/前端中的源码给出实现层面的印证帮助读者完整把握该版本的价值与影响。版本定位与升级前提Windows 7/8 的最后支持版本v2.8.10 的开篇声明是整个版本最重要的信息这是最后一个支持 Windows 7、8 和 Server 2012 的版本。从 v2.9.0 开始后续版本将要求 Windows 10 或更高版本操作系统。这意味着仍在旧版 Windows 上使用思源笔记的用户应以 v2.8.10 作为可长期驻留的稳定基线而需要体验后续新功能尤其是即将发布的插件系统的用户则需要提前规划系统升级。该决策同时解释了为何本版本的开发者变更清单中出现了大量与插件系统相关的配置项与 API——它们正是为 v2.9.0 的正式发布铺路。服务与国际化进展英文论坛上线与繁体中文支持本版本在国际化与云端服务侧有三个值得关注的动向官方英文论坛上线思源官方英文论坛于本版本正式上线用于服务非中文用户交流。官方同时预告后续会在「设置 - 账号」中支持使用英文论坛账号登录并在账号登录支持开放后为非中国大陆地区用户提供云端数据同步与备份服务。变更记录支持繁体中文从本版本起各版本变更记录提供繁体中文版本。这一点在仓库中可以直观验证——v2.8.10 变更记录目录 下同时存在v2.8.10.md英文、v2.8.10_zh_CN.md简体中文与v2.8.10_zh_CHT.md繁体中文三个版本后续各版本目录也沿用这一命名约定。改进集市包繁体中文显示配合繁体中文支持集市Marketplace包在繁体中文环境下的显示效果也得到同步改进。编辑器与排版能力增强本版本对编辑器的日常编辑体验做了多项增强与修复覆盖表格、字号调节、粘贴行为与公式渲染等高频场景支持固定显示表格的表头当表格内容较长、需要在文档内滚动阅读时表头行保持固定可见避免滚到后面忘了列名的尴尬是表格类文档如数据整理、清单对比阅读体验的重要提升。添加编辑器字号快速缩放开关此前的字号缩放需要通过设置面板修改字号本版本引入了开关。前端设置项位于 appearanceTab.ts其中editor.fontSize以 range 控件设置字号新增的editor.fontSizeScrollZoom开关通过editorConfigApi.patch写入配置开启后可配合滚动快速缩放编辑器字号Ctrl/⌘ 滚轮或手势方便演示、投影场景下的即时调整。从 IDE 中粘贴代码不再转义和修复了从 IDE 复制代码粘贴进文档时尖括号被转义为实体的问题保证粘贴即所得代码块内容保持原样。导入 Markdown 时支持$后跟数字解析为公式之前如$100这类以美元符号开头的数字串在导入时不会被识别为数学公式本版本调整了解析规则使$紧跟数字的场景也能按需识别为行级公式更贴合 Markdown 书写习惯。行级公式不再显示wbr修复了行内公式渲染时错误插入wbr软换行标签、导致公式排版出现异常折行的问题。修复在表格中按F5不生效表格单元格内按F5的快捷行为恢复正常。修复Backspace删除 Markdown 转义符异常此前在编辑含转义序列的文本时退格删除可能产生不符合预期的结果本版本修正了该编辑行为。修复在包含的文本上粘贴引用或块超链接解析异常当目标文本片段含双引号时粘贴块引用与块超链接的解析结果不再错乱。改进多块复制 - 重复插入多块复制后执行重复插入的操作流程得到优化重复块的结构与顺序更为稳定。文档管理、大纲与信息组织优化针对长文档管理场景本版本在文档树排序、大纲同步与阅读状态上做了细化文档树、反链、标签和模板按字母排序时忽略大小写此前字母序排列会区分大小写大写排前或小写排前导致B与b打头的条目被人为割裂本版本改为忽略大小写后再按字母排序更符合自然阅读习惯。从源码结构看思源前端在多个列表/菜单排序场景中已采用基于本地化规则、忽略大小写的localeCompare排序例如 workspace.tslocaleCompare(..., {numeric: true})与 assets.ts 中的写法与本版本忽略大小写排序的方向一致。标题创建或删除后更新大纲面板此前在文档中新建或删除标题时大纲面板可能不会即时刷新本版本保证大纲随标题的增删实时同步。修复只读模式下大纲定位不正确文档处于只读模式时从大纲点击定位正文的位置计算恢复正常。修复在新页签中打开间隔重复报错通过在新页签打开操作进入间隔重复闪卡复习界面时不再抛错。修复搜索输入框中无法选中文本搜索框内已输入的文本可以正常通过鼠标/键盘选中复制便于调整检索词。外观、窗口与移动端交互在桌面端与移动端的使用体验上本版本处理了若干窗口管理与触控细节始终显示窗口控制按钮桌面端窗口在特定主题/布局下可能隐藏最小化、最大化、关闭按钮的问题被修复现在这些窗口控制按钮始终可见避免用户找不到关闭入口。更新「最近使用的外观」样式设置中外观面板的最近使用列表样式经过重新设计视觉呈现更清晰。移动端过拽看板时不再拉出侧栏面板在移动端看板Kanban视图上横向拖拽卡片时此前可能误触发从屏幕边缘拉出侧栏面板的手势本版本限制了该手势冲突让看板拖拽操作更跟手。添加集市介绍页集市内新增介绍页用于向用户展示集市包的分类与使用指引帮助用户在 v2.9.0 插件生态爆发前熟悉包管理入口。用户指南中的文档不再支持一键分享到社区出于内容管理考虑移除了指南文档的社区一键分享入口。性能与系统集成优化本版本在性能与底层集成上有多处看不见但影响大的优化修复 Linux 端version GLIBC_x.xx not found部分 Linux 发行版因系统 glibc 版本过旧启动内核时会出现GLIBC_xx not found错误导致无法运行本版本对构建与运行方式进行了兼容性处理降低了该报错的出现概率。自定义 Pandoc 路径后工作空间不再重复初始化内置 Pandoc思源内核在检测到用户已在设置中指定了自定义 Pandoc 可执行文件时不再重复解压/初始化自带的 Pandoc 运行时缩短了启动路径、避免资源浪费。仓库 app/pandoc 目录中维护了各平台的 Pandoc 内置包pandoc-linux-amd64.zip、pandoc-windows-amd64.zip等相关初始化与调用逻辑位于 kernel/model/pandoc.go。优化获取云端快照性能拉取云端历史快照列表的接口与数据结构得到优化大快照量下加载更快。改进插件加载性能为迎接插件系统正式发布插件扫描与加载路径做了性能优化降低插件数量增多时的启动开销。粘贴 PDF 标注引用时移除非法字符从 PDF 标注复制引用粘贴到文档时会自动清理其中的非法字符避免脏数据进入文档与数据库。文档完善订阅过期说明与架构设计章节本版本还包含两处面向阅读者的文档工作用户指南中补充订阅过期后云端存储删除的详细说明向用户明确订阅过期后云端数据被删除的规则与时间线避免数据预期不符带来的损失。思源的内置用户指南存放于 app/guide 目录以.sy文档树组织。在项目自述文件中添加架构设计章节仓库根目录 README.md以及 README.zh-CN.md 等语言版本新增架构设计说明从整体上介绍内核kernel、前端app、数据存储等模块的关系为后续阅读源码与参与开发提供地图。插件系统发布前奏面向开发者的变更全景v2.8.10 的开发者分类是整个变更记录中技术含量最高的部分几乎全部指向 v2.9.0 插件系统的正式发布。理解这些变更等于提前掌握了思源插件开发的骨架。集市包配置项调整minAppVersion、移除i18n、新增backends/frontends集市包插件、主题、模板等的plugin.json/theme.json元数据 schema 在本版本发生三处关键变化新增配置项minAppVersion声明该包可运行所需的最低思源版本。内核在 installed.go 中通过isBelowRequiredAppVersion校验——当包未声明minAppVersion时视为允许安装返回false当声明的版本号大于当前内核版本util.Ver时返回true表示不允许安装。判定使用语义化版本比较semver.Compare(vpkg.MinAppVersion, vutil.Ver)避免简单的字符串比较导致v2.9.0被误判小于v2.8.10这类问题。该校验在 installed.go 与 bazaar.go 等多个安装/升级路径中被调用用于给包标记disallowInstall禁止安装与updateRequiredMinAppVer升级目标要求的最低应用版本等状态。删除配置项i18n包元数据中旧的i18n字段被移除多语言文案统一收敛到displayName、description、readme这类LocaleStrings结构中见 package.go 的注释说明从包元数据结构上完成了多语言能力的规范化。新增配置项backends和frontends用于声明插件支持的运行环境。内核在 plugin.go 的IsIncompatiblePlugin中进行兼容性判断先检查backends是否包含当前后端桌面端为runtime.GOOS如windows/darwin/linux移动端等容器环境下为容器标识见 plugin.go 的GetCurrentBackend再检查frontends是否包含当前前端标识。字段缺失时IsTargetSupported直接视为兼容等价于all见 plugin.go。该机制使得仅支持桌面端或仅支持移动端的插件可以被正确识别并标记为不兼容。同时package.go 中Package结构的 JSON 序列化字段Author、URL、Version、MinAppVersion、DisabledInPublish、Kernels、Backends、Frontends、DisplayName、Description、Readme、Funding、Keywords等反映了集市包描述的全部元数据面开发者编写包描述文件时可直接对照。事件总线click-editortitleicon与open-noneditableblock前端事件总线eventBus新增了两个标准事件插件可借此感知编辑器状态变化click-editortitleicon点击编辑器文档标题图标区域时触发。该事件在前端 openTitleMenu.ts 中作为标题菜单弹出的前置事件被派发type: click-editortitleicon插件监听后可注入自己的标题级操作。open-noneditableblock打开不可编辑块非编辑态内容时触发前端在 toolbar/index.ts 通过item.eventBus.emit(open-noneditableblock, ...)派发。需要说明的是事件名在后续 v3.x 中还经历过字段扩充见 v3.1.11 变更记录 中关于renderElement、blockElement的补充本版本属于该事件的首次引入。两个事件均登记在前端事件类型定义 index.d.ts 中与click-blockicon、click-editorcontent、open-noneditableblock等既有事件并列插件开发者可以像使用内置事件一样通过eventBus.on订阅。插件 API 增强addTab、addDock、Menu与交互修复面向界面扩展的插件 API 在本版本集中打磨addTab增加Tab上下文addTab回调中可获得当前页签上下文便于插件根据激活的文档/页签做差异化渲染同时修复了当页签不激活时不调用addTab.init的问题——此前插件在后台页签中可能无法完成初始化本版本保证页签被创建即使未立即激活时初始化逻辑也会执行。修复若干插件 APIaddDock的缺陷并让addDock支持序号与显示选项插件可以控制停靠栏Dock入口的排列顺序与显隐行为实现更可控的侧栏布局。Menu.addItem支持直接传入 DOM 元素此前菜单项只能接受字符串或预设类型本版本允许插件把任意 DOM 元素作为菜单项内容为富文本菜单项图标 描述、自定义控件等提供了可能。自定义块标菜单移到二级菜单中为给插件菜单腾出主菜单空间原生自定义块标类操作被收纳进二级菜单整体菜单层级更清爽。改进插件系统设置交互设置中插件管理界面的启用/停用、配置入口等交互细节得到完善为 v2.9.0 面向普通用户的插件管理体验做铺垫。小结该版本对三类用户的含义综合来看v2.8.10 的价值可以按受众划分为三层对 Windows 7/8 用户这是可安全停留的最终版本升级 Windows 前请以此为基线备份数据对普通用户享受了表格固定表头、字号快速缩放、忽略大小写排序、更流畅的云端快照与粘贴体验等一批日常高频改进对插件开发者minAppVersion、backends/frontends、eventBus新事件与addTab/addDock/Menu等 API 变更共同勾勒出 v2.9.0 插件系统的正式形态——包配置 schema 更规范、兼容性判定更严谨、界面扩展能力更完整。结合 kernel/bazaar 目录下的包解析、兼容性与安装校验实现开发者可以在 v2.9.0 到来前提前适配插件描述文件与 API 用法为思源笔记的第一批插件生态做好准备。【免费下载链接】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),仅供参考
返回列表