Butterfly 5.6 更新日誌
Jerry
·
2026-07-16
·
via Butterfly
New Features
- 新增 Knocket 聊天功能,新增對應的 pug 模板
knocket.pug,在聊天配置中新增 knocket 選項 - 新增腳本和樣式表緩存機制(
scriptCache / cssCache),避免重複加載相同資源 - 新增
rafThrottle 工具函數,基於 requestAnimationFrame 實現節流 - 新增 HTML 轉義函數(
sanitizeString),防範 XSS 注入
- TOC 滾動改用
IntersectionObserver 取代原本的 throttle + 遍歷方式,大幅減少滾動事件計算量 - 滾動處理從
btf.throttle 改為 btf.rafThrottle,與瀏覽器渲染幀率同步 resize 事件處理加入 rafThrottle 節流scrollToDest 平滑滾動改用 easeOutQuart 緩動曲線,取代原本的線性插值rightsideScrollPercent 的 goUpElement / scrollPercentElement 改為閉包緩存,避免每次滾動都查詢 DOMoverflowPaddingR 的 page-header / menus 元素改為閉包緩存- 漢堡選單切換時
document.getElementById 查詢結果緩存到 sidebarFn adjustMenu 的 classList.toggle 包裹在 requestAnimationFrame 中forPostFn 改為接收 $article 參數,內部所有函數(addHighlightTool、addPhotoFigcaption、runLightbox、scrollFnToDo、addTableWrap、clickFnOfTagHide、tabsFn)統一使用傳入的 $article 查詢,避免重複 document.getElementById('article-container')tabsFn 改為事件委託,將點擊監聽綁在 $article 上而非每個 .tabs 元素clickFnOfTagHide 改為事件委託,綁在 $article 上而非逐個 .hide-button 綁定getActualHeight 改用 cloneNode(true) + 隱藏插入測量,取代原本遍歷父節點修改 style 的方式- 簡繁轉換的查找從
indexOf 改為 Map.has / Map.get,O(1) 查找 - 簡繁字對映改為延遲初始化(
getMaps),避免不必要的計算 tw_cn.js 的 translateButtonObject 改為 let,支持 pjax 後重新查詢- Mermaid 手勢系統重構:用
AbortController 管理事件監聽生命週期,避免重複綁定;wheel 事件加入 stopPropagation 防止穿透滾動;getBoundingClientRect 加入 dirty flag 緩存;DOM 更新改為 requestAnimationFrame 批次處理;deltaMode 正規化處理跨瀏覽器差異 - Mermaid 圖片預覽 URL 的
revokeObjectURL 超時從 30 秒縮短為 5 秒 - MathJax 改用
ui/lazy 模組實現延遲渲染,移除原本的 renderActions.findScript hack - MathJax 重新渲染改用
typesetClear + typesetPromise,取代 texReset random_cover.js 的 resolvePostAsset 提取為獨立函數,減少重複邏輯page.js 的 getVersion 改為直接引用模組頂部 require 的 themeVersion,避免每次呼叫都重複讀取 package.jsoninject_head_js.js 的 darkmode 判斷邏輯修復了 start > end(跨午夜)的時段判斷錯誤
Bug Fixes
- 修復 pjax 下簡繁轉換按鈕文字不會更新的問題(
translateButtonObject 改為 let 並在 translateInitialization 中重新查詢) - 修復 pjax 完成時
script[data-pjax] 替換失敗的問題(加入 item.parentNode 存在性檢查) - 修復 pjax 錯誤處理中
responseURL 可能為 undefined 的問題,加入空值檢查 - 修復
handleThemeChange 中 themeChange 可能不是物件的問題(加入 typeof fn !== 'function' 檢查) - 修復
scrollFn 中 checkDocumentHeight() 在初始化時過早 return 導致滾動事件未綁定的問題 - 修復 Mermaid 在 Chrome 上滾動時圖表亂跳的問題(
svg.style.touchAction = 'none' + wheel 事件 preventDefault + stopPropagation) - 修復 Mermaid 手勢在 themeChange/pjax 後重複綁定的問題(AbortController 清理 +
__mermaidGestureBound 移除改用 __mermaidAbortController) - 修復 Mermaid 配置解析失敗時無錯誤回報的問題(加入 try/catch)
- 修復
gallery.js 的 IMAGE_REGEX 在多次呼叫時 lastIndex 未重置的 bug - 修復
flink.js 和 button.js 缺少 HTML escape 導致的 XSS 風險 - 修復
hide.js 的 parseArgs 缺少 trim 導致參數帶有前導空格 - 修復
series.js 模組級可變狀態 groups 在多次 build 時累積過期資料(加入 before_generate 清理) - 修復
score.js 重複實現 escapeHTML,改用 hexo-util 的 escapeHTML + 額外處理 {} - 修復
getArchiveLength.js 中 monthly 模式下 year 計數未累加的問題(year 計數改為始終執行) - 修復
getArchiveLength.js 中 key 選取邏輯,daily 模式下也能正確取得月份計數 - 修復
related_post.js 中 postDesc 被提前計算的問題,改為在渲染時才取值 - 修復
page.js 中 shuoshuoFN 時區轉換的變數作用域問題 - 修復
page.js 中 cloudTags 多餘的 colorClass 變數和 class - 修復
page.js 中 findArchivesTitle 遞迴時 m[key] 可能不是字串的問題 - 修復
main.js 的 fetchUrl 在 HTTP 失敗時靜默返回空數組的問題,改為 throw 錯誤 - 修復
main.js 的 runJustifiedGallery 在 limit / firstLimit 為非法值時的邊界處理 - 修復
main.js 的 addJustifiedGallery 在 data 非陣列時的錯誤處理 - 修復
main.js 的 sanitizeString 從只替換 " 改為替換 &、"、'、<、> 五種字符 - 修復
main.js 的 forPostFn 在 hbe-container 存在時跳過初始化 - 修復
main.js 的 gallery 空數據時顯示載入動畫的問題
Changed
- Mermaid 手勢縮放從固定倍率(1.1/0.9)改為連續倍率(
Math.pow(1.001, delta)),操作更平滑 - Mermaid 手勢的 viewBox 範圍限制從每次計算改為預計算
minW/maxW/minH/maxH - Mermaid
openSvgInNewTab 移除了不再需要的 typeof svg === 'string' 分支 - MathJax 的
lazyMargin 設為 200px adjustMenu 的 hideMenuIndex 改為先宣告再賦值scrollFn 的 isChatBtn 改為 typeof window.chatBtn !== 'undefined'scrollFn 的 innerHeight 改為每次滾動時動態計算 window.innerHeight + 56

Jerry
A Simple and Card UI Design theme for Hexo
主題 GitHub
此内容由惯性聚合(RSS阅读器)自动聚合整理,仅供阅读参考。 原文来自 — 版权归原作者所有。