dsh-offwork 1.1.1 → 1.2.2

package/CHANGELOG.md

@@ -1,5 +1,44 @@
 # 更新记录
 
+## 1.2.2 — 页面收拢与信息层级
+
+- 下班卡片移除重复的刷新和设置文字入口，改用页头设置按钮；只保留计时、班次详情、收尾和收入明细。
+- 外观页将“显示与动作”折叠，缩小预览高度；主题、卡片尺寸和自定义人物仍统一一次应用。
+- 设置页把作息、喝水、备份做成清晰入口，提醒和免打扰集中展示，测试与代理权限移入高级设置。
+- 修正设置入口箭头被读屏当作按钮名称的问题，并恢复更清楚的“全部免打扰”按钮样式。
+- 空白的“喝了一杯”常驻按钮已移除，只有喝水到期时才显示；平时从喝水卡片记录。
+- 187项自动化测试及浏览器交互回归通过。
+
+## 1.2.1 — 交互收拢与卡片联动
+
+- 移除独立六页搭子菜单，保留人物旁的原有卡片和上下文菜单；喝水、抽烟、下班时间直接点击进入对应卡片。
+- 自定义计时并入抽烟计时卡片，运行中的计时显示在人物小卡片下方；不再增加第二套计时入口。
+- 下班收尾挂到下班卡片，设置和备份收进设置卡片；返回路径按所属卡片处理，避免卡片之间循环跳转。
+- 外观将内置人物、主题、卡片缩放和自定义图片合并为一个编辑器，统一使用“应用外观”保存，“取消”保留原配置。
+- 到点提醒沿用人物旁的卡片位置；稍后后在原计时位置显示剩余等待时间。
+- 改善触屏按钮尺寸、深色主题和320/390/640宽度下的布局。
+- 187项自动化测试及实际浏览器交互验证通过。
+
+- 新增统一到点提醒、明确的关闭/稍后/重开操作、可选声音和后台通知；角色与卡片均提供“搭子菜单”。
+- 增加具名独立计时、统一免打扰、提示测试与跨标签协调。
+- 界面设置脱离会话命令；薪资迁移到宿主稳定存储，旧文件保留，代理访问默认关闭并可显式开启。
+- 新增下班收尾、明日一件事、真实操作记录、草稿冲突保护和最多2分钟的输入/会话运行暂缓。
+- 支持本地图片导入、裁切预览、主题与卡片缩放；沿用原人物选择与动态资源。
+- 增加浏览器与薪资分离备份、恢复预览、冲突检测和持久化的恢复前备份。
+- 使用已确认的斜对角人物/倒计时Logo。真实用户试用尚未开展，详见 [使用与验证说明](docs/RELEASE-1.2.0.md)。
+
+## 1.1.2 — 2026-11-07
+
+- 喝水提醒改为全天自然时间：午休、下班和休息日继续运行，不再依赖薪资、作息或会话；“稍后”按自然时间10分钟处理，计数不随班次清零。
+- 饮水数据迁移至schema3及IndexedDB版本2，事务保留原开关、间隔、次数、暂停、免打扰与近期操作；保留旧记录快照，隔离旧客户端写入。升级后需刷新所有已打开的Harness标签页。
+- 新增独立喝水与抽烟倒计时。抽烟计时手动开始，支持暂停/继续、重新计时、停止、刷新恢复和多标签同步；角色脚下统一展示三项时间。
+- 非宠物模式重做为224×94紧凑卡片，状态与计时横排，水滴/香烟图标并列，收入默认收纳到眼睛入口。下班、休息、未配置和读取失败显示明确状态。
+- 简化喝水、提醒设置、计时、收入、外观和作息薪资页：去除嵌套灰框与重复说明，突出主要操作，低频选项折叠，保存入口在窄屏仍可到达。
+- 外观页增加独立动作试播。试播不记录喝水、不修改已保存角色；取消、切换、后台和减少动态效果均清理播放。
+- 人物视频改为同源按需加载，支持内容指纹缓存、ETag、HEAD和Range；客户端脚本约0.9MB，安装包约8MiB。改善动作衔接、透明首帧检测和失败重试。
+- 修复初次读取时角色消失、到点提示入口、编辑器草稿恢复和非宠物卡片尺寸观察等问题；自动提醒不抢输入焦点，刷新逾期不重复弹卡。
+- 完整项目检查171项通过，并完成实际安装包的界面、迁移、全天计时、多标签及媒体验证。计薪、工资隐私和既有角色偏好继续保留。
+
 ## 1.1.1 — 2026-11-05
 
 - 调整角色入口：左键点击及 Enter/Space 只触发回应，倒计时和到期徽标作为信息展示；主动打开功能卡片统一使用右键菜单，保留自动到期提醒。

package/README.md

@@ -1,20 +1,34 @@
 # 下班计时器 · Offwork Clock
 
-> **1.1.1**：新增两套透明视频角色和交互动作；左键只与角色互动，功能卡片统一从右键菜单打开。查看 [更新记录](CHANGELOG.md)、[角色与卡片操作](docs/PET-PREVIEW.md) 和 [发布验证](docs/RELEASE-1.1.1.md)。
+> **1.2.2（本地候选版）**：收拢提醒、计时、收尾和外观交互，直接接入人物脚下与原有卡片。喝水和抽烟时间可直接点击，自定义计时并入抽烟卡片，外观统一一次应用。当前尚未发布到 npm。详见 [1.2.2 使用与验证](docs/RELEASE-1.2.2.md)。
+>
+> 1.1.2 的全天喝水、独立计时、动作试播和按需视频继续保留。
 
-在 DeepSeek Harness 中查看下班倒计时、记录喝水，并通过独立卡片查看本班收入。
+在 DeepSeek Harness 中查看下班倒计时、记录喝水，通过独立卡片查看收入，也可以使用手动开始的抽烟倒计时。角色模式把三项计时汇总在脚下；非宠物模式默认使用224×94像素的小卡片。
+
+喝水按自然时间运行，午休、下班和休息日均可提醒，不依赖薪资配置或会话。喝水、提醒设置、计时、收入、外观与薪资页使用统一的简洁布局；常用操作直接在人物和原有卡片上完成，低频选项按需展开。
+
+**升级提示：请刷新所有已打开的Harness标签页。** 喝水数据会迁移并保留开关、间隔、次数和暂停状态；旧页面不能覆盖新格式记录。详见 [喝水规则与迁移](docs/HYDRATION.md)。
+
+外观页可试播已有动作，不记录喝水、不更换已保存角色；视频按实际播放读取并复用缓存。正常计时到点会自动提示，刷新时已逾期先显示提示入口；收起不打卡、不延期。
 
 提供 **长裙动态** 和 **短裙动态**：长裙支持点击挥手、打卡喝茶，短裙增加眨眼摆尾待机循环；支持动作开关、后台暂停和静态回退。在“右键 → 外观 → 角色形象”中预览并应用。
 
-`dsh-offwork` 提供可拖动的页面陪伴角色与计时卡片，支持月薪 / 日薪、跨午夜班次、无薪休息扣除和工资隐藏。角色可关闭，继续使用原有计时小条。
+`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)
 
 ## 功能
 
+- **统一提醒**：抽烟、喝水、自定义计时与下班收尾使用同一提醒投递层；关闭不记完成，稍后10分钟，多标签页协调显示。声音和后台浏览器通知默认关闭。
+- **下班收尾**：可选的下班前提醒、今天完成的一行记录、明日第一件事；结束今天不停止代理任务或全天喝水。
+- **自定义计时**：最多8个具名计时，各自开始、暂停、继续、停止和重开。
+- **自定义外观与备份**：PNG/WebP/JPEG本地导入、裁切预览、主题及独立卡片缩放；浏览器记录和薪资分别导出，恢复前保存回退备份。
 - **页面陪伴角色**：两套动态视频形象、长裙/礼裙两款静态立绘及原创水滴，支持预览、大小调整、拖动和动作反馈。
-- **喝水提醒**：默认关闭，可设置 5–240 工作分钟间隔；支持手动打卡、稍后提醒、本班暂停和 30/60 分钟免打扰。
-- **独立功能卡片**：右键菜单分别打开倒计时、喝水、收入、外观及作息与薪资；自适应窗口并保护未保存修改。
+- **喝水提醒**：默认关闭，可设置5–240自然分钟间隔；午休、下班和休息日均可提醒，支持随时打卡、稍后10分钟、手动暂停和30/60分钟免打扰。
+- **独立功能卡片**：下班、喝水、抽烟和收入继续使用原有卡片；自定义计时并入抽烟计时卡片，外观与设置从上下文菜单进入；自适应窗口并保护未保存修改。
+- **抽烟倒计时**：默认60分钟，手动开始，可暂停/继续、重新计时或停止；刷新和多标签页同步进度。
+- **动作试播与按需加载**：在外观页查看已有动作，只有应用才保存形象，试播不增加喝水记录。
 - **下班倒计时**：根据作息显示待开工、工作中、休息中、班次完成和休息日状态。
 - **实时工资**：显示本班已赚金额、计薪进度、日薪和有效时薪，支持月薪或日薪输入。
 - **灵活作息**：自定义上下班时间、工作日、时区，以及一段可选的无薪休息；支持跨午夜夜班。
@@ -22,27 +36,32 @@
 - **工资隐藏**：默认遮住金额，支持一键显示 / 隐藏；设置中的薪资输入和折算预览也会同步遮蔽。
 - **外观与记忆**：背景透明度可在 30%–100% 之间调整，位置、展开状态和显示偏好可在刷新后恢复。
 - **中文 / English**：提供中英文界面，并响应系统的减少动态效果设置。
+- **页面入口**：点击人物脚下的下班、喝水或抽烟时间进入对应卡片；喝水提醒到期时才在人物卡片上显示“喝了一杯”，平时手动记录从喝水卡片完成，右侧“…”打开上下文菜单。
 - **代理工具**：可通过 Harness 命令或 `offwork_clock` 工具读取和更新配置。
 
 ## 效果预览
 
 以下截图来自隔离的 Harness 测试配置，使用示例数据。
 
-**页面陪伴角色与外观选择**
+**紧凑小卡片与简洁详情页**
 
-![鲸系少女陪伴角色](https://raw.githubusercontent.com/SnowBeatRain/dsh-offwork/main/docs/pet-preview/whale-default.png)
+<img src="https://raw.githubusercontent.com/SnowBeatRain/dsh-offwork/main/docs/design-review/working.png" alt="非宠物模式的紧凑计时卡片" width="224">
 
-![角色选择、大小与透明度设置](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/detail-pages/water.png" alt="喝水倒计时与打卡" width="320">
 
-**独立喝水卡片**
+<img src="https://raw.githubusercontent.com/SnowBeatRain/dsh-offwork/main/docs/detail-pages/settings.png" alt="全天自然时间提醒设置" width="360">
 
-<img src="https://raw.githubusercontent.com/SnowBeatRain/dsh-offwork/main/docs/pet-preview/adaptive-water.png" alt="喝水打卡、倒计时和免打扰卡片" width="336">
+**角色与外观选择**
 
-角色图片和视频随插件加载。短裙支持眨眼摆尾循环待机，两套动态形象均支持挥手和喝茶。内置视频合计约7MiB，安装包约15MiB；关闭动作控制播放，不会移除内置资源。长裙独立待机视频、Live2D和外部模型包导入尚未提供。
+<img src="https://raw.githubusercontent.com/SnowBeatRain/dsh-offwork/main/docs/countdown-preview/timer-layout-detail.png" alt="页面角色及三项计时概览" width="196">
+
+<img src="https://raw.githubusercontent.com/SnowBeatRain/dsh-offwork/main/docs/detail-pages/appearance.png" alt="角色选择、预览与外观设置" width="340">
+
+角色图片随客户端加载，视频素材随插件安装并从Harness Host按需读取。短裙支持眨眼摆尾循环待机，两套动态形象均支持挥手和喝茶。本版客户端脚本约0.9MB、安装包约8MiB，相比1.1.1约15MiB的安装包减少了重复嵌入资源；五段视频原素材合计仍约7MiB。长裙独立待机视频、Live2D和外部模型包导入尚未提供。
 
 ## 运行环境
 
-- DeepSeek Harness：`>=0.2.1-rc.5 <0.3.0-0`。
+- DeepSeek Harness：`>=0.2.2-rc.1 <0.3.0-0`（1.2.2使用宿主认证接口，当前在0.2.2-rc.1验证）。
 - 使用 Harness 的 Web 界面，安装后刷新页面以加载客户端。
 
 悬浮窗显示在 Harness 页面内，切换到其他应用后不会作为桌面置顶窗口显示。
@@ -87,12 +106,13 @@ plugin_manager → install_bundle → target: /绝对路径/dsh-offwork
 
 ## 首次使用
 
-1. 安装后刷新 Harness 页面，打开或创建一个会话。
-2. 在首次设置引导中选择月薪或日薪，填写税前薪资；月薪模式还需填写月计薪天数。
-3. 设置上下班时间、班次开始日和时区；如有无薪休息，启用扣除并填写休息时段。
-4. 点击「保存」开始计时。引导中的初始数值仅为示例，保存前不会作为你的实际收入展示。
+1. 安装或更新后刷新所有Harness标签页。
+2. 如需下班计时和收入，从人物脚下或小卡片的下班时间进入；作息与薪资入口位于上下文菜单。无需先建立会话。
+3. 填写月薪或日薪、上下班时间、工作日、时区及可选无薪休息，保存后开始计薪。初始示例数值不会作为已配置收入展示。
+4. 喝水提醒可独立使用：进入喝水页，点击右上角提醒设置，开启并保存间隔；无需先配置薪资。
+5. 抽烟计时需手动开始；外观页可试播已有动作，点击“应用”才保存角色选择。
 
-如需指定配置读写结果记入哪个会话，可在设置的「高级设置 → 操作记录会话」中选择。这个选择不影响工资计算。
+界面配置通过同源插件接口直接保存，不再通过会话命令。代理工具默认不可读取或修改薪资；如有需要，在上下文菜单的设置中显式开启代理访问。
 
 ### 常用操作
 
@@ -105,11 +125,11 @@ plugin_manager → install_bundle → target: /绝对路径/dsh-offwork
 | 打开其他卡片           | 右键角色，或使用 Shift+F10 / 菜单键       |
 | 修改形象、大小与透明度 | 右键 → 外观，预览后点击“应用外观”         |
 | 修改薪资和作息         | 右键 → 作息与薪资                         |
-| 设置喝水间隔           | 喝水卡片 → 提醒设置                       |
-| 使用原计时小条         | 在外观中关闭“宠物模式”并应用              |
+| 设置喝水间隔           | 喝水页右上角 → 提醒设置                   |
+| 使用非宠物概览         | 在外观中关闭“宠物模式”并应用              |
 | 显示 / 隐藏工资        | 收入卡片中的眼睛按钮                      |
 
-喝水提醒默认关闭；开启后按有效工作时间计时，午休冻结，下班后不提醒。免打扰按自然时间计时。关闭 Harness 页面后不会在后台发送通知。
+喝水提醒默认关闭；开启后按自然时间计时，不受工作、午休或休息日限制。修改作息或薪资不会重排提醒；暂停需要手动恢复，免打扰到期自动结束。需要保持Harness页面打开才能显示页面内提醒；关闭后重新打开会保留截止时间和一个待处理事件，不补发多条。
 
 同一浏览器、同一站点下的多个标签页会同步显示偏好。薪资与作息配置由 Harness Host 共享，其他页面保存后可手动读取最新配置。
 
@@ -136,13 +156,15 @@ plugin_manager → install_bundle → target: /绝对路径/dsh-offwork
 
 ## 数据与隐私
 
-薪资和作息保存在**运行 Harness Host 的机器**上的插件目录 `data.json` 中。如果 Harness 部署在服务器上，配置也保存在该服务器上。保存时采用原子替换，文件权限为 `0600`；`data.json` 已被 Git 忽略，也不会包含在 npm 发布包中。
+薪资和作息保存在**运行 Harness Host 的机器**上的 `$DSH_HOME/storages/dsh-offwork/settings.json` 中。未设置 `DSH_HOME` 时使用 `~/.dsh`。保存采用原子替换，文件权限为 `0600`；首次读取时，从旧插件目录 `data.json` 校验迁移，保留原文件。现有稳定配置不会被旧文件覆盖；损坏文件不会被默认值重置。
+
+悬浮窗位置、角色、展开状态、工资隐藏和透明度保存在浏览器本地存储。1.1.2继续使用v7外观偏好并迁移保留旧版选择。浏览器禁止存储时，这些偏好仅在本次页面访问期间有效。
 
-悬浮窗位置、角色、展开状态、工资隐藏和透明度保存在浏览器本地存储。1.1.1 使用v7外观偏好并迁移保留旧版选择。浏览器禁止存储时，这些偏好仅在本次页面访问期间有效。
+抽烟倒计时另存在浏览器 IndexedDB，按自然时间计算，与喝水和Host薪资独立。多个标签页同步，存储失败时可重试恢复；清除站点数据会清除此计时。
 
-喝水设置与当前班次记录保存在浏览器 IndexedDB，不写入 Host 薪资文件或 Harness 会话。同源标签页共享提醒并去重；存储不可用时停止自动提醒，界面提供重试入口。清除浏览器站点数据会清除这些本地记录。
+喝水设置与饮水计数保存在浏览器 IndexedDB，不写入 Host 薪资文件或 Harness 会话。计数不再随班次或日期自动清零；同源标签页共享提醒并去重。存储不可用时停止自动提醒，界面提供重试入口。schema3迁移在事务中完成并保留原记录快照，旧标签页需刷新。清除浏览器站点数据会清除这些本地记录。
 
-**配置读取和保存通过 Harness 命令执行，返回的配置内容会进入所选会话记录；代理工具的调用及结果也会进入会话记录。** 工资隐藏只控制界面显示，不会清除配置文件或会话中已有的薪资信息。
+**界面读写不进入会话记录。** 显式执行 `/offwork-clock` 命令仍会返回配置；开启代理访问后的工具调用及结果也可能进入会话记录。工资隐藏只控制界面显示，不会删除历史记录。浏览器备份包含个人笔记与图片，薪资需单独导出，均由用户自行保管。
 
 ## 命令与代理工具
 
@@ -153,7 +175,7 @@ plugin_manager → install_bundle → target: /绝对路径/dsh-offwork
 /offwork-clock set {"monthlySalary":10000}
 ```
 
-代理可调用 `offwork_clock` 工具。读取配置的参数为：
+代理访问默认关闭。在上下文菜单的设置中显式开启后，代理可调用 `offwork_clock` 工具。读取配置的参数为：
 
 ```json
 { "action": "get" }
@@ -205,7 +227,7 @@ npm run check
 | `index.js`         | Host 命令、代理工具、配置校验与保存  |
 | `tests/`           | 计算、持久化与界面辅助逻辑测试       |
 
-`npm run build` 将业务和界面模块、角色图片内联到 `client.js`。`npm test` 先检查生成物是否与源码一致，再运行测试，覆盖计薪、时区、持久化、喝水状态机、跨标签事务、导航和布局。1.1.1 的检查及隔离浏览器验证见 [发布验证记录](docs/RELEASE-1.1.1.md)。
+`npm run build` 将业务和界面模块、角色图片内联到 `client.js`。`npm test` 先检查生成物是否与源码一致，再运行测试，覆盖计薪、时区、持久化、喝水状态机、跨标签事务、导航和布局。1.1.2的检查及隔离浏览器验证见 [发布验证记录](docs/RELEASE-1.1.2.md)。
 
 ## 发布到 npm（维护者）
 

package/ROADMAP.md

@@ -0,0 +1,70 @@
+# 迭代路线图
+
+项目专注 DeepSeek Harness 页面内的陪伴角色、计时、提醒和日常记录。未来功能与版本号是计划，不表示当前版本已经支持。
+
+## 1.2.0：四阶段本地候选实现
+
+已按市场调研完成提醒与入口、统一数据与计时、下班收尾、可导入外观四个阶段的本地候选功能。详见 [1.2.0使用与验证](docs/RELEASE-1.2.0.md)。尚未发布到npm；两周用户试用与留存验证仍待实际使用，不能以自动化通过替代。
+
+后续优先根据提醒打扰程度、收尾跨周使用和备份恢复反馈修正体验。复杂任务管理、养成等级、3D/Live2D平台、云账号和独立桌面客户端降低优先级。
+
+## 1.1.2：全天提醒与轻量界面
+
+- 喝水改为自然时间，不依赖工作日、午休、薪资或会话；原子迁移旧记录并隔离旧客户端。
+- 独立喝水/抽烟计时、统一角色计时概览和224×94非宠物小卡片。
+- 简洁详情页、清楚的状态、低频选项折叠、保存和草稿保护。
+- 外观动作试播、同源按需视频和缓存、更平稳的动作衔接与首帧检测。
+
+验证与升级说明见 [1.1.2发布记录](docs/RELEASE-1.1.2.md)。
+
+## 1.1.1：交互与动态形象
+
+- 左键和键盘激活仅与角色互动，计时/到期徽标只显示信息；主动打开功能卡片统一从右键菜单进入。
+- 长裙和短裙两套透明视频形象；短裙具有循环待机、挥手和喝茶，长裙具有挥手和喝茶。
+- 独立动作控制、实际透明通道检测、后台暂停、减少动态效果、失败回退与v7外观偏好兼容迁移。
+
+来源与限制见 [角色说明](docs/PET-PREVIEW.md)，发布验证见 [1.1.1 发布记录](docs/RELEASE-1.1.1.md)。
+
+## 1.0系列与1.1.0基线
+
+- 独立页面宠物与右键菜单，不依赖其他宠物插件，不做系统桌面客户端。
+- 鲸系少女长裙、礼裙与原创水滴三种形象；预览、应用、取消、拖动、缩放与减少动态效果。
+- 倒计时、喝水、收入、外观、作息与薪资独立卡片；自适应布局、键盘操作和草稿保护。
+- 喝水提醒、手动打卡、稍后提醒、本班暂停/恢复、30/60 分钟免打扰和多标签页去重。
+- 原有计薪、夜班、时区、无薪休息、金额隐藏和 Host 配置继续保留。
+
+操作与验证见 [角色及卡片说明](docs/PET-PREVIEW.md)、[喝水规则](docs/HYDRATION.md) 和 [1.1.0 发布记录](docs/RELEASE-1.1.0.md)。原先规划的 1.0.2 已按用户决定并入 1.1.0。
+
+## 已完成体验优化
+
+外观动作试播、按动作请求视频和缓存复用、加载期间保持上一画面，以及窄屏预览对齐已纳入1.1.2。试播不写入喝水记录或已保存外观，说明见 [体验优化](docs/EXPERIENCE-PREVIEW.md)。
+
+喝水已按用户最新要求改为全天自然时间提醒，不受工作日或午休限制，计数保留；旧数据迁移见 [喝水规则](docs/HYDRATION.md)。
+
+## 当前素材状态
+
+两套用户视频已完成本地抠像和播放器接入。原片裁切造成的缺失未重绘；长裙独立循环待机素材仍待提供。
+
+## 后续候选
+
+| 方向           | 计划内容                                                 | 完成标志                                             |
+| -------------- | -------------------------------------------------------- | ---------------------------------------------------- |
+| 人物动画       | 为自有角色制作待机、点击回应和喝水动作；支持透明动画资源 | 动作稳定衔接、可关闭、后台暂停，有静态回退           |
+| 远眺与起身休息 | 间隔、短休息倒计时、完成、跳过和延期                     | 多标签页去重，多种提醒不同时打扰                     |
+| 打工心情       | 每班主动记录、备注、最近七天回顾、修改删除与导出         | 不自动发送模型，保留期限明确，存储异常可恢复         |
+| 下班收尾       | 明日事项、计薪快照与今日打卡小结                         | 只汇总真实记录，重复进入不重复创建，分享遵守金额隐藏 |
+| 更多外观       | 外部模型资源导入与其他渲染器                             | 格式和素材来源明确，加载失败可回退                   |
+
+1.1.0的人物使用透明立绘与轻微整体反馈；1.1.1加入两套内置动作及短裙循环待机。长裙循环待机、Live2D和外部模型包导入尚未完成。
+
+## 产品原则
+
+- 功能通过独立卡片按需展开，提醒默认关闭，允许稍后、暂停和免打扰。
+- 计薪继续遵循班次和作息；喝水与抽烟按自然时间，各自计时不互相重排，也不改变工资计算。
+- 保持工资隐藏偏好。薪资保存在 Harness Host，喝水记录与界面偏好保存在浏览器。
+- 自动提醒不抢输入焦点，角色动作可关闭，并响应系统减少动态设置。
+- 每次交付可独立使用且经过验证的功能，再推进下一项。
+
+## 历史基线
+
+1.0.0 首次提供计时与收入悬浮窗；1.0.1 完善规范、发布检查、透明度、辅助名称及展示素材。历史市场申请与验证见 [1.0.1 发布记录](docs/RELEASE-1.0.1.md)。市场收录状态以目录维护者实际结果为准。