QFXfocus

1.3.3

2026-10-10：合并今天 1.2.0–1.3.2 的本地更新及本次检查修复，统一正式发布。

新增与调整

• 新增“焦点不可攻击时不提醒”，默认开启。焦点为队友、友方玩家或其他不可攻击单位时，隐藏实际读条，停止发光、TTS 和自定义声音提醒；可攻击的敌方玩家仍正常监控。焦点变化、玩家/焦点阵营或状态变化会在战斗中刷新判断，预览及声音测试仍可使用。
• 缺失设置自动采用开启状态；已经明确保存的关闭设置保持关闭。基础设置与悬浮窗口快捷按钮使用同一个设置，切换后立即生效。
• 悬浮窗口鼠标提示下方显示“焦点不可攻击时不提醒已开启”或“焦点不可攻击时不提醒已关闭”。
• 悬浮窗口展开后最上方增加快捷开关图标，向上或向下展开都保持在顶部；开启时显示勾选并正常亮度，关闭时变暗。点击不会更换标记、发送分工消息或收起菜单，设置页面修改也会同步图标和已显示的提示。
• 提示各行采用不同颜色：快捷键金色、选标记青色、发送分工橙色、双击设置紫色、开启绿色、关闭红色，锁定状态灰色。
• 左键、右键提示使用与 QFXSystemBar 顶部菜单相同的暴雪内置鼠标图标，组合快捷键也使用对应图标；双击设置显示两个左键图标。移除重复的鼠标按钮文字，无需安装 QFXSystemBar 或新增素材。
• 上述设置、状态、操作提示及修正后的焦点监控说明均提供英文、简体中文和繁体中文。

修复与清理

• 修复打断冷却期间计时对象晚于读条开始事件到达时，进度条未绑定计时而停滞的问题；现在冷却期间也会补绑计时。
• 修复只开启语音/声音提醒时仍持续运行无用的读条倒计时轮询；仅保留等待打断冷却恢复所需的临时刷新，恢复后提醒一次并停止轮询。
• 修复其他点击施法插件接管快捷键后，关闭快速焦点或更换快捷键可能误删其动作/宏的问题；仅清理本插件最后写入且尚未被替换的绑定。
• 清理从未使用的设置区折叠分支、旧翻译键、重复颜色包装函数、无调用的强制提醒分支、未使用的读条数据字段及重复快捷开关刷新。
• 修正“仅在打断可用时显示”的旧说明，使其与冷却期间仍显示读条的当前设置一致。
• 发布包统一命名为 QFXfocus_1.3.3.zip，继续排除测试、开发文件和更新说明；自动发布在更新说明为空时会终止，防止遗漏说明。

API 与验证

• 按 Retail Live 12.1.0.69933 的生成 API 文档核对固定单位参数 UnitCanAttack("player", "focus")：返回普通布尔值，无秘密返回标记；另保留秘密值检查，遇到异常返回时先拒绝再比较。受保护的读条数据仍仅交给显示接口。
• 保留现有设置，新 SavedVariables 字段为 focus_interrupt.suppressUnattackableFocus；没有清空用户配置或新增插件依赖。
• 验证：3 组 Lua 回归测试及全部 Lua 文件语法检查，覆盖计时延迟、冷却恢复、宠物打断、友方过滤、预览、音频提醒、快捷开关与点击施法绑定保护。游戏内战斗和真实界面表现仍需实际使用验证。

English

• Added Suppress Unattackable Focus, enabled by default while preserving explicitly saved disabled settings. Unattackable focus units suppress the live bar, glow, TTS and custom sound; attackable enemy players remain monitored. Focus/relationship events refresh the filter in combat, with preview and sound tests still available.
• Added the current setting below the marker-window mouse hints and a shared-setting toggle at the top of the expanded selector in either direction. Enabled uses a check mark/full brightness; disabled dims the icon. Clicking keeps the selector open without changing or announcing a marker. Settings changes refresh the icon and visible tooltip.
• Colored each tooltip action/status separately. Left/right hints reuse Blizzard mouse glyphs matching QFXSystemBar, including combination shortcuts; double-click uses two left glyphs. No new media or addon dependency. English, Simplified Chinese and Traditional Chinese strings are included.
• Fixed late duration binding in interrupt-cooldown mode, removed audio-only countdown polling after interrupt recovery, and protected replacement third-party click-casting bindings when disabling Quick Focus or changing its shortcut.
• Removed unused section-collapse code, stale localization entries, redundant helpers/refreshes, an unused forced-alert branch and unused cast fields. Corrected outdated cooldown descriptions.
• Release packages use QFXfocus_1.3.3.zip, exclude development files/changelogs, and refuse publishing with empty release notes. Validated with three Lua regression suites and Lua syntax checks; actual in-game combat/UI validation remains necessary.