hexo-theme-stellar 1.42.0 → 1.42.1

package/.claude/skills/stellar-theme-dev/SKILL.md

@@ -38,6 +38,7 @@ description: 主题仓库（hexo-theme-stellar）开发全流程：方案 →
 - 任务完成后**不自动提交**：改动保留在工作区供用户审查。
 - 仅在用户明确要求提交时执行；提交前须通过第 3 步中应执行的验证。
 - 使用 Conventional Commits，一次提交对应一个需求点；如果几个需求任务逻辑相似，可以合并为一次提交；类型与格式见 `AGENTS.md`「Git 规范」（§7）。
+- 合并代码时，把合并提交 / PR 标题改为 Conventional Commits 格式（见 `AGENTS.md`「Git 规范」§7），不保留默认的 `Merge branch ...` / `Merge pull request ...` 标题。
 - 改动只提交在本仓库（stellar）；仅当用户明确要求时 push。
 - 完成条件：改动已通过应执行的验证并保留在工作区；如用户要求提交，提交符合规范；如用户要求 push，已推送且远端为最新。
 

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 1.42.1
+
+> 发布日期：2026-08-17
+
+### 修复
+- 图片懒加载过滤器在 HTML 压缩器（如 hexo-minify `removeAttributeQuotes`）去除属性引号后，原正则跨标签越界，把页尾 bootstrap 内联脚本里的 `s.src = "/js/utils.js?v=..."` 误改写为「1×1 PNG 占位 + `data-src`」，导致 bootstrap 语法错误、`stellar is not defined` 连锁报错、scrollreveal 不初始化、`.slide-up` 文章列表延迟约 3 秒才显示；改为属性感知标签扫描并跳过 `<script>`/`<style>`/注释区域，同时兼容无引号 `src` 的图片懒加载
+- bootstrap 的 utils 补载改用 `setAttribute('src')` 赋值，避免被基于 `s.src = "..."` 的朴素正则（图片懒加载 / 脚本延迟优化器）改写
+- `layout/_plugins/index.ejs` 增加 `stellar.initPlugin` 兜底注册点：bootstrap 被第三方优化器改写/移除时不再产生 `stellar is not defined` 连锁报错，插件仍可注册运行
+
+Full Changelog: [1.42.0...1.42.1](https://github.com/xaoxuu/hexo-theme-stellar/compare/1.42.0...1.42.1)
+
 ## 1.42.0
 
 > 发布日期：2026-08-16

package/_config.yml

@@ -1,6 +1,6 @@
 ######## Stellar info ########
 stellar:
-  version: '1.42.0'
+  version: '1.42.1'
   homepage: 'https://xaoxuu.com/wiki/stellar/'
   repo: 'https://github.com/xaoxuu/hexo-theme-stellar'
   main_css: /css/main.css
@@ -299,9 +299,9 @@ comments:
   # Waline
   # https://waline.js.org/
   waline:
-    js: https://gcore.jsdelivr.net/npm/@waline/client@3.1/dist/waline.js
-    css: https://gcore.jsdelivr.net/npm/@waline/client@3.1/dist/waline.css
-    meta_css: https://gcore.jsdelivr.net/npm/@waline/client@3.1/dist/waline-meta.css
+    js: https://gcore.jsdelivr.net/npm/@waline/client@3.15.2/dist/waline.js
+    css: https://gcore.jsdelivr.net/npm/@waline/client@3.15.2/dist/waline.css
+    meta_css: https://gcore.jsdelivr.net/npm/@waline/client@3.15.2/dist/waline-meta.css
     # Waline server address url, you should set this to your own link
     serverURL: https://waline.vercel.app
     # If false, comment count will only be displayed in post page, not in home page

package/layout/_partial/scripts/bootstrap.ejs

@@ -24,7 +24,9 @@
     if (typeof utils === 'object') return;
     // utils 未就绪时补载；加载成功后由 utils.js 内部补跑插件队列
     var s = document.createElement('script');
-    s.src = '<%- url_for('/js/utils.js') %>?v=<%- stellar_info('version') %>';
+    // 用 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）');

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hexo-theme-stellar",
-  "version": "1.42.0",
+  "version": "1.42.1",
   "description": "Elegant and powerful theme for Hexo.",
   "main": "package.json",
   "scripts": {

package/scripts/filters/lib/img_lazyload.js

@@ -1,56 +1,200 @@
 /**
- * img_lazyload.js v1 | https://github.com/xaoxuu/hexo-theme-stellar/
+ * img_lazyload.js v2 | https://github.com/xaoxuu/hexo-theme-stellar/
  *
+ * 懒加载强制开启：不再读取 enable 配置，no-lazy 是唯一例外。
+ * v2：改为属性感知的 <img> 标签解析，仅在标签自身范围内读取 src，
+ * 并跳过 <script>/<style>/<!-- --> 区域，避免与「去属性引号」的 HTML
+ * 压缩器（如 hexo-minify removeAttributeQuotes）组合时正则跨标签越界，
+ * 误改写页内内联脚本中的 `s.src = "..."`。
  */
 
-'use strict';
+"use strict";
 
-// 懒加载强制开启：不再读取 enable 配置，no-lazy 是唯一例外
-function lazyProcess(htmlContent) {
-  // 短路：无 <img 的页面（如 404）无需正则扫描
-  if (typeof htmlContent !== 'string' || !/<img/i.test(htmlContent)) {
-    return htmlContent;
+// 1×1 透明 PNG：懒加载占位图
+const LOADING_IMG =
+  "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAABGdBTUEAALGPC/xhBQAAADhlWElmTU0AKgAAAAgAAYdpAAQAAAABAAAAGgAAAAAAAqACAAQAAAABAAAAAaADAAQAAAABAAAAAQAAAADa6r/EAAAAC0lEQVQIHWNgAAIAAAUAAY27m/MAAAAASUVORK5CYII=";
+
+// 解析 <img ...> 标签内部属性，返回 [{name, value, raw, start, end}]
+function parseAttrs(inner) {
+  const attrs = [];
+  const re = /([^\s=/>]+)(?:\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s>]+)))?/g;
+  let m;
+  while ((m = re.exec(inner)) !== null) {
+    attrs.push({
+      name: m[1].toLowerCase(),
+      value: m[2] !== undefined ? m[2] : m[3] !== undefined ? m[3] : m[4] !== undefined ? m[4] : null,
+      raw: m[0],
+      start: m.index,
+      end: m.index + m[0].length,
+    });
+  }
+  return attrs;
+}
+
+// 处理单个 <img> 标签：加 lazy 类并替换 src 为占位图 + data-src
+function processImgTag(imgTag) {
+  // 快速跳过：整标签已含懒加载标记 / 原生 srcset / no-lazy（兼容压缩前后写法）
+  if (/data-src/gi.test(imgTag)) {
+    return imgTag;
+  }
+  if (/srcset=/gi.test(imgTag)) {
+    return imgTag;
+  }
+  if (/\bno-lazy\b/gi.test(imgTag)) {
+    return imgTag;
+  }
+
+  const selfClosing = /\/>$/.test(imgTag);
+  const inner = imgTag.slice(4, selfClosing ? imgTag.length - 2 : imgTag.length - 1);
+  const attrs = parseAttrs(inner);
+  const src = attrs.find((a) => a.name === "src");
+  // 无 src / 空 src / 已是占位图（data:image）时不处理
+  if (!src || src.value == null || src.value === "" || /^data:image/i.test(src.value)) {
+    return imgTag;
   }
-  return htmlContent.replace(/<img(.*?)src="(.*?)"(.*?)>/gi, function(imgTag, src_before, src_value, src_after) {
-    // 已由 tag 插件输出懒加载标记（data-src / data-srcset）的图片不重复处理
-    if (/data-src/gi.test(imgTag)) {
-      return imgTag;
+
+  const classAttr = attrs.find((a) => a.name === "class");
+  const oldClass = classAttr && classAttr.value != null ? classAttr.value : "";
+  const newClass = (oldClass ? oldClass + " " : "") + "lazy";
+
+  let out = "<img";
+  if (!classAttr) {
+    out += ' class="' + newClass + '"';
+  }
+  let pos = 0;
+  for (const a of attrs) {
+    out += inner.slice(pos, a.start);
+    if (a.name === "src") {
+      out += 'src="' + LOADING_IMG + '" data-src="' + src.value + '"';
+    } else if (a.name === "class") {
+      out += 'class="' + newClass + '"';
+    } else {
+      out += a.raw;
     }
-    // 使用 srcset 的图片交给浏览器原生处理，避免占位图与 srcset 冲突
-    if (/srcset=/gi.test(imgTag)) {
-      return imgTag;
+    pos = a.end;
+  }
+  out += inner.slice(pos);
+  out += selfClosing ? "/>" : ">";
+  return out;
+}
+
+// 查找标签结束位置（尊重属性值内的引号，避免把 > 截断进属性值）
+function findTagEnd(html, start) {
+  let j = start;
+  let quote = null;
+  while (j < html.length) {
+    const ch = html[j];
+    if (quote) {
+      if (ch === quote) {
+        quote = null;
+      }
+    } else if (ch === '"' || ch === "'") {
+      quote = ch;
+    } else if (ch === ">") {
+      return j;
     }
-    if (/src="data:image(.*?)/gi.test(imgTag)) {
-      return imgTag;
+    j++;
+  }
+  return -1;
+}
+
+function isTagBoundary(html, pos) {
+  if (pos >= html.length) {
+    return true;
+  }
+  const ch = html[pos];
+  return ch === " " || ch === "\t" || ch === "\n" || ch === "\r" || ch === ">" || ch === "/";
+}
+
+// 全页扫描：只在真实 <img> 标签上做懒加载，跳过脚本/样式/注释内容
+function processHtml(html) {
+  const parts = [];
+  let i = 0;
+  const n = html.length;
+  const lower = html.toLowerCase();
+  while (i < n) {
+    const ch = html[i];
+    if (ch !== "<") {
+      parts.push(ch);
+      i++;
+      continue;
     }
-    // no-lazy 兼容 `no-lazy` / `no-lazy=""` 两种写法
-    if (/\bno-lazy\b/gi.test(imgTag)) {
-      return imgTag;
+    // HTML 注释
+    if (html.startsWith("<!--", i)) {
+      const end = html.indexOf("-->", i);
+      if (end === -1) {
+        break;
+      }
+      parts.push(html.slice(i, end + 3));
+      i = end + 3;
+      continue;
     }
-    var newImgTag = imgTag;
-    if (newImgTag.includes(' class="') == false) {
-      newImgTag = newImgTag.slice(0,4) + ' class=""' + newImgTag.slice(4);
+    // <script>…</script>：整段跳过，避免误处理模板字符串/字符串里的 <img
+    if (lower.startsWith("<script", i) && isTagBoundary(html, i + 7)) {
+      const end = findTagEnd(html, i);
+      if (end === -1) {
+        break;
+      }
+      parts.push(html.slice(i, end + 1));
+      i = end + 1;
+      const close = lower.indexOf("</script", i);
+      if (close === -1) {
+        break;
+      }
+      const closeEnd = html.indexOf(">", close);
+      if (closeEnd === -1) {
+        break;
+      }
+      parts.push(html.slice(i, closeEnd + 1));
+      i = closeEnd + 1;
+      continue;
     }
-    // class 中增加 lazy
-    newImgTag = newImgTag.replace(/(.*?) class="(.*?)" (.*?)>/gi, function(ori, before, value, after){
-      var newClass = value;
-      if (newClass.length > 0) {
-        newClass += ' ';
-      }
-      newClass += 'lazy';
-      if (value) {
-        return ori.replace('class="' + value, 'class="' + newClass);
-      } else {
-        return ori.replace('class="', 'class="' + newClass);
+    // <style>…</style>：整段跳过
+    if (lower.startsWith("<style", i) && isTagBoundary(html, i + 6)) {
+      const end = findTagEnd(html, i);
+      if (end === -1) {
+        break;
       }
-    });
-    // 加载图
-    const loadingImg = 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAABGdBTUEAALGPC/xhBQAAADhlWElmTU0AKgAAAAgAAYdpAAQAAAABAAAAGgAAAAAAAqACAAQAAAABAAAAAaADAAQAAAABAAAAAQAAAADa6r/EAAAAC0lEQVQIHWNgAAIAAAUAAY27m/MAAAAASUVORK5CYII=';
-    newImgTag = newImgTag.replace(src_value, loadingImg + '" data-src="' + src_value);
-    return newImgTag;
-  });
+      parts.push(html.slice(i, end + 1));
+      i = end + 1;
+      const close = lower.indexOf("</style", i);
+      if (close === -1) {
+        break;
+      }
+      const closeEnd = html.indexOf(">", close);
+      if (closeEnd === -1) {
+        break;
+      }
+      parts.push(html.slice(i, closeEnd + 1));
+      i = closeEnd + 1;
+      continue;
+    }
+    // <img …>
+    if (lower.startsWith("<img", i) && isTagBoundary(html, i + 4)) {
+      const end = findTagEnd(html, i);
+      if (end === -1) {
+        break;
+      }
+      parts.push(processImgTag(html.slice(i, end + 1)));
+      i = end + 1;
+      continue;
+    }
+    parts.push(ch);
+    i++;
+  }
+  return parts.join("");
+}
+
+function lazyProcess(htmlContent) {
+  // 短路：无 <img 的页面（如 404）无需扫描
+  if (typeof htmlContent !== "string" || !/<img/i.test(htmlContent)) {
+    return htmlContent;
+  }
+  return processHtml(htmlContent);
 }
 
-module.exports.processSite = function(htmlContent) {
+module.exports.processSite = function (htmlContent) {
   return lazyProcess.call(this, htmlContent);
 };
+
+module.exports.lazyProcess = lazyProcess;

package/source/css/_components/widgets/ghrepo.styl

@@ -28,3 +28,7 @@
       display: grid
       grid-gap: 2px
       grid-template-columns: repeat(auto-fill, "calc((100% - 2 * %s) / 3)" % 2px)
+      .flex-row
+        min-width: 0
+        span
+          txt-ellipsis()

package/source/css/comments/waline.styl

@@ -1,3 +1,7 @@
+@import '../_defines/const'
+@import '../_custom'
+@import '../_defines/func'
+
 .cmt-body
   .wl-panel
     margin: 0.5em 0 !important
@@ -66,3 +70,23 @@
   :root:not([data-theme]) &
     @media (prefers-color-scheme: dark)
       ondark()
+
+// override
+.md-text .cmt-body.waline
+  p
+    font-size: var(--waline-font-size)
+    line-height: 1.5
+    margin: 0
+  .wl-reply-to *
+    line-height: 1.5
+  .wl-header label, .wl-input
+    font-size: 0.875em
+  .wl-editor
+    font-size: var(--waline-font-size)
+    font-family: $ff-body
+  .wl-content
+    .wl-emoji, .vemoji
+      height: 2.5em
+    img:not(.wl-emoji):not(.vemoji)
+      margin-top: 0.5em
+      margin-bottom: 0.5em