hexo-theme-stellar 1.40.0 → 1.41.0

package/CHANGELOG.md

@@ -1,5 +1,46 @@
 # Changelog
 
+## 1.41.0
+
+> 发布日期：2026-08-15
+
+### 新功能
+- 本地搜索：搜索结果按章节拆分展示，点击直达章节锚点，目标页自动高亮关键词（`?kw=` 定位）
+- 本地搜索：懒加载与缓存 TTL（`search.local_search.lazy_load` 默认开启、`cache_ttl` 默认 1 天）
+- navbar 未吸顶时采用卡片样式，吸顶后恢复玻璃效果
+- 文章末尾新增标签行（`article.tags`，默认开启）
+- 内容表格统一铺满滚动与圆角边框
+- 文章新增 AI 成分标签（front-matter `ai_label: manual | polished | generated | reviewed`，`article.ai_label` 配置文案与颜色，默认不渲染）
+
+### 修复
+- 移动端顶栏伸缩时 navbar 玻璃效果误消失
+- 导航激活指示改为纯 CSS 小圆点，修复异步图标替换引起的抖动/闪烁
+- 恢复标题锚点等页内链接平滑滚动
+- 评论表情面板图片不再误触发 fancybox 弹窗
+- 修正 toc 底部操作按钮分隔线选择器
+- 修复 artalk 邮件链接无法定位评论区
+- SEO 元数据修复：wiki 标题去重、`og:site_name`、JSON-LD 图片/描述回退、分页标题
+
+### 样式
+- 调整 navbar 与 float-panel 按钮尺寸与间距（40px、gap 4px、底部 inset ×1）
+
+### 性能
+- 按需加载与外置缓存优化，减小 html/css/js 体积
+- 图标按命名空间异步加载，首屏关键图标保持内联
+- 构建期脚本去重遍历与过滤器短路（generate 阶段优化）
+
+### 重构
+- 主题内置图标统一迁移到 `_data/icons.yml`
+- 图标键统一为语义化命名空间（`default:` / 标签名命名空间），消除 `solar:`、`ph:`、`bxs:` 前缀
+
+### 升级注意（配置变更与破坏性改动）
+- 新增 `article.tags`（默认 `true`）：文章末尾显示标签行，不需要时设为 `false`
+- 新增 `article.ai_label` 与 front-matter `ai_label` 字段：不设置时不渲染，历史文章零变化
+- 新增 `search.local_search.lazy_load`（默认 `true`）与 `cache_ttl`（默认 `86400`）
+- 破坏性变更：图标键为公开接口，`solar:*` 等旧前缀键已全部改名；站点若在 `source/_data/icons.yml` 覆盖或 `_config.stellar.yml` 引用旧键需同步改名（主工程已确认无此类覆盖）
+
+Full Changelog: [1.40.0...1.41.0](https://github.com/xaoxuu/hexo-theme-stellar/compare/1.40.0...1.41.0)
+
 ## 1.40.0
 
 > 发布日期：2026-08-14

package/_config.yml

@@ -1,6 +1,6 @@
 ######## Stellar info ########
 stellar:
-  version: '1.40.0'
+  version: '1.41.0'
   homepage: 'https://xaoxuu.com/wiki/stellar/'
   repo: 'https://github.com/xaoxuu/hexo-theme-stellar'
   main_css: /css/main.css
@@ -46,22 +46,22 @@ menubar:
     # url: 点击跳转到哪，支持相对路径和绝对路径
     # - id: post
     #   theme: '#1BCDFC'
-    #   icon: solar:documents-bold-duotone
+    #   icon: default:documents
     #   title: 博客
     #   url: /
     # - id: wiki
     #   theme: '#3DC550'
-    #   icon: solar:notebook-bookmark-bold-duotone
+    #   icon: example:notebook
     #   title: 文档
     #   url: /wiki/
     # - id: explore
     #   theme: '#FA6400'
-    #   icon: solar:planet-bold-duotone
+    #   icon: example:planet
     #   title: 探索
     #   url: /explore/
     # - id: social
     #   theme: '#F44336'
-    #   icon: solar:chat-square-like-bold-duotone
+    #   icon: example:chat
     #   title: 社交
     #   url: /friends/
 
@@ -159,7 +159,7 @@ notebook:
   auto_excerpt: 128
   # 可以为某个 tag 设定图标（显示在标签树中）。
   tagcons:
-    '': solar:hashtag-square-bold
+    '': quot:hashtag
   # 每页显示多少篇笔记。0 表示不分页，null 则 fallback 到 hexo 的配置。
   # 可以在笔记本 yaml 的 per_page 字段中覆盖此参数。
   per_page: null
@@ -197,6 +197,23 @@ article:
   # 分类颜色
   category_color:
     '探索号': '#f44336'
+  # 文章 AI 成分标签：front-matter 用 ai_label: manual / reviewed / polished / generated 标记，
+  # 未设置时取 default（为空则不显示）；文案由多语言系统提供（languages/*.yml 的 meta.ai_label.*），
+  # 此处配置各档文字颜色与可选 icon；文章页显示在顶部面包屑行最右（阅读时长右侧）
+  ai_label:
+    default:
+    manual:
+      color: '#03a9f4'
+      icon: default:shield-user
+    reviewed:
+      color: '#4caf50'
+      icon: default:shield-check
+    polished:
+      color: '#4caf50'
+      icon: default:shield-up
+    generated:
+      color: '#ff9800'
+      icon: default:shield-warning
   # 文章许可协议
   license: '本文采用 [署名-非商业性使用-相同方式共享 4.0 国际](https://creativecommons.org/licenses/by-nc-sa/4.0/) 许可协议，转载请注明出处。'
   # 分享
@@ -210,6 +227,8 @@ article:
   reading_time: false
   # 文章卡片是否显示标签（最多 5 个，#580）
   card_tags: false
+  # 文章末尾是否显示本文标签（位于 article-footer 之前）
+  tags: true
 
 search:
   service: local_search # local_search, algolia_search, todo...
@@ -217,6 +236,8 @@ search:
     field: all # post, page, all
     path: /search.json # 搜索文件存放位置
     content: true # 是否搜索内容
+    lazy_load: true # 懒加载：首次聚焦搜索框时才加载搜索数据（默认开启）；站点内容较多时建议关闭，防止首次搜索卡顿
+    cache_ttl: 86400 # 搜索数据缓存时长（秒），默认 1 天；设为 0 表示不缓存，建议按内容更新频率调整
     skip_search:  # 指定 path 中的内容不被搜索。
   algolia_search: # Docsearch https://docsearch.algolia.com/apply/ 申请
     appId: 
@@ -392,12 +413,12 @@ tag_plugins:
   # {% quot %}
   quot:
     default: # 可以自行配置多种图标方案，支持icons.yml中配置的图片key，也支持直接设置svg/png等文件链接
-      prefix: bxs:quote-left
-      suffix: bxs:quote-right
+      prefix: quot:quote-left
+      suffix: quot:quote-right
     hashtag:
-      prefix: solar:hashtag-square-bold
+      prefix: quot:hashtag
     question:
-      prefix: ph:seal-question-fill
+      prefix: quot:question
   # {% emoji %}
   emoji:
     default: https://gcore.jsdelivr.net/gh/cdn-x/emoticons@3.1/qq/{name}.gif
@@ -731,8 +752,10 @@ default:
   project: https://gcore.jsdelivr.net/gh/cdn-x/placeholder@1.0.12/image/2779789.png
   banner: https://gcore.jsdelivr.net/gh/cdn-x/placeholder@1.0.12/banner/books.jpg
   topic: https://gcore.jsdelivr.net/gh/cdn-x/placeholder@1.0.12/image/10433048.png
+  # loading 兼容回退：新值位于 _data/icons.yml（default:loading-placeholder）
   loading: https://api.iconify.design/eos-icons:three-dots-loading.svg?color=%231cd0fd
   # loading: https://github.githubassets.com/images/mona-loading-dark.gif
+  # image_onerror 兼容回退：新值位于 _data/icons.yml（image:onerror）
   image_onerror: "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='2rem' height='2rem' viewBox='0 0 24 24'%3E%3C!-- Icon from Solar by 480 Design - https://creativecommons.org/licenses/by/4.0/ --%3E%3Cpath fill='%23F44336' d='M22 12.698c-.002 1.47-.013 2.718-.096 3.743c-.097 1.19-.296 2.184-.74 3.009a4.2 4.2 0 0 1-.73.983c-.833.833-1.893 1.21-3.237 1.39C15.884 22 14.2 22 12.053 22h-.106c-2.148 0-3.83 0-5.144-.177c-1.343-.18-2.404-.557-3.236-1.39c-.738-.738-1.12-1.656-1.322-2.795c-.2-1.12-.236-2.512-.243-4.241Q1.999 12.737 2 12v-.054c0-2.148 0-3.83.177-5.144c.18-1.343.557-2.404 1.39-3.236s1.893-1.21 3.236-1.39c1.168-.157 2.67-.175 4.499-.177a.697.697 0 1 1 0 1.396c-1.855.002-3.234.018-4.313.163c-1.189.16-1.906.464-2.436.994S3.72 5.8 3.56 6.99C3.397 8.2 3.395 9.788 3.395 12v.784l.932-.814a2.14 2.14 0 0 1 2.922.097l3.99 3.99a1.86 1.86 0 0 0 2.385.207l.278-.195a2.79 2.79 0 0 1 3.471.209l2.633 2.37c.265-.557.423-1.288.507-2.32c.079-.972.09-2.152.091-3.63a.698.698 0 0 1 1.396 0' opacity='.5'/%3E%3Cpath fill='%23F44336' fill-rule='evenodd' d='M17.5 11c-2.121 0-3.182 0-3.841-.659S13 8.621 13 6.5s0-3.182.659-3.841S15.379 2 17.5 2s3.182 0 3.841.659S22 4.379 22 6.5s0 3.182-.659 3.841S19.621 11 17.5 11m-1.47-7.03a.75.75 0 1 0-1.06 1.06l1.47 1.47l-1.47 1.47a.75.75 0 0 0 1.06 1.06l1.47-1.47l1.47 1.47a.75.75 0 1 0 1.06-1.06L18.56 6.5l1.47-1.47a.75.75 0 0 0-1.06-1.06L17.5 5.44z' clip-rule='evenodd'/%3E%3C/svg%3E"
 
 api_host: