提醒

提醒会在之后的某个会话中再次提示一次或重复提示，直到你将其移除。

提醒会在你设定的时间，向一个现有的会话发送提示。它可以仅触发一次，也可以重复触发，直到有人将其移除。代理会用提醒来检查自己的工作进度，例如：“24 小时后检查供应商是否回复了”“每小时检查部署是否正常”。

提醒是一个作用范围限定为单个会话的触发器。两者的区别：

	触发器	提醒
存储位置	`beeuni.yaml`，提交到默认分支	数据库。无需修改清单，也无需提交。
触发时	通常会启动新会话	向其指定的会话发送提示。不会启动会话。
有效期	直到有人从清单中将其移除	直到有人将其移除。如果其会话被删除或失败，提醒会自动暂停。
谁可以创建	项目经理（`project.trigger.create`）	任何可以向该会话发送提示的人。代理只能在自己的会话中创建提醒。
查看位置	`beeuni triggers ls`，触发器页面	`beeuni reminders ls`，每个会话各自显示

对于任何人都应该看到的项目工作（例如每日摘要），请使用触发器。对于属于单项任务的后续跟进，请使用提醒。

开启提醒

提醒是项目级的功能标记，reminders，默认关闭。可在 Settings → Feature flags 中开启，或运行：

beeuni projects features enable reminders

标记关闭时，所有提醒路由都会返回 403 和 code: "feature_disabled"，提醒页面会说明如何开启，现有提醒也不会触发。重新开启标记后，关闭期间错过的时段会触发一次，之后按计划继续。

设置提醒

在会话内使用 CLI 时，命令会针对当前会话。在会话外使用时，请传入 --session <id>。

# Fire once, 24 hours from now.
beeuni remind "Check whether the vendor replied to the contract email." --in 24h

# First fire in 24 hours, then every hour until removed.
beeuni remind "Did the vendor reply? If yes, summarize it and remove this reminder." --in 24h --every 1h

# Fire at an exact instant.
beeuni remind "Post the launch checklist to #launch." --at 2026-10-01T09:00:00Z

# Repeat on a cron expression in a time zone.
beeuni reminders add "Post the standup summary." --cron "0 0 9 * * 1-5" --timezone Europe/Berlin

命令会输出提醒 ID（例如 reminder.3f9a1c2e7b04）以及下一次触发时间。

计划规则

--in <duration> 或 --at <ISO-8601> 用于设置首次触发时间。单独使用时，提醒仅触发一次。
--every <duration> 用于重复触发。最短周期为 5m。每个周期从上一次触发被领取时开始计算。
--cron "<expr>" 按 6 字段 cron 表达式重复触发（秒在第一位）。--timezone 用于设置时区；默认值为 UTC。Cron 提醒的触发频率不得超过每 5 分钟一次。它不接受 --in 或 --at。
时长格式为 30m、24h、2d 或整数秒。
--in、--at 和 --every 最多接受 366 天。
每个会话最多可有 20 个启用中的提醒。每个项目最多可有 200 个。超出任一限制都会返回 409。

触发时会发生什么

每次触发都会将提醒文本作为提示排入会话，提示以以下标头开头：

[REMINDER reminder.3f9a1c2e7b04 — recurring scheduled check-in on this session, not a new user message. When it is no longer needed, run `beeuni reminders rm reminder.3f9a1c2e7b04`.]

Did the vendor reply? If yes, summarize it and remove this reminder.

处于停放状态的会话会唤醒。代理可以访问该会话的完整对话和工作区。
触发不会启动新会话。如果会话被删除或失败，提醒会暂停，原因会记录在 last_error 中。
触发时会保留会话的个人连接，例如成员自己的 Gmail。如果你为一个并非由你操作的会话设置提醒，这些连接会被清除，与向该会话发送提示的行为相同。
项目级的触发器暂停设置（beeuni triggers pause）也会停止提醒。

每次触发都会产生一个模型轮次。条件满足后，请立即移除重复提醒。

管理提醒

命令	效果
`beeuni reminders ls [--json]`	列出会话的提醒：ID、状态、计划、下一次触发时间和文本。
`beeuni reminders pause <id>`	停止触发，但保留提醒。
`beeuni reminders resume <id>`	再次触发，并从现在开始重新计时。已触发过的一次性提醒仍保持 `done`。
`beeuni reminders rm <id>`	删除提醒。别名：`stop`、`delete`。

提醒状态可以是 active（已计划）、paused（已关闭）或 done（已触发的一次性提醒）。

API 和 SDK

这些路由的作用范围限定为会话：

路由	效果
`GET /v1/projects/:projectId/sessions/:sessionId/reminders`	列出提醒。
`POST /v1/projects/:projectId/sessions/:sessionId/reminders`	创建提醒。请求体：`prompt`、可选的 `name`，以及 `every`、`cron` + `timezone`、`at` 或 `in`。返回 `201`。
`PATCH /v1/projects/:projectId/sessions/:sessionId/reminders/:reminderId`	请求体为 `{ "enabled": false }` 时暂停，为 `{ "enabled": true }` 时恢复。
`DELETE /v1/projects/:projectId/sessions/:sessionId/reminders/:reminderId`	删除提醒。

计划无效时，会返回 400 和原因。会话已删除时，会返回 409。代理凭据指定了其他会话时，会返回 403。

const reminders = beeuni.session(projectId, sessionId).reminders;
const reminder = await reminders.create({ prompt: 'Did the vendor reply?', in: '24h', every: '1h' });
await reminders.update(reminder.id, { enabled: false });
await reminders.remove(reminder.id);