dsh-offwork 1.0.0 → 1.1.0

package/CHANGELOG.md

@@ -0,0 +1,27 @@
+# 更新记录
+
+## 1.1.0 — 2026-11-05
+
+- 新增独立 Harness 页面陪伴角色：默认鲸系少女长裙立绘，可切换礼裙或原创水滴；支持拖动、缩放、预览、应用、取消及轻微动作反馈。
+- 新增喝水提醒：5–240 工作分钟间隔、秒级倒计时、手动打卡、稍后提醒、本班暂停/恢复和 30/60 自然分钟免打扰；午休冻结，下班不提醒。
+- 喝水记录保存在浏览器 IndexedDB，同源标签页共享并去重；存储异常时停止自动提醒并提供恢复入口。
+- 右键菜单打开独立的倒计时、喝水、收入、外观、作息与薪资卡片，支持键盘导航和未保存草稿保护。
+- 卡片按内容与可视视口自适应，统一样式和焦点反馈，隐藏滚动条但保留滚动与键盘访问。
+- 保留薪资配置、金额隐藏和显示偏好；外观偏好迁移至 v5，喝水存储支持 schema 1→2 迁移。
+- 补充自动化与隔离浏览器验证。人物使用透明立绘与整体动作反馈，本版不包含 Live2D、独立眨眼/摆尾或视频动画。
+
+## 1.0.1 — 2026-11-04
+
+- 修复默认 82% 透明度与原生滑块取值不一致的问题，支持按 1% 调整。
+- 为设置中的工资显示和计薪方式按钮补充明确的辅助名称。
+- 统一源码格式，固定开发依赖，补充开发指南及格式、语法和打包检查。
+- 更新 GitHub Actions，发布前执行完整检查。
+- 明确界面和工具中的 Harness Host 配置存储说明。
+- 补充真实 Harness 截图、市场图标、浏览器验证记录及插件迭代计划。
+
+## 1.0.0 — 2026-11-04
+
+- 首次发布 Harness 页面内的下班倒计时与实时工资悬浮窗。
+- 支持月薪 / 日薪、跨午夜班次、工作日、时区和可选无薪休息。
+- 支持拖动、展开 / 收起、金额遮蔽、透明度和显示偏好记忆。
+- 提供中英文界面、配置命令及代理工具。

package/README.md

@@ -1,13 +1,18 @@
 # 下班计时器 · Offwork Clock
 
-在 DeepSeek Harness 中查看距离下班还有多久，以及本班已经赚了多少钱。
+> **1.1.0**：新增鲸系少女陪伴角色、喝水提醒、免打扰和独立功能卡片。查看 [更新记录](CHANGELOG.md)、[角色与卡片操作](docs/PET-PREVIEW.md) 和 [喝水提醒规则](docs/HYDRATION.md)。
 
-`dsh-offwork` 提供可拖动的页面悬浮窗，支持月薪 / 日薪、跨午夜班次、无薪休息扣除和工资隐藏，工作时可以收起成小条。
+在 DeepSeek Harness 中查看下班倒计时、记录喝水，并通过独立卡片查看本班收入。
 
-[GitHub 仓库](https://github.com/SnowBeatRain/dsh-offwork) · [npm 包](https://www.npmjs.com/package/dsh-offwork) · [问题反馈](https://github.com/SnowBeatRain/dsh-offwork/issues)
+`dsh-offwork` 提供可拖动的页面陪伴角色与计时卡片，支持月薪 / 日薪、跨午夜班次、无薪休息扣除和工资隐藏。角色可关闭，继续使用原有计时小条。
+
+[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)
 
 ## 功能
 
+- **页面陪伴角色**：鲸系少女长裙、礼裙及原创水滴三种外观，支持预览、大小调整、拖动和轻微动作反馈。
+- **喝水提醒**：默认关闭，可设置 5–240 工作分钟间隔；支持手动打卡、稍后提醒、本班暂停和 30/60 分钟免打扰。
+- **独立功能卡片**：右键菜单分别打开倒计时、喝水、收入、外观及作息与薪资；自适应窗口并保护未保存修改。
 - **下班倒计时**：根据作息显示待开工、工作中、休息中、班次完成和休息日状态。
 - **实时工资**：显示本班已赚金额、计薪进度、日薪和有效时薪，支持月薪或日薪输入。
 - **灵活作息**：自定义上下班时间、工作日、时区，以及一段可选的无薪休息；支持跨午夜夜班。
@@ -17,6 +22,22 @@
 - **中文 / English**：提供中英文界面，并响应系统的减少动态效果设置。
 - **代理工具**：可通过 Harness 命令或 `offwork_clock` 工具读取和更新配置。
 
+## 效果预览
+
+以下截图来自隔离的 Harness 测试配置，使用示例数据。
+
+**页面陪伴角色与外观选择**
+
+![鲸系少女陪伴角色](https://raw.githubusercontent.com/SnowBeatRain/dsh-offwork/main/docs/pet-preview/whale-default.png)
+
+![角色选择、大小与透明度设置](https://raw.githubusercontent.com/SnowBeatRain/dsh-offwork/main/docs/pet-preview/whale-appearance.png)
+
+**独立喝水卡片**
+
+<img src="https://raw.githubusercontent.com/SnowBeatRain/dsh-offwork/main/docs/pet-preview/adaptive-water.png" alt="喝水打卡、倒计时和免打扰卡片" width="336">
+
+角色图片随插件加载。当前人物为透明立绘，支持轻微整体反馈；独立眨眼、摆尾、Live2D 和视频动画尚未提供。
+
 ## 运行环境
 
 - DeepSeek Harness：`>=0.2.1-rc.5 <0.3.0-0`。
@@ -28,13 +49,19 @@
 
 ### 从 npm 安装
 
-首次 npm 发布完成后，在 Harness 中使用 `plugin_manager` 的 `install_bundle` 操作，将 `target` 填为 `dsh-offwork`：
+在 Harness 中使用 `plugin_manager` 的 `install_bundle` 操作，将 `target` 填为 `dsh-offwork`：
 
 ```text
 plugin_manager → install_bundle → target: dsh-offwork
 ```
 
-这是 Harness 插件，请通过 Harness 插件管理器安装，以加载 Host 配置和 Web 悬浮窗。
+这是 Harness 插件，请通过 Harness 插件管理器安装，以加载 Host 配置和 Web 悬浮窗。使用命令行管理 Web 配置时，也可以运行：
+
+```sh
+dsh plugin --profile web add dsh-offwork
+```
+
+`web` 是配置名称，使用其他配置时请替换为实际名称。
 
 ### 从 GitHub 安装
 
@@ -67,15 +94,19 @@ plugin_manager → install_bundle → target: /绝对路径/dsh-offwork
 
 ### 常用操作
 
-| 操作 | 使用方式 |
-| --- | --- |
-| 移动悬浮窗 | 按住小条或卡片的空白处拖动 |
-| 微调位置 | 悬浮窗获得键盘焦点后，使用方向键调整；Home 复位 |
-| 展开 / 收起 | 点击上箭头展开详情，点击下箭头收回小条 |
-| 显示 / 隐藏工资 | 点击眼睛图标或「显示工资」 |
-| 修改薪资和作息 | 点击齿轮进入设置 |
-| 调整透明度 | 在设置中调整「背景透明度」，仅影响背景层 |
-| 获取其他页面保存的配置 | 点击「读取最新配置」 |
+| 操作                   | 使用方式                            |
+| ---------------------- | ----------------------------------- |
+| 移动角色               | 按住角色拖动；方向键微调，Home 复位 |
+| 打开喝水卡片           | 左键点击角色                        |
+| 查看下班倒计时         | 点击角色脚下的倒计时                |
+| 打开其他卡片           | 右键角色，或使用 Shift+F10 / 菜单键 |
+| 修改形象、大小与透明度 | 右键 → 外观，预览后点击“应用外观”   |
+| 修改薪资和作息         | 右键 → 作息与薪资                   |
+| 设置喝水间隔           | 喝水卡片 → 提醒设置                 |
+| 使用原计时小条         | 在外观中关闭“宠物模式”并应用        |
+| 显示 / 隐藏工资        | 收入卡片中的眼睛按钮                |
+
+喝水提醒默认关闭；开启后按有效工作时间计时，午休冻结，下班后不提醒。免打扰按自然时间计时。关闭 Harness 页面后不会在后台发送通知。
 
 同一浏览器、同一站点下的多个标签页会同步显示偏好。薪资与作息配置由 Harness Host 共享，其他页面保存后可手动读取最新配置。
 
@@ -83,12 +114,12 @@ plugin_manager → install_bundle → target: /绝对路径/dsh-offwork
 
 所有金额以人民币（CNY）显示，表示按配置估算的税前收入。
 
-| 项目 | 计算方式 |
-| --- | --- |
-| 月薪模式的日薪 | 月薪 ÷ 月计薪天数 |
-| 日薪模式的日薪 | 直接使用填写的日薪 |
-| 有效时薪 | 日薪 ÷ 扣除无薪休息后的班次时长 |
-| 本班已赚 | 日薪 × 已完成的有效计薪比例 |
+| 项目           | 计算方式                        |
+| -------------- | ------------------------------- |
+| 月薪模式的日薪 | 月薪 ÷ 月计薪天数               |
+| 日薪模式的日薪 | 直接使用填写的日薪              |
+| 有效时薪       | 日薪 ÷ 扣除无薪休息后的班次时长 |
+| 本班已赚       | 日薪 × 已完成的有效计薪比例     |
 
 例如，月薪为 10,000 元、月计薪天数为 21.75 天，上班时间为 09:00–18:00，并扣除 12:00–13:00 的无薪休息时，日薪约为 459.77 元，有效时薪约为 57.47 元。
 
@@ -104,7 +135,9 @@ plugin_manager → install_bundle → target: /绝对路径/dsh-offwork
 
 薪资和作息保存在**运行 Harness Host 的机器**上的插件目录 `data.json` 中。如果 Harness 部署在服务器上，配置也保存在该服务器上。保存时采用原子替换，文件权限为 `0600`；`data.json` 已被 Git 忽略，也不会包含在 npm 发布包中。
 
-悬浮窗位置、展开状态、工资隐藏和透明度保存在浏览器本地存储。浏览器禁止存储时，这些偏好仅在本次页面访问期间有效。
+悬浮窗位置、角色、展开状态、工资隐藏和透明度保存在浏览器本地存储。1.1.0 会迁移旧外观偏好并保留原有选择。浏览器禁止存储时，这些偏好仅在本次页面访问期间有效。
+
+喝水设置与当前班次记录保存在浏览器 IndexedDB，不写入 Host 薪资文件或 Harness 会话。同源标签页共享提醒并去重；存储不可用时停止自动提醒，界面提供重试入口。清除浏览器站点数据会清除这些本地记录。
 
 **配置读取和保存通过 Harness 命令执行，返回的配置内容会进入所选会话记录；代理工具的调用及结果也会进入会话记录。** 工资隐藏只控制界面显示，不会清除配置文件或会话中已有的薪资信息。
 
@@ -148,35 +181,37 @@ plugin_manager → install_bundle → target: /绝对路径/dsh-offwork
 
 ## 开发
 
-建议使用 Node.js 22，与仓库 CI 保持一致。当前项目无需安装第三方依赖即可构建和测试。
+建议使用 Node.js 22，与仓库 CI 保持一致。运行时无第三方依赖；开发依赖用于格式检查和 IndexedDB 事务回归测试，通过锁文件固定版本。
 
 ```sh
 git clone https://github.com/SnowBeatRain/dsh-offwork.git
 cd dsh-offwork
-npm run build
-npm test
-npm pack --dry-run
+npm ci --ignore-scripts
+npm run format
+npm run check
 ```
 
-| 文件 | 用途 |
-| --- | --- |
-| `client.source.js` | Web 界面源码 |
-| `clock.js` | 班次、时区和工资计算 |
-| `ui-utils.js` | 界面状态与显示辅助函数 |
-| `client.js` | 构建生成的客户端文件，请通过构建更新 |
-| `index.js` | Host 命令、代理工具、配置校验与保存 |
-| `tests/` | 计算、持久化与界面辅助逻辑测试 |
+`npm run format` 统一源码格式并重新生成客户端；`npm run check` 检查格式、生成物一致性、自动化测试、JavaScript 语法及 npm 打包内容。单独构建使用 `npm run build`，单独运行测试使用 `npm test`。代码约定和人工验证步骤见 [贡献指南](https://github.com/SnowBeatRain/dsh-offwork/blob/main/CONTRIBUTING.md)。
+
+| 文件               | 用途                                 |
+| ------------------ | ------------------------------------ |
+| `client.source.js` | Web 界面源码                         |
+| `clock.js`         | 班次、时区和工资计算                 |
+| `ui-utils.js`      | 界面状态与显示辅助函数               |
+| `client.js`        | 构建生成的客户端文件，请通过构建更新 |
+| `index.js`         | Host 命令、代理工具、配置校验与保存  |
+| `tests/`           | 计算、持久化与界面辅助逻辑测试       |
 
-`npm run build` 将计算模块和界面辅助模块内联到 `client.js`。`npm test` 先检查生成物是否与源码一致，再运行测试，覆盖班次边界、夜班、休息、时区与夏令时、金额精度、磁盘持久化和命令 / 工具行为。浏览器外观、拖动与实际 Harness 安装体验仍需人工检查。
+`npm run build` 将业务和界面模块、角色图片内联到 `client.js`。`npm test` 先检查生成物是否与源码一致，再运行测试，覆盖计薪、时区、持久化、喝水状态机、跨标签事务、导航和布局。1.1.0 的检查及隔离浏览器验证见 [发布验证记录](docs/RELEASE-1.1.0.md)。
 
 ## 发布到 npm（维护者）
 
 包名为 `dsh-offwork`，版本以 `package.json` 为准。发布前确认 npm 账号拥有该包的发布权限，并完成检查：
 
 ```sh
+npm ci --ignore-scripts
 npm run build
-npm test
-npm pack --dry-run
+npm run check
 ```
 
 检查打包清单，确认包含 README、客户端、Host 入口和语言文件，且不包含 `data.json`、`.env` 或其他本地配置。
@@ -188,7 +223,7 @@ npm login
 npm publish --access public
 ```
 
-`npm publish` 会通过 `prepublishOnly` 自动执行构建和测试。npm 不允许覆盖已发布的同名版本，后续发布需先更新版本，例如 `npm version patch` 或 `npm version minor`。
+`npm publish` 会通过 `prepublishOnly` 自动执行构建和完整检查。npm 不允许覆盖已发布的同名版本，后续发布需先更新版本，例如 `npm version patch` 或 `npm version minor`。
 
 ### GitHub Actions 发布
 
@@ -196,16 +231,15 @@ npm publish --access public
 
 1. 在 GitHub 仓库的 **Settings → Secrets and variables → Actions** 中配置 `NPM_TOKEN`，使用具备该包发布权限并满足 npm 发布认证要求的 npm 令牌。GitHub 登录使用的 `ghp_…` 令牌不能用于 npm 发布。
 2. 确认代码已提交，且标签版本与 `package.json` 中的版本完全一致。
-3. 首次发布 `1.0.0` 时执行以下命令；若该版本已发布，请先更新版本并使用对应的新标签：
+3. 通过 `npm version patch`、`npm version minor` 或 `npm version major` 创建版本提交和标签，再推送到 GitHub。例如发布修订版本：
 
 ```sh
-git tag v1.0.0
-git push origin main
-git push origin v1.0.0
+npm version patch
+git push origin main --follow-tags
 ```
 
-后续可通过 `npm version patch` 创建版本提交和标签，再执行 `git push origin main --follow-tags`。在 [Actions 页面](https://github.com/SnowBeatRain/dsh-offwork/actions) 确认发布结果。本地发布和 Actions 发布任选一种，避免重复发布同一版本。
+在 [Actions 页面](https://github.com/SnowBeatRain/dsh-offwork/actions) 确认发布结果。本地发布和 Actions 发布任选一种，避免重复发布同一版本。
 
 ## 许可与反馈
 
-本项目采用 [MIT License](https://github.com/SnowBeatRain/dsh-offwork/blob/main/LICENSE)。欢迎通过 [GitHub Issues](https://github.com/SnowBeatRain/dsh-offwork/issues) 反馈问题或建议；反馈时请说明 Harness 版本、浏览器和复现步骤，薪资信息可使用示例数值代替。
+代码采用 [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

@@ -0,0 +1,7 @@
+# 角色图片来源
+
+whale-dress.webp 与 whale-ornate.webp 来自用户为本插件外观开发提供的两张 PNG 立绘，原始尺寸均为 1024×1536。长裙版本为默认形象，礼裙版本为可选形象。
+
+处理只包括透明边缘的极低透明度噪点清理、按可见人物裁切、等比缩小、透明留白及 WebP 编码，没有重绘角色或拼接身体部位。图片随客户端打包，不依赖外部文件服务或其他宠物插件。
+
+本仓库代码采用 MIT 许可。这两张用户提供图片按提供者的 1.1.0 发布指示随本插件分发，原始图像的权利归相应权利人；代码的 MIT 许可不自动授予图片的独立再分发许可。