日历 — 用户手册 | YoBench

「日历」模块的用途

YoBench 内置的完整日历:事件、重复规则、iCalendar(.ics)导入与订阅、提醒以及含节假日的工作日历。与 任务跟踪 集成 — 带截止日期的任务会显示在时间轴上。

您将获得:

• 五种视图 —— 年、月、周、日、Agenda(日程列表)。
• 灵活的重复规则 —— 每日、工作日、每周(可选若干天)、每月、每年或自定义间隔。
• ICS 导入/导出 —— 打开第三方日历或导出您自己的。
• 订阅 外部 ICS URL,并支持自动同步。
• 系统提醒 —— 事件前 0/5/15/30/60/120/1440 分钟。
• 俄罗斯工作日历 —— 数据来自 consultant.ru:工作日 / 周末 / 节假日 / 缩短工作日。
• 跟踪器任务 —— 按 due_date 渲染在同一时间轴。

事件参数

创建或编辑时:

• 标题 (必填)。
• 描述 (可选)。
• 开始 / 结束日期与时间 或 全天 标志。
• 颜色 —— HEX(默认 #3b82f6)。
• 分类 —— 工作 / 个人 / 会议 / 生日 / 无分类。
• 地点/链接 —— 文本或 URL。
• 状态 —— 已确认 / 暂定 / 已取消。
• 忙碌 —— 忙碌标志(用于忙/闲视图)。
• 专注时段 —— focus-time 标记。
• 提醒 —— 提前分钟列表:0(事件时刻)、5、15、30、60、120、1440(一天)。
• 重复 —— 重复规则(见下文)。

重复事件

不使用 RRULE,而是简洁的 JSON 格式:

• 类型:daily、weekdays、weekly(选择星期几)、monthly、yearly、custom。
• 自定义间隔/单位:例如每两周(unit: weeks, interval: 2)。
• 结束:永不 / 按日期 / N 次后结束。

虚拟重复实例在渲染时间区间时即时展开。

iCalendar(.ics)

• 导入文件 —— 选择 .ics;通过 external_uid 去重。
• 导出 —— 将当年事件导出为 .ics(使用 ical-generator)。
• URL 订阅 —— 添加 URL 与可选的 Basic 认证。日历按计划自动轮询(默认 60 分钟)。源端删除的事件会同步从 YoBench 中移除。

工作日历

已接入 ru1 提供商 —— 通过 consultant.ru 公开数据获取俄罗斯工作日历。日期类型:

• working —— 工作日
• weekend —— 周末
• holiday —— 节假日
• short —— 缩短工作日

用于计算工作时间并在年/月视图中突出显示非工作日。

架构可扩展 —— 后续可加入其他国家的提供商。

提醒

表单预设:事件前 0、5、15、30、60、120、1440 分钟。到时间后,YoBench 通过通知服务发送操作系统级通知。日历提醒不使用 Telegram / 邮件通道。

由 日历通知 标志(calendarNotificationsEnabled,默认开启)控制。

与跟踪器集成

日历时间轴除了事件外,也会渲染 跟踪器 中具有 due_date 的任务。点击任务可跳转到跟踪器中的详情。

模块全局设置

在 设置 → 日历:

• 日历通知(calendarNotificationsEnabled)—— 启用/禁用提醒。
• ICS 订阅同步间隔(calendarIcalSyncIntervalMinutes)—— 默认 60 分钟。
• 还会保存上次打开的年份与所选工作日历提供商。

使用流程

1. 创建事件

1. 在左侧菜单打开 日历 模块。
2. 点击空白日期单元格或 + 事件 按钮。
3. 填写标题、时间、描述。
4. 可选地设置重复与提醒。
5. 保存。

2. 切换视图

日历顶部 —— 年 / 月 / 周 / 日 / Agenda 切换器。

3. 拖动与缩放事件

拖动事件卡片到另一日期/时间即可移动。拖动底部边缘可调整时长。

4. 连接外部日历

在 订阅 区添加 ICS URL 与(如需)凭据。点击 立即同步 或等待自动同步。

5. 导入/导出

• ICS 导入 —— 点击 导入,选择文件。通过 UID 去重避免重复。
• ICS 导出 —— 点击 导出,保存当年事件。

6. 启用工作日历

在设置中选择 ru1 提供商 —— 非工作日将被突出显示,月/年视图中显示节假日。

下一步

• 连接 任务跟踪 —— 截止日期会自动出现在时间轴上。
• 想从邮件创建事件可使用 邮件。

帮助与反馈

希望支持其他国家的工作日历或 RRULE?通过反馈表单联系我们。