MailUI4Agents

Files

JianFeeeee bcd7e7f217 跨端: 鸿蒙日历补 .ics 导入导出（WebUI 有、鸿蒙一直没有）

WebUI 工具条那两个入口（`CalendarView` 的导入/导出图标）鸿蒙侧一直缺，
`CalendarPage` 的文件头也一直诚实写着"没做：…….ics 导入导出"。

## 为什么不能照抄 WebUI 的做法

WebUI 在浏览器里：导出是 `Blob` + `<a download>`、导入是 `<input type=file>`，
两条都由浏览器提供。鸿蒙**没有"下载目录"这个概念**，必须显式走系统
`DocumentViewPicker` —— 这不是多此一举，是这个平台上唯一能让用户拿到／指定文件的路。
新增 `common/IcsFile.ets` 封装选/读/写（`pickIcsText` / `saveIcsText`）。

## ApiClient 加两个方法（不能复用 `request<T>`）

`request<T>` 无条件 `JSON.parse(response.result)`，而 iCalendar 不是 JSON
（与 `getBytes` 取壁纸二进制同一个理由）。所以：
- `getText()`：`expectDataType: STRING` 取原文；
- `postText()`：raw body + **显式** `Content-Type: text/calendar`
  —— 服务端是**按 Content-Type 分流**的（`strings.HasPrefix(ct, "multipart/")`，
  否则当 raw text）。写错成 `application/json` 会走对分支但语义不对。

## 三处对齐 WebUI 的细节

- **区间用屏幕上正在看的那段**（`rangeFrom/rangeTo`），不写死 ±1 年 ——
  服务端注释里写着同一条理由：「写死 ±1 年会让人点导出后得到一堆与屏幕上不符的事件」。
- **文件名带日期**：`agentmail-<selectedIso>.ics`（WebUI 是
  `agentmail-${dayKey(anchor)}.ics`）。固定名的问题是连导两次就分不清哪份是哪份，
  而导出天然会被重复做（看一个月导一份）。实测截图里默认文件名
  `agentmail-2026-09-18.ics`。
- **`imported` 与 `skipped` 两个数都报**：只说"导入成功"会把
  "20 条里跳过了 18 条"读成一切正常，而"跳过"正是用户需要知道的那部分。

## 结果要分三种说（取消不是失败）

导出成功（给出落盘路径）/ 用户取消（**什么都不说**）/ 真失败（说原因）。
把"取消"弹成"导出失败"是"用户什么也没做却被骂一句"。
导入成功后**重拉当前区间** —— 不重拉用户看不到刚导进来的东西，会以为失败。

## 验证

- 服务端两端点实测（curl）：导出 8 个 VEVENT、Content-Type/Disposition 正确；
  把导出的原样导回去 `{"imported":8,"skipped":0,"total":8}`。
- ★ 这次验证**污染了生产库**（那 8 条真写进去了）：已按 event_id 逐条删除
  （47 → 39），删除前备份 `/tmp/db-before-cleanup.db`。
  教训：拿生产实例做写侧验证要先想清楚怎么回滚 —— 我这次是先写后想。
- 设备侧：导出选择器实测打开（系统 filemanager 的 `PathPicker`），
  默认文件名正确、目录可选；选中保存后回到日历。

2026-09-18 12:55:46 +08:00

AppScope

跨端: harmony 管理页（用户管理）+ P4c 壁纸上传入口 —— 「功能做全再交付」的两块

2026-09-15 11:17:23 +08:00

entry

跨端: 鸿蒙日历补 .ics 导入导出（WebUI 有、鸿蒙一直没有）

2026-09-18 12:55:46 +08:00

hvigor

chore: directory migration - gateway→server, web→client/electron

2026-09-08 19:16:35 +08:00

.gitignore

跨端: AGC 客户端配置不入库（gitignore + rm --cached + example）+ 一条判据代替"靠记得"