hexo-theme-stellar 1.41.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,54 @@
 # 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

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.41.0'
+  version: '1.42.0'
   homepage: 'https://xaoxuu.com/wiki/stellar/'
   repo: 'https://github.com/xaoxuu/hexo-theme-stellar'
   main_css: /css/main.css
@@ -188,10 +188,10 @@ 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
   # 分类颜色
@@ -669,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

package/_data/icons.yml

@@ -173,8 +173,6 @@ rating:star: <svg xmlns="http://www.w3.org/2000/svg" width="1em" height="1em" vi
 weibo:repeat: <svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 24 24"><!-- Icon from Solar by 480 Design - https://creativecommons.org/licenses/by/4.0/ --><path fill="currentColor" fill-rule="evenodd" d="M8.46967 2.46967C8.76256 2.17678 9.23744 2.17678 9.53033 2.46967L11.5303 4.46967C11.7448 4.68417 11.809 5.00676 11.6929 5.28701C11.5768 5.56727 11.3033 5.75 11 5.75H9C5.54822 5.75 2.75 8.54822 2.75 12C2.75 15.4517 5.54846 18.25 9.00028 18.25H9.5C9.91421 18.25 10.25 18.5858 10.25 19C10.25 19.4142 9.91421 19.75 9.5 19.75H9.00028C4.72011 19.75 1.25 16.2802 1.25 12C1.25 7.71979 4.71979 4.25 9 4.25H9.18934L8.46967 3.53033C8.17678 3.23744 8.17678 2.76256 8.46967 2.46967ZM13.75 5C13.75 4.58579 14.0858 4.25 14.5 4.25H15C19.2802 4.25 22.75 7.71979 22.75 12C22.75 16.2802 19.2802 19.75 15 19.75H14.8107L15.5303 20.4697C15.8232 20.7626 15.8232 21.2374 15.5303 21.5303C15.2374 21.8232 14.7626 21.8232 14.4697 21.5303L12.4697 19.5303C12.2552 19.3158 12.191 18.9932 12.3071 18.713C12.4232 18.4327 12.6967 18.25 13 18.25H15C18.4518 18.25 21.25 15.4518 21.25 12C21.25 8.54822 18.4518 5.75 15 5.75H14.5C14.0858 5.75 13.75 5.41421 13.75 5Z" clip-rule="evenodd"/></svg>
 # 微博点赞（weibo.js，替代 emoji，客户端注册表）
 weibo:like: <svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 24 24"><!-- Icon from Solar by 480 Design - https://creativecommons.org/licenses/by/4.0/ --><g fill="currentColor"><path d="M20.2699 16.265L20.9754 12.1852C21.1516 11.1662 20.368 10.2342 19.335 10.2342H14.1539C13.6404 10.2342 13.2494 9.77328 13.3325 9.26598L13.9952 5.22142C14.1028 4.56435 14.0721 3.892 13.9049 3.24752C13.7664 2.71364 13.3545 2.28495 12.8128 2.11093L12.6678 2.06435C12.3404 1.95918 11.9831 1.98365 11.6744 2.13239C11.3347 2.29611 11.0861 2.59473 10.994 2.94989L10.5183 4.78374C10.3669 5.36723 10.1465 5.93045 9.86218 6.46262C9.44683 7.24017 8.80465 7.86246 8.13711 8.43769L6.69838 9.67749C6.29272 10.0271 6.07968 10.5506 6.12584 11.0844L6.93801 20.4771C7.0125 21.3386 7.7328 22 8.59658 22H13.2452C16.7265 22 19.6975 19.5744 20.2699 16.265Z"/><path fill-rule="evenodd" d="M2.96767 9.48508C3.36893 9.46777 3.71261 9.76963 3.74721 10.1698L4.71881 21.4063C4.78122 22.1281 4.21268 22.7502 3.48671 22.7502C2.80289 22.7502 2.25 22.1954 2.25 21.5129V10.2344C2.25 9.83275 2.5664 9.5024 2.96767 9.48508Z" clip-rule="evenodd"/></g></svg>
-# weibo / timeline 评论数（weibo.js / timeline.js 共用，客户端注册表）
-weibo:comment: <svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 24 24"><!-- Icon from Solar by 480 Design - https://creativecommons.org/licenses/by/4.0/ --><g fill="currentColor"><path d="M21.9749 13.8143C20.4809 14.5732 18.7904 15.0009 17 15.0009C10.9249 15.0009 6 10.0761 6 4.00092C6 3.37164 6.05284 2.7547 6.15433 2.1543C5.43913 2.25971 4.87728 2.43759 4.38751 2.73772C3.71473 3.15 3.14908 3.71565 2.7368 4.38843C2 5.59078 2 7.22749 2 10.5009V11.5009C2 13.8306 2 14.9955 2.3806 15.9143C2.88807 17.1395 3.86144 18.1129 5.08658 18.6203C5.74689 18.8938 6.53422 18.9707 7.78958 18.9924C8.63992 19.007 9.06509 19.0144 9.40279 19.2108C9.74049 19.4072 9.95073 19.7624 10.3712 20.4728L10.9133 21.3886C11.3965 22.2049 12.6035 22.2049 13.0867 21.3886L13.6288 20.4728C14.0492 19.7624 14.2595 19.4072 14.5972 19.2108C14.9349 19.0144 15.36 19.007 16.2104 18.9924C17.4658 18.9707 18.2531 18.8938 18.9134 18.6203C20.1386 18.1129 21.1119 17.1395 21.6194 15.9143C21.8463 15.3666 21.9379 14.7315 21.9749 13.8143Z"/><path fill-rule="evenodd" d="M13.0867 21.3886L13.6288 20.4728C14.0492 19.7624 14.2595 19.4072 14.5972 19.2108C14.9349 19.0144 15.36 19.007 16.2104 18.9924C17.4658 18.9707 18.2531 18.8938 18.9134 18.6203C20.1386 18.1129 21.1119 17.1395 21.6194 15.9143C21.8463 15.3666 21.9379 14.7315 21.9749 13.8143C20.4809 14.5732 18.7904 15.0009 17 15.0009C10.9249 15.0009 6 10.0761 6 4.00092C6 3.37164 6.05284 2.7547 6.15433 2.1543C5.43913 2.25971 4.87728 2.43759 4.38751 2.73772C3.71473 3.15 3.14908 3.71565 2.7368 4.38843C2 5.59078 2 7.22749 2 10.5009V11.5009C2 13.8306 2 14.9955 2.3806 15.9143C2.88807 17.1395 3.86144 18.1129 5.08658 18.6203C5.74689 18.8938 6.53422 18.9707 7.78958 18.9924C8.63992 19.007 9.06509 19.0144 9.40279 19.2108C9.74049 19.4072 9.95073 19.7624 10.3712 20.4728L10.9133 21.3886C11.3965 22.2049 12.6035 22.2049 13.0867 21.3886Z" clip-rule="evenodd"/><path d="M13.5 2H10.5C8.56 2 7.19487 2 6.15433 2.15337C6.05284 2.75378 6 3.37072 6 4C6 10.0751 10.9249 15 17 15C18.7904 15 20.4809 14.5722 21.9749 13.8134C22 13.1919 22 12.441 22 11.5V10.5C22 7.22657 22 5.58985 21.2632 4.38751C20.8509 3.71473 20.2853 3.14908 19.6125 2.7368C18.4101 2 16.7734 2 13.5 2Z" opacity=".5"/></g></svg>
 
 # ================ 标签插件 · {% chat %} — 浏览器来源标识（链接卡片） ================
 # Google 浏览器

package/layout/_partial/cover/index.ejs

@@ -3,9 +3,6 @@ function layoutCover() {
   if (page.wiki) {
     return partial('wiki_cover')
   }
-  // if (page.layout === 'post') {
-  //   return partial('post_cover')
-  // }
   return ''
 }
 %>

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

@@ -19,17 +19,18 @@ if (banner.subtitle == null) {
   banner.subtitle = page.subtitle
 }
 
-function layoutBreadcrumb() {
+// 上块：第一行（左侧面包屑 + 右侧阅读时长 / AI 标签）+ 第二行（日期信息，靠左）
+function layoutTop() {
   if (page.breadcrumb === false) {
-    return `<div class="top"></div>`
+    return ''
   }
   var el = ''
-  // 1.main
+  // 1.上块容器
   el += `<div class="top bread-nav footnote">`
-  // 2.left
-  el += `<div class="left">`
-  // 3.left.top: 面包屑导航
-  el += `<div class="flex-row" id="breadcrumb">`
+  // 2.第一行
+  el += `<div class="top-row">`
+  // 2.1 左：面包屑导航
+  el += `<div class="left" id="breadcrumb">`
     // 首页
     el += `<a class="cap breadcrumb" href="${pretty_url(config.root)}">${__("btn.home")}</a>`
     if (theme.wiki.tree[page.wiki]) {
@@ -41,30 +42,30 @@ function layoutBreadcrumb() {
     } else {
       el += partial('breadcrumb/page')
     }
-  // 字数和预计阅读时长，置于面包屑行右侧（#302）
-  var readingHtml = ''
+  el += `</div>`
+  // 2.2 右：字数和预计阅读时长 + AI 成分标签（仅在有内容时渲染）
+  var rightHtml = ''
+  // 字数和预计阅读时长，置于第一行右侧（#302）
   if (page.layout == 'post' && theme.article.reading_time) {
     var _wc = word_count(page)
     if (_wc > 0) {
-      readingHtml = `<span class="cap reading right">${__("meta.word_count", _wc)} · ${__("meta.reading_time", reading_time(page))}</span>`
+      rightHtml += `<span class="cap reading">${__("meta.word_count", _wc)} · ${__("meta.reading_time", reading_time(page))}</span>`
     }
   }
-  el += readingHtml
-  // AI 成分标签：置于面包屑行最右（阅读时长右侧）；
+  // AI 成分标签：置于第一行最右（阅读时长右侧）；
   // banner 含图片时不用配置色，继承默认文字色（--text-banner）
   const bannerHasImage = banner.url && banner.url.length > 0
-  if (readingHtml.length > 0) {
-    el += ai_label(page.ai_label, 'cap', bannerHasImage)
-  } else {
-    el += ai_label(page.ai_label, 'cap right', bannerHasImage)
+  rightHtml += ai_label(page.ai_label, 'cap', bannerHasImage)
+  if (rightHtml.length > 0) {
+    el += `<div class="right">${rightHtml}</div>`
   }
-  // end 3.left.top
+  // end 2.第一行
   el += `</div>`
-  // 3.left.bottom
+  // 3.第二行：日期信息，靠左
+  el += `<div class="meta-row">`
   el += partial('dateinfo')
-  // end 2.left
   el += `</div>`
-  // end 1.main
+  // end 1.上块
   el += `</div>`
   return el
 }
@@ -118,26 +119,28 @@ function layoutBottom() {
 
 function layoutDiv() {
   const bottom = layoutBottom()
-  if (page.breadcrumb === false && bottom.length == 0) {
+  const top = layoutTop()
+  if (top.length == 0 && bottom.length == 0) {
     return ``
   }
-  const top = layoutBreadcrumb()
   var bannerStyle = ``
-  var contentStyle = ``
+  var adaptiveAttr = ``
+  var maskHtml = ``
   var el = ``
   if (banner.url?.length > 0) {
     bannerStyle += ` style="--bg-url:url('${banner.url.replace(/'/g, '%27')}')"`
+    // 背景图上方文字颜色自适应
+    adaptiveAttr = ` data-text-adaptive="split"`
   }
   el += `<div class="article-banner-wrap${scrollreveal(' ')}">`
   el += `<div class="article banner top"${bannerStyle}>`
   if (banner.url?.length > 0) {
     el += `<img class="lazy bg" data-src="${banner.url}">`
-    if (banner.color) {
-      contentStyle += ' style="--text-banner:' + banner.color + '"'
-    }
+    maskHtml = `<div class="banner-mask banner-mask-top" aria-hidden="true"></div><div class="banner-mask banner-mask-bottom" aria-hidden="true"></div>`
   }
   el += `
-  <div class="content"${contentStyle}>
+  <div class="content"${adaptiveAttr}>
+    ${maskHtml}
     ${top}
     ${bottom}
   </div>

package/layout/_partial/main/pin_slider.ejs

@@ -49,25 +49,13 @@ pinItems.sort(function(a, b) {
   return pinWeight(b) - pinWeight(a)
 })
 
-// 文章幻灯片：固定「标题 + 一行小字」结构，宽高比统一取自 pin_slider.ratio。
-// 标题：poster.headline > title；小字：poster.caption > description > excerpt（截断 50 字）。
-// 样式与 poster 卡片 cover-info 一致；无封面时为纯白卡片（文字按普通文章颜色）。
-function postSubtitle(post) {
-  if (post.poster != null && post.poster.caption != null && post.poster.caption.length > 0) {
-    return post.poster.caption
-  }
-  if (post.description != null && post.description.length > 0) {
-    return post.description
-  }
-  var text = post.excerpt || post.content || ''
-  text = strip_html(text).replace(/\s+/g, ' ').trim()
-  return text.length > 0 ? truncate(text, {length: 50}) : ''
-}
-
+// 文章幻灯片：固定「标题 + 一行小字」结构。
+// 标题：post.title；小字由 subtitle() helper 统一取值（subtitle > description > excerpt 前 50 字）。
+// 样式与 hero 卡片 cover-info 一致；无封面时为纯白卡片（文字按普通文章颜色）。
 function postSlide(post) {
   var noCover = !(post.cover != null && post.cover.length > 0)
-  var headline = (post.poster != null && post.poster.headline != null && post.poster.headline.length > 0) ? post.poster.headline : post.title
-  var subtitle = postSubtitle(post)
+  var headline = post.title
+  var sub = subtitle(post)
   var el = ''
   el += '<a class="pin-slide post-slide' + (noCover ? ' no-cover' : '') + '" href="' + escape_html(pretty_url(post.link || post.path)) + '"'
   if (!noCover) {
@@ -77,10 +65,11 @@ function postSlide(post) {
   if (!noCover) {
     el += '<img class="pin-slide-bg" src="' + escape_html(post.cover) + '" alt=""/>'
   }
-  el += '<div class="pin-slide-text">'
+  // 有封面时文字颜色自适应（大字 contrast、小字 theme）；无封面保持普通文章文字颜色
+  el += '<div class="pin-slide-text"' + (noCover ? '' : ' data-text-adaptive="split"') + '>'
   el += '<div class="pin-slide-headline">' + escape_html(headline) + '</div>'
-  if (subtitle.length > 0) {
-    el += '<div class="pin-slide-caption">' + escape_html(subtitle) + '</div>'
+  if (sub.length > 0) {
+    el += '<div class="pin-slide-caption">' + escape_html(sub) + '</div>'
   }
   el += '</div>'
   el += '</a>'
@@ -100,10 +89,9 @@ function wikiSlide(proj) {
   var title = proj.title || proj.name || proj.id
   var excerpt = proj.description || ''
   var el = ''
-  el += '<a class="pin-slide" href="' + escape_html(pretty_url(proj.homepage?.path || '/')) + '">'
+  el += '<a class="pin-slide" href="' + escape_html(pretty_url(proj.homepage?.path || '/')) + '" style="--pin-cover-url:url(\'' + escape_html(img.replace(/'/g, '%27')) + '\')">'
   el += '<img class="pin-slide-bg" src="' + escape_html(img) + '" alt=""/>'
-  el += '<div class="pin-slide-mask"></div>'
-  el += '<div class="pin-slide-info">'
+  el += '<div class="pin-slide-info" data-text-adaptive="split">'
   el += '<div class="pin-slide-caps">' + projectChips(proj.tags) + '</div>'
   el += '<div class="pin-slide-title">' + escape_html(title) + '</div>'
   if (excerpt.length > 0) {
@@ -145,12 +133,13 @@ if (pinItems.length > 0) {
 <%- el %>
 <script>
 function initWhenReady() {
-  if (typeof utils !== 'undefined' && utils.initPlugin) {
-    utils.initPlugin(initPinSlider, 'pin-slider');
+  if (typeof stellar === 'object' && typeof stellar.initPlugin === 'function') {
+    stellar.initPlugin(initPinSlider, 'pin-slider');
   } else {
-    document.addEventListener('DOMContentLoaded', function() {
-      if (typeof utils !== 'undefined' && utils.initPlugin) {
-        utils.initPlugin(initPinSlider, 'pin-slider');
+    // pin_slider 内联脚本渲染在 scripts/bootstrap 之前，等待 DOMContentLoaded 后注册
+    document.addEventListener('DOMContentLoaded', function () {
+      if (typeof stellar === 'object' && typeof stellar.initPlugin === 'function') {
+        stellar.initPlugin(initPinSlider, 'pin-slider');
       }
     });
   }
@@ -163,6 +152,10 @@ function initPinSlider() {
   var slides = slider.querySelectorAll('.pin-slide');
   var count = slides.length;
   if (!track || count <= 1) {
+    // 单张幻灯片：直接把封面同步到 .pin-slider 自身背景（跟随 corner-shape）
+    if (slides[0]) {
+      slider.style.setProperty('--pin-cover-url', slides[0].style.getPropertyValue('--pin-cover-url') || '');
+    }
     slider.style.visibility = 'visible';
     return;
   }
@@ -185,6 +178,11 @@ function initPinSlider() {
   function goTo(n) {
     index = (n + count) % count;
     track.style.transform = 'translateX(-' + (index * 100) + '%)';
+    // 背景图由 .pin-slider 自身背景承载（跟随 corner-shape），随当前 slide 同步
+    var active = slides[index];
+    if (active) {
+      slider.style.setProperty('--pin-cover-url', active.style.getPropertyValue('--pin-cover-url') || '');
+    }
     var dots = slider.querySelector('.pin-slider-dots');
     var items = dots ? dots.children : [];
     for (var i = 0; i < count; i++) {
@@ -198,9 +196,39 @@ function initPinSlider() {
       }
     }
     savePinIndex(group, contentKey, index, count);
+    updateNavColor();
   }
   function next() { goTo(index + 1); }
   function prev() { goTo(index - 1); }
+
+  // 左右箭头颜色随当前幻灯片封面自适应（contrast：深色背景白箭头、浅色背景深箭头）
+  var navColorRetries = 0;
+  function updateNavColor() {
+    var navs = slider.querySelectorAll('.pin-slider-nav');
+    if (navs.length === 0) return;
+    if (!window.stellar || !window.stellar.color || !window.resolveAdaptiveBackdrop) {
+      // 懒加载的 color.js / 插件尚未就绪时重试
+      if (navColorRetries < 25) {
+        navColorRetries++;
+        setTimeout(updateNavColor, 200);
+      }
+      return;
+    }
+    var slide = slides[index];
+    if (!slide) return;
+    var cover = slide.style.getPropertyValue('--pin-cover-url');
+    if (!cover) return;
+    var m = cover.match(/url\((['"]?)(.*?)\1\)/i);
+    if (!m) return;
+    stellar.color.getAverageColor(m[2], { background: window.resolveAdaptiveBackdrop(slide) }).then(function (rgb) {
+      if (!rgb) return;
+      var color = stellar.color.adaptiveTextColor(rgb, { style: 'contrast' });
+      for (var i = 0; i < navs.length; i++) {
+        navs[i].style.setProperty('--text-banner', color);
+      }
+    });
+  }
+  window.refreshPinNavColor = updateNavColor;
   function start() {
     if (reduced) return;
     slider.classList.remove('paused');
@@ -294,6 +322,9 @@ function initPinSlider() {
       navNext.removeEventListener('click', next);
     }
     document.removeEventListener('visibilitychange', onVis);
+    if (window.refreshPinNavColor === updateNavColor) {
+      window.refreshPinNavColor = null;
+    }
   };
 }
 function restorePinIndex(group, contentKey, count) {