tttools/settings.go

// ============================================================================
// settings.go — 应用配置
//
// AppSettings 结构体（含各 Tab 设置项）、默认值、字段校验（normalizeSettings）、
// 配置读写（loadSettings/saveSettings）与运行时应用（applySettings）。
// ============================================================================
package main

import (
	"crypto/rand"
	"encoding/hex"
	"encoding/json"
	"fmt"
	"log"
	"os"
	"path/filepath"
	"strings"
	"sync"
)

// 默认配置：首次运行或字段为空时使用
const (
	DefaultHotkey                 = "CmdOrCtrl+Shift+G" // 默认呼出窗口热键
	DefaultAPIAddr                = "127.0.0.1:17890"   // 内置 Gin API 服务默认监听地址（仅本机）
	DefaultStockUpColor           = "#ff5a5a"           // 股票上涨颜色（红涨）
	DefaultStockDownColor         = "#4d8dff"           // 股票下跌颜色（蓝跌）
	DefaultStockRefreshSecs       = 30                  // 股市自动刷新间隔（秒）
	DefaultStockClosedRefreshSecs = 7200                // 股市休市时自动刷新间隔（秒），默认 2 小时
	DefaultNewsRefreshMinutes     = 120                 // 新闻自动刷新间隔（分钟）
	DefaultNewsCount              = 30                  // 新闻页显示条数
	DefaultGithubRefreshMinutes   = 120                 // Github 自动刷新间隔（分钟）
	AppVersion                    = "0.1.4"             // 应用自身版本（与 build/windows/info.json 的 ProductVersion 一致），用于仓库更新提示

	// 鼠标提醒默认配置
	DefaultMouseAlertFontSize     = 20        // 字号（px）
	DefaultMouseAlertWidth        = 200       // 气泡窗口宽度（px）
	DefaultMouseAlertSpeed        = 33        // 超长文字滚动速度（px/s）
	DefaultMouseAlertColor        = "#ffffff" // 文字颜色（白）
	DefaultMouseAlertDuration     = 8         // 显示时长（秒）
	DefaultMouseAlertOutlineColor = "#000000" // 文字描边颜色（黑边，与白字形成反差）
	DefaultMouseAlertOutlineWidth = 2         // 文字描边宽度（px），0 表示关闭
)

// LinkItem 常用网址条目
type LinkItem struct {
	Name string `json:"name"` // 网站名称
	URL  string `json:"url"`  // 网站地址
}

// CustomTab 用户自定义 Tab 页面
type CustomTab struct {
	Name string `json:"name"` // 页面名称（Tab 按钮显示文字）
	URL  string `json:"url"`  // 页面地址（iframe 加载）
	Desc string `json:"desc"` // 备注/提示信息（可空），Tab 说明文字优先显示
}

// RepoItem 关注的 GitHub 仓库条目
type RepoItem struct {
	URL     string `json:"url"`     // 仓库地址，如 https://github.com/wailsapp/wails
	Desc    string `json:"desc"`    // 项目说明
	Version string `json:"version"` // 本地已安装版本（用于与最新 release 比较），可为空
}

// TickerConfig 置顶滚动条（股票 / 新闻）的显示配置
type TickerConfig struct {
	Enabled     bool   `json:"enabled"`     // 是否显示滚动条窗口
	Width       int    `json:"width"`       // 窗口宽度（px），0 表示默认 1400
	FontSize    int    `json:"fontSize"`    // 字号（px）
	Color       string `json:"color"`       // 文字颜色
	Speed       int    `json:"speed"`       // 滚动速度（px/s）
	Transparent bool   `json:"transparent"` // 背景透明，不遮挡下方内容
	X           int    `json:"x"`           // 窗口位置，-1 表示未设置（系统默认位置）
	Y           int    `json:"y"`           // 窗口位置，-1 表示未设置
}

// MouseAlertConfig 系统级鼠标提醒气泡的显示配置
type MouseAlertConfig struct {
	FontSize     int    `json:"fontSize"`     // 字号（px）
	Width        int    `json:"width"`        // 气泡窗口宽度（px）
	Speed        int    `json:"speed"`        // 超长文字滚动速度（px/s）
	Color        string `json:"color"`        // 文字颜色
	Background   string `json:"background"`   // 气泡背景色（COLORKEY 抠成透明，仅作底色参考）
	Duration     int    `json:"duration"`     // 显示时长（秒）
	OutlineColor string `json:"outlineColor"` // 文字描边颜色（白边/黑边，与文字形成反差）
	OutlineWidth int    `json:"outlineWidth"` // 文字描边宽度（px），0 表示关闭描边
}

// AppSettings 保存全部可自定义配置，序列化为 JSON 存于用户配置目录
type AppSettings struct {
	Theme          string           `json:"theme"`          // 界面主题：dark / light
	Autostart      bool             `json:"autostart"`      // 系统启动时运行
	AlwaysOnTop    bool             `json:"alwaysOnTop"`    // 窗口置顶
	StartCompact   bool             `json:"startCompact"`   // 启动时自动收拢为圆点（窗口缩小）
	Hotkey         string           `json:"hotkey"`         // 呼出（显示）窗口的全局热键
	TabOrder       []string         `json:"tabOrder"`       // Tab 显示顺序（tabId 列表，未列出的追加到末尾）
	StockCodes     []string         `json:"stockCodes"`     // 股市页展示的股票代码列表
	Links          []LinkItem       `json:"links"`          // 常用网址列表
	NewsKeywords   string           `json:"newsKeywords"`   // 新闻关注关键词，逗号分隔
	BiliCookie     string           `json:"biliCookie"`     // B站登录 cookie（含 SESSDATA），用于抓取「关注的人最新动态」
	GithubRepos    []RepoItem       `json:"githubRepos"`    // 关注的 GitHub 仓库列表
	CustomTabs     []CustomTab      `json:"customTabs"`     // 用户自定义 Tab 页面（名字 + 网址）
	APIAddr        string           `json:"apiAddr"`        // 内置 API 服务监听地址
	APIAutoStart   bool             `json:"apiAutoStart"`   // 应用启动时自动启动内置 API 服务（默认开启）
	UploadPassword string           `json:"uploadPassword"` // 文件上传密码（空=不启用上传/下载接口）
	UploadDir      string           `json:"uploadDir"`      // 文件上传保存目录（空=用户配置目录/uploads）
	UploadMaxSize  int              `json:"uploadMaxSize"`  // 单个上传文件大小上限（MB），<=0 用默认 512
	TodoPath       string           `json:"todoPath"`       // 待办（TODO）文件路径
	RecordPath     string           `json:"recordPath"`     // 记录（Record）文件路径：每行「姓名|名称|值」（保留兼容）
	RecordDBPath   string           `json:"recordDBPath"`   // 记录数据库路径：SQLite3 数据库文件（记录 Tab 实际存储）
	BackupDir      string           `json:"backupDir"`      // 文本文件备份目录（文件类自定义 Tab「备份」按钮使用）
	StockTicker    TickerConfig     `json:"stockTicker"`    // 股票滚动条配置
	NewsTicker     TickerConfig     `json:"newsTicker"`     // 新闻滚动条配置
	Poem           PoemConfig       `json:"poem"`           // 随机古诗显示配置
	MouseAlert     MouseAlertConfig `json:"mouseAlert"`     // 系统级鼠标提醒气泡配置
	BrowserPath    string           `json:"browserPath"`    // 指定浏览器 exe 路径（空=系统默认浏览器）
	LEDColor       string           `json:"ledColor"`       // LED 滚动文字点阵颜色（如 #ff4d4d）

	StockUpColor           string `json:"stockUpColor"`           // 股票上涨颜色
	StockDownColor         string `json:"stockDownColor"`         // 股票下跌颜色
	StockRefreshSecs       int    `json:"stockRefreshSecs"`       // 股市自动刷新间隔（秒）
	StockClosedRefreshSecs int    `json:"stockClosedRefreshSecs"` // 股市休市时自动刷新间隔（秒）
	NewsRefreshMinutes     int    `json:"newsRefreshMinutes"`     // 新闻自动刷新间隔（分钟）
	NewsCount              int    `json:"newsCount"`              // 新闻页显示条数
	GithubRefreshMinutes   int    `json:"githubRefreshMinutes"`   // Github 自动刷新间隔（分钟）
	FontDelta              int    `json:"fontDelta"`              // 全局字号偏移（px），+-3 范围内调整

	LocalSend LocalSendConfig `json:"localSend"` // LocalSend 文件互传配置（本机名/接收目录/接收模式等）
	Croc      CrocConfig      `json:"croc"`      // Croc 传送配置（发送/接收共用密码）
	YTDLP     YTDLPConfig     `json:"ytdlp"`     // 视频下载配置（yt-dlp 保存目录）
	Memos     MemosConfig     `json:"memos"`     // Memos 速记配置（地址/访问令牌/默认可见性）
	ToolOrder []string        `json:"toolOrder"` // 工具页卡片显示顺序（工具 id 列表，未列出的追加到末尾）
}

// 当前已注册的热键（用于保存设置时先注销旧热键）
var (
	hotkeyMu     sync.Mutex
	activeHotkey string
)

// defaultSettings 返回默认配置：开机启动默认开启，热键与页面地址使用内置值
func defaultSettings() AppSettings {
	return AppSettings{
		Theme:       "dark",
		Autostart:   true,
		AlwaysOnTop: false,
		Hotkey:      DefaultHotkey,
		TabOrder:    []string{"links", "news", "github", "stock", "todo", "record", "tools", "host", "settings"}, // 默认 Tab 顺序（控制/硬件等固定网页已改为自定义 Tab）
		ToolOrder:   DefaultToolOrder(),                                                                          // 工具页卡片默认显示顺序
		StockCodes:  []string{"sh000001", "sh600519", "sz000001"},
		Links: []LinkItem{
			{Name: "煎蛋", URL: "https://jandan.net/"},
			{Name: "头条", URL: "https://www.toutiao.com/"},
			{Name: "GitHub", URL: "https://github.com/"},
		},
		NewsKeywords: "",
		GithubRepos: []RepoItem{
			{URL: "https://github.com/wailsapp/wails", Desc: "Wails：Go + Web 桌面应用框架"},
		},
		APIAddr:        DefaultAPIAddr,
		APIAutoStart:   true, // 内置 API 服务随应用启动（默认开启）
		UploadPassword: "",   // 上传密码：默认空（不启用上传/下载）
		UploadDir:      "",   // 上传保存目录：默认空（回退到用户配置目录/uploads）
		UploadMaxSize:  512,  // 上传大小上限：默认 512MB
		TodoPath:       "",   // 待办路径：无默认值，用户须在设置中配置（空值时强制进入设置）
		RecordPath:     "",   // 记录路径：无默认值，用户须在设置中配置（空值时强制进入设置）
		RecordDBPath:   "",   // 记录数据库路径：无默认值，用户须在设置中配置（空值时强制进入设置）
		BackupDir:      "",   // 备份目录：无默认值，用户须在设置中配置（空值时强制进入设置）
		StockTicker:    TickerConfig{Enabled: false, Width: 1400, FontSize: 14, Color: "#ff4d4d", Speed: 80, Transparent: true, X: -1, Y: -1},
		NewsTicker:     TickerConfig{Enabled: false, Width: 1400, FontSize: 14, Color: "#3ddc84", Speed: 60, Transparent: true, X: -1, Y: -1},
		Poem:           PoemConfig{Enabled: false, Color: DefaultPoemColor, FontSize: DefaultPoemFontSize, TTS: false, Interval: DefaultPoemInterval, Speed: DefaultPoemSpeed},
		MouseAlert:     MouseAlertConfig{FontSize: DefaultMouseAlertFontSize, Width: DefaultMouseAlertWidth, Speed: DefaultMouseAlertSpeed, Color: DefaultMouseAlertColor, Duration: DefaultMouseAlertDuration, OutlineColor: DefaultMouseAlertOutlineColor, OutlineWidth: DefaultMouseAlertOutlineWidth},
		BrowserPath:    "",        // 指定浏览器路径：默认空（使用系统默认浏览器）
		LEDColor:       "#ff4d4d", // LED 滚动文字点阵颜色：默认红色

		StockUpColor:           DefaultStockUpColor,
		StockDownColor:         DefaultStockDownColor,
		StockRefreshSecs:       DefaultStockRefreshSecs,
		StockClosedRefreshSecs: DefaultStockClosedRefreshSecs,
		NewsRefreshMinutes:     DefaultNewsRefreshMinutes,
		NewsCount:              DefaultNewsCount,
		GithubRefreshMinutes:   DefaultGithubRefreshMinutes,
		FontDelta:              0, // 全局字号偏移默认 0
		Memos: MemosConfig{
			URL: "https://m.scwy.net", // 默认 Memos 实例
		},
	}
}

// DefaultToolOrder 返回工具页卡片默认显示顺序（与 index.html 中 data-tool 属性一一对应）。
// 新增工具时需在此追加 id，并在 normalizeSettings 中自动归一化（未列出的追加到末尾）。
func DefaultToolOrder() []string {
	return []string{
		"websvc",     // Web 服务
		"translate",  // 翻译
		"qrcode",     // 二维码生成
		"ntfy",       // 发送 ntfy 消息
		"chat",       // ntfy 聊天室
		"poem",       // 古诗词
		"screenshot", // 屏幕截图
		"shutdown",   // 延时关机
		"md5",        // MD5 加密
		"sha256",     // SHA256 编码
		"led",        // LED 滚动文字
		"reminder",   // 定时提醒
		"localsend",  // LocalSend 互传
		"croc",       // Croc 传送（PATH 中存在 croc 时才展示）
		"ytdlp",      // 视频下载（PATH 中存在 yt-dlp 时才展示）
		"memos",      // Memos 速记
	}
}

// settingsFilePath 返回配置文件路径：<用户配置目录>/TengTuToolbox/settings.json
func settingsFilePath() (string, error) {
	dir, err := os.UserConfigDir() // 例如 C:\Users\<用户名>\AppData\Roaming
	if err != nil {
		return "", err
	}
	return filepath.Join(dir, "TengTuToolbox", "settings.json"), nil
}

// loadSettings 读取配置文件；文件不存在或损坏时回退到默认配置
func loadSettings() AppSettings {
	defaults := defaultSettings()

	path, err := settingsFilePath()
	if err != nil {
		return defaults
	}

	data, err := os.ReadFile(path)
	if err != nil {
		return defaults // 首次运行：无配置文件，使用默认值
	}

	settings := defaults
	if err := json.Unmarshal(data, &settings); err != nil {
		return defaults // 文件损坏：回退默认值，避免启动失败
	}
	return normalizeSettings(settings)
}

// saveSettings 将配置写入磁盘（目录不存在时自动创建）
func saveSettings(settings AppSettings) error {
	path, err := settingsFilePath()
	if err != nil {
		return err
	}
	if err := os.MkdirAll(filepath.Dir(path), 0o755); err != nil {
		return err
	}

	data, err := json.MarshalIndent(settings, "", "  ") // 缩进保存，便于手动查看
	if err != nil {
		return err
	}
	return os.WriteFile(path, data, 0o644)
}

// normalizeSettings 校正配置字段：空值回填默认、主题取值限定、股票代码规范化
func normalizeSettings(settings AppSettings) AppSettings {
	if settings.Theme != "light" {
		settings.Theme = "dark" // 只允许 dark / light
	}
	if strings.TrimSpace(settings.Hotkey) == "" {
		settings.Hotkey = DefaultHotkey
	}
	// 先清洗自定义 Tab（生成 custom-N id 白名单供下方 Tab 顺序校验使用）
	tabs := make([]CustomTab, 0, len(settings.CustomTabs))
	for _, tab := range settings.CustomTabs {
		tab.Name = strings.TrimSpace(tab.Name)
		tab.URL = strings.TrimSpace(tab.URL)
		tab.Desc = strings.TrimSpace(tab.Desc) // 备注可空
		if tab.Name != "" && tab.URL != "" {   // 名字与网址都非空才保留
			tabs = append(tabs, tab)
		}
	}
	settings.CustomTabs = tabs

	// Tab 顺序：只保留已存在的 tabId（内置 + 自定义 custom-N），去重；未列出的追加到末尾，保证全部 Tab 都能显示
	validTabs := map[string]bool{"links": true,
		"news": true, "github": true, "stock": true, "todo": true, "record": true, "tools": true, "host": true, "settings": true}
	for i := range settings.CustomTabs {
		validTabs[fmt.Sprintf("custom-%d", i)] = true // 自定义 Tab id：custom-0, custom-1...
	}
	seen := map[string]bool{}
	ordered := make([]string, 0, len(validTabs))
	for _, tab := range settings.TabOrder {
		if validTabs[tab] && !seen[tab] {
			seen[tab] = true
			ordered = append(ordered, tab)
		}
	}
	for _, tab := range []string{"links", "news", "github", "stock", "todo", "record", "tools", "host", "settings"} {
		if !seen[tab] {
			ordered = append(ordered, tab) // 设置中未列出的内置 Tab 追加到末尾
		}
	}
	for i := range settings.CustomTabs {
		id := fmt.Sprintf("custom-%d", i)
		if !seen[id] {
			ordered = append(ordered, id) // 设置中未列出的自定义 Tab 追加到末尾
		}
	}
	settings.TabOrder = ordered

	// 工具顺序：只保留已存在的工具 id，去重；未列出的追加到末尾，保证全部工具都能显示
	validTools := map[string]bool{}
	for _, id := range DefaultToolOrder() {
		validTools[id] = true
	}
	seenTools := map[string]bool{}
	toolOrder := make([]string, 0, len(validTools))
	for _, id := range settings.ToolOrder {
		if validTools[id] && !seenTools[id] {
			seenTools[id] = true
			toolOrder = append(toolOrder, id)
		}
	}
	for _, id := range DefaultToolOrder() {
		if !seenTools[id] {
			toolOrder = append(toolOrder, id) // 设置中未列出的工具追加到末尾
		}
	}
	settings.ToolOrder = toolOrder

	if strings.TrimSpace(settings.APIAddr) == "" {
		settings.APIAddr = DefaultAPIAddr
	}
	settings.UploadPassword = strings.TrimSpace(settings.UploadPassword) // 上传密码：空表示不启用
	settings.UploadDir = strings.TrimSpace(settings.UploadDir)           // 上传目录：空回退到默认目录
	// TodoPath / RecordPath / RecordDBPath / BackupDir 无默认值：空值保留，前端据此强制用户进入设置配置（不做硬编码回填）
	settings.StockTicker = normalizeTicker(settings.StockTicker, "#ff4d4d", 80) // 股票条默认红字
	settings.NewsTicker = normalizeTicker(settings.NewsTicker, "#3ddc84", 60)   // 新闻条默认绿字
	settings.Poem = normalizePoemConfig(settings.Poem)                          // 古诗显示配置校正
	settings.MouseAlert = normalizeMouseAlert(settings.MouseAlert)              // 鼠标提醒配置校正

	if !isHexColor(settings.StockUpColor) {
		settings.StockUpColor = DefaultStockUpColor // 涨色回填默认红
	}
	if !isHexColor(settings.StockDownColor) {
		settings.StockDownColor = DefaultStockDownColor // 跌色回填默认蓝
	}
	if settings.StockRefreshSecs < 5 || settings.StockRefreshSecs > 3600 {
		settings.StockRefreshSecs = DefaultStockRefreshSecs // 股市刷新间隔限定 5 秒 ~ 1 小时
	}
	if settings.StockClosedRefreshSecs < 60 || settings.StockClosedRefreshSecs > 86400 {
		settings.StockClosedRefreshSecs = DefaultStockClosedRefreshSecs // 休市刷新间隔限定 1 分钟 ~ 1 天
	}
	if settings.NewsRefreshMinutes < 5 || settings.NewsRefreshMinutes > 1440 {
		settings.NewsRefreshMinutes = DefaultNewsRefreshMinutes // 新闻刷新间隔限定 5 分钟 ~ 1 天
	}
	if settings.NewsCount < 5 || settings.NewsCount > 200 {
		settings.NewsCount = DefaultNewsCount // 新闻显示条数限定 5 ~ 200 条
	}
	if settings.GithubRefreshMinutes < 5 || settings.GithubRefreshMinutes > 1440 {
		settings.GithubRefreshMinutes = DefaultGithubRefreshMinutes // Github 刷新间隔限定 5 分钟 ~ 1 天
	}
	if settings.FontDelta < -3 || settings.FontDelta > 3 {
		settings.FontDelta = 0 // 全局字号偏移限定 +-3 px
	}

	// LocalSend 配置校正：本机名未设置时随机生成、端口兜底、接收目录默认
	settings.LocalSend = normalizeLocalSend(settings.LocalSend)

	// Croc 配置校正：密码与接收目录均去首尾空格
	settings.Croc.Password = strings.TrimSpace(settings.Croc.Password)
	settings.Croc.Dir = strings.TrimSpace(settings.Croc.Dir)
	// 视频下载目录去首尾空格
	settings.YTDLP.Dir = strings.TrimSpace(settings.YTDLP.Dir)
	// mp3 转换质量：仅允许 0-9（VBR）或常见码率，非法值回退到最佳
	settings.YTDLP.Mp3Quality = strings.TrimSpace(settings.YTDLP.Mp3Quality)
	if !validMp3Quality(settings.YTDLP.Mp3Quality) {
		settings.YTDLP.Mp3Quality = "0"
	}

	// Memos 配置校正：地址去尾斜杠、令牌去空格
	settings.Memos.URL = strings.TrimRight(strings.TrimSpace(settings.Memos.URL), "/")
	settings.Memos.Token = strings.TrimSpace(settings.Memos.Token)

	if settings.StockCodes == nil {
		settings.StockCodes = defaultSettings().StockCodes // 未设置时用默认自选股
	}
	if settings.Links == nil {
		settings.Links = defaultSettings().Links // 未设置时用默认网址
	}
	if settings.GithubRepos == nil {
		settings.GithubRepos = defaultSettings().GithubRepos // 未设置时用默认仓库
	}

	links := make([]LinkItem, 0, len(settings.Links))
	for _, link := range settings.Links {
		link.Name = strings.TrimSpace(link.Name)
		link.URL = strings.TrimSpace(link.URL)
		if link.Name != "" && link.URL != "" {
			links = append(links, link)
		}
	}
	settings.Links = links

	repos := make([]RepoItem, 0, len(settings.GithubRepos))
	for _, repo := range settings.GithubRepos {
		repo.URL = strings.TrimSpace(repo.URL)
		repo.Desc = strings.TrimSpace(repo.Desc)
		repo.Version = strings.TrimSpace(repo.Version) // 本地版本，可为空
		if repo.Version == "" {
			repo.Version = AppVersion // 未填版本时自动用应用自身版本，用于分析并提示新版本
		}
		if repo.URL != "" {
			repos = append(repos, repo)
		}
	}
	settings.GithubRepos = repos

	codes := make([]string, 0, len(settings.StockCodes))
	for _, raw := range settings.StockCodes {
		code := normalizeStockCode(raw) // 补全 sh / sz / bj 前缀
		if code != "" {
			codes = append(codes, code)
		}
	}
	settings.StockCodes = codes
	return settings
}

// normalizeTicker 校正滚动条配置：宽度、字号、速度下限，颜色默认值
func normalizeTicker(cfg TickerConfig, defaultColor string, defaultSpeed int) TickerConfig {
	if cfg.Width < 200 || cfg.Width > 6000 {
		cfg.Width = 0 // 宽度限定在 200~6000px，0 表示用默认 1400
	}
	if cfg.FontSize < 10 || cfg.FontSize > 40 {
		cfg.FontSize = 14 // 字号限定在 10~40px
	}
	if strings.TrimSpace(cfg.Color) == "" {
		cfg.Color = defaultColor
	}
	if cfg.Speed < 20 || cfg.Speed > 400 {
		cfg.Speed = defaultSpeed // 速度限定在 20~400 px/s
	}
	return cfg
}

// normalizeMouseAlert 校正鼠标提醒配置：字号、宽度、速度、显示时长下限，颜色默认值
func normalizeMouseAlert(cfg MouseAlertConfig) MouseAlertConfig {
	if cfg.FontSize < 10 || cfg.FontSize > 48 {
		cfg.FontSize = DefaultMouseAlertFontSize // 字号限定 10~48px
	}
	if cfg.Width < 120 || cfg.Width > 1200 {
		cfg.Width = DefaultMouseAlertWidth // 宽度限定 120~1200px
	}
	if cfg.Speed < 5 || cfg.Speed > 300 {
		cfg.Speed = DefaultMouseAlertSpeed // 滚动速度限定 5~300 px/s
	}
	if strings.TrimSpace(cfg.Color) == "" {
		cfg.Color = DefaultMouseAlertColor
	}
	if strings.TrimSpace(cfg.OutlineColor) == "" {
		cfg.OutlineColor = DefaultMouseAlertOutlineColor
	}
	if cfg.OutlineWidth < 0 || cfg.OutlineWidth > 6 {
		cfg.OutlineWidth = DefaultMouseAlertOutlineWidth // 描边宽度限定 0~6 px，0 关闭
	}
	if cfg.Duration < 2 || cfg.Duration > 60 {
		cfg.Duration = DefaultMouseAlertDuration // 显示时长限定 2~60 秒
	}
	return cfg
}

// normalizeLocalSend 校正 LocalSend 配置：本机名未设置时随机生成、端口兜底、接收目录默认
func normalizeLocalSend(cfg LocalSendConfig) LocalSendConfig {
	if strings.TrimSpace(cfg.Alias) == "" {
		cfg.Alias = defaultLocalSendAlias() // 本机名未设置：随机生成
	}
	if cfg.Port <= 0 {
		cfg.Port = 53317 // 端口兜底：LocalSend 默认端口
	}
	if strings.TrimSpace(cfg.ReceiveDir) == "" {
		cfg.ReceiveDir = defaultLocalSendReceiveDir() // 接收目录：默认到用户配置目录/LocalSend 接收
	}
	return cfg
}

// defaultLocalSendAlias 随机生成本机名，如「工具箱-3F8A」
func defaultLocalSendAlias() string {
	b := make([]byte, 2)
	_, _ = rand.Read(b)
	return fmt.Sprintf("工具箱-%s", strings.ToUpper(hex.EncodeToString(b)))
}

// defaultLocalSendReceiveDir 返回默认接收目录：<用户配置目录>/TengTuToolbox/LocalSend接收
func defaultLocalSendReceiveDir() string {
	dir, err := os.UserConfigDir()
	if err != nil {
		return "LocalSend接收"
	}
	return filepath.Join(dir, "TengTuToolbox", "LocalSend接收")
}

// isHexColor 判断是否为 #RGB / #RRGGBB 形式的颜色值
func isHexColor(value string) bool {
	value = strings.TrimSpace(value)
	if !strings.HasPrefix(value, "#") {
		return false
	}
	return len(value) == 4 || len(value) == 7
}

// mergeTickerPositions 保留磁盘上已保存的滚动条位置：
// 设置表单不提交位置，保存其他设置时不能覆盖拖动后记录的最新坐标
func mergeTickerPositions(settings AppSettings) AppSettings {
	prev := loadSettings()
	settings.StockTicker.X, settings.StockTicker.Y = prev.StockTicker.X, prev.StockTicker.Y
	settings.NewsTicker.X, settings.NewsTicker.Y = prev.NewsTicker.X, prev.NewsTicker.Y
	return settings
}

// applySettings 把配置应用到运行时：重新注册热键、设置窗口置顶、同步开机启动
func applySettings(settings AppSettings) {
	hotkeyMu.Lock()
	if settings.Hotkey != activeHotkey {
		if activeHotkey != "" {
			_ = app.GlobalShortcut.Unregister(activeHotkey) // 注销旧热键，避免冲突
		}
		if err := app.GlobalShortcut.Register(settings.Hotkey, showMainWindow); err != nil {
			log.Printf("register hotkey %q failed: %v", settings.Hotkey, err)
		} else {
			activeHotkey = settings.Hotkey // 记录当前生效的热键
		}
	}
	hotkeyMu.Unlock()

	if mainWindow != nil {
		mainWindow.SetAlwaysOnTop(settings.AlwaysOnTop) // 窗口置顶开关
	}

	if settings.Autostart {
		_ = app.Autostart.Enable() // 写入系统开机启动项
	} else {
		_ = app.Autostart.Disable() // 移除开机启动项
	}

	// 内置 API 服务：按「服务自动启动」开关决定启动或停止（地址变化时重启）
	if settings.APIAutoStart {
		ensureAPIServer(settings.APIAddr)
	} else {
		StopAPIServer()
	}
	syncTickerWindows(settings) // 按配置创建 / 关闭 / 刷新滚动条窗口
}