Nicercz007-cloud/schedule

🗓️ schedule

DSH Desktop 桌面小组件 · 三合一毛玻璃悬浮卡片

_时间安排 · 目标追踪 · 日期规划 —— 一个插件，铺满你的桌面_

version
license
platform
deps

纯前端 vanilla DOM 实现，零依赖，localStorage 持久化。
三张卡片均为毛玻璃质感（明暗主题自动跟随桌面壁纸），可拖动、任意缩放、自动记忆位置。

English: A pure vanilla-DOM DSH Desktop widget suite with zero dependencies. Three frosted-glass floating cards — daily schedule, goal tracker with freeform flowchart workspace, and calendar planner — persisted via localStorage, with data export/import, rolling auto-snapshots, delete-undo, and light/dark theme auto-detection.

✨ 三个模块

| 模块 | 一句话介绍 |
| --- | --- |
| 🗓 每日时间安排 | 写一次长期生效的日程：事项 + 起止时间 + 周期（每天 / 工作日 / 周末），进行中的事项自动高亮 |
| 🎯 目标设置 | 一行一个目标的条状数据行，进度直接点数字改；📊 展开自由流程图工作台 |
| 📆 日期规划 | 月历视图的跨天任务：从某天到某天，彩色任务条铺满每一天，流程图截止日同步上历 |

🗓 每日时间安排

- 每行布局：事项（左）· 起止时间段（右，上下堆叠）· 周期下拉 · 删除
- 周期：每天 / 工作日 / 周末 —— 写一次长期生效，当天不生效的行半透明显示
- 进行中高亮（0.17.0）：当前时间落在某行起止区间内即高亮描边，已过时段自动变灰
- 内置倒计时便签（重要日期倒数：天 + 时 : 分 : 秒）
- 首次使用自动注入一日模板；旧版本数据自动迁移

🎯 目标设置

- 条状数据行 [勾选] [名称] [进度%] [📊] [×] —— 在最小的空间显示最多的数据
- 进度百分比点击即可编辑（0–100）；含子目标的目标自动汇总为百分比（只读）
- 点 📊 展开 WPS 工作台式自由流程图：
29 种 SVG 形状 · 正交吸附连线 · 节点截止日期条（按紧迫度变色）· 画布 0.3×–2.5× 缩放 · 可拖拽缩放的独立悬浮窗

📆 日期规划

- 任务为 {标题, 备注, 开始日期, 结束日期, 颜色} 的跨天任务
- 跨多天的任务在覆盖的每一天格子里显示彩色任务条（最多 3 条 + +N）
- 「今天」按钮（0.17.0）：翻到别的月份后一键回到当月
- 截止日联动（0.17.0）：流程图节点设置的截止日期按紧迫度配色显示在月历上，点击直达该目标流程图，实时刷新
- 点击某天新建任务；编辑器含起止日期（自动纠正倒置）与 6 色色板

🧩 通用特性

- 毛玻璃卡片（0.17.0 重设计）：半透明磨砂 + 彩色侧条玻璃行，明暗主题自动跟随壁纸
- 卡片拖动 + 位置记忆，双方式缩放（右下角 + 底部把手）
- 悬浮按钮四个分区（0.18.0 起为线性 SVG 图标）：🧩 显隐全部卡片 / 📅 今日面板 / 📊 流程图 / ⚙ 数据中心
- 今日面板（0.18.0）：进行中、即将开始（1 小时内）、今日截止、已逾期、今天的任务一屏聚合，30 秒自动刷新，点击直达对应卡片或流程图
- 自动备份文件（0.18.0）：⚙ 里一次性绑定一个 .json 文件（File System Access API），全部数据每 10 分钟自动落盘到该文件——浏览器存储被清也能一键恢复；环境不支持时自动隐藏该选项
- ⚙ 数据中心（0.17.0）：
- 📤 导出 / 📥 导入 JSON 备份
- 自动快照（最近 5 份，去重滚动），一键恢复，清缓存前先导出
- 单卡显示/隐藏开关（× 关掉的卡不再"复活"，从 ⚙ 里重新打开）
- 双重确认的清空数据（清空前自动留快照，可反悔）
- 删除撤销（0.17.0）：所有删除（流程图节点/连线、目标、日程、便签、日历任务）弹「已删除 · 撤销」toast，Ctrl+Z 同样有效
- 性能优化（0.17.0）：选中节点/拖拽/平移不再全量重绘；文字输入落盘与侧栏重建 400ms 防抖
- 所有数据存 localStorage，刷新 / 重启不丢；单卡数据损坏不再拖垮整个插件启动

📦 安装

方式一：从 tgz 安装（推荐）

从 Releases 下载 schedule-x.y.z.tgz 后：

dsh plugin add ./schedule-0.18.0.tgz

或者手动解压到 DSH 的插件目录：

1. 源目录
tar -xzf schedule-0.18.0.tgz -C /tmp && cp -r /tmp/package ~/.dsh/local-plugins/schedule
2. 运行目录（重要 —— DSH Desktop 实际从 profiles/desktop 加载）
cp -r /tmp/package ~/.dsh/profiles/desktop/node_modules/schedule

方式二：从源码

git clone https://github.com/Nicercz007-cloud/schedule.gitbash
mkdir -p ~/.dsh/local-plugins ~/.dsh/profiles/desktop/node_modules
cp -r schedule ~/.dsh/local-plugins/
cp -r schedule ~/.dsh/profiles/desktop/node_modules/

💡 两条 cp 缺一不可：local-plugins 是插件注册目录，profiles/desktop/node_modules 是 DSH Desktop 实际加载的运行副本。
💡 Windows 用户请用 Git Bash 执行上述命令（~ 即 C:\Users\）；或者直接用资源管理器把 schedule 文件夹分别复制进这两个目录。
💡 本地开发改完源码，直接双击仓库里的 sync.cmd 即可把源目录同步到运行目录。
⚠️ 安装后请完全重启 DSH Desktop 生效。

🗂 项目结构
text
lib/client.js      浏览器半：全部 UI（三张卡片 + 流程图 + ⚙ 数据中心），注入页面运行
lib/index.js       宿主半：cordis bundle 注册（安全 no-op）
cordis.patch.yml   bundle 注册补丁
sync.cmd           开发用：源目录 → 运行目录一键同步

🔑 数据键（localStorage）

| 键 | 内容 |
| --- | --- |
| dw:schedule:data | 每日时间安排 [{id, time, endTime, text, kind}] |
| dw:countdown:data | 倒计时便签 [{title, t}] |
| dw:goals:data | 目标（含子目标树 + 流程图边 + 截止日期） |
| dw:cal:data | 日期规划 [{id, title, desc, startDate, endDate, color}] |
| dw:backup:v1 | 自动快照环形缓冲（最近 5 份） |
| dw:hidden / dw:launcherShown | 单卡显隐 / 悬浮按钮状态 |

🈶 0.16.x 及更早版本的数据无需任何操作，启动时自动迁移补齐。

📜 更新日志

| 版本 | 变更 |
| --- | --- |
| 0.18.0 | 今日面板（进行中/即将开始/今日截止/逾期/今天任务聚合，点击直达，30s 刷新）；线性 SVG 图标替换 emoji 界面骨架（悬浮按钮四分区、卡片标题带模块色图标、流程图按钮）；自动备份文件（File System Access API 绑定 .json，每 10 分钟静默落盘，免疫浏览器存储被清）；全部 color-mix 声明加老内核回退 |
| 0.17.0 | 毛玻璃视觉全面重设计；⚙ 数据中心（导出/导入/自动快照/单卡显隐/清空）；全部删除可撤销（toast + Ctrl+Z）；日程「进行中」高亮与已过变灰；日历「今天」按钮 + 流程图截止日联动上历；大图性能优化（选中不重绘、输入防抖）；修复：新建目标缺 id 导致的 "undefined" 键污染复发、连线成环卡死侧栏、脏数据炸掉整个启动、单卡关闭状态被 launcher 重置（含升级自愈：一次性清空旧版遗留的关闭状态，且"显示"永不落到零张卡）；清理 813KB 误打包备份与根目录重复文件 |
| 0.16.7 | 修复旧版本无 id 目标导致的流程图停靠键 "undefined" 污染（启动自愈） |
| 0.16.6 | 移除内嵌第三方壁纸（base64）并修复体积/版权问题；去掉未实现的「单次」周期选项；安装命令改用 dsh plugin add |
| 0.16.5 | 目标进度统一为百分比显示 |
| 0.16.4 | 目标卡片改为条状数据行、整体缩小；修复事项与时间段重叠 |
| 0.16.0 | 周期下拉、日历跨天任务、装饰随卡片缩放 |
| 0.15.0 | 流程图编辑器改为可拖拽缩放的悬浮窗（8 向手柄 + 最大化/还原） |
| 0.14.0 | 画布 0.3×–2.5× 缩放 + Ctrl 滚轮缩放 |
| 0.13.0 | 日历事件 chips、节点截止日期条（紧迫度渐变色）、便签装饰随卡片等比缩放 |
| 0.12.0 | WPS 工作台式流程图重构（形状库 / 正交连线 / 中点吸附 / 连线中部插入节点） |
| 0.11.0 | 修复循环引用导致的静默保存失败（孙节点丢失） |
| 0.8.0 | 便签纸皮肤统一三卡视觉 |
| 0.6.0 | 卡片全透明壳 + 更易发现的缩放手势 |

📄 License

MIT © 2026