MWI 市场伴侣 · 功能说明文档
写在前面
⚠️ 关于合规性说明
本插件不包含任何自动购买功能，因自动功能会违反游戏规则第4.2条。
✅ 本插件：在客户端直接跳转到市场中某个物品的页面。这与玩家手动 Shift 点击背包中的物品效果完全一致。
❌ 违规插件：提供一键完成多种物品的批量购买。这会批量向服务器发送请求，属于自动化操作。
因此，所有的购买行为均需玩家手动操作。
插件仅负责帮你找到物品、算清数量，剩下的交给你来完成。
如果你不信任一键跳转市场的功能，插件亦提供了购物车内物品在市场内高亮的功能。
插件已提交管理员查看，一切功能均确保合规。
一、插件简介
本插件是制作缺料的计算助手与手动采购辅助工具。打开任意制作面板，它会自动分析所需材料，精准算出缺哪些、缺多少，加入购物清单后帮你快速跳转到市场对应页面——购买本身始终由你手动完成。
缺料计算
- 数据直读游戏数据层（
initClientData），不依赖屏幕文本解析，配方与库存精确到个位
- 工匠茶、暴饮袋等 buff 自动计入材料减免；可选「备料余量」，仅在大批量制作时多备料以抵消工匠茶随机波动
- 覆盖制作面板、炼金面板（点金/分解/转化）、房屋建造面板，以及从市场/库存等任意位置打开的详情弹窗
- 材料行内联徽章：缺料「缺 X」、余量「余 X」、被其他计划锁定「🔒N」一目了然
购物清单
- 双形态界面：桌面侧栏 / 移动抽屉，样式与游戏及其他插件完全隔离
- 市场实时价格、单件小计与预估总价；收藏保护、常备数量、搜索、数量直填
- WebSocket 精确库存追踪，购买后自动从清单扣减，全部购齐自动收起
市场与采购（全部手动触发）
- 市场弹窗自动预填缺料数量；市场内物品高亮
- 采购导航条：贴在市场弹窗下方，一眼看到待购物品与进度；购齐的物品原地划线淡出，不重排、不误点
- 「采购下一个」按钮与自定义快捷键常驻导航条，购齐当前物品后一键跳到下一个待购物品的市场页
制作计划与升级链
- 制作计划锁定材料库存，根治多配方共用材料时的缺口误算；加购时勾选「建计划」即可按需创建（默认不勾，不打扰只想买材料的场景）
- 计划进度用「产出物快照」统计，关网页 / 离线挂机后重开仍准确；列表内显示进度条与锁定材料明细，完成后手动点「完成」释放锁定
- 升级链树形展示、步骤勾选、「加入全链材料」为每个步骤建独立计划（同样受「建计划」勾选控制）
- 任务追踪：展示进行中生产任务的进度
互操作与诊断
- 公共 API
window.MWIMM：供其他用户脚本读写购物车、监听变化、跳转市场（文档见脚本顶部注释）
- 与 MWI_Toolkit、Sunny's MWI 增强同开经专项适配
- 诊断命令：
MWIMM.__log()（一键导出诊断日志）、__probe()、__key()、__selftest()
- 界面中英双语，自动跟随游戏语言设置
📖 完整使用说明请访问：https://mate.colacola.cloud/guide
💬 功能建议与社区反馈：https://mate.colacola.cloud/community
二、致谢名单
优化思路提供
- Mooooooooo
- AlphB
- wangchyan
- mutallip
- Foreversunny与他的朋友们
- Joey
- baozi
- Star
BUG反馈
（排名不分先后）
三、更新日志
v2.3
修复游戏更新后采购导航条整条消失的问题，并把导航条重做为贴合游戏原生风格的样子。
修复
- 采购导航条消失：游戏本次更新给市场弹窗外面多包了一层铺满整屏的容器。现已修复。
- 窗口偏矮或移动端时导航条跑出屏幕：市场弹窗最多占到屏幕的 96%，底下本就放不下一条导航条。现在空间不足时，导航条会自动翻到弹窗内侧底部，而不是消失。
- 导航条内容滞留：在市场里改购物车数量、新增物品或切换浏览物品时，导航条不会跟着刷新。现已改为内容变化即重绘。
改进
- 导航条界面重做：配色、字号、圆角、边框全部改用游戏自己的样式变量。
- 已购齐物品原地保留：买齐的物品不再从导航条上消失，而是原地划线、淡出、变绿留在队伍里。以前购齐即移除会让后面的物品集体左移，容易点错。
- 左侧新增「待购 N / M」计数。
- 「采购下一个」按钮与快捷键提示常驻导航条：不必等到购齐横幅弹出才看得到快捷键。
- 取消购齐横幅：购齐提示改由物品本身的划线淡出动画承担，不再有横幅遮挡与自动淡出的等待。
升级后建议刷新页面一次。
v2.2.1
界面细节打磨：边缘热区更醒目、待购提示更清爽，并修复设置页一处重复文案。
改进
- 边缘热区可视化增强：桌面右缘的呼出热区，过去只有一条几乎看不见的细线。现在靠近右缘时会显示一条由边缘向内渐隐的高亮带 + 一个指向箭头，清楚标示「哪片区域可以呼出侧栏」；高亮带宽度跟随「边缘热区宽度」设置实时变化。同时移除了过窄、易误触的 4px 档位。
- 悬浮按钮待购提示重做：侧边悬浮小耳朵在有待购物品时，改为描一道金色内缘 + 一颗脉冲圆点（替代原先的数字角标），更清爽不抢眼；具体待购数量在展开侧栏后的表头「缺 N 项」处查看。
修复
- 设置页重复文案：设置页底部曾重复显示两行「设置即时生效并自动保存」，现已修正为一行。
升级后建议刷新页面一次。
v2.2.0
重做了制作计划的创建方式与进度统计，让计划更可控、离线也准。
修复 / 改进
- 制作计划改为按需创建：加入购物清单时新增「建计划」复选框（默认不勾），只有勾选才会创建计划并锁定材料。修复了旧版"一加购就自动建计划、悄悄锁定库存，导致后续其他物品缺料计算对不上"的问题——即便在制作同一物品时也可能受影响。现在是否建计划完全由你决定。
- 计划进度改用「产出物快照」统计：创建计划时记录产出物当前库存作为基线，进度 = 当前库存 − 基线，封顶为「计划次数 × 每次产出数」。这一方式只读库存差值，关闭网页或离线挂机后重新打开仍能正确显示进度（旧的事件计数方式在关网页时会丢失统计）。
- 计划列表信息增强：每个计划新增进度条与「锁定明细」——直观看到该计划锁了哪些材料、各锁多少。
- 完成改为手动确认：新增「完成」按钮，点击后释放该计划的材料锁定并移出列表；计划不再自动完成或自动消失，避免误判，更可控。
升级后建议刷新页面一次。
兼容性说明：v2.2.0 之前已创建的计划在升级后会照常加载并保留锁定，但需要重新创建（在制作面板勾选「建计划」后加购）才会显示进度条。
v2.1.1
重做了材料安全余量（备料）的算法与交互，并补充清单易用性细节。
修复
- 「备料余量」（原「Z-score 安全边际」）的算法与工匠茶实际机制不符：旧的概率模型会高估随机波动，甚至在材料需求本就能被工匠整除（每次消耗固定、零波动）时仍让你多买。现改用官方 Wiki 的真实机制——减料后每次需求的小数部分即为「该材料被消耗的概率」——波动估计与游戏一致，零波动场景不再多备。
改进
- 新增「补料起算行动次数」阈值：行动次数在阈值（默认 10）以内时，按实际需求向上取整、不补料；超过阈值才按所选档位多备。小批量制作（做几件装备）不受影响，只有大批量（刷一整天）才多备一截以抵消随机波动，避免差几个没做完。
- 备料余量档位精简为：标准（95%）/ 充足（99%）/ 十足（99.9%）/ 关闭（「关闭」= 完全按实际需求、不补料）。
- 清单点击提示：清单顶部新增提示「点击物品或所在行即可跳转到市场」，可一键关闭、不再显示。
- 清单物品图标放大一圈，更清晰易点。
升级后建议刷新页面一次。
v2.1.0
在 v2.0.0 架构升级基础上，修复两类面板检测问题，并显著增强与第三方插件同开时的稳定性。
修复
- 炼金 / 强化面板的徽章与「加入购物车」按钮缺失：旧版的面板白名单判定会把炼金（点金 / 分解 / 转化）与强化面板排除在外，导致这些面板上的徽章和加购按钮一起消失。现改为统一的面板识别，制作 / 炼金 / 强化三类面板一致覆盖。
- 跳转市场往返后徽章冻结或消失：从市场页返回后——尤其是与会向面板注入按钮的插件（如 Sunny's MWI 增强）同开时——制作面板的徽章可能停在旧数值，或整片消失，需切换配方 / 切换浏览器标签页才恢复。根因是持续不断的 DOM 变动把刷新无限推迟（去抖饿死）：刷新被排进队列却始终等不到执行。现加入刷新封顶机制，无论 DOM 变动多频繁都保证及时重绘。
改进
- 配方识别改用游戏数据层（React Fiber）读取确定的配方标识，不再依赖屏幕文本或面板类名推断，识别更稳，与第三方插件共存更可靠。
- 看门狗增强：市场弹窗开 / 关时自动刷新一拍，及时反映在市场内购买导致的库存变化；当面板被复用但配方已切换时强制重绘，杜绝旧配方残留。
- 诊断：
MWIMM.__log() 新增「去抖合并」计数，便于定位与其他插件互相注入引发的 DOM 变动风暴。
升级后建议刷新页面一次。
v2.0.0
架构升级 + 稳定性大修 + 新功能的合并发布，经 17 套 197 项打磨。
新增
- 全新界面：Shadow DOM 双形态壳（桌面侧栏 / 移动抽屉），样式完全隔离，不再与游戏或其他插件互相干扰；设置即时生效自动保存
- 诊断命令：
MWIMM.__log() 一键导出诊断日志（版本/设置/数据层状态/完整事件流水）；另有 __probe() 缺料计算体检、__key() 快捷键体检、__selftest() 解析链自检
提高计算正确性与稳定性
其他改进
遇到问题怎么反馈
F12 控制台执行 MWIMM.__log()，把输出全文贴在反馈里即可。个别私有/小众插件可能与面板检测产生冲突（表现为徽章不出现），同样请贴 log。
v1.7.0
新增
- 公共 API（
window.MWIMM）：供其他用户脚本读写购物车、监听变化、跳转市场。写入 addToCart / setCartItemQuantity / removeFromCart / clearCart，读取 getCartItems / getCartItem / hasCartItem / getCartCount，辅助 resolveItemName / openMarketplace / normalizeItemId；事件支持 ready 与 cart:change。完整双语文档见脚本顶部注释
- 「采购下一个」快捷键：购齐当前物品且清单还有下一项时，按自定义快捷键跳转到下一个物品的市场页。设置面板捕获模式绑定，单键与组合键均支持
- 横幅快捷键徽章：购齐横幅上显示当前快捷键；未设置时可点击直达设置对应行
改进与安全网
- 购物车写入路径拆分，API 批量写入只触发一次持久化与广播
- 快捷键作用域严格隔离：仅购齐事件后装填、按下即消费、输入框聚焦时一律放行，聊天打字不受影响
v1.4.0 – v1.6.1（汇总）
- 合规性：移除「采购自动跳转」与回退跳转方案，改为导航栏内联购齐横幅与「采购下一个 ▶」按钮——所有市场页面跳转均由玩家手动点击触发（v1.4.1 / v1.4.2）
- 计算：Z-score 安全边际概率模型（90%–99.9% 四档）；材料充足时显示蓝色「余 X」徽章；金币不参与工匠茶减免；同配方多任务计划正确累加；全链材料加入清单时扣除购物车已有数量（v1.4.2 – v1.4.7）
- 升级链：树形展示完整链与每步缺口、步骤勾选筛选、「加入全链材料」为每个步骤创建独立制作计划并锁定库存、链内库存排除自身链锁定（v1.4.2 – v1.4.7）
- 任务追踪面板：展示活跃生产任务进度，WS 实时更新，「补缺料/建计划」快捷按钮（v1.4.2）
- 市场价格：清单内单价与小计、底部预估总价栏、价格缓存秒加载（v1.5.0 / v1.6.0）
- 双语：英语界面支持（120+ 处 UI 文本）、物品名双语解析、语言始终跟随游戏设置（v1.4.0 / v1.5.0）
- 界面：深色主题大改版（近纯黑底 + 琥珀金主色）、滑动开关、设置面板四组分类、F12/窗口缩放后面板位置尺寸自动恢复（v1.6.0）
- 锁定可视化：材料行徽章尾部 🔒N、摘要行锁定汇总标签，悬停查看每个计划各锁多少（v1.6.1）
- 稳定性：脚本提前至
document-start 加载修复部分用户库存读取失败、强化面板重建 6 秒冷却防闪烁、observer 收窄至游戏容器、监听器防累积、暴饮袋/工匠茶检测修复、全链路错误捕获（v1.4.0 – v1.6.0）
v1.3.6 及更早（汇总）
- 核心功能上线：缺料自动计算、购物清单、市场跳转与高亮
- 游戏数据层接入（
initClientData），生产配方不再依赖 DOM 解析；动态输入场景智能回退 DOM 解析
- 工匠茶与暴饮袋自动计算材料减免，数据来源标记可视化确认 buff 状态
- WebSocket 精确库存追踪，购买后自动扣减购物清单；市场弹窗预填、采购导航条、市场数据缓存
- 制作计划与库存锁定、制作计划面板、WS 实时追踪进度并自动释放锁定
- 收藏保护、常备数量、补齐自动收起、清空分级（清非收藏 / 清全部）
- 房屋建造面板缺料计算；「当前行动」界面手动输入计划次数
- 面板拖动、调整大小、物品搜索、数量可编辑
