docs: add README

README.md

@@ -0,0 +1,125 @@
+# timeTable2 - 纯前端 ICS 日历整理器
+
+浏览器内解析、去重、编辑 ICS 日历文件，全程无需 Python 或后端服务。拖入 `.ics` → 整理去重 → 编辑 → 下载。
+
+## 功能
+
+- 📥 **拖入即用**：拖拽或选择 `.ics` 文件，浏览器内直接解析
+- 🔁 **智能去重**：自动检测重复模式，将 61 个扁平事件合并为 5 个 RRULE 重复事件 + 3 个独立事件
+- ✏️ **可视化编辑**：编辑标题/地点/时间/重复规则，点击网格切换排除日期
+- ✂️ **拆分事件**：把一个重复事件按日期拆成前后两段（如后半学期换教室）
+- ➕ **增删事件**：新增单次/重复事件，删除任意事件
+- ↶ **撤销重做**：快照式 undo/redo，最多 50 步
+- ⬇ **导出 ICS**：编辑完成下载整理后的 `.ics`，可直接导入日历应用
+
+## 快速开始
+
+```bash
+# 安装依赖（使用 npmmirror 镜像加速，已配在 .npmrc）
+npm install
+
+# 启动开发服务器
+npm run dev
+
+# 构建生产版本
+npm run build
+
+# 运行单元测试
+npm test
+```
+
+浏览器打开 `http://localhost:5173`，拖入 `.ics` 文件即可。
+
+## 使用流程
+
+1. **导入**：拖入 `.ics` 文件（或点击选择），左侧显示所有原始事件
+2. **去重**：点击顶栏「🔁 整理去重」，自动合并重复事件为 RRULE + EXDATE
+3. **编辑**：点击左侧事件，右侧展开编辑表单
+   - 修改标题/地点/描述/时间
+   - 调整重复规则（频率/间隔/星期/重复到）
+   - 点击 occurrence 网格切换排除日期（绿色=包含，红色删除线=排除）
+4. **拆分**（可选）：点击「✂ 拆分此日程」，选日期，把重复事件拆成前后两段
+5. **新增/删除**：点「➕ 新增日程」或「删除此日程」
+6. **撤销**：「↶ 撤销」/「↷ 重做」最多 50 步
+7. **下载**：点「⬇ 下载 ICS」，导出整理后的 `.ics`（有未保存更改时会提示确认）
+
+## 项目结构
+
+```
+timeTable2/
+├── index.html                      Vite 入口
+├── package.json
+├── .npmrc                          npmmirror 镜像加速
+├── vite.config.js
+├── vitest.config.js
+├── src/
+│   ├── main.js                     应用挂载
+│   ├── App.vue                     布局装配
+│   ├── composables/
+│   │   └── useCalendar.js          中心 store + 快照 undo/redo
+│   ├── lib/
+│   │   ├── weekday.js              星期常量与工具（统一 getDay 索引）
+│   │   ├── ical-io.js              ICS 文本 <-> plain model（ical.js 封装）
+│   │   ├── recur.js                RRULE 网格展开
+│   │   └── organize.js             GCD 去重算法（移植自 Python 版）
+│   └── components/
+│       ├── HeaderBar.vue           顶栏：整理/撤销/重做/导入/下载
+│       ├── DropZone.vue            拖拽/选择文件
+│       ├── EventList.vue           侧栏事件列表
+│       ├── EventDetail.vue         编辑表单 + 拆分
+│       └── OccurrenceGrid.vue      排除日期网格
+└── test/                           Vitest 单元测试（34 个）
+    ├── golden-org.ics              测试用例（61 事件的真实课表）
+    ├── weekday.test.js
+    ├── ical-io.test.js
+    ├── recur.test.js
+    └── organize.test.js
+```
+
+### 三个核心 lib 模块
+
+| 文件 | 作用 |
+|------|------|
+| `ical-io.js` | ICS 文本解析为普通对象、序列化回 ICS 文本（ical.js 封装） |
+| `organize.js` | GCD 间隔检测 + 系列分组 + EXDATE 生成（移植自 `ical_organizer.py`） |
+| `recur.js` | 从 RRULE + EXDATE 按需展开 occurrence 网格 |
+
+## 算法
+
+去重算法从 `timeTable/ical_organizer.py` 1:1 移植：
+
+1. 按 (标题 + 地点 + 开始时间 + 时长 + 星期) 将事件分组
+2. 计算组内相邻日期间隔的 **GCD**，识别：
+   - GCD = 7 → `FREQ=WEEKLY`（每周，含 `BYDAY`）
+   - GCD = 1 → `FREQ=DAILY`（每天）
+   - GCD = 14 → `FREQ=WEEKLY;INTERVAL=2`（每两周）
+3. 构建期望网格，网格上缺失的日期写入 `EXDATE`（如假期）
+4. 不符合规律的组（跳过次数 ≥ 事件数）保留为独立事件
+5. 合并后保留首个事件的原始 UID（避免重新导入冲突）
+
+**验证**：对 `org.ics`（61 事件）整理后输出 8 个事件（5 重复 + 3 独立），与 Python 版 `ical_organizer.py --verify` 结果一致。下载的 ICS 用 Python `recurring-ical-events` 展开，61 个 occurrence 与原始文件完全匹配。
+
+## 技术栈
+
+| 项 | 选择 |
+|----|------|
+| 框架 | Vue 3.5（SFC，`<script setup>`） |
+| 构建 | Vite 6 |
+| ICS 库 | ical.js 2.x（仅用于文本↔对象转换） |
+| 状态管理 | composable 单例 store（无 Pinia） |
+| 测试 | Vitest |
+| 包源 | npmmirror.com（中国镜像加速） |
+
+## 与 timeTable 的关系
+
+`timeTable`（Python 版）使用 Flask + icalendar 库，需创建 venv 并启动本地服务器。
+`timeTable2` 是纯前端等价实现：零安装、双击即用、算法行为一致。
+
+| 对比 | timeTable (Python) | timeTable2 (前端) |
+|------|--------------------|--------------------|
+| 运行方式 | venv + Flask 服务器 | 浏览器直接打开 |
+| 依赖 | icalendar, flask, recurring-ical-events | ical.js |
+| 整理器 | `ical_organizer.py` 命令行 | 网页内「整理去重」按钮 |
+| 编辑器 | `ical_editor.py` + `editor.html` | Vue3 组件 |
+| 验证 | `recurring_ical_events` 展开 | 网页内 occurrence 网格 |
+| 导出 | 保存到磁盘 / 下载 | 下载 `.ics` |