feat: 增强日历功能并集成 AgentScope 代理服务

2026-03-11 17:16:11 +08:00
parent e20e7d2a02
commit 85b314cf64
53 changed files with 3642 additions and 297 deletions
@@ -0,0 +1,63 @@
+# 日历提醒字段与详情页对齐设计
+
+**Date:** 2026-03-11
+**Status:** 已确认
+
+## 目标
+
+- 修复日历事件详情页字段映射错误，去掉 raw metadata 直出
+- 新增可持久化的提醒字段（方案1）：`metadata.reminder_minutes`
+- 打通前后端和 AgentScope 工具调用链
+- 用前端本地通知实现系统提醒与震动
+
+## 数据契约
+
+### metadata 结构
+
+```json
+{
+  "color": "#4F46E5",
+  "location": "会议室A",
+  "notes": "带电脑",
+  "attachments": [],
+  "reminder_minutes": 15,
+  "version": 1
+}
+```
+
+### 字段规则
+
+- `reminder_minutes`: `int | null`
+- 取值范围：`0..10080`（0 表示准时提醒，10080 表示最多提前 7 天）
+- 兼容历史数据：缺失或 null 视为无提醒
+
+## 前端设计
+
+1. 模型层（`ScheduleMetadata`）新增 `reminderMinutes`
+2. 详情页：提醒时间改为结构化渲染
+   - null: `无`
+   - 0: `准时提醒`
+   - n: `开始前 n 分钟`
+3. 创建/编辑弹层新增提醒选项，默认值为 `15`
+4. 删除 metadata raw 原样渲染区块
+
+## 本地通知设计
+
+- 采用 Flutter 本地通知，调度时间：`startAt - reminderMinutes`
+- 创建/编辑成功：重建该事件通知
+- 删除成功：取消该事件通知
+- App 启动后：扫描未来事件并重建通知（补偿机制）
+
+## 后端与 AgentScope 设计
+
+1. `ScheduleItemMetadata` 增加 `reminder_minutes`
+2. service 继续走 `metadata -> extra_metadata`，不加新 DB 列
+3. AgentScope `calendar.write` 增加 `reminder_minutes` 参数
+4. CrewAI calendar tool 将 `reminderMinutes` 映射为 `metadata.reminder_minutes`
+5. calendar tool 回包增加 `reminderMinutes` 字段
+
+## 验证策略
+
+- 后端：schemas/service/agentscope 单元测试
+- 前端：calendar_api 与详情页渲染测试
+- 手动：创建提醒 -> 等待系统通知与震动 -> 更新/删除后确认调度变更