Release 0.4.1 · Moyf/style-context

[0.4.1] 2026-09-09

Shuffle button hint: The image value row now shows a visible hint under the input explaining that the shuffle button picks one of the local image variables — the explanation moved out of the crowded field description.

中文说明（点击展开）

Per-image random scope: Each registered image variable can now choose which random background pools include it — all (default), light only, dark only, or none. The choice lives on a compact icon button that opens the picker on click.
Settings page restructure: The image variable list and the note path rules moved into their own subpages. The add button was repositioned and a filter box added for when the list grows long.
Appearance reset all: Each Appearance page now ends with a "Reset all" button that restores every parameter on the page — display, filter, and layout — to that mode's defaults. The image value itself is not part of the page and stays untouched.

Filter slider ranges: Brightness, contrast, and saturate cap at 150% (down from 200%) since values beyond that are rarely useful, and the blur slider now steps in whole pixels (1 px instead of 0.5 px). Saved values above the new caps are kept until the slider is moved.
Bare variable names in Image value: The background image value now accepts a bare custom property name — typing --image-1 is stored as var(--image-1) automatically, so both forms validate, preview, and resolve identically.
No-repeat randomness: Randomizing the background image now keeps an in-memory cache of the last three picks and avoids them, so consecutive randoms no longer alternate between the same images.
Diagnostics panel polish: The "Live status" panel is capped at 400 px and scrolls internally, so long rule lists no longer stretch the settings page.

Preview tile on first open: Image preview tiles now refresh immediately after typing a vault path, including the first settings open after a plugin reload — the variable is republished into the settings document directly instead of relying on activeDocument, which can lag on detached settings windows.
Add button overflow: In narrow panels the button now shrinks and truncates its label with an ellipsis ("Add image...") instead of overflowing the frame.
Diagnostics panel visible again: The "Live status" panel is now anchored inside its setting row. Obsidian 1.14's declarative settings re-render silently detaches extra siblings placed in the group list, which left the panel empty; wrapping the row keeps the panel on its own full-width line and preserves it across re-renders.

中文说明（点击展开）

图片随机范围：每个注册的图片变量现在可以选择参与哪些随机背景池——全部（默认）、仅亮色、仅暗色，或不参与随机。选项收纳在一个紧凑的图标按钮上，点击弹出选择菜单。
设置页面重构：图片变量列表和笔记路径规则移入独立的子页面。调整添加按钮的位置，并增加过滤框，用于列表项目较多的时候。
外观页全部重置：每个外观页底部新增「全部重置」按钮，一键将该页显示、滤镜、布局参数恢复到对应模式的默认值。图片值本身不属于该页，不会被改动。

滤镜滑块范围：亮度、对比度、饱和度上限从 200% 降为 150%（更高的值很少实用）；模糊滑块步长改为整像素（1 px，原为 0.5 px）。已保存的超上限数值会保留，直到再次拖动滑块。
图片值支持裸变量名：背景图片值现在接受不带 var() 的变量名——输入 --image-1 会自动存为 var(--image-1)，两种写法的校验、预览和解析行为完全一致。
随机不重复：随机背景图现在会在内存中缓存最近三次的选择并避开它们，连续随机不再出现来回切换的情况。
诊断面板优化：「实时状态」面板高度上限 400 px，内部滚动，超长规则列表不再拉长设置页。

首次打开时预览不刷新：输入路径后图片预览立即刷新，包括插件重载后第一次打开设置页的情况——现在直接向设置页所在文档重新发布变量，不再依赖在独立设置窗口可能滞后更新的 activeDocument。
添加按钮溢出：窄面板下按钮自动收缩并以省略号截断文字（"Add image..."），不再超出边框。
诊断面板重新可见：「实时状态」面板现在固定在所属设置行内部。Obsidian 1.14 的声明式设置重渲染时会静默移除挂在分组列表里的额外兄弟节点，导致面板空白；让设置行换行后，面板独占一行并在重渲染后保持可见。