hexo-theme-stellar 1.37.0 → 1.38.0

package/CHANGELOG.md

@@ -1,5 +1,46 @@
 # Changelog
 
+## 1.38.0
+
+> 发布日期：2026-08-11
+
+### 新功能
+- 新增连续曲率圆角配置 `style.corner-shape`（默认 `superellipse(1.2)`）：所有带圆角的位置统一使用曲率连续的 squircle 曲线，自动适配容器宽高；文章卡片与横幅的渐变模糊改为「同图模糊层」实现以兼容连续曲率（仅 Chromium 139+ 原生支持，其余浏览器自动回退普通圆角，可设 `round` 关闭）
+- 左栏导航列表化，wiki 内页增加返回按钮与搜索条交互优化
+- 菜单栏激活/悬停图标与圆点支持可配置角度的主题色渐变（`style.gradient.angle`）
+- 首页支持可配置评论区（默认关闭，`site_tree.home.comments`）
+- 新增 mbti 标签
+
+### 修复
+- 补全 npm-publish workflow 的 GH_TOKEN，修复 GitHub Release 创建失败
+- GitHub Release 正文不再包含 CHANGELOG 发布日期行
+- 克隆站提示源站从 encoded 反解，防止批量替换域名误导
+- 侧栏内部滚动容器组件 scrollreveal 不显示
+- 仅当页面包含 toc 或评论时显示 toc 操作按钮
+- wiki 封面「开始使用」按钮平滑滚动，#start 锚点贴顶定位
+
+### 重构
+- 移除官方备用站提示的关闭按钮与配置项
+
+### 优化
+- 动态数据组件缓存优化：同 URL 请求去重、memos 用户详情缓存、stale 兜底
+
+### 样式
+- 侧栏光照效果覆盖相关卡片、返回胶囊与 widget 操作按钮
+- 侧栏导航区边距调整
+- 左栏激活书签等彩色图标使用主题色渐变
+- 侧栏高亮项顶部叠加白色光照渐变与高光边
+- 左侧栏底部留白调整为 32px
+- 作者页与错误页侧栏不再显示时间线
+- 移动端顶部导航吸顶距离调整为 8px
+
+### 升级注意（配置变更与破坏性改动）
+- 新增 `style.corner-shape`（默认 `superellipse(1.2)`）：连续曲率圆角仅 Chromium 139+ 生效，其余浏览器自动回退普通圆角；设置 `round` 可关闭
+- 新增 `style.gradient.angle` 与 `site_tree.home.comments` 配置
+- 移除 `canonical.closeEnable`、`canonical.closeText` 配置项：官方备用站提示不再支持手动关闭
+
+Full Changelog: [1.37.0...1.38.0](https://github.com/xaoxuu/hexo-theme-stellar/compare/1.37.0...1.38.0)
+
 ## 1.37.0
 
 > 发布日期：2026-08-09

package/_config.yml

@@ -1,6 +1,6 @@
 ######## Stellar info ########
 stellar:
-  version: '1.37.0'
+  version: '1.38.0'
   homepage: 'https://xaoxuu.com/wiki/stellar/'
   repo: 'https://github.com/xaoxuu/hexo-theme-stellar'
   main_css: /css/main.css
@@ -17,8 +17,6 @@ preconnect:
 # 一旦设置源站地址，非源站地址将不会被SEO收录，并且访问时弹出提示
 # 如果访问地址不在备用站主机列表，则警告信息为非法克隆
 canonical:
-  closeEnable: true # 是否显示关闭提示按钮
-  closeText: 关闭提示 # 关闭提示按钮的文字描述
   originalHost: # 主站点域名主机，例如 xaoxuu.com
   officialHosts: # 官方主机列表，每行一个，例如 xaoxuu.vercel.app
     - localhost
@@ -40,7 +38,6 @@ logo:
 
 # 侧边栏主功能导航菜单
 menubar:
-  columns: 4 # 一行多少个
   items: # 可按照自己需求增加，符合以下格式即可
     # id: 页面中高亮的 menu_id 
     # theme: 高亮时的颜色，仅 svg 中 fill="currentColor" 时有效
@@ -77,6 +74,10 @@ site_tree:
   home:
     leftbar: welcome, recent
     rightbar: 
+    # 首页评论区，默认不显示。可设为 true 使用全局评论服务，
+    # 或参考页面 front-matter 覆盖评论参数：
+    # service、comment_title、comment_id 及 beaudar/utterances/giscus/twikoo/waline/artalk 各服务参数。
+    comments:
   # 博客列表页配置
   index_blog:
     base_dir: blog # 只影响自动生成的页面路径
@@ -138,14 +139,14 @@ site_tree:
   author: 
     base_dir: author # 只影响自动生成的页面路径
     menu_id: post
-    leftbar: recent, timeline
-    rightbar: timeline
+    leftbar: recent
+    rightbar: 
   # 错误页配置
   error_page:
     menu_id: post
     '404': '/404.html'
-    leftbar: recent, timeline
-    rightbar: timeline
+    leftbar: recent
+    rightbar: 
   # 其它自定义页面配置 layout: page
   page:
     leftbar: recent
@@ -530,6 +531,7 @@ data_cache:
     waline: 600
     artalk: 600
     memos: 600
+    memos-user: 86400
     sites: 86400
     friends: 86400
     friends_and_posts: 86400
@@ -672,6 +674,7 @@ style:
     image-l: 24px # 非技术类文章插图圆角
     image: 16px # 技术类文章插图圆角
     image-s: 8px # 评论区图片圆角（部分评论支持）
+  corner-shape: superellipse(1.5) # 连续曲率圆角（仅 Chromium 139+ 支持，其余浏览器自动回退普通圆角）：superellipse(1.x) 开启，round 关闭
   color:
     # 主题色配置（不会根据明暗动态调整，请设置为通用的颜色）
     theme: 'hsl(192 98% 55%)' # 主题色
@@ -688,6 +691,8 @@ style:
     error: 加载失败，请稍后重试。
   gradient: # https://webgradients.com/
     start: 'linear-gradient(to right, hsl(215, 95%, 64%), hsl(195, 95%, 60%), hsl(165, 95%, 56%), hsl(165, 95%, 56%), hsl(195 95% 60%), hsl(215, 95%, 64%))'
+    searchbar: 'linear-gradient(to right, #04f3ff, #08ffc6, #ddf730, #ffbd19, #ff1fe0, #c418ff, #3b5bff, #04f3ff)' # 搜索条激活时底部横条的渐变色（彩虹，收尾经蓝色平滑过渡）
+    angle: 210deg # 主题色渐变的角度（0=向上，顺时针；225deg = 右上角 → 左下角）
   leftbar:
     # 可以设置：纯色/渐变色/图片作为背景
     # 设置为纯色时，可以分别设置浅色和深色模式背景色

package/languages/en.yml

@@ -68,3 +68,40 @@ symbol:
   colon: ": "
   brackets_l: "("
   brackets_r: ")"
+
+tag_plugins:
+  mbti:
+    title: 'My MBTI Type: %s (%s)'
+    types:
+      INTJ: Architect
+      INTP: Logician
+      ENTJ: Commander
+      ENTP: Debater
+      INFJ: Advocate
+      INFP: Mediator
+      ENFJ: Protagonist
+      ENFP: Campaigner
+      ISTJ: Logistician
+      ISFJ: Defender
+      ESTJ: Executive
+      ESFJ: Consul
+      ISTP: Virtuoso
+      ISFP: Adventurer
+      ESTP: Entrepreneur
+      ESFP: Entertainer
+    traits:
+      energy:
+        left: Extraverted
+        right: Introverted
+      mind:
+        left: Intuitive
+        right: Observant
+      nature:
+        left: Thinking
+        right: Feeling
+      tactics:
+        left: Judging
+        right: Prospecting
+      identity:
+        left: Assertive
+        right: Turbulent

package/languages/zh-CN.yml

@@ -68,3 +68,40 @@ symbol:
   colon: "："
   brackets_l: "（"
   brackets_r: "）"
+
+tag_plugins:
+  mbti:
+    title: 我的 MBTI 人格：%s（%s）
+    types:
+      INTJ: 架构师
+      INTP: 逻辑学家
+      ENTJ: 指挥官
+      ENTP: 辩论家
+      INFJ: 提倡者
+      INFP: 调停者
+      ENFJ: 主人公
+      ENFP: 活动家
+      ISTJ: 物流师
+      ISFJ: 守卫者
+      ESTJ: 管理者
+      ESFJ: 执政官
+      ISTP: 鉴赏家
+      ISFP: 冒险家
+      ESTP: 企业家
+      ESFP: 表演者
+    traits:
+      energy:
+        left: 外向
+        right: 内向
+      mind:
+        left: 天马行空
+        right: 求真务实
+      nature:
+        left: 理性思考
+        right: 情感细腻
+      tactics:
+        left: 运筹帷幄
+        right: 随机应变
+      identity:
+        left: 自信果断
+        right: 情绪易波动

package/languages/zh-TW.yml

@@ -68,3 +68,40 @@ symbol:
   colon: "："
   brackets_l: "（"
   brackets_r: "）"
+
+tag_plugins:
+  mbti:
+    title: 我的 MBTI 人格：%s（%s）
+    types:
+      INTJ: 架構師
+      INTP: 邏輯學家
+      ENTJ: 指揮官
+      ENTP: 辯論家
+      INFJ: 提倡者
+      INFP: 調停者
+      ENFJ: 主人公
+      ENFP: 活動家
+      ISTJ: 物流師
+      ISFJ: 守衛者
+      ESTJ: 管理者
+      ESFJ: 執政官
+      ISTP: 鑑賞家
+      ISFP: 冒險家
+      ESTP: 企業家
+      ESFP: 表演者
+    traits:
+      energy:
+        left: 外向
+        right: 內向
+      mind:
+        left: 天馬行空
+        right: 求真務實
+      nature:
+        left: 理性思考
+        right: 情感細膩
+      tactics:
+        left: 運籌帷幄
+        right: 隨機應變
+      identity:
+        left: 自信果斷
+        right: 情緒易波動

package/layout/_partial/comments/layout.ejs

@@ -6,7 +6,7 @@ if (cmt.service) {
   cmt[cmt.service] = Object.assign({}, theme.comments[cmt.service]);
 }
 var loadComment = false;
-if (theme.comments.service && theme.comments.service.length > 0) {
+if (cmt.service && cmt.service.length > 0) {
   if (page.comments == undefined || page.comments != false) {
     loadComment = true;
   }
@@ -34,6 +34,7 @@ if (cmt.service && page[cmt.service]) {
   Object.assign(cmt[cmt.service], page[cmt.service]);
 }
 page.cmt = cmt;
+page.cmt_rendered = loadComment;
 %>
 <% if (loadComment) { %>
   <div class="related-wrap md-text<%- scrollreveal(' ') %>" id="comments">

package/layout/_partial/main/navbar/article_banner.ejs

@@ -105,23 +105,29 @@ function layoutDiv() {
     return ``
   }
   const top = layoutBreadcrumb()
-  var style = ``
+  var bannerStyle = ``
+  var contentStyle = ``
   var el = ``
-  el += `<div class="article banner${scrollreveal(' ')} top">`
+  if (banner.url?.length > 0) {
+    bannerStyle += ` style="--bg-url:url('${banner.url.replace(/'/g, '%27')}')"`
+  }
+  el += `<div class="article-banner-wrap${scrollreveal(' ')}">`
+  el += `<div class="article banner top"${bannerStyle}>`
   if (banner.url?.length > 0) {
     el += `<img class="lazy bg" data-src="${banner.url}">`
     if (banner.color) {
-      style += ' style="--text-banner:' + banner.color + '"'
+      contentStyle += ' style="--text-banner:' + banner.color + '"'
     }
   }
   el += `
-  <div class="content"${style}>
+  <div class="content"${contentStyle}>
     ${top}
     ${bottom}
   </div>
   `
   el += `</div>`
+  el += `</div>`
   return el
 }
 %>
-<%- layoutDiv() %>
+<%- layoutDiv() %>

package/layout/_partial/main/post_list/post_card.ejs

@@ -109,7 +109,7 @@ function div_photo() {
       position = 'bottom';
     }
   }
-  el += '<div class="cover" position="' + position + '">';
+  el += '<div class="cover" position="' + position + '" style="--cover-url:url(\'' + obj.image.replace(/'/g, '%27') + '\')">';
   el += '<img src="' + obj.image + '"/>';
   if (position.length > 0) {
     el += '<div class="cover-info" position="' + position + '"';

package/layout/_partial/scripts/defines.ejs

@@ -31,7 +31,8 @@
         }
         const anchor = document.getElementById(anchorId);
         if (anchor) {
-          const offset = 32; // 与 TOC 点击滚动保持一致
+          // #start 锚点贴顶，不预留 offset；其余锚点与 TOC 点击滚动保持一致
+          const offset = anchorId === 'start' ? 0 : 32;
           const targetY = () => anchor.getBoundingClientRect().top + window.scrollY - offset;
           let timer = null;
           let lastY = null;

package/layout/_partial/scripts/utils.ejs

@@ -321,6 +321,31 @@
     // 动态数据本地缓存：TTL 未过期直接命中；过期后先显示缓存再后台刷新（stale-while-revalidate）
     _cacheEnabled: true,
     _cacheMaxEntryBytes: 200 * 1024,
+    // 同 URL 并发请求去重：页面内多个组件请求同一接口时共享一次 fetch
+    _pendingRequests: {},
+    _fetchShared: (url, options) => {
+      const key = (options && options.method || 'GET') + ' ' + url;
+      if (utils._pendingRequests[key]) {
+        return utils._pendingRequests[key].then(resp => resp.clone());
+      }
+      const promise = fetch(url, options).then(resp => {
+        if (!resp.ok) throw new Error('响应失败');
+        return resp;
+      }).finally(() => {
+        delete utils._pendingRequests[key];
+      });
+      utils._pendingRequests[key] = promise;
+      // 每个调用方各自 clone，避免 Response body 被消费后其他调用方取不到数据
+      return promise.then(resp => resp.clone());
+    },
+    // 延迟执行：缓存写入等非关键操作让出主线程
+    _defer: (fn) => {
+      if (window.requestIdleCallback) {
+        window.requestIdleCallback(fn, { timeout: 3000 });
+      } else {
+        setTimeout(fn, 0);
+      }
+    },
     cache: {
       prefix: 'Stellar.data_cache.v1.',
       enabled: () => !!def.data_cache?.enable && utils._cacheEnabled,
@@ -500,21 +525,21 @@
             }
           }, 5000);
 
-          fetch(url).then(resp => {
+          utils._fetchShared(url).then(resp => {
             if (timedOut) return;
             clearTimeout(timeout);
-
-            if (!resp.ok) throw new Error('响应失败');
             return resp;
           }).then(data => {
             if (timedOut) return;
             // 标记元素实例为已加载
             if (el) utils._loadedElements.add(el);
-            // 写入缓存（克隆响应，避免影响回调读取）
+            // 写入缓存（克隆响应，避免影响回调读取；延迟执行，避免阻塞渲染）
             if (cacheable && data.ok) {
-              data.clone().text().then(text => {
-                utils.cache.set(url, text, data.headers.get('Content-Type') || 'application/json', ttl);
-              }).catch(() => {});
+              utils._defer(() => {
+                data.clone().text().then(text => {
+                  utils.cache.set(url, text, data.headers.get('Content-Type') || 'application/json', ttl);
+                }).catch(() => {});
+              });
             }
             // 后台刷新渲染前恢复初始结构，避免缓存渲染的内容重复
             if (el && initialHTML !== null) {
@@ -562,30 +587,48 @@
 
       return new Promise((resolve, reject) => {
         let retryCount = 0;
+        // 与 request 保持一致：最终失败时回退 stale 缓存，避免闪失败态
+        const fallback = () => {
+          if (cached) {
+            resolve(utils.cache.toResponse(cached));
+          } else {
+            reject('timeout');
+          }
+        };
 
         const tryRequest = () => {
           let timedOut = false;
           const timer = setTimeout(() => {
             timedOut = true;
-            if (++retryCount > maxRetry) reject('timeout');
+            if (++retryCount > maxRetry) fallback();
             else tryRequest();
           }, timeout);
 
-          fetch(url, options)
+          utils._fetchShared(url, options)
             .then(resp => {
               clearTimeout(timer);
-              if (!resp.ok) throw new Error('bad response');
+              if (timedOut) return;
               if (cacheable) {
-                resp.clone().text().then(text => {
-                  utils.cache.set(url, text, resp.headers.get('Content-Type') || 'application/json', ttl);
-                }).catch(() => {});
+                utils._defer(() => {
+                  resp.clone().text().then(text => {
+                    utils.cache.set(url, text, resp.headers.get('Content-Type') || 'application/json', ttl);
+                  }).catch(() => {});
+                });
               }
               resolve(resp);
             })
             .catch(err => {
               clearTimeout(timer);
-              if (++retryCount > maxRetry) reject(err);
-              else setTimeout(tryRequest, 500);
+              if (timedOut) return;
+              if (++retryCount > maxRetry) {
+                if (cached) {
+                  resolve(utils.cache.toResponse(cached));
+                } else {
+                  reject(err);
+                }
+              } else {
+                setTimeout(tryRequest, 500);
+              }
             });
         };
 

package/layout/_partial/sidebar/grad-def.ejs

@@ -0,0 +1,26 @@
+<%
+// 隐藏的 SVG 线性渐变定义，配合 --item-grad 使用（用法见 menu.ejs 与 theme_base.styl 注释）。
+// 渐变角度来自 style.gradient.angle（CSS 角度，0=向上、顺时针），与 CSS 渐变方向保持一致；
+// 颜色使用 --item-theme（默认 var(--theme)）与 --item-theme-light 两个 CSS 变量，
+// 因此同一份定义可被任意元素复用，局部覆盖 --item-theme 的元素需同时设置 --item-theme-light。
+var gradAngle = 225
+if (theme.style && theme.style.gradient && theme.style.gradient.angle) {
+  gradAngle = parseFloat(theme.style.gradient.angle)
+  if (isNaN(gradAngle)) {
+    gradAngle = 225
+  }
+}
+var gradRad = gradAngle * Math.PI / 180
+var gradVX = Math.sin(gradRad)
+var gradVY = -Math.cos(gradRad)
+var gradProj = [[0,0],[1,0],[0,1],[1,1]].map(function(c) {
+  return c[0] * gradVX + c[1] * gradVY
+})
+var gradMin = Math.min.apply(null, gradProj)
+var gradMax = Math.max.apply(null, gradProj)
+var gradX1 = Math.round((0.5 + gradVX * gradMin) * 1000) / 10
+var gradY1 = Math.round((0.5 + gradVY * gradMin) * 1000) / 10
+var gradX2 = Math.round((0.5 + gradVX * gradMax) * 1000) / 10
+var gradY2 = Math.round((0.5 + gradVY * gradMax) * 1000) / 10
+%>
+<svg class="grad-def" width="0" height="0" aria-hidden="true" focusable="false"><defs><linearGradient id="<%= id %>" x1="<%= gradX1 %>%" y1="<%= gradY1 %>%" x2="<%= gradX2 %>%" y2="<%= gradY2 %>%"><stop offset="20%" style="stop-color:var(--item-theme-light)"/><stop offset="60%" style="stop-color:var(--item-theme)"/></linearGradient></defs></svg>

package/layout/_partial/sidebar/index_leftbar.ejs

@@ -78,16 +78,11 @@ function layoutTitle(main, url, sub) {
 function layoutWidgets() {
   var el = '';
   el += '<div class="widgets">';
+  // 左栏共用的 SVG 渐变定义（供激活书签等彩色图标使用，见 grad-def.ejs）
+  el += partial('grad-def', {id: 'leftbar-active-icon-grad'})
+  // 导航区放进组件滚动区，一起滚动
+  el += layoutNavArea()
   if (page.leftbar) {
-    var search = {}
-    if (page.search) {
-      search = page.search
-    } else if (wiki?.search) {
-      search = wiki.search
-    } else if (topic?.search) {
-      search = topic.search
-    }
-    el += partial('search', {item: search})
     page.leftbar.forEach((w, i) => {
       let name = ''
       let widget = {}
@@ -110,6 +105,20 @@ function layoutWidgets() {
   el += '</div>';
   return el;
 }
+function layoutSearch() {
+  if (!page.leftbar) {
+    return ''
+  }
+  var search = {}
+  if (page.search) {
+    search = page.search
+  } else if (wiki?.search) {
+    search = wiki.search
+  } else if (topic?.search) {
+    search = topic.search
+  }
+  return partial('search', {item: search})
+}
 function layoutFooterDiv() {
   const { social } = theme.footer
   if (social == null) {
@@ -154,6 +163,12 @@ function layoutNavArea() {
   if (page.menu == false) {
     return el
   }
+  // wiki 内容页默认隐藏导航区，page.menu 或 wiki.menu 为 true 时显示
+  if (page.wiki?.length > 0) {
+    if (page.menu !== true && wiki?.menu !== true) {
+      return el
+    }
+  }
   el += `<div class="nav-area">`
   el += partial('menu', {where: 'sidebar'})
   el += `</div>`
@@ -161,6 +176,6 @@ function layoutNavArea() {
 }
 %>
 <%- layoutLogo() %>
-<%- layoutNavArea() %>
+<%- layoutSearch() %>
 <%- layoutWidgets() %>
 <%- layoutFooterDiv() %>

package/layout/_partial/sidebar/logo.ejs

@@ -37,6 +37,26 @@ function layoutTitle(main, url, sub) {
   return el
 }
 
+function layoutBack() {
+  if (where != 'sidebar' || !page.wiki) {
+    return ''
+  }
+  // 开关：page 的 wiki_home 优先，其次 wiki 定义的 wiki_home，默认显示
+  const wiki = theme.wiki.tree[page.wiki]
+  const enabled = page.wiki_home ?? wiki?.wiki_home ?? true
+  if (enabled === false) {
+    return ''
+  }
+  var el = ''
+  el += `<div class="wiki-home-wrap">`
+  el += `<a class="wiki-home cap" href="${pretty_url(theme.site_tree.index_wiki.base_dir)}">`
+  el += icon('default:goback')
+  el += `<span>${__('btn.all_wiki')}</span>`
+  el += `</a>`
+  el += `</div>`
+  return el
+}
+
 function layoutDiv() {
   if (where == 'main') {
     if (page.header == false) {
@@ -75,4 +95,5 @@ function layoutDiv() {
 }
 %>
 
+<%- layoutBack() %>
 <%- layoutDiv() %>

package/layout/_partial/sidebar/menu.ejs

@@ -6,16 +6,22 @@ function layoutDiv() {
     if (item == undefined || item.id == null || item.url == null) {
       continue
     }
-    el += `<a class="nav-item${item.id == page.menu_id ? ' active' : ''}" title="${item.title}" href="${pretty_url(item.url)}"`
+    var active = item.id == page.menu_id
+    el += `<a class="nav-item${active ? ' active' : ''}${item.theme?.length > 0 ? ' themed' : ''}"`
+    var style = `--item-grad:url(#menu-grad-${item.id})`
     if (item.theme?.length > 0) {
-      el += ` style="color:${item.theme}"`
+      style += `;--item-theme:${item.theme}`
     }
-    el += `>`
+    el += ` style="${style}"`
+    el += ` title="${item.title}" href="${pretty_url(item.url)}">`
     if (item.icon?.length > 0) {
       el += icon(item.icon, 'no-lazy')
-    } else {
-      el += `<span>${__(item.title)}</span>`
     }
+    el += `<span>${__(item.title)}</span>`
+    if (active) {
+      el += `<span class="active-dot"></span>`
+    }
+    el += partial('grad-def', {id: 'menu-grad-' + item.id})
     el += `</a>`
   }
   el += `</nav>`

package/layout/_partial/widgets/toc.ejs

@@ -37,9 +37,15 @@ function layoutToc(fallback) {
 
 function layoutDiv(fallback) {
   const tocBody = layoutTocBody()
+  const hasToc = tocBody.trim().length > 0
+  // 页面是否实际渲染评论区，由 _partial/comments/layout.ejs 标记
+  const hasComments = page.cmt_rendered === true
+  if (!hasToc && !hasComments) {
+    return ''
+  }
   var el = ''
   el += `<widget class="widget-wrapper${scrollreveal(' ')} toc" id="data-toc" collapse="${item.collapse}">`
-  if (tocBody.trim().length > 0) {
+  if (hasToc) {
     el += layoutTocHeader()
     el += `<div class="widget-body">`
     el += tocBody
@@ -50,13 +56,11 @@ function layoutDiv(fallback) {
   el += icon('default:upup')
   el += `<span>${__('btn.top')}</span>`
   el += `</a>`
-  if (theme.comments.service && theme.comments.service.length > 0) {
-    if (page.comments == undefined || page.comments != false) {
-      el += `<a class="buttom" onclick="util.scrollComment()">`
-      el += icon('default:tocomment')
-      el += `<span>${__('btn.comments')}</span>`
-      el += `</a>`
-    }
+  if (hasComments) {
+    el += `<a class="buttom" onclick="util.scrollComment()">`
+    el += icon('default:tocomment')
+    el += `<span>${__('btn.comments')}</span>`
+    el += `</a>`
   }
   el += `</div>`
   el += `</widget>`

package/layout/_plugins/scrollreveal.ejs

@@ -18,11 +18,26 @@
       return null;
     };
 
+    // 最近的滚动容器（overflow-y: auto/scroll）
+    // 吸顶容器内可能存在内部滚动容器（如侧栏 .widgets），
+    // 若直接用吸顶容器做 reveal 容器，折叠区下方的元素永远不会进入视口，导致一直不显示。
+    const findScrollContainer = (el) => {
+      let node = el.parentElement;
+      while (node && node.nodeType === 1) {
+        const oy = window.getComputedStyle(node).overflowY;
+        if (oy === 'auto' || oy === 'scroll') return node;
+        node = node.parentElement;
+      }
+      return null;
+    };
+
     const pinnedGroups = new Map(); // 容器 -> 元素列表
     const targets = [];
     els.forEach((el) => {
-      const container = findPinnedContainer(el);
-      if (container) {
+      const pinned = findPinnedContainer(el);
+      if (pinned) {
+        // 优先使用最近的滚动容器，其次才用吸顶容器
+        const container = findScrollContainer(el) || pinned;
         const group = pinnedGroups.get(container) || [];
         group.push(el);
         pinnedGroups.set(container, group);