hexo-theme-stellar 2.0.0-rc.5 → 2.0.0

package/CHANGELOG.md

@@ -1,5 +1,71 @@
 # Changelog
 
+## 2.0.0
+
+> 发布日期：2026-09-30
+
+### 新功能
+
+- 配置、Collection YAML 与页面 Front Matter 采用声明式严格 Schema，字段类型、枚举与未知字段在构建前由 Doctor 报告来源与字段路径。
+- Post、Topic、Wiki、Notebook、Note 与索引页共用同一内容模型与构建管线；`listed/searchable` 分别控制聚合展示与搜索收录，Article 与 Notebook 的列表、横幅、许可、分享、标签和排序默认值收敛到内容模型。
+- 页面外壳统一为 Topbar、Leftbar、Rightbar Region，Brand、Menu、Widget、Footer 和 13 个 Profile 使用结构化配置与明确的覆盖语义；Leftbar 菜单支持 1–5 列，Tree、Linklist、Related 与右栏目录支持折叠，右栏随左栏收起显示紧凑目录。
+- 新增 `card/glass/minimal/flat` 外观预设、明暗模式切换、颜色／渐变／排版／形状／背景设置，以及独立设置页。
+- 浏览器功能改为原生 ES 模块按需加载，搜索、评论、动态效果、数据服务与请求缓存拥有明确的加载、取消与卸载生命周期；共享脚本、样式与图标不再逐页内联。
+- 搜索改为注册式 provider（内置 `local` 与 `algolia`），入口位于 Leftbar Brand；本地搜索按章节组织结果并分批查询、渲染，浮层带开合转场与滚动条槽位补位，支持 `Command+K` / `Ctrl+K`。
+- Wiki Hero 支持图片与视频背景、滚动视差，以及 `galaxy`、`light-rays`、`ferrofluid`、`Strands` 可选效果；标签目录新增 `gist`。
+- 图片在 `hexo server` / `hexo generate` 时增量提取尺寸与 HSLA 平均色并持久缓存，补全生成 HTML 且不修改 Markdown 或原图；新增 `hexo stellar images`（含 `--dry-run/--page/--refresh`）。
+- 新增 `hexo stellar doctor` 与 `hexo stellar new note`；目录驱动的完整 Blueprint 改由 Stellar Examples 仓库维护。
+- 文章横幅背景、访客头像镜像 `services.gravatar.base_url`、Reveal 的 `duration/interval/distance/blur` 与卡片 Spotlight／Tilt 均可独立配置。
+
+### 行为与样式变化
+
+- 内容横幅与列表共用页面 `cover`；`article.banner.background`（默认 `true`）与 Front Matter `banner.background: false` 控制内容页横幅是否使用封面作为背景，关闭时只影响内容页，列表卡片、SEO 与分享仍使用 `cover`。博客列表页附加导航默认开启。
+- 笔记本总索引卡片复用 Wiki 卡片的封面与项目栏视觉：`listing.cover` 作为封面、`listing.headline` 只取显式配置的大标题、`listing.caption` 作为项目副标题，未配置封面时降级为纯色卡片。
+- 正文图片统一 `max-width: 100%` 与 `height: auto`，按原图比例约束高度；图片元数据只采集会被主题消费的图片，分享二维码、评论、侧边栏与页脚等页面框架图片不触发下载或写入缓存。
+- 侧栏集合、Navbar、Dropdown、Grid、文章卡片、下载按钮与 Topbar 对齐改用统一的形状与状态反馈；设置页、单选框、标题装饰、导航下划线、目录指示条与移动端留白一并收敛。
+- 运行环境升级为 Node.js 22+、Hexo 8+；源码读取兼容 Windows CRLF 与 BOM，避免 Front Matter 整体丢失。
+
+### 升级注意（配置变更与破坏性改动）
+
+- v1 的 `logo/menubar/site_tree/style/tag_plugins/plugins/data_services/search.service` 等结构不会被兼容读取；请按[公开迁移说明](https://xaoxuu.com/wiki/stellar/migration/v1-to-v2/)逐项迁移到 `topbar/leftbar/rightbar/footer/profiles/appearance/tags/features/services/search`。
+- Collection 与 Front Matter 需要迁移为 `collection/route/navigation/listing/visibility/banner/article/comments/render/seo` 等分组字段；页面 `banner.image` 改为顶层 `cover`，横幅不再使用独立比例配置。未知字段、错误类型与非法枚举会在构建早期失败。
+- 分享服务由 `[wechat, weibo, email, link]` 改为 `qrcode/weibo/x/telegram/whatsapp/email`，配置位置为 `article.footer.share` 或内容 `footer.share`。
+- `plugins.card_hover.enable` 改为独立的 `features.card_hover.spotlight` 与 `features.card_hover.tilt`，默认均为 `false`；`plugins.adaptive_text` 改为固定开启的内置行为。
+- Site Info、Rating、Vote 的服务 endpoint 默认留空，需要自行部署并填写地址；依赖这些服务的站点升级后请显式配置。
+- `features.partial_navigation.enabled` 与 `features.image_optimization.enabled` 默认开启，首次处理远程图片会增加构建时间；Hero 背景默认启用 0.2 强度视差，设为 0 关闭位移。
+- `about`、`users` 标签以及对应的 `chat_users.yml`、`fcircle` 适配器已移除；`tip` 改为单标签 `{% tip 词句 pop:注解 %}`，`quot` 支持直接图标键与 `color`。
+- 博客列表页附加导航 `profiles.blog_index.listing_nav.enabled` 默认开启；语言文件不再使用 `settings.profile.provider_managed` 与 `settings.profile.provider_unknown`。
+- 浏览器后处理必须原样保留 `public/js/runtime/**/*.js` 的 ESM 语义、相对 import 与 JavaScript MIME 类型。
+- v2 源码从仓库 `main` 安装并需要执行 `npm install --prefix themes/stellar`；npm 安装的版本以实际公开版本为准。
+
+Full Changelog: [1.44.0...2.0.0](https://github.com/xaoxuu/hexo-theme-stellar/compare/1.44.0...2.0.0)
+
+## 2.0.0-rc.6
+
+> 发布日期：2026-09-18
+
+本节记录从公开候选 `2.0.0-rc.5` 到 `2.0.0-rc.6` 最终文件树的净变化。
+
+### 新功能
+
+- Wiki Hero 新增视频背景 `hero.background.video`，静音循环自动播放，图片可用作 poster；设置视频时不加载动态效果。
+- Hero 新增滚动视差 `hero.background.parallax`，范围 0–1、默认 0.2，设为 0 关闭位移；图片与视频背景随滚动淡出，减少动态效果偏好下关闭视差位移。
+- 新增 Strands WebGL 背景效果，支持光带配色、形态、发光及玻璃折射参数。
+- Leftbar 新增 `menu_columns`，支持 1–5 列，默认 1；1–2 列显示图标与标题，3–5 列仅显示图标并保留无障碍名称。支持 Profile、Collection、Page 覆盖。
+- 新增 `services.gravatar.base_url`，侧栏与设置页共享访客头像镜像地址，默认 `https://gravatar.com/avatar/`；自定义服务需兼容 SHA-256 并包含 `/avatar/` 路径。
+
+### 修复与改进
+
+- 同集合页面切换等待超过 150ms 时显示加载反馈，完成、失败或取消后清理，快速切换不闪烁。
+- 修复目录活动指示条在 CSS 压缩后高度丢失的问题。
+- 中英文安装说明补充 Windows PowerShell Blueprint 安装命令。
+
+### 升级注意
+
+- 现有 Hero 背景默认启用 0.2 强度视差；如需关闭位移，显式设置 `hero.background.parallax: 0`。
+
+Full Changelog: [2.0.0-rc.5...2.0.0-rc.6](https://github.com/xaoxuu/hexo-theme-stellar/compare/2.0.0-rc.5...2.0.0-rc.6)
+
 ## 2.0.0-rc.5
 
 > 发布日期：2026-09-12

package/README.md

@@ -49,10 +49,18 @@
 
 准备好 Git 和 npm 后，一条命令即可启动交互式蓝图安装器：
 
+macOS / Linux：
+
 ```bash
 sh -c "$(curl -fsSL https://github.com/xaoxuu/hexo-theme-stellar-examples/raw/main/install.sh)"
 ```
 
+Windows PowerShell 7+（`pwsh`）：
+
+```powershell
+& ([scriptblock]::Create((Invoke-RestMethod https://github.com/xaoxuu/hexo-theme-stellar-examples/raw/main/install.ps1)))
+```
+
 安装器会读取示例仓库的 [`blueprints.json`](https://github.com/xaoxuu/hexo-theme-stellar-examples/blob/main/blueprints.json)，展示当前可用的蓝图，并依次确认蓝图、项目目录、依赖安装和创建计划。
 
 ### 从 npm 安装

package/README_EN.md

@@ -49,10 +49,18 @@ Your writing preserves ideas while external data stays current. Remote content,
 
 With Git and npm available, launch the interactive Blueprint installer with one command:
 
+macOS / Linux:
+
 ```bash
 sh -c "$(curl -fsSL https://github.com/xaoxuu/hexo-theme-stellar-examples/raw/main/install.sh)"
 ```
 
+Windows PowerShell 7+ (`pwsh`):
+
+```powershell
+& ([scriptblock]::Create((Invoke-RestMethod https://github.com/xaoxuu/hexo-theme-stellar-examples/raw/main/install.ps1)))
+```
+
 The installer reads the example repository's [`blueprints.json`](https://github.com/xaoxuu/hexo-theme-stellar-examples/blob/main/blueprints.json), presents the available Blueprints, then confirms the Blueprint, project directory, dependency installation, and creation plan.
 
 ### Install from npm

package/_config.yml

@@ -58,6 +58,8 @@ leftbar:
     tagline: null
     # 设置品牌链接。
     href: /
+  # 设置 Leftbar 菜单列数（1–5）；1–2 列显示图标与标题，3–5 列仅显示居中的图标。
+  menu_columns: 1
   # 设置 Leftbar 菜单项；数组会整体替换，空数组表示不显示菜单项。
   menu:
     # 声明默认的博客入口。
@@ -208,7 +210,7 @@ profiles:
     # 配置博客列表页的附加导航。
     listing_nav:
       # 控制是否显示附加导航。
-      enabled: false
+      enabled: true
       # 设置附加导航标签；空数组表示不添加标签。
       tabs: []
 
@@ -458,6 +460,11 @@ article:
   style: tech
   # 设置段落首行缩进策略；可选值为 auto、always 或 never。
   paragraph_indent: auto
+  # 配置文章页顶部横幅。
+  banner:
+    # 控制文章页横幅是否使用页面 cover 作为背景图；false 表示只显示纯色横幅。
+    # 可在文章 Front Matter 用 banner.background 覆盖此默认值。
+    background: true
   # 配置文章列表卡片。
   listing:
     # 设置置顶文章布局；可选值为 carousel 或 flat。
@@ -930,6 +937,10 @@ features:
 
 # 配置主题使用的数据服务。
 services:
+  # 配置访客身份头像使用的 Gravatar 服务（侧边栏与设置页共享）。
+  gravatar:
+    # 设置兼容 SHA-256 的头像镜像地址，包含 /avatar/ 路径；末尾斜杠可省略。
+    base_url: https://gravatar.com/avatar/
   # 配置所有动态 Markdown 内容共享的 Marked 客户端。
   markdown:
     # 自定义脚本地址；null 使用默认资源。

package/languages/en.yml

@@ -98,8 +98,6 @@ settings:
     url: URL
     save: Save
     logout: Log out
-    provider_managed: '%s manages comment identity outside the theme. Profile editing and logout are unavailable here.'
-    provider_unknown: The current comment provider
   cache:
     title: Cache
     search: Search cache

package/languages/zh-CN.yml

@@ -98,8 +98,6 @@ settings:
     url: URL
     save: 保存
     logout: 退出登录
-    provider_managed: '%s 的评论身份不由主题管理，无法在此编辑或退出。'
-    provider_unknown: 当前评论服务
   cache:
     title: 缓存
     search: 搜索缓存

package/languages/zh-TW.yml

@@ -98,8 +98,6 @@ settings:
     url: URL
     save: 儲存
     logout: 登出
-    provider_managed: '%s 的留言身分不由主題管理，無法在此編輯或登出。'
-    provider_unknown: 目前留言服務
   cache:
     title: 快取
     search: 搜尋快取

package/layout/_partial/cover/wiki_cover.ejs

@@ -13,6 +13,7 @@ function layoutWikiCover() {
   }
   var backgroundConfig = cover.background || {};
   var background = typeof backgroundConfig.image === 'string' && backgroundConfig.image.length > 0 ? backgroundConfig.image : '';
+  var video = typeof backgroundConfig.video === 'string' ? backgroundConfig.video.trim() : '';
   var effect = backgroundConfig.effect || {};
   var preview = cover.preview || {};
   var commands = Array.isArray(preview.commands) ? preview.commands.filter(function (item) {
@@ -25,7 +26,7 @@ function layoutWikiCover() {
   var actions = Array.isArray(cover.actions) ? cover.actions.filter(function (item) {
     return item && item.title && item.url;
   }) : [];
-  var hasEffect = typeof effect.type === 'string' && effect.type.length > 0;
+  var hasEffect = !video && typeof effect.type === 'string' && effect.type.length > 0;
   var isImageBackground = background.length > 0;
   var effectOptions = effect.options && typeof effect.options === 'object' && !Array.isArray(effect.options) ? effect.options : {};
   var effectRuntime = effect.runtime && typeof effect.runtime === 'object' && !Array.isArray(effect.runtime) ? effect.runtime : {};
@@ -37,18 +38,23 @@ function layoutWikiCover() {
   var effectRuntimeJson = escape_html(JSON.stringify(effectRuntime));
   var projectName = cover.projectName;
   var adaptiveTextAttr = '';
-  if (isImageBackground) {
+  if (video) {
+    adaptiveTextAttr = ' data-text-adaptive="split" style="--adaptive-background:#000000"';
+  } else if (isImageBackground) {
     adaptiveTextAttr = ' data-text-adaptive="split" style="--cover-url:url(\'' + escape_html(background.replace(/'/g, '%27')) + '\')"';
   } else if (hasEffect) {
     adaptiveTextAttr = ' data-text-adaptive="split" style="--adaptive-background:' + escape_html(effectBackground) + '"';
   }
 
   el += '<div class="cover-content wiki wiki-hero' + (hasPreview ? '' : ' without-preview') + '">';
-  el += '<div class="wiki-cover-background' + (hasEffect ? ' has-effect' : '') + (respectsReducedMotion ? ' respect-reduced-motion' : '') + (isImageBackground ? ' image' : '') + '"' + (hasEffect ? ' style="--hero-effect-background:' + escape_html(effectBackground) + '"' : '') + ' aria-hidden="true">';
+  el += '<div class="wiki-cover-background' + (hasEffect ? ' has-effect' : '') + (respectsReducedMotion ? ' respect-reduced-motion' : '') + (isImageBackground ? ' image' : '') + (video ? ' has-video' : '') + '" data-parallax="' + escape_html(String(backgroundConfig.parallax)) + '"' + (hasEffect ? ' style="--hero-effect-background:' + escape_html(effectBackground) + '"' : '') + ' aria-hidden="true">';
   if (isImageBackground) {
     el += '<img class="wiki-cover-background-image" src="' + escape_html(background) + '" alt="" />';
     el += '<img class="wiki-cover-background-blur" src="' + escape_html(background) + '" alt="" />';
   }
+  if (video) {
+    el += '<video class="wiki-cover-background-video" src="' + escape_html(video) + '"' + (isImageBackground ? ' poster="' + escape_html(background) + '"' : '') + ' autoplay muted loop playsinline preload="metadata" disablepictureinpicture tabindex="-1"></video>';
+  }
   if (hasEffect) {
     el += '<canvas data-hero-effect="' + escape_html(effect.type) + '" data-effect-resource="' + effectResourceJson + '" data-effect-options="' + effectOptionsJson + '" data-effect-runtime="' + effectRuntimeJson + '"></canvas>';
   }

package/layout/_partial/main/navbar/article_banner.ejs

@@ -18,6 +18,15 @@ var banner = Object.assign({}, page.author
     : postViewModel ? postViewModel.item.presentation.banner : pageConfig.banner || {})
 
 var bannerImage = page.author ? page.author.cover : renderViewModel ? renderViewModel.item.cover : pageConfig.cover
+// 横幅背景图由 Front Matter banner.background 覆盖全局默认值；作者页不受全局开关影响。
+// 关闭时仅影响内容页横幅，列表卡片、SEO 与分享仍使用 cover。
+var bannerBackground = banner.background
+if (bannerBackground == null && !page.author) {
+  bannerBackground = stellar_config('article.banner.background')
+}
+if (bannerBackground === false) {
+  bannerImage = ''
+}
 
 // 标题
 if (banner.headline == null) {

package/layout/_partial/main/notebook/notebook_card.ejs

@@ -1,17 +1,37 @@
-<%# 笔记本信息卡片 %>
+<%# 笔记本卡片：复用 Wiki 卡片的 .wiki-card 视觉（cover 同图模糊层、底部信息层与项目栏） %>
 <% var listing = render.listing %>
-<article class="md-text">
-  <div class="preview">
-    <% if (listing.icon) { %>
-      <img src="<%= listing.icon %>" alt="icon"/>
-    <% } else { %>
-      <%- icon('default:documents') %>
-    <% } %>
-  </div>
-  <div class="excerpt">
-    <h2 class="post-title"><%= listing.headline || listing.name %></h2>
-    <% if (listing.description) { %>
-      <p><%= listing.description %></p>
+<% var cover = listing.cover || '' %>
+<% var headline = listing.headline || '' %>
+<% var caption = listing.caption || '' %>
+<%# 整个属性必须原样输出：EJS 转义输出会把属性里的引号变成实体，属性值带上一对引号，自适应颜色就失效 %>
+<% var adaptiveAttr = cover ? ' data-text-adaptive="split"' : '' %>
+<article class="wiki-card-content">
+  <div class="wiki-card-cover<%= cover ? '' : ' no-cover' %>" position="bottom">
+    <% if (cover) { %>
+      <img src="<%= cover %>" alt=""/>
     <% } %>
+    <div class="wiki-card-info" position="bottom"<%- adaptiveAttr %>>
+      <%# headline 是可选的大标题，只在显式配置时渲染；name 固定在底部项目栏 %>
+      <% if (headline) { %>
+      <div class="wiki-card-summary">
+        <h2 class="headline"><%= headline %></h2>
+      </div>
+      <% } %>
+      <div class="wiki-project">
+        <div class="project-icon">
+          <% if (listing.icon) { %>
+            <img src="<%= listing.icon %>" alt=""/>
+          <% } else { %>
+            <%- icon('default:documents') %>
+          <% } %>
+        </div>
+        <div class="project-text">
+          <div class="project-name"><%= listing.name %></div>
+          <% if (caption) { %>
+            <div class="project-subtitle"><%= caption %></div>
+          <% } %>
+        </div>
+      </div>
+    </div>
   </div>
 </article>

package/layout/_partial/primitives/navigation.ejs

@@ -5,8 +5,9 @@ if (!allowedPlacements.includes(placement)) {
 }
 var navigationItems = Array.isArray(entries) ? entries : []
 var navigationBody = partial('_partial/components/collection', {options: {
-  layout: 'list',
-  variant: 'nav',
+  layout: placement === 'leftbar' && typeof columns !== 'undefined' && columns > 1 ? 'grid' : 'list',
+  columns: typeof columns !== 'undefined' ? columns : 1,
+  variant: placement === 'leftbar' && typeof columns !== 'undefined' && columns > 2 ? 'icon' : 'nav',
   items: navigationItems
 }})
 var html = ''

package/layout/_partial/regions/widgets.ejs

@@ -69,7 +69,7 @@ function stack(items, zone, options) {
     <% if (leftbarBrandBody.trim().length > 0) { %><div class="widget-instance widget-instance--brand" data-widget-id="leftbar:fixed:brand" data-presentation="leftbar" data-leftbar-rail><%- leftbarBrandBody %></div><% } %>
   </header>
   <div class="site-region__body site-region__zone site-region__zone--body">
-    <% if (menuItems.length > 0) { %><div class="widget-instance widget-instance--menu" data-widget-id="leftbar:fixed:menu" data-presentation="leftbar" data-leftbar-rail><%- partial('../sidebar/menu', {where: 'leftbar', menu: menuItems, activeMenu: activeViewModel?.item.navigation.menu, viewModel: activeViewModel}) %></div><% } %>
+    <% if (menuItems.length > 0) { %><div class="widget-instance widget-instance--menu" data-widget-id="leftbar:fixed:menu" data-presentation="leftbar" data-leftbar-rail><%- partial('../sidebar/menu', {where: 'leftbar', menu: menuItems, menuColumns: regionState.menuColumns, activeMenu: activeViewModel?.item.navigation.menu, viewModel: activeViewModel}) %></div><% } %>
     <%- stack(regionWidgets, 'body') %>
   </div>
   <footer class="site-region__footer">

package/layout/_partial/sidebar/menu.ejs

@@ -9,6 +9,7 @@ function layoutDiv() {
     var pathMenu = menu_active_by_path(page.path, menuItems)
     if (pathMenu != null) currentMenu = pathMenu
   }
+  var iconLayout = where === 'leftbar' && typeof menuColumns !== 'undefined' && menuColumns > 2
   var entries = []
   for (var menuItem of menuItems) {
     if (menuItem == null || menuItem.id == null || menuItem.url == null || menuItem.title == null) {
@@ -18,6 +19,7 @@ function layoutDiv() {
       href: pretty_url(menuItem.url),
       title: __(menuItem.title),
       icon: menuItem.icon,
+      attrs: iconLayout ? {'aria-label': __(menuItem.title)} : {},
       theme: menuItem.accent,
       active: menuItem.id == currentMenu,
       className: menuItem.accent?.length > 0 ? 'is-themed' : ''
@@ -25,6 +27,7 @@ function layoutDiv() {
   }
   return partial('_partial/primitives/navigation', {
     placement: ['main', 'topbar', 'rightbar'].includes(where) ? where : 'leftbar',
+    columns: where === 'leftbar' && typeof menuColumns !== 'undefined' ? menuColumns : 1,
     entries: entries
   })
 }

package/layout/notebooks.ejs

@@ -1,10 +1,12 @@
-<%# 笔记本列表页主体部分 %>
-<% for (var notebook of page.notebookIndex.items) { %>
-  <div class="post-list wiki">
+<%# 笔记本列表页主体部分：复用 Wiki 列表的网格与卡片组件 %>
+<div class="post-list wiki">
+  <% for (var notebook of page.notebookIndex.items) { %>
+    <% var cover = notebook.cover || '' %>
+    <% var coverStyle = cover ? ` style="--cover-url:url('${escape_html(cover.replace(/'/g, '%27'))}')"` : '' %>
     <div class="post-card-wrap<%= scrollreveal(' ') %>">
-    <a class="<%- ui_classes('post-card wiki', 'hoverCard') %>" href="<%= pretty_url(notebook.href) %>">
+    <a class="<%- ui_classes('wiki-card', 'hoverCard', cover ? '' : 'no-cover') %>"<%- coverStyle %> href="<%= pretty_url(notebook.href) %>">
       <%- include('_partial/main/notebook/notebook_card', { render: {listing: notebook} }) %>
     </a>
     </div>
-  </div>
-<% } %>
+  <% } %>
+</div>

package/layout/settings.ejs

@@ -29,6 +29,7 @@ function linkAttributes(url) {
     <h1><%- escape_html(__('settings.title')) %></h1>
   </header>
 
+  <% if (providerSupported) { %>
   <section class="settings-section" aria-labelledby="settings-profile">
     <h2 id="settings-profile"><%- escape_html(__('settings.profile.title')) %></h2>
     <div class="settings-section__body">
@@ -38,9 +39,6 @@ function linkAttributes(url) {
           <span data-profile-avatar-fallback hidden><%- icon('default:profile', '', true) %></span>
         </div>
         <div class="settings-profile__content">
-          <% if (!providerSupported) { %>
-          <p data-provider-note class="settings-provider-note"><%- escape_html(__('settings.profile.provider_managed', provider || __('settings.profile.provider_unknown'))) %></p>
-          <% } else { %>
           <form data-profile-form class="settings-form" novalidate>
             <label>
               <span><%- escape_html(__('settings.profile.nickname')) %></span>
@@ -60,11 +58,11 @@ function linkAttributes(url) {
             </div>
           </form>
           <p class="settings-result" data-profile-status role="status" aria-live="polite"></p>
-          <% } %>
         </div>
       </div>
     </div>
   </section>
+  <% } %>
 
   <section class="settings-section" aria-labelledby="settings-cache">
     <h2 id="settings-cache"><%- escape_html(__('settings.cache.title')) %></h2>

package/legal/THIRD-PARTY-NOTICES.md

@@ -5,10 +5,10 @@ This project includes or adapts portions of the following third-party software.
 ## React Bits
 
 - Project: [React Bits](https://github.com/DavidHDev/react-bits)
-- Components: Ferrofluid, Galaxy and Spotlight Card
+- Components: Ferrofluid, Galaxy, Strands and Spotlight Card
 - License: MIT
 - Copyright: Copyright (c) 2026 David Haz
-- Usage: Adapted for the Wiki Ferrofluid and Galaxy WebGL backgrounds and Card Hover spotlight layer.
+- Usage: Adapted for the Wiki Ferrofluid, Galaxy and Strands WebGL backgrounds and Card Hover spotlight layer.
 
 ### MIT License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hexo-theme-stellar",
-  "version": "2.0.0-rc.5",
+  "version": "2.0.0",
   "description": "An all-in-one Hexo theme for blogs, project documentation, knowledge bases, series, and notebooks.",
   "main": "package.json",
   "scripts": {

package/scripts/events/lib/notebooks.js

@@ -137,9 +137,13 @@ module.exports = (ctx, pipeline) => {
           id: collectionId,
           href: baseDir,
           name: identity.name,
-          headline: identity.headline,
+          // 大标题只取显式配置的 headline；identity.headline 会回退到 name，
+          // 直接透传会让「删掉 headline」仍然渲染出同名大标题。
+          headline: typeof collectionConfig.headline === "string" ? collectionConfig.headline : "",
+          caption: identity.tagline || identity.description,
           description: identity.description,
           icon: identity.icon || "",
+          cover: collection.cover || "",
           order: collection.listing.order,
           listed: collection.visibility.listed !== false,
           navigation: {

package/scripts/lib/client-assets.js

@@ -22,6 +22,7 @@ function clientAssets(hexo) {
     'default:settings', 'copy:copy', 'weibo:repeat', 'weibo:like'];
   const clientIcons = Object.fromEntries(keys.map(key => [key, (icons[key] || '').replace(/<!--[\s\S]*?-->/g, '')]));
   const services = JSON.parse(JSON.stringify(INTERNAL.assets.services));
+  services.gravatar = { baseUrl: config.services.gravatar.baseUrl };
   services.siteinfo.api = resolveServiceProvider(config.services.siteInfo)?.endpoint || null;
   const provider = config.search.provider;
   const search = provider ? { service: provider === 'local' ? 'local_search' : provider } : null;

package/scripts/lib/config-schema.js

@@ -256,11 +256,11 @@ function validateEffectOptions(node, definition, options, source, path, issues)
       issues.push(issue("invalid_value", source, optionPath, valueType(value), "six-digit hexadecimal color", node.migration));
     } else if (rule.type === "hex_color_array" && (
       !Array.isArray(value)
-      || value.length < 1
+      || value.length < (rule.minItems ?? 1)
       || value.length > 8
       || value.some(item => typeof item !== "string" || !/^#?[a-f\d]{6}$/i.test(item))
     )) {
-      issues.push(issue("invalid_value", source, optionPath, valueType(value), "one to eight six-digit hexadecimal colors", node.migration));
+      issues.push(issue("invalid_value", source, optionPath, valueType(value), `${rule.minItems ?? 1} to eight six-digit hexadecimal colors`, node.migration));
     }
   }
 }

package/scripts/lib/contribution-registry.js

@@ -139,6 +139,20 @@ const CONTRIBUTIONS = defineContributions([
       });
     }
   },
+  {
+    id: "hero-parallax",
+    scope: "region",
+    kind: "feature",
+    entry: runtimeEntry("/js/runtime/extensions/hero-parallax.js"),
+    resources: [],
+    activation: selector(".wiki-hero"),
+    schema: null,
+    i18n: null,
+    docs: { category: "Components", path: "docs/knowledge/03-内容系统/wiki-docs.md" },
+    tests: [RUNTIME_TEST, RUNTIME_CONSUMPTION_TEST],
+    defaultsOwner: null,
+    project: () => configResult({})
+  },
   {
     id: "hero-effect",
     scope: "region",

package/scripts/lib/hero-effect-registry.js

@@ -32,7 +32,7 @@ function optionMatches(rule, value) {
   if (rule.type === "hex_color") return typeof value === "string" && /^#?[a-f\d]{6}$/i.test(value);
   if (rule.type === "hex_color_array") {
     return Array.isArray(value)
-      && value.length >= 1
+      && value.length >= (rule.minItems ?? 1)
       && value.length <= 8
       && value.every(item => typeof item === "string" && /^#?[a-f\d]{6}$/i.test(item));
   }
@@ -91,6 +91,55 @@ const LIGHT_RAYS_ORIGINS = Object.freeze([
 ]);
 
 const DEFINITIONS = defineHeroEffects([
+  {
+    id: "strands",
+    label: "Strands",
+    module: INTERNAL.assets.heroEffects.strands,
+    options: {
+      colors: { type: "hex_color_array", minItems: 0 },
+      count: { type: "number" },
+      speed: { type: "number" },
+      amplitude: { type: "number" },
+      waviness: { type: "number" },
+      thickness: { type: "number" },
+      glow: { type: "number" },
+      taper: { type: "number" },
+      spread: { type: "number" },
+      hueShift: { type: "number" },
+      intensity: { type: "number" },
+      saturation: { type: "number" },
+      opacity: { type: "number" },
+      scale: { type: "number" },
+      glass: { type: "boolean" },
+      refraction: { type: "number" },
+      dispersion: { type: "number" },
+      glassSize: { type: "number" }
+    },
+    defaults: {
+      colors: ["#F97316", "#7C3AED", "#06B6D4"],
+      count: 3,
+      speed: 0.5,
+      amplitude: 1,
+      waviness: 1,
+      thickness: 0.7,
+      glow: 2.6,
+      taper: 3,
+      spread: 1,
+      hueShift: 0,
+      intensity: 0.6,
+      saturation: 1.5,
+      opacity: 1,
+      scale: 1.5,
+      glass: false,
+      refraction: 1,
+      dispersion: 1,
+      glassSize: 1
+    },
+    presentation() {
+      return { background: "#000000" };
+    }
+  },
+
   {
     id: "galaxy",
     label: "Galaxy",

package/scripts/lib/image-metadata.js

@@ -13,6 +13,20 @@ const MAX_BYTES = 32 * 1024 * 1024;
 const RETRY_DELAY = 24 * 60 * 60 * 1000;
 const stores = new WeakMap();
 
+// The store serves two runtime consumers: article content images (dimensions
+// for aspect ratio) and average-color backgrounds for adaptive text. Scan the
+// rendered article region plus the adaptive-text owners, matching
+// source/js/plugins/adaptive-text.js, so page chrome (share QR codes, comments,
+// sidebars, footers) never triggers downloads or store entries.
+const METADATA_IMAGE_SELECTOR = [
+  'article.md-text.content img',
+  '.banner img',
+  '.cover img',
+  '.wiki-card-cover img',
+  '.pin-slide img',
+  '.wiki-hero img'
+].join(', ');
+
 function metadataPath(ctx) {
   return path.join(ctx.source_dir || path.join(ctx.base_dir || process.cwd(), 'source'), '_data', 'caches', DATA_FILE);
 }
@@ -91,12 +105,13 @@ function complete(entry) {
   return (dimensionsReady(entry?.dimensions) || entry?.dimensions?.status === 'unsupported') && colorDone;
 }
 
-// Scan rendered img elements, so Markdown, tags, Front Matter and data-driven
-// covers use their actual output without maintaining another source-field list.
+// Scan rendered img elements in scope for the store, so Markdown, tags, Front
+// Matter and data-driven covers use their actual output without maintaining
+// another source-field list, while page chrome stays out of scope.
 function collectImages(html, base) {
   const urls = new Set();
   const $ = load(html, null, false);
-  $('img').each((_, element) => {
+  $(METADATA_IMAGE_SELECTOR).each((_, element) => {
     const img = $(element);
     const url = imageUrl(img.attr('data-src') || img.attr('src'), base);
     if (url) urls.add(url);
@@ -247,7 +262,7 @@ function enrichImages(html, ctx, locals = {}) {
   let changed = false;
   const autoRatio = (ctx.stellar?.config?.features?.lazyLoading?.autoAspectRatio
     ?? ctx.theme?.config?.features?.lazy_loading?.auto_aspect_ratio) !== false;
-  $('img').each((_, image) => {
+  $(METADATA_IMAGE_SELECTOR).each((_, image) => {
     const img = $(image);
     const src = img.attr('data-src') || img.attr('src');
     const entry = store.images[imageUrl(src, base)];

package/scripts/lib/internal-constants.js

@@ -57,6 +57,7 @@ module.exports = deepFreeze({
       settings: "/js/runtime/extensions/settings.js"
     },
     heroEffects: {
+      strands: "/js/runtime/hero-effects/strands.js",
       ferrofluid: "/js/runtime/hero-effects/ferrofluid.js",
       galaxy: "/js/runtime/hero-effects/galaxy.js",
       lightRays: "/js/runtime/hero-effects/light-rays.js"

package/scripts/lib/models/wiki.js

@@ -7,6 +7,7 @@ const { firstContentImage } = require("../seo");
 const { caption } = require("../caption");
 const { wikiReadmeHtml } = require("../wiki_readme");
 const { filterShareServices } = require("../share-services");
+const { COLLECTION_CONFIG_SCHEMA } = require("../../schema/content-config-schema");
 const { projectHeroEffect } = require("../hero-effect-registry");
 const { normalizeThemeComments } = require("../comments");
 const { articleFooterDefaults, articlePresentationDefaults, collectionFooterDefaults, requireContentConfig } = require("../content-defaults");
@@ -14,6 +15,7 @@ const { cloneValue, deepFreeze, pick, mergeConfig, toContentNavigation, collecti
 
 function heroBackground(value) {
   const background = cloneValue(value || {});
+  background.parallax ??= COLLECTION_CONFIG_SCHEMA.properties.hero.properties.background.properties.parallax.default.value;
   if (background.effect) background.effect = projectHeroEffect(background.effect);
   return background;
 }