tttools

腾图工具箱（TengTu Toolbox）

基于 Wails v3 的桌面工具箱应用。前端使用原生 HTML/CSS/JS + Vite 构建，后端使用 Go；主窗口内嵌多个网页 Tab，并提供新闻聚合、Github 仓库监听、股票行情、记录/待办编辑、硬件监控、主机管理、工具（Web 服务 / 翻译 / 二维码）、聊天与设置等面板。

快速开始

# 开发模式：启动应用并为前后端启用热重载
wails3 dev

# 构建生产版本，输出到 bin/ 目录
wails3 build

主要功能

Tab	说明
笔记	内嵌网页，地址可在设置中修改；底部 footer 显示随机古诗（水平滚动，可配置颜色/字号/刷新间隔）
控制	内嵌网页，地址可在设置中修改
博客	内嵌网页，地址可在设置中修改
网址	常用网址卡片，点击在浏览器打开，列表在设置中维护
新闻	聚合煎蛋、头条热榜、腾讯科技/财经、Solidot；命中关键词置顶高亮，已查看标题灰显，条数可设置
Github	监听配置仓库的最新提交与 release，本地版本低于最新版提示更新；Latest 之后的 Pre-release/草稿版本也会列出（仅展示，不参与更新比较）；「本地 xxx」徽标与版本徽标均可点击跳转到对应 releases 列表
股市	自选股实时行情，点击行查看分时 / 日K；交易时段自动刷新，休市用较长间隔
记录	文本记录文件编辑，支持 Markdown 实时预览（编辑 / 预览切换，预览用后端 gomarkdown 渲染），路径可在设置中修改
待办	每行一个待办任务，可勾选完成、编辑、删除；每条可设置提醒时间，到点自动弹出置顶消息窗提醒（即使窗口隐藏也会触发）
硬件	内嵌硬件监控页，地址可在设置中修改
工具	开发/运维辅助工具：Web 服务（选目录开启浏览服务）、翻译（中英互译）、二维码生成、发送 ntfy 消息、ntfy 聊天室、古诗词、屏幕截图；各功能区默认折叠，点击标题展开
服务	内置 API 服务状态、电源命令状态与 Gin 日志（「清空日志」在标题右侧）；原截屏功能已迁移至工具页
聊天	内嵌网页，地址可在设置中修改
设置	按「系统 + 各 Tab」分组展示配置项，保存后立即生效

随机古诗

笔记页 footer 显示的水平滚动随机古诗，数据来源为 古诗词网接口（https://poetry.palemoky.com/api/poems/random，由 古诗词网 提供）。每次随机取一首，返回标题 / 作者 / 朝代 / 内容；可在设置中调整显示开关（禁止显示）、文字颜色、字号、滚动速度（秒/轮，数值越小滚动越快）、朗读按钮；速度保存后立即生效。

设置项

• 系统：界面样式（暗色/亮色）、系统启动时运行、窗口置顶、呼出窗口热键
• 各 Tab 对应设置：页面地址、Tab 显示顺序（逗号分隔）、股票代码与涨跌颜色、股市刷新间隔与休市刷新间隔、新闻关键词、新闻刷新间隔与显示条数、Github 项目与刷新间隔、API 监听地址、记录文件路径、待办文件路径、股票/新闻滚动条等

滚动文字

股票与新闻滚动条显示在屏幕顶部，位置与配置（宽度、字号、颜色、速度、背景透明）均可在设置中调整；位置会在拖动时自动保存，下次启动恢复。

工具页

• Web 服务：选择任意目录，开启本地静态文件浏览服务（默认页为 index.html 或 readme.md，README 会自动渲染为 HTML）；启动后点击地址链接可在系统浏览器打开。
• 翻译：一个文本框，输入中文自动翻译为英文、输入英文自动翻译为中文（自动检测方向）。使用 MyMemory 免费接口，每日约 5000 词配额（超出会提示恢复时间）；支持 Ctrl/Cmd+Enter 快捷翻译。
• 二维码生成：输入任意字符串（网址、文本、联系方式等），即时生成 PNG 二维码图片；点击图片或「下载 PNG」可保存，支持 Ctrl/Cmd+Enter 快捷生成。
• 发送 ntfy 消息：输入主题（Topic，用于指定监听频道，输入过的主题自动记忆、下拉可选）、标题（可空）、内容，推送到 ntfy 服务（默认 https://ntfy.sh），供手机 / 浏览器 / 其他设备即时提醒。主题历史保存于用户配置目录 TengTuToolbox/ntfy_topics.json。
• ntfy 聊天室：输入聊天室名称（ntfy 主题）并「开始监听」，通过 SSE 长连接实时接收该主题消息并显示在列表中；主题留空则不监听。可与手机 / 其他设备用同一主题互发消息，实现跨设备聊天 / 通知。监听时收到消息自动滚动到底部（上滚可暂停跟随）。
• 古诗词：显示主窗口 footer 最近获取到的古诗词内容（题目 / 作者 / 诗句），可点击「刷新获取」拉取新的一首；footer 加载到的古诗也会同步显示在此。数据来自古诗词网随机接口。
• 屏幕截图：点击「截屏」后自动隐藏本程序窗口，截取整个屏幕（全部显示器拼接），完成后重新显示本程序并预览截图；截到的画面不含本程序自身。原位于主机页的截屏功能已迁移至此。

鼠标提醒

通过内置 API 触发系统级鼠标提醒：平时鼠标为正常样式；触发后鼠标图标闪烁（白↔红，约 250ms 周期），光标下方浮出半透明提示文字，可覆盖任意窗口（系统级），默认 8 秒自动消退。详见 mousealert_windows.go。

项目结构

• main.go：Go 后端入口，创建应用、主窗口、系统托盘，注册服务与窗口事件，启动时间广播与待办提醒调度协程
• greetservice.go：Wails 示例服务（GreetService，用于验证 Go↔JS 绑定链路）
• settingsservice.go：设置读写、新闻抓取、Github 监听、行情查询、翻译、二维码、截屏、Web 服务、待办读写、Markdown 渲染、API 状态等核心服务
• settings.go：AppSettings 结构体、默认值与字段校验
• newsfeed.go：新闻来源抓取（煎蛋 / 头条 / 腾讯 / Solidot）
• trending.go：GitHub Trending 热门仓库抓取与自动翻译
• bilifeed.go：B站关注动态抓取（需 cookie）
• githubwatch.go：Github REST API 提交与版本监控（含 Latest 之后的版本列出）
• stockquote.go：股票行情与分时 / 日K
• ticker.go：滚动条窗口（位置保存）
• poem.go：主窗口首 Tab footer 随机古诗（水平滚动）
• apiserver.go：内置 API 服务（健康检查、通知、窗口控制、电源命令、鼠标提醒、屏幕截图等）
• pccontrol.go：电源控制（关机 / 重启 / 休眠 / 锁屏）
• timesync.go（及 _windows.go / _other.go）：系统时间同步
• screenshot.go：屏幕截图（多显示器拼接，返回 PNG base64 data URI）
• webservice.go：工具页 Web 服务（目录选择、静态文件服务、README 渲染）
• translate.go：工具页翻译（MyMemory 免费接口 + 中英文自动检测 + 限流提示）
• qrcode.go：工具页二维码生成（go-qrcode，返回 PNG data URI）
• ntfy.go：工具页 ntfy 消息推送与聊天室（POST ntfy.sh 指定主题、SSE 长连接订阅实时接收消息，主题历史持久化记忆）
• todoremind.go：待办提醒调度（解析待办文件中的 @ 时间 标记，到点广播事件）
• mousealert_windows.go：系统级鼠标提醒（Windows，WH_MOUSE_LL 全局钩子 + 置顶透明覆盖层 + GDI 绘制）
• mousealert_other.go：鼠标提醒非 Windows 空实现
• frontend/：前端代码（HTML、CSS、JavaScript）
• frontend/src/main.js：前端逻辑，负责调用后端服务、监听后端事件（含 Tab 管理、工具页折叠、待办提醒弹窗、记录 Markdown 预览等）
• frontend/src/ticker.js：滚动条逻辑
• frontend/src/lunar.js：农历与节日计算
• wails.json：Wails 项目配置

构建说明

• 开发调试：wails3 dev
• 生产构建：wails3 build，输出 bin/腾图工具箱.exe（UPX 压缩）
• 后端单独编译：go build .
• 前端单独构建：cd frontend && npm run build

备注

1. wails3 task windows:build BIN_DIR=Z:/ 可编译到指定目录并 UPX 压缩（见 build/windows/taskfile.yml）
2. wails3 dev 会根据 bin/config.yaml 的配置决定输出目录
3. 先 npm run build 完成后再单独 go build（后端需要读取构建后的前端 dist 清单，并行会导致 embed 失败）
4. 修改 Go 结构体/事件后需运行 wails3 generate bindings 重新生成前端绑定
5. 修改/新增前端页面后需 cd frontend && npm run build，再 wails3 build 才能打入产物

需求

1. 始终没有保存文字滚动条的位置（新闻/股票）：移动滚动条后 10 秒保存一次位置，重启程序时调用最后一次保存的位置
2. 系统级鼠标动态提醒：平时正常样式，API 触发时鼠标闪烁 + 光标下方半透明提示文字（已实现，见 mousealert_windows.go）
3. 工具页各功能区加区隔，默认折叠（已实现，见 frontend/src/main.js 的 initToolCollapse）
4. 记录界面支持 Markdown 格式（已实现，编辑/预览切换，见 settingsservice.go 的 RenderMarkdown）