前言¶
在 DSH（DeepSeek Harness）里做工作流时，日程往往散落在系统日历、CalDAV 账号和对话上下文之间。智能体要能查空闲、建事件、改重复规则，还要和 iPhone、Mac 上的提醒保持一致，单靠手写工具调用和自算 RRULE 展开，成本高且容易漏确认步骤。下面介绍社区插件 dsh-calendar-pro：面向 DSH 的日历能力，支持本地日历与 CalDAV，并通过智能体工具完成查询、增改删与安全约束下的批量操作。
这是什么¶
dsh-calendar-pro 由维护者 yan-evan 发布，在 SkillHub 等社区目录中归类为工作流；仓库为 yan-evan/dsh-calendar-pro，当前 package 版本为 0.1.0，许可证 MIT。插件依赖 DSH >=0.2.1-rc.3，运行环境要求 Node ^22.19.0 || >=24.0.0。
项目基于上游 STARDUSTLC666/dsh-calendar v0.14.3 演进，在保留 CalDAV、智能体工具、月/周/议程视图与 ICS 导入等能力的基础上，增加了本地日历、数据源迁移、农历与法定节假日调休、经期记录与预测、ICS 导出等能力（详见仓库 README 中的对比表）。
核心功能¶
智能体侧¶
- 自然语言查询：例如询问「下周三有什么安排」；重复日程会展开到具体场次。
- 对话式增改删：支持全天事件与重复规则（RRULE）。
- 空闲时段推荐：说明时长与偏好即可得到候选；默认工作日 09:00–18:00。
- 全字段搜索：按关键词匹配标题、描述与地点。
- 安全约束：删除重复日程系列、批量删除前，智能体需先说明影响范围并等待确认。
同步与多端¶
- CalDAV：支持 iCloud、Google、Nextcloud 及兼容 CalDAV 的服务。
- 双向同步：与系统日历提醒联动（README 描述为同步到 iPhone、iPad、Mac 后由系统日历提醒）。
- 本地日历：可不连接任何服务器，零配置使用完整本地能力。
界面与易用¶
- 悬浮日历：对话页右下角打开，Esc 收起。
- 农历与调休：法定节假日、调休在日期上标注。
- 经期预测：数据仅保存在本机（README 说明）。
- 手动操作：月 / 周 / 议程视图，点击新建、拖动改期、框选调整时段。
- ICS 导入导出：迁移或备份日程。
- 中英双语：跟随 DSH 界面语言切换。
更细的交互与字段说明见仓库 MANUAL.md。
安装与启用¶
插件以 DSH web profile 的客户端形式注入侧栏（package.json 中 dsh.client.platform 为 web）。安装前请自行查看仓库源码与 MIT 许可证；插件在当前 DSH 进程权限下运行，连接 CalDAV 或读写本地数据前请评估账号与路径是否可接受。
从 npm 安装（README 原文）：
dsh plugin --profile web add dsh-calendar-pro
dsh # 重启后侧栏出现「日历」
也可在 DSH 插件菜单 → 安装插件 中输入 dsh-calendar-pro 确认，或在 DSH 插件市场搜索该名称安装。
从本机源码路径安装（README 原文）：
dsh plugin --profile web add file:<本项目的绝对路径>
dsh
卸载：
dsh plugin --profile web remove dsh-calendar-pro
社区目录页：https://www.skillhub.cn/plugins/yan-evan/dsh-calendar-pro。目录站点与 DeepSeek / 幻方无官方从属关系，安装来源以你实际使用的市场或 npm 包为准。
典型用法¶
安装并重启 DSH 后，可在对话中用自然语言操作日程。README 给出的示例如下：
你：下周哪天适合安排一次两小时的复盘会？
DSH：下周二 14:00–16:00 和周四 10:00–12:00 都空闲，要帮你把周二那场建上吗？
你：建在周二下午两点，标题「Q4 复盘」。
DSH：已创建。
需要 CalDAV 时，在插件提供的设置流程中配置对应服务（具体字段与步骤以 MANUAL.md 为准）。若仅使用本地日历，可不配置远程账号。
适用场景与注意¶
适合希望在 DSH 同一界面里完成「查空闲 → 建会 → 与手机日历一致」的开发者或日常用户。依赖 CalDAV 时需准备可用的服务端账号与网络；经期等敏感数据 README 声明仅存本机，但仍建议在本机磁盘与备份策略上自行把控。
问题与需求可通过 GitHub Issues 反馈；版本变更见 CHANGELOG.md。
结尾¶
dsh-calendar-pro 把日历视图、本地/远程数据源和智能体工具收拢到 DSH 插件内，用对话完成查询与安全确认下的删改，用 CalDAV 或 ICS 与既有习惯衔接。进一步了解可访问目录页 SkillHub 与源码仓库 GitHub。
