0.3.2

[0.3.2] 2026-08-07

🚀 Added

• Background image previews: Show a compact source preview beside the Image value controls and a full Appearance preview that reflects the configured opacity, blend mode, sizing, positioning, repeat, and filters.

⚡ Changed

• Efficient live updates: Apply Appearance changes only to the background service and update only CSS custom properties whose values changed, avoiding unrelated resource, theme, and note-path work while adjusting controls.

🐛 Fixed

• Official review compliance: Move background-layer rules into the static plugin stylesheet and publish runtime background and resource values through CSS custom properties, eliminating forbidden runtime <style> elements and lint suppressions.
• Image value guidance: Explain that bare custom properties such as --image must be wrapped as var(--image), with localized guidance to copy a ready-to-use variable from its preview.
• Responsive Image value layout: Keep the input and shuffle button together, place the preview and validation feedback on separate rows, and wrap long CSS image examples within narrow settings panes.

中文说明（点击展开）

🚀 新增

• 背景图片预览：在「图片值」控件旁显示紧凑的源图片预览，并在「外观」页面显示完整预览，实时反映不透明度、混合模式、尺寸、位置、重复方式和滤镜设置。

⚡ 变更

• 高效实时更新：调整外观控件时仅应用背景服务，并只更新值发生变化的 CSS 自定义属性，避免重复执行无关的资源变量、主题和笔记路径处理。

🐛 修复

• 官方审核合规性：将背景图层规则迁移至插件静态样式表，并通过 CSS 自定义属性发布运行时背景与资源值，彻底移除审核禁止的运行时 <style> 元素和 lint 规则禁用指令。
• 图片值输入指引：输入 --image 等裸 CSS 自定义属性时，明确提示使用 var(--image) 包裹，并引导用户点击预览复制可直接使用的变量值。
• 图片值响应式布局：保持输入框与随机按钮位于同一行，将预览和校验提示分别放置在后续行，并确保窄设置面板中的长 CSS 图片示例能够正常换行。

[0.3.1] 2026-08-07

🚀 Added

• Flexible background image values: Accept complete CSS background-image expressions such as var(--image), remote url(...) values, and gradients, with syntax validation and a privacy notice for remote image hosts.

⚡ Changed

• Ready-to-use image references: Store the built-in background as an imageValue and make random selection insert var(--name) so copied local image references can be pasted directly.
• Obsidian DOM helpers: Create dynamic style and diagnostics elements with Obsidian's createEl and createDiv helpers for API compliance.

中文说明（点击展开）

🚀 新增

• 灵活的背景图片值：支持填写完整的 CSS background-image 表达式，例如 var(--image)、远程 url(...) 和渐变，并提供语法校验与远程图片隐私提示。

⚡ 变更

• 可直接使用的图片引用：内置背景改为保存 imageValue，随机选择会直接填入 var(--name)，复制的本地图片引用可以直接粘贴使用。
• Obsidian DOM 辅助方法：动态样式和诊断元素改用 Obsidian 的 createEl 与 createDiv，符合官方 API 规范。

[0.3.0] 2026-08-06

🚀 Added

• Built-in background image: Apply an enabled local image variable to the Obsidian canvas with random selection, opacity, blend mode, size, position, repeat, and attachment controls.
• Background filters: Adjust the background image layer with CSS filters — brightness, contrast, saturation, grayscale, sepia, invert, hue rotate, and blur — from the new Appearance sub-page.

⚡ Changed

• Declarative settings on Obsidian 1.13: The settings tab now uses the declarative settings API introduced in Obsidian 1.13.0, raising the minimum required Obsidian version to 1.13.0. Background display options (opacity, blend mode, size, position, repeat, attachment) and filters are grouped together in an Appearance sub-page under Background image.

🐛 Fixed

• Resource variable publishing: Publish vault resource variables in a dedicated stylesheet so they remain available to computed-style consumers without modifying the html element's inline style.
• Resource variable preview: Read computed styles when validating image variables, keeping the settings preview working with stylesheet-published variables.

中文说明（点击展开）

🚀 新增

• 内置背景图片：将已启用的本地图片变量直接应用到 Obsidian 画布，支持随机选择、不透明度、混合模式、尺寸、位置、重复方式和附着方式设置。
• 背景滤镜：在新的「外观」子页面中使用 CSS 滤镜调整背景图片图层——亮度、对比度、饱和度、灰度、褐色、反色、色相旋转和模糊。

⚡ 变更

• 基于 Obsidian 1.13 的声明式设置：设置页改用 Obsidian 1.13.0 引入的声明式设置 API，最低所需 Obsidian 版本提升至 1.13.0。背景显示选项（不透明度、混合模式、尺寸、位置、重复方式、附着方式）与滤镜一同归入「背景图片」下的「外观」子页面。

🐛 修复

• 资源变量发布：将库内资源变量发布到专用样式表中，使其可被计算样式读取，同时避免修改 html 元素的内联样式。
• 资源变量预览：校验图片变量时读取计算样式，确保变量改用样式表发布后设置页预览仍能正常工作。