hexo-theme-stellar 2.0.0-rc.1 → 2.0.0-rc.3

package/CHANGELOG.md

@@ -1,5 +1,63 @@
 # Changelog
 
+## 2.0.0-rc.3
+
+> 发布日期：2026-09-10
+
+本节记录从公开候选 `2.0.0-rc.2` 到 `2.0.0-rc.3` 最终文件树的净变化。
+
+### 新功能
+
+- 默认启用同集合局部导航：外壳兼容时更新正文、右栏和页面元数据，保留导航区域；支持历史滚动恢复，不兼容页面或请求失败时整页跳转。
+- 图片尺寸与 HSLA 平均色在 server/generate 时自动增量提取并持久缓存，补全生成 HTML，不修改 Markdown 或原图；新增 `hexo stellar images` 及 `--dry-run/--page/--refresh` 选项。
+- Markdown 文本链接、文章参考链接、远程 Markdown 与评论链接支持站点图标增强；站点信息支持 `appicon/favicon`，保留 `icon` 回退，行内请求失败显示断链图标。
+- 新增字体平滑与设计字重映射；卡片 Spotlight 与 Tilt 可独立开关。
+- 第三方 JS/CSS 地址可在对应搜索、评论、Feature 或 Markdown 服务配置中覆盖；Artalk 默认使用服务端配套资源。
+
+### 修复与改进
+
+- 共享 Collection 模型并隔离构建缓存，复用 PageViewModel 和归档文章投影，减少重复解析与校验；忽略 Collection 目录中的 macOS `.DS_Store` 文件。
+- 完善 Extension 的页面／文档作用域、异步取消及卸载清理；修复 Flying Pages 初始化、图片懒加载与 Safari 错误占位时序，Reveal 待入场透明度在卸载时恢复。
+- 修复文章上下篇、作者页 Topic 文章与作者横幅；Topic 文章默认继承全局分享配置，Wiki 与 Notebook 仍默认关闭分享。
+- Doctor 与构建统一恢复可用的配置：普通字段问题和不适用的表现参数给出 warning，缺少集合显示名时使用 Collection ID；根结构与归属冲突仍阻止构建。
+- 本地搜索按章节组织结果并分批查询、渲染，改进摘要、高亮、加载更多和结束提示。
+- 调整 minimal 外观、暗色背景、移动导航、品牌、目录吸顶与当前条目滚动；修复 Markdown Widget 背景、稀疏 Wiki 网格宽度、画廊列数以及轮播、图片标签、头像、MBTI 卡片的比例与布局。
+- GitHub 卡片默认服务切换为 `https://github-stats-extended.vercel.app`；图片颜色处理新增 Sharp 直接依赖。
+
+### 升级注意（配置变更与破坏性改动）
+
+- 将 `footer.sections` 改为 `footer.sitemap`；分组保留 `title/items`，但 items 中的 `{title, url}` 对象需改写为 `'[标题](地址)'` Markdown 字符串。默认 sitemap 为空数组；默认页脚正文新增 CC BY-NC-SA 4.0 说明，可自行覆盖 `footer.content`。
+- 将 `features.card_hover.enabled` 替换为独立的 `spotlight` 与 `tilt` 布尔值；希望保持原先全部开启效果时两项均设为 `true`，默认均为 `false`。
+- `features.partial_navigation.enabled` 默认开启，含非主题管理可执行脚本的页面使用整页导航；需要全部整页跳转时将其关闭。
+- `features.image_optimization.enabled` 默认开启，首次处理远程图片可能增加构建时间；关闭后仍复用站点 `source/_data/caches/images_metadata.json`。`features.lazy_loading.auto_aspect_ratio` 继续控制尺寸／比例补全。
+- 第三方资源覆盖不保证任意上游 API 版本兼容；KaTeX 自定义 CSS 时需配套更新 `css_integrity`，或设为 `null` 不附加 SRI。仅覆盖 CSS 地址时会清除继承的旧哈希。
+
+Full Changelog: [2.0.0-rc.2...2.0.0-rc.3](https://github.com/xaoxuu/hexo-theme-stellar/compare/2.0.0-rc.2...2.0.0-rc.3)
+
+## 2.0.0-rc.2
+
+> 发布日期：2026-09-07
+
+本节记录从公开候选 `2.0.0-rc.1` 到 `2.0.0-rc.2` 最终文件树的净变化。
+
+### 新功能
+
+- Notebook 列表、设置页与错误页的专属配置统一收敛到 `profiles`；404 页新增默认关闭的评论区，可独立覆盖标题、线程、Provider 与参数。
+- 可信页面注入补全 `head_begin/head_end/body_begin/body_end` 四个位置，站点主题配置与页面 Front Matter 使用同一合并顺序和原样输出语义。
+
+### 修复与工程变化
+
+- 将 `hexo-front-matter` 声明为主题直接依赖，避免源码配置与 `stellar new note` 依赖 Hexo 宿主的传递依赖。
+- 重构中英文 README，明确 npm、源码与 Blueprint 三种安装入口，并补充随 npm 包分发的 Stellar 图标、项目描述、关键词和作者元数据。
+
+### 升级注意（配置变更与破坏性改动）
+
+- 从 RC1 升级时，将顶层 `notebook` 移到 `profiles.notebook`，将 `settings.about` 移到 `profiles.settings.about`，将 `error_page.image` 移到 `profiles.error.image`。
+- `profiles.notebook_index` 更名为 `profiles.notebooks`，`profiles.note_index` 更名为 `profiles.notebook`；Note 内容页继续使用 `profiles.note`。
+- `inject` 内容会作为可信 HTML 原样输出；只应配置维护者完全信任的内容，站点级内容在前、页面 Front Matter 在后。
+
+Full Changelog: [2.0.0-rc.1...2.0.0-rc.2](https://github.com/xaoxuu/hexo-theme-stellar/compare/2.0.0-rc.1...2.0.0-rc.2)
+
 ## 2.0.0-rc.1
 
 > 发布日期：2026-09-07

package/README.md

@@ -1,81 +1,87 @@
-# Stellar - 每个人的独立博客
+<div align="center">
+  <img src="assets/icon-v2-x512.webp" width="160" alt="Stellar">
+  <h1>Stellar</h1>
+  <p>每个人的独立博客</p>
+  <p>基于 Hexo 的全能个人知识库，开箱即用，内置海量标签和动态数据组件。可用于个人博客、项目文档、知识库、专栏、笔记等。</p>
+  <p><a href="README.md">简体中文</a> · <a href="README_EN.md">English</a></p>
+  <p>
+    <a href="https://github.com/xaoxuu/hexo-theme-stellar/releases"><img src="https://img.shields.io/github/v/release/xaoxuu/hexo-theme-stellar" alt="release"></a>
+    <a href="https://www.npmjs.com/package/hexo-theme-stellar"><img src="https://img.shields.io/npm/v/hexo-theme-stellar" alt="npm"></a>
+    <a href="https://www.npmjs.com/package/hexo-theme-stellar"><img src="https://img.shields.io/npm/dm/hexo-theme-stellar" alt="npm downloads"></a>
+    <a href="https://github.com/xaoxuu/hexo-theme-stellar"><img src="https://img.shields.io/github/stars/xaoxuu/hexo-theme-stellar" alt="stars"></a>
+    <a href="LICENSE"><img src="https://img.shields.io/github/license/xaoxuu/hexo-theme-stellar" alt="license"></a>
+  </p>
+  <p>
+    <a href="https://xaoxuu.com/wiki/stellar/start/install/">创建第一个博客</a> ·
+    <a href="https://xaoxuu.com/wiki/stellar/support/examples/">站点示例</a> ·
+    <a href="https://xaoxuu.com/wiki/stellar/">完整文档</a>
+  </p>
+</div>
 
-[简体中文](README.md) · [English](README_EN.md)
+## 在纷繁中建立秩序
 
-一个博客，也是一套可以长期生长的内容系统。
+> 真正的简约不止删繁就简，而是在纷繁中建立秩序。
 
-从一篇文章开始。以后想加项目文档、专栏或笔记，仍然在同一个站点里写。
+### 完善的内容组织体系
 
-[创建第一个博客](https://xaoxuu.com/wiki/stellar/start/install/) · [蓝图与展示墙](https://xaoxuu.com/wiki/stellar/support/examples/) · [完整文档](https://xaoxuu.com/wiki/stellar/)
+从普通文章开始。项目需要稳定的文档目录时，用 Wiki；文章逐渐形成系列时，收进专栏；零散知识需要长期积累时，放进笔记本。它们共享同一套导航、搜索、侧栏与阅读体验，没有启用的内容系统不会增加额外负担。
 
-> Stellar v2 当前版本为 `2.0.0-rc.1`；是否已经公开发布，以 npm 页面和 GitHub Releases 为准。
+### 灵活的排版与表达方式
 
-[![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)
+从外观预设、配色和字体，到分栏、选项卡、折叠块与图库，站点的样子和内容的表达方式都可以按需组合。本地搜索可以直接定位到相关章节，响应式布局会在窄屏上把主要空间留给正文。
 
-## 内容多起来，也不用推倒重来
+### 静态页面，也能常看常新
 
-普通文章照常发布。项目需要一套稳定目录时，用 Wiki；几篇文章写成了系列，收进专栏；零散知识想长期补充，放进笔记本。
+手写内容沉淀观点，外部数据保持新鲜。远程内容、社区数据和外部服务可以按需加载，与静态正文保持解耦；经常变化的数据不必每次都随整站重新生成。
 
-博客、Wiki、专栏和笔记本共享同一套导航、搜索、侧栏与阅读体验。只写博客时，其它系统不会跑出来打扰你。
+## 站点示例
 
-## 静态博客，也能放一些活的内容
+[Stellar Examples](https://github.com/xaoxuu/hexo-theme-stellar-examples/) 提供可以直接运行的示例站，适合先体验接近自己目标的站点，再逐步替换内容与配置。更多真实站点见[站点示例](https://xaoxuu.com/wiki/stellar/support/examples/)。
 
-动态时间线、自动友链、远程 README、GitHub 仓库与贡献者、评分和投票都可以按需接入。博客仍然是静态文件，但经常变化的内容不必每次都跟着整站重新部署。
+## 开始使用
 
-远程服务不会挡住正文先显示。接口暂时不可用时，文章仍然可以读。
-
-## 写作、检索和阅读是一件事
-
-提示框、折叠、标签页、图库、时间线、聊天和表格等内容组件可以互相组合。Markdown 表达不够时，不需要临时拼一套风格各异的插件。
-
-本地搜索由主题生成索引，结果可以直接落到文章章节；桌面端目录和信息栏到了手机上会变成抽屉，把位置让给正文。
+### 环境要求
 
-[内容组件](https://xaoxuu.com/wiki/stellar/reference/tags/) · [站内搜索](https://xaoxuu.com/wiki/stellar/guides/search/) · [外观与排版](https://xaoxuu.com/wiki/stellar/guides/appearance/)
+- Node.js 22 或更高版本
+- Hexo 8 或更高版本
 
-> 如果你只想写博客，它不会逼你理解这些系统；内容真的多起来时，它们已经在那里了。
+### 从蓝图创建
 
-## 选择一个起点
+准备好 Git 和 npm 后，一条命令即可启动交互式蓝图安装器：
 
-| 示例 | 适合什么样的站点 |
-| --- | --- |
-| 留白 · Light Blog | 安静写长文、随笔和生活记录 |
-| 星迹 · Blog | 使用经典侧栏整理文章、分类与专栏 |
-| 个人知识库 · Knowledge | 把博客、项目资料和长期主题放在一起 |
-| 项目文档 · Docs | 给一个项目维护清晰的文档目录 |
+```bash
+sh -c "$(curl -fsSL https://github.com/xaoxuu/hexo-theme-stellar-examples/raw/main/install.sh)"
+```
 
-示例源码在 [hexo-theme-stellar-examples](https://github.com/xaoxuu/hexo-theme-stellar-examples/)。
+安装器会读取示例仓库的 [`blueprints.json`](https://github.com/xaoxuu/hexo-theme-stellar-examples/blob/main/blueprints.json)，展示当前可用的蓝图，并依次确认蓝图、项目目录、依赖安装和创建计划。
 
-## 快速开始
+### 从 npm 安装
 
-### 环境要求
+在博客根目录安装 npm 当前提供的默认版本，并确认实际安装结果：
 
-```yaml
-Hexo: '>= 8'
-hexo-cli: 4.3.0 ~ latest
-node: '>= 22'
-npm: '>= 10'
+```bash
+npm install hexo-theme-stellar
+npm ls hexo-theme-stellar
 ```
 
-### 使用最新源码
+### 跟随最新源码
 
-在博客根目录添加主题源码并安装依赖：
+将官方仓库的 `main` 分支添加为子模块，并安装主题自身的依赖：
 
 ```bash
 git submodule add -b main https://github.com/xaoxuu/hexo-theme-stellar.git themes/stellar
 npm install --prefix themes/stellar
 ```
 
-然后在博客 `_config.yml` 中启用主题：
+### 启用并检查
+
+在博客 `_config.yml` 中启用主题：
 
 ```yaml
 theme: stellar
 ```
 
-运行 Doctor 和生成：
+然后运行 Doctor 并生成站点：
 
 ```bash
 npx hexo stellar doctor
@@ -84,29 +90,15 @@ npx hexo generate
 
 完整步骤见[环境与安装](https://xaoxuu.com/wiki/stellar/start/install/)和[创建第一个站点](https://xaoxuu.com/wiki/stellar/start/first-site/)。
 
-### 使用 npm 公开稳定版
-
-```bash
-npm install hexo-theme-stellar
-```
+## 文档与社区
 
-这条命令不保证安装到 v2。复制 v2 配置前，请先运行 `npm ls hexo-theme-stellar` 核对实际版本。
-
-## 文档
-
-- [从第一篇文章开始](https://xaoxuu.com/wiki/stellar/start/first-site/)
-- [把博客变成自己的样子](https://xaoxuu.com/wiki/stellar/start/configuration/)
-- [用 Wiki 写项目文档](https://xaoxuu.com/wiki/stellar/guides/wiki/)
-- [把文章整理成专栏](https://xaoxuu.com/wiki/stellar/guides/topic/)
-- [建立自己的笔记本](https://xaoxuu.com/wiki/stellar/guides/notebook/)
+- [配置自己的站点](https://xaoxuu.com/wiki/stellar/start/configuration/)
+- [使用内容组件](https://xaoxuu.com/wiki/stellar/reference/tags/)
+- [管理 Wiki、专栏与笔记本](https://xaoxuu.com/wiki/stellar/reference/collection/)
 - [主题配置参考](https://xaoxuu.com/wiki/stellar/reference/theme/)
 - [从 v1 迁移到 v2](https://xaoxuu.com/wiki/stellar/migration/v1-to-v2/)
-
-## 社区
-
 - [Issues](https://github.com/xaoxuu/hexo-theme-stellar/issues/)：反馈可以复现的问题
 - [Discussions](https://github.com/xaoxuu/hexo-theme-stellar/discussions/)：交流使用经验和想法
-- [蓝图与展示墙](https://xaoxuu.com/wiki/stellar/support/examples/)：看看不同的人怎样使用 Stellar
 - [贡献指南](CONTRIBUTING.md)：参与主题开发与文档维护
 
 ## 开源许可

package/README_EN.md

@@ -1,79 +1,102 @@
-# Stellar — a blog that can grow with your work
+<div align="center">
+  <img src="assets/icon-v2-x512.webp" width="160" alt="Stellar">
+  <h1>Stellar</h1>
+  <p>A blog that grows with your work</p>
+  <p>A complete, versatile, and feature-rich personal knowledge base designed to grow over time.</p>
+  <p><a href="README_EN.md">English</a> · <a href="README.md">简体中文</a></p>
+  <p>
+    <a href="https://github.com/xaoxuu/hexo-theme-stellar/releases"><img src="https://img.shields.io/github/v/release/xaoxuu/hexo-theme-stellar" alt="release"></a>
+    <a href="https://www.npmjs.com/package/hexo-theme-stellar"><img src="https://img.shields.io/npm/v/hexo-theme-stellar" alt="npm"></a>
+    <a href="https://www.npmjs.com/package/hexo-theme-stellar"><img src="https://img.shields.io/npm/dm/hexo-theme-stellar" alt="npm downloads"></a>
+    <a href="https://github.com/xaoxuu/hexo-theme-stellar"><img src="https://img.shields.io/github/stars/xaoxuu/hexo-theme-stellar" alt="stars"></a>
+    <a href="LICENSE"><img src="https://img.shields.io/github/license/xaoxuu/hexo-theme-stellar" alt="license"></a>
+  </p>
+  <p>
+    <a href="https://xaoxuu.com/wiki/stellar/start/install/">Create your first blog</a> ·
+    <a href="https://xaoxuu.com/wiki/stellar/support/examples/">Site examples</a> ·
+    <a href="https://xaoxuu.com/wiki/stellar/">Documentation</a>
+  </p>
+</div>
 
-[English](README_EN.md) · [简体中文](README.md)
+## Bring order to everything you publish
 
-Stellar can begin as a quiet personal blog and grow into a home for your articles, project documentation, series, and notes.
+> True simplicity is not just subtraction; it is creating order within complexity.
 
-[See the examples](https://xaoxuu.com/wiki/stellar/support/examples/) · [Getting started](https://xaoxuu.com/wiki/stellar/start/install/) · [Chinese documentation](https://xaoxuu.com/wiki/stellar/)
+### A complete system for organizing content
 
-> The current Stellar v2 version is `2.0.0-rc.1`. Check npm and GitHub Releases for its public availability.
+Start with regular posts. Give a project its own Wiki when it needs stable documentation, collect related posts into a Topic, and keep evolving knowledge in a Notebook. They share the same navigation, search, sidebars, and reading experience, while unused content systems stay out of the way.
 
-[![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)
+### Flexible layout and expression
 
-## Four kinds of content, one site
+From appearance presets, colors, and type to columns, tabs, folding sections, and galleries, you can shape both the site and the way its content is presented. Local search can take readers directly to a matching section, while responsive layouts leave the main space to the article on narrow screens.
 
-Publish regular blog posts as usual. Give a project its own Wiki when it needs stable navigation. Keep a series of posts together as a Topic, or collect smaller pieces of knowledge in a Notebook.
+### Static pages that stay fresh
 
-They share the same navigation, search, sidebars, and reading experience. If all you need is a blog, the other systems stay out of the way.
+Your writing preserves ideas while external data stays current. Remote content, community data, and external services can load on demand without being coupled to the static article, so frequently changing data does not require a full-site rebuild.
 
-## A static site with room for live data
+## Site examples
 
-Timelines, link status, remote README files, GitHub repositories and contributors, ratings, and polls can load when they are needed. Your site remains static, while frequently changing data does not require a full rebuild.
+[Stellar Examples](https://github.com/xaoxuu/hexo-theme-stellar-examples/) provides runnable sites you can explore before replacing their content and configuration at your own pace. Visit [Site examples](https://xaoxuu.com/wiki/stellar/support/examples/) for more real sites.
 
-The article remains readable when a remote service is unavailable.
+## Get started
 
-## Writing, finding, and reading belong together
+### Requirements
 
-Stellar includes content components for notes, folding sections, tabs, galleries, timelines, chat, tables, and more. Built-in local search can take a reader straight to a matching section. On smaller screens, navigation moves into drawers and leaves the page to the article.
+- Node.js 22 or newer
+- Hexo 8 or newer
 
-## Choose a starting point
+### Create from a Blueprint
 
-| Example | A good fit for |
-| --- | --- |
-| Light Blog | Essays, personal notes, and distraction-free reading |
-| Blog | A classic sidebar blog with categories and series |
-| Knowledge | A personal site combining articles and long-lived knowledge |
-| Docs | Documentation for a single project |
+With Git and npm available, launch the interactive Blueprint installer with one command:
 
-The source for these sites lives in the catalog-driven [hexo-theme-stellar-examples](https://github.com/xaoxuu/hexo-theme-stellar-examples/) repository.
+```bash
+sh -c "$(curl -fsSL https://github.com/xaoxuu/hexo-theme-stellar-examples/raw/main/install.sh)"
+```
+
+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
+
+Install the default version currently provided by npm, then confirm what was installed:
+
+```bash
+npm install hexo-theme-stellar
+npm ls hexo-theme-stellar
+```
 
-## Use the latest source
+### Follow the latest source
 
-You need Node.js 22 or newer and Hexo 8 or newer. In the root of an existing Hexo site:
+Add the official repository's `main` branch as a submodule and install the theme's own dependencies:
 
 ```bash
 git submodule add -b main https://github.com/xaoxuu/hexo-theme-stellar.git themes/stellar
 npm install --prefix themes/stellar
 ```
 
-Enable the theme in `_config.yml`:
+### Enable and check
+
+Enable the theme in your site's `_config.yml`:
 
 ```yaml
 theme: stellar
 ```
 
-Then check and build the site:
+Then run Doctor and generate the site:
 
 ```bash
 npx hexo stellar doctor
 npx hexo generate
 ```
 
-The full v2 documentation is currently maintained in Chinese. The example repository provides an English quick start and complete runnable sites that can be explored without reading the whole reference.
-
-## Stable npm release
-
-```bash
-npm install hexo-theme-stellar
-```
-
-This command may still install v1. Run `npm ls hexo-theme-stellar` before using any v2 configuration.
+See [Installation](https://xaoxuu.com/wiki/stellar/start/install/) and [Create your first site](https://xaoxuu.com/wiki/stellar/start/first-site/) for the complete workflow.
 
-## Community
+## Documentation and community
 
+- [Configure your site](https://xaoxuu.com/wiki/stellar/start/configuration/)
+- [Use content components](https://xaoxuu.com/wiki/stellar/reference/tags/)
+- [Manage Wikis, Topics, and Notebooks](https://xaoxuu.com/wiki/stellar/reference/collection/)
+- [Theme configuration reference](https://xaoxuu.com/wiki/stellar/reference/theme/)
+- [Migrate from v1 to v2](https://xaoxuu.com/wiki/stellar/migration/v1-to-v2/)
 - [Issues](https://github.com/xaoxuu/hexo-theme-stellar/issues/) for reproducible problems
 - [Discussions](https://github.com/xaoxuu/hexo-theme-stellar/discussions/) for ideas and usage questions
 - [Contributing](CONTRIBUTING.md) for code and documentation work