同步日历 使用帮助

本页介绍「同步日历」的完整使用方式：从添加第一个 CalDAV 账号，到视图与显示方式、新建日程、同步、提醒、系统日历、桌面卡片与常见问题排查。如果你是第一次使用，建议按顺序读「快速开始」与前三节。

快速开始（三步）

1. 准备一个 CalDAV 服务器地址
   你需要有一个支持 CalDAV 的服务，例如自建的群晖 Calendar、Nextcloud、Radicale，或第三方 CalDAV 服务。请提前取得它的访问地址、用户名与密码（或应用专用密码）。
2. 在「账号」页添加账号
   填写服务器地址、用户名与密码，保存后应用会自动探测该服务器下的日历本。账号信息在本地加密保存，不会上传给开发者。
3. 回到首页等待首次同步
   首次同步会把服务器上的日程拉取到本地。之后本地修改会自动推送、服务器变更会自动拉取。

一、账号管理

1.1 添加账号

在「账号」页点「＋」或「添加账号」，依次填写：

• 服务器地址：完整的 https 地址，建议使用 HTTPS 以保证传输加密。
• 用户名 / 密码：部分服务需要「应用专用密码」而非登录密码，请以服务方说明为准。

保存后应用会尝试连接并列出该账号下可见的日历本。若失败，会给出错误提示，可据此检查地址、端口或凭据。

服务器地址该填什么？（重要）

只需填服务器域名即可，应用会自动探测正确的 CalDAV 端点：

• 会按标准 .well-known/caldav 自动发现；
• 并在常见路径中智能尝试（Nextcloud / ownCloud / Radicale / Baïkal 等）。

当然，也可以直接填写完整的日历家目录（最稳），例如：

• Nextcloud / ownCloud：https://你的域名/remote.php/dav/calendars/你的用户名/
  在 Nextcloud 网页版「日历 → 左下角设置 → 目标日历 → 复制私有链接」可直接拿到这个地址。
• Radicale：https://你的域名/你的用户名/
• Baïkal：https://你的域名/dav.php/calendars/你的用户名/

1.2 管理日历本

账号添加成功后，你可以在账号详情中看到该账号下的所有日历本，并对每个日历本单独设置：

• 显示 / 隐藏：控制某个日历本是否在首页展示。
• 只读：标记后其中日程只能查看，不能再新建或修改（详见第五节）。
• 静音：标记后其中所有日程不再弹出提醒（详见第五节）。

1.3 删除账号

在账号页可删除已添加的账号（长按账号 → 删除）。删除后，本应用将不再持有该账号的任何凭据，本地相关设置也会一并清理，并会同步清除该账号镜像到系统日历的全部日历本。请注意：删除账号不会删除服务器上的日程数据，仅解除本机的绑定关系。

二、界面与视图

首页顶部有「月 / 周 / 列表」三个切换标签，可直接点选切换；也可以在「设置 → 默认视图」中指定打开应用时默认进入哪一种。月视图与周视图的下半部分展示的都是「选中那一天」的日程。熟悉之后也可以改用手势翻页，详见后面「九、手势操作」。

三个视图里「一天」的呈现方式，由设置中的「日程显示方式」决定——时间轴或列表，默认是时间轴。详见下一节 2.2。

2.1 怎么读时间轴（默认方式）

• 色块颜色 = 日程所属日历本的默认色。同一个日历本的事件颜色一致，便于区分来源。
• 色块高度 = 日程时长。块越高表示这件事占用的时间越长。
• 左右并排 = 时间重叠。当两件或多件事时间冲突时，应用会把它们并排摆放并自动等分宽度，而不是互相遮盖，冲突一目了然。
• 时间轴上方 = 全天 / 跨天日程。这类日程不属于某个具体时刻，单独画在时间轴顶部。
• 红色横线 = 当前时间。仅「今天」显示，随实际时间自动下移。
• 刻度范围 = 固定显示 8:00 ~ 18:00 这一段；只有当某天在 8 点之前有日程时，才会把 8 点以前的刻度一并显示出来，在 18 点之后有日程时才显示 18 点以后的刻度。这样即使一天只有一两条日程，也不会只剩很窄的一小段刻度，读起来更自然。

2.2 切换日程显示方式（时间轴 / 列表）

进入「设置 → 日程显示方式」，在「时间轴」与「列表」之间二选一即可，立即生效且会记住，下次打开应用仍是你的选择。

• 作用范围：月视图与周视图下方的那一天、列表视图里的每一天，以及 4×4 / 6×4 桌面卡片，都会跟着一起切换。
• 不影响数据：切换只改变「怎么画」，不会新增、修改或删除任何日程；点按查看详情、新建、编辑、手势切换等操作在两种方式下完全一致。
• 全天 / 跨天日程：两种方式都会展示，只是画法不同（时间轴方式单独画在最上方，列表方式作为独立条目列出）。
• 找不到红线了？先看这里的设置是不是被切成了「列表」——该方式下本来就不画当前时间红线。

三、新建、编辑与删除日程

3.1 新建日程

点界面上的「＋」进入新建页，可填写：

• 标题、所属日历本
• 开始 / 结束时间（也可设为全天）
• 重复规则：不重复 / 每天 / 工作日 / 每周 / 每月 / 每年；选好频率后可继续设置结束条件——永不结束、重复到某天（选定截止日期，含当天）或共重复几次。编辑已有的重复日程时，这两项会按服务器上的规则自动回显，可随时修改。
• 提醒：可多选多个提前量，例如「提前 15 分钟」和「提前 1 天」同时生效
• 地点：只需输入几个字即可从候选列表中点选，自动填入完整地址（见 3.2 地点搜索补全）；手动输入同样可以正常保存。填写后可在详情中一键发起导航
• 备注：补充说明

3.2 地点搜索补全

在新建或编辑页的「地点」栏输入两三个字，输入框上方就会浮出匹配的地点列表（列表浮在页面上方，不会把输入框顶来顶去），每一行显示地点名称与完整地址。点一下即填入完整地址，列表随即关闭，光标停留在原地可继续修改。

• 地图选点：地点栏右侧的「地图」按钮可打开系统地图界面，直接搜索、拖动图钉选点，确认后回填地址——适合只记得地方、说不出门牌号的情况。
• 完全不申请定位权限：搜索补全只用你敲进去的关键词调用华为地图服务；「一键导航」的坐标也由系统地理编码按地址换算。应用全程不申请、也不使用定位权限，不会读取你的实时位置。
• 完全可选：不联网、不想用、或搜不到结果时，照旧手动输入即可，保存不受任何影响。

3.3 查看详情

在任意视图中点击任意日程都会弹出详情，其中包含完整标题、起止时间、地点与备注。若该日程填写了地址，详情中会显示「导航 ›」按钮。

3.4 编辑与删除

对可写的日程，详情弹层底部会出现「编辑日程」按钮，进入编辑页即可修改或删除。只读日历本中的日程、以及系统来源的日程不显示编辑入口，只能查看——这是为了避免误改他人共享给你或系统托管的内容。

重复日程：先选"改哪几次"

若修改或删除的是重复日程，保存或删除前会先弹出范围选择，让你明确作用到哪几次发生：

• 仅这一次：只影响所选日期的这一次，其余保持不变（标准 iCalendar 的 EXDATE + RECURRENCE-ID 写法）。
• 此次及以后：从这一次开始到最后一次都一并修改或删除（把原系列截断，剩余部分成为新系列）。
• 全部：整条重复日程的所有发生都修改或删除。

这三项与主流日历客户端一致，改动会以标准 iCalendar 形式同步到你的 CalDAV 服务器，其它设备（含系统日历镜像）看到的也是一致的。

3.5 一键导航

在日程详情中点击「导航 ›」，应用会先用系统地理编码服务把地点地址解析为坐标，再唤起高德地图并带上目的地；若设备未安装高德地图，则回退到网页版地图的搜索结果页。整个过程不申请定位权限、不读取你的实时位置，地址仅在本地瞬时处理，不记录、不上传。

四、同步

4.1 自动同步

应用处于打开状态时，会按设定的间隔自动同步。你可以在设置中调整同步间隔。

4.2 后台自动同步

开启「后台自动同步」后，即使退到后台，也会由系统定时唤起同步（受系统省电策略限制，最短约 2 小时一次；应用使用越频繁、间隔越接近这个下限）。

此外，以下两种情况会立即补同步一次，保证你打开日历时数据总是最新的：

• 回到前台：重新切回应用时立刻同步；
• 网络恢复：从断网（飞行模式、地铁、弱网）恢复到有网时立刻同步。

说明：HarmonyOS 出于省电考虑，不允许普通应用在后台"常驻"并高频轮询。本应用遵循系统机制，采用「前台按间隔同步 ＋ 后台定时唤起 ＋ 回前台/网络恢复即时补同步」的组合，在可用范围内尽量让数据保持最新。

4.3 手动同步

点首页右上角的「≡」按钮，在打开的菜单里选择「手动同步」，即可立即触发一次同步。同步进行中该项会显示「同步中…」，此时该项不可再次点击，等它恢复为「手动同步」就说明本轮已结束。

4.4 重建日程数据

若发现提醒丢失、日程显示异常等情况，可在设置中执行「重建日程数据」。该操作会让下一次同步重新拉取完整数据，把本地状态与服务器对齐，常用于排查显示类异常。

五、只读与静音

六、提醒与通知权限

• 日程会在开始前，按你设置的提前量弹出系统通知。
• 同一条日程可设置多个提醒时间点（例如提前 1 天 + 提前 15 分钟）。
• 提醒走系统本地通知，不依赖厂商云推送，无需注册任何推送账号。
• 若系统代理提醒配额不可用，应用会自动降级为应用内通知（此时需要应用在前台，或已开启后台自动同步）。

七、系统日历

7.1 混合显示系统日历

该开关默认关闭。到「设置 → 混合显示系统日历」打开时，系统会弹出「读取全部日程」授权框；同意后，手机自带日历中的日程就会与本应用的 CalDAV 日程一起显示在同一套时间轴里，方便统一查看。系统来源的日程仅可查看，不能在本应用内编辑。

7.2 镜像到系统日历（可选）

本应用是 CalDAV 客户端，日程默认不进系统日历，因此小艺、桌面日历卡片、手表等系统入口可能看不到你的日程。开启该功能后，本应用会把你在设置里勾选的日历本写入系统日历中本应用创建的独立账户，让这些系统入口也能看到。要点：

• 默认关闭。在「设置 → 镜像到系统日历」打开时，系统才会弹出「写入日历」授权框。
• 打开开关后，勾选要镜像的日历本，点「立即执行镜像」即可（之后每次同步会自动更新）。
• 每个日历本在系统日历中保持各自的颜色；重复日程会自动展开，重复系列中「单次改期」的日程也能正确呈现。
• 只写自己的账户：本应用不会读取、修改或删除系统日历中其它账户的任何内容。
• 关闭开关会自动清除已镜像出去的全部日历本；也可以在单个日历本上取消勾选，只清除那一本。

7.3 系统日历改动回读

开启镜像后，若你希望把在系统日历里做的改动（新建、修改、删除）也回读并写回你的 CalDAV 服务器，可在设置中打开「回写系统日历改动」（默认关闭）。关闭时系统日历内容只读、改动不回传，避免误改服务器数据。

7.4 备份到 CalDAV

开启「备份到 CalDAV」并选择一个目标日历本后，可以把系统本地的日程导入该 CalDAV 日历本，实现「把手机上的日程也纳入自己的服务器」——换机或设备丢失时也有备份可依。选择该模式时同样会先申请「读取全部日程」权限。

八、桌面服务卡片

把服务卡片添加到桌面后，不打开应用也能看到今天的安排。应用提供四种尺寸（长按桌面空白处 → 服务卡片 → 选择「同步日历」）：

卡片会自动刷新（并可在应用同步完成后立即刷新）。点击卡片任意区域可打开应用；点击「＋」则直接进入新建日程页。

4×4 与 6×4 卡片跟随「日程显示方式」：选「时间轴」，卡片里就是按小时铺开的迷你时间轴（带当前时间红线）；选「列表」，卡片改为逐条罗列，一屏能多看几条。另外，点击卡片打开的是卡片当前显示的那一天——先用「‹ ›」把卡片翻到某天再点进去，看到的就是那一天，不会每次都跳回今天。

九、手势操作

除了点按，常用操作都可以用手势完成，效率更高。下表的方向均按手指滑动的方向描述。切换视图时会播放方向一致的转场动画，能直观看出是「进入」还是「返回」。

• 列表视图没有手势切换：从列表视图要换视图，请点顶部的「月 / 周 / 列表」标签。
• 左右滑按天切换只在周视图生效：月视图下方的日程区只响应上下滚动；要换日期，先在月历里点选某一天。
• 上下滑进出视图是一对：月历上滑进入周视图，周视图下滑返回月视图。
• 平板 / 横屏：布局会变成左右分栏（月历或日期条在左、日程在右），手势与上表完全一致。
• 列表显示方式下：手势照常有效——周视图里左右滑按天切换依旧可用，日程区上下滚动变成普通列表滚动。
• 各处时间轴本身都能上下滚动，方便看清从早到晚的安排；左右滑的行为见上表（周视图下切日期，月视图下无反应）。

十、常见问题

十一、故障排查

• 日程不更新：点首页右上角「≡」→「手动同步」试一次；若仍不行，用「重建日程数据」重新拉取完整数据。
• 提醒不弹：检查「设置 → 通知权限」是否已开启；确认该日历本没有被「静音」；确认日程本身设置了提醒。
• 时间轴出现异常色块：多为数据未拉全，执行「重建日程数据」后在下次同步时修正。
• 红色当前时间线不见了 / 日程变成逐行排列：检查「设置 → 日程显示方式」是否为「列表」——该方式下本来就不绘制当前时间红线，切回「时间轴」即可恢复。
• 导航打不开地图：确认设备已安装高德地图或允许打开网页；若目的地为空，多为该地址无法解析为坐标，可把地点写得更完整（含城市与街道）后重试。
• 桌面卡片不刷新：打开一次应用触发同步；卡片会在同步完成后自动刷新。

十二、联系我们

反馈问题时，如果方便，请附上：应用版本号、设备型号与系统版本、以及问题出现的具体现象与步骤，这样能更快定位。