yandex-calendar

核心用法

本 Skill 提供了一套完整的 Yandex 日历终端管理方案，基于 CalDAV 协议通过 vdirsyncer 实现双向同步，配合 khal 工具进行本地日历操作。核心工作流为：先执行 vdirsyncer sync 拉取云端数据，再通过 khal 命令进行查询或修改，最后再次同步回写。

主要功能覆盖三类场景：

• 事件查询：khal list today 查看当日安排，，khal list today 7d 获取周视图，，khal calendar 输出月历
• 事件创建：khal new "日期 时间" "时长" "标题" 支持自然语言日期（如"завтра 15:00"）和多种时长格式（30m/1h/2h）
• 全文搜索：khal search "关键词" 快速定位历史事件

显著优点

1. 离线优先架构：所有数据本地存储，无网络时仍可完整浏览和编辑日历，恢复连接后自动同步
2. 终端原生体验：适合开发者工作流，无需切换图形界面，支持脚本化批量操作
3. 开放标准兼容：基于 CalDAV 协议，理论上可扩展至其他服务商（Google Calendar、iCloud 等）
4. 零运行时依赖：Skill 本身为纯文档，不捆绑任何二进制或动态代码

潜在缺点与局限性

• 配置门槛较高：需自行安装配置 vdirsyncer（Python 工具链）和 khal，涉及 CalDAV URL、认证令牌等手动设置
• 无图形界面：不支持拖拽创建、颜色标签、附件等高级功能
• 同步冲突处理：多设备同时修改时依赖 vdirsyncer 的冲突解决策略，可能需要手动介入
• 俄语生态局限：Skill 文档为俄语，且针对 Yandex 服务优化，国际化支持有限

适合的目标群体

• 习惯终端工作流的开发者、运维工程师
• 追求数据本地化的隐私敏感用户
• 需要自动化日历操作（如 CI/CD 集成定时任务）的场景
• 已在使用 vdirsyncer/khal 工具链的现有用户

使用风险

• 配置安全风险：vdirsyncer 配置文件明文存储 CalDAV 密码，需确保文件权限（建议 chmod 600）
• 同步延迟风险：本地修改后若未及时同步，多设备场景下可能产生数据不一致
• 工具链维护风险：vdirsyncer 和 khal 为社区维护项目，长期更新支持存在不确定性
• 误操作风险：命令行操作无撤销确认，删除或覆盖事件后恢复依赖备份