# 庄园时间与旅行商人 · 本地评审

版本：0.9.0-preview.3。日期：2026-09-07。源码随仓库同步，供本地开发与试玩；未创建 Release、提交市场或覆盖正式 DSH 存档。

## 怎么试玩

在本地项目目录运行 `npm ci`、`npm run dev`，再打开开发服务提示的地址下的 `/native-preview.html`（默认 `http://127.0.0.1:5173/native-preview.html`）。这不是可直接远程访问的公网试玩站。

1. 工作台点击「第 1 天 06:00」打开日历，查看倍率、来访预告、买入与出售。
2. 「生态快进 6 小时」推进 6 游戏小时，同步改变光照、成长和日期。
3. 「测试商人来访」快进到下次营业时刻。这是测试入口，不加入正式插件。
4. 买入页可测试补给限购；出售页列出成熟收成和报价，二次确认后成交。
5. 「清晨/白天/黄昏/夜晚」只覆盖试玩光照，不修改时间。选回「庄园时间」恢复游戏昼夜。

沙盒每次刷新重新开始独立测试数据；正式 Host 存档则延续游戏日期。不要把沙盒刷新当作正式存档持久化测试。

## 时间规则

- 现实 1 分钟 = 游戏 30 分钟；完整游戏日为现实 48 分钟。首次接入第 1 天 06:00，首个午夜在现实 36 分钟后。
- 电脑小时、时区不直接决定天色，只用经过的真实时间推进。游戏午夜更新天数与手账每日委托。
- 05:00–08:00 清晨、08:00–17:00 白天、17:00–20:00 黄昏，其余夜晚；牧场沿用夜间休息表现。
- 成长按游戏小时计算：普通胡萝卜约 20 游戏小时成熟，鱼约 25 游戏小时成年，小鸡约 33⅓ 游戏小时成年。照料可加速。
- 离线最多补算真实 24 小时，即 30 游戏日；超过部分不反复补算，不导致居民死亡。
- 时钟回退保留最后可信时间，等真实时间追上再推进。首次立即保存、普通轮询每 30 秒检查点、交易即时保存。重启会补算检查点后的间隔。
- Token 奖励与每日硬币上限保持现实日期，不受游戏加速影响。
- 旧存档保留成长、产物、下一茬、剩余加速、钱包与收藏；手账日期换成游戏日，但已领状态不清空。

## 商人与货物

随机日程由存档内固定种子决定：第 2–4 天选一天、第 5–7 天选一天，之后类推。每个分组来一次，不代表任意连续三天都必来。游戏 08:00–20:00 营业，等于现实约 24 分钟。未到访可以看预告，但不能提前交易。

| 货物 | 每次购买 | 每次来访限购 |
| --- | --- | --- |
| 鱼食、肥料、动物饲料 | 4 枚买 3 份 | 各 2 包 |
| 两种轮换普通种子/居民 | 工坊价减 1 枚，最低 1 枚，买 1 份 | 各 1 份 |

普通轮换池为金鱼、胡萝卜、番茄、卷心菜、青菜、小鸡、垂耳兔。稀有/套装奖励不进入商人库存。已拥有居民与种子不可再买；补给空间不足一整包时拒绝，不截断发货。

出售只包含当前未收的成熟蔬菜与鸡蛋，不卖活体，也不卖累计历史。

| 收购产物 | 每份报价 |
| --- | --- |
| 胡萝卜、鸡蛋 | 4 枚 |
| 番茄 | 5 枚 |
| 卷心菜 | 6 枚 |
| 青菜 | 7 枚 |
| 星光南瓜 | 9 枚 |
| 洋葱 | 10 枚 |

- 每次总收购额度 24 份，菜园/牧场共享，整批报价。超额整批拒绝，仍可普通收获或等下次来访。
- 售卖清空对应待收成，按原规则进入下一茬；不会再给普通收获金币。
- Host 校验价格、数量、访次与库存。旧货单、离场、并发冲突、存储失败不形成半笔交易；重复成功请求只返回原回执。
- 账本只保存最近一次交易访次，最多 5 个货品记录，不随天数无限增长。

## 验证与边界

- 干净目录执行 `npm ci`，依赖审计 0 漏洞；类型检查与正式构建通过。
- 单元、组件、Host 重放/并发/重启与迁移测试：67 个文件，756 项通过。
- 覆盖率：语句 88.76%、分支 82.86%、函数 86.45%、行 91.35%。
- 安装包契约：7 项通过。浏览器真实点击回归：30 项通过，覆盖游戏昼夜、成长、交易、离场、限购、重复售卖、桌面窄窗口以及既有老虎机流程。
- 新增窄窗口首排购买按钮完全可见的断言；不是仅确认元素存在于页面中。
- 本地试玩地址返回 HTTP 200。截图保存在 `artifacts/world-merchant/`。
- 干净构建生成 `dsh-slot-homestead-0.9.0-preview.3.tgz`，项目根目录与 `artifacts/world-merchant/` 的副本 SHA-256 一致：

  `D630C8D57A044E74BCFE29B7388ECE29D68DA5759E86286890C8350B7AD96C44`

未安装到正式 DSH；真实桌面端的安装、关闭再启动与人工美术评审仍待后续确认。

本轮先完成商人的到访、预告与交易界面，未新增独立人物模型或重绘原桌面，沿用现有原创居民图集。

既有兔子/羊驼繁殖算法在长离线与细粒度在线模拟下可能有代际速度差异，容量仍受上限约束。本轮未改写为严格事件时刻积分。