tttools/settingsservice.go

// ============================================================================
// settingsservice.go — 设置页后端能力绑定
//
// SettingsService 暴露给前端调用的核心服务：配置读写、新闻抓取、GitHub 监听、
// 行情查询、翻译、二维码、截屏、Web 服务、待办读写、Markdown 渲染、API 状态等。
// ============================================================================
package main

import (
	"fmt"
	"os"
	"path/filepath"
	"strings"
	"time"

	"github.com/gomarkdown/markdown"
	"github.com/gomarkdown/markdown/html"
	"github.com/gomarkdown/markdown/parser"
)

// SettingsService 暴露「设置」页需要的后端能力给前端调用。
// 前端通过 bindings 调用 GetSettings / SaveSettings / GetStocks 等方法。
type SettingsService struct{}

// AppVersion 返回应用版本号，供 footer 展示。
// 版本常量在 settings.go 的 AppVersion（与 build/windows/info.json 的 ProductVersion 一致）。
func (s *SettingsService) AppVersion() string {
	return AppVersion
}

// GetSettings 返回当前配置（读取配置文件，不存在则返回默认值）
func (s *SettingsService) GetSettings() AppSettings {
	return loadSettings()
}

// SetMobileMode 前端在窗口尺寸变化时调用：移动端（窄屏）隐藏主机 Tab 并禁止滚动条
func (s *SettingsService) SetMobileMode(mobile bool) {
	SetMobileMode(mobile)
}

// SaveSettings 保存配置并立即生效：热键、窗口置顶、开机启动、页面地址、股票代码等
func (s *SettingsService) SaveSettings(settings AppSettings) (AppSettings, error) {
	settings = normalizeSettings(settings)    // 校正空值与代码格式
	settings = mergeTickerPositions(settings) // 保留拖动保存的滚动条位置
	if err := saveSettings(settings); err != nil {
		return settings, err
	}
	applySettings(settings) // 应用到运行时
	return settings, nil
}

// GetStocks 按已保存的股票代码拉取最新行情
func (s *SettingsService) GetStocks() ([]StockQuote, error) {
	return fetchStockQuotes(loadSettings().StockCodes)
}

// CaptureScreen 截取屏幕并返回 PNG 数据 URI，供「主机」页预览。
// display 为显示器索引，-1 表示全部屏幕。
func (s *SettingsService) CaptureScreen(display int) (string, error) {
	return captureScreen(display)
}

// PickWebDir 弹出目录选择对话框，返回选中的目录（取消返回空串）。
func (s *SettingsService) PickWebDir() (string, error) {
	return pickWebDir()
}

// StartWebService 启动静态文件服务（默认页 index.html 或 readme.md）。
func (s *SettingsService) StartWebService(dir string) (WebServiceInfo, error) {
	return StartWebService(dir)
}

// StopWebService 停止静态文件服务。
func (s *SettingsService) StopWebService() {
	StopWebService()
}

// WebServiceStatus 返回静态文件服务当前状态。
func (s *SettingsService) WebServiceStatus() WebServiceInfo {
	return WebServiceStatus()
}

// Translate 翻译文本：输入中文翻译为英文，输入英文翻译为中文（自动检测方向）。
// 使用 MyMemory 免费 API，有每日配额限制。
func (s *SettingsService) Translate(text string) (TranslateResult, error) {
	return translateMyMemory(text)
}

// GenerateQRCode 把输入字符串生成 PNG 二维码，返回 data URI 供前端展示。
// size 为图片边长（像素），<=0 时用默认值 300。
func (s *SettingsService) GenerateQRCode(text string, size int) (string, error) {
	return GenerateQRCode(text, size)
}

// GetMinuteChart 拉取指定股票的分时数据（点击股市行打开分时图时调用）
func (s *SettingsService) GetMinuteChart(code string) (MinuteChart, error) {
	return fetchMinuteChart(normalizeStockCode(code))
}

// GetKLine 拉取指定股票的日 K 数据，count 为交易日数量
func (s *SettingsService) GetKLine(code string, count int) ([]KLineBar, error) {
	return fetchKLine(normalizeStockCode(code), count)
}

// ShowWindow 供前端主动呼出窗口（例如通知点击后回到主界面）
func (s *SettingsService) ShowWindow() {
	showMainWindow()
}

// GetNews 抓取新闻标题，按设置的关键词标记命中项并优先排序
func (s *SettingsService) GetNews() ([]NewsItem, error) {
	return fetchNews(loadSettings().NewsKeywords)
}

// GetBiliDynamic 抓取 B站「关注的人最新动态」。
// 需要设置里配置 B站登录 cookie（含 SESSDATA）；cookie 为空或失效时回退热门视频。
func (s *SettingsService) GetBiliDynamic() ([]BiliDynamicItem, error) {
	items, _, err := fetchBiliFeed(loadSettings().BiliCookie)
	return items, err
}

// GetGithubFeeds 抓取设置中所有 GitHub 仓库的最新提交
func (s *SettingsService) GetGithubFeeds() []RepoFeed {
	return fetchGithubFeeds(loadSettings().GithubRepos)
}

// GetTrendingRepos 抓取 GitHub Trending 页的热门仓库列表（英文简介已自动翻译为中文）
func (s *SettingsService) GetTrendingRepos() ([]TrendingRepo, error) {
	return fetchTrendingRepos()
}

// MarkGithubRepoChecked 标记某仓库已检视：把本地版本更新为最新 release 版本，消除「发现新版本」提示
func (s *SettingsService) MarkGithubRepoChecked(url, latest string) error {
	settings := loadSettings()
	for i := range settings.GithubRepos {
		if settings.GithubRepos[i].URL == url {
			settings.GithubRepos[i].Version = latest
			break
		}
	}
	return saveSettings(settings)
}

// ReadTextFile 读取任意文本文件内容（供「自定义 Tab」文件类型页面使用）。
// 文件不存在时返回空内容；其他错误原样返回。
func (s *SettingsService) ReadTextFile(path string) (string, error) {
	data, err := os.ReadFile(path)
	if os.IsNotExist(err) {
		return "", nil // 文件尚未创建，返回空白
	}
	if err != nil {
		return "", err
	}
	return string(data), nil
}

// WriteTextFile 把文本内容写回指定文件（目录不存在时自动创建）。
// 供文件类自定义 Tab 的「保存」使用。
func (s *SettingsService) WriteTextFile(path, content string) error {
	if err := os.MkdirAll(filepath.Dir(path), 0o755); err != nil {
		return err
	}
	return os.WriteFile(path, []byte(content), 0o644)
}

// BackupFile 把指定文本文件按当前时间备份到配置的备份目录。
// 备份文件名带时间戳：<原名>_YYYYMMDD_HHMMSS<扩展名>；目录不存在时自动创建。
// 返回备份后的完整路径，供前端提示。
func (s *SettingsService) BackupFile(path string) (string, error) {
	if _, err := os.Stat(path); err != nil {
		return "", err // 源文件不存在，无法备份
	}
	dir := strings.TrimSpace(loadSettings().BackupDir)
	if dir == "" {
		return "", fmt.Errorf("未设置「文本备份目录」，请到设置页配置后再备份")
	}
	if err := os.MkdirAll(dir, 0o755); err != nil {
		return "", err
	}
	ext := filepath.Ext(path)
	base := strings.TrimSuffix(filepath.Base(path), ext)
	stamp := time.Now().Format("20060102_150405")
	dst := filepath.Join(dir, fmt.Sprintf("%s_%s%s", base, stamp, ext))
	data, err := os.ReadFile(path)
	if err != nil {
		return "", err
	}
	if err := os.WriteFile(dst, data, 0o644); err != nil {
		return "", err
	}
	return dst, nil
}

// RenderMarkdown 把 Markdown 文本渲染为安全 HTML 片段（供文件类自定义 Tab 展示）。
// 使用 gomarkdown 渲染，并启用 CommonMark 扩展（表格、任务列表、围栏代码等）。
func (s *SettingsService) RenderMarkdown(md string) string {
	p := parser.NewWithExtensions(parser.CommonExtensions | parser.AutoHeadingIDs)
	renderer := html.NewRenderer(html.RendererOptions{
		Flags: html.CommonFlags | html.HrefTargetBlank, // 链接在新窗口打开
	})
	return string(markdown.ToHTML([]byte(md), p, renderer))
}

// ReadTodo 读取待办文件内容（每行一个任务）；文件不存在时返回空
func (s *SettingsService) ReadTodo() (string, error) {
	path := strings.TrimSpace(loadSettings().TodoPath)
	if path == "" {
		return "", fmt.Errorf("未设置「待办文件路径」，请到设置页配置后再使用")
	}
	data, err := os.ReadFile(path)
	if os.IsNotExist(err) {
		return "", nil // 首次使用：文件尚未创建，返回空白
	}
	if err != nil {
		return "", err
	}
	return string(data), nil
}

// WriteTodo 把待办内容写回待办文件（目录不存在时自动创建）
func (s *SettingsService) WriteTodo(content string) error {
	path := strings.TrimSpace(loadSettings().TodoPath)
	if path == "" {
		return fmt.Errorf("未设置「待办文件路径」，请到设置页配置后再使用")
	}
	if err := os.MkdirAll(filepath.Dir(path), 0o755); err != nil {
		return err
	}
	return os.WriteFile(path, []byte(content), 0o644)
}

// GetAPILogs 返回 Gin 日志环形缓冲的全部内容
func (s *SettingsService) GetAPILogs() []string {
	return apiLogRing.Snapshot()
}

// ClearAPILogs 清空 Gin 日志缓冲
func (s *SettingsService) ClearAPILogs() {
	apiLogRing.Clear()
}

// GetAPIStatus 返回内置 API 服务运行状态
func (s *SettingsService) GetAPIStatus() APIStatus {
	return getAPIStatus()
}

// StopAPIService 停止内置 API 服务（服务页手动停止）
func (s *SettingsService) StopAPIService() {
	StopAPIServer()
}

// StartAPIService 启动 / 重启内置 API 服务（服务页手动启动）
func (s *SettingsService) StartAPIService() {
	StartAPIServer()
}

// GetPCStatus 返回电源控制命令状态
func (s *SettingsService) GetPCStatus() PCStatus {
	return getPCStatus()
}

// SaveTickerPos 保存滚动条窗口拖动后的位置（只更新配置，不重建窗口）
func (s *SettingsService) SaveTickerPos(kind string, x, y int) error {
	settings := loadSettings()
	if kind == "stock" {
		settings.StockTicker.X, settings.StockTicker.Y = x, y
	} else {
		settings.NewsTicker.X, settings.NewsTicker.Y = x, y
	}
	return saveSettings(settings) // 不调 applySettings，避免滚动条因保存位置而重建
}

// SaveTickerEnabled 保存滚动条开关状态（新闻条 / 股票条右侧「关闭」按钮调用）
func (s *SettingsService) SaveTickerEnabled(kind string, enabled bool) error {
	settings := loadSettings()
	if kind == "stock" {
		settings.StockTicker.Enabled = enabled
	} else {
		settings.NewsTicker.Enabled = enabled
	}
	if err := saveSettings(settings); err != nil {
		return err
	}
	syncTickerWindows(settings) // 同步滚动条窗口：关闭时销毁
	return nil
}