有温度的中国风日历🍵 - 支持网页和utools插件

开源地址 | 在线示例

合社日历是一款融合中国传统文化元素的精美日历插件，专为 uTools 用户设计。它不仅是一个简单的日历工具，更是一个能让你感受中国传统文化魅力的数字艺术品。

• 🎨 24节气智能主题：根据当前节气自动切换配色，每个节气都有独特的中国传统色彩
• 📅 农历与黄历：完整的农历信息、节气、传统节日和黄历宜忌
• 🌈 多样主题风格：提供素雅、水墨、朱红、鎏金、黛蓝等多种主题，满足不同审美需求
• ⚡ 流畅交互体验：支持滚轮切换月份、快速选择年月、一键回到今天
• 📆 详细日历信息：显示节假日、调休信息、干支纪年、五行、冲煞、彭祖百忌等
• 🎯 精准定位：快速查看任意日期与今天的时间距离

合社日历根据中国传统24节气，为每个节气精心挑选了对应的中国传统色彩：

• 春季：立春（春黄）、雨水（雨绿）、惊蛰（桃红）、春分（春蓝）、清明（桐绿）、谷雨（羽紫）
• 夏季：立夏（夏黄）、小满（满红）、芒种（麦黄）、夏至（星云）、小暑（晨紫）、大暑（萤黑）
• 秋季：立秋（蝉绿）、处暑（谷蓝）、白露（鹟黄）、秋分（秋紫）、寒露（菊红）、霜降（柿红）
• 冬季：立冬（冬黄）、小雪（雪青）、大雪（雪白）、冬至（冬蓝）、小寒（寒青）、大寒（寒紫）

选择任意日期，右侧面板会显示详细的黄历信息：

• 基本信息：公历日期、农历日期、生肖年、干支纪年
• 宜忌事项：当日适宜和忌讳的事项
• 其他信息：五行纳音、冲煞、彭祖百忌、胎神方位等传统信息

在 uTools 中通过以下关键词唤起插件：

• 日历
• 万年历
• 黄历
• calendar

• 切换月份：使用鼠标滚轮上下滚动，或点击左右箭头按钮
• 选择年份：点击顶部年份，在下拉面板中选择或滚轮切换
• 选择月份：点击顶部月份，在下拉面板中快速选择
• 回到今天：点击"今天"按钮
• 切换主题：点击调色板图标，选择喜欢的主题
• 查看详情：点击任意日期，在右侧查看详细信息

• Vue 3：现代化的渐进式 JavaScript 框架
• Vite：下一代前端构建工具
• Day.js：轻量级日期处理库
• lunar-javascript：强大的农历、节气、黄历计算库
• Lucide Vue Next：精美的图标库

• ✅ 设置持久化：修复 uTools 环境下设置（颜色模式、主题、周起始日）重启后丢失的问题，改用 utools.dbStorage 持久化 API。
• 🐞 外部链接跳转修复：修复 uTools 环境下 GitHub 源码和网页版地址无法跳转的问题，改用 utools.shellOpenExternal API 打开外部链接。

✨ 深色模式支持与视觉优化

• ✅ 深色模式：新增外观设置，支持浅色、深色及跟随系统自动切换
• ✅ 状态栏适配：深色模式下自动调整界面颜色与对比度

• 🚀 CSS 变量重构：全面采用 CSS 变量管理颜色，大幅提升主题与模式适配的灵活性
• 🚀 今日高亮优化：为今日日期增加呼吸感阴影，视觉定位更清晰
• 🚀 滚动条适配：优化滚动条在不同模式下的视觉表现

• 🐞 优化了部分主题在特定模式下的文字对比度问题

✨ 功能增强与交互优化

• ✅ 设置面板：新增设置按钮，支持自定义周起始日（周日/周一）
• ✅ 关于信息：在设置中增加项目信息、GitHub 源码链接、网页版地址及作者信息
• ✅ 版本与 Slogan：设置面板中增加版本号显示及精致的项目 Slogan 展示

• 🚀 主题选择器重构：改为点击触发显隐，支持鼠标悬停实时预览主题色效果
• 🚀 竖向主题列表：主题选择列表改为竖向排列，增加主题名称显示，信息更直观
• 🚀 全局点击关闭：实现全局点击监听，点击日历外任意区域即可自动关闭弹出菜单
• 🚀 统一图标样式：统一 Header 所有功能按钮的 class 实现，确保图标颜色与主题高度协调
• 🚀 选中态优化：优化主题选中效果，移除黑色环，改用双层主题色环设计

• 🎨 网页版背景重构：移除紫色渐变背景，改为简约优雅的浅灰色调，并增加动态环境光感
• 🎨 主题色适配：设置面板内的所有元素（标签、图标、分割线）全面适配 24 节气主题色

• 🐞 修复 GitHub Pages 部署后缺失网页标题和 Favicon 的问题
• 🐞 修复在非自动主题下，选择列表中动态主题名称显示为空的问题

🎉 首个正式版本发布

• ✅ 完整的日历视图，支持公历和农历双显示
• ✅ 24节气智能主题系统，自动跟随当前节气切换配色
• ✅ 5种静态主题：素雅、水墨、朱红、鎏金、黛蓝
• ✅ 完整的黄历信息展示（宜忌、干支、五行、冲煞等）
• ✅ 节假日与调休信息标注
• ✅ 传统节日和节气提示
• ✅ 年份选择器（支持前100年到后20年）
• ✅ 月份快速选择器
• ✅ 日期距离今天的天数计算
• ✅ 鼠标滚轮快速切换月份/年份
• ✅ 主题偏好本地保存
• ✅ 流畅的交互动画和过渡效果
• ✅ 周末日期特殊标记

• 🎨 采用中国传统色彩体系
• 🎨 精心设计的24节气配色方案
• 🎨 简洁优雅的现代中式风格
• 🎨 响应式悬浮效果和视觉反馈

• ⚡ 使用 Vue 3 Composition API 实现高性能渲染
• ⚡ 智能的日期计算和缓存机制
• ⚡ 流畅的滚动体验（300ms 节流）

本项目基于 MIT 协议开源。

感谢以下开源项目：

• Vue.js
• Vite
• lunar-javascript
• Day.js
• Lucide Icons

用心感受时间的温度，让传统文化融入日常 🌸