icloud-calendar-plugin:让 DeepSeek Harness 读写国区 iCloud 日历与联系人
srt180/icloud-calendar-plugin
为 DeepSeek Harness 接入中国区 iCloud 日历与通讯录,通过 CalDAV/CardDAV 让 Agent 直接查询、创建、修改和删除事件并查找联系人。
icloud-calendar-plugin 是一个 DSH plugin,把中国区 Apple ID 的日历与通讯录接入 DeepSeek Harness,让助手能直接查询和修改这些数据。它通过 CalDAV 与 CardDAV 连接国区域名,失败时自动回退全球域名,因此国区与全球区账号都能使用,也不依赖本机日历应用。核心能力包括列出日历、按时间段或关键字查找事件、新建与局部更新事件、取消重复事件中的某一次,以及按中文姓名、拼音首字母或电话检索只读联系人。
如何安装
dsh plugin --profile <your-profile> add github:srt180/icloud-calendar-plugin--profile 换成你本机实际使用的 profile 名(ls ~/.dsh/profiles/ 可查看目录名):浏览器版通常是 web,桌面版通常是 desktop 或 desktop-NNN。
- 分类
- 集成与连接
- 平台
- DSH Plugin
- 作者
- srt180
- 分发方式
- 插件
icloud-calendar-plugin 核心特性
icloud-calendar-plugin 仓库简介
它是做什么的?
它是 DeepSeek Harness(DSH)的 iCloud 日历与通讯录插件,让 Agent 直接读写中国区 Apple ID 的日历和联系人。它解决的是国区 iCloud 数据(存于云上贵州)在 DSH 里无法被 Agent 操作的问题,通过 CalDAV/CardDAV 协议访问 caldav.icloud.com.cn 与 contacts.icloud.com.cn,失败时自动回退全球域名,因此国区与全球区账号都能用。插件不依赖本机 Calendar.app,也不读取本机日历数据库,纯 ESM、无运行时依赖,由 srt180 维护,采用 MIT 协议。
核心功能
- 日历与事件管理:列出日历、颜色、读写权限与默认目标日历,并按时间段、常用范围或关键字查找事件,重复事件按每一次发生展开。
- 事件增删改:新建事件支持标题、起止时间、全天、地点、备注、重复规则、提前提醒与参与者;更新时只改传入字段,其余属性(含原有提醒)保持不变;删除可整条删除,也可只取消重复事件中的某一次。
- 中文联系人检索:按中文姓名、拼音、全拼首字母(如 zw 匹配张伟)、邮箱、公司或电话查找 iCloud 通讯录,通讯录为只读查询。
- 国区时区适配:时间默认按 Asia/Shanghai 解释与展示,输出带 +08:00 偏移,时区可在配置中改为任意 IANA 名称。
- 安全写入与凭据保护:写入携带 ETag,若其他设备已修改则拒绝覆盖并提示重新读取;Apple ID 密码不写入配置文件,凭据保存在 DSH 凭据存储中,每次调用重新读取。
怎么使用这个插件?
在 DSH 中启用后,先配置账号:生成 App 专用密码(不要用 Apple ID 登录密码),再在会话里把 Apple ID 与专用密码交给助手代存,或直接写入 DSH 凭据存储的 icloud-calendar/default 记录。随后对助手说「列一下我的 iCloud 日历」即可验证,返回结果会显示账号下的日历数量、时区与默认写入日历。日常使用直接自然语言下达指令,例如查找某段时间的事件、新建带提醒的会议、修改地点或取消重复事件中的某一次;需要多账号、代理或调整超时,可在插件配置里设置 account、proxy、timeoutMs 等非敏感字段。
报错怎么排查?
- 写入事件时服务器返回 412:说明期间其他设备已修改该事件,插件会拒绝覆盖,按提示重新读取后再改。
- 账号无法连接或认证失败:确认账号已开启双重认证,且使用的是 App 专用密码而非登录密码;被停用或不支持 App 专用密码的账号无法使用。
- 访问 iCloud 超时:Node 的 https 不读取系统代理设置,需要经 HTTP 代理访问时在配置的 proxy 字段填写代理地址。
- 重复事件只返回主事件:BYSETPOS、BYMONTHDAY 等复杂重复规则不做近似展开,属已知限制。
本页是基于该插件官方 README 独立重写的导读——权威文档和最新变更请以源头为准:srt180/icloud-calendar-plugin。插件是安装时就在你机器上运行的第三方代码;收录不代表背书——安装前请自行审阅源码。
DSH Plugin 常见问题
