简洁桌面日历

受够了 Windows 原生的日历，也实在受不了市面上第三方日历软件——明明很简单的需求，硬塞一堆没必要的功能。 自己写了这款极简日历：核心只做三件事——看日历、看放假、看上班，外加一个真正有用的「特别关注」提醒。 想要更多功能，看手机不就行了。

---

✨ 功能

• 极简本体：打开就是一张日历，没有广告、没有账号、没有多余菜单。
• 任务栏挂件条（常驻）：任务栏右端一条小窗，上行 24 小时制实时时钟（时:分:秒），下行星期与日期，不占任务栏按钮、常驻后台。
  • 左键点击 → 打开 / 隐藏日历；
  • 右键菜单 → 本年最近节日、特别关注、显示/隐藏日历、设置、退出软件；
  • 主窗空白处右键 → 弹出同一套菜单（兜底入口，防止挂件条被关掉后无法恢复）。
  • 可拖动 + 边界限制：按住可拖到屏幕任意位置；四条边都被夹在屏幕工作区内（工作区已排除任务栏），拖不出屏幕、也压不到任务栏；落点会记住，重启回到原处。
  • 多屏记忆（v2.4.0）：外接屏断连后插件会回落到存活屏，重新连接后自动还原到原屏原位。
  • 点击热区：只有插件可见的小方框能响应鼠标，方框外的透明区域完全穿透、不拦截点击。
• 农历 / 节气 / 节日：每天副字显示农历、24 节气或节日名（按白名单过滤，只保留中国传统与主流民俗）。
• 放假 / 上班一目了然：
  • 法定节假日 → 朱砂红底 + 红色「休」角标；
  • 调休补班 → 蓝色「班」角标。
• 区间天数计算：点两个日期，端点深绿、中间浅绿连成一条带，浮层实时显示「共计 N 天」；支持跨月；第三下点击或点窗口外取消。
• 特别关注 / 提醒：右键任意格子标记为「特别关注」（金黄底 +「注」角标），可选填定时（时:分）——填了就在当天该时刻提醒，留空则当天首次打开时提醒；添加面板会实时显示「定时提醒：H时M分」。弹窗可「知道了」（当天不再弹）或「稍后提醒」（半小时后再弹）。每条 15 字以内；点击工具栏的书按钮打开独立关注列表窗口，窗口按 日期 / 关注内容 / 定时 / 删除 四列展示，并可直接在窗口底部「＋ 新增关注」录入（不必回到日历逐个点击），添加后日历界面自动同步；窗口可拖到屏幕任意位置并记住位置。
• 每周起始自由切换：周一 / 周日，一键切换，习惯你定。
• 皮肤系统（v3.3.0）：设置里点「🎨 皮肤设置」打开皮肤设置窗口，主视图有三个入口：
  • 原生皮肤：点开动画展开 6 套风格（默认 / 极简 / 玻璃拟态 / 新拟态 / 科技感 / 温润拟物，每套带迷你预览）。选中即让日历 / 浮窗 / 桌面插件 / 放大窗口四个界面统一切成该风格（浮窗即便此前单独设过图片也会被覆盖）。每套都做了针对性设计——科技感是赛博朋克（青 + 品红双霓虹、网格、切角），玻璃拟态是磨砂玻璃（自绘光斑 + 斜向光泽带）；
  • 浮窗样式：点开动画展开 6 款造型——圆角卡片（默认）/ 像素方屏 / 虹彩流光 / 极简圆环 / 翻页时牌 / 绘本台钟。造型只作用于浮窗（任务栏挂件条）：窗口尺寸随造型变（方屏 / 圆环 / 台钟会离开任务栏变成桌面挂件），默认「圆角卡片」就是原来的贴任务栏小条。浮窗在「跟随主界面」时统一为圆角卡片，选任一其他造型即自动转为独立；在这些造型下导入自选图片会自动切回「圆角卡片」并显示该图（这五款造型自带材质、不吃图片皮肤），而单纯换造型不会清掉已选图片——切回「圆角卡片」即恢复显示；其中**「虹彩流光」现在也能像「圆角卡片」一样贴任务栏与屏幕右边**（其余四款仍为悬浮的桌面挂件）。
  • 自选图片：点开独立新窗口（不再是窗内浮层），先选界面（日历 / 浮窗 / 桌面插件 / 放大窗口），再按界面单独设置：
    • 图片：拖拽导入、拖动取景、滚轮缩放（1×~5×）、GIF / MP4 动图、图片不透明度（20%~100%）；取景框随界面比例不同；图片自动复制进数据目录，删原文件不影响；右上「清空」按钮可一键清掉本界面图片、回到原生皮肤（造型不变，盘上图片文件不删）；
    • 文字明暗：自动 / 深字 / 浅字——只改文字、不改整窗明暗；
    • UI 清晰度：可按背景复杂度自动推导，也可手动调保护强度；
    • 透明度 与 「跟随主界面」 开关（仅浮窗 / 桌面插件 / 放大窗口可跟随）。
    • 浮窗大小（选中「浮窗界面」时出现）：等比放大 / 缩小整个浮窗，范围 60%~160%、步进 5%、默认 100%；它调的是几何尺寸，与「跟随主界面」开关相互独立。
  • 四处默认统一：选一套原生风格后，日历 / 浮窗 / 桌面插件 / 放大窗口统一切成同一风格；若在「自选图片」窗口里单独调整过某个界面，该界面会自动转为独立、不再跟随（也可手动切回「跟随主界面」）。
• v3.4.2 要点：修复浮窗（任务栏挂件条）消失后无法自愈——新增可见性诊断日志与低频心跳、自愈看门狗（约 20 秒巡检，发现浮窗不可见 / 被最小化 / 被挪出屏幕或已销毁时自动救回）、以及二次启动 / 睡眠唤醒 / 显示器插拔后的可见性兜底，浮窗不再静默消失。
• v3.4.1 要点：自选图片 / 动图背景下不再显示日历背景那个大号月份数字水印（此前那张 200px 的月份大字会盖在照片上、影响观感）；原生皮肤与纯色背景不受影响，水印照旧。
• v3.4.0 要点：自定义图片背景新增 MP4 动图支持 —— 独立 <video> 层、静音循环自动播放，取景 / 缩放 / 不透明度 / 文字明暗与图片完全一致；支持格式扩展为 PNG / JPG / GIF 动图 / WebP / MP4 动图。两条限制如实说明：MP4 音轨一律不播放（静音）、无法采样视频首帧亮度（文字明暗默认浅色兜底，可手动改）。
• v3.3.0 要点：新增「浮窗样式」入口——浮窗可选 6 款造型（圆角卡片 / 像素方屏 / 虹彩流光 / 极简圆环 / 翻页时牌 / 绘本台钟），窗口尺寸随造型自适应；「自选图片」窗口新增清空图片按钮（一键回到原生皮肤）、以及选中「浮窗界面」时的浮窗大小等比缩放拉杆（60%~160%，步进 5%）；修复「浮窗不跟随主界面时图片框仍显示主界面图片」的问题（取消跟随即回到空白态，图片不再被继承）；浮窗跟随开关语义明确为「关掉跟随回到原生皮肤」。新装/升级后还会看到三处观感修复：窗口圆角之外不再露出一圈不透明的直角底色（顺带让卡片的毛玻璃背景第一次真正生效）、极简圆环与像素方屏造型外围的方形暗框已去除。
• v3.2.0 要点：界面名词统一为「浮窗」；皮肤窗改为「原生皮肤 / 自选图片」两入口，「原生皮肤」动画展开 6 套带预览的风格、选中即四个界面统一；「自选图片」改为独立新窗口、按界面单独设置（移除「背景来源」「明暗」两项）。
• v3.1.0 要点：皮肤窗精简为 6 行风格列表（细调移入「自选图片」浮层）；六套原生风格视觉重做；原生风格默认四处统一、手调后自动独立；特别关注支持定时与列表内直接录入；修复升级后浮窗自定义配置被静默忽略、手动调整被静默忽略、提醒弹窗被置顶主窗遮挡、深色档上下月日期几乎不可见。
• 放大模式：点「⊕」放大到近全屏、字号同步放大，拖到屏幕边缘自动吸附；拖拽四角可等比缩放。
• 开机自启：安装后默认登录启动，随用随点。

📦 下载与安装

1. 到 Releases 下载 SimpleCalendar-Setup-3.4.2.exe。
2. 双击运行，按向导「下一步 → 完成」即可。
   • 默认安装到当前用户目录（无需管理员权限）；也可点「浏览」改路径。
   • 默认勾选「创建桌面快捷方式」与「开始菜单快捷方式」。
3. 安装完成后可勾选「立即运行」与「查看说明文档」。

卸载：控制面板 → 程序和功能 → 简洁桌面日历 → 卸载；或开始菜单文件夹内的「卸载」。

🖱️ 使用

• 任务栏挂件条：任务栏右端实时时钟（时:分:秒 + 星期/日期），左键打开/隐藏日历；点界面外任意处自动隐藏。
• 翻月：左上「‹ ›」箭头，或下拉选择年/月，点「今」回到本月。
• 算天数：依次点两个日期 → 显示「共计 N 天」（端点深绿、中间更浅的绿连成一条带）；第三下点击或按 Esc、点空白处取消。
• 特别关注：右键某个日期 → 输入框填写备忘（15 字以内）→ 确认后该格变金黄；到日期当天自动弹窗提醒。
  • 快速浏览：鼠标指向格子右上角的「注」小标注即可看到完整内容。
  • 批量管理：点工具栏书图标按钮打开独立关注列表窗口（日期 / 内容 / ✕ 三列）。
• 皮肤设置：设置 →「🎨 皮肤设置」→ 三个入口：「原生皮肤」动画展开 6 套风格、点一套即四个界面统一；「浮窗样式」动画展开 6 款造型、点一款即换浮窗外观（默认圆角卡片）；「自选图片」打开独立窗口，选界面（日历/浮窗/桌面插件/放大）后单独调「图片」「文字明暗」「UI 清晰度」「透明度」「跟随主界面」，并可一键「清空」图片回到原生皮肤。
• 放大：点右上「⊕」放大；放大态拖到屏幕边缘自动吸附，拖拽四角可等比缩放；点别处退出放大。
• 每周起始：右上「一/日」开关切换周一 / 周日起始。主题 / 明暗请在「设置 → 皮肤设置」中调整（v3 起主窗不再有 ☾/☀ 按钮）。

🛠 技术栈

• Electron 31（桌面壳，系统托盘 + 无边框透明窗口 + 独立提醒弹窗）
• electron-builder 24（NSIS 安装包）
• 纯前端：HTML + CSS（color-mix 主题派生 + CSS 变量皮肤层）+ 原生 JS，零运行时依赖
• 农历数据：lunar.min.js（第三方库，仅读取不修改）
• 图片皮肤：自定义特权协议 skin:// 加载用户数据目录下的本地图片，主进程 nativeImage 采样亮度判定文字明暗

🧑‍💻 本地开发 / 打包

cd 简洁桌面日历        # 进入项目目录
npm install            # 首次安装 Electron 等依赖（仅打包/运行桌面端需要）
npm run dev            # 开发预览：Electron 弹出桌面日历
npm run build          # 打包：在 dist/ 生成 SimpleCalendar-Setup-3.4.2.exe

闸门链：npm run check（= verify + smoke + runtime + qa-v244 + qa-v300 + qa-v310 + qa-v330）与 npm run prebuild 同源，打包前自动跑。

无需打包时，可直接双击 calendar.html 在浏览器预览界面（不含托盘/提醒弹窗/吸附等桌面特性）。

目录结构

简洁桌面日历/
├── template.html      # 主界面模板（设计系统：纸与光）
├── app.js             # 主界面渲染逻辑：日历/农历/节假日/区间选择/特别关注/皮肤应用
├── electron-main.js   # 主进程：窗口/右键菜单/提醒巡检/IPC/皮肤中枢/skin://协议
├── preload.js         # 安全的渲染↔主进程桥接
├── holidays.js        # 节假日与最近节日数据（本年/跨年）
├── reminder.html      # 提醒弹窗界面（知道了 / 稍后提醒）
├── remindlist.html    # 关注列表独立窗口
├── dock.html          # 任务栏挂件条界面（上行 24h 时钟含秒 / 下行星期与日期；v3.3 起支持 6 款造型）
├── settings.html      # 设置弹窗（功能区/桌面插件区/浮窗区/日历窗口区 + 皮肤设置入口）
├── skin.html          # 皮肤设置窗口（v3.3：三入口「原生皮肤 / 浮窗样式 / 自选图片」+ 6 套风格与 6 款造型动画展开）
├── skincustom.html    # 「自选图片」独立窗口（按界面设图片/文字明暗/UI 清晰度/透明度/跟随；可清空图片回原生皮肤）
├── lunar.min.js       # 第三方农历库（不修改）
├── build.js           # 把 lunar+app+样式注入模板，生成 calendar.html
├── calendar.html      # 构建产物（可直接浏览器打开预览）
├── make-icon.js       # 生成 icon.ico（蓝磁贴 + 白日历卡）
├── icon.ico           # 多尺寸图标（exe/安装包/快捷方式/托盘共用）
├── installer.nsh      # NSIS 完成页扩展（查看说明文档）
├── exit.html          # 退出确认弹窗
├── 使用说明.html      # 安装后"查看文档"打开的帮助页（图文）
├── 使用说明.md        # 软件介绍 + 使用说明书（Markdown 版）
├── CHANGELOG.md       # 版本变更日志
├── 开发历程.md         # 开发过程 + 技术决策 + 踩坑复盘
├── UI_DESIGN_SYSTEM.md # 设计规范文档
├── DESIGN_SPEC.md     # 视觉设计规范（纸与光设计系统）
├── README.md          # 本文件（GitHub 说明）
└── package.json       # 版本/作者/NSIS 打包配置

⚠️ 已知限制

• 节假日数据为 2026 年硬编码（国务院办公厅安排）。每年需更新 app.js 中的 HOLIDAYS_2026（放假区间）与补班 WK，以及 holidays.js 的节日列表。
• 仅支持 Windows（依赖系统托盘与窗口特性）。
• 农历库为第三方库，仅读取其 Solar / Lunar 接口。
• 图片皮肤无尺寸/像素上限（按用户意愿不设限），超大图片会占用较多内存；GIF 动图在窗口隐藏时仍保持播放。
• MP4 动图一律静音（不播放音轨）；视频文件按原样复制进数据目录，体积大时占用磁盘。

📄 许可证

MIT © 2026 YG

---

作者：YG