# Changelog

本文件记录会影响安装、兼容性、存档或玩法的改动。版本号遵循语义化版本。

## [Unreleased]

### 0.9.0-preview.3 · 庄园时间与旅行商人（未发布）

- 独立时钟从第 1 天 06:00 开始，现实 1 分钟对应 30 游戏分钟；昼夜、生态成长与手账每日委托跟随游戏时间。
- 旧存档保留居民、钱包、收成、预约和已领手账奖励。重启延续日期；时钟回退不倒退，离线最多补算现实 24 小时。
- 时钟首次立即保存、平时每 30 秒检查点，交易仍即时原子保存；Token 每日限额保持现实日期。
- 旅行商人在每 3 日分组中随机选择一天，08:00–20:00 营业；三种补给、两种轮换普通居民/种子，库存不会因刷新改变。
- 成熟蔬菜/鸡蛋整批出售，普通收获价加 1 枚/份，每访收购最多 24 份。不得二次出售历史产物，不出售活体居民。
- 按需日历包括到访预告、买入、出售确认与缺货/离场提示；沙盒新增「测试商人来访」。
- 此版本仅同步 GitHub 源码，未安装到正式 DSH、未创建 Release 或提交插件市场。

### 0.9.0-preview.2 · 细节与交互评审版（未发布）

- 工坊新增全部、摆件、居民、补给筛选与清空搜索；12 种居民使用原生像素图集预览。
- 点击居民图片可展开成长图鉴，手动对比鱼类/作物 4 阶段、动物 3 阶段，明确区分图示与真实养成进度。
- 精修青年/成年鸡、兔、羊驼的原生 SVG 羽毛、毛绒与脚爪；保留幼年分帧、轮廓和透明区域。
- 种植手账展示田地的真实生长外观，并可直接收获、撤销下一茬；撤销只退回 1 份肥料，不损失当前作物。
- 新增基于已接受状态的照料、成长、收获、购买、领奖反馈；不把点击意图或补满测试资源当作成功操作。
- 改善窄网页工坊布局、面板开合、按钮反馈与减少动画模式；不改变统一木桌、月亮和原有场景构图。
- 未生成或采用新的位图素材；图片生成服务连接失败，保留已有原创图集，不调用额外付费接口。
- 本地验证完成后仍须维护者确认；未安装到正式 DSH、未上传或发布。

### 0.9.0-preview.1 · 本地评审版（未发布）

- 新增庄园手账：3 项每日委托、5 项长期足迹、6 个庄园称号；奖励由 Host 校验、去重并持久化。
- 新增六块田的自由播种和下一茬计划：永久解锁种子，每次播种/换种消耗 1 份肥料；成长与待收获产物不会被覆盖。
- 手账采用按需展开的像素书本入口；工坊增加搜索，养成抽屉改善信息层次、焦点和成长时间提示。
- 细化项目原创 SVG 图集的鱼鳞、毛羽与叶脉，保留轮廓、生长分帧、统一木桌和夜间光照。
- 本地预览增加清晨/白天/黄昏/夜晚对比，原生小窗预览与网页样式分离。
- 新玩法覆盖旧存档读取、重复领取、系统日期回退、12 周活动有界性、并发播种和真实页面全流程。
- 本轮未修改正式 DSH profile，也未推送 GitHub 或提交市场。待维护者确认后再发布。

## [0.8.0-beta.2] - 2026-09-02

- 将正式名称统一为「老虎机庄园｜桌面像素生态养成」。
- 将 GitHub 仓库、npm 包名和新发布产物统一为 `dsh-slot-homestead`。
- 保留旧 Cordis row ID、Host 存储 domain 和 API 路径；Client loader 按 DSH 要求改用新
  包名，原有钱包、收藏与生态存档仍会继续读取。
- 明确 `0.8.0-beta.1` 升级流程：先移除旧包，再安装新包，避免两个包同时挂载同一存档与路由。
- 增加真实 DSH 改名升级门禁：由 beta.1 写入状态，卸载旧包并安装 beta.2 后验证存档继续存在。

## [0.8.0-beta.1] - 2026-09-02

- 增加固定老虎机与鱼缸、种植园、牧场三场景轮换的共享桌面生态。
- 重新排列为“左侧养成场景、右侧固定老虎机”，并将鱼、水草、气泡、作物、小鸡、兔子和羊驼拆成独立像素动画层。
- 修正生态素材坐标空间与桌面锚点，使左右桌面无缝连接，并让胡萝卜等动态居民落在对应格子的视觉中心。
- 修正鱼与羊驼倒退、动物蒙版缺损和作物夹带场景杂物的问题，并重新整理六块田的作物比例与位置。
- 增加鱼、种子、动物、鱼食、肥料与动物饲料，并让像素工坊统一使用老虎机钱包购买。
- 拉杆现在可以掉落生态居民或用品；重复居民按品质自动折算为硬币。
- 投喂、施肥与喂食会推进成长，完成一轮后增加生态心愿、收获次数并返还少量硬币。
- 实际工作奖励会同步推进三个养成场景；离线和用品不足只暂停成长，不会造成损失。
- Host 存档升级到 v4，并为旧存档自动填充安全的生态默认值。

- 补齐 GitHub 仓库元数据、贡献指南、安全政策和发布展示图。
- 让真实 DSH 冒烟测试从 `package.json` 读取当前安装包版本，避免 CI 验证旧包。
- 将项目依赖管理统一为锁定的 `npm@11.9.0`，并增加干净 checkout 的
  `prepack`/发布候选验证链。
- 增加 GitHub 预发布工作流、SHA-256 校验文件、素材来源说明和发布前权利确认门禁。
- 清理本机绝对路径，并排除本地 QA 截图、生成中间件、缓存和旧打包产物。

## 0.7.0 - 2026-08-30

- 增加结算结果卡、一键摆放、单一当前目标和三组桌面收藏组合效果。
- 将收藏品商店调整为像素工坊：普通品可制作，稀有与套装品通过拉杆或保底发现。
- 提高桌面伴生窗中的按钮、面板标题和收藏名称字号，并补齐新界面的无障碍进度语义。

## 0.6.0 - 2026-08-29

### Added

- 增加随 DSH Desktop 启动的透明桌面伴生窗。
- 支持窗口拖动、四边收起、边缘标签展开和 0.75 至 1.60 倍缩放。
- 增加 12 格收藏盒、桌面圆台吸附、收藏品换位和回收操作。
- 增加基于权威会话 usage 的 Token 能量与硬币奖励。
- 增加真实 DSH 安装、重启、持久化和卸载冒烟测试。

### Changed

- 将收藏品放置位置迁移到稳定桌位 ID，旧存档会按原顺序迁移。
- 按素材可见像素边界校正收藏品的比例、中心线和底边。
- 插件构建产物增加独立 companion 页面、脚本和声明文件。

### Fixed

- 修复随机 loopback 端口变化后伴生窗无法继续读取存档的问题。
- 修复大 turn 的 Token 奖励被截断、重复计数或跨重启丢失的问题。
- 修复发布检查可能读取旧版本 tgz 的问题。

## 0.2.0 - 2026-08-27

- 交付首个可复现构建的 DSH 插件包。
- 增加 Host 持久化、每日硬币、老虎机动画、收藏系统和安装包契约测试。

[Unreleased]: https://github.com/YuiKiZJ2026/dsh-slot-homestead/compare/v0.8.0-beta.2...HEAD
[0.8.0-beta.2]: https://github.com/YuiKiZJ2026/dsh-slot-homestead/compare/v0.8.0-beta.1...v0.8.0-beta.2
[0.8.0-beta.1]: https://github.com/YuiKiZJ2026/dsh-slot-homestead/releases/tag/v0.8.0-beta.1