feat(shadow): 候选窗支持 blur+spread 浮动投影，画布扩展后以内容尺寸定位

新增 ViewShadow.Blur / Spread 字段，通过 3 次 box blur 近似高斯模糊实现
WeChat 输入法风格的四向扩散投影（blur+spread+color 可主题化配置）。

渲染层：paintBlurredShadow 在临时缓冲上绘制扩散色块、3-sigma box blur
平滑 alpha 过渡，再以 src-over 合成到主画布；3-sigma 公式
（pad = ceil(3×sqrt(blur×(blur+2)))+2）保证渐变不被截断。

布局层：shadowMargins 返回四向 padding（blur+spread+offset 共同决定），
renderTree 用 (marginLeft, marginTop) 偏移内容布局、扩展画布。
RenderResult 回传四向 margin，doShowCandidates 据此以内容尺寸（去阴影后）
调用 AdjustCandidatePosition，结果再减 (marginLeft, marginTop) 得到画布
屏幕坐标，确保内容区域精确对准光标，消除阴影扩展引入的位置偏移。

主题层：views.window.shadow 新增 blur / spread 字段（Dimension 类型，支持 dp
和百分比）；capability.json 标记 CapShadowBlurSpread 为 supported；
更新受影响的 golden 快照与几何指纹。

Author: huanfeng

wind_input/internal/ui/manager_candidate.go

@@ -202,8 +202,27 @@ func (m *Manager) doShowCandidates(candidates []Candidate, input string, cursorP
 		if m.renderer != nil && m.renderer.GetLayout() == config.LayoutHorizontal {
 			layout = LayoutHorizontal
 		}
+		// 阴影画布四向扩展了 shadowMargin 像素，定位应以内容尺寸（不含阴影）为基准，
+		// 再把画布整体左移/上移 margin，使内容区域精确对准光标。
+		sml, smt, smr, smb := 0, 0, 0, 0
+		if renderResult != nil {
+			sml = renderResult.ShadowMarginLeft
+			smt = renderResult.ShadowMarginTop
+			smr = renderResult.ShadowMarginRight
+			smb = renderResult.ShadowMarginBottom
+		}
+		contentW := windowWidth - sml - smr
+		contentH := windowHeight - smt - smb
+		if contentW < 1 {
+			contentW = 1
+		}
+		if contentH < 1 {
+			contentH = 1
+		}
 		var showAbove bool
-		windowX, windowY, showAbove = AdjustCandidatePosition(caretX, caretY, caretHeight, windowWidth, windowHeight, layout, preference)
+		windowX, windowY, showAbove = AdjustCandidatePosition(caretX, caretY, caretHeight, contentW, contentH, layout, preference)
+		windowX -= sml
+		windowY -= smt
 		m.logger.Debug("Position adjusted", "windowX", windowX, "windowY", windowY, "showAbove", showAbove, "stickyAbove", currentStickyAbove)
 
 		// Update sticky state if we're now showing above

wind_input/internal/ui/protocol.go

@@ -20,6 +20,11 @@ type RenderResult struct {
 	Rects        []CandidateRect // Bounding rectangles for each candidate
 	PageUpRect   *CandidateRect  // Bounding rectangle for page up button
 	PageDownRect *CandidateRect  // Bounding rectangle for page down button
+	// 阴影画布四向扩展量（像素）。blur/spread>0 时非零，用于将画布坐标还原为内容坐标。
+	ShadowMarginLeft   int
+	ShadowMarginTop    int
+	ShadowMarginRight  int
+	ShadowMarginBottom int
 }
 
 // CandidateCallback defines callbacks for candidate window interactions

wind_input/internal/ui/viewbox_build_vertical.go

@@ -271,7 +271,7 @@ func (r *Renderer) buildVerticalCandidateTree(
 		Padding:    Edges{Top: scD(rv.Window.PadTop), Right: scD(rv.Window.PadRight), Bottom: scD(rv.Window.PadBottom), Left: scD(rv.Window.PadLeft)}, // 完整遵循主题 window.padding 四边
 		Background: r.fillFor(r.resolvedViews.Window.BgColor, r.resolvedViews.Window.BgImage, r.resolvedViews.Window.BgGradient, scale),               // P7-C：背景图来自 views.window.background.image
 		Border:     r.windowBorder(rv.Window.BorderRadius.Scaled(scale), sc, scale),
-		Shadow:     &ViewShadow{OffsetX: rv.ShadowOffsetX.Scaled(scale), OffsetY: rv.ShadowOffsetY.Scaled(scale), Color: r.resolvedViews.ShadowColor},
+		Shadow:     &ViewShadow{OffsetX: rv.ShadowOffsetX.Scaled(scale), OffsetY: rv.ShadowOffsetY.Scaled(scale), Blur: rv.ShadowBlur.Scaled(scale), Spread: rv.ShadowSpread.Scaled(scale), Color: r.resolvedViews.ShadowColor},
 		Children:   bands,
 	}
 	r.appendThemeLayers(window, rv.Window.Layers, sc) // P7-C：窗口装饰层（水印等）

wind_input/internal/ui/viewbox_render.go

@@ -11,6 +11,28 @@ import (
 	"github.com/huanfeng/wind_input/pkg/theme"
 )
 
+// shadowMargins 返回窗口画布为投影额外预留的四向 margin（像素）。
+// blur/spread > 0 时四向扩展（与 paintBlurredShadow 的 3-sigma 公式对齐）；
+// 否则仅右下留出偏移空间（向后兼容无模糊投影）。sh==nil 或 Color==nil 时全零。
+func shadowMargins(sh *ViewShadow) (marginLeft, marginTop, marginRight, marginBottom int) {
+	if sh == nil || sh.Color == nil {
+		return
+	}
+	if sh.Blur > 0 || sh.Spread > 0 {
+		sigma := math.Sqrt(float64(sh.Blur) * float64(sh.Blur+2))
+		pad := int(math.Ceil(3*sigma)) + 2
+		base := pad + sh.Spread
+		marginLeft = base + maxInt(-sh.OffsetX, 0)
+		marginTop = base + maxInt(-sh.OffsetY, 0)
+		marginRight = base + maxInt(sh.OffsetX, 0)
+		marginBottom = base + maxInt(sh.OffsetY, 0)
+	} else {
+		marginRight = maxInt(sh.OffsetX, 0)
+		marginBottom = maxInt(sh.OffsetY, 0)
+	}
+	return
+}
+
 // refreshResolvedViews 重建 r.resolvedViews，由渲染入口 render*V2 每次调用。
 // 候选窗外观直接消费 theme 包解析结果 ResolveCandidateViews（views 已 merge defaultViews
 // 基线、几何+颜色权威）；字号/行高/竖排宽是运行时值（用户全局字号派生 + DPI scale），在此回填。
@@ -95,23 +117,7 @@ func (r *Renderer) renderTree(tree *candWindowTree) (*image.RGBA, *RenderResult)
 	root := tree.root
 
 	// 先计算阴影四向 margin，再以 (marginLeft, marginTop) 为起点 layout。
-	// blur/spread > 0：四向扩展，offset 决定不对称量；否则退化为旧右下扩展。
-	marginLeft, marginTop, marginRight, marginBottom := 0, 0, 0, 0
-	if sh := root.Shadow; sh != nil {
-		if sh.Blur > 0 || sh.Spread > 0 {
-			// 与 paintBlurredShadow 相同的公式：3-sigma 覆盖 99.7% 模糊梯度。
-			sigma := math.Sqrt(float64(sh.Blur) * float64(sh.Blur+2))
-			pad := int(math.Ceil(3*sigma)) + 2
-			base := pad + sh.Spread
-			marginLeft = base + maxInt(-sh.OffsetX, 0)
-			marginTop = base + maxInt(-sh.OffsetY, 0)
-			marginRight = base + maxInt(sh.OffsetX, 0)
-			marginBottom = base + maxInt(sh.OffsetY, 0)
-		} else {
-			marginRight = maxInt(sh.OffsetX, 0)
-			marginBottom = maxInt(sh.OffsetY, 0)
-		}
-	}
+	marginLeft, marginTop, marginRight, marginBottom := shadowMargins(root.Shadow)
 	Layout(root, marginLeft, marginTop, td)
 
 	w := root.Rect().Dx() + marginLeft + marginRight
@@ -127,7 +133,13 @@ func (r *Renderer) renderTree(tree *candWindowTree) (*image.RGBA, *RenderResult)
 	PaintTree(root, dc, img, td)
 	DrawDebugBanner(img)
 
-	res := &RenderResult{Rects: make([]CandidateRect, len(tree.items))}
+	res := &RenderResult{
+		Rects:              make([]CandidateRect, len(tree.items)),
+		ShadowMarginLeft:   marginLeft,
+		ShadowMarginTop:    marginTop,
+		ShadowMarginRight:  marginRight,
+		ShadowMarginBottom: marginBottom,
+	}
 	for i, it := range tree.items {
 		res.Rects[i] = rectOf(i, it)
 	}

wind_input/pkg/theme/candidate_views.go

@@ -97,6 +97,16 @@ func resolveViewNode(n ViewNode, resolveColor func(ColorRef) color.Color, defBg,
 	if n.NextChar != nil {
 		out.NextChar = *n.NextChar
 	}
+	// shadow：候选窗 views.window.shadow / 简单窗口 views.status|tooltip|toast.shadow 共用此解析。
+	if sh := n.Shadow; sh != nil {
+		out.ShadowOffsetX = dimOr(sh.OffsetX, Dimension{})
+		out.ShadowOffsetY = dimOr(sh.OffsetY, Dimension{})
+		out.ShadowBlur = dimOr(sh.Blur, Dimension{})
+		out.ShadowSpread = dimOr(sh.Spread, Dimension{})
+		if c := resolveColor(sh.Color); c != nil {
+			out.ShadowColor = c
+		}
+	}
 	return out
 }
 

wind_input/pkg/theme/views.go

@@ -113,7 +113,7 @@ type ViewNode struct {
 	Layers     []ViewImage `yaml:"layers,omitempty"` // z 层级覆盖图（P7-C，D4）：z<0 在内容下、z>0 在上
 
 	// 仅特定节点字段（V3-D 属性归位）：
-	Shadow      *ViewShadowSpec `yaml:"shadow,omitempty"`       // 仅 window：窗口投影（offset/color 已实现，blur/spread 预留）
+	Shadow      *ViewShadowSpec `yaml:"shadow,omitempty"`       // 窗口投影（候选窗=views.window.shadow；简单窗口=views.status/tooltip/toast.shadow）
 	Gap         *Dimension      `yaml:"gap,omitempty"`          // 仅 candidate_list：横排候选项**横向**间距基数（旧 metrics.item_spacing）
 	BandGap     *Dimension      `yaml:"band_gap,omitempty"`     // 仅 candidate_list：band 间距（旧 metrics.band_gap → WindowGap）
 	RowGap      *Dimension      `yaml:"row_gap,omitempty"`      // 仅 candidate_list：竖排候选项**纵向**（行）间距；nil/0=紧贴（横排不用，横向间距走 gap）
@@ -158,7 +158,7 @@ type Views struct {
 	Menu          *MenuViews    `yaml:"menu,omitempty"`       // P4-D 弹出菜单
 }
 
-// ViewShadowSpec 结构化窗口投影（P7-E）。offset_x/offset_y/color 已实现；blur/spread 为预留字段（渲染 later）。
+// ViewShadowSpec 结构化窗口投影（P7-E）。offset_x/offset_y/color/blur/spread 均已实现。
 // V3-D：归位到 window 节点（views.window.shadow）。优先级：Shadow 非 nil 时其 offset/color
 // 覆盖 ShadowOffset 默认 + palette.Shadow；未给的子字段回退。
 type ViewShadowSpec struct {
@@ -228,6 +228,9 @@ type RVNode struct {
 	PrevImage, NextImage                             *RVImage    // 仅 footer_bar：上/下翻页箭头图（替代内置字符，可 SVG + tint）；nil=用字符
 	PrevChar, NextChar                               string      // 仅 footer_bar：上/下翻页字符；空=内置默认（❮/❯）；PrevImage/NextImage 非 nil 时不消费
 	LineSpacing, ColGap, TitleGap                    Dimension   // 多行/多列布局间距（tooltip/toast 专用；零值=渲染层兜底现状）
+	ShadowOffsetX, ShadowOffsetY                     Dimension   // 窗口投影偏移（status/tooltip/toast 由 resolveViewNode 填充）
+	ShadowBlur, ShadowSpread                         Dimension   // 投影模糊/扩散半径
+	ShadowColor                                      color.Color // nil=无投影（简单窗口不继承 palette.Shadow 默认）
 }
 
 // ResolvedViews 候选窗各具名 View 的解析后外观（plain 逻辑像素，渲染器直接读）。