一、立项背景与目标__ 市面上的锻造玩法大多停在"材料够、点一下、出货"的合成层,工艺链条被压缩成一个按钮。本项目想验证一个相反的方向:让玩家真正感到"锻造"和"铸造"是两件事。立项目标是用 30 分钟可通关的最小闭环,跑通「矿石 → 铸造出锭 → 锻造/切割成未成之器 → 精修 → 成品 → 委托/战斗」的完整链路,并证明这套规则可以被两套界面(终端与图形)复用,而不是把数值逻辑再写一遍。
二、软件功能与核心模块__ 启动与存档(3 个手动槽 + 开战前自动存档、旧档兼容迁移);仓库(7 个页签 × 48 格,锭块账与余料账两本账分开记);商店(买入 / 卖回 / 回收 / 矿石兑换);锻造(按武器族模板逐槽投料、温控与淬火回火、共享工时预算、工艺问题返工);铸造(矿石熔炼成锭、铸造未成之器);切割(成品分割 / 备料分割 / 原材切锭,2–3 套排料方案);精修(粗磨 → 热处理 → 精磨 → 开锋四步,支持批量);装备(8 槽,双手武器与盾、戒指互斥);任务与委托(剧情章节任务 + 每日整板刷新);战斗(累计时间轴,预判与结算同源);经营与成长(睡觉过天、技能购买、宝物投入);结局与自由经营复玩。
三、业务流程与功能路径__ 新游戏 → 4 步新手引导(仓库 → 锻造 → 装备 → 战斗)→ 每章 1 关 → 铸造供料 → 锻造精品 → 委托交付 → 结算推进 → 第 6 章进入结局 → 转入自由经营。任意节点自动落盘,关窗重进按最近快照恢复;投入材料后本炉不可放弃,避免出现"半炉"脏状态。
## 8. 项目实现(1007 字,实测在 80–1200 内)
__一、整体架构与设计思路__ 三层单向依赖:JSON 数据层(29 张配置表,全部内容驱动)→ 纯函数规则引擎(无 IO、无 print,可单测)→ 视图层。视图有两条:终端 CLI 与 Godot 4.7.2 图形界面。Godot 只负责界面与数据绑定,通过 GDScript 桥用 OS.execute 调 Python 桥脚本,一次调用一个动作(--action + --payload),stdout 只回一行 ASCII 转义 JSON;规则始终由引擎唯一实现,界面里不复制任何公式,所以"预判值"和"结算值"天然一致。发布链路两条:文字版用 PyInstaller 打成约 9.8 MB 单文件 exe;图形版导出 exe + pck + game/ + 便携 Python,解释器按 FORGE_PYTHON → 包内 python → 项目 .venv → PATH 四级回落,保证换机零配置可跑。
__二、我负责的模块与结果__ 引擎、数据表、两套界面、工具链均为独立完成:24 个 Python 文件约 1.7 万行(engine / cli / tools)+ 6 个 GDScript;29 张 JSON 数据表;587 条单元测试(42 个测试文件,2.3 秒全绿);17 个 Godot 无头冒烟/截图脚本;整局自动回放可通关 6 章;发布包自带数据与解释器,朋友机器零依赖运行。
__三、难点、坑与解决方案__ 1)双端规则一致性:把规则下沉为纯函数引擎,CLI 与 Godot 共用同一入口;桥协议固定"一次一个动作、stdout 单行 JSON",并在 Windows 代码页下强制 ASCII 转义,解决中文 JSON 被吞引号、界面解析失败的问题。 2)存读档兼容:读档按版本补齐缺失字段、保留未知字段、跳过失效引用,另做低版本存档生成器,让"旧客户端能不能读新档"变成可测用例。 3)对象语义混乱:材料 / 锭块 / 未成之器 / 余料曾混用,先落决策基线与术语表再改代码;锭账与余料账分账,份制口径(1 份 = 0.25 L)统一后才接界面,避免库存显示翻 10 倍。 4)记账 bug:锻造成功时材料池与锭池双扣,定位后把材料池语义重定义为"未成型原料堆",改成单侧扣减并加合并余量校验,旧存档走冲减迁移。 5)中文终端与管道:统一 UTF-8 输出,非 TTY 自动关闭颜色与清屏,规避乱码和被管道吞掉输入。