WeCal Sync - Apple日历助手

Apple iCloud 日历的 Chrome 伴侣——同步、提醒、智能创建。

概述

WeCal Sync 是一款基于 Chrome 扩展（Manifest V3）的 Apple iCloud 日历同步助手。它通过 CalDAV 协议直接连接 iCloud 日历，在浏览器侧边栏中实时显示您的日程安排，并在事件临近时通过强力弹窗和警报音提醒您。

无需打开手机或 macOS 日历应用——一切都在浏览器里完成。

---

核心功能

📅 实时日程视图

• 浏览器侧边栏自动显示 今日 和 明日 日程列表
• 事件卡片展示：时间、标题、地点、来源
• 已过期日程自动变灰显示
• 悬浮查看日程完整详情
• 底部状态栏显示最后同步时间

🔔 强力弹窗提醒

• 事件前 30 分钟、15 分钟、5 分钟、0 分钟 自动弹窗
• 苹果风格精美弹窗界面，带动态铃铛动画
• 显示事件标题、开始时间、预估时长、地点
• 倒计时提示（"X 分钟后开始"）
• 180 秒自动关闭，也可手动点击"我知道了"

🔊 响铃告警

• 使用 Chrome Offscreen API 播放强力警报音
• 即使在安静标签页或后台，告警音也能正常响起
• 避免错过重要日程

🧠 智能日程创建

• 粘贴文本 → 自然语言识别：粘贴任意文本（如"明天下午3点在星巴克开会"），使用 Deepseek API 自动解析为完整日程
• 表单创建：手动输入日程名称、开始/结束时间、地点
• 右键快速创建：在任意网页选中文字 → 右键 → "添加日程到 WeCal" → 自动跳转到创建页面并预填内容
• 创建成功确认页：显示日程摘要 + 云端同步状态

☁️ iCloud 双向同步

• 支持 中国区 iCloud (iCloud.com.cn) 和 国际区 iCloud (iCloud.com)
• 使用 Apple 官方 App 专用密码安全连接
• 每分钟自动同步，实时获取日历变更
• 手动"立即同步"按钮
• 一键查询并选择要同步的日历

⚙️ 配置管理

• 云服务入口选择（中国/全球）
• Apple ID + App 专用密码输入
• 内置帮助悬浮窗指引 App 专用密码生成步骤
• 日历列表查询与选择
• 配置信息保存在浏览器本地存储

---

安装方法

从 Chrome 应用商店安装（推荐）

1. 打开 Chrome 浏览器
2. 访问 Chrome 应用商店中 WeCal Sync 的页面
3. 点击 "添加至 Chrome"
4. 在弹出的权限确认窗口中点击 "添加扩展程序"

开发者模式手动安装

1. 下载本项目的 ZIP 包并解压
2. 打开 Chrome 浏览器，访问 chrome://extensions/
3. 开启右上角的 "开发者模式"
4. 点击 "加载已解压的扩展程序"
5. 选择解压后的文件夹 wecal-sync-1.5.2

---

快速上手指南

第一步：配置 iCloud 账号

1. 安装后，点击浏览器工具栏中的 WeCal Sync 图标 → 打开侧边栏
2. 点击底部导航栏的 「设置」 按钮
3. 选择云服务入口：
   • 中国用户选择 中国 (iCloud.com.cn)
   • 海外用户选择 全球 (iCloud.com)
4. 输入您的 Apple ID（邮箱地址）
5. 输入 App 专用密码（不是普通密码）
   • 访问 appleid.apple.com → 登录和安全 → App 专用密码 → 生成新密码
   • 复制格式为 xxxx-xxxx-xxxx-xxxx 的密码
6. 点击 「验证账号」 按钮
7. 验证通过后，在日历下拉框中选择要同步的日历
8. 点击 「保存配置」

第二步：查看今日日程

配置成功后自动跳转到今日视图，您将看到：

• 今日日期标题
• 今天日程 列表（可折叠/展开）
• 明日计划 列表（可折叠/展开）
• 每条日程显示时间、标题、地点
• 底部显示同步状态

提示：将鼠标悬停在地图标记图标上，可查看日程的完整详细信息。

第三步：创建新日程

方式一：智能粘贴

1. 在今日视图点击 「+ 新建日程」
2. 在粘贴文本框中输入自然语言描述，例如：
   • 明天下午3点在星巴克和客户开会
   • 每周五上午10点团队站会
   • 下周一9:00-11:00 产品评审会 腾讯会议
3. 输入你的 Deepseek API Key
4. 点击 「智能识别」 按钮
5. 系统自动解析时间、地点、标题并填入表单
6. 确认无误后点击 「添加」

方式二：手动填写

1. 在创建页面直接填写日程名称、开始/结束时间、地点
2. 点击 「添加」 即可

方式三：右键快速创建

1. 在任意网页选中相关文字
2. 右键 → 「添加日程到 WeCal」
3. 侧边栏自动打开并跳转到创建页面，选中文字已自动填入
4. 补充信息后点击 「添加」

第四步：接收提醒

• 日程到达前 30 分钟、15 分钟、5 分钟、0 分钟 时，Chrome 会自动弹出提醒窗口
• 弹窗显示事件标题、开始时间、时长、地点
• 伴随强力告警音
• 点击 「我知道了」 关闭弹窗，或等待 180 秒自动关闭

---

隐私说明

• WeCal Sync 不会收集或上传您的任何个人数据
• 您的 Apple ID 和 App 专用密码仅存储在浏览器本地（chrome.storage.local）
• Deepseek API Key 仅用于智能日程识别，不会被记录或传输给第三方
• 与 iCloud 的通信使用 HTTPS/CalDAV 加密协议直接进行

---

技术支持

如有问题或建议，请在 Chrome 应用商店页面留言，或通过项目主页提交 Issue。

---

版本历史

版本	日期	更新内容
1.5.4	2026-06-05	图标、打包脚本、隐私政策，准备上架
1.5.2	2025-12-28	右键菜单模块重构，AI 独立处理层优化，修复 CSP 问题
1.5.0	2025-12	架构重构，采用 Feature-Sliced 设计，增强智能识别功能
1.0.0	-	初始版本，基础 iCloud 日历同步与提醒功能