dsh-schedule-calendar 0.4.3 → 1.0.1

package/README.md

@@ -1,50 +1,54 @@
 # dsh-schedule-calendar · 日程助手
 
-> **功能描述**：日程助手一个面板搞定：今日安排、日历、待办、天气，可开关的黄历与星座运势，每日签到攒运气，并按实际完成情况自动生成日报与周报。适配 DSH 内核 0.2.2-rc.1。
+> **功能描述**：日程助手一个面板搞定：今日一屏（城市天气定点刷新 + 黄历 + 可折叠星座运势）、农历月历与日程待办、日报周报与每日签到，外加多账号 IMAP 收信 / SMTP 发信的邮件客户端（附件收发、草稿箱、群发）、久坐 / 喝水 / 护眼 / 听音乐提醒（界面内浮层胶囊 + 可选 Windows 系统通知，停留秒数与弹出位置可调，可手动预览）与壁纸轮播外观。适配 DSH 内核 0.2.2-rc.1。
 >
-> **English**: Schedule assistant in one panel: today plan, calendar, to-dos, weather, an almanac and horoscope block you can switch off, a daily check-in, and automatic daily and weekly reports built from what you actually finished. Adapts DSH kernel 0.2.2-rc.1.
-
-
-DSH 桌面端的侧边栏「日程助手」插件：多城市天气、黄历宜忌、农历日历、日程与提醒、工作待办、日报周报、星座运势与配对、好运签到，以及按人设置的休息日（双休 / 大小周 / 单休 / 自定义）与上下班倒计时，全部收进一个侧边栏标签页。
-
-> 依赖宿主插件 `dsh-better-sidebar`（提供侧边栏标签页能力）。
-
-## 效果图
-
-| 今日（天气 + 日程 + 星座运势） | 日历（农历 / 假期 / 休息日配色） |
-| --- | --- |
-| ![今日](https://raw.githubusercontent.com/loyalchiiina/dsh-schedule-calendar/main/docs/screenshots/1-today.png) | ![日历](https://raw.githubusercontent.com/loyalchiiina/dsh-schedule-calendar/main/docs/screenshots/2-calendar.png) |
-
-| 日程（生日解锁 / 自动排列） | 邮件（状态 / 添加账号） |
-| --- | --- |
-| ![日程](https://raw.githubusercontent.com/loyalchiiina/dsh-schedule-calendar/main/docs/screenshots/3-events.png) | ![邮件](https://raw.githubusercontent.com/loyalchiiina/dsh-schedule-calendar/main/docs/screenshots/4-mail.png) |
-
-| 待办（未完成 / 已完成） | 报告（日报 / 周报 / 批量） |
-| --- | --- |
-| ![待办](https://raw.githubusercontent.com/loyalchiiina/dsh-schedule-calendar/main/docs/screenshots/5-todos.png) | ![报告](https://raw.githubusercontent.com/loyalchiiina/dsh-schedule-calendar/main/docs/screenshots/6-reports.png) |
-
-| 设置（人员班制 / 星座） | 设置·提醒与 DIY 壁纸轮播 |
-| --- | --- |
-| ![设置](https://raw.githubusercontent.com/loyalchiiina/dsh-schedule-calendar/main/docs/screenshots/7-settings.png) | ![设置·提醒](https://raw.githubusercontent.com/loyalchiiina/dsh-schedule-calendar/main/docs/screenshots/8-settings-reminders.png) |
-
+> **English**: Schedule assistant in one panel: a today view with city weather refreshed at fixed times, an almanac and a collapsible horoscope block, a lunar month calendar, events and to-dos, daily and weekly reports and a daily check-in — plus a multi-account mail client (IMAP receive + SMTP send, attachments in both directions, drafts, group send), health reminders that surface as an in-app floating capsule on top of the DSH client (adjustable dwell time of 3–60 s and position, optional Windows system notification, manual preview), and a rotating wallpaper appearance. Adapts DSH kernel 0.2.2-rc.1.
+
+
+DSH 桌面端的侧边栏「日程助手」插件：城市天气（定点刷新）、黄历宜忌、农历月历、日程与提醒、工作待办、日报周报、星座运势与配对、好运签到、按人设置的休息日（双休 / 大小周 / 单休 / 自定义）与上下班倒计时，还能收发邮件（多账号 IMAP / SMTP）、按点弹健康提醒、轮播壁纸做背景 —— 全部收进一个侧边栏标签页。
+
+> 依赖宿主插件 `dsh-better-sidebar`（提供侧边栏标签页能力，未安装则标签页挂不上），并需要 DSH 0.2.2+。
+
+## 效果图
+
+| 今日（天气 / 日程 / 星座） | 日历（农历 / 假期 / 班休） |
+| --- | --- |
+| ![今日](docs/screenshots/1-today.jpg) | ![日历](docs/screenshots/2-calendar.jpg) |
+
+| 邮件（多账号收件箱） | 待办（未完成 / 已完成） |
+| --- | --- |
+| ![邮件](docs/screenshots/3-mail.jpg) | ![待办](docs/screenshots/4-todos.jpg) |
+
+| 设置 · 外观（文字颜色 / 壁纸轮播） |
+| --- |
+| ![设置](docs/screenshots/5-settings.jpg) |
+
 ## 功能
 
-- **多城市天气**：按「省 / 市 / 区」级联或关键字搜索添加城市（区级用 Nominatim 地理编码，回退 Open-Meteo），横向表格显示今天 / 明天 / 后天 / 大后天 4 天预报；支持「🔄 刷新」与失败自动重试。
-- **黄历（宜 / 忌）**：今日头部在星期右侧显示农历与当日宜忌（本地黄历算法，按日固定）。
-- **农历日历**：显示农历与节气、法定节假日；周末 / 个人休息日 / 法定假期 / 补班上班 四类背景色可区分，且可在设置里自定义颜色；日历右侧分栏点日期看/加当天日程，支持右键加日程。
-- **日程**：标题、日期、时间、备注、提前提醒；支持**不重复 / 每日 / 每周 / 每月 / 每年 / 农历每年（生日纪念）**；记录创建时间；列表按下次发生排序，**本周期已过发灰、未到的高亮**。
-- **工作待办**：可设**截止日期**，未完成按截止日排序、逾期红色「⚠ 逾期」，已完成显示完成时间。
+- **城市天气（定点刷新）**：按「省 / 市 / 区」级联或关键字搜索添加城市（区级用 Nominatim 地理编码，回退 Open-Meteo），横向表格显示今天 / 明天 / 后天 / 大后天 4 天预报；每天 **8:30 / 12:00 / 17:30** 定点刷新，其余时间保持静态不跳动，也可手动「🔄 刷新」，失败自动重试。
+- **黄历（宜 / 忌）**：今日头部在星期右侧显示农历与当日宜忌（本地黄历算法，按日固定），可在设置里开关。
+- **农历月历**：月视图显示农历与节气、法定节假日；周末 / 个人休息日 / 法定假期 / 补班上班 四类背景色可区分，且可在设置里自定义颜色；**点击某天即可查看 / 添加当天日程**（也支持右键加日程）；**开背景图时格子自动半透明**以免挡住壁纸，不开背景则保持原配色。
+- **日程**：增删改，字段含标题、日期、时间、备注、提前提醒；重复支持**不重复 / 每日 / 每周 / 每月 / 每年 / 农历每年（生日纪念）**；记录创建时间；列表按下次发生排序，**本周期已过发灰、未到的高亮**。
+- **工作待办**：增删改与完成状态切换，可设**截止日期**；未完成列表支持按**时间 / 标题**排序并在**升序 / 降序**间切换（默认时间升序 —— 截止越近越在上，无截止日期排最后），逾期红色「⚠ 逾期」，已完成按完成时间倒序（最近完成的在上）。
 - **日报 / 周报**：日报可「一键生成（自动统计当日日程 / 未完成任务 / 已完成）」，支持按日期区间**批量一键生成**；周报自动汇总本周日报与完成情况，也可手动修改并保存。
-- **星座运势**：在「设置」里为每人填写生日（可选**阳历 / 农历 + 年份**，自动识别星座）；「今日」底部显示星座图案与每日气运（综合 / 恋爱 / 事业 / 财运 / 幸运色 / 幸运数字），并给出**星座配对**（最配 TOP3 + 与其余 11 星座的相处评分）。
+- **星座运势（可开关）**：在「设置」里为每人填写生日（可选**阳历 / 农历 + 年份**，自动识别星座）；「今日」底部显示星座图案与每日气运（综合 / 恋爱 / 事业 / 财运 / 幸运色 / 幸运数字），并给出**星座配对**（最配 TOP3 + 与其余 11 星座的相处评分）；整块可在设置里开关，并已做**紧凑折叠**，展开才占版面。
 - **好运签到**：今日顶部 Buff 条，每日签到随机抽取「鸿运当头 / 日进斗金 / 暴富」等好运词并附健康提醒，连续签到累计天数。
 - **人员与班制**：多人管理；每人在「双休 / 大小周 / 单休 / 自定义星期」间切换。**大小周**语义：大周周六周日都休（双休），小周周六上班、周日休；可指定本周大 / 小周并自动交替。
 - **上下班倒计时**：按当前人员班制实时倒计时（距上班 / 距下班），上下班到点提醒。
 - **左侧栏入口**：在原生左侧栏脚部注入「日程助手」按钮，一键打开右侧面板；也可从右侧「新建标签页」选择「日程助手」。
-- **DIY 背景（壁纸文件夹轮播）**：设置里可填一个壁纸文件夹路径（jpg / png / webp / gif），插件读取文件夹内图片自动轮播为面板背景，支持深浅色自动适配与磨砂玻璃效果。
-- **健康 / 趣味提醒**：久坐、喝水（科学饮水量按体重估算）、摸鱼 / 护眼、听音乐等提醒，间隔可自定，支持开关与恢复默认。
-- **邮件监控（⚠️ 暂不可用）**：设置里有添加 QQ 邮箱账号（IMAP 授权码）与开启邮件监控的入口（含模拟一封 / 开启监控）、收件箱展示、Windows 桌面通知与声音提醒；**目前 IMAP 监控功能尚在开发中，界面可操作但真实收发暂不可用**。
+- **外观（壁纸文件夹轮播）**：设置里可填一个壁纸文件夹路径（jpg / png / webp / gif），插件读取文件夹内图片自动轮播为面板背景；支持**顺序 / 随机不重复洗牌**两种播放方式、切换间隔、透明度、磨砂玻璃开关，**文字颜色可设为自动 / 深色字 / 浅色字 / 自定义取色**，深浅色自动适配；开背景图时日历格子自动半透明。
+- **健康 / 趣味提醒**：久坐、喝水（科学饮水量按体重估算）、摸鱼 / 护眼、听音乐四条内置提醒，可改间隔与时段、可增删、可恢复默认。**到点由宿主端扫描**（不依赖界面是否打开）：在 DSH 客户端界面**最上层浮出自绘的胶囊卡片**（`document.body` 固定层，z-index 10500，**与侧边栏是否展开无关**），**停留时间可在设置里设 3~60 秒（默认 6 秒）**，**弹出位置用左右 / 上下两个百分比滑块调**，**点一下胶囊立即关闭**；也可**同时推送 Windows 系统通知**（独立开关，窗口最小化也能看到），还可选择自动弹出侧边栏定位到日程助手，各开关可单独关闭；设置里每条提醒都有 **▶ 手动预览**（只预览效果，不消耗正式计时）。
+- **邮件（IMAP 收信 + SMTP 发信，QQ 邮箱实测通过）**：**多账号**，每个账号独立授权码、存本机凭据库，按账号设定的间隔定时收信。收件箱 **七个页签**（全部 / 未读 / 星标 / 垃圾 / 垃圾箱 / 已发送 / 草稿），**未读与已读底色区分**，支持关键词搜索、点开看全文（自动标已读）、收藏（星标）/ 标记垃圾 / 删除（本地 + IMAP 双向尽力同步）/ 还原；正文里的网址显示为蓝色可点，**用系统默认浏览器打开**。写信支持**多附件（含中文文件名）**与群发（逐封限速），带**草稿箱**；**附件收发都支持** —— 收信附件落盘后可预览、「↗ 用系统默认应用打开」（发信仅纯文本正文，不支持 HTML 排版）。账号信息卡显示服务器 / 检查间隔 / 上次检查 / 未读统计。列表支持按**时间 / 标题**排序（升序 / 降序可切，**默认按收到时间降序 —— 最新邮件在最上面**）。
 - **日程生日上锁与解锁**：日历视图的生日纪念可上锁保护隐私，解锁后显示备注内容；支持自动排列。
-- **数据随包走**：数据存在插件包内 `data/store.json`，便于整包打包 / 备份。
+- **设置分栏**：设置页按 班制 / 城市 / 提醒 / 外观 / 数据 / 关于 六个二级分栏，不挤在一页。
+- **数据随包走**：全部数据为本地 JSON（插件包内 `data/store.json`），不上传云端，便于整包打包 / 备份。
+
+## 已知限制
+
+- 邮件正文只渲染**纯文本化内容**，不支持 HTML 正文渲染；发信也只发纯文本正文，不带 HTML 排版。
+- 「已发送」只存本地副本，不会同步写入邮箱服务器的「已发送」文件夹。
+- 附件单封上限 **8MB**、单次合计上限 **20MB**。
+- 提醒有**两条独立通路**：**界面内浮层胶囊**（自绘在 DSH 客户端界面之上，与侧边栏展开与否无关）与 **Windows 系统通知**，可分别开关。界面胶囊属客户端侧改动，改完按 **Ctrl+Shift+R 硬刷新**即生效，**不需要重启宿主 / DSH 客户端**；只有宿主端扫描逻辑（`lib/index.js`）变更才需要彻底退出再启动。
 
 ## 安装（桌面端 · desktop profile）
 

package/data/defaults.json

@@ -3,28 +3,136 @@
   "settings": {
     "activePersonId": "p1",
     "activeCityId": "c-bj",
+    "weekStart": 1,
     "reminderSound": true,
     "workReminder": true,
-    "weekStart": 1
+    "showAlmanac": false,
+    "showHoroscope": false,
+    "reminderToast": true,
+    "reminderSeconds": 6,
+    "textTone": "auto",
+    "textColor": "#ff004c",
+    "capsX": 44,
+    "capsY": 20,
+    "colors": {
+      "weekend": "#fff3d6",
+      "rest": "#e3f5ec",
+      "holiday": "#ffe0e1",
+      "makeup": "#e5edff"
+    },
+    "buff": {
+      "date": "",
+      "text": "",
+      "streak": 0
+    },
+    "reminders": [
+      {
+        "id": "r-sit",
+        "type": "sit",
+        "emoji": "🧘",
+        "name": "久坐提醒",
+        "enabled": true,
+        "intervalMin": 5,
+        "start": "09:00",
+        "end": "18:00",
+        "msg": "久坐 45 分钟啦，起身活动一下、伸个懒腰吧～"
+      },
+      {
+        "id": "r-drink",
+        "type": "drink",
+        "emoji": "💧",
+        "name": "喝水提醒",
+        "enabled": true,
+        "intervalMin": 5,
+        "start": "08:00",
+        "end": "20:00",
+        "msg": "该喝水啦，小口慢饮，别等口渴才喝～"
+      },
+      {
+        "id": "r-eye",
+        "type": "fun",
+        "emoji": "🐟",
+        "name": "摸鱼/护眼",
+        "enabled": true,
+        "intervalMin": 5,
+        "start": "09:30",
+        "end": "18:00",
+        "msg": "摸鱼时间到～看看远处放松眼睛，别一直盯屏幕"
+      },
+      {
+        "id": "r-music",
+        "type": "music",
+        "emoji": "🎵",
+        "name": "听音乐提醒",
+        "enabled": true,
+        "intervalMin": 5,
+        "start": "10:00",
+        "end": "18:00",
+        "msg": "放首歌听吧，调节心情，效率更高～"
+      }
+    ],
+    "drink": {
+      "weightKg": 60,
+      "totalMl": 2100,
+      "cups": 9,
+      "cupMl": 233,
+      "start": "08:00",
+      "end": "20:00"
+    },
+    "diy": {
+      "enabled": false,
+      "dir": "",
+      "intervalSec": 1,
+      "veil": 0,
+      "order": "rand",
+      "frost": false
+    },
+    "update": {
+      "autoCheck": true
+    }
   },
   "weatherCities": [
-    { "id": "c-bj", "name": "北京", "latitude": 39.9042, "longitude": 116.4074, "country": "中国", "admin1": "北京市" },
-    { "id": "c-sh", "name": "上海", "latitude": 31.2304, "longitude": 121.4737, "country": "中国", "admin1": "上海市" }
+    {
+      "id": "c-bj",
+      "name": "北京",
+      "latitude": 39.9042,
+      "longitude": 116.4074,
+      "country": "中国",
+      "admin1": "北京市"
+    },
+    {
+      "id": "c-sh",
+      "name": "上海",
+      "latitude": 31.2304,
+      "longitude": 121.4737,
+      "country": "中国",
+      "admin1": "上海市"
+    }
   ],
   "persons": [
     {
       "id": "p1",
       "name": "我",
       "schedule": {
-        "type": "double",
-        "workStart": "09:00",
-        "workEnd": "18:00",
+        "type": "bigsmall",
+        "workStart": "08:30",
+        "workEnd": "17:30",
         "bigWeekIsWork": true,
         "anchorDate": "2026-01-05",
-        "customWorkdays": [1, 2, 3, 4, 5]
+        "customWorkdays": [
+          1,
+          2,
+          3,
+          4,
+          5
+        ],
+        "anchorIsBig": true
       }
     }
   ],
   "events": [],
-  "todos": []
+  "todos": [],
+  "contacts": [],
+  "dailyReports": {},
+  "weeklyReports": {}
 }