hexo-theme-stellar 1.39.1 → 1.41.0

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

@@ -29,11 +29,11 @@ description: 主题仓库（hexo-theme-stellar）开发全流程：方案 →
 命令按需执行：
 
 - `scripts/` 有改动 → 必须在主工程（xaoxuu.com）执行 `npm run g` 全量验证（已含 `hexo clean && hexo generate && npx gulp minify`）；`npm run s` 是按需渲染，不能替代。
-- 新增/修改纯函数 → 补充单测并跑 `npm run check`（lint + 单测 + 知识库硬事实核查）。
+- 新增/修改纯函数 → 补充单测并跑 `npm run check`（lint + 单测 + 依赖声明检查 + 知识库硬事实核查）。
 - 知识库有改动 → `python3 docs/knowledge/tools/verify.py` 硬事实核查。
 - UI 方面（样式、模板、前端交互等）改动量不大时无需自检流程，除非用户明确要求。
 - 检查所有受影响页面类型（首页、文章页、Wiki 页等），验证结果记录在方案目录 `checklist.md`。
-- 完成条件：应执行的命令全部通过；首页、文章页、Wiki 页等受影响页面类型均检查通过。
+- 完成条件：应执行的命令全部通过；新增 `require` 均已声明或为 Node 内置模块（test/ 禁止幽灵依赖）；首页、文章页、Wiki 页等受影响页面类型均检查通过。
 
 ### 4. 提交
 

package/CHANGELOG.md

@@ -1,5 +1,75 @@
 # 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
+
+### 新功能
+- 文章页新增字数与预计阅读时长显示（`article.reading_time`，默认关闭）
+- 文章卡片新增标签展示（最多 5 个，`article.card_tags`，默认关闭）
+- 新增表格标签 `{% table style:scroll|wrap|compact %}`，支持滚动/换行/紧凑三种表格样式
+- 新增气泡注解标签 `{% tip text:... %}词句{% endtip %}`，桌面 hover、移动端点击显示
+- 远程 Markdown 渲染抽象：`{% md %}` 标签新增可选 `wrap` 参数；wiki 项目配置 `repo` 后可直接以仓库 README 作为首页正文
+
+### 修复
+- wiki 项目描述作为页面描述（OG / JSON-LD）的兜底，修复 SEO 描述缺失的问题
+- 声明 hexo-pagination / hexo-util 依赖并新增依赖声明检查门禁，修复幽灵依赖导致的构建问题
+- 时间线节点标题（header）不再渲染 markdown 的问题（#401）
+- 分类页三级及以上分类无法正确展示的问题，改为基于 parent 递归构建嵌套树（#564）
+- 亮暗切换后 topbar 与左栏颜色不同步的问题：navbar/sidebar 暗色样式统一跟随 `data-theme` 开关（#593、#663）
+- iOS Safari 下右下角悬浮控件在玻璃椭圆框中不对齐的问题（#599）
+- artalk 邮件通知链接携带 `?atk_*` 参数导致目录定位失效的问题（#598）
+- waline 最近评论接口返回结构兼容（数组 / `{ data: [...] }`）（#630）
+- memos 新版 v1 接口识别与渲染适配，识别失败仍回退 feature 兜底（#668）
+- new-note 命令生成 front-matter 的 date 对齐为 `YYYY-MM-DD HH:mm`（#594）
+
+### 升级注意（配置变更与破坏性改动）
+- 新增 `article.reading_time`（默认 `false`）与 `article.card_tags`（默认 `false`），需要时设为 `true`
+- 新增 `table`、`tip` 两个标签插件；`table` 默认使用 `scroll` 样式
+
+Full Changelog: [1.39.1...1.40.0](https://github.com/xaoxuu/hexo-theme-stellar/compare/1.39.1...1.40.0)
+
 ## 1.39.1
 
 > 发布日期：2026-08-13

package/_config.yml

@@ -1,6 +1,6 @@
 ######## Stellar info ########
 stellar:
-  version: '1.39.1'
+  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/) 许可协议，转载请注明出处。'
   # 分享
@@ -206,6 +223,12 @@ article:
   related_posts:
     enable: false
     max_count: 5
+  # 文章页是否显示字数和预计阅读时长（#302）
+  reading_time: false
+  # 文章卡片是否显示标签（最多 5 个，#580）
+  card_tags: false
+  # 文章末尾是否显示本文标签（位于 article-footer 之前）
+  tags: true
 
 search:
   service: local_search # local_search, algolia_search, todo...
@@ -213,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: 
@@ -388,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
@@ -676,7 +701,7 @@ style:
     image-l: 24px # 非技术类文章插图圆角
     image: 16px # 技术类文章插图圆角
     image-s: 8px # 评论区图片圆角（部分评论支持）
-  corner-shape: superellipse(1.5) # 连续曲率圆角（仅 Chromium 139+ 支持，其余浏览器自动回退普通圆角）：superellipse(1.x) 开启，round 关闭
+  corner-shape: superellipse(1.25) # 连续曲率圆角（仅 Chromium 139+ 支持，其余浏览器自动回退普通圆角）：superellipse(1.x) 开启，round 关闭
   color:
     # 主题色配置（不会根据明暗动态调整，请设置为通用的颜色）
     theme: 'hsl(192 98% 55%)' # 主题色
@@ -727,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: