feat(ui): 候选标签换行符渲染为 ↵ 防御单行布局

候选窗口的候选标签是单行控件, candidate.Text 含真实换行符 (\r/\n) 时
会撑破布局或与相邻候选重叠。

- 新增 CandidateNewlineGlyph = '↵', 作为可调常量集中定义 (字体兼容
  可调, 与 CmdbarCandidatePrefix 同类设计)。
- 包级 strings.NewReplacer 把 \r\n / \r / \n 替换为单个符号 (\r\n 列在
  最前, NewReplacer 按参数顺序优先匹配, 保证 CRLF 折叠为一个符号)。
- 改造 candidateDisplayText 在 candidateNewlineReplacer.Replace 之后再
  拼 CmdbarCandidatePrefix; candidate.Text 自身不变, 上屏多行仍多行。
- 防御范围与转义来源无关 — 不论换行符是解码而来还是用户/词库里本就
  存在, 渲染层一律替换。

Author: huanfeng

wind_input/internal/ui/renderer_layout.go

@@ -5,6 +5,7 @@ import (
 	"image"
 	"image/color"
 	"math"
+	"strings"
 
 	"github.com/huanfeng/wind_input/pkg/config"
 )
@@ -16,13 +17,32 @@ import (
 // 历史记录和右键菜单文案。
 const CmdbarCandidatePrefix = "⚡"
 
-// candidateDisplayText 返回候选实际渲染到候选框的文本。命令直通车候选 (Actions
-// 非空) 在 Text 前加 CmdbarCandidatePrefix 作为视觉标识。
+// CandidateNewlineGlyph 候选标签中换行符 (\r / \n) 的占位渲染符号。
+// 候选框是单行控件, 候选文本含真实换行会撑破布局或与相邻候选重叠,
+// 故渲染前统一替换为该符号。candidate.Text 本身不受影响 (上屏仍多行)。
+// 不同字体渲染效果可能有差异, 后续可调 (如改用 ⏎ / ¶)。
+const CandidateNewlineGlyph = "↵"
+
+// candidateNewlineReplacer 把候选文本里的换行符折叠为 CandidateNewlineGlyph。
+// \r\n 列在最前, NewReplacer 按参数顺序优先匹配, 保证 CRLF 折叠为单个符号。
+var candidateNewlineReplacer = strings.NewReplacer(
+	"\r\n", CandidateNewlineGlyph,
+	"\r", CandidateNewlineGlyph,
+	"\n", CandidateNewlineGlyph,
+)
+
+// candidateDisplayText 返回候选实际渲染到候选框的文本。
+//   - 换行符 (\r / \n) 替换为 CandidateNewlineGlyph, 保证单行渲染;
+//   - 命令直通车候选 (Actions 非空) 在文本前加 CmdbarCandidatePrefix。
+//
+// candidate 自身的 Text 字段保持原状, 仅渲染时变换, 避免污染历史记录与
+// 右键菜单文案。
 func candidateDisplayText(cand Candidate) string {
+	text := candidateNewlineReplacer.Replace(cand.Text)
 	if len(cand.Actions) > 0 {
-		return CmdbarCandidatePrefix + cand.Text
+		return CmdbarCandidatePrefix + text
 	}
-	return cand.Text
+	return text
 }
 
 // pagerFontSize returns the font size for the pager indicator (e.g. "1/3").

wind_input/internal/ui/renderer_layout_test.go

@@ -0,0 +1,31 @@
+package ui
+
+import (
+	"testing"
+
+	"github.com/huanfeng/wind_input/internal/cmdbar"
+)
+
+func TestCandidateDisplayText_NewlineGlyph(t *testing.T) {
+	withAction := Candidate{Text: "打开"}
+	withAction.Actions = make([]cmdbar.ResolvedAction, 1)
+
+	cases := []struct {
+		name string
+		cand Candidate
+		want string
+	}{
+		{"plain no newline", Candidate{Text: "你好"}, "你好"},
+		{"lf replaced", Candidate{Text: "行1\n行2"}, "行1" + CandidateNewlineGlyph + "行2"},
+		{"cr replaced", Candidate{Text: "行1\r行2"}, "行1" + CandidateNewlineGlyph + "行2"},
+		{"crlf folds to one glyph", Candidate{Text: "行1\r\n行2"}, "行1" + CandidateNewlineGlyph + "行2"},
+		{"command prefix kept", withAction, CmdbarCandidatePrefix + "打开"},
+	}
+	for _, tc := range cases {
+		t.Run(tc.name, func(t *testing.T) {
+			if got := candidateDisplayText(tc.cand); got != tc.want {
+				t.Fatalf("candidateDisplayText = %q, want %q", got, tc.want)
+			}
+		})
+	}
+}