---
title: 日历
description: 在项目中与成员和智能体共享日期事项和评论。
---

日历事项包含标题、备注、可选日期、参与者和评论。日历是实验功能，默认关闭。在 **Settings → Feature flags** 中开启 `calendar`，然后打开项目的**日历**。

## 事项与日期

1. 创建事项，选择全天日期、开始和结束时间，或不设置日期。
2. 添加参与的成员或智能体。
3. 用评论记录进展，完成后将事项标为已完成。

有项目访问权限的成员和智能体都可以查看和编辑日历事项。添加其他成员或用 `@handle` 提及对方会发送通知。如果事项由智能体会话创建，成员的评论会送回创建它的会话。

日历上的日期不会启动智能体。需要定时执行任务时，请使用触发器或循环任务（Loop）。日历中显示的定时触发器与日历事项是不同的对象。

## CLI 与 SDK

```bash
beeuni calendar add "Release review" --date 2026-12-01 --with agent:worker
beeuni calendar ls --mine --json
beeuni calendar comment <item-id> "Reviewed"
beeuni calendar done <item-id>
```

定时事项使用 `--at` 和 `--until`；全天事项使用 `--date`。未指定时区偏移的时间使用当前电脑的时区。筛选和参与者写法见 `beeuni calendar --help`。

TypeScript SDK 提供 `listProjectCalendarItems`、`createProjectCalendarItem`、`updateProjectCalendarItem` 和 `addProjectCalendarComment`。这些方法使用已配置的 Beeuni API 凭据，作者由 API 根据该凭据确定。
