# 历历。你的 Mac 一直缺少的那本日历。

> 农历、二十四节气、含调休的法定节假日，以及香港公众假期 —— 再加上与「日历」和「提醒事项」的双向同步、任务与番茄钟。一切尽在菜单栏。

macOS 14+ · 支持 Apple 芯片与 Intel

## 一本中国区日历该做的一切

国际日历读不懂农历和调休，本地万年历应用又不懂 Apple 生态。历历正处在两者的交汇点 —— 并且安静地待在菜单栏里，不打扰你。

### 一眼看全整个日期

可滚动的月历，每一天都标注农历、二十四节气和传统节日 —— 还有标记调休的休 / 班角标、代表其他地区节假日的彩色圆点，以及你自己日程的圆点。

- 公历 + 农历、节气与节日一并呈现
- 拖动可 1:1 滚动，轻扫则逐月对齐
- 点按某一天，查看它的详情、日程和任务

### 法定节假日与调休，开箱即用

中国大陆的法定节假日随应用内置 —— 包括没有一款国际日历能算对的调休补班日 —— 由开源的 holiday-cn 数据集驱动。香港公众假期也一并涵盖。

- 休 标记休息日；班 标记调休补班日
- 香港公众假期开箱即用
- 在线增量更新，让每一年都保持最新

### 是你自己的日程和提醒 —— 而非另起炉灶

历历通过 Apple 的 EventKit 读写你真实的系统「日历」和「提醒事项」。没有第三方账户，也没有独立数据库 —— 所以一切早已通过 iCloud 在你的各设备间同步。

- 与「日历」和「提醒事项」双向同步
- 无需新账户；通过 iCloud 多设备同步，且完全免费
- 精确选择哪些系统日历显示在面板中

### 任务与专注，同在一个面板

专属的「任务」标签页会按已过期、今天、即将到来和无日期分组整理一切。用一个按键即可行内添加、设置提醒时间，并为任意任务启动番茄钟 —— 全程无需离开菜单栏。

- 行内添加，自动解析日期和优先级
- 按已过期 / 今天 / 即将到来 / 无日期分组
- 为手头任务启动一枚 🍅 番茄钟

## 从菜单栏出发已够快，从键盘出发更快

一个无需鼠标即可操控的面板，一个安静待在菜单栏、从不打扰你的应用。

### 从不碍事

一款没有 Dock 图标的菜单栏应用。面板在状态栏图标下方打开，点击别处或按 Esc 即可收起 —— 从不抢占焦点。

### 为键盘而生

用 Tab 在「日历 / 日程 / 任务」间切换，跳转月份、添加任务、设置提醒，全程无需伸手去够鼠标。

### 面板快捷键

- 切换标签页: Tab
- 上一个标签页: shift + Tab
- 行内添加任务: Return
- 上一个 / 下一个月: ‹ ›
- 收起面板: Escape

## 还有几件普通日历做不到的事

历历不只是一张日期网格 —— 它是一个本地化的指挥中心，掌管节假日、会议与专注。

### 订阅任何地区的节假日

除了中国大陆和香港，还能添加任意国家或地区 —— 历历从免费的 Nager.Date 服务拉取约 150 个国家的数据，也接受任意 iCal / webcal 链接。为每个来源指定专属颜色；某天若在多个地区都是节假日，就会显示多个彩色圆点。

- 约 150 个国家和地区，无需 API 密钥
- 任意 iCal / webcal 链接 —— 谷歌、政府、公司均可
- 每个来源一种自定义颜色，同一天并排显示

### 会议提醒，助你准时入会

历历能识别日程中的会议链接，接管会前通知，提供一键加入和你自定的提前时间。再也不用从日历里翻找 Zoom 链接了。

- 识别日程备注和地点中的会议链接
- 会前通知，一键加入
- 自定提前时间，或交回给系统处理

### 番茄钟专注，与你的任务相连

从任意任务启动番茄钟，在菜单栏中盯着倒计时，让休息自动衔接。一段专注结束时，你可以完成该任务，或直接进入下一枚番茄。

- 让一枚番茄钟专注于某个具体任务
- 菜单栏中的实时倒计时
- 自动切换工作 / 休息，附以温和提醒

### 把面板打造成你的样子

八种预设强调色，加上完整的自定义取色器，可为今日高亮、选中环和日程圆点重新上色。独立滑块调整日历的宽度和高度，菜单栏标题显示什么也由你决定。

- 8 种预设主题 + 自定义取色器
- 用宽度 / 高度滑块调整日历区域大小
- 自选菜单栏标题：日期、星期、农历日

## 你的日历，始终属于你

历历从设计之初就本地优先。它通过 Apple 自家的框架和你的 iCloud 运行 —— 没有第三方账户，没有分析统计，没有追踪。

### 本地与离线优先

你的日程和任务通过 Apple 的 EventKit 存放在系统「日历」和「提醒事项」中 —— 若你使用 iCloud，则存放在你自己的 iCloud 账户里。历历不运行任何存储你数据的服务器。

### 无账户，无追踪

没有历历登录，也没有第三方登录。应用不含任何分析、遥测、广告或追踪。

### 由你明确授权访问

首次使用时会通过 macOS 请求「日历」和「提醒事项」的访问权限，你可随时在「系统设置」中撤销。App Store 版本运行在沙盒中。

### 节假日数据是获取，而非采集

公众假期数据源（holiday-cn、Nager.Date 以及你添加的任意 iCal 链接）通过 HTTPS 读取，仅用于显示日期。这些请求不会携带任何关于你的信息。

## 打造成你的样子

调整外观、菜单栏标题、通知、节假日来源，以及面板中显示的内容，让它契合你的工作方式。

- 浅色、深色或跟随系统外观
- 8 种预设强调色 + 自定义取色器
- 日历区域的独立宽度 / 高度滑块
- 菜单栏标题：日期、星期与农历日，随你所愿
- 显示或隐藏农历（含节气与节日）
- 精确选择哪些系统日历显示在面板中
- 为任意国家 / 地区或任意 iCal / webcal 链接添加节假日
- 各来源节假日颜色，以并排圆点呈现
- 会前通知，支持一键加入和自定提前时间
- 登录时启动，且运行时不显示 Dock 图标

## 献给每一位依中国历法而生活的人

### 上班族 / 知识工作者

提前数周围绕法定节假日和调休补班日做规划，并在会议被提及的瞬间随手录入。

### 港澳用户

公众假期开箱即用，还能关注任意其他地区 —— 每个都有专属颜色，让重叠的日历清晰易读。

### 家庭与传统

让农历生日、节气和传统节日尽在眼前，再也不错过除夕、端午或中秋。

### 追求专注的人

把任务变成一枚番茄钟，在菜单栏中盯着计时，让工作与休息的循环推着你前行。

## 免费。无需账户。没有广告。

历历在 Mac App Store 免费下载 —— 没有订阅、没有内购、没有广告。安装它，授予「日历」和「提醒事项」访问权限，就可以开始了。更新通过 App Store 推送。

## 常见问题解答

下载前你可能想知道的一切。

### 历历（Kopit Cal）是什么？

历历是一款专为 Mac 打造、面向中国区的菜单栏日历与任务应用。它显示农历、二十四节气和传统节日；内置含调休的大陆法定节假日和香港公众假期；并与系统「日历」和「提醒事项」双向同步。

### 历历支持哪些 Mac？

历历可在 macOS 14 Sonoma 及更高版本上运行，同时支持 Apple 芯片和 Intel Mac，是一个通用二进制版本。

### 它会显示农历和节气吗？

会的。每一天都显示农历日期，二十四节气和传统节日也会出现在日历上。若你偏好纯公历视图，可以隐藏农历图层。

### 它能处理调休（补班日）吗？

能。历历使用开源的 holiday-cn 数据集，因此休息日标记为休，补班日标记为班 —— 这正是国际日历会弄错的细节。随着新年份公布，它会在线增量更新。

### 包含香港假期吗？

包含，香港公众假期已内置。你也可以将澳门、台湾或任何其他地区添加为订阅。

### 我可以添加其他国家的节假日吗？

可以。从免费的 Nager.Date 服务添加约 150 个国家和地区中的任意一个（无需 API 密钥），或粘贴任意 iCal / webcal 链接。每个来源都有专属颜色，同一天的多个地区会以并排圆点显示。

### 它会与 Apple「日历」和「提醒事项」同步吗？

会的，双向同步。历历通过 Apple 的 EventKit 读写你真实的系统「日历」和「提醒事项」，因此没有独立数据库，一切也早已通过 iCloud 在你的各设备间同步。

### 我的数据私密吗？

私密。你的日程和任务保留在系统「日历」和「提醒事项」中 —— 若使用 iCloud，则保存在你自己的 iCloud 账户里。没有历历账户，没有分析统计，也没有追踪。节假日数据源通过 HTTPS 获取以显示日期，不会附带任何关于你的信息。

### 它真的免费吗？

真的。历历在 Mac App Store 免费下载，没有订阅、没有内购、也没有广告。更新通过 App Store 推送。

### 它包含番茄钟吗？

包含。为任意任务启动番茄钟，在菜单栏中盯着倒计时，让工作与休息的循环自动运转。

## 让你的日历回家

农历、节假日与调休、会议、任务与专注 —— 为中国场景本地化，与你的 Mac 原生相融。

---

网页版本: https://cal.kopit.app/zh-cn

本 Markdown 版本面向 AI 智能体与 LLM 工具提供。
