STARDUSTLC666/dsh-calendar
31最近提交 2026年8月15日
dsh-calendar DSH 插件
dsh-calendar 是 DSH 社区插件，让智能体能够通过 CalDAV 管理日历事件。提供五个工具（列出、创建、更新、删除、搜索），支持 Google 日历、iCloud、Nextcloud 以及任意 CalDAV 服务器。所有配置通过 cordis.patch.yml 完成，无设置页 UI。
如何安装 dsh-calendar DSH 插件
dsh plugin --profile web add dsh-calendar复制不会执行命令。安装 dsh-calendar DSH 插件前请核对仓库和版本。
dsh-calendar DSH 插件数据来源
dsh-calendar DSH 插件快照日期：2026年8月16日
discovered
dsh-calendar DSH 插件能做什么
- 指定时间段列出事件，重复事件自动展开（默认最多 30 次，可限制 1-200）。
- 新建日历事件，支持标题、起止时间、描述、地点、全天标记和重复规则。
- 按 uid 更新事件，未提供的字段保持不变。
- 按 uid 删除事件。
- 按关键词搜索事件（匹配标题、描述、地点、UID，不区分大小写，默认限制 50 条，可调 1-200）。
dsh-calendar DSH 插件适合哪些场景
- 让智能体帮你安排会议，自动创建日历事件。
- 询问智能体未来一周的所有日程安排。
- 让智能体修改已有事件的地点或时间。
- 搜索包含特定关键词的日历事件。
- 自动清理过期或重复的日历条目。
dsh-calendar DSH 插件适合谁
- 希望智能体具备日历管理能力的 DSH 用户。
- 需要日历集成的智能体工作流开发者。
- 使用 Google Workspace 或 iCloud 并开放 CalDAV 访问的企业用户。
dsh-calendar DSH 插件的限制
- Google 和 iCloud 的 CalDAV 端点在中国大陆不可直连，需配置 proxyUrl 走代理。
- 不支持修改或删除重复事件的单次发生（不支持 RECURRENCE-ID 实例级操作）。
- 仅支持 Basic 认证（应用专用密码），不支持 OAuth 流程。
- 时区处理有限：带 TZID 的事件会转为 UTC，夏令时等复杂规则未精细处理。
- iCloud 需要手动填写完整日历集合 URL，不支持自动发现日历。
dsh-calendar DSH 插件的仓库 README 摘录
以下文字摘自 dsh-calendar DSH 插件的上游仓库 STARDUSTLC666/dsh-calendar 的 README，版权归原作者，仅作引用。
> **agent 从此会排期**：CalDAV 读写日历，重复日程自动展开。     [](https://awesome-dsh-plugin.com) DSH 社区插件：通过 CalDAV 读写日历事件。提供 5 个面向模型的工具（calendar_list / calendar_create / calendar_update / calendar_delete / calendar_search），支持 Google / iCloud / Nextcloud 及任意 CalDAV 服务器。本轮为 node 半身，不含设置页 UI，配置全部走 profile 的 cordis.patch.yml。 ## 安装 ```bash dsh plugin --profile web add dsh-calendar ``` 安装后重启 dsh。插件会向 profile 插入一行 id 为 `calendar` 的配置行（见本包的 cordis.patch.yml）。默认 provider 为 custom 且未填任何凭证，此时插件照常加载，但工具在调用时会抛出中文指引错误，提示你补全配置。 ## 配置 所有配置都在你的 profile 的 cordis.patch.yml 里，按 id 覆盖 `calendar` 行（覆盖整行的 config）。通用字段： - `provider`：google | icloud | nextcloud | custom - `caldavUrl`：完整日历集合 URL（custom / icloud 必填；google / nextcloud 也可手填覆盖预设） - `username`：CalDAV 账号（Google / iCloud 为账号邮箱） - `password`：密码；Google / iCloud 请用应用专用密码。推荐用环境变量 `DSH_CALENDAR_PASSWORD`，避免明文入库。 - `proxyUrl`：
阅读完整 README仓库未声明许可，使用前请先与作者确认。
dsh-calendar DSH 插件常见问题
如何配置 Google 日历与 dsh-calendar？
将 provider 设为 'google'，username 和 calendarId 填写你的 Gmail 邮箱。在 Google 账户安全设置中生成应用专用密码（不是登录密码）填入 password 字段。如果你在中国大陆，还需设置 proxyUrl 为本地代理客户端端口，例如 http://127.0.0.1:7890。
dsh-calendar 支持 Outlook 或 Exchange 吗？
插件支持任何 CalDAV 服务器，如果你的 Outlook/Exchange 提供了 CalDAV 端点，可以使用 'custom' 提供者并填写完整的 caldavUrl。但很多 Office 365 租户并未开放 CalDAV，你可能需要启用该功能或使用第三方桥接服务。
调用工具时出现 401 错误怎么办？
最常见的原因是使用了普通登录密码而非应用专用密码。Google 和 iCloud 都要求使用应用专用密码进行 CalDAV 访问。请从账户安全设置中生成一个应用专用密码，然后重新配置。同时检查用户名和密码是否拼写正确。
proxyUrl 字段是做什么用的？
proxyUrl 用于将 CalDAV 请求通过本地代理客户端转发，这是因为在中国大陆无法直接访问 Google 和 iCloud 的 CalDAV 端点。填写你的代理客户端的 HTTP(S) 代理地址即可，例如 http://127.0.0.1:7890。如果你的 CalDAV 服务器可以直接连接，则无需填写。
dsh-calendar 能否修改重复事件中的单次发生？
插件可以按 uid 更新或删除整个重复系列，但不支持修改或删除重复事件中的单次发生（不支持 RECURRENCE-ID 实例级操作）。calendar_list 工具可以将重复事件展开为单次发生供查看，但修改操作会作用于整个系列。