CHANGELOG — Postalmax

1.0.22（2026-09-23）

Bug fixes (EN)

• Mailbag blank on open (root-caused & fixed): when the Mail Bag tab is the default tab, the item grid could intermittently come up blank until you waited or switched tabs and back — an internal timer-ordering race. Root-caused via in-game logging and fixed; items now appear in ~0.3s instead of ~0.8s.
• Wrong item picked during mailbag collection: if attachment slots shifted (an earlier item was taken) or a mail was deleted mid-run, the queue could pick the wrong item — every take is now verified against an item-ID snapshot and re-located, so it skips rather than mis-picks.
• Gold-send dialog could deadlock sessions or double-send: starting a ratio-mail session while the gold dialog was pending could permanently lock the session or send twice with double postage — an entry re-check now prevents this.
• Merchant bulk buy could buy the wrong item: after the vendor list refreshed and reordered, the buy loop could purchase a different item (real money at stake) — each group is now identity-checked against the vendor list and stops on any change.
• Buy Em All quantity fix: rounding and clamping of the purchase quantity on Enter are corrected; an over-typed quantity no longer buys the wrong amount.
• Auto-send guard: quick-attach auto-send now refuses to send when the send page has leftover money or old attachments, and tells you why.
• "Return Selected" deadlock: if the confirm dialog was displaced by another popup, the return feature locked up until a UI reload — state is now cleaned up automatically and you can retry immediately.
• Mail copies no longer lose attachments: re-loading a saved copy now enumerates all 16 attachment slots instead of trusting a header count.
• Forward mis-send guard: starting a collection while a forward confirmation is pending can no longer mix attachments into the send page.
• Dialog reliability: when the screen already has 4 dialogs up, the addon's confirm dialogs no longer fail silently — you get a message and a safe rollback; the buy-em-all dialog no longer steals keyboard focus and closes with ESC.
• Crash on expired mails in the sender-blacklist filter fixed.
• Ratio-mail recipient restore: your manually typed recipient is correctly restored when a session ends.
• Close-mailbox protection: interrupting ratio mail by closing the mailbox now returns any attachments already placed on the send page to your bags.
• Recent-contacts deletion: deleting a recent contact no longer removes cross-realm same-name / similar-prefix entries by mistake.
• Settings checkboxes: the current value of dropdown-style settings (e.g. pickup interval) now shows its checked state correctly.
• Send-result ownership: mail you send manually or via other addons during a session is no longer mis-counted into the addon's session (which could falsely fail a whole batch).

Improvements (EN)

• Big-guild menu speedup: the contacts dropdown paging through a 1000-member guild drops from ~25,000 queries to ~1,000 — noticeably less lag.
• Ratio-mail status bar now fully hidden when you switch away mid-run.
• Ratio-mail panel input: the recipient / name boxes no longer rescan your whole bags on every keystroke — typing is smooth.
• Buy Em All: sold-out errors are recognized and stop the run (no more fake timeouts); each group buys at the optimal stack size for speed; the Max button tooltip now breaks down affordable / fit / available.
• Contact lists sorted: alts are name-sorted; friends/guild lists are name-sorted for non-CJK clients and keep the roster order on CJK clients — stable, no more random ordering.
• Settings self-heal: a corrupted plugin-toggle sub-table is rebuilt to its default instead of requiring manual save-editing.
• Internal hardening: the 21 inbox-header parse sites now share a single parser.
• New /pmx trace diagnostic command (for reproducing timing issues when reporting problems).

Localization (EN)

• 9 new message keys (send interrupted / send result uncertain / merchant list changed / auto-send cancelled / dialog-full notice / gold temporarily unavailable / three buy-em-all breakdown lines) and 1 removed obsolete key, aligned across all 10 languages.

修复

• 邮包页开箱空白（根治）：默认打开邮包页时物品网格偶发空白、要等几秒或切页再切回才出现——根因是内部两个刷新计时器的执行顺序不保证（时序竞态，偶发触发）；已根治并提速，开箱到物品出现从约 0.8 秒缩短到约 0.3 秒。
• 邮包点取误取 / 漏收：批量收取执行期间若附件槽位前移（前一件被取走）或信件被删，会取错物品——现在按物品 ID 快照逐件复核重定位，宁可不取也不会取错。
• 寄钱弹窗悬置锁死 / 双发：弹窗确认期间启动比例邮寄可致会话永久锁死或双倍发送双倍邮资——入口互斥复查堵住。
• 商人批量购买买错商品：商人列表刷新重排后，购买循环可能买成列表上的另一个商品（涉及金币安全）——每组购买前复核商品身份，列表变化立即停止。
• 买光数量修正：回车确认时购买数量取整与上限钳制修正，不再出现超量输入按错误数量购买。
• 自动发送防线：快捷装信自动发送前，若发送页残留金额或旧附件则拒绝发送并提示，防止误发。
• 「退回选中」死锁：退回确认弹窗被其他弹窗挤掉（异常隐藏）后功能永久卡死、需重载界面——现在自动清理，可立即重试。
• 邮件副本丢附件：保存的副本重新装填时附件数可能漏计——改为 16 槽全枚举。
• 转发误寄防护：转发确认等待期间开始收取，附件不会再被误装进发送页。
• 弹窗可靠性：屏幕上弹窗已满 4 个时，插件确认弹窗不再静默失败——会提示原因并安全回滚；买光弹窗不再抢占键盘焦点，ESC 可直接关闭。
• 过期信崩溃：黑名单过滤处理过期信件时崩溃修复。
• 比例邮寄收件人还原：会话结束正确还原你手填的收件人，不再丢失。
• 关邮箱中断保护：关邮箱中断比例邮寄时，等待窗口内已装入发送页的附件自动退回背包，不再滞留。
• 联系人「最近」误删：删除最近联系人不再误删跨服同名 / 前缀相近的条目。
• 设置勾选态不显示：设置面板「收取间隔」等选项的当前档位勾选状态现在正确显示。
• 发送结果归属：你在插件会话期间手动发信或使用其他插件发信，其成败不再被误计入插件会话（防止误判整批失败）。

改进

• 大公会菜单提速：联系人下拉在千人大公会翻页从约 2.5 万次查询降到约 1000 次，卡顿明显减轻。
• 比例邮寄状态条彻底隐藏：执行中切到其他页不再重现状态条。
• 比例邮寄面板输入提速：收件人 / 名称输入框不再每次按键全背包扫描，输入流畅。
• 买光增强：售罄错误正确识别并停止（不再超时假成功空转）；每组按堆叠上限取优，购买更快；Max 按钮悬停显示「买得起 / 放得下 / 有库存」明细。
• 联系人名单排序：小号名单按名字排序；好友 / 公会名单在非中日韩语言下按名字排序，中日韩客户端保持名册原序——顺序稳定，不再随机出现。
• 设置自愈：插件设置开关子表类型损坏时自动重建默认值，无需手改存档。
• 内部加固：21 处邮件头读取统一为单一解析接口。
• 新增 /pmx trace 诊断命令（时序类问题取证，报告问题时可开启复现）。

本地化

• 新增 9 个提示键（发送中断 / 发送结果不确定 / 商人列表已变化 / 自动发送取消 / 弹窗满提示 / 发钱暂不可用 / 买光三明细），删除 1 个废弃键，全部对齐 10 语言。