日程日历

更新内容

• 修复 JSON 注入 script 标签导致的存储型 XSS。
• 修复外部日历 URL 无校验导致的 SSRF。
• 修复本地条目无界重复展开导致的 DoS。
• 修复 CSS 样式属性颜色值注入。
• 修复已禁用日程可通过直接名称引用访问。

---

Generate from v3.3.0

更新内容

• 新增批量导入本地事项，支持通过文本格式一次性添加多条日程。
• 更新支持的 Halo 版本至 >=2.25.0。

---

Generate from v3.2.0

更新内容

• 修复 Microsoft Outlook Calendar 等使用 Windows 时区名称（如 China Standard Time）的 ICS 订阅无法导入的问题。
• 新增 Windows 时区到 IANA 时区的自动映射，解析失败时回退到系统默认时区。

---

Generate from v3.1.0

更新内容

• 新增外部日历订阅管理，支持添加 Google Calendar 等工具导出的公开 iCal 地址，并可启用、停用、编辑、删除和手动刷新订阅缓存。
• 前台公开页面、后台周历和编辑器日程卡片支持展示外部日历事项。
• 新增公开 iCal 订阅地址 /schedule-calendar.ics，用于导出本地事项，并明确不包含外部日历订阅数据。
• 本地事项支持启用和停用状态，备份恢复会保留并同步该状态。
• 插件设置与备份恢复流程优化，支持统计本地事项和外部日历订阅的新增、更新、删除数量。
• 优化公开链接生成，前台页面和 iCal 订阅链接使用 Halo 外部访问地址。
• 优化外部日历订阅缓存加载与手动刷新，减少每次访问时的远端订阅请求开销。
• 清理临时诊断接口、无效样式和过期内部配置，补齐公开 API 权限声明。

---

Generate from v3.0.0

更新内容

• 修复构建依赖配置，将 Halo 平台依赖从失效的快照版本切换到正式版本，恢复持续集成环境下的依赖解析。
• 修复 Gradle 9.4 与 pnpm 安装任务的兼容问题，避免前端依赖目录状态跟踪导致构建失败。

---

Generate from v2.8.0

更新内容

• 修复前台公共日历页面标题未做 HTML 转义的问题，避免插件设置中的标题被直接注入 <title> 和 <h1> 引发存储型 XSS 风险。
• 调整公共日历页面标题渲染逻辑，统一复用现有 HTML 转义处理，并补充对应回归测试，降低后续模板调整时再次引入同类问题的概率。
• 优化编辑器日程卡片扩展的依赖结构，移除对 @tiptap/core 的直接依赖，统一改为复用 Halo 富文本编辑器导出，减少额外依赖维护成本。感谢 @ruibaby 提交的 PR #10。

---

Generate from v2.7.0

更新内容

• 前台和后台新增当前状态提示，并按分钟刷新显示当前空闲或正在进行中的事项。
• 前台和后台周视图补充当前时间线与红点指示，并优化层级表现，查看当前时间位置更直观。
• 新增“距离下一个事项还有多久”提示，同时统一相关文案与展示细节，减少无效占位信息。
• 优化前台顶部工具区布局，标题、状态、日期切换和视图切换在桌面与手机端的层级更清晰。
• 补充 Finder API 与 REST API 的摘要能力，新增 summary 接口，并在周视图返回中补充 serverTime、zoneId、summary 字段，便于主题和自定义前端直接消费。

---

Generate from v2.6.0

更新内容

• 优化前台和后台手机端周视图的自适应布局，恢复日历区域内的纵向滑动体验，并提升小屏设备查看整周事项的完整性。
• 进一步优化前台和后台手机端事项块样式，标题改为居中显示并放大字号，同时在手机端保持横向和竖向都居中，提升周视图可读性。
• 优化后台周视图布局切换控件，改为更接近前台体验的 Halo 原生切换样式，同时提升手机端宽度适配表现。
• 精简后台事项布局展示，移除事项卡片右上角的循环标签，减少移动端信息干扰。
• 修复控制台工具入口和插件页数据备份入口在部分权限聚合场景下消失的问题。
• 调整数据备份页权限处理逻辑：入口保持可见，无管理权限时显示只读提示并禁用导出、导入操作。

---

Generate from v2.5.0

更新内容

• 修复手机端后台周历与 Halo 底部菜单的遮挡问题，避免事项色块覆盖底部黑色菜单区域。
• 优化手机端周历滚动区域与层级处理，提升小屏设备下后台查看的稳定性。

---

Generate from v2.4.0

更新内容

• 修复公开日历页面将事项内容直接写入 innerHTML 带来的潜在 XSS 风险，改为使用安全的 DOM 构造方式。
• 升级并锁定前端关键依赖到安全版本，处理 axios、form-data、qs、vite 等依赖链安全问题。
• 移除不必要的 unplugin-icons 依赖链，改用 Halo 现有图标组件，减少额外攻击面和依赖噪音。

---

Generate from v2.3.0

更新内容

新增功能

• 扩展对外能力说明，补充 Finder API 与公开 REST API 文档，明确对外查询能力与接入方式。
• 补充插件权限模板，细分“日程日历查看”和“日程日历管理”，支持按权限控制后台可见范围与管理能力。

优化功能

• 恢复 Halo 原生插件设置页，移除自定义设置页实现，设置项重新接回 Halo 原生配置链路。
• 后台事项删除改回 Halo 原生确认对话框，交互与控制台保持一致。
• 插件备份页保留在插件设置区域，并调整为更接近 Halo 原生的卡片与操作布局。
• 精简备份页文案与结构，移除多余说明区域、蓝色提示块，并统一“下载备份文件”等按钮文案。
• 优化前台日历页面边角裁切与布局细节，修正日历容器圆角表现。

修复内容

• 修复备份恢复时 ScheduleEntry 索引未注册导致的 500 错误，插件启动阶段会主动注册事项索引。
• 修复备份恢复链路，恢复过程重新基于已验证接口同步事项与插件设置，避免恢复失败或配置不存在时异常。
• 修复普通被授予“日程日历管理”权限的用户无法在后台新增、编辑、删除事项的问题。
• 修复后台工具页对管理权限的误判问题，避免已授予管理权限的用户仍被错误显示为只读。
• 修复权限探测过程中在后台产生 403 噪音日志和 500 错误的问题，权限判断改为无副作用探测方式。
• 修复无管理权限时编辑器侧仍可新增事项的问题，移除不受控的编辑器侧新增入口。
• 修复后台操作按钮与服务端权限状态不一致的问题，管理操作与服务端权限校验重新对齐。
• 修复插件设置、备份页与权限边界的显示不一致问题，管理权限不足时不再暴露不该出现的管理能力入口。

---

Generate from v2.2.0

更新内容

新增功能

• 新增插件设置页数据备份与恢复，支持导出当前插件设置和全部事项为 JSON，并支持按备份内容恢复设置与事项数据。
• 新增后台事项周视图“日历布局 / 事项布局”双模式，前台 /schedule-calendar 页面同步支持双布局切换。
• 新增移动端专用纵向周视图，小屏下按天分组展示事项，减少七列表格在手机上的使用负担。

优化功能

• 备份入口接入插件详情原生标签页。
• 后台事项删除接入 Halo 原生二次确认弹窗，布局切换改为更稳的 Halo 原生按钮组。
• 优化后台与前台移动端工具栏、布局切换、横向滚动和小屏宽度表现。
• 优化后台事项列表头部、编辑器新增事项弹窗、选择日程弹窗和已选卡片的小屏自适应布局。
• 删除备份页顶部重复说明，仅保留导出与导入恢复两个核心区域。

修复内容

• 修复备份恢复时配置不存在、事项恢复触发服务器内部错误、ScheduleEntry 索引异常等问题，恢复流程改为复用已验证接口同步事项。
• 修复后台入口与插件设置页备份页显示兼容性问题。
• 修复前后台周视图在小屏和桌面端的白屏、未撑满、右侧溢出、内容错位、按钮挤压和间距异常等问题。

---

Generate from v2.1.0

更新内容

新增功能

• 新增事项管理页列表化管理体验，支持实时搜索、快速新增、编辑、删除，并补齐 Halo 风格的操作按钮。
• 新增编辑器日程卡片能力，支持通过工具箱和 / 命令插入事项，并在文章中展示时间、地点、备注、循环信息和“下一次出现”。
• 新增权限控制，区分后台查看 / 管理权限，并补充公开卡片匿名访问所需权限模板。

优化功能

• 优化事项选择弹窗、已选卡片、发布页卡片与后台列表样式，统一日期格式为 YYYY-MM-DD / YYYY-MM-DD HH:mm。
• 优化搜索交互为实时触发，清空即恢复全部结果，并修复编辑内容未变化时的提示逻辑。
• 优化事项加载与同步逻辑，已选事项和发布页卡片会读取最新数据，且不再受 200 条数量限制。
• 修复循环事项“下一次出现”计算异常，以及周视图重叠、跨零点、iframe 高度和多余留白等显示问题。

---

Generate from v2.0.0

更新内容

• 新增循环事项能力，支持按每天、每周、每月、每年重复，并可设置循环间隔与截止日期。
• 新增控制台事项编辑能力，可直接修改标题、时间、循环规则、颜色、地点和备注。
• 新增 Halo 主题可直接调用的 Finder API：scheduleCalendarFinder，支持 week(start)、get(name)、listAll()。
• 修复控制台与前台公开页中地点、备注、循环信息的展示顺序不一致问题，并统一悬浮提示文案。
• 修复 24 小时事项展示异常，以及跨天循环事项可能导致周历渲染混乱的问题。
• 修复周历事项色块中地点、备注等附加信息的行距不一致问题，并恢复按色块高度自适应显示内容。
• 修复周历事项在短色块场景下内容垂直居中导致的半截裁切问题，改为顶部排版并更保守地控制可见行数。
• 修复正式版发布流程中的测试编译问题，补齐与当前 TimeBlock 结构一致的测试断言。
• 优化事项列表摘要展示与仓库资源结构，移除未使用图标资源和冗余前端依赖。

---

Generate from v1.1.0

更新内容

• 新增前台公开页面路由 /schedule-calendar，支持按周展示日程日历。
• 新增控制台周视图页面，支持新增、查看和删除事项，并提供周范围、事项数和总占用摘要。
• 新增编辑器日程卡片能力，可在编辑器中插入单个事项的时间信息。
• 新增插件设置页，支持自定义前台页面标题。
• 修复前后台周历在事项分列后可能被撑出宽度并触发额外滚动条的问题。
• 优化控制台与前台周历的交互、重叠事项展示和小屏适配效果。

---

Generate from v1.0.0