思源筆記 v2.8.10 完整解讀Windows 7 最終支援版、固定表格表頭與插件系統發布前的 API 演進【免费下载链接】siyuanAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间让人与智能体在此协作项目地址: https://gitcode.com/GitHub_Trending/si/siyuan思源筆記SiYuanv2.8.10 是一版具有里程碑意義的發布它是官方聲明最後一個支援 Windows 7、Windows 8 與 Server 2012 的版本同時也是「插件系統正式發布」前最後一次對插件配置與 API 的大規模打磨。本篇文章以 v2.8.10 官方變更記錄為主線逐項解讀本次新增的功能改進、缺陷修復與開發者 API 變更並結合當前倉庫app、kernel中的真實源碼與配置文件說明這些變更在代碼層面的落地方式幫助使用者在升級前了解版本邊界也幫助插件開發者理解 bazaar 集市包配置與事件系統的演進脈絡。適用場景與閱讀收益正準備從舊版升級的思源桌面端使用者、希望遷移/適配 v2.9.0 插件系統的開發者、以及維護舊版環境Windows 7/8的部署人員可從本文明確版本支援邊界、核對缺陷修復清單並掌握minAppVersion、backends、frontends等集市包配置項的來源與含義。版本定位桌面端支援邊界的轉折點v2.8.10 在變更記錄「概述」中明確宣告這是最後一個支持 Windows 7、8 和 Server 2012 的版本升級到 Windows 10 或更高版本後才能使用後續版本的思源筆記。換言之v2.8.10 是舊版 Windows 使用者所能安裝的最後一個思源桌面版本。從 v2.9.0 起思源將依賴更高版本的系統能力因此仍在 Windows 7/8/Server 2012 上運行的環境應將此版本視為凍結版本並提前規劃數據遷移路徑工作空間目錄整體備份即可跨版本遷移參見 WORKSPACE.md 對工作空間結構的說明。與此同時該版本還承載了兩條「前瞻性」信息英文論壇 LiuYun 上線官方英文論壇正式開放後續計畫在思源「設置 - 賬號」中支持通過英文論壇賬號登錄並在此之後開放非中國大陸地區的雲端數據同步與備份服務。插件系統即將正式發布v2.8.10 是插件系統正式發布前的最後一版官方計畫於v2.9.0正式發布插件系統並歡迎開發者基於該系統實現實用性與趣味性兼顧的插件。正因如此本版本的「開發者」變更記錄異常密集——多達 13 項插件 API / 配置項調整本質上是在為 v2.9.0 的正式發布做最後的兼容性收斂。這些變更在當前倉庫源碼中仍有完整對應是理解插件系統設計思路的最佳教材。表格表頭固定顯示custom-pinthead的落地實現本次版本新增「支持固定顯示表格的表頭」issue 8294。這一功能在當前倉庫源碼中保留了完整實現鏈路菜單開關位於 app/src/menus/protyle.ts在表格上下文菜單中提供「固定表頭 / 取消固定表頭」選項通過設置或移除custom-pinthead屬性實現切換id分別為pinTableHead與unpinTableHead表格渲染與結構處理位於 app/src/protyle/util/table.ts其中判斷custom-pinthead true以調整表格結構樣式層面由 app/src/assets/scss/protyle/_wysiwyg.scss 承載當.table[custom-pintheadtrue]生效時thead採用position: sticky實現滾動時表頭吸附在可視區頂部的效果搜索結果頁也同步感知該屬性app/src/search/util.ts確保搜索預覽中表頭固定行為一致。由此可見該功能並非一次性補丁而是貫穿「菜單切換 → 屬性標記 → 表格渲染 → 全局樣式」的完整特性後續在文檔樹、搜索結果等場景中均能復用同一套標記語義。編輯器體驗改進字號快速縮放開關新增「編輯器字號快速縮放」開關issue 8297使用者可在設置中啟用/停用編輯器字號的快捷縮放能力。字號相關設置的集中管理可在 app/src/config 下的設置頁簽中找到對應配置組屬於編輯體驗層的通用開關方便在不同顯示環境下快速調整閱讀舒適度。從 IDE 粘貼代碼不再轉義與修復了從 IDE 粘貼代碼時、被額外轉義的問題issue 8340使得包含泛型、模板字面量等符號的代碼塊粘貼後可保持原樣減少二次修正成本。其他編輯器與界面改進標題創建或刪除後實時更新大綱面板issue 8372避免大綱與文檔內容不一致改善多塊「複製 - 重複」插入行為issue 8394多選塊重複插入的結果更穩定改善「最近使用的外觀」樣式issue 8392自定義塊標菜單移至二級菜單中issue 8419收斂一級菜單項屬於插件 API 影響下的 UI 結構調整粘貼 PDF 標註引用時移除非法字符issue 8403移動端橫拖看板時不再誤拉出側欄面板issue 8402Linux 端針對version GLIBC_x.xx not found錯誤issue 8334進行了適配處理以兼容部分較舊 glibc 的發行版始終顯示窗口控制按鈕issue 8344避免在某些窗口模式下控制按鈕被隱藏優化獲取雲端快照的性能issue 8387。文檔樹、反鏈與搜索排序規則「文檔樹、反鏈、標籤和模板按字母排序時忽略大小寫」issue 8360——排序規則從區分大小寫調整為不區分大小寫使a與A開頭的條目按自然閱讀順序排列符合多數使用者的預期也避免了大小寫混合時排序跳變造成的檢索困難。導入 Markdown 的公式解析擴展「導入 Markdown 時支持$後跟數字解析為公式」issue 8362此前形如$5之類「美元符號緊跟數字」的文本可能在導入時被誤判為貨幣符號或普通文本本次調整後這類內容會按行級/塊級公式規則嘗試解析減少從 Markdown 遷移文檔時公式丟失的情況。涉及 Markdown 語法解析的底層處理位於 kernel 的 kernel/util/lute.go 及其依賴的 Lute 引擎。Pandoc 自定義路徑優化「自定義 Pandoc 路徑後工作空間不再重複初始化內置 Pandoc」issue 8377。思源默認隨安裝包分發內置 Pandoc見 app/pandoc 下各平台的 zip 包用於文檔導出。若使用者自行指定了自定義 Pandoc 二進位路徑舊版可能仍會重複初始化內置 Pandoc造成冗餘資源佔用本次修復後一旦配置了自定義路徑即跳過內置初始化。該配置在當前源碼中位於導出設置頁簽 app/src/config/tabs/exportTab.ts配置鍵為export.pandocBin設置界面提供路徑選擇pandocBinChooser、重置pandocBinReset與當前路徑顯示pandocBinPathDisplay將配置項置空即可恢復使用內置 Pandoc。搜索與引用粘貼的細節修復搜索輸入框無法選中文本issue 8331修復了搜索框中文本無法被正常框選複製的問題新頁簽打開間隔重複報錯issue 8337修復間隔重複在新頁簽打開時的異常只讀模式下大綱定位不正確issue 8356修復只讀視圖中從大綱跳轉的錨點偏差在包含的文本上粘貼引用或塊超鏈接解析異常issue 8359當被粘貼文本含雙引號時引用/塊超鏈接的解析結果不再錯亂在表格中按F5不生效issue 8367修復表格環境內刷新/重算快捷鍵失靈行級公式顯示wbrissue 8378移除行級公式渲染結果中多餘的換行機會點Backspace刪除 Markdown 轉義符異常issue 8406修復退格刪除轉義字符時的行為異常。集市Bazaar體驗與配置演進v2.8.10 對集市進行了多項改進這些改動直接服務於即將到來的插件系統集市介紹頁issue 8324集市不再只是簡單的列表而是具備介紹性質的入口頁便於使用者了解集市包的用途與安裝方式集市包繁體中文顯示issue 8342完善集市包的繁體中文zh_CHT文案顯示變更記錄支持繁體中文issue 8333變更記錄開始提供繁體中文版本——本文所對應的 v2.8.10_zh_CHT.md 即為該能力的直接產物與簡體版本v2.8.10_zh_CN.md並行維護用戶指南不再支持一鍵分享到社區issue 8388收斂分享範圍用戶指南文檔僅保留本地閱讀用途。文檔層面的完善本版本同步補齊了兩處重要文檔在用戶指南中新增「訂閱過期後刪除雲端存儲」的詳細說明issue 8370讓使用者明確訂閱過期後雲端數據的處理策略與刪除機制在自述文件中新增架構設計章節issue 8416——該架構說明在當前倉庫的自述文檔體系中仍可查閱例如 README.md 及其多語言版本README.zh-CN.md、README.ja.md、README.tr.md系統性地描述了思源「前後端分離、數據本地優先」的總體設計。開發者視角插件系統發布前的 API 收斂v2.8.10 的「開發者」變更記錄是本次發布的重頭戲共 13 項全部指向插件系統的正式化。逐條解讀如下集市包配置項調整重要影響插件作者新增minAppVersionissue 8330集市包可聲明所需的最低思源應用版本低於該版本的客戶端會提示版本不足而禁止安裝/升級。該字段在 kernel 側的Package結構體中有明確定義見 kernel/bazaar/package.go 中的MinAppVersion string字段前端集市列表app/src/config/bazaar.ts則將其用於安裝按鈕的禁用提示文案bazaarNeedVersion替換${x}顯示所需版本。此外 kernel/bazaar/installed.go 也用於已安裝包與當前版本的兼容性校驗。這意味著插件作者必須維護該字段避免老版本思源載入依賴新 API 的插件。刪除i18n配置項issue 8346集市包的i18n字段被移除展示文案改由displayName、description、readme等多語種字段統一承載。從 kernel/bazaar/package.go 可見當前Package結構中的DisplayName、Description、Readme均為LocaleStrings按語種 key 的映射表配合GetPreferredLocaleString按當前語言回退取值default→en→en_US兼容歷史命名插件作者應遷移到這一套語種機制。新增backends與frontendsissue 8386插件可聲明自己運行於哪些後端/前端環境用於標識插件在不同端桌面端、移動端、內核等的可用性。同樣可在 kernel/bazaar/package.go 的Backends []string、Frontends []string字段中確認。配合Kernels字段聲明所需內核構成了集市包完整的「運行環境能力描述」。插件 API 方法改進addTab增加Tab上下文PR 8336addTab回調現在可拿到完整的Tab上下文對象便於插件在初始化時獲取當前頁籤狀態並執行差異化渲染修復addDock的部分缺陷issue 8341並支持序號position與顯示選項issue 8347dock 面板的註冊行為更可控插件可指定停靠位置與是否默認顯示修復頁籤不激活時調用addTab.init的異常issue 8350此前僅在頁籤激活時才執行init被動態切換的頁籤可能永遠得不到初始化本次修正了初始化時機判斷Menu.addItem支持傳入 DOM 元素issue 8343插件構建自定義菜單時不再僅限於文本項可直接注入自定義 DOM使插件菜單可以容納圖標、表單控件等複雜內容。事件系統擴充新增click-editortitleicon事件issue 8335點擊編輯器標題圖標時觸發插件可借此攔截/增強標題欄操作。事件對應的類型聲明可在 app/src/types/index.d.ts 中檢索其在標題菜單 app/src/protyle/header/openTitleMenu.ts 等模塊中協同工作。eventBus新增open-noneditableblock事件issue 8374當使用者試圖打開不可編輯塊時派發該事件。從 app/src/protyle/toolbar/index.ts 的源碼可見其通過item.eventBus.emit(open-noneditableblock, ...)方式觸發插件可監聽該事件實現「只讀塊的閱讀/導航增強」等擴展。改善插件系統設置交互issue 8391插件管理界面交互細節優化為 v2.9.0 的正式發布鋪平了使用體驗。升級與兼容性建議綜合本版本信息可總結出以下三條針對性建議Windows 7/8 / Server 2012 使用者v2.8.10 是支援邊界版本如無升級系統的計畫請保持在此版本並定期備份工作空間如計畫跟進新版本建議先完成系統升級再做思源升級。插件/集市包作者minAppVersion已是必備配置項i18n已刪除改用多語種字段backends/frontends與addDock/addTab/Menu.addItem的行為在此版本定型——以本版本或更新的 v2.9.0作為開發基準可避免兼容性返工。一般使用者本次缺陷修復覆蓋搜索框選中、表格F5、只讀大綱定位、轉義字符刪除等高頻交互場景建議在升級後重點回歸這些路徑並可結合 app/changelogs/v2.8.4-v2.12.8 下各版本變更記錄追蹤後續演進。思源 v2.8.10 作為舊系統支援的收尾版與插件時代的開篇版其代碼痕跡固定表頭的custom-pinthead屬性鏈路、集市包Package結構的配置演進、事件系統的emit位置至今仍完整保留在倉庫中無論是升級評估、歷史回溯還是插件開發都具有實際的參考價值。【免费下载链接】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），仅供参考