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
14 Commits
Author SHA1 Message Date
laoyang 42fb5fd120 release: 版本升级 0.2.0 → 0.2.1（待办功能小升级） 
## 版本变更
- versionName: 0.2.0 → 0.2.1
- versionCode: 10200 → 10201

## 同步一致性验证（用户要求）
对比手机端本地库与服务端 CalDAV 的待办数据：

| 日历本 | 服务端 | 手机端 |
|---|---|---|
| Inbox | 测试收件箱、再测试 | 同 ✅ |
| 家庭计划 | 洗衣服、做饭、买菜 | 同 ✅ |
| 工作任务 | 写方案、研讨会 | 同 ✅ |
| 个人成长 | 健身、读书 | 同 ✅ |
| 合计 | 9 条 | 9 条 ✅ |

完成状态也一致：研讨会 `STATUS:COMPLETED`/100% ↔ `completed=1`，
其余 8 条 `NEEDS-ACTION`/0% ↔ `completed=0`。

**结论：标题、归属、完成状态三项完全一致，同步正常。**

## 产物验证
解包 HAP 读 module.json：
```
bundleName : synccalendar.yangyq.net
versionName: 0.2.1
versionCode: 10201
```
大小 4.36 MB，BUILD SUCCESSFUL，已安装到真机。
 2026-11-05 16:50:05 +08:00
laoyang 37062cc75b feat(0.2.0): 待办同步、事件标记、反馈系统迁移、版本升 0.2.0 #5 #6 
## 版本
versionCode 10200 / versionName 0.2.0（原 10000 / 0.1.0）

## 新增
- **VTODO 待办完整支持**：同步、展示、勾选完成、编辑、循环待办。
  关键修复：待办此前**从未被同步过** —— 同步主循环只处理 VEVENT，
  `DavClient.reportTodos()` 写了却零调用（死代码）。现已在
  `SyncEngine.syncAccountInner` 接入，并对未知类型本也拉一次
  （服务器多半不声明 supported-calendar-component-set，宁多拉不漏）。
  整段包 try/catch，单本失败不影响日程同步。
- **日历本类型图标**：`supported-calendar-component-set` 解析出
  event/todo/both/unknown，账号页在颜色前显示对应 SVG 图标。
  unknown 按日历对待（服务器不声明时不能武断判成待办）。
- **问题反馈入口**：设置页新增卡片，指向 FeedLite
  （https://feedlite.yangyq.net/?sw=synccalendar）。

## 改进
- 月视图事件标记：农历下方浅红点，每日期最多一个
- 选中/今天改为正圆底，周视图复用月视图 `dayCellCircle`
- 「今天」按钮状态化（在不在今天，视觉可辨）
- 待办页签按需显示（只看 todos.length，不依赖可能缺失的 comps）
- 新建非今天日程默认 09:00（统一 DEFAULT_START_HOUR）

## 修复
- 首屏农历不变色：外层 ForEach key 缺数据版本 → 整树复用不重绘
- 翻月闪跳：async 未等待 + @State 同栈不可读 → 改 rebuildPagesFor(y,m) 显式传参
- 翻月后整月无选中：选中日未随月迁移，且钳制导致日号漂移 → 加 preferredDay
- 周视图颜色过浅/选中不变白/星期标签丢失：复用组件时未设 inMonth

## 官网
- sf.html 新增「三、待办清单」章节（原三~八顺延为四~九）
- index.html 版本号 V0.1.0 → V0.2.0

## 工单
关闭 #3 #4 #5 #6；新建 #7 记录「VTODO 无法镜像到系统待办」的技术限制。

## 未做（技术限制）
镜像到系统日历「待办」页签：鸿蒙未开放待办 API，不可行。见 #7。
 2026-11-02 22:58:30 +08:00
laoyang b7bc4b5403 chore: 版本号 0.0.9 -> 0.1.0（versionCode 10000） 
0.0.9 已上架，开启 0.1.0 开发周期。
versionCode 按 major*1e6 + minor*1e4 + patch*100 计 = 10000。

同步更新官网 deploy/site：index.html / sf.html / uh.html 的版本标识，
_404.tpl.html 改后重跑 _gen404.py 重新生成 404.html。
 2026-10-21 14:12:52 +08:00
laoyang c711cdb7d5 版本号 0.0.8 -> 0.0.9（versionCode 900） 2026-10-20 22:34:12 +08:00
laoyang a49e7d03b1 0.0.8：系统日历账户显示名可切换 + 清理判定改为 bookId 身份校验 
背景：应用往系统日历写数据时，账户显示名固定为「同步日历 · <本名>」。多账号用户
无法看出某个日历本属于哪个账号；若把"应用名+账号名"都写上又太长，本名被挤压看不清。
方案见《镜像账户命名方案-去掉应用名前缀.md》，影响评估见《0.0.8升级影响评估.md》。

平台硬约束（已核实 @ohos.calendarManager）：
  **没有"修改账户"的 API**（只有 create/delete/get/getAll；CalendarConfig 仅
  enableReminder+color；CalendarAccount.name 为 readonly）→ displayName 只能在
  创建时定，改名必须"删账户 → 重建"。

实现：
1. **三种显示名格式**（分隔符统一半角点 `·` U+00B7、**无空格**）：
     1 = `同步日历·<本名>`
     2 = `同步日历·<账号>·<本名>`
     3 = `<账号>·<本名>`  ★默认
   ⚠️ **不提供"仅本名"**：裸本名与用户原有同名日历本无法区分 → 有误删风险；
      每个镜像账户名必须至少带一个归属标识（同步日历/账号名/二者）。
   displayName 上限 64 字符 → 超长自动截断。
2. ⭐ **一键重命名** `MirrorRenamer.reapplyDisplayNames`，顺序**不可调换**：
     ① `MirrorInbound.reconcile()` 先回读（把用户在系统日历里手动新建/改动的
        收进本地库并置 dirty）—— 因为 deleteCalendar 会删掉账户下**所有**日程，
        含用户手动加的，不回读就会丢数据；回读失败则**中止**重命名（宁可不改）。
     ② `removeAccountsByBookIds` 删旧账户（按 bookId 精确定位，与名字无关；
        含"清空日程后重试"降级）
     ③ `syncNow()` 按新格式重建并全量写回
   独立成模块的原因：MirrorInbound 已 import SystemCalendarMirror，反向 import 会成环。
3. ⭐⭐ **清理判定改为「bookId 身份校验」**（`isOurMirrorAccount`）—— 用户指出的关键改进：
     **两道闸**：① name 必须以 `synccalendar.mirror.` 开头（挡掉别人家的账户）；
     ② 从 name 切出 `accId`（取最后一个 `-` 之前）并确认在账号库中。
     ⭐ **附加安全阀**：账号库读不到 → **一律不认为是我们的**（宁可不清，不可误删）。
     `displayName` 兜底**降级为仅格式 1/2 可用**（格式 3 = `账号·本名` 与别的 App
     账户可能同名，参与兜底会误删）。
     ⇒ **删不删看 accId 是不是我们的；名字只用来显示。** 判定与名字彻底解耦。
4. `AppSettings` 新增 `mirror_display_format`（1|2|3，默认 3；非法值回落 3）。
5. 设置页新增「系统日历中的显示名称」：三种格式胶囊选择 + **用真实账号名/本名实时预览**
   + 「应用」按钮（未变化时禁用、失败自动回滚选项）+ 检测到旧格式时的弱提示
   + 说明"期间日程会短暂消失几秒"。
6. `ensureCalendar` 按格式创建（已有账户**不在此处改名** —— 改名是破坏性操作，
   必须由用户显式点「应用」触发）；`syncBook` 增加 format 参数并逐层传递。
7. `describeCal` / `purgeOrphans` 参数语义更新（aggressive → allowDisplayMark）。

**不做自动迁移**（用户决定）：升级后老账户名字不变、日程不动，用户想换才在设置页点。
理由：自动迁移期间日程会短暂消失，老用户可能正在开会/开车，看到"日程全没了"会惊慌；
且默认格式是主观偏好，强改所有人等于替用户做决定。

验证：
- 编译通过（BUILD SUCCESSFUL）；包内版本 800/0.0.8。
- 离线用例覆盖：三种格式生成（确认半角点、无空格）、64 字符截断、
  身份判定五种情形（含"别的 App 同名账户不被删""accId 失效的孤儿仍被清"
  "读不到账号时一律不删""格式 3 兜底失效"）—— **全部通过**。
- 手机未连接 → 未装机（待用户插线后安装测试）。
 2026-10-14 10:09:48 +08:00
laoyang ed26da8dc4 0.0.7：CalDAV 地址自动发现 + 人话错误提示 + 只读公开日历 
背景：用户反馈（Nextcloud/内网）——DAVx5 用 CalDAV 地址能完整读取，换本应用
读不出日历；用"分享链接"绑定时提示服务器返回 405。

定位：不是协议问题，而是"填入的 URL 不是 CalDAV 端点"。
  ① 我们的发现＝PROPFIND+Depth:1 只认 resourcetype 含 calendar 的集合；填 DAV 根
     /remote.php/dav 只能看到 principals/calendars/addressbooks → "未发现日历本"。
  ② 分享链接（/apps/calendar/p/<token>、/s/<token>）是网页路由 → PROPFIND 405。
  ③ 全工程此前无 .well-known 自动发现（grep 无命中）→ 必须手填完整路径，
     而 DAVx5 内置自动发现，故"DAVx5 能用、我们不能"。

实现（新增 common/DavDiscovery.ets）：
1. .well-known/caldav 自动发现：207/200 直接用；301/302/307/308/401 读 Location
2. 智能补全：按 Nextcloud/ownCloud/Radicale/Baikal 等常见路径生成候选并逐个探测，
   保留子目录前缀（填 https://h/nextcloud → /nextcloud/remote.php/dav/calendars/<u>/）
3. 分享链接识别：/apps/calendar/p/、/s/、/index.php/s/ 直接拦下并给改法
4. OPTIONS 能力探测：读 DAV/Allow 头，区分"不是 DAV 端点"与"服务端挡了方法"
5. 状态码人话化：405/401/403/404/跳转/网络失败各有可操作指引；
   "未发现日历本"区分"地址差一层"（给出补全后的正确地址）与"确实为空"
6. 只读公开日历：识别 public-calendars 链接；只读由既有 calendarWritable 探测自动标记

接入三处：
- CalendarListPage.fetchCalendars / EditAccountPage：先 resolve() 定位端点，
  命中则自动修正 serverUrl（并落库），失败则直接给人话原因
- AddAccountPage：连接前拦分享链接；probeServer 遇 405 用 OPTIONS 判定并给指引；
  地址输入框提示同步更新

设计要点：发现顺序＝原地址优先（保持既有行为、不破坏已能用的用户）→ .well-known
→ 常见候选；单个候选失败不抛错；ArkTS 静态方法内禁用 this → 统一用类名调用。

验证：编译通过；离线用例覆盖分类/完整性判定/候选路径（4 种输入形态）全部通过。

版本：AppScope/app.json5 → 0.0.7 / 700
文档：新增《上架更新说明-0.0.6到0.0.7.md》；官网 sf/uh 补功能说明与使用指引、
  版本号与日期更新、404 重建，已部署并线上核验。
打包：assembleApp release → verify-app success、profile type=release、
  app-distribution-type=app_gallery、包内版本 700/0.0.7。
 2026-10-13 12:43:26 +08:00
laoyang da0249d9f4 版本号升至 0.0.6（versionCode 600） 2026-10-10 08:30:12 +08:00
laoyang d5e5d54d35 账号页空状态的「＋」可点击；版本号升至 0.0.5（versionCode 500） 
- AccountsPage.emptyState 的「＋」改为可点击按钮，直接进入添加 CalDAV 账号页
  （此前只是静态图标，点了没反应）；提示文案同步更新
- 版本号 0.0.4 → 0.0.5
 2026-10-09 19:23:29 +08:00
laoyang b83ce83d43 版本号升至 0.0.4（versionCode 400） 2026-09-29 08:46:48 +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 088f7b3773 增加了用户隐私协议等，增加了引导卡片。 
Signed-off-by: Yang Yongquan <i@yangyq.net>
 2026-09-15 09:06:15 +08:00
laoyang c04a9a28cf 更改了日程的样式显示，现在按照时间轴显示。 
Signed-off-by: Yang Yongquan <i@yangyq.net>
 2026-09-14 21:28:51 +08:00
laoyang bbb3ec5334 首次提交：SyncCalendar 项目 2026-09-13 15:50:37 +08:00