# Portability: USER
# Last validated: 2026-05-17
# Next review: 2027-05-17
# 资源：[assistant_calendar 表，hub/calendar_handler.py]

CALENDAR - 约会和日历管理
=========================================

状态：2026-02-08

日历系统（第 3 层）捆绑时间关键信息 
各种来源（约会、提醒、例行公事）。

核心概念
------------
- 组合：显示助理日历和适当的家庭例行公事。
- 视图：针对 CLI（今天、周、月）进行了优化。
- 持久性：存储在中央“bach.db”中。

CLI 命令（巴赫日历）
---------------------------
  今天 今天的约会和例行公事。
  周 每周概述（周一至周日）以及工作日名称。
  月 当月的所有条目。
  列出所有即将到来的约会（默认值：30 天）。
  添加“标题” 创建新约会 (assistant_calendar)。
  show <ID> 显示预约详细信息。
  完成 <ID> 将约会标记为已完成。
  删除<ID> 删除约会。
  help 显示帮助。

显示格式
--------------
  [星期一 28.01.] --------------------------------------------------
    09:00 牙医穆勒博士
    [R04] ---- 清理厨房（日常、家庭）

数据库（第 1 层）
---------------------
- `assistant_calendar`：用户的手动预约。
- `household_routines`：重复任务（仅显示）。
- `calendar_events`：（可选）系统事件。

GUI 和集成
-----------------
GUI 中的 **助理仪表板** 提供图形化的每周和 
月视图。日历充当第 5 层自动化的时间线。

另请参见
----------
  bach routine         家庭日常管理
  bach --help clock    时间和时间戳工具
  docs/help/memory.txt 会话时间
