ChatGPTClaudeGrok / X / CursorGemini

icloud-calendar-plugin:让 DeepSeek Harness 读写国区 iCloud 日历与联系人

srt180/icloud-calendar-plugin

集成与连接已验证
收录时间 2026-11-20
页面最后更新 2026-11-20

为 DeepSeek Harness 接入中国区 iCloud 日历与通讯录,通过 CalDAV/CardDAV 让 Agent 直接查询、创建、修改和删除事件并查找联系人。

icloud-calendar-plugin 是一个 DSH plugin,把中国区 Apple ID 的日历与通讯录接入 DeepSeek Harness,让助手能直接查询和修改这些数据。它通过 CalDAV 与 CardDAV 连接国区域名,失败时自动回退全球域名,因此国区与全球区账号都能使用,也不依赖本机日历应用。核心能力包括列出日历、按时间段或关键字查找事件、新建与局部更新事件、取消重复事件中的某一次,以及按中文姓名、拼音首字母或电话检索只读联系人。

如何安装

install
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 核心特性

列出日历与读写权限按时间与关键字查找事件新建、修改、删除事件重复事件按次展开与取消按中文名或拼音查联系人
Listed on dsh-plugin.org

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。插件是安装时就在你机器上运行的第三方代码;收录不代表背书——安装前请自行审阅源码。

安装、更新、卸载这个插件,都在 DeepSeek Harness 的 DSH Plugin Hub 插件市场完成
ChatGPTClaudeGrok / X / CursorGemini

DSH Plugin 常见问题