dsh-calendar
CalDAV 日历插件：查/建/改/删/搜日程与健康自检，Google/iCloud/Nextcloud/自定义端点，RRULE 重复事件展开；设置页内置月/周/议程面板，连接可在面板内填写并先测后存，周视图支持拖拽改期（15 分钟吸附、5 秒撤销）。面板内置 4 步首次使用引导，看一次后不再出现。
安装
dsh plugin --profile web add dsh-calendar
沙箱测试结果
| 阶段 | 结果 |
|---|---|
| 1 安装 | ✓ |
| 2 列装 | ✓ |
| 3 挂载 | ✓ |
| 4 启动 | — |
四阶段在隔离沙箱里跑：安装（有网）→ 列装 → 挂载 → 启动（后三步断网）。
README
简体中文 · [English](README.en.md)
Calendar
看清日程，找到当前日历里合适的空闲时间。
  
[安装使用](#安装) · [使用流程](#开始使用) · 完整说明
<picture>
<source media="(prefers-color-scheme: dark) and (max-width: 640px)" srcset="https://raw.githubusercontent.com/STARDUSTLC666/dsh-calendar/main/docs/assets/intro/workflow-zh-mobile-dark.svg">
<source media="(max-width: 640px)" srcset="https://raw.githubusercontent.com/STARDUSTLC666/dsh-calendar/main/docs/assets/intro/workflow-zh-mobile-light.svg">
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/STARDUSTLC666/dsh-calendar/main/docs/assets/intro/workflow-zh-dark.svg">
<img src="https://raw.githubusercontent.com/STARDUSTLC666/dsh-calendar/main/docs/assets/intro/workflow-zh-light.svg" alt="看清日程，找到当前日历里合适的空闲时间。 · 流程示意" width="100%">
</picture>
功能
- 用月、周或议程视图安排日程。
- 按时长、工作日与缓冲查找空闲候选。
- 先核对新建草稿或 ICS 导入预览，再确认写入。
<details>
<summary>查看实际示例</summary>
图片来自验证环境的真实界面或示例 PPTX 渲染，使用示例数据。
</details>
安装
在 DSH 桌面版「插件」面板安装 dsh-calendar。已配置命令行时也可使用：
dsh plugin --profile desktop add dsh-calendar
网页版把 desktop 改为 web；安装后重启对应的 DSH。宿主要求以包声明 >=0.2.1-rc.3 为准。
开始使用
1. 打开左侧栏“日历”，在连接设置中选择服务商并填写自己的账号与授权信息。
2. 测试连接并选择目标日历，核对时区后读取月、周或议程视图。
3. 新建或调整日程时，先核对日期、时间和目标日历，再确认保存。
4. 导入 ICS 时先预览并选择条目，再确认导入；检查跳过项和失败项后按需重试。
可以这样说：
读取当前日历本周的日程，先整理需要我确认的时间冲突。
开始前要知道
需要自己的 CalDAV 账号。空闲查询只覆盖当前连接的日历。
配置、完整工具与排错见详细使用说明。
插件更新
在工作台或原生插件详情页底部检查更新。默认自动检查，默认不自动安装；是否安装、何时重启由你决定。Suite 管理的组件随整包更新。查看更新规则。
文档
反馈与贡献
如果插件帮到了你，欢迎 Star，让更多人发现它。问题和建议请提交 Issues，也欢迎代码与文档 PR。反馈时附上版本与复现步骤，并移除凭据。
License
<a id="依赖与配置"></a>
以上内容来自 npm 上的 README，我们只做格式化，不改内容。
版本
npm 上共发布：47，最后更新 2026-11-04