hexo-theme-stellar 1.37.0 → 1.39.0

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) {
@@ -59,7 +79,7 @@ function layoutDiv() {
   } else if (md_text(logo.avatar)) {
     el += `<a class="avatar" href="${url_for(md_link(logo.avatar) || '/')}">`
     if (theme.style.animated_avatar.animate) {
-      el += `<div class="bg" style="opacity:0;background-image:url(${theme.style.animated_avatar.background});"></div>`
+      el += `<div class="bg"></div>`
     }
     el += `<img no-lazy class="avatar" src="${md_text(logo.avatar)}">`
     el += `</a>`
@@ -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/components/linklist.ejs

@@ -16,7 +16,7 @@ function layoutDiv(linklist) {
   if (columns == 1 && links.length > 1) {
     align = 'left'
   }
-  el += `<div class="linklist ${align}" ${style}>`
+  el += `<div class="linklist ${align}${columns > 1 ? ' multi' : ''}" ${style}>`
   for (let link of links) {
     el += partial('link', {item: link, columns: columns})
   }
@@ -24,4 +24,4 @@ function layoutDiv(linklist) {
   return el
 }
 %>
-<%- layoutDiv(item) %>
+<%- layoutDiv(item) %>

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);

package/layout/index.ejs

@@ -5,6 +5,32 @@ if (page.menu_id == undefined) {
 if (page.title && page.wiki) {
   page.robots = 'noindex,follow';
 }
+// 首页评论区：仅首页第一页，默认不显示，可通过 site_tree.home.comments 开启/覆盖
+var homeCmt = theme.site_tree?.home?.comments
+if (homeCmt && homeCmt !== false && is_home_first_page()) {
+  page.comments = true;
+  if (typeof homeCmt === 'object') {
+    if (homeCmt.service) {
+      page.comments_service = homeCmt.service;
+    }
+    if (homeCmt.comment_title != null) {
+      page.comment_title = homeCmt.comment_title;
+    }
+    if (homeCmt.comment_id != null) {
+      page.comment_id = homeCmt.comment_id;
+    }
+    var homeCommentServices = ['beaudar', 'utterances', 'giscus', 'twikoo', 'waline', 'artalk'];
+    for (var i = 0; i < homeCommentServices.length; i++) {
+      var key = homeCommentServices[i];
+      if (homeCmt[key]) {
+        page[key] = homeCmt[key];
+      }
+    }
+  }
+}
+
+// 首页第一页渲染置顶轮播时，列表不再重复展示置顶文章
+var pinSliderActive = is_home_first_page()
 
 function layout_post_card(layout, post, content) {
   var el = '';
@@ -25,6 +51,12 @@ function layout_post_list(partial) {
   el += `<div class="post-list post">`;
   page.posts.each(function(post){
     if (post.indexing != false) {
+      if (pinSliderActive) {
+        var pinVal = post.pin != null ? post.pin : post.sticky
+        if (pinVal !== false && pinVal != null) {
+          return
+        }
+      }
       el += layout_post_card('post', post, partial(post));
     }
   })
@@ -38,4 +70,7 @@ function layout_post_list(partial) {
 <%- layout_post_list(function(post){
   return partial('_partial/main/post_list/post_card', {post: post})
 }) %>
-<%- partial('_partial/main/post_list/paginator') %>
+<%- partial('_partial/main/post_list/paginator') %>
+<% if (homeCmt && homeCmt !== false && is_home_first_page()) { %>
+  <%- partial('_partial/comments/layout') %>
+<% } %>

package/layout/layout.ejs

@@ -49,7 +49,7 @@ if (theme.style.prefers_theme === 'auto') {
     html += site_background
     html += `<div id="l_cover">${partial('_partial/cover/index').trim()}</div>`
     html += `<div class="l_body ${page_type}" id="start" layout="${page.layout}" type="${article_type}" ${indent ? 'text-indent' : ''}>`
-      html += `<aside class="l_left">`
+      html += `<aside class="l_left${theme.style.leftbar?.['ui-style'] === 'card' ? ' leftbar-card' : ''}">`
         html += `<div class="sidebg"></div>`
         html += `<div class="leftbar-container${theme.style.leftbar?.blur ? ' leftbar-blur' : ''}">`
           html += partial('_partial/sidebar/index_leftbar')

package/layout/notebooks.ejs

@@ -1,8 +1,10 @@
 <%# 笔记本列表页主体部分 %>
 <% for (const notebook of Object.values(theme.notebooks.tree)) { %>
   <div class="post-list wiki">
-    <a class="post-card wiki<%= scrollreveal(' ') %>" href="<%= pretty_url(notebook.base_dir) %>">
+    <div class="post-card-wrap<%= scrollreveal(' ') %>">
+    <a class="post-card wiki" href="<%= pretty_url(notebook.base_dir) %>">
       <%- include('_partial/main/notebook/notebook_card', { notebook: notebook }) %>
     </a>
+    </div>
   </div>
 <% } %>

package/layout/notes.ejs

@@ -1,12 +1,14 @@
 <%# 笔记列表页主体部分 %>
 <div class="post-list post">
   <% page.posts.each(post => { %>
+    <div class="post-card-wrap<%= scrollreveal(' ') %>">
     <a
-      class="post-card<%= scrollreveal(' ') %> post"
+      class="post-card post"
       href="<%= pretty_url(post.link || post.path) %><%= page.activeTag ? `?tag=${page.activeTag}` : '' %>"
     >
       <%- include('_partial/main/notebook/note_card', { note: post }) %>
     </a>
+    </div>
   <% }) %>
 </div>
 <%- include('_partial/main/notebook/paginator') %>

package/package.json

@@ -1,10 +1,12 @@
 {
   "name": "hexo-theme-stellar",
-  "version": "1.37.0",
+  "version": "1.39.0",
   "description": "Elegant and powerful theme for Hexo.",
   "main": "package.json",
   "scripts": {
-    "test": "echo test",
+    "lint": "eslint .",
+    "test": "node --test",
+    "check": "npm run lint && npm test && python3 docs/knowledge/tools/verify.py",
     "release": "node release.js",
     "release:dry": "node release.js --dry-run"
   },
@@ -31,5 +33,6 @@
   },
   "homepage": "https://xaoxuu.com/wiki/stellar/",
   "devDependencies": {
+    "eslint": "^9.39.5"
   }
 }

package/scripts/tags/index.js

@@ -42,6 +42,7 @@ hexo.extend.tag.register('poetry', require('./lib/poetry')(hexo), true)
 hexo.extend.tag.register('quot', require('./lib/quot')(hexo))
 hexo.extend.tag.register('blockquote', require('./lib/blockquote')(hexo), true)
 hexo.extend.tag.register('hashtag', require('./lib/hashtag')(hexo))
+hexo.extend.tag.register('mbti', require('./lib/mbti')(hexo))
 hexo.extend.tag.register('okr', require('./lib/okr')(hexo), {ends: true})
 hexo.extend.tag.register('audio', require('./lib/audio')(hexo))
 hexo.extend.tag.register('video', require('./lib/video')(hexo))

package/scripts/tags/lib/mbti.js

@@ -0,0 +1,169 @@
+/**
+ * mbti.js v1 | https://github.com/xaoxuu/hexo-theme-stellar/
+ *
+ * {% mbti INTJ-T 93-72-78-83-51 [url:https://...] [image:src] %}
+ *
+ * - type: 人格类型代码（如 INTJ-T / INTJ，大小写均可），决定标题与配色
+ * - scores: 五个百分比，用 - 分隔，顺序固定为 energy-mind-nature-tactics-identity
+ * - url: 档案链接（可选，url:https://...），支持完整 URL 或纯档案 ID
+ * - image: 标题上方横幅图片地址（可选）
+ */
+
+'use strict';
+
+var TYPE_ROLES = {
+  INTJ: 'analyst',
+  INTP: 'analyst',
+  ENTJ: 'analyst',
+  ENTP: 'analyst',
+  INFJ: 'diplomat',
+  INFP: 'diplomat',
+  ENFJ: 'diplomat',
+  ENFP: 'diplomat',
+  ISTJ: 'sentinel',
+  ISFJ: 'sentinel',
+  ESTJ: 'sentinel',
+  ESFJ: 'sentinel',
+  ISTP: 'explorer',
+  ISFP: 'explorer',
+  ESTP: 'explorer',
+  ESFP: 'explorer'
+};
+
+var ROLE_COLORS = {
+  analyst: 'purple',
+  diplomat: 'green',
+  sentinel: 'blue',
+  explorer: 'yellow'
+};
+
+var TRAIT_KEYS = ['energy', 'mind', 'nature', 'tactics', 'identity'];
+
+var TRAIT_COLORS = {
+  energy: '#2196f3',
+  mind: '#FFBD2B',
+  nature: '#3DC550',
+  tactics: '#9c27b0',
+  identity: '#F44336'
+};
+
+// 根据类型代码推导每个维度的偏向侧（trait 侧）：E/I、N/S、T/F、J/P、A/T
+function getTraitSides(typeCode) {
+  var code = typeCode.replace('-', '');
+  var sides = {};
+  sides.energy = code.charAt(0) === 'E' ? 'left' : 'right';
+  sides.mind = code.charAt(1) === 'N' ? 'left' : 'right';
+  sides.nature = code.charAt(2) === 'T' ? 'left' : 'right';
+  sides.tactics = code.charAt(3) === 'J' ? 'left' : 'right';
+  if (code.charAt(4) === 'A') {
+    sides.identity = 'left';
+  } else if (code.charAt(4) === 'T') {
+    sides.identity = 'right';
+  } else {
+    sides.identity = 'left';
+    console.warn('[mbti] identity variant missing, default to Assertive (-A): ' + typeCode);
+  }
+  return sides;
+}
+
+function clamp(value) {
+  value = parseInt(value, 10);
+  if (isNaN(value)) {
+    value = 0;
+  }
+  return Math.max(0, Math.min(100, value));
+}
+
+function alphaHex(hex, alpha) {
+  var r = parseInt(hex.slice(1, 3), 16);
+  var g = parseInt(hex.slice(3, 5), 16);
+  var b = parseInt(hex.slice(5, 7), 16);
+  return 'rgba(' + r + ',' + g + ',' + b + ',' + alpha + ')';
+}
+
+module.exports = ctx => function(args) {
+  args = ctx.args.map(args, ['image', 'url'], ['type', 'scores']);
+
+  var typeCode = String(args.type || '').trim().toUpperCase();
+  if (!typeCode) {
+    console.error('[mbti] missing personality type');
+    return '';
+  }
+  var typeMatch = typeCode.match(/^([A-Z]{4})/);
+  var typeKey = typeMatch ? typeMatch[1] : null;
+  var role = typeKey ? TYPE_ROLES[typeKey] : null;
+  if (!role) {
+    console.warn('[mbti] unknown personality type: ' + typeCode);
+  }
+  var themeColor = role ? ROLE_COLORS[role] : '';
+
+  var __ = (this && typeof this.__ === 'function') ? this.__ : ctx.theme.i18n.__(ctx.config.language);
+  var typeName = typeKey ? __('tag_plugins.mbti.types.' + typeKey) : '';
+  if (!typeName || typeName.indexOf('tag_plugins.mbti.types.') === 0) {
+    typeName = typeCode;
+  }
+
+  var scoreParts = String(args.scores || '').split('-');
+  var pcts = [];
+  for (var i = 0; i < TRAIT_KEYS.length; i++) {
+    pcts.push(clamp(scoreParts[i]));
+  }
+
+  var url = args.url ? String(args.url).trim() : '';
+  if (url && !/^https?:\/\//i.test(url)) {
+    url = 'https://www.16personalities.com/ch/' + encodeURIComponent('档案') + '/' + url;
+  }
+  if (url) {
+    url = url.replace(/"/g, '&quot;');
+  }
+
+  var image = args.image ? String(args.image).trim() : '';
+  if (image) {
+    image = image.replace(/"/g, '&quot;');
+  }
+
+  var traitSides = getTraitSides(typeCode);
+
+  var el = '<div class="tag-plugin colorful note mbti"';
+  if (themeColor) {
+    el += ' color="' + themeColor + '"';
+  }
+  el += '>';
+  if (image) {
+    el += '<img class="mbti-image" src="' + image + '" alt="" />';
+  }
+  var title = __('tag_plugins.mbti.title', typeCode, typeName);
+  el += '<div class="mbti-title">';
+  if (url) {
+    el += '<a class="mbti-title-link" href="' + url + '" target="_blank" rel="external nofollow noopener noreferrer">' + title + '</a>';
+  } else {
+    el += '<span class="mbti-title-text">' + title + '</span>';
+  }
+  el += '</div>';
+  el += '<div class="mbti-body">';
+  el += '<div class="mbti-traits">';
+  for (var j = 0; j < TRAIT_KEYS.length; j++) {
+    var key = TRAIT_KEYS[j];
+    var left = __('tag_plugins.mbti.traits.' + key + '.left');
+    var right = __('tag_plugins.mbti.traits.' + key + '.right');
+    var pct = pcts[j];
+    // 官网规则：trait 在左端时 reverse=true，圆点位置 = reverse ? 100-pct : pct，高亮侧由圆点位置决定
+    var reverse = traitSides[key] === 'left';
+    var position = reverse ? 100 - pct : pct;
+    var activeSide = position <= 50 ? 'left' : 'right';
+    // 填充从主导侧（trait 侧）开始：trait 在右时 fill 右对齐
+    var reversed = traitSides[key] === 'right' ? ' reversed' : '';
+    el += '<div class="mbti-trait' + reversed + '" style="--theme:' + TRAIT_COLORS[key] + '; --theme-a30:' + alphaHex(TRAIT_COLORS[key], 0.3) + '">';
+    el += '<div class="mbti-labels">';
+    el += '<span class="mbti-label left' + (activeSide === 'left' ? ' active' : '') + '">' + left + (activeSide === 'left' ? ' <span class="pct">' + pct + '%</span>' : '') + '</span>';
+    el += '<span class="mbti-label right' + (activeSide === 'right' ? ' active' : '') + '">' + (activeSide === 'right' ? '<span class="pct">' + pct + '%</span> ' : '') + right + '</span>';
+    el += '</div>';
+    // fill 从主导侧端点延伸到圆点位置（宽度与圆点互补），保证填充末端与圆点对齐
+    el += '<div class="mbti-progress"><div class="fill" style="width:' + (100 - pct) + '%"></div><span class="mbti-dot" style="left:' + position + '%"></span></div>';
+    el += '</div>';
+  }
+  el += '</div>';
+  el += '</div>';
+  el += '</div>';
+  return el;
+};

package/source/css/_common/canonical.styl

@@ -2,6 +2,7 @@
   position: fixed
   display: flex
   text-align: center
+  border-radius: 8px
   bottom: 4rem
   left: 50%
   transform: translateX(-50%)
@@ -12,17 +13,15 @@
   box-shadow: 0 2px 8px rgba(black, .1), 0 4px 16px rgba(black, .1), 0 8px 32px rgba(black, .1)
   .headline
     font-size: $fsh2
-  a, button
-    border-radius: 6px
-    background: var(--bg-a100)
+    margin-bottom: .5rem
+  a
     display: block
     color: inherit
-    padding: 1rem
-    font-size: 1rem
-  button
-    padding: 0
-    width: 3rem
-    margin-left: 1px
+    padding: .75rem
+    font-size: $fs-14
+
+.canonical-tip.official
+  background-color: var(--bg-a100)
 
 .canonical-tip.unofficial
   background-color: hsl(5, 100%, 60%)
@@ -34,4 +33,4 @@
     50%
       background-color: hsl(5, 100%, 30%)
     100%
-      background-color: hsl(5, 100%, 60%)
+      background-color: hsl(5, 100%, 60%)

package/source/css/_common/device.styl

@@ -20,28 +20,31 @@
   display: flex
   justify-content: center
   flex-direction: column
-  border-radius: 64px
+  gap: $bar-item-gap
+  padding: $bar-item-gap
   @media screen and (min-width: $device-mobile-max)
     margin-right: 3rem
   overflow: hidden
   trans1: all
-  &:before,&:after
-    border-radius: 64px
 
-  newblur()
+  bar-glass()
 
 
 // 侧边栏弹出按钮
 .float-panel button
+  bar-item()
   cursor: pointer
   color: var(--text)
   background: none
-  width: 48px
-  height: 48px
+  box-sizing: border-box
+  width: 36px
+  height: 36px
+  padding: 4px
   line-height: 0
   font-size: 28px
-  margin: 0
   display: flex
+  justify-content: center
+  align-items: center
   >*
     path#sep
       trans1 transform
@@ -49,10 +52,8 @@
     height: 28px
 
 // 侧边栏弹出后
-.l_body[leftbar] .float-panel, .l_body[rightbar] .float-panel
-  box-shadow: 0 0 4px -1px var(--theme), 0 0 16px -4px var(--theme), 0 0 32px -12px var(--theme), 0 0 128px -32px var(--theme)
-  &:before
-    background: var(--bg-a50)
+.l_body[leftbar] .float-panel button.leftbar-toggle, .l_body[rightbar] .float-panel button.rightbar-toggle
+  bar-item-active()
 
 .l_body[leftbar] .float-panel button.leftbar-toggle
   color: var(--theme)
@@ -74,4 +75,3 @@
     fill-opacity: 0.3
     path#sep
       transform: translateX(2px)
-

package/source/css/_common/highlight.styl

@@ -14,7 +14,6 @@ p>code:not([class]),li>code:not([class])
   --theme: var(--text-p3)
   margin: var(--gap-p) 0
   border-radius: $border-card
-  corner-shape: superellipse(1.2)
   overflow: hidden
   background: var(--block)
   font-family: $ff-codeblock
@@ -80,7 +79,6 @@ p>code:not([class]),li>code:not([class])
   .gist-file 
     border: 1px solid var(--block-border)
     border-radius: $border-card
-    corner-shape: superellipse(1.2)
     overflow: hidden
   .gist-data
     --bgColor-default: var(--block)

package/source/css/_common/html.styl

@@ -1,5 +1,6 @@
 *
   outline: none
+  corner-shape: $corner-shape
 html
   height: 100%
   width: 100%
@@ -9,7 +10,7 @@ html
   font-size: $fs-root
   -webkit-text-size-adjust: 100%
   -ms-text-size-adjust: 100%
-  scroll-padding-top: 8px
+  scroll-padding-top: 0
 body
   background: var(--background)
   margin: 0

package/source/css/_common/svg.styl

@@ -6,4 +6,12 @@ svg.icon
   overflow: hidden
 
 svg.active-icon
-  color: var(--theme)
+  color: var(--theme)
+
+// 隐藏的 SVG 渐变定义容器（配合 --item-grad 与 fill:var(--item-grad) 使用）
+svg.grad-def
+  position: absolute
+  width: 0 !important
+  height: 0 !important
+  overflow: hidden
+  pointer-events: none