hexo-theme-stellar 1.40.0 → 1.42.0

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

@@ -24,8 +24,6 @@ description: 主题仓库（hexo-theme-stellar）开发全流程：方案 →
 
 ### 3. 验证
 
-- UI 方面（样式、模板、前端交互等）改动量不大时无需验证，除非用户明确要求。
-
 命令按需执行：
 
 - `scripts/` 有改动 → 必须在主工程（xaoxuu.com）执行 `npm run g` 全量验证（已含 `hexo clean && hexo generate && npx gulp minify`）；`npm run s` 是按需渲染，不能替代。
@@ -46,5 +44,6 @@ description: 主题仓库（hexo-theme-stellar）开发全流程：方案 →
 ### 5. 发版
 
 - 由用户触发时执行：分析自上一 tag 起的 commit 确定版本号 → 在 `CHANGELOG.md` 写入对应非空章节（H2 版本号 + H3 分类）→ 向用户确认版本号与变更摘要 → `npm run release:dry -- <version>` 预演 → 正式发版。
+- 发版前核对：`npm run check` 内含提交登记完整性检查，自上一 tag 起涉及主题代码/配置/行为变化的非合并提交须在 `docs/knowledge/VERIFICATION.md`「提交登记（发版前核对）」表登记短 SHA（纯文档 / CI 改动无需登记）；缺失先补登记再发版。
 - 详见 `docs/guides/release-process.md` 与 `AGENTS.md`「发版规范」（§8）。
 - 完成条件：版本号与变更摘要已获用户确认；dry-run 通过后完成正式发版。

package/CHANGELOG.md

@@ -1,5 +1,95 @@
 # Changelog
 
+## 1.42.0
+
+> 发布日期：2026-08-16
+
+### 新功能
+- 文章卡片新增 `article.card_style`（`hero` / `classic`）：hero 全图文字封面卡片（有 cover 时标题 + 单行小字，文字区固定底部），classic 普通卡片；hero 与置顶轮播统一小字取值 `subtitle()`（`subtitle` > `description` > excerpt 前 50 字）
+- 背景图/背景色上方文字颜色自适应（`plugins.adaptive_text`，默认开启）：`theme` / `contrast` / `split` 三种模式，按背景平均色计算并写入 `--text-banner` / `--text-banner-theme`，接入文章封面、专栏最新文章卡片、置顶轮播、页顶横幅与 `{% banner %}` 标签
+- 专栏列表页重构为上下布局：标题 + 描述 + 全宽最新文章卡片 + 其他文章列表，抽出 `.post-panel` 公共组件（友链文章订阅同步复用）
+
+### 修复
+- 标签行负边距导致移动端页面横向溢出（#688）
+- albums/posters 在 Firefox/Safari 标题竖排与遮罩消失问题（#689）
+- Babel 转译将 `sidebar` 全局改名导致侧边栏失效
+- 作者归档页横幅下块贴顶；页面顶部横幅黑色蒙版始终显示并贴边
+- Safari 下顶部横幅与列表封面方角漏出（`isolation: isolate` + `translateZ(0)` + clip-path 兜底）
+- banner 导航激活项 blur 导致 hover 圆角丢失
+- TOC 回到顶部/参与讨论图标改为内联并修复占位符布局
+- 轮播区/文章封面/页顶横幅/`{% banner %}` 图片角落跟随连续曲率圆角配置
+- timeline 页脚评论图标尺寸与文字对齐
+
+### 样式
+- 文章卡片标签 `#` 前缀替换为 hashtag 图标
+- banner hover 动画对齐封面（背景图缩放 1.05 + 变暗），封面渐变模糊层增加黑色蒙版
+- 统一封面、轮播、页顶横幅与 banner 标签背景图覆盖层观感（`cover-overlay()`）
+- 左栏「所有项目」返回胶囊默认背景复用目录树激活光照效果
+- 间距令牌重构为 `--gap-base` / `--gap-page`：组件内部间距固定 16px，页面级留白随断点分档（16/32px），侧边栏贴边时四周间距一致
+- 右栏在侧边栏基础宽度上单独加宽（新增 `--rightbar-width-extra`，默认 32px）
+- 右栏 `.l_right .widgets` 桌面端 padding 归零，折叠抽屉保留 16px 0
+- 折叠抽屉位移改为跟随自身宽度（`calc(100% + inset*2)`），修复右栏加宽后收拢仍露边
+
+### 重构
+- 移除已失效的 auto_banner（Unsplash 自动横幅）与 `poster` 配置
+- 页面横幅上块重构为显式两行结构（面包屑 + 阅读时长/AI 标签 + 日期行）
+- 评论数图标统一使用 `default:tocomment`，移除 `weibo:comment`
+
+### 其他
+- 移除知识库合并版 `知识库全量.md`，知识库以领域页面为唯一事实源
+- 新增 AI 规范引用一致性检查（check-spec-refs）与发版前提交登记完整性检查（随 `npm run check` 执行）
+
+### 升级注意（配置变更与破坏性改动）
+- 移除 `article.auto_banner`（Unsplash 自动横幅已失效）与文章 front-matter `poster`（`headline` / `topic` / `caption`）；`poster.color` / `banner_info.color` 显式文字颜色不再生效，由自适应文字颜色接管
+- 新增 `article.card_style`（`hero` 默认 / `classic`）：未显式设置的站点保持 hero 卡片样式
+- 新增 `plugins.adaptive_text`（默认 `enable: true`）：页面存在 `[data-text-adaptive]` 元素时才按需加载，文字颜色默认随背景自适应
+- 删除间距令牌 `--gap-margin` / `--gap-padding` / `--gap-max`，替换为 `--gap-base`（组件内部间距）与 `--gap-page`（页面级留白）；引用旧令牌的自定义 CSS 需迁移
+- `weibo:comment` 图标已移除，评论数图标统一使用 `default:tocomment`；自定义中引用了 `weibo:comment` 的站点请改用 `default:tocomment`
+- 知识库合并版 `知识库全量.md` 移除（RAG 可直接索引领域页面）
+
+Full Changelog: [1.41.0...main](https://github.com/xaoxuu/hexo-theme-stellar/compare/1.41.0...main)
+
+## 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/CONTRIBUTING.md

@@ -68,7 +68,7 @@ git submodule add https://github.com/<your-name>/hexo-theme-stellar.git themes/s
 
 ## 编码规范摘要
 
-完整规范见 `AGENTS.md` §6，核心要求：
+完整规范见 `AGENTS.md` §4，核心要求：
 
 - **EJS 模板**：`<%- %>` 输出非转义 HTML；变量声明用 `var`（IE8 兼容）；2 空格缩进；HTML 属性双引号；复杂逻辑提取到 `helpers/`
 - **Node 脚本**：CommonJS（`require()` / `module.exports`）；文件头 `/* global hexo */` + `'use strict';`；2 空格缩进、双引号、分号结尾
@@ -128,6 +128,7 @@ CI 会在 PR 上强制执行以下检查，全部通过后才可合并：
 | Unit tests | node:test 单测 |
 | Conventional Commits | 提交信息符合规范 |
 | Skill mirror sync | `.agents/` 与 `.claude/` 技能镜像一致 |
+| Spec refs | AGENTS.md 章节引用与关键措辞一致性 |
 | Integration build | 官方 demo 全量构建（hexo generate）+ Gulp minify |
 | Knowledge base verify | `docs/knowledge/tools/verify.py` 硬事实核查 |
 

package/README.md

@@ -1,39 +1,60 @@
 # Stellar - 每个人的独立博客
 
+[简体中文](README.md) · [English](README_EN.md)
+
 [![npm](https://img.shields.io/npm/v/hexo-theme-stellar)](https://www.npmjs.com/package/hexo-theme-stellar)
 [![license](https://img.shields.io/github/license/xaoxuu/hexo-theme-stellar)](https://github.com/xaoxuu/hexo-theme-stellar/blob/main/LICENSE)
 [![stars](https://img.shields.io/github/stars/xaoxuu/hexo-theme-stellar)](https://github.com/xaoxuu/hexo-theme-stellar)
 [![npm downloads](https://img.shields.io/npm/dm/hexo-theme-stellar)](https://www.npmjs.com/package/hexo-theme-stellar)
 [![release](https://img.shields.io/github/v/release/xaoxuu/hexo-theme-stellar)](https://github.com/xaoxuu/hexo-theme-stellar/releases)
 
-Stellar 是一个功能强大的综合型 Hexo 主题，内置博客、知识库、专栏、笔记四大系统，并提供丰富的标签组件与动态数据组件，开箱即用。
+Stellar 是一个「博客 + 知识库一体」的 Hexo 主题：简约商务美学之下，内置博客、Wiki、专栏、笔记四大内容系统与丰富的标签、动态数据组件，开箱即用。
 
-## 亮点
+可以只把它当作一个轻博客主题使用——安装启用即可写文章；Wiki 知识库、专栏、笔记与动态数据组件都按需启用，随着你的内容需求自然生长。
 
-- 支持技术 / 生活两种文章布局风格，为不同类型的文章呈现不同的阅读体验。
-- 内置 Wiki 系统，既可以展示多个项目文档，也可以作为个人知识库。
-- 内置专栏系统，支持沉浸式阅读专栏系列文章。
-- 内置笔记系统，方便地梳理和归档笔记。
-- 内置大量灵活而强大的标签组件，互相之间可以自由混搭嵌套。
-- 内置多种动态数据组件，让静态博客的内容更新不再依赖重新部署：
-  - 动态时间线：像发朋友圈一样发布短文，也可以订阅他人的时间线。
-  - 自动化友链：自动检测友链状态、打标签、订阅友链文章。
-  - 远程 Markdown 渲染：例如直接渲染项目仓库的 README，避免重复维护。
-- 模块化设计，内置多种高复用性的小组件，可以自由搭配布局。
-- 图片懒加载时按原图比例预留占位，不会出现高度跳变，体验更佳。
-- 支持一站多作者，可以为不同文章指定不同作者，每位作者都有专属主页。
-- 社区文化：可以订阅「探索号」时间线数据源，获取社区用户的宝贵经验分享。
+## 为什么选择 Stellar
 
-以上功能都可以在 [文档](https://xaoxuu.com/wiki/stellar/) 中找到详细的使用方法。
+### 四大内容系统，一体化整合
 
-[![Star History Chart](https://star-history.dera.page/svg?repos=xaoxuu/hexo-theme-stellar&type=date&legend=top-left)](https://star-history.dera.page/#xaoxuu/hexo-theme-stellar&type=date&legend=top-left)
+- **博客系统**：支持技术 / 生活两种文章布局，分类、标签、分页与相关文章一应俱全；只想写博客时，它就是一个开箱即用的轻博客。
+- **Wiki 文档系统**：既可以展示多个项目文档，也可以作为个人知识库，项目树、小节与层级导航开箱即用。
+- **专栏系统**：系列文章集中管理，提供沉浸式的连续阅读体验。
+- **笔记本系统**：三层架构与标签树导航，方便地梳理、归档和检索笔记。
+
+四套系统与动态数据组件一体化整合，无需拼装多个插件。
+
+### 富表达标签组件
+
+内置大量灵活而强大的标签组件——提示框、折叠、标签页、时间线、图库、图标、表情、高亮、OKR、聊天、表格等，互相之间可以自由混搭嵌套，让内容表达不再受 Markdown 语法限制。详见[标签组件文档](https://xaoxuu.com/wiki/stellar/tag-plugins/)。
+
+### 动态数据组件
+
+静态博客也能拥有动态能力，内容更新无需重新部署：
+
+- **动态时间线**：像发朋友圈一样发布短文，也可以订阅他人的时间线。
+- **自动化友链**：自动检测友链状态、打标签、订阅友链文章。
+- **远程 Markdown 渲染**：例如直接渲染项目仓库的 README，避免重复维护。
+- **GitHub 仓库 / 贡献者卡片、评分、投票、最新评论**等数据组件，按需加载，不拖慢首屏。
+- **社区文化**：可以订阅「探索号」时间线数据源，获取社区用户的宝贵经验分享。
+
+### 体验与性能
+
+- **模块化设计**：内置多种高复用性小组件，左右侧边栏自由搭配，布局随心。
+- **设计令牌驱动的样式系统**：统一的设计语言、深色模式与移动端响应式适配。
+- **图片懒加载**按原图比例预留占位，不会出现高度跳变，体验更佳。
+- 可选插件按需启用：代码高亮与复制、KaTeX / MathJax 数学渲染、Mermaid 图表、Fancybox 灯箱、Swiper 轮播等。
+- **本地搜索**：内置索引生成器，结果按章节展示，点击直达锚点并高亮关键词。
+- **SEO 完备**：JSON-LD 结构化数据、Open Graph、canonical 与克隆站检测，保护原创内容。
+- **一站多作者**：可以为不同文章指定不同作者，每位作者都有专属主页。
+
+以上功能都可以在[文档](https://xaoxuu.com/wiki/stellar/)中找到详细的使用方法。
 
 ## 示例与展示
 
-- 示例源码：[hexo-theme-stellar-examples](https://github.com/xaoxuu/hexo-theme-stellar-examples/)（`blog` 博客场景、`docs` 文档场景）
-- 展示墙：[使用 Stellar 主题的博客](https://xaoxuu.com/wiki/stellar/examples/)（30 个站点）
+- 示例源码：[hexo-theme-stellar-examples](https://github.com/xaoxuu/hexo-theme-stellar-examples/)（`blog` 博客场景、`docs` 文档场景），可直接 fork 起步
+- 展示墙：[使用 Stellar 主题的博客](https://xaoxuu.com/wiki/stellar/examples/)
 
-部分使用站点：[杜老师说](https://dusays.com)、[Watermelonabc](https://watermelonabc.top/)、[妄司逸](https://blog.flechazo.icu/)
+[![Star History Chart](https://star-history.dera.page/svg?repos=xaoxuu/hexo-theme-stellar&type=date&legend=top-left)](https://star-history.dera.page/#xaoxuu/hexo-theme-stellar&type=date&legend=top-left)
 
 ## 快速开始
 
@@ -62,6 +83,10 @@ npm install hexo-theme-stellar
 theme: stellar
 ```
 
+### 从轻博客开始
+
+配置完成后即可发布文章。Wiki、专栏、笔记本与动态数据组件按需启用，文档中均有详细说明；也可以直接参考示例仓库的 `blog` 场景快速搭建。
+
 ## 使用文档
 
 完整文档请见：https://xaoxuu.com/wiki/stellar/
@@ -70,7 +95,7 @@ theme: stellar
 
 - 更新日志：[CHANGELOG.md](https://github.com/xaoxuu/hexo-theme-stellar/blob/main/CHANGELOG.md) · [Releases](https://github.com/xaoxuu/hexo-theme-stellar/releases)
 
-## 常用文档
+### 常用文档
 
 - [标签组件](https://xaoxuu.com/wiki/stellar/tag-plugins/)
 - [主题配置](https://xaoxuu.com/wiki/stellar/theme-settings/)
@@ -82,3 +107,7 @@ theme: stellar
 - 提交 Issues：https://github.com/xaoxuu/hexo-theme-stellar/issues/
 - 参与讨论：https://github.com/xaoxuu/hexo-theme-stellar/discussions/
 - 贡献指南：[CONTRIBUTING.md](CONTRIBUTING.md) · [Wiki 贡献页](https://xaoxuu.com/wiki/stellar/contributors/)
+
+## 开源许可
+
+本项目采用 [MIT License](LICENSE)，Copyright (c) 2021 xaoxuu，永久开源、完全免费。

package/README_EN.md

@@ -0,0 +1,113 @@
+# Stellar - Your Own Independent Blog
+
+[English](README_EN.md) · [简体中文](README.md)
+
+[![npm](https://img.shields.io/npm/v/hexo-theme-stellar)](https://www.npmjs.com/package/hexo-theme-stellar)
+[![license](https://img.shields.io/github/license/xaoxuu/hexo-theme-stellar)](https://github.com/xaoxuu/hexo-theme-stellar/blob/main/LICENSE)
+[![stars](https://img.shields.io/github/stars/xaoxuu/hexo-theme-stellar)](https://github.com/xaoxuu/hexo-theme-stellar)
+[![npm downloads](https://img.shields.io/npm/dm/hexo-theme-stellar)](https://www.npmjs.com/package/hexo-theme-stellar)
+[![release](https://img.shields.io/github/v/release/xaoxuu/hexo-theme-stellar)](https://github.com/xaoxuu/hexo-theme-stellar/releases)
+
+Stellar is a Hexo theme that unifies blogging and knowledge base in one place. Beneath its clean, business-style aesthetics lie four built-in content systems — Blog, Wiki, Topic, and Notebook — plus a rich collection of tag plugins and dynamic data widgets, ready to use out of the box for every kind of expression.
+
+You can also use it as a lightweight blog theme from day one: install, enable, and start writing. Wiki, Topic, Notebook, and dynamic data widgets are all enabled on demand, growing naturally with your content needs.
+
+## Why Stellar
+
+### Four Content Systems, Integrated in One
+
+- **Blog**: Two article layouts (tech / story) offer different reading experiences, with categories, tags, pagination, and related posts — use it as a lightweight blog right away if that's all you need.
+- **Wiki**: Showcase multiple project documentations or use it as your personal knowledge base, with project trees, sections, and hierarchical navigation.
+- **Topic**: Manage series of articles with an immersive, continuous reading experience.
+- **Notebook**: A three-layer architecture with a tag tree to organize, archive, and retrieve notes with ease.
+
+All four systems and dynamic widgets are integrated out of the box — no need to assemble multiple plugins.
+
+### Expressive Tag Plugins
+
+A large set of flexible and powerful tag plugins — notes, folding, tabs, timelines, galleries, icons, emoji, highlights, OKR, chat, tables, and more — that can be freely mixed and nested, freeing your content from the limits of plain Markdown. See the [tag plugins documentation](https://xaoxuu.com/wiki/stellar/tag-plugins/).
+
+### Dynamic Data Widgets
+
+Static blogs with dynamic capabilities — update content without redeploying:
+
+- **Dynamic timeline**: Post short updates like a social feed, or subscribe to others' timelines.
+- **Automated friend links**: Automatically detect link status, tag links, and subscribe to friends' posts.
+- **Remote Markdown rendering**: Render a project repository's README directly, avoiding duplicate maintenance.
+- **GitHub repository / contributor cards, ratings, votes, latest comments**, and other data widgets — loaded on demand without slowing down the first screen.
+- **Community culture**: Subscribe to the "Explorer" timeline data source to learn from the community.
+
+### Experience & Performance
+
+- **Modular design**: Highly reusable widgets with freely configurable left/right sidebars.
+- **Design-token-driven styling**: A unified design language, dark mode, and responsive mobile adaptation.
+- **Lazy-loaded images** reserve space by original aspect ratio, preventing layout jumps.
+- Optional plugins enabled on demand: code highlighting & copy, KaTeX / MathJax, Mermaid diagrams, Fancybox lightbox, Swiper carousel, and more.
+- **Local search**: A built-in index generator, with results grouped by section, jumping to anchors and highlighting keywords.
+- **Complete SEO**: JSON-LD structured data, Open Graph, canonical URLs, and clone-site detection to protect original content.
+- **Multi-author support**: Assign different authors to different posts, each with their own dedicated homepage.
+
+Detailed usage for all of the above can be found in the [documentation](https://xaoxuu.com/wiki/stellar/).
+
+## Examples & Showcase
+
+- Example source: [hexo-theme-stellar-examples](https://github.com/xaoxuu/hexo-theme-stellar-examples/) (`blog` blog scenario, `docs` documentation scenario) — ready to fork and start
+- Showcase: [Blogs using Stellar](https://xaoxuu.com/wiki/stellar/examples/)
+
+[![Star History Chart](https://star-history.dera.page/svg?repos=xaoxuu/hexo-theme-stellar&type=date&legend=top-left)](https://star-history.dera.page/#xaoxuu/hexo-theme-stellar&type=date&legend=top-left)
+
+## Quick Start
+
+### Requirements
+
+```yaml
+Hexo: 6.3.0 ~ latest (verified up to 8.1.2)
+hexo-cli: 4.3.0 ~ latest
+node: >= 22 # LTS recommended
+npm: >= 10
+```
+
+### Install
+
+In the root directory of your blog:
+
+```bash
+npm install hexo-theme-stellar
+```
+
+### Configure
+
+Edit `_config.yml` and enable the theme:
+
+```yaml
+theme: stellar
+```
+
+### Start Light
+
+Once configured, you can publish posts immediately. Wiki, Topic, Notebook, and dynamic widgets can be enabled on demand and are documented in detail; alternatively, start from the `blog` scenario in the example repository for a quick setup.
+
+## Documentation
+
+Full documentation: https://xaoxuu.com/wiki/stellar/ (currently available in Chinese)
+
+> AI documentation: https://deepwiki.com/xaoxuu/hexo-theme-stellar/
+
+- Changelog: [CHANGELOG.md](https://github.com/xaoxuu/hexo-theme-stellar/blob/main/CHANGELOG.md) · [Releases](https://github.com/xaoxuu/hexo-theme-stellar/releases)
+
+### Common Topics
+
+- [Tag Plugins](https://xaoxuu.com/wiki/stellar/tag-plugins/)
+- [Theme Settings](https://xaoxuu.com/wiki/stellar/theme-settings/)
+- [Wiki System](https://xaoxuu.com/wiki/stellar/wiki-settings/)
+- [Topic & Notebook](https://xaoxuu.com/wiki/stellar/topic/)
+
+## Feedback
+
+- Issues: https://github.com/xaoxuu/hexo-theme-stellar/issues/
+- Discussions: https://github.com/xaoxuu/hexo-theme-stellar/discussions/
+- Contributing: [CONTRIBUTING.md](CONTRIBUTING.md) · [Wiki contributors page](https://xaoxuu.com/wiki/stellar/contributors/)
+
+## License
+
+This project is licensed under the [MIT License](LICENSE), Copyright (c) 2021 xaoxuu. Permanently open source and completely free.

package/_config.yml

@@ -1,6 +1,6 @@
 ######## Stellar info ########
 stellar:
-  version: '1.40.0'
+  version: '1.42.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
@@ -188,15 +188,32 @@ article:
   indent: # true / false
   # 封面图宽高比
   cover_ratio: 2
+  # 文章卡片样式：hero = 全图文字封面卡片（有 cover 时标题 + 一行小字，文字区固定底部），classic = 普通卡片（封面/标题/摘要/meta）
+  card_style: hero
   # 文章内横幅宽高比
   banner_ratio: 2.5
-  # 如果没有指定横幅，是否根据 tags 作为关键词搜索横幅图片？
-  auto_banner: false # search from https://source.unsplash.com/
   # 如果没有指定 excerpt 和 description，将自动取多长的内容作为文章摘要？
   auto_excerpt: 128
   # 分类颜色
   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
@@ -648,6 +669,11 @@ plugins:
     default_text: 'Copy'
     success_text: 'Copied'
     toast: 复制成功
+
+  # 文字自适应颜色：背景图/背景色上方的文字随背景亮度自适应
+  # 页面存在 [data-text-adaptive] 元素时才按需加载（theme：背景图平均色 lighten/darken；contrast：黑白对比）
+  adaptive_text:
+    enable: true
   
   # 赫蹏 (Heti) - 专为中文网页内容设计的排版样式增强
   # https://github.com/sivan/heti
@@ -731,8 +757,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: