三件事凑成一次不兼容变更:WebSocket 通道、Hypercorn 服务器、「手动推进一天」都消失了。 实时通道:WebSocket -> SSE - hub 改为 SSE 订阅池,GET /api/stream 单向推送 welcome/state/day/notice/bye, 250ms 节流 + 15s 心跳注释;写操作一律走 HTTP POST /api/actions,不再有 WS 回执。 - 停机三处一起修才干净:close_all() 发 bye + timeout_graceful_shutdown 兜底 + 客户端 stop() 直接 shutdown 底层 socket(光 close() 会等读线程的锁,最长卡到下次心跳)。 - 网页版改 EventSource + fetch;tools/ws_demo.py 换成 tools/sse_demo.py。 服务器:Hypercorn -> uvicorn + zttp 的 HTTP/2 - 同一端口同时说 HTTP/1.1 与 HTTP/2。uvicorn 0.53 不再内置 h2,必须装 zttp 并显式 http="zttp",否则 Config.load() 直接 raise。 - 信号接管改成子类覆盖 Server.handle_exit(0.53 没有 install_signal_handlers 可覆盖), 不调 super()、不写 _captured_signals,退出时不重放信号;第二次信号强制退出。 - 入口启动前用 daemon.port_busy() 自检端口:Windows 上 SO_REUSEADDR 会让第二个实例 「绑上」已监听端口并抢走新连接,所以判断「能不能连上」而不是「能不能 bind」。 - 修掉 clear_pid_file 的 Windows 真 bug:文件还开着就 os.remove 会失败且被 except OSError 吞掉,导致每次正常退出都留 stale pid 文件。 节奏:一天 15 秒 -> 40 分钟,并整体移除「休息」 - DEFAULT_TICK_SECONDS=2400,MAX_TICK_SECONDS 放宽到 86400(旧上限会把 40 分钟夹回去)。 - engine.sleep / SLEEP_COOLDOWN / /api/sleep / TUI 的 [N]休息 / 网页版按钮全部删掉, 时间只能自然流动;机器人改为 wait_for_next_day(timeout),CLI 加 bot --wait。 - 时长显示统一走 models.format_duration(),不再出现 2399.6s 这种写法。 键盘:修复方向键/空格/Tab/ESC 全部静默失效 - keys.py 的具名键统一小写并成为唯一来源,tui.py 一律引用 keys.XXX 而不手写字符串 (历史 bug 就是 Windows 侧产大写 UP、TUI 里写小写 up,字母键正常所以很难发现)。 - 顺带修 POSIX 路径一次 os.read 只取首字节、其余按键静默丢弃的老毛病。 测试:重建 500 项 - test_engine 110 / test_actions 35 / test_server 131(skip 35) / test_tui_keys 75 / test_bot 36 / test_client 113。未安装的第三方依赖用 skipUnless 自动跳过,其余照跑, 所以是全绿而不是靠跳过伪装。 - 被测试逼出两处真隐患并修掉:RemoteFarm._normalize() 必须「先补 scheme 再削尾斜杠」 (顺序反了畸形端点会溜到系统代理、报一个和真实原因无关的 502);StateView 空视图要 预置 plots/animals,否则连不上服务器时读 state.plots 直接 AttributeError。 优化:先量后改,依据与前后数字都在 tools/bench.py - 新增 engine.brief_source():brief/summary/动作回执只要十几个标量,不再为它们序列化 整局;to_dict 里 net_worth 只算一次。brief -76%、summary -77%、leaderboard(32) -78%、 GET /api/world -31%、POST /api/actions?full=1 -16%。 - 拆掉三个巨型函数:create_app 475->32 行(_Services + _register_*)、 build_parser 与 available_actions 分组、__main__.main 160->7 行。 - 消除重复:等级门槛 5 处 -> _is_locked/_require_level/_newly_unlocked;hub 的 broadcast/broadcast_all/close_all -> _push_many;daemon.probe/world -> _get_json; main.py 的 _add_endpoint_args/_leaderboard_lines。 - tools/bench.py 作为长期性能守卫(含调用计数器),谁把轻量路径改回 snapshot() 会立刻报警。 门禁:ruff format/check 全绿、pyright 0 错误、500 项测试 OK(skip 35)。
216 lines
5.9 KiB
Python
216 lines
5.9 KiB
Python
"""游戏平衡参数与静态定义。
|
||
|
||
本模块只描述"世界是什么样的"(作物表、动物表、经济参数),
|
||
不包含任何状态或逻辑,方便单独调参。
|
||
"""
|
||
|
||
from __future__ import annotations
|
||
|
||
from typing import Any
|
||
|
||
# --------------------------------------------------------------------------
|
||
# 基础经济参数
|
||
# --------------------------------------------------------------------------
|
||
|
||
START_GOLD = 120 # 初始金币
|
||
START_LEVEL = 1 # 初始等级
|
||
START_AP = 10 # 每天行动点上限
|
||
START_FEED = 5 # 初始饲料库存
|
||
|
||
BASE_PLOTS = 6 # 初始土地数量
|
||
MAX_PLOTS = 16 # 土地数量硬上限
|
||
PLOT_BASE_PRICE = 200 # 第一块新地的价格
|
||
PLOT_PRICE_GROWTH = 1.75 # 每多买一块,价格乘以该系数
|
||
|
||
FEED_UNIT_PRICE = 6 # 主动购买饲料的单价
|
||
FEED_EMERGENCY_PRICE = 9 # 自动补货(缺饲料时喂食)的惩罚单价
|
||
FEED_BULK = 10 # 一次购买饲料的默认批量
|
||
|
||
WATER_CAPACITY = 3 # 一次浇水可支撑的天数
|
||
PLANT_INITIAL_MOISTURE = 2 # 播种后地块自带的水分
|
||
PRICE_VOLATILITY = 0.18 # 每天价格波动幅度(±18%)
|
||
LUCKY_CHANCE = 0.12 # 丰收暴击概率(产出翻倍)
|
||
MAX_LOG_ENTRIES = 300 # 内存中保留的事件条数上限
|
||
MAX_FEED_PURCHASE = 200 # 单次购买饲料的数量上限
|
||
|
||
# 每级提供的土地上限(基础 6 + 2/级,封顶 MAX_PLOTS)
|
||
PLOTS_PER_LEVEL = 2
|
||
|
||
# 行动点消耗表
|
||
AP_COST = {
|
||
"plant": 1,
|
||
"water": 1,
|
||
"harvest": 0,
|
||
"feed": 1,
|
||
"collect": 0,
|
||
"buy_animal": 0,
|
||
"buy_plot": 0,
|
||
"buy_feed": 0,
|
||
}
|
||
|
||
|
||
# 经验曲线:升到 level+1 所需经验
|
||
def exp_to_next(level: int) -> int:
|
||
"""返回从 level 升到 level+1 所需的经验值。"""
|
||
return int(80 * (max(1, level) ** 1.6))
|
||
|
||
|
||
# 升级奖励金币
|
||
def level_up_bonus(level: int) -> int:
|
||
"""升到 level 时发放的金币奖励。"""
|
||
return 80 + 40 * level
|
||
|
||
|
||
# --------------------------------------------------------------------------
|
||
# 作物表
|
||
# --------------------------------------------------------------------------
|
||
# key : 内部标识(API 与存档使用)
|
||
# name : 中文名
|
||
# seed_cost : 种子价格
|
||
# grow_days : 成熟所需生长天数(需要水分支撑)
|
||
# base_price : 收获物的基础售价
|
||
# exp : 每次收获获得的经验
|
||
# level_req : 解锁所需等级
|
||
|
||
CROPS: dict[str, dict[str, Any]] = {
|
||
"wheat": {
|
||
"name": "小麦",
|
||
"seed_cost": 5,
|
||
"grow_days": 2,
|
||
"base_price": 14,
|
||
"exp": 3,
|
||
"level_req": 1,
|
||
},
|
||
"carrot": {
|
||
"name": "胡萝卜",
|
||
"seed_cost": 8,
|
||
"grow_days": 3,
|
||
"base_price": 26,
|
||
"exp": 5,
|
||
"level_req": 1,
|
||
},
|
||
"tomato": {
|
||
"name": "番茄",
|
||
"seed_cost": 16,
|
||
"grow_days": 4,
|
||
"base_price": 52,
|
||
"exp": 9,
|
||
"level_req": 2,
|
||
},
|
||
"corn": {
|
||
"name": "玉米",
|
||
"seed_cost": 28,
|
||
"grow_days": 6,
|
||
"base_price": 95,
|
||
"exp": 14,
|
||
"level_req": 3,
|
||
},
|
||
"pumpkin": {
|
||
"name": "南瓜",
|
||
"seed_cost": 45,
|
||
"grow_days": 8,
|
||
"base_price": 180,
|
||
"exp": 22,
|
||
"level_req": 4,
|
||
},
|
||
"strawberry": {
|
||
"name": "草莓",
|
||
"seed_cost": 70,
|
||
"grow_days": 10,
|
||
"base_price": 320,
|
||
"exp": 35,
|
||
"level_req": 5,
|
||
},
|
||
}
|
||
|
||
# 生长阶段阈值(按生长进度 0.0~1.0 划分)
|
||
GROWTH_STAGES = [
|
||
(0.00, "已播种"),
|
||
(0.30, "幼苗"),
|
||
(0.65, "生长中"),
|
||
(1.00, "已成熟"),
|
||
]
|
||
|
||
|
||
# --------------------------------------------------------------------------
|
||
# 动物表
|
||
# --------------------------------------------------------------------------
|
||
# key : 内部标识
|
||
# name : 中文名
|
||
# cost : 购买价格
|
||
# product : 产出物标识(中文名)
|
||
# base_price : 产出物基础售价
|
||
# cycle : 产出周期(天)
|
||
# feed_per_day: 每天消耗饲料数
|
||
# exp : 每次收集产出获得的经验
|
||
# level_req : 解锁所需等级
|
||
|
||
ANIMALS: dict[str, dict[str, Any]] = {
|
||
"chicken": {
|
||
"name": "鸡",
|
||
"cost": 90,
|
||
"product": "鸡蛋",
|
||
"base_price": 15,
|
||
"cycle": 1,
|
||
"feed_per_day": 1,
|
||
"exp": 4,
|
||
"level_req": 1,
|
||
},
|
||
"sheep": {
|
||
"name": "羊",
|
||
"cost": 220,
|
||
"product": "羊毛",
|
||
"base_price": 55,
|
||
"cycle": 2,
|
||
"feed_per_day": 1,
|
||
"exp": 9,
|
||
"level_req": 2,
|
||
},
|
||
"cow": {
|
||
"name": "牛",
|
||
"cost": 480,
|
||
"product": "牛奶",
|
||
"base_price": 72,
|
||
"cycle": 1,
|
||
"feed_per_day": 2,
|
||
"exp": 15,
|
||
"level_req": 3,
|
||
},
|
||
}
|
||
|
||
MAX_ANIMALS = 8 # 牧场总容量
|
||
|
||
|
||
# --------------------------------------------------------------------------
|
||
# 时间
|
||
# --------------------------------------------------------------------------
|
||
|
||
# 一天有多长(真实秒数)。慢是刻意的:这是“放置农场”——
|
||
# 一天 40 分钟,作物 2~10 天成熟(小麦 80 分钟、草莓约 6.7 小时)。
|
||
# 没有任何“手动推进一天”的接口,时间只能自然流动。
|
||
DEFAULT_TICK_SECONDS = 2400.0
|
||
MIN_TICK_SECONDS = 3.0 # 调试用:把一天缩到几秒
|
||
MAX_TICK_SECONDS = 86400.0 # 上限给到一整天,想多慢都不会被夹住
|
||
|
||
|
||
# --------------------------------------------------------------------------
|
||
# 进度目标
|
||
# --------------------------------------------------------------------------
|
||
|
||
GOALS = [
|
||
(200, "起步:攒够 200 金币"),
|
||
(600, "小农:攒够 600 金币"),
|
||
(1500, "农场主:攒够 1500 金币"),
|
||
(4000, "庄园主:攒够 4000 金币"),
|
||
(10000, "农业大亨:攒够 10000 金币"),
|
||
]
|
||
|
||
|
||
def goal_index(net_worth: float) -> int:
|
||
"""返回已达成的最低目标索引(-1 表示一个都没达成)。"""
|
||
reached = -1
|
||
for i, (amount, _) in enumerate(GOALS):
|
||
if net_worth >= amount:
|
||
reached = i
|
||
return reached
|