工具索引 我最近在做什么 / K线倒计时悬浮窗
开源工具 · 01 · OSS INDEX

K线倒计时悬浮窗

Kline Countdown Widget · for Windows

一块常驻桌面的半透明浮窗:M5 / M15 / H1 三个周期的收盘倒计时、亚欧美三市场的 24 小时盘口,以及本周经济日历 —— 需要确认时间时,抬眼就能看到,不必切窗口。

v1.7.3 Windows 10 / 11 Python · PySide6 单文件免安装 开源 · 无账号 · 无遥测
仓库:cnb.cool/balakov-2026/Kline-Widget · 全部实拍与演示均为真实运行
01 · Capabilities

功能一览

从「离收盘还有多久」到「下一场数据什么时候来」—— 一块 340px 宽的浮窗,把这些每天要确认很多次的数字,固定在视野一角。

三周期收盘倒计时

M5、M15、H1 同时倒计,每秒刷新;按本地时钟自然分界,三个市场全部收盘时统一切换为 CLOSED。

三市场盘口时间轴

亚盘、欧盘、美盘共用一条 24 小时轴;夏令时自动切换,当前时刻以红线贯穿三条轨道。

独立休市判断

每个盘口按当地时区判定:时段、周末、当地节假日三层;哪盘休市,轨道就地显示 CLOSED,不牵连其它盘口。

休市原因状态条v1.7.0

常驻一行,说清「为什么没在跑」:交易中 / 周末 / 节假日(中英对照原因)/ 凌晨空档,四态全覆盖。

中文经济日历

本周重要事件(High / Medium)自动抓取;事件名经「精确字典 → 指标族 → 机构缩写」三级中译,悬停可看英文原文。

字典外置热更v1.7.3

译名不满意时,改一行 JSON 存盘,重开日历窗口即生效 —— 不用等新版本、不用换程序;文件随时可删,程序绝不改写它。

四套配色主题

深夜蓝 / 白昼纸 / 琥珀暖 / 极简白;托盘一键切换,夜间、白天与办公场景各有一套。

NTP 网络对时

内置对时工具:本地时间与网络时间对比、一键校准(需管理员权限),让倒计时不依赖系统时钟的精度。

浮窗交互与记忆

默认鼠标穿透、始终置顶;右键拖拽、屏幕边缘自动吸附(多显示器可用);位置、主题与开关自动写入 config.ini。

02 · Desktop UI

桌面版 · 界面实拍

以下截图均取自桌面版真实渲染(2× 像素)—— 四套配色主题与三处界面细节。

四套配色主题

深夜蓝主题的桌面浮窗 白昼纸主题的桌面浮窗 琥珀暖主题的桌面浮窗 极简白主题的桌面浮窗
同一时刻 22:20:33 拍摄,便于对比四套配色

三处界面细节

03 · Economic Calendar

本周数据,一处看全

托盘 →「经济日历」打开独立看板:按重要度与品种组筛选、同指标族自动合并、日期导航,每条事件带倒计时 —— 已发布与待发布一眼分列。

04 · Web Edition

网页重绘版 · 三种形态

本站从首页到日报页挂着的时间条,就是它的网页重绘版:与桌面版共享同一套时段表、夏令时与休市判定(189 项移植断言逐条对齐);数据为真实时间推算,每周随站点更新。三种形态均可直接使用 —— 以下都在实时运行。

形态 A竖版 VVertical
340px 固定宽八区域全开

完整信息结构:主时间、三周期倒计时、三市场盘口、休市状态条与三行经济日历。适合封面、详情页侧栏等纵向空间。

形态 B横条 HHorizontal
内容自适应 ≈ 640–760px计时行 : 盘口带 = 1 : 1

挂页面顶栏或工具栏常驻的横向形态:左侧计时行与交易状态、右侧下一场事件,下方 24 小时盘口带贯穿。

形态 C收起态 h-miniCollapsed
高 26px时间 / 日期 / 倒计时 / 状态 · 一行

滚动经过正文时收敛成的一条线:只留「现在几点、还剩多久、哪盘在开」,不抢阅读焦点。

为「嵌入」而生 —— 一个标签插进任何页面: <kline-widget variant="h"></kline-widget>

组合模块只需改一个属性;挂件自动跟随宿主页面的明暗主题。数据优先本地快照,拉取失败静默兜底,不影响宿主页面。

05 · Setup

运行与操作

Windows 10 / 11 下运行;单文件版双击即用,源码方式只需 Python 3.12+ 与 PySide6。

方式一 · 单文件(推荐)

双击即用,无需安装环境

单文件包约 46 MB(PyInstaller 打包);与 config.ini、dict/ 放在同一文件夹即可运行,配置与字典随程序走。发布包与历史版本随源码仓库的 dist/ 目录维护。

方式二 · 源码运行

三行命令跑起来

# 需要 Python 3.12+ git clone https://cnb.cool/balakov-2026/Kline-Widget.git pip install PySide6 python main.py
操作速查
操作功能
右键按住拖拽移动浮窗(未锁定时)
拖到屏幕边缘松手自动吸附,多显示器均可
托盘左键单击显示 / 隐藏浮窗
托盘右键 → 锁定位置锁定后完全鼠标穿透
托盘右键 → 网络对时对比本地与网络时间,一键校准(需管理员)
托盘右键 → 经济日历打开完整日历窗口
托盘右键 → 外观四套主题切换
托盘右键 → 关于版本号 / 字典条数 / 数据说明

程序目录:config.ini 运行配置(自动生成)· holidays.csv 节假日表(可编辑,附同步与备份工具)· ff_calendar_thisweek.csv 日历缓存(每周自动刷新)· dict/zh_dict.json 外置字典(可选)· logs/ 日志(7 天轮转)

06 · Reliability

可靠性与版本

工具不大,但该有的工程约束都有:桌面版与网页版是同一套逻辑的两种实现,靠可执行的检查项对齐;数据获取失败静默兜底;异常有日志可查。

189 项网页版移植断言,逐条比对桌面版逻辑,全部通过
150+ 项桌面端测试断言(六个测试套件),发版前全程跑绿
3 个实例上限防误开;退出与异常自动腾位
7 天日志轮转;数据快照兜底,拉取失败不影响使用
版本历史(节选 · 完整记录见仓库)
版本日期要点
v1.7.32026-09-14字典外置热更:译名改一行存盘即生效;本周事件翻译补全
v1.7.22026-09-07翻译字典更新至本周全覆盖;「关于」显示打包时间戳
v1.7.12026-09-03实例数上限 3(崩溃自愈);修复右键拖动穿透到下层窗口
v1.7.02026-08-31休市原因状态条:四态文案、超宽走马灯、淡入淡出过渡
v1.6.x2026-08经济日历看板:数据层 / 独立窗口 / 主界面时间轴;事件名中文化
v1.5.x2026-08节假日同步工具;折线版新图标;盘口 OPEN / CLOSED 状态光晕
v1.4.02026-08三市场独立休市判断(时段 + 周末 + 节假日三层判定)
v1.0–1.32026-08首发 MVP(倒计时 / 拖拽 / 吸边 / 托盘 / NTP)→ 四套配色主题
07 · FAQ

常见问题

支持哪些系统?

Windows 10 / 11(x64)。拖拽与鼠标穿透依赖 Windows 底层接口,macOS 与 Linux 未适配。

会不会挡住下面的窗口?

默认鼠标穿透 —— 看得见、点得穿;按住右键可拖拽,靠近屏幕边缘自动吸附。托盘「锁定位置」后完全穿透,适合长期挂在屏幕角落。

在游戏里为什么拖不动?

拖拽依赖系统鼠标钩子,独占全屏的游戏或反作弊环境会拦截 —— 这是已知限制,不是故障;浮窗显示与倒计时不受影响。

数据从哪里来?会联网吗?

经济日历来自 ForexFactory 公开 CSV(每周自动更新一次),对时使用标准 NTP 协议。除此之外全部本地运行:无账号、无遥测,不收集任何个人信息。

译名不满意怎么办?

打开程序目录的 dict/zh_dict.json,按「英文原题 → 中文译名」加一行,存盘后重开日历窗口即生效。文件可以随时删除(自动退回内置),程序不会改写它。

为什么最多同时运行 3 个实例?

防误开堆积、避免托盘图标重复。超限时弹窗提示;关闭任一实例自动腾出名额,异常退出也会释放。

免责说明 · 本工具为个人开发的看盘辅助小工具,其中的时间、行情与日历信息均来自公开数据源,仅供参考,不构成任何投资建议。
站内信 · CONTACT

有问题,或想谈谈合作?

工具的问题与建议、功能想法,或合作意向 —— 都欢迎发站内信(说明是哪个工具即可),我会尽快联系你。

写站内信