SiYuan v3.6.4 版本升級(jí)解析粘貼與排版細(xì)節(jié)改進(jìn)、缺陷修復(fù)及任務(wù)列表新內(nèi)核 API【免費(fèi)下載鏈接】siyuanAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 開源、隱私優(yōu)先、自托管的知識(shí)工作空間讓人與智能體在此協(xié)作項(xiàng)目地址: https://gitcode.com/GitHub_Trending/si/siyuan本文基于 SiYuan 官方變更記錄 v3.6.4 中文文檔完整梳理該版本的 15 項(xiàng)功能改進(jìn)、5 項(xiàng)缺陷修復(fù)與 5 項(xiàng)開發(fā)者向變更并結(jié)合內(nèi)核源碼Go與前端源碼TypeScript逐一印證新增 API/api/file/workspaceCopyFiles、/api/block/updateTaskListItemMarker、/api/block/batchUpdateTaskListItemMarker、插件 APIgetAllTabs的type參數(shù)以及任務(wù)列表data-task狀態(tài)屬性的真實(shí)實(shí)現(xiàn)幫助插件開發(fā)者與運(yùn)維用戶理解 v3.6.4 的能力邊界與升級(jí)要點(diǎn)。版本概述根據(jù) v3.6.4 變更記錄此版本定位是「改進(jìn)了一些細(xì)節(jié)」變更集中在三類編輯器細(xì)節(jié)粘貼行為、塊標(biāo)block marker渲染與位置、行級(jí)代碼粘貼、優(yōu)化排版對(duì)全角字符的處理界面與布局按鈕陰影、分屏布局、?？繖诿姘鍢?biāo)題、閃卡管理窗口分頁(yè)按鈕位置、云端配置界面加載圖標(biāo)、集市列表卡片數(shù)據(jù)與集成塊引用導(dǎo)出、反向鏈接面板粘貼行為、已下載集市包的 README 離線化、macOS 默認(rèn)工作空間數(shù)據(jù)丟失修復(fù)、若干安全漏洞修復(fù)以及面向插件開發(fā)者的新內(nèi)核 API 與屬性約束。改進(jìn)功能詳解編輯器粘貼與渲染文檔塊菜單新增「復(fù)制全文」選項(xiàng)在文檔塊菜單中可以直接復(fù)制整篇文檔內(nèi)容無需手動(dòng)全選。改進(jìn)粘貼鏈接優(yōu)化粘貼鏈接的解析與轉(zhuǎn)換行為使粘貼過來的鏈接內(nèi)容更符合預(yù)期。改進(jìn)包含反引號(hào)和與號(hào)的行級(jí)代碼粘貼針對(duì)行內(nèi)代碼inline code中含有反引號(hào)或與號(hào)時(shí)粘貼錯(cuò)亂的場(chǎng)景做了修正。改進(jìn)當(dāng)列表項(xiàng)包含塊引用或提示塊時(shí)的塊標(biāo)渲染復(fù)雜嵌套塊列表項(xiàng)內(nèi)含 callout/提示塊出現(xiàn)時(shí)塊標(biāo)的顯示不再異常。優(yōu)化排版忽略全角字符排版優(yōu)化邏輯不再把全角字符納入處理范圍避免中文排版場(chǎng)景下被誤改。改進(jìn)塊標(biāo)的顯示位置塊標(biāo)hover 時(shí)顯示的塊操作標(biāo)記的定位更合理。界面與布局反向鏈接面板中的列表在粘貼后不再自動(dòng)折疊粘貼操作不會(huì)再觸發(fā)反向鏈接面板里列表的意外折疊。改進(jìn)按鈕陰影效果按鈕的陰影樣式統(tǒng)一優(yōu)化。改進(jìn)分屏布局分屏split view的布局行為改進(jìn)。支持顯示完整的停靠欄面板標(biāo)題和操作按鈕?？繖诿姘遄冋驑?biāo)題過長(zhǎng)時(shí)也能完整展示面板標(biāo)題與操作按鈕。加載圖標(biāo)不再覆蓋整個(gè)云端配置界面云端配置界面加載態(tài)的 loading 圖標(biāo)尺寸收斂不再鋪滿整個(gè)界面。將閃卡管理窗口中的分頁(yè)和導(dǎo)航按鈕移動(dòng)到左上角閃卡flashcard管理窗口的分頁(yè)與導(dǎo)航按鈕調(diào)整到左上角操作位置更順手。集市與導(dǎo)出改進(jìn)集市列表卡片集市插件/主題市場(chǎng)的列表卡片樣式改進(jìn)。改進(jìn)塊引用導(dǎo)出塊引用block reference導(dǎo)出結(jié)果的準(zhǔn)確性改進(jìn)。已下載的集市包不再回退獲取在線 README集市包本地下載后README 直接讀取本地內(nèi)容不再回退到在線獲取——這也意味著離線環(huán)境下集市包的說明文檔可正常展示減少了對(duì)網(wǎng)絡(luò)的依賴。修復(fù)的缺陷macOS 上默認(rèn)工作空間數(shù)據(jù)會(huì)丟失修復(fù) macOS 平臺(tái)默認(rèn)工作空間數(shù)據(jù)丟失問題屬數(shù)據(jù)安全性修復(fù)macOS 用戶應(yīng)優(yōu)先升級(jí)到包含此修復(fù)的版本。將塊拖動(dòng)到反向鏈接面板時(shí)會(huì)導(dǎo)致報(bào)錯(cuò)拖拽塊到反向鏈接面板的報(bào)錯(cuò)已修復(fù)。修復(fù)一些安全漏洞批量安全修復(fù)建議所有部署尤其是開啟局域網(wǎng)訪問的自托管實(shí)例跟進(jìn)升級(jí)。Android 上導(dǎo)入 Markdown.zip 出錯(cuò)移動(dòng)端導(dǎo)入 Markdown.zip 歸檔的錯(cuò)誤已修復(fù)。在提示塊內(nèi)部拖動(dòng)塊后整個(gè)塊會(huì)消失提示塊callout內(nèi)部拖動(dòng)塊導(dǎo)致塊整體消失的嚴(yán)重編輯缺陷已修復(fù)。開發(fā)者變更源碼級(jí)解讀本版本對(duì)插件開發(fā)者與 API 集成者價(jià)值最大的部分是 5 項(xiàng)開發(fā)者變更。下面結(jié)合內(nèi)核源碼逐項(xiàng)說明。任務(wù)列表支持data-task狀態(tài)屬性任務(wù)列表項(xiàng)task list item現(xiàn)在有了規(guī)范的「任務(wù)狀態(tài)」表達(dá)方式通過塊 IAL 屬性中的data-task讀取任務(wù)狀態(tài)但修改任務(wù)狀態(tài)被限制為只能通過專用的 marker API 完成。從源碼結(jié)構(gòu)看這一約束實(shí)現(xiàn)在 setNodeAttrs0 中當(dāng)通過通用的塊屬性設(shè)置接口嘗試設(shè)置或移除data-task屬性時(shí)內(nèi)核會(huì)直接拒絕并返回明確指引setting or removing [data-task] attribute is not allowed via this interface. Please use /api/block/updateTaskListItemMarker or /api/block/batchUpdateTaskListItemMarker to update the task list item marker這一設(shè)計(jì)把「任務(wù)勾選」這類會(huì)引發(fā)事務(wù)transaction與多端廣播的寫操作收斂到單一受控入口避免插件繞過事務(wù)機(jī)制直接改屬性造成狀態(tài)不一致。新增內(nèi)核 API/api/block/updateTaskListItemMarker該 API 用于更新單個(gè)任務(wù)列表項(xiàng)的勾選標(biāo)記marker。請(qǐng)求參數(shù)為id塊 ID與marker標(biāo)記字符實(shí)現(xiàn)位于 updateTaskListItemMarker路由注冊(cè)見 router.go需通過認(rèn)證、管理員角色與只讀檢查中間件。從源碼可以看到關(guān)鍵的校驗(yàn)與處理鏈路buildUpdatedTaskListItemBlockDOM 先按id取出塊校驗(yàn)塊類型必須是NodeListItem再加載所在文檔的語(yǔ)法樹Lute AST定位節(jié)點(diǎn)校驗(yàn)li.ListData.Typ 3確認(rèn)為任務(wù)列表項(xiàng)校驗(yàn)marker長(zhǎng)度必須為 1且不能是[或]防止破壞任務(wù)列表語(yǔ)法在 AST 的TaskListItemMarker節(jié)點(diǎn)上寫入新標(biāo)記并以TaskListItemChecked ! marker推導(dǎo)勾選態(tài)隨后渲染出更新后的塊 DOM通過事務(wù)機(jī)制提交構(gòu)造Action: update的Operation經(jīng)model.PerformTransactions與model.FlushTxQueue落庫(kù)并broadcastTransactions廣播到各端含移動(dòng)端保證多端同步與歷史記錄history正確。請(qǐng)求示例{ id: 20260909000000-abcdefgh, marker: x }新增內(nèi)核 API/api/block/batchUpdateTaskListItemMarker批量版本用于一次更新多個(gè)任務(wù)列表項(xiàng)的標(biāo)記實(shí)現(xiàn)見 batchUpdateTaskListItemMarker。參數(shù)為對(duì)象數(shù)組items每個(gè)元素包含id與marker{ items: [ { id: 20260909000000-abcdefgh, marker: x }, { id: 20260909000001-ijklmnop, marker: } ] }從源碼結(jié)構(gòu)看其實(shí)現(xiàn)有兩個(gè)值得注意的細(xì)節(jié)同一id重復(fù)出現(xiàn)時(shí)「保留最后一個(gè) marker」且按去重后的 id 生成操作列表即重復(fù)提交是冪等收斂的所有操作合并進(jìn)一個(gè)事務(wù)單個(gè)Transaction的DoOperations再統(tǒng)一廣播。相比逐條調(diào)用單條 API批量接口減少事務(wù)次數(shù)適合插件做「一鍵完成全部任務(wù)」這類批量操作。新增內(nèi)核 API/api/file/workspaceCopyFiles該 API 提供工作空間內(nèi)的文件批量復(fù)制能力實(shí)現(xiàn)位于 workspaceCopyFiles。請(qǐng)求參數(shù)srcs字符串?dāng)?shù)組源文件路徑相對(duì)于工作空間destDir目標(biāo)目錄相對(duì)于工作空間不存在時(shí)會(huì)自動(dòng)創(chuàng)建。{ srcs: [data/box1/20260909000000-abcdefgh/20260909000000-abcdefgh.md], destDir: data/backup/20260909 }從源碼看該接口在安全邊界上做了多層防護(hù)這也呼應(yīng)了本版本「修復(fù)一些安全漏洞」的整體基調(diào)每個(gè)源路徑都經(jīng)util.GetAbsPathInWorkspace解析并限定在工作空間內(nèi)越界路徑直接返回 403util.IsSensitivePath判定為敏感路徑的文件拒絕復(fù)制返回code: -2rejectEncryptedBoxPath拒絕涉及加密筆記本的源路徑與目標(biāo)目錄返回code: -3避免在加密筆記本內(nèi)創(chuàng)建明文目錄或繞過加密邊界目標(biāo)若為已存在的 symlink 則拒絕os.Create會(huì)跟隨符號(hào)鏈接可能寫入加密筆記本內(nèi)部目標(biāo)目錄不存在時(shí)以0755權(quán)限MkdirAll創(chuàng)建且創(chuàng)建前先做加密筆記本目錄攔截復(fù)制完成調(diào)用model.IncSync()保證文件同步機(jī)制感知到變更。這些防護(hù)意味著該 API 可以安全地用于插件實(shí)現(xiàn)「工作空間內(nèi)備份/歸檔」類功能而無法被用作越權(quán)文件操作通道。插件 APIgetAllTabs新增type參數(shù)前端布局工具 getAllTabs 新增可選參數(shù)type用于按面板類型篩選標(biāo)簽頁(yè)該函數(shù)已導(dǎo)出給插件使用見 API.ts。從源碼實(shí)現(xiàn)看type支持的值包括Search、Asset、Editor、Graph、Backlink、Outline以及自定義面板的customModelType。篩選邏輯是雙通道匹配已實(shí)例化的 tab 直接比較其model實(shí)例類型model instanceof Search等尚未完全初始化的 tab 回退解析頭部元素的data-initdata屬性按instance/customModelType字段匹配。插件使用示例// 僅獲取所有編輯器標(biāo)簽頁(yè) const tabs getAllTabs(Editor); // 獲取某個(gè)自定義類型的面板 const customTabs getAllTabs(myPanelType);此前插件只能拿到全量標(biāo)簽再自行過濾現(xiàn)在可以在布局層面直接按類型取回簡(jiǎn)化了「聚焦當(dāng)前文檔編輯器」「定位搜索面板」等常見插件邏輯。注意該實(shí)現(xiàn)標(biāo)注了#if !MOBILE桌面端與移動(dòng)端行為存在條件編譯差異移動(dòng)端相關(guān)邏輯不可用。升級(jí)建議與適用前提macOS 用戶本版本修復(fù)了默認(rèn)工作空間數(shù)據(jù)丟失問題建議盡快升級(jí)開啟 API 自托管訪問的用戶本版本包含安全漏洞修復(fù)且新增的workspaceCopyFiles等 API 均疊加了認(rèn)證、管理員角色與只讀檢查見 路由注冊(cè)但生產(chǎn)環(huán)境仍建議保持最小化端口暴露插件開發(fā)者data-task的寫約束意味著此前若有插件通過通用屬性接口寫任務(wù)狀態(tài)的邏輯需要遷移到updateTaskListItemMarker/batchUpdateTaskListItemMarkergetAllTabs的type參數(shù)則為布局類插件提供了更精確的篩選能力。該變更記錄基于當(dāng)前倉(cāng)庫(kù)中 v3.6.4 的三個(gè)語(yǔ)言版本文檔en、zh-CN、zh-TWAPI 行為以源碼kernel/api/目錄當(dāng)前實(shí)現(xiàn)為準(zhǔn)由于倉(cāng)庫(kù)為后續(xù)版本的源碼個(gè)別實(shí)現(xiàn)細(xì)節(jié)可能在更新版本中繼續(xù)演進(jìn)。【免費(fèi)下載鏈接】siyuanAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 開源、隱私優(yōu)先、自托管的知識(shí)工作空間讓人與智能體在此協(xié)作項(xiàng)目地址: https://gitcode.com/GitHub_Trending/si/siyuan創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考