jovanreyesdev/albion-refining-chain-planner

# 精炼链规划器 规划您在《阿尔比恩Online》中覆盖所有等级与附魔层级的精炼流程。 输入您的原材料与半成品库存，规划器将显示当前可进行的精炼操作， 自动将每一等级的产出投入下一环节，并精确告知您仍需购买多少低等级物品才能完成所有现有物资的精炼。 ## 功能概述 阿尔比恩的精炼配方形成链式结构：T6需要T5半成品+T6原材料，T7需要T6半成品+T7原材料，依此类推。当您拥有混合多等级与附魔的原材料时，手动计算市场采购清单十分繁琐。本工具将为您完成计算： - **拖拽式库存**——从等级×附魔网格中选择物品并拖入库存袋，操作如同游戏内。 - **实时采购清单**——每个精炼缺口自动生成待购物品项，自动去重并分组，方便一次性采购。 - **级联模式**——假设您将所有物资精炼至最高等级，低等级产出会自动抵消高等级缺口。 - **复选框**——购买后可勾选完成项，进度自动保存。 - **快照功能**——保存并加载命名的库存状态，便于进行"假设"分析。 - **JSON导出**——将整个计划导出为文件，用于测试或分享。 ## 配方编码 ``` T2 = T1 raw ×2 T3 = T2 refined + T3 raw ×2 T4 = T3 refined + T4 raw ×2 T5 = T4 refined + T5 raw ×3 T6 = T5 refined + T6 raw ×4 T7 = T6 refined + T7 raw ×5 T8 = T7 refined + T8 raw ×5 ``` 相同模式适用于所有四类资源（矿石→金属锭，兽皮→皮革，纤维→布料，木材→木板）。附魔层级（.1至.4）从T4开始生效。任何T4.x的原料均为**T3基础资源**（同一资源所有附魔链共享该基础资源），因为游戏中T3资源无附魔变体。 ## 技术栈 - React 19 配合 Vite 8（开发服务器使用 `npm run dev`，生产构建使用 `npm run build`） - Tailwind CSS v4 通过 `@tailwindcss/vite` 引入 - 所有状态通过 `localStorage` 持久化（库存、快照、购物勾选项、级联模式偏好）——数据完全保留在您的设备 ## 快速开始 ``` npm install npm run dev ``` 随后访问Vite输出的URL（通常为 `http://localhost:5173`）。 ## 项目结构 ``` src/ App.jsx Top-level shell: state, persistence, layout components/ constants.js Resource catalog, tiers, enchantments, recipes iconResolver.js Maps (family, tier, ench) → bundled icon URL storage.js localStorage keys + load helpers cascade.js The refining math (cascadeAllChains, runChain) ThemedButton.jsx Albion-style button using button.png TopTabs.jsx Resource / Refined top-level picker tabs SubTabs.jsx Material family sub-tabs (Ore / Hide / ...) PickerGrid.jsx T1–T8 × Base/.1–.4 draggable item grid InventoryPanel.jsx The bag — accepts drops, shows filled slots QtyModal.jsx Quantity prompt shown after drop/click ShoppingList.jsx The buy list with checkboxes + cascade toggle PlansBreakdown.jsx Per-chain step-by-step refining tables SnapshotMenu.jsx Dropdown listing saved snapshots StatPill.jsx Small header chips (Raw / Refined / Will Produce) assets/ inv-slot.jpg Inventory cell background texture button.png Button background items/ All resource & refined item icons (T1–T8 × .0–.4) ``` 核心算法位于 `components/cascade.js` 且与界面分离——便于编写测试或在其他项目中复用计算器。 ## 级联模式详解 启用时，规划器假设您会购买所有缺失的原料，使每个等级的产出自动流向更高等级。 示例：70份T7兽皮 + 300份T8兽皮。 - T7环节：70 ÷ 5 = 生产14份T7皮革（需购买14份T6皮革）。 - T8环节：300 ÷ 5 = 需要60份T7皮革。 - 级联模式开启：其中14份来自T7环节 → 仅需购买**46份**T7皮革。 - 级联模式关闭：各等级独立计算 → 需购买**60份**T7皮革。 开关位于采购清单标题栏，设置自动保存。

标签：Albion Online, React, Syscalls, Tailwind CSS, Vite, Web前端, 动态规划, 在线计算器, 库存管理, 拖放交互, 效率规划, 数据持久化, 本地存储, 材料合成, 材料链规划, 浏览器应用, 游戏工具, 游戏资源管理, 游戏辅助工具, 物品计算, 精炼计算器, 级联计算, 自定义脚本, 购物清单生成, 资源优化