dsh-zoo 1.5.0 → 1.6.1

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.
package/README.md CHANGED
@@ -70,7 +70,7 @@ node scripts/uninstall.mjs
70
70
  | 带派(捎东西) | 出门前捎一张字条或一个文件;背包、送达回执、礼物卡都已落地。 |
71
71
  | 串门记录 | 双方各留一条记录,保留最近 200 条。 |
72
72
  | 农场 | 4 块起步、最多 50 块;10 种作物;离线也长,待机攒露水。 |
73
- | 四季与节日 | 一天一季、四天一轮;四季作物、每日节日、换季枯萎和秋天的熊獾。 |
73
+ | 四季与节日 | 一天一季、四天一轮;四季作物、每日节日、换季枯萎,以及随机/固定 15:00 出现 3 小时的四季来客。 |
74
74
  | 交易所 | 本机做市,买种子、卖作物;邻居行情汇总成局域网指数。 |
75
75
  | 偷菜与帮忙 | 去邻居家偷成熟作物,或给生长中的地浇水;守卫与每日上限随农场规模放大。 |
76
76
  | 看田与偷菜行程 | 在家只读地看邻居的地块与守卫,不用放行;点「派它去偷」让它自己跑一趟,回来作物已在仓库。 |
@@ -109,7 +109,7 @@ node scripts/uninstall.mjs
109
109
  | `settings.json` | 入站串门、自动出门两个开关 |
110
110
  | `visits.json` | 串门记录,最多 200 条 |
111
111
  | `farm.json` | 农场:地块、仓库、硬币、露水、挂牌和农场日志 |
112
- | `season.json` | 当前节日进度/领取、熊獾来客状态;可删,删了重建 |
112
+ | `season.json` | 当前节日进度/领取、四季来客的随机窗口与结算状态;可删,删了重建 |
113
113
  | `market.json` | 本机交易所:价格、成交历史、局域网指数 |
114
114
  | `contracts.json` | 雇佣合同(`outgoing` 我是雇主 / `incoming` 我是雇工) |
115
115
  | `backpack.json` | 待捎礼物,最多 2 件 |
@@ -243,13 +243,13 @@ curl -s -X POST http://127.0.0.1:<DSH端口>/dsh-zoo/self-state \
243
243
  30 硬币、2 颗小番茄种子、0 露水;第一次打开就能直接种。完整操作在农场小窗里(页签:农场 / 交易所 / 雇工 /
244
244
  记录);桌面上没有地块条,右键「农场」唤醒,再点一次或 ×/Esc 关闭。
245
245
  小窗是奶白底、祖母绿/琥珀点缀的卡片农场:顶部有「我的农场 / X/Y 已种植」、季节日历、
246
- 硬币/露水胶囊和 ×;日历下面是今天的节日卡(进度、奖励、领取),秋天还会多一张「熊獾」来客卡。
246
+ 硬币/露水胶囊和 ×;日历下面是今天的节日卡(进度、奖励、领取),来客在随机 3 小时窗口内会多一张来客卡。
247
247
  地块卡分空地(点一下开播种弹窗)、生长中(倒计时 + 进度 + 浇水/施肥)、成熟
248
248
  (轻微弹跳 + 收获/施肥)和枯萎(点一下重种);农场页还有「一键种满 / 一键收割」,
249
249
  底部常驻种子背包和收获仓库。
250
250
  地块网格按宿主下发的 `farm.plots` 自适应(开局 4 块、最多 50 块)。已解锁的地块后面
251
251
  跟着一张「下一块」锁定卡,显示地价;顶部计数直接写 `x/50`。
252
- 记录页给最近 100 条农场日志(种/收/偷/帮/雇/结算/解锁/换季/节日/来客);
252
+ 记录页给最近 100 条农场日志(种/收/偷/帮/雇/结算/解锁/换季/节日/来客/冻住/解冻);
253
253
  偷来的作物和未结算的工资显示在窗口顶部的「驮包」里,只显示、不重复记账。
254
254
 
255
255
  ### 作物
@@ -269,16 +269,17 @@ curl -s -X POST http://127.0.0.1:<DSH端口>/dsh-zoo/self-state \
269
269
 
270
270
  | 作物 | id | 季节 | 生长 | 种子价 | 产量 | 交易所底价 |
271
271
  | --- | --- | --- | --- | --- | --- | --- |
272
- | 豌豆 | `pea` | 春 | 25 分钟 | 6 | 3 | 4 |
273
- | 西瓜 | `watermelon` | 夏 | 6 小时 | 30 | 8 | 10 |
274
- | 稻米 | `rice` | 秋 | 3 小时 | 18 | 10 | 4 |
275
- | 白萝卜 | `radish` | 冬 | 90 分钟 | 10 | 6 | 4 |
272
+ | 豌豆 | `pea` | 春 | 25 分钟 | 6 | 3 | 6 |
273
+ | 西瓜 | `watermelon` | 夏 | 6 小时 | 30 | 8 | 24 |
274
+ | 稻米 | `rice` | 秋 | 3 小时 | 18 | 10 | 10 |
275
+ | 白萝卜 | `radish` | 冬 | 90 分钟 | 10 | 6 | 8 |
276
276
 
277
277
  初始种子只有小番茄;其他种子去交易所买。表按生长时长排,窗口里的种子列表和行情页
278
- 也是这个顺序。越久的一档种子越贵、每小时毛收越低,但种下去管得更久——短的刷得勤,
279
- 长的适合睡前种。外观是包里自带的 SVG(`desktop/crops/<id>.svg`),不是 emoji;
280
- 没有图的作物(老版本邻居传来的、或将来漏放的)退回 emoji 显示。四季作物的图目前是
281
- 占位 SVG,玩法不受影响。
278
+ 也是这个顺序。常驻作物越久的一档种子越贵、每小时毛收越低,但种下去管得更久——短的
279
+ 刷得勤,长的适合睡前种。四季作物的底价刻意高于常驻作物:它们只在当季能种,作为补偿,
280
+ 当季按底价卖的日收益也高于草莓;价格跌到地板时仍不亏。外观是包里自带的 SVG
281
+ (`desktop/crops/<id>.svg`),不是 emoji;没有图的作物(老版本邻居传来的、或将来漏放的)
282
+ 退回 emoji 显示。
282
283
 
283
284
  四季种子只在所属季节能买、能种;收获后可以随时卖。当季种下长得快 10%,跨季没熟的
284
285
  四季作物会在本地午夜枯萎(不能收、不能浇水/施肥,但可以点一下重种)。六种常驻作物
@@ -309,7 +310,7 @@ curl -s -X POST http://127.0.0.1:<DSH端口>/dsh-zoo/self-state \
309
310
  越界的**整条丢掉**(不做部分修补),日志里留一行。
310
311
  - 加进去以后:交易所多一种行情、种子列表多一行、地块能种能收能卖,和内置作物一样。
311
312
  - 数值自己负责:`seedPrice` 太低 + `yield` 太高就是刷钱。
312
- - 外观暂时退回 🌱(自定义作物的图还没接;内置十种仍是包里的 SVG,四季四种目前是占位图)。
313
+ - 外观暂时退回 🌱(自定义作物的图还没接;内置十种仍是包里的 SVG)。
313
314
  - **局域网里会自动同步**:beacon 只带目录指纹,邻居发现不一样就单播拉一次完整目录
314
315
  (每片 ≤8 条、30 秒最多问一次);图走局域网 HTTP,按内容哈希取,取不到就退 🌱。
315
316
  同一网段里你加一种作物,别人的窗口几十秒内也会多一种。
@@ -346,18 +347,26 @@ curl -s -X POST http://127.0.0.1:<DSH端口>/dsh-zoo/self-state \
346
347
  | 秋 | 丰收祭 | 收获 15 个作物 | 50 硬币 + 4 露水 |
347
348
  | 冬 | 围炉节 | 浇水 5 次 | 35 硬币 + 6 露水 |
348
349
 
349
- ### 季候来客:熊獾
350
+ ### 季候来客:四季来客
350
351
 
351
- 熊獾只在秋天出现,每个四天一轮只来一次,是一张二选一卡片,不打架、
352
- 没有倒计时战斗:
352
+ 每个季节有一位来客:**蛙雨/野火在当天随机时间出现,熊獾/巨鹿固定本地 15:00 出现**,
353
+ 每次只待 **3 小时**;窗口外不显示卡片,也不能结算。窗口结束时还没处理,会按「不管它」结算一次。
354
+ 来客是一张二选一卡片,不打架、没有实时战斗:
353
355
 
354
- - **守夜**:按当前守卫值掷一次(主人在家 0.3 + 雇工 0.5,封顶 0.8)。成功得
355
- 40 硬币 + 3 露水;失败从仓库搬走最多 3 个作物。
356
- - **投喂**:仓库至少有 3 个作物时可用,扣 3 个,换 1 颗稻种 + 2 露水,稳过。
357
- - **不管它**:秋天结束(本地午夜)时,从仓库搬走 1 个作物。
356
+ | 季节 | 来客 | 守卫 | 守卫成功 | 守卫失败 | 安抚 | 不管它 |
357
+ | --- | --- | --- | --- | --- | --- | --- |
358
+ | 春 | 蛙雨 🐸 | 赶走 | 45 硬币 + 3 露水 + 1 颗豌豆种 | 踩坏 2 块正在长的地 | 引水:1 露水 | 踩坏 1 块地 |
359
+ | 夏 | 野火 🔥 | 隔离 | 55 硬币 + 4 露水 + 1 颗西瓜种 | 烧掉 2 块成熟作物 | 浇水:2 露水 | 烧掉 1 块地 |
360
+ | 秋 | 熊獾 🐻 | 守夜 | 70 硬币 + 5 露水 + 1 颗稻种 | 搬走 5 个仓库作物 | 投喂:3 个仓库作物,换 1 颗稻种 + 2 露水 | 搬走 2 个作物 |
361
+ | 冬 | 巨鹿 🦌 | 硬扛 | 65 硬币 + 6 露水 + 1 颗白萝卜种 | 冻住 3 块地 | 生火:2 露水 + 10 硬币 | 冻住 2 块地 |
362
+
363
+ 守卫成功率和主人是否在家、是否有雇工有关(0.3 + 0.5,封顶 0.8)。来客卡上还能临时雇 **0~2 名守卫**:
364
+ 每名 20 硬币、加 0.5 成功率,和常驻守卫相加后封顶 100%;硬币在结算时先扣,失败不退。安抚不掷骰,付得起就稳过。
365
+ 来客卡只在主人视图出现,访客和看田看不到。失败/忽略不会删存档,也不会扣未提及的资源。
366
+
367
+ **冻住的地**:作物还在,但停止生长,不能收获/浇水/施肥,也不能直接重种;点「生火解冻」花
368
+ 2 露水 + 5 硬币即可恢复。到换季还没解冻,这块地会冻死成「枯萎」,只能重种。
358
369
 
359
- 失败/忽略只动仓库里的作物,不会毁地块、不会扣硬币、不会删存档。来客卡只在主人视图出现,
360
- 访客和看田看不到。
361
370
 
362
371
  ### 怎么玩
363
372
 
@@ -390,13 +399,16 @@ curl -s -X POST http://127.0.0.1:<DSH端口>/dsh-zoo/self-state \
390
399
  生长中的地可以帮一次(花 1 露水、+10% 生长、得 1 硬币)。偷菜成功会让主人收获少 1;
391
400
  被抓只是这次白跑。两种互动都有每日上限和每块地每轮一次的限制。
392
401
  - **看田 / 派它去偷**:右键邻居小街上的那户(或农场窗顶部的邻居切换器)就能在家看邻居的地:
393
- 只读,只有地块、守卫和这趟最多几块。看田窗底部的「派它去偷」让宠物真的出门跑一趟——
402
+ 只读,只有地块、守卫和这趟最多几块。看田窗会一直停在那一页——行情摘要、自家作物成熟、
403
+ 邻居来偷都不会把它踢回自己农场;倒计时到点只会重拉一份对方的新视图,
404
+ 要回自己农场得点顶部的「我的农场」。看田窗底部的「派它去偷」让宠物真的出门跑一趟——
394
405
  不用放行、也不用先串门;它出现在对面的桌面上,带「偷菜」角标,把这一趟能偷的都偷完
395
406
  就自己回家,作物回家时已经在仓库里。对方版本太老(没有 `raid` / `look`)时,
396
407
  切换器那一项会写「对方版本太老」。
397
408
  - **雇工**:雇工页保存自己的挂牌(开关 / 时薪 / 可雇时段)。邻居的挂牌随行情摘要过来,
398
409
  选宠物和时长就能雇。工资 + 5% 手续费预付;雇工出现在雇主的桌面上(带「打工」角标),
399
- 雇主守卫 0.3 + 0.5 = 0.8 封顶。合同期内雇工不能串门、不能被别人雇,**自家农场没人看**。
410
+ 雇主守卫 0.3 + 0.5 = 0.8 封顶;来客结算时还可另雇 0~2 名临时守卫,最多把这一次的成功率推到 100%。
411
+ 合同期内雇工不能串门、不能被别人雇,**自家农场没人看**。
400
412
  主人可以召回,雇主可以提前结束,按实际服务时长结算;手续费不退。
401
413
  宠物在外打工时自家桌面上留一个「在「X」家打工」胶囊:点开能开农场窗、能带派、能改名,
402
414
  也能一键「叫它回家」——不用等合同到点。
@@ -409,7 +421,7 @@ curl -s -X POST http://127.0.0.1:<DSH端口>/dsh-zoo/self-state \
409
421
  | 地块 | 起始 4 块,最多 50 块(`p1`–`p50`),按顺序解锁 |
410
422
  | 作物 | 10 种(6 常驻 + 4 四季) |
411
423
  | 季节 | 1 天/季,4 天一轮,本地午夜换 |
412
- | 节日 / 来客 | 每日 1 个节日,完成领 1 次;熊獾每个四天一轮 1 次 |
424
+ | 节日 / 来客 | 每日 1 个节日,完成领 1 次;每季 1 位来客,随机/固定 15:00 起 3 小时 |
413
425
  | 硬币 | 1,000,000 |
414
426
  | 每种种子 / 作物 | 999 |
415
427
  | 露水 | 每天最多挣 48,余额上限 48 |
@@ -425,7 +437,7 @@ curl -s -X POST http://127.0.0.1:<DSH端口>/dsh-zoo/self-state \
425
437
  | 价格 | 夹在 `base×0.5`–`base×2`;`bid = round(effective × 0.9)`;每 10 分钟回归 3% |
426
438
  | 幂等缓存 | `farm-action` 按 `${deviceId}:${requestId}` 留最近 200 条 / 10 分钟;`work-*` ack 留 200 条 / 10 分钟 |
427
439
  | 雇佣 | 时薪 1–100,时长 2–8 小时,手续费 `ceil(工资 × 5%)`、最低 1 |
428
- | 守卫 | 主人在家 0.3 + 雇工 0.5,相加封顶 0.8;宠物串门/打工时自家为 0 |
440
+ | 守卫 | 主人在家 0.3 + 雇工 0.5,相加封顶 0.8;来客卡可另雇 0~2 名临时守卫(20 硬币/名,各 +0.5),一次结算封顶 1.0;宠物串门/打工时自家为 0 |
429
441
  | 农场快照 | HTTP 响应 ≤64 KiB;访客宿主 2 秒超时,失败按地址冷却 60 秒 |
430
442
 
431
443
  表里的 `n` 是当前已解锁地块数(4–50);地价 = `round5(60 × 1.10^(n−4))`。
@@ -606,13 +618,14 @@ npm run fake-peer -- --gift $'给你留了张便条\n第二行'
606
618
  - 礼物:单件 ≤16 MiB、字条 ≤500 字、一次串门只带一件、背包最多 2 件;不自动打开。
607
619
  - 0.3.x 及更早版本不认礼物字段:串门照常,但礼物会显示「没送到」并退回背包。
608
620
  - 农场:开局 4 块、最多 50 块;10 种作物(6 常驻 + 4 四季)、一个雇工位;没有土地升级、
609
- 狗/篱笆、装饰、天气(四季只换了作物、节日和熊獾)、虫害、卖地/退地。访客不能在主人的
621
+ 狗/篱笆、装饰、天气(四季只换了作物、节日和来客)、虫害、卖地/退地。访客不能在主人的
610
622
  交易所成交,硬币和作物只有被宠物驮着才跨机;
611
- 没有跨机账本。50 块时的行情仍只由本机交易所吸收,深度按 `5 × 已解锁` 放大。
623
+ 没有跨机账本。**临时守卫只作用于一次来客结算**,不进入合同、不显示在桌面,也不能被邻居雇。
624
+ 50 块时的行情仍只由本机交易所吸收,深度按 `5 × 已解锁` 放大。
612
625
  - 农场小窗的记录页给最近 100 条日志;`/state.farm.log` 仍只给最近 20 条。驮包是只显示的
613
626
  「在途」标记,作物/硬币的账在宿主那本账里只记一次。
614
- - 季节按本机时钟算:改系统时间会直接改季节,跨时区也会跟着本地午夜换;v1 的季候来客
615
- 只有秋·熊獾,没有春蛙雨、夏野火、冬巨鹿。节日/来客只影响本机,邻居看不到。
627
+ - 季节按本机时钟算:改系统时间会直接改季节,跨时区也会跟着本地午夜换;来客窗口也是本地时间算的,
628
+ 重启/重开窗口不会换时间。节日/来客只影响本机,邻居看不到。
616
629
  - 旧版本邻居看不到农场:串门、礼物、记录照常,但偷/帮/雇/行情需要双方都是 v1.1。
617
630
  - 一次场景最多 256 只;访客没有 TTL,靠对方心跳判断失联。放行提示最多同时排 8 位,
618
631
  心跳影子表最多 8 位。
@@ -623,7 +636,7 @@ npm run fake-peer -- --gift $'给你留了张便条\n第二行'
623
636
  - 协议、动作、错误码与敌意输入边界:[`docs/protocol.md`](docs/protocol.md)
624
637
  - 桌面 helper、点击穿透、场景 v3、素材协议:[`desktop/README.md`](desktop/README.md)
625
638
  - 领域词汇:[`CONTEXT.md`](CONTEXT.md)
626
- - 决策记录:[`docs/adr/`](docs/adr/)(季节时钟/四季作物/熊獾见 ADR-0020~0022)
639
+ - 决策记录:[`docs/adr/`](docs/adr/)(季节时钟/四季作物/来客与冻住见 ADR-0020~0023)
627
640
  - 四季与季候来客规格:[`.scratch/dsh-zoo/SPEC-v8.md`](.scratch/dsh-zoo/SPEC-v8.md)
628
641
  - 发布与上架 dsh-market:[`docs/release.md`](docs/release.md)
629
642
  - 开发笔记与验收截图:[`.scratch/dsh-zoo/`](.scratch/dsh-zoo/)
package/desktop/README.md CHANGED
@@ -369,8 +369,8 @@ ticket 11 又加了:悬停 → 弹层、按钮点击真的把 `action` 写给
369
369
  内容区自己滚动。农场窗**默认不置顶**(右上角图钉可切换;选择记在
370
370
  `userData/farm-window.json`,下次开窗沿用)。桌面宠物本体仍保持置顶。
371
371
  header 是「我的农场 / X/Y 已种植 / 🪙·💧 胶囊 / 📌 / ×」,header 下面是四季日历
372
- (`#season-bar` / `#season-calendar`)和当天的节日卡(`#event-card`;秋天还会多一张
373
- 主人专属的熊獾卡 `#omen-card`)。再下面是 4 段页签、农场页专属的
372
+ (`#season-bar` / `#season-calendar`)和当天的节日卡(`#event-card`;来客窗口内还会多一张
373
+ 主人专属的来客卡 `#omen-card`)。再下面是 4 段页签、农场页专属的
374
374
  「一键种满 · 一键收割」行、可滚动内容区和常驻 footer(种子背包 / 收获仓库)。
375
375
  - **雇工挂牌(ticket 44)**:`contracts.listings[]` 带 `expiresAt`——宿主按**本机收到行情**
376
376
  的时刻 + `peerLostMs` 算(默认 120 秒 = 4 个 30 秒广播),不是邻居的墙上时钟。
@@ -384,17 +384,22 @@ ticket 11 又加了:悬停 → 弹层、按钮点击真的把 `action` 写给
384
384
  对象上(`baseRemainingMs` / `baseAt`,见 `primeCountdowns` / `primeContractCountdowns`),
385
385
  只在 `onState` 里刷新。走到 0 也不本地改状态:窗口只把文本停在「马上就好 / 马上结束」,
386
386
  再请宿主重推一份 `farm-refresh`;熟没熟、合同结没结只认宿主的 `stage` / `status`。
387
+ `farm-refresh` 是"到点确认":它**保持当前视图**,看田时宿主会重拉一份邻居的公开视图。
388
+ 切回自己农场是另一条动作 `farm-own`(顶部「我的农场」那颗圆片)——两条挤成一条时,
389
+ 邻居的作物一熟(或自家作物一熟)就把看田窗口踢回了自己农场。
387
390
  - **地块卡**:空地显示「+ 种植」,整张卡点开播种底部弹窗;生长中显示倒计时、进度条和
388
391
  浇水/施肥;成熟轻微弹跳并给收获/施肥。枯萎卡 `data-stage="withered"`,角标「枯萎」,
389
392
  详情「换季了,这株没来得及熟,重种一株吧」,操作只留「+ 重种」(发 `farm-plant`)。
393
+ 冻住卡 `data-stage="frozen"`,角标「冻住了」,详情「生火解冻:2 露水 + 5 硬币」,
394
+ 操作只留「解冻」(发 `farm-thaw`,带 `plotId`)。
390
395
  动作 id 仍是 `farm-plant` / `farm-harvest` /
391
- `farm-water` / `farm-fertilize`,`plotId` / `cropId` 的窄口不变。
396
+ `farm-water` / `farm-fertilize` / `farm-thaw`,`plotId` / `cropId` 的窄口不变。
392
397
  - **播种弹窗**:十种种子的库存、生长时长、产量;库存 0 禁用,错季四季种子也禁用并写
393
398
  「下季才有」;「去交易所买种」只切页签,
394
399
  没有随机买种。批量:一键种满 = 按空地与种子库存逐块种下(种子用完即停);一键收割 = 所有成熟
395
400
  地块按顺序逐条发 `farm-harvest`,busy 守卫 + 逐条 toast,不新增宿主动作。
396
401
  - **作物外观(ticket 58 / 64)**:不再用 emoji,改成包内自带的 `desktop/crops/<id>.svg`
397
- (十个:六种常驻 + 豌豆/西瓜/稻米/白萝卜;四季四种是占位图)。`desktop/farm-view.js` 的 `CROP_META`
402
+ (十个:六种常驻 + 豌豆/西瓜/稻米/白萝卜,四季四种是手绘扁平矢量)。`desktop/farm-view.js` 的 `CROP_META`
398
403
  同时带 `art` 和 `emoji`:有图渲染 `<img class="crop-art-img">`,没图(空地、旧邻居
399
404
  传来的未知作物、将来漏放的作物)退回 emoji。图外面仍套 `.crop-emoji` / `.seed-emoji`
400
405
  那个盒子,所以字号、阶段滤镜和布局都不用改;尺寸按 `1.2em` 走,只有地块卡单独钉 26px。
@@ -428,15 +433,19 @@ ticket 11 又加了:悬停 → 弹层、按钮点击真的把 `action` 写给
428
433
  四格 `#season-calendar` 用 `calendar[]` 的 `today/past` 上色,最后一格旁边写
429
434
  「距入冬 8 小时 12 分」,最后 4 小时加 `is-almost` 并提示未熟四季作物会枯萎。
430
435
  `#event-card` 每个季节都有,显示目标/进度/奖励/领取;`#omen-card` 只在 `mode === 'owner'`
431
- 且有 `season.omen` 时画,访客/看田强制隐藏。`body[data-season]` 只换强调色和背景渐变,
436
+ 且来客窗口 `active === true` 时画,访客/看田强制隐藏。来客卡显示窗口剩余时间、
437
+ 守卫/安抚两个选择的代价与失败损失,以及 0~2 名临时守卫的下拉(每名 20 硬币、+0.5);
438
+ 窗口外宿主把 `season.omen` 置空。
439
+ `body[data-season]` 只换强调色和背景渐变,
432
440
  不重排布局。换季时宿主会在下一帧推新 `season`,窗口重画并 toast「秋天到了 · 丰收祭」。
433
- - 动作窄口:农场 `farm-plant` / `farm-harvest` / `farm-water` / `farm-fertilize`
441
+ - 动作窄口:农场 `farm-plant` / `farm-harvest` / `farm-water` / `farm-fertilize` /
442
+ `farm-thaw`
434
443
  (只带 `plotId`,种地再带 `cropId`);解锁 `farm-unlock`(只带可选的
435
444
  `expectedUnlocked`,4–50 的乐观锁,价格由宿主算);交易所 `farm-buy-seed` /
436
445
  `farm-sell-crop`(只带 `cropId` + 1–99 的 `qty`,单价/总价由宿主算);雇工 `hire` /
437
446
  `recall-worker` / `end-contract` / `hire-listing`;访客偷/帮 `farm-steal` / `farm-help`;
438
447
  节日 `farm-event-claim`(只带 `expectedStart`);来客 `farm-omen-resolve`
439
- (只带 `choice: 'guard'|'feed'` + `expectedStart`)。
448
+ (`choice: 'guard'|'feed'`、`guards?: 0..2`、`expectedStart`;`feed` 不能带守卫)。
440
449
  `shared.normalizeFarmAction` 与 `main.js` 的 `farmPending` 双重防串 id;一次只能有
441
450
  一个在飞动作,宿主回 `action-result` 后窗口才解锁。
442
451
  - 成功不关窗:种/收/买卖/挂牌/雇佣都只 toast 并刷新数据;失败留在窗里显示 `notice`。
@@ -41,6 +41,7 @@ contextBridge.exposeInMainWorld('dshZooFarm', {
41
41
  // 票 70:节日/来客的乐观锁和二选一也要过桥,否则会被当成缺地块的普通动作。
42
42
  expectedStart: action.expectedStart,
43
43
  choice: action.choice,
44
+ guards: action.guards,
44
45
  hours: action.hours,
45
46
  contractId: action.contractId,
46
47
  wagePerHour: action.wagePerHour,
@@ -29,14 +29,14 @@
29
29
  * `file://` 加载,CSP 里放行了 `img-src 'self'`。
30
30
  */
31
31
  const BUILTIN_META = Object.freeze({
32
- pea: { name: '豌豆', emoji: '🫛', art: 'crops/pea.svg', seedPrice: 6, base: 4, growMs: 25 * MINUTE_MS, yield: 3, season: 'spring' },
32
+ pea: { name: '豌豆', emoji: '🫛', art: 'crops/pea.svg', seedPrice: 6, base: 6, growMs: 25 * MINUTE_MS, yield: 3, season: 'spring' },
33
33
  tomato: { name: '小番茄', emoji: '🍅', art: 'crops/tomato.svg', seedPrice: 6, base: 5, growMs: 30 * MINUTE_MS, yield: 3 },
34
34
  strawberry: { name: '草莓', emoji: '🍓', art: 'crops/strawberry.svg', seedPrice: 9, base: 7, growMs: 45 * MINUTE_MS, yield: 4 },
35
- radish: { name: '白萝卜', emoji: '🥬', art: 'crops/radish.svg', seedPrice: 10, base: 4, growMs: 90 * MINUTE_MS, yield: 6, season: 'winter' },
35
+ radish: { name: '白萝卜', emoji: '🥬', art: 'crops/radish.svg', seedPrice: 10, base: 8, growMs: 90 * MINUTE_MS, yield: 6, season: 'winter' },
36
36
  carrot: { name: '胡萝卜', emoji: '🥕', art: 'crops/carrot.svg', seedPrice: 14, base: 6, growMs: 2 * HOUR_MS, yield: 5 },
37
- rice: { name: '稻米', emoji: '🌾', art: 'crops/rice.svg', seedPrice: 18, base: 4, growMs: 3 * HOUR_MS, yield: 10, season: 'autumn' },
37
+ rice: { name: '稻米', emoji: '🌾', art: 'crops/rice.svg', seedPrice: 18, base: 10, growMs: 3 * HOUR_MS, yield: 10, season: 'autumn' },
38
38
  corn: { name: '玉米', emoji: '🌽', art: 'crops/corn.svg', seedPrice: 22, base: 9, growMs: 4 * HOUR_MS, yield: 6 },
39
- watermelon: { name: '西瓜', emoji: '🍉', art: 'crops/watermelon.svg', seedPrice: 30, base: 10, growMs: 6 * HOUR_MS, yield: 8, season: 'summer' },
39
+ watermelon: { name: '西瓜', emoji: '🍉', art: 'crops/watermelon.svg', seedPrice: 30, base: 24, growMs: 6 * HOUR_MS, yield: 8, season: 'summer' },
40
40
  pumpkin: { name: '南瓜', emoji: '🎃', art: 'crops/pumpkin.svg', seedPrice: 36, base: 30, growMs: 8 * HOUR_MS, yield: 3 },
41
41
  grape: { name: '葡萄', emoji: '🍇', art: 'crops/grape.svg', seedPrice: 52, base: 24, growMs: 12 * HOUR_MS, yield: 5 }
42
42
  })
@@ -109,9 +109,11 @@
109
109
 
110
110
  const WATER_COST = 1
111
111
  const FERTILIZE_COST = 5
112
+ // 票 75:生火解冻的固定成本,必须和宿主 THAW_COST 一致。
113
+ const THAW_COST = Object.freeze({ dew: 2, coins: 5 })
112
114
  /** 解锁后至少留一颗最便宜种子的钱;与宿主 PLOT_UNLOCK_RESERVE 同源(drift 测试会读)。 */
113
115
  const UNLOCK_RESERVE = 6
114
- const STAGE_TEXT = { empty: '空地', growing: '生长中', mature: '可收割', withered: '枯萎了' }
116
+ const STAGE_TEXT = { empty: '空地', growing: '生长中', mature: '可收割', withered: '枯萎了', frozen: '冻住了' }
115
117
 
116
118
  function cropMeta (cropId) {
117
119
  return Object.prototype.hasOwnProperty.call(CROP_META, cropId) ? CROP_META[cropId] : null
@@ -278,7 +280,7 @@
278
280
  /** 进度条 = 已生长 / 总生长。剩余时间是宿主算的权威值,这里只做显示。 */
279
281
  function progressOf (plot) {
280
282
  if (plot === null || typeof plot !== 'object') return 0
281
- if (plot.stage === 'empty' || plot.stage === 'withered') return 0
283
+ if (plot.stage === 'empty' || plot.stage === 'withered' || plot.stage === 'frozen') return 0
282
284
  if (plot.stage === 'mature' || plot.mature === true) return 1
283
285
  const meta = cropMeta(plot.crop)
284
286
  if (meta === null) return 0
@@ -364,28 +366,91 @@
364
366
  }
365
367
  }
366
368
 
367
- /** 票 69:秋天来客卡。选择与代价来自宿主,窗口不自己算概率。 */
369
+ /** 票 69/74:来客卡。四季共用同一张卡,文案/成本/代价全部由宿主给。 */
368
370
  function omenCard (omen) {
369
371
  if (omen === null || typeof omen !== 'object') return null
370
372
  const stakes = omen.stakes ?? {}
371
373
  const resolved = omen.resolved === true
372
- const canFeed = omen.canFeed !== false
374
+ const active = omen.active === true
375
+ const choices = Array.isArray(omen.choices) ? omen.choices : []
376
+ const guardChoice = choices.find((choice) => choice.id === 'guard') ?? { id: 'guard', label: '守卫' }
377
+ const feedChoice = choices.find((choice) => choice.id === 'feed') ?? { id: 'feed', label: '安抚' }
378
+ const costText = (cost) => {
379
+ const parts = []
380
+ if (Number(cost?.crops) > 0) parts.push(Number(cost.crops) + ' 个仓库作物')
381
+ if (Number(cost?.dew) > 0) parts.push(Number(cost.dew) + ' 露水')
382
+ if (Number(cost?.coins) > 0) parts.push(Number(cost.coins) + ' 硬币')
383
+ return parts.join(' + ')
384
+ }
385
+ const rewardText = (reward) => {
386
+ const parts = []
387
+ if (Number(reward?.coins) > 0) parts.push('+' + Number(reward.coins) + ' 硬币')
388
+ if (Number(reward?.dew) > 0) parts.push('+' + Number(reward.dew) + ' 露水')
389
+ for (const [crop, qty] of Object.entries(reward?.seeds ?? {})) {
390
+ if (Number(qty) > 0) parts.push('+' + Number(qty) + ' 颗' + (cropMeta(crop)?.name ?? crop) + '种子')
391
+ }
392
+ return parts.join(' ')
393
+ }
394
+ const failText = (() => {
395
+ const parts = []
396
+ if (Number(stakes.failLoss) > 0) parts.push(Number(stakes.failLoss) + ' 个仓库作物')
397
+ if (Number(stakes.failWither) > 0) parts.push(Number(stakes.failWither) + ' 块' + (stakes.failMatureOnly === true ? '成熟' : '') + '地')
398
+ if (Number(stakes.failFreeze) > 0) parts.push(Number(stakes.failFreeze) + ' 块地冻住')
399
+ return parts.length === 0 ? '没有额外损失' : parts.join(' + ')
400
+ })()
401
+ const ignore = stakes.ignoreLoss ?? {}
402
+ const ignoreParts = []
403
+ if (Number(ignore.crops) > 0) ignoreParts.push(Number(ignore.crops) + ' 个作物')
404
+ if (Number(ignore.witherPlots) > 0) ignoreParts.push(Number(ignore.witherPlots) + ' 块地')
405
+ if (Number(ignore.freezePlots) > 0) ignoreParts.push(Number(ignore.freezePlots) + ' 块地冻住')
406
+ const cost = costText(stakes.feedCost)
407
+ const feedReward = rewardText(stakes.feedReward)
408
+ const guardReward = rewardText(stakes.guardReward)
409
+ const remaining = Number(omen.remainingMs)
410
+ const guardOptions = (Array.isArray(omen.guardOptions) ? omen.guardOptions : []).map((option) => {
411
+ const guards = Math.max(0, Math.min(2, Math.floor(Number(option?.guards) || 0)))
412
+ const chance = Math.min(1, Math.max(0, Number(option?.chance) || 0))
413
+ const cost = Math.max(0, Math.floor(Number(option?.cost) || 0))
414
+ return {
415
+ guards,
416
+ chance,
417
+ cost,
418
+ affordable: option?.affordable !== false,
419
+ label: (guards === 0 ? '不另雇' : '雇 ' + guards + ' 名') + ' · ' +
420
+ Math.round(chance * 100) + '%' + (cost > 0 ? ' · ' + cost + ' 硬币' : '')
421
+ }
422
+ })
373
423
  return {
374
424
  id: typeof omen.id === 'string' ? omen.id : '',
375
425
  name: typeof omen.name === 'string' ? omen.name : '来客',
376
426
  emoji: typeof omen.emoji === 'string' ? omen.emoji : '🐻',
427
+ tag: typeof omen.tag === 'string' ? omen.tag : '季候来客',
428
+ active,
377
429
  resolved,
378
430
  choice: typeof omen.choice === 'string' ? omen.choice : null,
379
- canFeed,
380
- detail: '秋夜来了位不速之客。守夜可能失败;投喂 3 个仓库作物稳过。',
381
- guardText: '守夜成功 +' + (Number(stakes.guardReward?.coins) || 0) + ' 硬币 +' +
382
- (Number(stakes.guardReward?.dew) || 0) + ' 露水;失败被搬走最多 ' + (Number(stakes.failLoss) || 0) + ' 个作物。',
383
- feedText: '投喂 ' + (Number(stakes.feedCost) || 0) + ' 个仓库作物,换 ' +
384
- (Number(stakes.feedReward?.seeds?.rice) || 0) + ' 颗稻种 +' +
385
- (Number(stakes.feedReward?.dew) || 0) + ' 露水。',
431
+ canFeed: omen.canFeed !== false,
432
+ remainingText: active && Number.isFinite(remaining) && remaining > 0
433
+ ? '还剩 ' + formatRemaining(remaining)
434
+ : active ? '马上就走' : '窗口已关',
435
+ detail: active ? (omen.name + '在田边出现了。') : '它已经离开了。',
436
+ guardText: guardReward === '' ? '守卫成功没有奖励;失败损失 ' + failText + '。' : '守卫成功 ' + guardReward + ';失败损失 ' + failText + '。',
437
+ guardOptions,
438
+ guardBase: Number.isFinite(Number(omen.guardBase)) ? Math.min(1, Math.max(0, Number(omen.guardBase))) : 0,
439
+ feedText: cost === '' ? feedChoice.label + '不花资源,稳过。' : feedChoice.label + ' ' + cost + (feedReward === '' ? ',稳过。' : ',换 ' + feedReward + '。'),
440
+ ignoreText: ignoreParts.length === 0 ? '' : '不管它:' + ignoreParts.join(' + ') + '。',
386
441
  actions: [
387
- { id: 'guard', label: '守夜', disabled: resolved },
388
- { id: 'feed', label: '投喂', disabled: resolved || !canFeed, reason: !canFeed ? '仓库作物不够 3 个' : '' }
442
+ {
443
+ id: 'guard',
444
+ label: guardChoice.label,
445
+ disabled: !active || resolved || guardChoice.affordable === false,
446
+ reason: guardChoice.reason ?? ''
447
+ },
448
+ {
449
+ id: 'feed',
450
+ label: feedChoice.label,
451
+ disabled: !active || resolved || feedChoice.affordable === false,
452
+ reason: feedChoice.reason ?? ''
453
+ }
389
454
  ]
390
455
  }
391
456
  }
@@ -518,6 +583,7 @@
518
583
  const opts = options !== null && typeof options === 'object' ? options : {}
519
584
  const plots = farm !== null && typeof farm === 'object' && Array.isArray(farm.plots) ? farm.plots : []
520
585
  const dew = Number.isFinite(Number(opts.dew)) ? Number(opts.dew) : Number(farm?.dew) || 0
586
+ const coins = Number.isFinite(Number(farm?.coins)) ? Math.max(0, Number(farm.coins)) : 0
521
587
  const busy = opts.busy === true
522
588
  const selected = typeof opts.selectedPlot === 'string' ? opts.selectedPlot : null
523
589
  return plots.map((plot, index) => {
@@ -525,16 +591,21 @@
525
591
  ? plot.stage
526
592
  : 'empty'
527
593
  const meta = cropMeta(plot?.crop)
594
+ const frozen = stage === 'frozen'
528
595
  const withered = stage === 'withered'
529
596
  const mature = stage === 'mature'
530
597
  const growing = stage === 'growing'
531
- const displayStage = withered ? 'withered' : mature ? 'mature' : growing ? 'growing' : 'empty'
598
+ const displayStage = frozen
599
+ ? 'frozen'
600
+ : withered ? 'withered' : mature ? 'mature' : growing ? 'growing' : 'empty'
532
601
  const card = {
533
602
  plotId: typeof plot?.id === 'string' ? plot.id : '',
534
603
  label: plotLabel(plot, index),
535
604
  stage: displayStage,
536
605
  crop: meta === null ? null : plot.crop,
537
- cropName: meta === null ? '空地' : withered ? meta.name + '(枯萎)' : meta.name,
606
+ cropName: meta === null
607
+ ? '空地'
608
+ : frozen ? meta.name + '(冻住)' : withered ? meta.name + '(枯萎)' : meta.name,
538
609
  emoji: meta === null ? '+' : meta.emoji,
539
610
  art: meta === null ? '' : meta.art,
540
611
  badge: STAGE_TEXT[displayStage],
@@ -546,7 +617,20 @@
546
617
  selected: selected !== null && plot?.id === selected,
547
618
  actions: []
548
619
  }
549
- if (card.openPlant) {
620
+ if (frozen) {
621
+ const affordable = dew >= THAW_COST.dew && coins >= THAW_COST.coins
622
+ card.detailText = '生火解冻:' + THAW_COST.dew + ' 露水 + ' + THAW_COST.coins + ' 硬币'
623
+ card.actions.push(action({
624
+ action: 'thaw',
625
+ plotId: card.plotId,
626
+ label: '生火解冻',
627
+ className: 'thaw',
628
+ disabled: busy || !affordable,
629
+ ...(affordable
630
+ ? {}
631
+ : { reason: dew < THAW_COST.dew ? '露水不够(需要 ' + THAW_COST.dew + ')' : '硬币不够(需要 ' + THAW_COST.coins + ')' })
632
+ }))
633
+ } else if (card.openPlant) {
550
634
  card.detailText = withered ? '换季枯了,点一下重种' : '点一下选种子'
551
635
  } else if (mature) {
552
636
  card.detailText = plot?.fertilized === true ? '已施肥 · 可以收了' : '已经成熟,可以收了'
@@ -797,6 +881,7 @@
797
881
  setCrops,
798
882
  WATER_COST,
799
883
  FERTILIZE_COST,
884
+ THAW_COST,
800
885
  UNLOCK_RESERVE,
801
886
  MIN_TRADE_QTY,
802
887
  MAX_TRADE_QTY,
package/desktop/farm.html CHANGED
@@ -557,6 +557,28 @@
557
557
  .plot-card[data-stage='withered'] .plot-progress-fill {
558
558
  background: #b9b0a1;
559
559
  }
560
+ /* 票 75:冻住。作物还在,但按钮变成「生火解冻」,不能收获/浇水/施肥。 */
561
+ .plot-card[data-stage='frozen'] {
562
+ border-color: #a9c9dd;
563
+ background: linear-gradient(180deg, #f2fafd, #e2f1f8);
564
+ box-shadow: inset 0 0 0 1px rgba(120, 178, 208, 0.18);
565
+ }
566
+ .plot-card[data-stage='frozen'] .plot-badge {
567
+ background: #d9edf6;
568
+ color: #2c6f8e;
569
+ }
570
+ .plot-card[data-stage='frozen'] .crop-emoji img {
571
+ filter: saturate(0.45) brightness(1.08) hue-rotate(155deg);
572
+ opacity: 0.8;
573
+ }
574
+ .plot-card[data-stage='frozen'] .plot-progress-fill {
575
+ background: #8fc4dd;
576
+ }
577
+ .plot-card[data-stage='frozen'] .chip-btn.thaw {
578
+ border-color: #a9c9dd;
579
+ background: #e6f4fa;
580
+ color: #2c6f8e;
581
+ }
560
582
 
561
583
  /* 票 70:顶部季节条 + 四格日历。 */
562
584
  .season-bar {
@@ -743,6 +765,26 @@
743
765
  display: flex;
744
766
  gap: 6px;
745
767
  }
768
+ .season-card .omen-guard {
769
+ display: flex;
770
+ align-items: center;
771
+ gap: 6px;
772
+ margin: 6px 0;
773
+ color: var(--ink-soft);
774
+ font-size: 10px;
775
+ }
776
+ .season-card .omen-guard select {
777
+ flex: 1 1 auto;
778
+ min-width: 0;
779
+ height: 25px;
780
+ border: 1px solid var(--line-strong);
781
+ border-radius: 8px;
782
+ background: var(--card);
783
+ color: var(--ink);
784
+ font: inherit;
785
+ font-size: 10px;
786
+ padding: 0 5px;
787
+ }
746
788
  .season-card .season-btn {
747
789
  appearance: none;
748
790
  flex: 1 1 0;