可选资源包

• 桌面版0.2.8 已提供
• 网页版不适用

什么是资源包#

基础下载保持小巧。额外的插画、壁纸、媒体、分享卡素材或本地模型等可选内容，可以以资源包（.gspack 文件）的形式添加。不安装任何资源包，两套界面方案也都能使用；缺少可选素材时会使用内置外观，设置中也会注明。

第一个示例是 B 配置页头插画，由栞已有的美术素材制作。安装后，如果你使用默认壁纸，B 方案会在页头显示它；否则使用内置插画（“B 配置的额外页头插画未安装，正在使用内置插画。”）。应用本身不附带任何资源包。

在哪里管理#

“设置 → 媒体与下载 → 可选资源包”会列出每个已安装的资源包，显示类型、版本、大小、来源、许可、签名状态，以及保留的上一个可用版本。

资源包的声明#

每个资源包都有清单（格式 galshelf-pack/1），写明：编号、类型（壁纸、媒体、分享卡、界面素材或模型）、版本、适用的栞版本、依赖的其他资源包、提供的内容、每个文件的大小和 SHA-256、总大小、来源与许可、可选的签名信息，模型资源包还会写明所需的运行环境。

安装与校验#

1. 选择从文件安装资源包…（桌面客户端），然后选择一个 .gspack 文件。不会从网络下载任何内容。
2. 资源包先复制到暂存区并逐项检查：每个文件都必须在清单中声明，且大小和 SHA-256 一致；不安全的路径、链接、程序和脚本（包括 .js、.html 和 .svg）都会被拒绝。上限为 2,000 个文件、单个文件 2 GB、总计 8 GB。
3. 只有完全通过校验的资源包才会一次性启用，保存到 %LOCALAPPDATA%\GalShelf\packs\installed\<编号>\<版本>。中断的安装留下的临时文件会在下次启动时清理。

任何一步失败，都不会有改动，之前的状态继续生效。

签名#

资源包的签名会显示出来，但目前还不会校验：还没有可信发布者的公钥。列表会显示“未签名（来自本地文件）”“有签名但无法验证”或“签名未经受信发布者验证”。请只安装来自可信来源的资源包。

资源包不含代码#

资源包只包含素材和预设，从不包含程序或脚本，无法在你的电脑上运行代码。

回退、移除与重新安装#

• 回到上一个版本会切换回保留的上一个可用版本。
• 移除资源包会删除该资源包的所有已安装版本；如果有其他已安装的资源包依赖它，会拒绝移除。
• 重新安装只需再次安装该文件。
• 移除后，受影响的界面会回到内置素材，书架和设置不受影响。

离线#

资源包从本地文件安装，所以安装和使用都可以离线进行。