hexo-theme-stellar 1.41.0 → 1.42.1

package/layout/_partial/main/pin_slider.ejs

@@ -49,25 +49,13 @@ pinItems.sort(function(a, b) {
   return pinWeight(b) - pinWeight(a)
 })
 
-// 文章幻灯片：固定「标题 + 一行小字」结构，宽高比统一取自 pin_slider.ratio。
-// 标题：poster.headline > title；小字：poster.caption > description > excerpt（截断 50 字）。
-// 样式与 poster 卡片 cover-info 一致；无封面时为纯白卡片（文字按普通文章颜色）。
-function postSubtitle(post) {
-  if (post.poster != null && post.poster.caption != null && post.poster.caption.length > 0) {
-    return post.poster.caption
-  }
-  if (post.description != null && post.description.length > 0) {
-    return post.description
-  }
-  var text = post.excerpt || post.content || ''
-  text = strip_html(text).replace(/\s+/g, ' ').trim()
-  return text.length > 0 ? truncate(text, {length: 50}) : ''
-}
-
+// 文章幻灯片：固定「标题 + 一行小字」结构。
+// 标题：post.title；小字由 subtitle() helper 统一取值（subtitle > description > excerpt 前 50 字）。
+// 样式与 hero 卡片 cover-info 一致；无封面时为纯白卡片（文字按普通文章颜色）。
 function postSlide(post) {
   var noCover = !(post.cover != null && post.cover.length > 0)
-  var headline = (post.poster != null && post.poster.headline != null && post.poster.headline.length > 0) ? post.poster.headline : post.title
-  var subtitle = postSubtitle(post)
+  var headline = post.title
+  var sub = subtitle(post)
   var el = ''
   el += '<a class="pin-slide post-slide' + (noCover ? ' no-cover' : '') + '" href="' + escape_html(pretty_url(post.link || post.path)) + '"'
   if (!noCover) {
@@ -77,10 +65,11 @@ function postSlide(post) {
   if (!noCover) {
     el += '<img class="pin-slide-bg" src="' + escape_html(post.cover) + '" alt=""/>'
   }
-  el += '<div class="pin-slide-text">'
+  // 有封面时文字颜色自适应（大字 contrast、小字 theme）；无封面保持普通文章文字颜色
+  el += '<div class="pin-slide-text"' + (noCover ? '' : ' data-text-adaptive="split"') + '>'
   el += '<div class="pin-slide-headline">' + escape_html(headline) + '</div>'
-  if (subtitle.length > 0) {
-    el += '<div class="pin-slide-caption">' + escape_html(subtitle) + '</div>'
+  if (sub.length > 0) {
+    el += '<div class="pin-slide-caption">' + escape_html(sub) + '</div>'
   }
   el += '</div>'
   el += '</a>'
@@ -100,10 +89,9 @@ function wikiSlide(proj) {
   var title = proj.title || proj.name || proj.id
   var excerpt = proj.description || ''
   var el = ''
-  el += '<a class="pin-slide" href="' + escape_html(pretty_url(proj.homepage?.path || '/')) + '">'
+  el += '<a class="pin-slide" href="' + escape_html(pretty_url(proj.homepage?.path || '/')) + '" style="--pin-cover-url:url(\'' + escape_html(img.replace(/'/g, '%27')) + '\')">'
   el += '<img class="pin-slide-bg" src="' + escape_html(img) + '" alt=""/>'
-  el += '<div class="pin-slide-mask"></div>'
-  el += '<div class="pin-slide-info">'
+  el += '<div class="pin-slide-info" data-text-adaptive="split">'
   el += '<div class="pin-slide-caps">' + projectChips(proj.tags) + '</div>'
   el += '<div class="pin-slide-title">' + escape_html(title) + '</div>'
   if (excerpt.length > 0) {
@@ -145,12 +133,13 @@ if (pinItems.length > 0) {
 <%- el %>
 <script>
 function initWhenReady() {
-  if (typeof utils !== 'undefined' && utils.initPlugin) {
-    utils.initPlugin(initPinSlider, 'pin-slider');
+  if (typeof stellar === 'object' && typeof stellar.initPlugin === 'function') {
+    stellar.initPlugin(initPinSlider, 'pin-slider');
   } else {
-    document.addEventListener('DOMContentLoaded', function() {
-      if (typeof utils !== 'undefined' && utils.initPlugin) {
-        utils.initPlugin(initPinSlider, 'pin-slider');
+    // pin_slider 内联脚本渲染在 scripts/bootstrap 之前，等待 DOMContentLoaded 后注册
+    document.addEventListener('DOMContentLoaded', function () {
+      if (typeof stellar === 'object' && typeof stellar.initPlugin === 'function') {
+        stellar.initPlugin(initPinSlider, 'pin-slider');
       }
     });
   }
@@ -163,6 +152,10 @@ function initPinSlider() {
   var slides = slider.querySelectorAll('.pin-slide');
   var count = slides.length;
   if (!track || count <= 1) {
+    // 单张幻灯片：直接把封面同步到 .pin-slider 自身背景（跟随 corner-shape）
+    if (slides[0]) {
+      slider.style.setProperty('--pin-cover-url', slides[0].style.getPropertyValue('--pin-cover-url') || '');
+    }
     slider.style.visibility = 'visible';
     return;
   }
@@ -185,6 +178,11 @@ function initPinSlider() {
   function goTo(n) {
     index = (n + count) % count;
     track.style.transform = 'translateX(-' + (index * 100) + '%)';
+    // 背景图由 .pin-slider 自身背景承载（跟随 corner-shape），随当前 slide 同步
+    var active = slides[index];
+    if (active) {
+      slider.style.setProperty('--pin-cover-url', active.style.getPropertyValue('--pin-cover-url') || '');
+    }
     var dots = slider.querySelector('.pin-slider-dots');
     var items = dots ? dots.children : [];
     for (var i = 0; i < count; i++) {
@@ -198,9 +196,39 @@ function initPinSlider() {
       }
     }
     savePinIndex(group, contentKey, index, count);
+    updateNavColor();
   }
   function next() { goTo(index + 1); }
   function prev() { goTo(index - 1); }
+
+  // 左右箭头颜色随当前幻灯片封面自适应（contrast：深色背景白箭头、浅色背景深箭头）
+  var navColorRetries = 0;
+  function updateNavColor() {
+    var navs = slider.querySelectorAll('.pin-slider-nav');
+    if (navs.length === 0) return;
+    if (!window.stellar || !window.stellar.color || !window.resolveAdaptiveBackdrop) {
+      // 懒加载的 color.js / 插件尚未就绪时重试
+      if (navColorRetries < 25) {
+        navColorRetries++;
+        setTimeout(updateNavColor, 200);
+      }
+      return;
+    }
+    var slide = slides[index];
+    if (!slide) return;
+    var cover = slide.style.getPropertyValue('--pin-cover-url');
+    if (!cover) return;
+    var m = cover.match(/url\((['"]?)(.*?)\1\)/i);
+    if (!m) return;
+    stellar.color.getAverageColor(m[2], { background: window.resolveAdaptiveBackdrop(slide) }).then(function (rgb) {
+      if (!rgb) return;
+      var color = stellar.color.adaptiveTextColor(rgb, { style: 'contrast' });
+      for (var i = 0; i < navs.length; i++) {
+        navs[i].style.setProperty('--text-banner', color);
+      }
+    });
+  }
+  window.refreshPinNavColor = updateNavColor;
   function start() {
     if (reduced) return;
     slider.classList.remove('paused');
@@ -294,6 +322,9 @@ function initPinSlider() {
       navNext.removeEventListener('click', next);
     }
     document.removeEventListener('visibilitychange', onVis);
+    if (window.refreshPinNavColor === updateNavColor) {
+      window.refreshPinNavColor = null;
+    }
   };
 }
 function restorePinIndex(group, contentKey, count) {

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

@@ -0,0 +1,25 @@
+<%
+// 最新文章封面卡片（公共组件）：整卡跳转到最新文章，背景为封面图，底部渐变模糊文字区。
+// 入参：href（跳转链接）、background（背景图 URL）、label（专栏名/分类名）、post（{title, date}）
+// 专栏列表页与未来首页等场景复用；无 post 时仅渲染 label。
+function layoutDiv() {
+  var el = '';
+  var bg = background || theme.default.topic;
+  // 注意：不能用 `var href` 承接，var 提升会遮蔽 partial 传入的 href 参数
+  var link = pretty_url(href || '/');
+  el += '<a class="cover" position="bottom" style="--cover-url:url(\'' + escape_html(bg.replace(/'/g, '%27')) + '\')" href="' + link + '">';
+  el += '<img src="' + escape_html(bg) + '" alt=""/>';
+  el += '<div class="cover-info" position="bottom" data-text-adaptive="split">';
+  if (typeof label !== 'undefined' && label) {
+    el += '<div class="text topic">' + escape_html(label) + '</div>';
+  }
+  if (post) {
+    el += '<div class="text headline">' + escape_html(post.title) + '</div>';
+    el += '<div class="text caption">' + escape_html(date(post.date, config.date_format)) + '</div>';
+  }
+  el += '</div>';
+  el += '</a>';
+  return el;
+}
+%>
+<%- layoutDiv() %>

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

@@ -1,47 +1,16 @@
 <%
-const poster = post.poster;
 var obj = {
   image: post.cover
 };
-if (poster) {
-  obj.headline = poster.headline;
-  obj.topic = poster.topic;
-  obj.caption = poster.caption;
-  obj.color = poster.color;
-}
 function div_default() {
   var el = '';
   el += '<article class="md-text">';
 
-  // 封面
-  if (obj.image || theme.article.auto_cover) {
-    var cover_url;
-    if (obj.image != undefined) {
-      if (obj.image.includes('/')) {
-        cover_url = obj.image;
-      } else {
-        cover_url = 'https://source.unsplash.com/1280x640/?' + obj.image;
-      }
-    } else {
-      // 自动以 tags 作为关键词搜索封面
-      if (post.tags) {
-        var params = '';
-        post.tags.reverse().forEach((tag, i) => {
-          if (i > 0) {
-            params += ',';
-          }
-          params += tag.name;
-        });
-        cover_url = 'https://source.unsplash.com/1280x640/?' + params;
-      } else {
-        cover_url = 'https://source.unsplash.com/random/1280x640';
-      }
-    }
-    if (cover_url) {
-      el += '<div class="post-cover">';
-      el += '<img src="' + escape_html(cover_url) + '"/>';
-      el += '</div>';
-    }
+  // 封面：仅当显式 cover 为完整 URL 时渲染（Unsplash 自动封面接口已失效，不再生成）
+  if (obj.image && obj.image.includes('/')) {
+    el += '<div class="post-cover">';
+    el += '<img src="' + escape_html(obj.image) + '"/>';
+    el += '</div>';
   }
 
   // 标题
@@ -100,7 +69,7 @@ function div_default() {
       if (i >= 5) {
         return;
       }
-      el += `<span class="cap tag-chip">#${escape_html(tag.name)}</span>`;
+      el += `<span class="cap tag-chip">${icon('default:hashtag')}${escape_html(tag.name)}</span>`;
     });
     el += '</span>';
   }
@@ -110,39 +79,22 @@ function div_default() {
 }
 function div_photo() {
   var el = '';
-  var position = '';
-  if (obj.headline || obj.topic || obj.caption) {
-    if (obj.topic) {
-      position = 'top';
-    } else {
-      position = 'bottom';
-    }
-  }
-  el += '<div class="cover" position="' + position + '" style="--cover-url:url(\'' + escape_html(obj.image.replace(/'/g, '%27')) + '\')">';
+  // 小字取值统一由 subtitle() helper 提供：subtitle > description > excerpt 前 50 字
+  var caption = subtitle(post);
+  // hero 卡片文字区固定 bottom：标题 + 一行小字，不再有 top 布局
+  el += '<div class="cover" position="bottom" style="--cover-url:url(\'' + escape_html(obj.image.replace(/'/g, '%27')) + '\')">';
   el += '<img src="' + escape_html(obj.image) + '"/>';
-  if (position.length > 0) {
-    el += '<div class="cover-info" position="' + position + '"';
-    if (obj.color) {
-      el += 'style="color:' + escape_html(obj.color) + '"';
-    }
-    el += '>';
-    if (obj.topic) {
-      el += '<div class="text topic">' + escape_html(obj.topic) + '</div>';
-    }
-    if (obj.headline) {
-      el += '<div class="text headline">' + escape_html(obj.headline) + '</div>';
-    }
-    if (obj.caption) {
-      el += '<div class="text caption">' + escape_html(obj.caption) + '</div>';
-    }
-    el += '</div>';
-
+  el += '<div class="cover-info" position="bottom" data-text-adaptive="split">';
+  el += '<div class="text headline">' + escape_html(post.title ? post.title : date(post.date, config.date_format)) + '</div>';
+  if (caption.length > 0) {
+    el += '<div class="text caption">' + escape_html(caption) + '</div>';
   }
   el += '</div>';
+  el += '</div>';
   return el;
 }
 function div() {
-  if (obj.image && obj.image.length > 0 && obj.headline != undefined) {
+  if (theme.article.card_style == 'hero' && obj.image && obj.image.length > 0) {
     return div_photo();
   }
   return div_default();

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

@@ -1,14 +1,35 @@
 <%
 function layoutDiv() {
   var el = '';
+  var bg = topic.cover || topic.icon || theme.default.topic;
+  var label = topic.title || topic.name;
+  var latest = topic.homepage;
   el += '<article class="md-text">';
-  el += `<div class="preview"><img src="${topic.icon ? topic.icon : theme.default.topic}"/></div>`
-  el += '<div class="excerpt">';
-  el += '<h2 class="post-title">' + (topic.title || topic.name) + '</h2>';
+  // 专栏标题（story 文章 h2 样式，置于卡片外）
+  el += '<h2 class="topic-title">' + escape_html(label) + '</h2>';
+  // 专栏描述（标题下方）
   if (topic.description) {
-    el += '<p>' + topic.description + '</p>';
+    el += '<p class="topic-desc">' + escape_html(topic.description) + '</p>';
+  }
+  // 最新文章卡片（整卡跳转最新文章）
+  el += partial('_partial/main/post_list/latest_post_card', {
+    href: pretty_url(latest ? (latest.path || '/') : '/'),
+    background: bg,
+    post: latest
+  });
+  // 其他文章（排除最新，最多 3 条，按发布时间倒序）
+  if (topic.pages && topic.pages.length > 1) {
+    el += '<div class="post-panel">';
+    el += '<div class="posts">';
+    topic.pages.slice(1, 4).forEach(function(post) {
+      el += '<a class="post-link" href="' + pretty_url(post.path) + '">';
+      el += '<span class="title">' + escape_html(post.title) + '</span>';
+      el += '<span class="date">' + escape_html(date(post.date, config.date_format)) + '</span>';
+      el += '</a>';
+    });
+    el += '</div>';
+    el += '</div>';
   }
-  el += '</div>';
   el += '</article>';
   return el;
 }

package/layout/_partial/scripts/bootstrap.ejs

@@ -0,0 +1,37 @@
+<script>
+  // 插件注册队列：utils.js 尚未就绪时先缓存注册请求，就绪后统一补跑，
+  // 保证解析期注册的插件不因加载时序丢失。
+  window.stellar = window.stellar || {};
+  window.stellar._pluginQueue = window.stellar._pluginQueue || [];
+  window.stellar.initPlugin = function (fn, name, options) {
+    if (typeof utils === 'object' && typeof utils.initPlugin === 'function') {
+      return utils.initPlugin(fn, name, options);
+    }
+    window.stellar._pluginQueue.push({ fn: fn, name: name, options: options || {} });
+  };
+  window.stellar._flushPlugins = function () {
+    var pending = window.stellar._pluginQueue.splice(0);
+    if (typeof utils !== 'object' || typeof utils.initPlugin !== 'function') return;
+    for (var i = 0; i < pending.length; i++) {
+      try {
+        utils.initPlugin(pending[i].fn, pending[i].name, pending[i].options);
+      } catch (e) {
+        console.error('[Stellar] 插件补注册失败:', e);
+      }
+    }
+  };
+  document.addEventListener('DOMContentLoaded', function () {
+    if (typeof utils === 'object') return;
+    // utils 未就绪时补载；加载成功后由 utils.js 内部补跑插件队列
+    var s = document.createElement('script');
+    // 用 setAttribute 赋值 src，避免被基于 `s.src = "..."` 的正则
+    // （图片懒加载 / 脚本延迟优化器）误改写
+    s.setAttribute('src', '<%- url_for('/js/utils.js') %>?v=<%- stellar_info('version') %>');
+    s.async = false;
+    s.onerror = function () {
+      console.error('[Stellar] 无法加载 /js/utils.js，已启用内容兜底显示（sr-fallback）');
+      document.documentElement.classList.add('sr-fallback');
+    };
+    document.head.appendChild(s);
+  });
+</script>

package/layout/_partial/scripts/defines.ejs

@@ -195,7 +195,8 @@
       if (!window.location.search) return;
       if (!new URLSearchParams(window.location.search).has('kw')) return;
       document.addEventListener('DOMContentLoaded', function () {
-        // utils 为全局词法绑定（顶层 const），不能通过 window.utils 访问
+        // utils 由 /js/utils.js 定义（同时暴露 window.utils）；
+        // 未就绪时由 bootstrap 队列兜底，此处按就绪状态判断
         if (typeof utils === 'object' && typeof utils.js === 'function') {
           utils.js('<%- url_for('/js/search/highlight.js') %>', { defer: true }).catch(function () {});
         }

package/layout/_partial/scripts.ejs

@@ -34,8 +34,17 @@ function tagtreeWidgetOnPage() {
 %>
 <%- partial('scripts/defines') %>
 
+<%- partial('scripts/bootstrap') %>
+
 <!-- core: utils 必须同步加载（页尾内联插件片段在解析期即调用 utils.initPlugin） -->
 <script src="<%- url_for('/js/utils.js') %>?v=<%- stellar_info('version') %>"></script>
+<script>
+  // 解析期检测 utils 是否已就绪；未就绪时同步补载，
+  // 保证「utils 先于页尾插件片段定义」的不变量。
+  if (typeof utils === 'undefined') {
+    document.write('<script src="<%- url_for('/js/utils.js') %>?v=<%- stellar_info('version') %>"><\/script>');
+  }
+</script>
 <script defer src="<%- url_for('/js/stellar-icons.js') %>?v=<%- stellar_info('version') %>"></script>
 <!-- 非首屏图标异步加载：占位符替换依赖构建期生成的 js/icons/{ns}.json -->
 <script defer src="<%- url_for('/js/icons.js') %>?v=<%- stellar_info('version') %>" data-version="<%- stellar_info('version') %>"></script>

package/layout/_partial/widgets/toc.ejs

@@ -60,12 +60,12 @@ function layoutDiv(fallback) {
   }
   el += `<div class="widget-footer">`
   el += `<a class="top" onclick="util.scrollTop()">`
-  el += icon('default:upup')
+  el += icon('default:upup', '', true)
   el += `<span>${__('btn.top')}</span>`
   el += `</a>`
   if (hasComments) {
     el += `<a class="buttom" onclick="util.scrollComment()">`
-    el += icon('default:tocomment')
+    el += icon('default:tocomment', '', true)
     el += `<span>${__('btn.comments')}</span>`
     el += `</a>`
   }

package/layout/_plugins/adaptive_text.ejs

@@ -0,0 +1,11 @@
+<script>
+  stellar.initPlugin(() => {
+    const els = Array.prototype.slice.call(document.querySelectorAll('[data-text-adaptive]'));
+    if (els.length === 0) return;
+    utils.js('/js/color.js').then(() => utils.js('/js/plugins/adaptive-text.js')).then(() => {
+      if (typeof applyAdaptiveText === 'function') {
+        applyAdaptiveText(els);
+      }
+    });
+  }, 'adaptive-text');
+</script>

package/layout/_plugins/copycode.ejs

@@ -1,5 +1,5 @@
 <script>
-  utils.initPlugin(() => {
+  stellar.initPlugin(() => {
     const codeElements = document.querySelectorAll('.code');
     if (codeElements.length > 0) {
       ctx.copycode = {
@@ -14,4 +14,4 @@
       });
     }
   }, 'copycode');
-</script>
+</script>

package/layout/_plugins/index.ejs

@@ -1,3 +1,28 @@
+<script>
+  // 防御：bootstrap 被第三方优化器改写/移除导致 window.stellar.initPlugin 缺失时，
+  // 在此补一个等价注册点：utils 就绪时直接委托，未就绪时入队，utils 加载后自动补跑。
+  if (typeof window.stellar === 'undefined' || typeof window.stellar.initPlugin !== 'function') {
+    window.stellar = window.stellar || {};
+    window.stellar._pluginQueue = window.stellar._pluginQueue || [];
+    window.stellar.initPlugin = function (fn, name, options) {
+      if (typeof utils === 'object' && typeof utils.initPlugin === 'function') {
+        return utils.initPlugin(fn, name, options);
+      }
+      window.stellar._pluginQueue.push({ fn: fn, name: name, options: options || {} });
+    };
+    window.stellar._flushPlugins = function () {
+      var pending = window.stellar._pluginQueue.splice(0);
+      if (typeof utils !== 'object' || typeof utils.initPlugin !== 'function') return;
+      for (var i = 0; i < pending.length; i++) {
+        try {
+          utils.initPlugin(pending[i].fn, pending[i].name, pending[i].options);
+        } catch (e) {
+          console.error('[Stellar] 插件补注册失败:', e);
+        }
+      }
+    };
+  }
+</script>
 <%
 function loadPlugins() {
   var el = ''

package/layout/_plugins/mermaid.ejs

@@ -1,6 +1,6 @@
 <script defer type="text/javascript" src="<%- conf.js %>"></script>
 <script>
-  utils.initPlugin(() => {
+  stellar.initPlugin(() => {
     const els = document.querySelectorAll('.mermaid');
     if (els.length > 0) {
       utils.css(`<%- url_for('/css/plugins/mermaid.css') %>?v=<%- stellar_info('version') %>`);

package/layout/_plugins/scrollreveal.ejs

@@ -1,7 +1,20 @@
 <script>
-  utils.initPlugin(() => {
-    const els = Array.prototype.slice.call(document.querySelectorAll('.slide-up'));
-    if (els.length === 0) return;
+  (function () {
+    // 兜底看门狗独立于插件初始化：3 秒内未完成 reveal 时强制显示 .slide-up 内容
+    let fallbackApplied = false;
+    const revealFallback = () => {
+      if (fallbackApplied) return;
+      fallbackApplied = true;
+      document.documentElement.classList.add('sr-fallback');
+    };
+    const watchdog = setTimeout(() => revealFallback(), 3000);
+
+    stellar.initPlugin(() => {
+      const els = Array.prototype.slice.call(document.querySelectorAll('.slide-up'));
+      if (els.length === 0) {
+        clearTimeout(watchdog);
+        return;
+      }
 
     // 吸顶/固定定位容器内的元素始终在视口内（或由容器控制显隐），
     // 但 ScrollReveal 按文档坐标判断可见性，会误判这类元素为不可见，
@@ -45,15 +58,10 @@
         targets.push(el);
       }
     });
-    if (pinnedGroups.size === 0 && targets.length === 0) return;
-
-    // 加载/初始化失败时兜底显示内容，避免整页空白
-    let fallbackApplied = false;
-    const revealFallback = () => {
-      if (fallbackApplied) return;
-      fallbackApplied = true;
-      document.documentElement.classList.add('sr-fallback');
-    };
+    if (pinnedGroups.size === 0 && targets.length === 0) {
+      clearTimeout(watchdog);
+      return;
+    }
 
     const slideUp = {
       distance: `<%- conf.distance %>`,
@@ -64,9 +72,6 @@
       easing: "ease-out"
     };
 
-    // 看门狗：CDN 长时间无响应时强制显示内容
-    const watchdog = setTimeout(() => revealFallback(), 3000);
-
     utils.js(`<%- conf.js %>`, { defer: true })
       .then(() => {
         if (fallbackApplied) return;
@@ -92,5 +97,6 @@
         console.error('[Plugin scrollreveal] 加载失败:', err);
         revealFallback();
       });
-  }, 'scrollreveal');
+    }, 'scrollreveal');
+  })();
 </script>

package/layout/_plugins/swiper.ejs

@@ -1,5 +1,5 @@
 <script>
-  utils.initPlugin(() => {
+  stellar.initPlugin(() => {
     const swiper_api = document.getElementById('swiper-api');
     if (swiper_api != undefined) {
       utils.css(`<%- url_for('/css/plugins/swiper.css') %>?v=<%- stellar_info('version') %>`);

package/layout/index.ejs

@@ -76,11 +76,19 @@ if (pinFlat && is_home_first_page()) {
 function layout_post_card(layout, post, content) {
   var el = '';
   var layout = layout;
-  if (layout == 'post' && post.cover != undefined && post.poster != undefined) {
+  var hero = false;
+  if (layout == 'post' && post.cover != undefined && theme.article.card_style == 'hero') {
     layout += ' photo';
+    hero = true;
   }
   el += `<div class="post-card-wrap${scrollreveal(' ')}">`;
-  el += `<a class="post-card ${layout}" href="${pretty_url(post.link || post.path)}">`
+  if (hero) {
+    // hero 封面卡片：背景图由 .post-card 自身背景承载（跟随 corner-shape 圆角裁剪），
+    // 子图保留用于 hover 变暗/放大滤镜
+    el += `<a class="post-card ${layout}" style="--cover-url:url('${escape_html(post.cover.replace(/'/g, '%27'))}')" href="${pretty_url(post.link || post.path)}">`
+  } else {
+    el += `<a class="post-card ${layout}" href="${pretty_url(post.link || post.path)}">`
+  }
   el += content;
   el += '</a>';
   el += '</div>';

package/layout/index_topic.ejs

@@ -8,9 +8,9 @@ function layout_topic_list(partial) {
       continue
     }
     el += `<div class="post-card-wrap${scrollreveal(' ')}">`
-    el += `<a class="post-card wiki topic" href="${pretty_url(topic.homepage?.path || '/')}">`
+    el += `<div class="post-card topic">`
     el += partial(topic)
-    el += `</a>`
+    el += `</div>`
     el += `</div>`
   }
   return el
@@ -18,7 +18,7 @@ function layout_topic_list(partial) {
 function layoutDiv() {
   var el = ''
   el += partial('_partial/main/navbar/nav_tabs_blog')
-  el += `<div class="post-list wiki topic">`;
+  el += `<div class="post-list topic">`;
   el += layout_topic_list(function(topic) {
     return partial('_partial/main/post_list/topic_card', {topic: topic})
   })
@@ -27,4 +27,4 @@ function layoutDiv() {
 }
 %>
 
-<%- layoutDiv() %>
+<%- layoutDiv() %>

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "hexo-theme-stellar",
-  "version": "1.41.0",
+  "version": "1.42.1",
   "description": "Elegant and powerful theme for Hexo.",
   "main": "package.json",
   "scripts": {
     "lint": "eslint .",
-    "test": "node ci/check-require-decls.js && node --test",
-    "check": "npm run lint && npm test && python3 docs/knowledge/tools/verify.py",
+    "test": "node ci/check-require-decls.js && node --test && node ci/check-spec-refs.js",
+    "check": "npm run lint && npm test && python3 docs/knowledge/tools/verify.py && node ci/check-release-docs.js",
     "release": "node release.js",
     "release:dry": "node release.js --dry-run"
   },