Skip to content

scutken/he-calendar

Repository files navigation

合社日历

有温度的中国风日历🍵 - 支持网页、uTools 插件与远程 MCP

开源地址 | 在线示例

应用介绍

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

✨ 核心特色

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

🎨 24节气主题

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

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

📖 黄历功能

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

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

🚀 快速使用

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

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

🔌 远程 MCP

  • 远程端点:/mcp
  • 传输方式:Streamable HTTP(JSON 响应模式)
  • 当前鉴权:固定 Bearer Token(通过 HE_CALENDAR_MCP_API_KEY 配置)
  • 已适配部署:Vercel Functions

示例:

curl https://<your-vercel-domain>/mcp \
  -H "Authorization: Bearer <YOUR_FIXED_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

💡 操作指南

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

技术栈

  • Vue 3:现代化的渐进式 JavaScript 框架
  • Vite:下一代前端构建工具
  • Vercel Functions:网页与远程 MCP 同域部署
  • Day.js:轻量级日期处理库
  • tyme4ts:强大的农历、节气、黄历计算库(6tail)
  • Lucide Vue Next:精美的图标库
  • Model Context Protocol SDK:远程 MCP 接入

版本说明

详细版本说明请查看 版本说明.txt


开源协议

本项目基于 MIT 协议开源。

致谢

感谢以下开源项目:


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

About

合社日历 - 有温度的中国风日历🍵 He-Calendar - A Heartfelt Chinese-Style Calendar 🍵

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages