laoyang/SyncCalendar
1
0
Fork 0
Code Issues 1 Pull Requests Actions Packages Projects Releases Wiki Activity
123 Commits 1 Branch 11 Tags
42fb5fd120ba2e1145c57250aa69162ae255f8c9
Commit Graph
11 Commits
Author SHA1 Message Date
laoyang d9db8b476a feat(待办): 子任务（RELATED-TO）+ 附件（内联 base64 ATTACH）(#43 #44) 
补齐待办模块最后两项协议能力。

## #43 子任务（父子结构）

### 协议
`RELATED-TO;RELTYPE=PARENT:<父uid>`，值用**父任务 UID**（不是本地 id——
父子关系是服务器资源属性，跨设备同步时 UID 才稳定）。

### 数据层
- `LocalEvent` / `RemoteEvent` / `DisplayEvent` 加 `parentUid`
- 表加 `parent_uid` 列，`toBucket`/`fromRow`/`applyRemote` 双向映射

### UI
- 列表：子任务缩进 34vp + 标题前「∟」连线符
- 父任务副行追加子任务进度「N/M」
- 编辑弹层加「父任务」行 → 覆盖层选择（候选 = 未完成顶层任务，
  排除自己及后代，防成环）
- **父任务勾选完成 → 级联完成所有未完成子任务**（用户选定的语义）

## #44 附件（内联 base64）

### 查证 + 实测（已更新 #44 工单）
- iCalendar RFC 5545 原生支持 ATTACH，两种形式：URI / **内联 base64**
- RFC 8607 托管附件需服务器特殊支持（群晖没有）
- **实测群晖**：PUT 带 `ATTACH;...;ENCODING=BASE64;VALUE=BINARY:<b64>` → 201，
  GET 回原文原样保留（4558 字符整行、含中文文件名「报告.pdf」都不丢）

### 实现（按标准协议，直接上传同步）
- 附件 = VTODO 的 ATTACH 行（内联 base64），随 .ics 一起 PUT 同步
- 不需要自己传文件贴链接
- `buildTodo` / `rewriteTodoFields` 读写 ATTACH；`parseTodos` 解析回填
- 数据层 `attachments` 存 JSON（[{name,mime,base64}]），base64 直接存库零转换
- UI：弹层加「附件」区，文件选择器选文件 → 读二进制 → base64 编码 → 随待办保存

### 限制
最多 3 个附件、单文件 ≤5MB（内联 base64 会让 .ics 膨胀，限制防爆）。

### 折行决策
**不折行**。原因：① 工程现有 SUMMARY/DESCRIPTION/LOCATION 一贯整行不折；
② 群晖实测 4558 字符整行也能存；③ RFC 折行是 SHOULD 非 MUST，一致性优先；
④ 折行若按 75 octets 硬切会把 UTF-8 中文名（「报告.pdf」）拦腰切断成乱码。

## 兼容性
`rewriteTodoFields` 新增 `touchParent` / `touchAttach` 哨兵：
编辑只改标题时传 false，服务器上**其他客户端写的 RELATED-TO / ATTACH 原样保留**；
只有用户实际编辑了父任务/附件才 touch=true 重写。

## 验证
- 编译 `BUILD SUCCESSFUL`
- 协议往返（Python 等价复刻）：生成→解析 无损，附件 base64 还原正确
- 服务器端到端：PUT(201) + GET 原样返回 RELATED-TO + 中文文件名 ATTACH

## 未验证
真机 UI（设备离线）。需人工验：子任务缩进、级联完成、文件选择器上传、
附件随待办同步到另一客户端。
 2026-11-04 17:19:43 +08:00
laoyang 413900bbce feat(待办): 提醒 / 左滑删除 / 优先级标签地点 / 编辑热区 / 卡片刷新 (#38 #39 #40 #41 #42) 
一次性完成待办模块的 5 项缺口。

## #38 待办提醒
`ReminderService` 原本只服务 `kind='event'`，待办完全不提醒。

- `EventDb.queryRemindableTodos`：查未完成待办，**额外要求 `completed=0`**
  （否则做完的待办到期还会弹）
- `refreshReminders` 合并日程 + 待办两路查询，文案按 kind 分支：
  待办是「将在 X 分钟后到期」/`该待办已到期`，日程仍为「开始」
- `IcsUtil.buildTodo` 写 VALARM；`rewriteTodoFields` 编辑时整段重建 VALARM
  （逐行改 TRIGGER 容易漏 ACTION/DESCRIPTION）
- 待办弹层加提醒芯片（不提醒 / 5 / 15 / 30 分钟 / 1 小时 / 1 天，多选）
- 三个写操作后调 `refreshReminders`，保证改完立刻重排

协议要点：VTODO 的 VALARM `TRIGGER` 相对 **DUE**（RFC 5545 §3.8.6.3），
所以 `TRIGGER:-PT5M` 就是"到期前 5 分钟"，无需额外写 RELATED=END。

## #39 待办列表左滑删除
`swipeAction` 只能挂 ListItem，而原结构是 `Scroll + Column + ForEach`。

- 外层 Scroll → List，分组改用 `ListItemGroup`（保留"色点+本名+条数"分组头）
- 每个 ListItem 挂 `swipeAction({ end: ... })`，滑出红底「删除」
- 点击复用现有 `askDeleteTodo`（二次确认）→ `doDeleteTodo`（软删 + 服务器 DELETE）
- 未完成 / 已完成两个清单都支持

## #40 优先级 / 标签 / 地点
- 表加 `priority`(INTEGER) / `categories`(TEXT)；`location` 本来就有
- PRIORITY 存 **iCal 原生值**（1 最高 … 9 最低，0 未设置），写回零转换
- ICS：`parseTodos` 读 PRIORITY/CATEGORIES，`buildTodo` 与 `rewriteTodoFields` 写
- 新增 `todoExtras()` 供新建与改写共用，避免两处生成结构不一致
- `rewriteTodoFields` 用 `priority=-1` 做"不改"哨兵（0 是合法语义：清空）
- 弹层加优先级芯片（高/中/低）、标签输入、地点输入

## #41 重复待办打勾推进
核查结论：**已实现且完整**。`toggleTodo` 已按 `recurRule !== ''` 分流到
`completeRecurringRound`，且该方法会保留"基准→DUE 偏移"、复位 STATUS 后推进。
本次未改逻辑，仅补了完成后刷新卡片与提醒。

## #42 编辑入口热区
内容区 `Column` 原来高度只到文字高度，行内上下留白点不到。
加 `.height('100%')` + `justifyContent(Center)` 撑满行高。
勾选圈仍是独立 onClick（ArkUI 不冒泡），点圈只切完成态、不进编辑。

## 顺带修复（共性遗漏）
`toggleTodo` / `saveTodoEdit` / `saveNewTodo` / `doDeleteTodo` 四处
改完库只刷 `this.todos`，**都没推送桌面卡片** —— 卡片停在旧数据。
四处统一补 `CardDataService.pushToAllForms`。

## 验证
- 编译 `BUILD SUCCESSFUL`
- 真机 dump 确认弹层新 UI 全部渲染：优先级（高/中/低）、
  提醒（不提醒/提前5分钟/15/30/1小时/1天）、标签、地点
- ICS 生成逻辑用等价实现校验：PRIORITY、CATEGORIES（逗号转义 \,
  LOCATION、VALARM（TRIGGER:-PT5M 位于 VTODO 内、结构闭合）全部通过

## 未验证
端到端「填字段→创建→查服务器 ICS」未跑通：`uitest inputText` 按坐标输入时
多个输入框会累积到同一个（把标签/地点内容追加进了标题框），是自动化限制而非代码问题。
需人工建一条带各字段的待办，确认服务器端 ICS 与上述结构一致。
提醒能否实际弹出依赖代理提醒权限（此前有配额为 0 的记录）。
 2026-11-04 08:23:42 +08:00
laoyang 2bb620a6ed fix(日历本): 按 COMP_SET 类型分别列出 —— 待办只给待办本，日程只给日历本 
上一个提交把"全部可写本"铺开，导致新建待办时连纯日历本（娱乐/生活/工作/家庭）
也列出来，新建日程时又把纯待办本列出来。用户选错类型时服务器会拒绝写入，
或写进去但永远不在对应列表显示。

## 依据
`DavAccount.calendarComps[i]` 早就在库里存着服务器 COMP_SET 声明：
  'event'   只有 VEVENT
  'todo'    只有 VTODO
  'both'    两者都支持
  'unknown' 未声明（旧数据）

但 `CalSource` 没透传它，界面层拿不到类型，只能按"可写"一刀切。

## 改动
- `CalSource` 增加 `comps` 字段
- `CalendarDataService.loadSources` 从 `acc.calendarComps[i]` 透传（空串归 'unknown'）
- 待办侧（`Index.openTodoCreator`）：排除 `comps === 'event'`
- 日程侧（`EventEditPage.CalendarDataBridge.loadWritableDavSources`）：排除 `comps === 'todo'`

**'unknown' 两端都保留**：旧数据没有 COMP_SET 信息，武断排除会让老用户
升级后发现日历本"消失"。

## 真机验证（5NC0225B27004718）

服务器实际类型（PROPFIND 实测）：

| 本 | COMP_SET | 待办列表 | 日程列表 |
|---|---|---|---|
| 娱乐 / 生活 / 工作 / 家庭 | VEVENT | 不显示 | 显示 |
| Inbox / 家庭计划 / 工作任务 / 个人成长 | VTODO | 显示 | 不显示 |

改后实测：
- 新建待办 → 只列「群晖:Inbox / 家庭计划 / 工作任务 / 个人成长」4 个 ✅
- 新建日程 → 只列「群晖 · 娱乐 / 生活 / 工作 / 家庭」4 个 ✅

两端的本数量都从 8 降到 4，与服务器声明完全一致。

## 编译
`BUILD SUCCESSFUL`
 2026-11-03 23:04:00 +08:00
laoyang 788171d1b2 feat(待办): 支持循环任务（标准 CalDAV / VTODO RRULE）#5 
只按标准 CalDAV 实现，不依赖家书的自定义机制。
群晖等标准服务器：RRULE 写在 VTODO 上，由客户端负责展开。

## 核心语义决策
循环待办「勾完成」= 这一轮做完了，推进到下一周期，而不是结束。
若照搬非循环逻辑（置 COMPLETED 就完结），用户每勾一次循环任务它就永久结束，
循环规则等于白设。所以：
  · 非循环 → 置 COMPLETED，永久结束
  · 循环   → DUE 推到下一周期 + 状态复位 NEEDS-ACTION

## 关键修复：DTSTART 与 DUE 必须分开
原 parseTodos 把 DUE 和 DTSTART 都写进 startTime，后出现的覆盖先出现的。
但循环下两者语义完全不同：
  · DTSTART = RRULE 的重复基准
  · DUE     = 这一条的截止时间
混在一起会导致重复基准被截止时间覆盖，算出来的发生日全错。
现在拆成独立字段，数据库补 dtstart 列（rrule 列已有）。

## 顺带修掉两个既有 bug（测试连带查出）
rewriteTodoCompletion 与 rewriteTodoFields 里，插入阶段的块序号
vtodoIdx 在遇到 END:VTODO 时被重置成 -1 ⇒ 每块都从 0 重新数，
多 VTODO 文件里永远匹配不到目标块，字段加不上（静默失败，
表现为「点了没反应」）。三处一并修正，vtodoIdx 改为全局块序号。

## 实现
- IcsUtil.incForFreq：按 FREQ 推周期，处理月末溢出
  （1/31 + 1月 → 2/28 钳制，不跳到 3 月；2/29 + 1年 → 2/28）
- IcsUtil.freqOfRrule / rewriteTodoRecurrence
- TodoService.setRecurrence / completeRecurringRound
- 写回时同时给 DTSTART + DUE：RFC 5545 里 VTODO 的 DTSTART 是 OPTIONAL，
  但缺它时各客户端对 RRULE 基准理解不一致，显式给能消除歧义
- 待办行显示「↻ 每周」标记（否则循环任务和普通待办长得一样，
  用户勾完发现「又冒出新的」会困惑）
- 编辑弹框加 每天/每周/每月/每年 选择，再点一次取消

## 验证
scripts/test-ics-todo-recurrence.js：24 项全通过
（月末钳制、闰年、字段保留、取消循环、多 VTODO 定位、结构完整性）。
编译 BUILD SUCCESSFUL。

## 说明
服务器若不支持 RRULE（如群晖 Calendar 规格里未提及循环任务），
则循环只在客户端可见，同步到其它客户端会退化为普通任务。
 2026-11-02 16:53:30 +08:00
laoyang 9066a12bbc feat(待办): 按日历本分组 + 编辑/删除 + 修整行点击误完成 + 周视图圆点 #5 #6 
## 1. 修 bug：整行点击都会勾选完成
上一版把 onClick 挂在最外层 Row 上，点标题/点截止时间/点空白都会改状态。
改为：
  · 只有左侧圆圈 → 勾选/取消完成
  · 其余内容区 → 打开编辑弹框（不改变完成状态）

## 2. 待办按日历本分组
用户：待办应按日历本分类，未完成里也能按家庭/生活分开，要有区分度。
未完成/已完成 两大段内部，再按日历本聚合：
  · 分组标题前带该本颜色圆点（这是区分度的来源）
  · 组标题显示 本名（数量）
  · 组内按截止时间升序，无截止时间排最后
  · 组之间按组内最早截止时间排序（最紧急的本在前）
CalendarDataService.loadTodos 补 d.calName（原来只带 calKey，分组标题没名字）。

## 3. 待办编辑弹框
点内容区弹出，可改：标题 / 备注 / 截止时间（含日期+时间选择器，可清除），
另有删除（二次确认）。只读本禁用编辑并提示。

⚠️ 用**整页覆盖层**而不是 bindSheet：ArkUI 同一组件只能挂一个 bindSheet，
Index 已用 detailShow 挂了日程详情，再挂会被覆盖（EventEditPage 顶部记过此坑）。

写入仍走「GET 原文 → 改字段 → PUT」，只动 SUMMARY/DESCRIPTION/DUE，
**不动 STATUS/COMPLETED**（改内容不该重置完成状态），
并保留 PRIORITY/CATEGORIES/X-* 等本地没存的字段。

## 4. 周视图圆点
weekStripDays 原来没算 hasEvent；补上与月视图**共用同一份**事件日期集合
（buildEventDaySet），口径完全一致。
颜色：用主题色 brand（选中日换白），**不取日历本的颜色** ——
圆点只表示这天有安排，若取本色会误导成只有那个本有日程。

## 验证
scripts/test-ics-todo-fields.js：19 项全通过
（保留 PRIORITY/CATEGORIES/X-扩展、特殊字符转义、多 VTODO 只改目标、
缺字段补齐位置、结构完整性）。编译 BUILD SUCCESSFUL。

## 未做
子任务（父子层级 / RELATED-TO）：需先确认服务器是否支持，另开工单。
 2026-11-02 15:47:03 +08:00
laoyang 736a0a6587 新增系统日历镜像功能，镜像与备份目标统一改用 bookId；修复重复日程覆盖行、备份目标随勾选漂移等一批问题 
- 新增 SystemCalendarMirror / MirrorSnapshot / MirrorInbound：把选定的 CalDAV 日历本镜像写入系统日历（供小艺、桌面日历卡片、手表可见），并做入站对账，区分"自己写入的 / 用户改的 / 用户删的 / 用户新建的"，镜像标识一律用稳定的 bookId（accId-href哈希），不再用会随勾选顺序漂移的 calKey
- 后台同步接入镜像：同步前先做入站对账、同步后自动出站镜像，无需用户手动触发
- 系统日历备份目标改用 bookId：当用户取消同步某个日历本导致目标失效时，自动清空目标并把模式回退为"仅显示"；开启备份必须先选定目标本，不再自动挑第一个本
- EventDb：覆盖行保留 RECURRENCE-ID，排除主事件对应发生改用 overrideKey(calKey, uid, recurrenceId, startTime)，修复重复日程出现"幽灵条目"的问题
- 新增 WRITE_CALENDAR 权限声明及其用途说明；添加日历不再出现"本机"，日历本对齐显示；版本升至 0.0.3(300)
 2026-09-19 23:07:03 +08:00
laoyang 353473127a 应用在首次打开或运行中，在用户未主动点击权限对应的相关功能或服务时，提前向用户弹窗申请开启【读取全部日程】权限，不符合相关法律法规要求。该问题已被修复。 
Signed-off-by: laoyang <laoyang@example.com>
 2026-09-16 20:54:41 +08:00
laoyang 5ab9648b5a 修复了新增日历本颜色不对的问题。 
Signed-off-by: Yang Yongquan <i@yangyq.net>
 2026-09-15 23:03:58 +08:00
laoyang 04fdf3d386 1.增加了重力感应，也就是横屏响应式布局。 
2.修改了沉浸式布局。
3.修改了添加日程和编辑日程页面，增加了重复、提醒等功能。
4.修改了权限问题，如果日历本是只读，则有删除线做标识。同时，对于只读的日程，点击后将不再进入编辑页面，而是展示详情。
5.系统日历的处理。给用户两个选择，第一个选择就是只显示系统日历。第二种选择，用户可以选择一个caldav账户中的某一个日历本，把系统日历中的日程，包括日历日程和应用创建的日程，都读取出来，然后加入到这个日历本下，最后同步到caldav的服务器上，这样的好处是，手机丢失了，或者换了手机品牌型号，手机上的日程仍然在自己的caldav服务器上有一个备份。当然，系统日历中的caldav日历，就不会再读取了。
 2026-09-13 20:25:18 +08:00
laoyang 61bd6fc75f 修复了重复日历第一次不显示的问题。 2026-09-13 17:48:39 +08:00
laoyang bbb3ec5334 首次提交：SyncCalendar 项目 2026-09-13 15:50:37 +08:00