dsh-offwork 1.0.1 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (28) hide show
  1. package/CHANGELOG.md +10 -0
  2. package/README.md +35 -20
  3. package/assets/characters/NOTICE.md +7 -0
  4. package/assets/characters/whale-dress.webp +0 -0
  5. package/assets/characters/whale-ornate.webp +0 -0
  6. package/client.js +3569 -188
  7. package/client.source.js +2389 -218
  8. package/companion.js +185 -0
  9. package/hydration-store.js +101 -0
  10. package/hydration.js +303 -0
  11. package/locale/en.json +1 -1
  12. package/locale/zh.json +1 -1
  13. package/package.json +10 -2
  14. package/pet-interactions.js +138 -0
  15. package/pet-surfaces.js +194 -0
  16. package/pet-view.js +272 -0
  17. package/tests/companion.test.mjs +86 -0
  18. package/tests/hydration-extras.test.mjs +226 -0
  19. package/tests/hydration-store.test.mjs +287 -0
  20. package/tests/hydration.test.mjs +211 -0
  21. package/tests/pet-character.test.mjs +56 -0
  22. package/tests/pet-interactions.test.mjs +88 -0
  23. package/tests/pet-surfaces.test.mjs +128 -0
  24. package/tests/pet-view.test.mjs +48 -0
  25. package/tests/ui.test.mjs +22 -2
  26. package/tools/build.mjs +36 -6
  27. package/tools/check-package.mjs +9 -0
  28. package/ui-utils.js +16 -4
package/CHANGELOG.md CHANGED
@@ -1,5 +1,15 @@
1
1
  # 更新记录
2
2
 
3
+ ## 1.1.0 — 2026-11-05
4
+
5
+ - 新增独立 Harness 页面陪伴角色：默认鲸系少女长裙立绘，可切换礼裙或原创水滴；支持拖动、缩放、预览、应用、取消及轻微动作反馈。
6
+ - 新增喝水提醒：5–240 工作分钟间隔、秒级倒计时、手动打卡、稍后提醒、本班暂停/恢复和 30/60 自然分钟免打扰；午休冻结，下班不提醒。
7
+ - 喝水记录保存在浏览器 IndexedDB，同源标签页共享并去重；存储异常时停止自动提醒并提供恢复入口。
8
+ - 右键菜单打开独立的倒计时、喝水、收入、外观、作息与薪资卡片，支持键盘导航和未保存草稿保护。
9
+ - 卡片按内容与可视视口自适应，统一样式和焦点反馈，隐藏滚动条但保留滚动与键盘访问。
10
+ - 保留薪资配置、金额隐藏和显示偏好；外观偏好迁移至 v5，喝水存储支持 schema 1→2 迁移。
11
+ - 补充自动化与隔离浏览器验证。人物使用透明立绘与整体动作反馈，本版不包含 Live2D、独立眨眼/摆尾或视频动画。
12
+
3
13
  ## 1.0.1 — 2026-11-04
4
14
 
5
15
  - 修复默认 82% 透明度与原生滑块取值不一致的问题，支持按 1% 调整。
package/README.md CHANGED
@@ -1,13 +1,18 @@
1
1
  # 下班计时器 · Offwork Clock
2
2
 
3
- 在 DeepSeek Harness 中查看距离下班还有多久，以及本班已经赚了多少钱。
3
+ > **1.1.0**：新增鲸系少女陪伴角色、喝水提醒、免打扰和独立功能卡片。查看 [更新记录](CHANGELOG.md)、[角色与卡片操作](docs/PET-PREVIEW.md) 和 [喝水提醒规则](docs/HYDRATION.md)。
4
4
 
5
- `dsh-offwork` 提供可拖动的页面悬浮窗，支持月薪 / 日薪、跨午夜班次、无薪休息扣除和工资隐藏，工作时可以收起成小条。
5
+ 在 DeepSeek Harness 中查看下班倒计时、记录喝水，并通过独立卡片查看本班收入。
6
+
7
+ `dsh-offwork` 提供可拖动的页面陪伴角色与计时卡片，支持月薪 / 日薪、跨午夜班次、无薪休息扣除和工资隐藏。角色可关闭，继续使用原有计时小条。
6
8
 
7
9
  [GitHub 仓库](https://github.com/SnowBeatRain/dsh-offwork) · [npm 包](https://www.npmjs.com/package/dsh-offwork) · [问题反馈](https://github.com/SnowBeatRain/dsh-offwork/issues) · [迭代路线图](https://github.com/SnowBeatRain/dsh-offwork/blob/main/ROADMAP.md)
8
10
 
9
11
  ## 功能
10
12
 
13
+ - **页面陪伴角色**：鲸系少女长裙、礼裙及原创水滴三种外观，支持预览、大小调整、拖动和轻微动作反馈。
14
+ - **喝水提醒**：默认关闭，可设置 5–240 工作分钟间隔；支持手动打卡、稍后提醒、本班暂停和 30/60 分钟免打扰。
15
+ - **独立功能卡片**：右键菜单分别打开倒计时、喝水、收入、外观及作息与薪资；自适应窗口并保护未保存修改。
11
16
  - **下班倒计时**：根据作息显示待开工、工作中、休息中、班次完成和休息日状态。
12
17
  - **实时工资**：显示本班已赚金额、计薪进度、日薪和有效时薪，支持月薪或日薪输入。
13
18
  - **灵活作息**：自定义上下班时间、工作日、时区，以及一段可选的无薪休息；支持跨午夜夜班。
@@ -19,15 +24,19 @@
19
24
 
20
25
  ## 效果预览
21
26
 
22
- 以下截图来自独立的 Harness 测试配置，使用示例月薪 12,000 元、月计薪 20 天及受控的浏览器时间。
27
+ 以下截图来自隔离的 Harness 测试配置，使用示例数据。
28
+
29
+ **页面陪伴角色与外观选择**
30
+
31
+ ![鲸系少女陪伴角色](https://raw.githubusercontent.com/SnowBeatRain/dsh-offwork/main/docs/pet-preview/whale-default.png)
23
32
 
24
- **页面内的小条**
33
+ ![角色选择、大小与透明度设置](https://raw.githubusercontent.com/SnowBeatRain/dsh-offwork/main/docs/pet-preview/whale-appearance.png)
25
34
 
26
- ![Harness 页面内的下班倒计时小条](https://raw.githubusercontent.com/SnowBeatRain/dsh-offwork/main/assets/screenshot-compact.png)
35
+ **独立喝水卡片**
27
36
 
28
- **展开详情与设置**
37
+ <img src="https://raw.githubusercontent.com/SnowBeatRain/dsh-offwork/main/docs/pet-preview/adaptive-water.png" alt="喝水打卡、倒计时和免打扰卡片" width="336">
29
38
 
30
- <img src="https://raw.githubusercontent.com/SnowBeatRain/dsh-offwork/main/assets/screenshot-detail.png" alt="展开后的计薪进度、工资与班次详情" width="328"> <img src="https://raw.githubusercontent.com/SnowBeatRain/dsh-offwork/main/assets/screenshot-settings.png" alt="薪资、作息、时区和透明度设置" width="372">
39
+ 角色图片随插件加载。当前人物为透明立绘，支持轻微整体反馈；独立眨眼、摆尾、Live2D 和视频动画尚未提供。
31
40
 
32
41
  ## 运行环境
33
42
 
@@ -85,15 +94,19 @@ plugin_manager → install_bundle → target: /绝对路径/dsh-offwork
85
94
 
86
95
  ### 常用操作
87
96
 
88
- | 操作 | 使用方式 |
89
- | ---------------------- | ----------------------------------------------- |
90
- | 移动悬浮窗 | 按住小条或卡片的空白处拖动 |
91
- | 微调位置 | 悬浮窗获得键盘焦点后，使用方向键调整；Home 复位 |
92
- | 展开 / 收起 | 点击上箭头展开详情，点击下箭头收回小条 |
93
- | 显示 / 隐藏工资 | 点击眼睛图标或「显示工资」 |
94
- | 修改薪资和作息 | 点击齿轮进入设置 |
95
- | 调整透明度 | 在设置中调整「背景透明度」，仅影响背景层 |
96
- | 获取其他页面保存的配置 | 点击「读取最新配置」 |
97
+ | 操作 | 使用方式 |
98
+ | ---------------------- | ----------------------------------- |
99
+ | 移动角色 | 按住角色拖动；方向键微调，Home 复位 |
100
+ | 打开喝水卡片 | 左键点击角色 |
101
+ | 查看下班倒计时 | 点击角色脚下的倒计时 |
102
+ | 打开其他卡片 | 右键角色，或使用 Shift+F10 / 菜单键 |
103
+ | 修改形象、大小与透明度 | 右键 → 外观，预览后点击“应用外观” |
104
+ | 修改薪资和作息 | 右键 → 作息与薪资 |
105
+ | 设置喝水间隔 | 喝水卡片 → 提醒设置 |
106
+ | 使用原计时小条 | 在外观中关闭“宠物模式”并应用 |
107
+ | 显示 / 隐藏工资 | 收入卡片中的眼睛按钮 |
108
+
109
+ 喝水提醒默认关闭；开启后按有效工作时间计时，午休冻结，下班后不提醒。免打扰按自然时间计时。关闭 Harness 页面后不会在后台发送通知。
97
110
 
98
111
  同一浏览器、同一站点下的多个标签页会同步显示偏好。薪资与作息配置由 Harness Host 共享，其他页面保存后可手动读取最新配置。
99
112
 
@@ -122,7 +135,9 @@ plugin_manager → install_bundle → target: /绝对路径/dsh-offwork
122
135
 
123
136
  薪资和作息保存在**运行 Harness Host 的机器**上的插件目录 `data.json` 中。如果 Harness 部署在服务器上，配置也保存在该服务器上。保存时采用原子替换，文件权限为 `0600`；`data.json` 已被 Git 忽略，也不会包含在 npm 发布包中。
124
137
 
125
- 悬浮窗位置、展开状态、工资隐藏和透明度保存在浏览器本地存储。浏览器禁止存储时，这些偏好仅在本次页面访问期间有效。
138
+ 悬浮窗位置、角色、展开状态、工资隐藏和透明度保存在浏览器本地存储。1.1.0 会迁移旧外观偏好并保留原有选择。浏览器禁止存储时，这些偏好仅在本次页面访问期间有效。
139
+
140
+ 喝水设置与当前班次记录保存在浏览器 IndexedDB，不写入 Host 薪资文件或 Harness 会话。同源标签页共享提醒并去重；存储不可用时停止自动提醒，界面提供重试入口。清除浏览器站点数据会清除这些本地记录。
126
141
 
127
142
  **配置读取和保存通过 Harness 命令执行，返回的配置内容会进入所选会话记录；代理工具的调用及结果也会进入会话记录。** 工资隐藏只控制界面显示，不会清除配置文件或会话中已有的薪资信息。
128
143
 
@@ -166,7 +181,7 @@ plugin_manager → install_bundle → target: /绝对路径/dsh-offwork
166
181
 
167
182
  ## 开发
168
183
 
169
- 建议使用 Node.js 22，与仓库 CI 保持一致。运行时无第三方依赖；开发依赖仅用于代码格式检查，通过锁文件固定版本。
184
+ 建议使用 Node.js 22，与仓库 CI 保持一致。运行时无第三方依赖；开发依赖用于格式检查和 IndexedDB 事务回归测试，通过锁文件固定版本。
170
185
 
171
186
  ```sh
172
187
  git clone https://github.com/SnowBeatRain/dsh-offwork.git
@@ -187,7 +202,7 @@ npm run check
187
202
  | `index.js` | Host 命令、代理工具、配置校验与保存 |
188
203
  | `tests/` | 计算、持久化与界面辅助逻辑测试 |
189
204
 
190
- `npm run build` 将计算模块和界面辅助模块内联到 `client.js`。`npm test` 先检查生成物是否与源码一致，再运行测试，覆盖班次边界、夜班、休息、时区与夏令时、金额精度、磁盘持久化和命令 / 工具行为。`1.0.1` 已在隔离的 Harness `0.2.1-rc.5` 与 Headless Chromium 中完成设置、拖动、刷新恢复及双标签页等浏览器验证，范围与限制见 [验证记录](https://github.com/SnowBeatRain/dsh-offwork/blob/main/docs/VALIDATION-1.0.1.md)。
205
+ `npm run build` 将业务和界面模块、角色图片内联到 `client.js`。`npm test` 先检查生成物是否与源码一致，再运行测试，覆盖计薪、时区、持久化、喝水状态机、跨标签事务、导航和布局。1.1.0 的检查及隔离浏览器验证见 [发布验证记录](docs/RELEASE-1.1.0.md)。
191
206
 
192
207
  ## 发布到 npm（维护者）
193
208
 
@@ -227,4 +242,4 @@ git push origin main --follow-tags
227
242
 
228
243
  ## 许可与反馈
229
244
 
230
- 本项目采用 [MIT License](https://github.com/SnowBeatRain/dsh-offwork/blob/main/LICENSE)。欢迎通过 [GitHub Issues](https://github.com/SnowBeatRain/dsh-offwork/issues) 反馈问题或建议；反馈时请说明 Harness 版本、浏览器和复现步骤，薪资信息可使用示例数值代替。
245
+ 代码采用 [MIT License](https://github.com/SnowBeatRain/dsh-offwork/blob/main/LICENSE)。用户提供的鲸系少女图片随插件分发，单独使用图片请参阅 [素材说明](assets/characters/NOTICE.md)。欢迎通过 [GitHub Issues](https://github.com/SnowBeatRain/dsh-offwork/issues) 反馈问题或建议；反馈时请说明 Harness 版本、浏览器和复现步骤，薪资信息可使用示例数值代替。
package/assets/characters/NOTICE.md ADDED
@@ -0,0 +1,7 @@
1
+ # 角色图片来源
2
+
3
+ whale-dress.webp 与 whale-ornate.webp 来自用户为本插件外观开发提供的两张 PNG 立绘，原始尺寸均为 1024×1536。长裙版本为默认形象，礼裙版本为可选形象。
4
+
5
+ 处理只包括透明边缘的极低透明度噪点清理、按可见人物裁切、等比缩小、透明留白及 WebP 编码，没有重绘角色或拼接身体部位。图片随客户端打包，不依赖外部文件服务或其他宠物插件。
6
+
7
+ 本仓库代码采用 MIT 许可。这两张用户提供图片按提供者的 1.1.0 发布指示随本插件分发，原始图像的权利归相应权利人；代码的 MIT 许可不自动授予图片的独立再分发许可。