# 导出ICS日程 · Export ICS Schedule

Export Obsidian `- [ ]` tasks to `.ics` calendar files and open them with your system calendar app (Google Calendar, Outlook, and other calendars that can import `.ics`) — on **both desktop and mobile**.

把 Obsidian 的 `- [ ]` 任务生成 `.ics` 日历文件，并用系统日历 App 打开导入（桌面端 / 移动端都支持）。

## Features · 功能

- Turn tasks with a date/time into **timed** or **all-day** calendar events.
- Supports `📅` due date, `⏰` time, `(@YYYY-MM-DD HH:MM)` reminder syntax, and Dataview `[date::]`.
- **Configurable timezone** — auto-detect the system timezone, or pick one of 24 fixed timezones (each labelled with common cities).
- **DST-aware** `VTIMEZONE` generation (full `STANDARD` + `DAYLIGHT` rules), so even importers without a timezone database (e.g. desktop Outlook) parse times correctly.
- **Stable UID deduplication** — re-exporting the same task updates the event instead of creating a duplicate.
- **Reminders** (`VALARM`) for every event.
- Date defanging to avoid calendar "smart schedule" auto-creating duplicate events.

## Comparison with similar plugins · 与同类插件的差异

This plugin is built for one job: turn **the current note's tasks** into calendar events with a single tap and let the **system calendar app** do the rest. No token, no Gist, no whole-vault scan.

本插件只做一件事 —— 把**当前这一页**的任务一键扔进**系统日历**，其余交给日历 App 自己处理：无需 Token、无需 Gist、无需全库扫描。

Other plugins in this space fall into three rough approaches, each with different trade-offs:

社区同类插件大致走三条路线，各有取舍：

| 维度 Dimension | 本插件 This plugin | 单字段导出版 Single-field exporters | 全库订阅型 Whole-vault sync |
|---|---|---|---|
| 触发方式 Trigger | 当前页 / 单任务，按需 | 单条笔记的某个 `frontmatter` 字段 | 全库周期扫描 |
| 输出形式 Output | **直接拉起系统日历 App**（Android 一步 / 桌面走系统默认程序）| 写入 vault 子文件夹 `.ics/`（需手动导入）| 上传 GitHub Gist，生成订阅 URL |
| **移动端 Mobile UX** | ✓ **Android 一键拉起系统日历**（原生桥，事件已预填）<br>△ iOS 待补（当前用 `openWithDefaultApp`，iOS Obsidian 不暴露此 API）| △ 走系统分享面板（Android 浏览器原生 / iOS 走 data URL 跳转）| ✕ 需先建 Gist、拷 Token、在日历 App 里手动订阅 URL |
| 弹窗打扰 Interrupts | **0 个**（全程后台，无模态）| 1 个（缺日期时弹选择器）| 多个（帮助 / 报告 / 配置向导）|
| 时区 Timezone | ✓ 24 整点时区 + 自动检测 | 仅本地时区 | 仅本地时区 |
| 夏令时 DST | ✓ 内嵌完整 STANDARD + DAYLIGHT | ✗ | ✗（部分需 X-LIC-LOCATION 字符串） |
| 多日期字段 Date fields | `📅` / `⏰` / `(@…)` / `[date::]` / 自定义前缀 | 仅一个固定字段 | `📅` 任务 + Tasks emoji / Dataview |
| 提醒 Reminder | ✓ VALARM 可配触发时间（**免费**）| ✗ | 基础（部分锁付费）|
| 重复事件 RRULE | ✗ v0.x 排期中 | ✗ | ✓（部分锁付费）|
| 稳定 UID 去重 Dedup | ✓ 路径 + 标题 FNV-1a 哈希（改标题 UID 会变）| △ 视实现而定 | ✓ 三级（行内 `^blockId` 锚点 + occurrence + 64-bit 双 FNV）|
| 日期脱敏 Defang | ✓ 防「智能识别」重复建事件 | ✗ | ✗ |
| 付费层 / 任务上限 Pricing | **免费，无任务上限** | 免费 | 部分有 Pro 付费版（典型 25 任务上限解锁更多功能）|
| 声明式设置 API Settings API | ✓ 1.13+ 声明式 + 旧版 fallback | ✓ 1.13+ 声明式 | ✗ 旧 `display()` |
| 代码体积 Code size | **23.6 KB**（1 个 main.ts，esbuild cjs）| ~12 KB（minify）| ~185 KB（25 个 src 模块分层）|
| 云服务 / 依赖 Cloud / deps | 无，纯离线 | 无 | Gist / Buymeacoffee 之类 |

**怎么选 · When to choose**
- **移动端随手记几条任务就想立刻进系统日历** → 本插件（一键直达、零打扰、零配置、Android 最佳）。
- 笔记里每个事件都有专门的 `deadline` 字段、要批量归档单条 → 单字段导出版。
- 需要**全库持续同步、用订阅 URL 在多个设备间共享同一份日历**，或要 RRULE 重复、提醒、已完成等 Pro 级功能 → 全库订阅型。
- 同时也想在 iOS 上用 → 选单字段导出（它的 iOS 兼容已实现）；本插件 iOS 支持排期见 [Issues](https://github.com/lindongyan1992/export-ics-schedule/issues)。

## Usage · 用法

1. Open a note that contains tasks with a date or time.
2. Click the ribbon icon **「本页任务 → ICS日程」**, or use the command palette (search "ICS日程"), or right-click a task / file.
3. The plugin generates a `.ics` file (under `附件/calendar-sync/`) and opens it with your system calendar app.
4. Review the pre-filled event and tap **Save**.

## Task format · 任务格式

| Syntax | Result |
|---|---|
| `- [ ] Report 📅 2026-09-05` | all-day event on 2026-09-05 |
| `- [ ] Report (@2026-09-05)` | all-day event on 2026-09-05 |
| `- [ ] Visit [date:: 2026-09-05]` | all-day event on 2026-09-05 |
| `- [ ] Workout 📅 2026-09-05 ⏰ 15:00` | timed event 15:00–16:00 |
| `- [ ] Call (@2026-09-05 15:00)` | timed event 15:00–16:00 |

## Settings · 设置

| Setting | Default |
|---|---|
| Timezone (auto / 24 fixed zones) | auto |
| Default event duration (minutes) | 60 |
| Timed reminder lead (minutes) | 0 (at start) |
| All-day reminder time (hour) | 9 |
| Defang dates in description | on |

## Installation · 安装

### Obsidian Community Plugins
Search for "Export ICS Schedule" in Settings → Community plugins (once published).

### Manual / BRAT
Copy `main.js`, `manifest.json`, and `styles.css` into `.obsidian/plugins/export-ics-schedule/`, then enable it in Settings → Community plugins.

## License

MIT