版本: v1.0.1.0
开发者: 技术奇客 ITGeeker.net
官网: https://www.itgeeker.net
平台: Windows 桌面应用
一、产品概述
ITGeeker Widgets 是一款面向投资者和金融从业者的 Windows 桌面工具箱，集成了 6 个独立运行的金融数据小部件（Widget），覆盖股票、基金、黄金、外汇、加密货币和行业板块六大维度。通过一个精致小巧的中央启动器，用户可以一键管理全部 Widget 的启停、自启和外观设置，无需逐个打开。
所有 Widget 均为独立进程，采用无边框、半透明悬浮窗设计，可自由放置在桌面任意位置，不遮挡日常工作，实现「一瞥即知」的信息获取体验。
二、六大金融数据 Widget
| 序号 | Widget 名称 | 说明 |
|---|---|---|
| 1 | 📈 股票行情 | 实时个股行情、分时/K线图表，支持自选股监控 |
| 2 | 📊 持仓组合 | 投资组合管理，持仓盈亏、仓位分布一目了然 |
| 3 | 🧈 黄金价格 | 国际/国内金价实时追踪，支持多单位显示 |
| 4 | 💱 汇率行情 | 主要货币对实时汇率，覆盖美元、欧元、日元等 |
| 5 | 🏭 行业板块 | A股行业板块涨跌、资金流向热力图 |
| 6 | ₿ 加密货币 | 主流加密货币行情，BTC/ETH 等实时报价 |
每个 Widget 都是独立开发的 .exe 程序，互不干扰。你可以按需启动 1~6 个，不会因为不需要的模块浪费系统资源。
三、中央启动器核心功能
3.1 智能卡片式管理
主窗口以 6 张卡片展示全部 Widget，每张卡片包含：
| 元素 | 功能 |
|---|---|
| 🎨 图标 | 优先使用各 Widget 自带图标，回退 emoji 兜底 |
| 📛 名称/副标题 | 中文名 + 英文标识，一目了然 |
| 🟢 运行状态绿点 | 实时显示当前 Widget 是否正在运行 |
| 🚀 启动/运行中按钮 | 未运行时蓝色「启动」；运行中绿色「运行中」并禁用，防止重复启动 |
| 🔴 关闭/已关闭按钮 | 运行时红色「关闭」；未运行时灰色「已关闭」并禁用 |
| ✅ 自启复选框 | 可对单个 Widget 设置随 Windows 开机自启 |
3.2 一键批量操作
- ▶ 一键开启全部：同时启动所有 6 个 Widget，幂等设计，已运行的不会重复启动
- ⏹ 一键关闭全部：优雅终止所有 Widget 进程，先
terminate()再 3 秒超时kill()
3.3 智能进程追踪
- 启动时自动扫描系统中是否已有 Widget 在运行（无论通过何种方式打开），并同步卡片状态
- 关闭时不仅尝试缓存的 PID，还会按 exe 文件名遍历所有匹配进程，确保「关得彻底」
- 上次退出时运行的 Widget，下次启动自动恢复
四、外观自定义
通过右键菜单 →「⚙️ 设置…」进入外观定制面板，支持：
| 设置项 | 说明 |
|---|---|
| 🎨 背景颜色 | 自由选色，内置「深邃宇宙」「午夜蓝」「暗绿科技」「深紫极光」「纯黑」5 种预设 |
| 🔍 窗口透明度 | 滑块 20%~100% 无级调节，磨砂质感始终保留 |
| 🔤 字体大小 | 8~20 pt 连续调节 |
| 👁️ 实时预览 | 任何外观参数的改动在设置对话框中即时生效，无需确认 |
窗口整体采用磨砂深色半透明设计（rgba(18,18,26,220)），圆角边框，在任何桌面壁纸上都能保证文字清晰可读，同时保留微妙的透明质感。
五、系统托盘深度集成
ITGeeker Widgets 启动后常驻系统托盘，不霸占任务栏：
| 功能 | 说明 |
|---|---|
| 🖱️ 双击托盘图标 | 显示/隐藏主窗口 |
| 📋 右键托盘图标 | 弹出完整功能菜单 |
| 💬 托盘 Tooltip | 动态显示当前运行的 Widget 数量和名称列表，如「运行中: 3/6」 |
| 🔒 点击窗口关闭按钮 | 最小化到托盘而非退出（可配置） |
| ❌ 托盘菜单退出 | 唯一彻底退出的方式，退出前保存窗口位置和运行状态 |
托盘菜单与窗口右键菜单完全一致，包含：显示窗口、窗口置顶、自动启动设置（自身 + 6 个 Widget）、外观设置、关于、访问官网。
六、开机自启管理
支持两级开机自启控制，均通过 Windows 注册表 Run 键（HKCU\Software\Microsoft\Windows\CurrentVersion\Run）实现：
- 自身自启：启动器本身是否随系统启动
- Widget 自启：每个 Widget 可独立设置是否开机自启
特性：
– 自启复选框状态在启动时自动与注册表同步，确保 UI 反映真实系统配置
– 写入注册表后立即回读确认，以实际生效状态为准
– 全程使用 winreg 标准库，无第三方依赖
七、窗口管理
| 特性 | 说明 |
|---|---|
| 🪟 无边框窗口 | 干净利落，无标题栏冗余 |
| 📌 窗口置顶 | 右键菜单一键切换，置顶时始终悬浮在其他窗口之上 |
| ✋ 拖动标题栏 | 自定义标题栏支持任意位置拖动 |
| 📐 右下角尺寸调节 | SizeGrip 支持自由缩放 |
| 💾 位置记忆 | 窗口位置/大小通过 400ms 防抖计时器自动保存到 JSON |
| 🔲 圆角边框 | 14px 圆角，现代感十足 |
窗口样式全面采用暗色主题（#1a1a2e），配合亮色强调色（#00d4ff 青蓝），视觉风格统一。
八、技术架构特点
| 维度 | 说明 |
|---|---|
| 🐍 语言/框架 | Python 3.12 + PySide6（Qt for Python） |
| 🧩 进程架构 | 主进程（启动器）+ 6 个独立子进程（Widget），互不干扰 |
| 🔧 子进程启停 | subprocess.Popen + DETACHED_PROCESS 标志，子进程完全独立于主进程生命周期 |
| 🗄️ 配置存储 | JSON 文件，路径 %APPDATA%\ITGeekerWidgets\settings.json，支持深度合并与向后兼容 |
| 📦 打包分发 | PyInstaller 单文件打包，生成独立的 ITGeekerWidgets.exe |
| 📐 统一版本号 | version.py 单一真相源，版本号、开发者、网址统一管理 |
| 🖼️ 高 DPI | 启用 QT_ENABLE_HIGHDPI_SCALING，4K 屏友好 |
| 🔍 进程检测 | 基于 psutil 的实时进程扫描，按 exe 文件名精确匹配 |
注册表命名规范
| 类型 | 注册表键名 |
|---|---|
| 本程序 | ITGeekerWidgets |
| 股票行情 | ITGeekerWidget_Stock |
| 持仓组合 | ITGeekerWidget_Portfolio |
| 黄金价格 | ITGeekerWidget_Gold |
| 汇率行情 | ITGeekerWidget_Exchange |
| 行业板块 | ITGeekerWidget_Industry |
| 加密货币 | ITGeekerWidget_Crypto |
九、适用场景
- 💼 金融从业者：交易时段多屏监控，Widget 分散放置在各显示器角落
- 📊 个人投资者：日常盯盘、关注汇率和金价的散户
- 🪙 加密货币玩家：同时关注传统金融和加密市场
- 🖥️ 桌面美化爱好者：半透明悬浮窗提升桌面颜值，信息与美观兼得
十、一句话总结
ITGeeker Widgets — 把 6 个金融数据小工具装进一个精致启动器，开机即用，关不掉的优雅。
© 2024 技术奇客 ITGeeker.net · 保留所有权利
