EUI_Kdtool

# EUI_Kdtool 更新日志 / Changelog

本文件为发布更新说明的单一来源（中英双语），CurseForge / Wago 的版本说明自动取自这里（见 `.pkgmeta` 的 `manual-changelog`）。

This file is the single source of release notes (bilingual zh-CN / en-US). CurseForge / Wago notes are taken from here automatically (see `manual-changelog` in `.pkgmeta`).

格式遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
新版本条目请**顶头追加**（newest-first），每个版本先中文后英文，并与游戏内「更新内容」页（`Core/Changelog/Changelog.lua` 的 `DEFAULT_PATCHES`）保持同步。

Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), versions follow [Semantic Versioning](https://semver.org/).
Append new entries **at the top** (newest-first), Chinese first then English, and keep them in sync with the in-game "What's New" page (`DEFAULT_PATCHES` in `Core/Changelog/Changelog.lua`).

## [Unreleased]

## [1.1.1] - 2026-09-12

### 新增 / Added

- **通用 › 鼠标增强 › 鼠标十字线**：移植自 OldManCursor（作者 Chrotesque）的「贯穿屏幕十字线」，按要求精简为「一个指针 + 粗细 + 透明度」——光标处四条准线（上 / 下 / 左 / 右）跟随鼠标移动，线宽 1~10px、透明度 0~100% 即时生效；未移植多层贴图、多档 profile、战斗内外双档、可见性模式、颜色 / 混合 / 旋转与设置页预览。
  **General › Mouse Enhance › Mouse Crosshair**: Ported from OldManCursor (by Chrotesque). The screen-spanning crosshair is trimmed down to "one pointer + thickness + opacity" — four guide lines meeting at the cursor, with line width (1–10px) and opacity (0–100%) adjustable live. Multi-layer textures, profiles, in/out-of-combat pairs, visibility modes, color/blend/rotation and the options preview are intentionally not ported.
- **通用 › 聊天 › 按 Tab 切换频道**（新子标签）：移植自 EUI_Kogotool 的 Chat 模块 —— 在聊天输入框里按 Tab 正向循环、Shift+Tab 反向循环切换频道（说 → 队伍 → 团队 → 副本 → 公会 → 官员），不在对应场景的频道自动跳过，以「/」开头的命令输入不受影响；另可开启「记住上次频道」，关闭聊天框后下次打开仍停在该频道。
  **General › Chat › Tab cycles channels** (new sub-tab): Ported from EUI_Kogotool's Chat module — in the chat edit box, Tab cycles channels forward and Shift+Tab backward (Say → Party → Raid → Instance → Guild → Officer). Channels that don't apply are skipped, and slash commands are left untouched. An optional "remember the last channel" keeps the channel after you close the chat box.

### 修复 / Fixed

- **「目标施法提醒」页构建失败**：该页 8 个滑条漏传数值格式化函数，导致构建页面时抛 `attempt to call a nil value` 并中断整页渲染；已补齐全部滑条配置，并在滑条控件内部增加参数兜底与数值渲染保护，单个异常数值不再中断整页。
  **"Targeted Spells" page failed to build**: All 8 sliders on that page omitted the value formatter, throwing `attempt to call a nil value` during page construction and aborting the whole page. The sliders are fixed, and the slider widget now has a parameter fallback plus safe value rendering, so a single bad value can no longer abort a page.
- **奥法之魂提醒战斗中报错 / 不触发**：模块直接读取光环数据，而 12.x 战斗中光环对插件不可读（保密值机制），会抛出 `Auras cannot be accessed when secret ... ForceTaint_Strong` 并让提醒静默失效；现已按项目既有做法加固（`pcall` 包裹 + 保密值判定 + 战斗中完全不读），并把计时依据改为设置项「涌动窗口时长」—— 战斗中读不到增益是预期路径而非依赖项。
  **Arcane Soul reminder errored / never fired in combat**: The module read aura data directly, but auras are unreadable by addons during combat in Midnight (secret values), throwing `Auras cannot be accessed when secret ... ForceTaint_Strong` and silently killing the alert. It now follows the project's existing pattern (pcall + secret-value check + no aura reads in combat), and timing is driven by the new "Surge window duration" setting — reading the buff in combat is an expected dead end, not a dependency.
- **保密值加固**：目标施法提醒与 DK 血沸监控里读取单位施法 / 引导 / 光环数据的调用，统一改走安全调用（pcall 包裹 + 逐位保密值筛查），战斗中数据被保密值拦截时不再弹错，按「读不到」处理并跳过本次提醒。
  **Secret-value hardening**: Spell-cast, channel and aura reads in Targeted Spells and the DK Blood Boil monitor now go through a single safe-call helper (pcall + per-value secret check), so combat-time secret values no longer throw errors — they are treated as "no data" and that alert is simply skipped.
- **好友列表字体忽大忽小**：社交模块与「字体大小」页各管一套好友行字号且取值不同，跨帧互相覆盖导致字体来回跳；现已同源（「字体大小」页把字号同步写入社交模块存档，登录时同步一次）。
  **Friends-list font jumping**: The social module and the Font Size page each set the friend-row font sizes from their own store with different values, overwriting each other across frames. They now share one source — the Font Size page writes the sizes into the social module's saved data (and re-syncs on login).

## [1.1.0] - 2026-09-11

### 新增 / Added

- **职业工具 › 目标施法提醒**：移植自 TargetedSpells（作者 Xephyris-Blackrock-EU，MIT）。敌人施放指向自己 / 队友的法术时，在屏幕上弹出高亮图标或进度条；支持图标 / 进度条 / 图标+时长三种模板、按目标过滤（自己 / 队友 / 无人指向）、按内容类型与职责显示、多种发光样式、打断者提示，以及按 NPC 类型分级的 TTS 语音播报。精简版以「锚点 + X/Y」定位（未移植可视化编辑器与拖拽摆放），分组样式在职业工具页内配置，带 5 秒测试预览。
  **Class Tools › Targeted Spells**: Ported from TargetedSpells (by Xephyris-Blackrock-EU, MIT). Pops up a highlighted icon or cast bar when enemies cast spells targeted at you / your party; supports three templates (icon / bar / icon+duration), target filtering (self / party / untargeted), per-content-type and per-role conditions, multiple glow styles, interrupter indication, and TTS announcements graded by NPC type. The trimmed port anchors via "anchor + X/Y" (the visual editor and drag placement are not ported); group styles are configured on the Class Tools page with a 5-second test preview.
- **职业工具 › 奥法之魂提醒**：模仿独立插件「准备奥术之魂」（作者 CN-无尽之海-简繁丶）。法师施放奥术涌动后，在其增益结束前提前数秒播放提示音，提醒准备衔接「奥术之魂」输出窗口；提前秒数可调（原插件固定 4.1 秒），音效走材质包可更换 / 试听，播报前校验奥术涌动增益仍在与角色存活。
  **Class Tools › Arcane Soul Reminder**: Modeled after the standalone addon "Ready Arcane Soul" (by 简繁丶). After a Mage casts Arcane Surge, plays an alert sound a few seconds before the buff ends to prepare the "Arcane Soul" damage window; adjustable lead time (the original is fixed at 4.1s), swappable / previewable sound via the media pack, and pre-announcement checks for the Arcane Surge buff and player alive state.
- **字体大小**（新顶层页）：基于 EllesmereUI 各模块字号实现的集中调整面板，含三个子标签——好友列表（名字 / 信息 / 状态 / 游戏文字四处字号）、角色面板槽位标签（装等 / 附魔 / 升级轨迹的字号、描边与阴影）、统计区与其他命名框体文字；调整即时生效，无需重载。
  **Font Size** (new top-level page): A centralized font-size panel based on EUI module font implementations, with three sub-tabs — friends list (four font slots: name / info / status / game text), character sheet slot labels (item level / enchant / upgrade track size, outline and shadow), and the stats area & other named frame texts; changes apply immediately without reload.

### 变更 / Changed

- **常驻 OnUpdate 性能治理**：新增共享 Ticker 驱动（Core/Ticker.lua，订阅空闲自解除）；DK血沸倒计时、大秘境菜单平滑滚动与点击外部关闭轮询、拾取条状态计时、路点追踪缩放 / 光柱写入全部改走「空闲即解绑」订阅，隐藏帧不再每帧空转。
  **Resident OnUpdate performance overhaul**: Adds a shared Ticker driver (Core/Ticker.lua, self-releasing idle subscriptions); the DK Blood Boil countdown, M+ menu smooth scrolling and click-outside polling, loot roll bar status timers, and waypoint tracking scale / beacon writes all now use self-releasing subscriptions, eliminating per-frame idle work on hidden frames.

## [1.0.0] - 2026-09-11

### 亮点 / Highlights

- **Kdtool工具箱 · 首发**：在 EllesmereUI 设置面板注入独立分组，承载 Kdtool 自己的功能页；框架沿用已验证的 EUI 拓展方案，不修改 EllesmereUI 源码。
  **Kdtool Toolbox · First release**: Injects an independent group into the EllesmereUI settings panel hosting Kdtool's own feature pages; built on the proven EUI extension approach, without modifying EllesmereUI source code.
- **职业工具**：移植自 SeUI（作者 semage）：全职业延迟容限 + DK血沸监控。
  **Class Tools**: Ported from SeUI (by semage): global spell queue tolerance + DK Blood Boil monitor.

### 新增 / Added

- **全职业延迟容限**：接管 SpellQueueWindow，可按职业与专精分别指定延迟；关闭后自动还原启用前的游戏原值。
  **Global spell queue tolerance**: Takes over SpellQueueWindow with per-class and per-spec latency values; the original game value is restored automatically when disabled.
- **DK血沸监控**：鲜血死亡骑士的血沸可用提醒：图标 / 横条 / 饼状三种形式，首次与重复触发分色，支持边框与光效高亮、初次音效。
  **DK Blood Boil monitor**: Blood Death Knight Blood Boil availability alert in three styles (icon / bar / pie), distinct coloring for first vs. repeated triggers, with border and glow highlighting and a first-time sound cue.
- **职业工具统一入口**：两个功能合并进侧栏「职业工具」页，用顶部标签栏切换。
  **Unified Class Tools entry**: Both features merged into the sidebar "Class Tools" page, switched via a top tab bar.

### 变更 / Changed

- **皮肤模块未随迁移**：原「皮肤」页（暴雪界面皮肤 / 专精图标替换 / 第三方插件皮肤）整体不迁移。
  **Skin module not migrated**: The original "Skins" page (Blizzard UI skins / spec icon replacement / third-party addon skins) is intentionally not carried over.

### 修复 / Fixed

- **设置页预览不再改写偏好**：DK血沸监控的实时预览改为页面级开关，关闭设置页后不会把「预览效果」偏好写成关闭。
  **Preview no longer overwrites preference**: The DK Blood Boil monitor's live preview is now page-scoped; closing the settings page no longer writes the "preview effect" preference off.

[Unreleased]: https://github.com/unix-cc/EUI_Kdtool/compare/v1.1.1...HEAD
[1.1.1]: https://github.com/unix-cc/EUI_Kdtool/releases/tag/v1.1.1
[1.1.0]: https://github.com/unix-cc/EUI_Kdtool/releases/tag/v1.1.0
[1.0.0]: https://github.com/unix-cc/EUI_Kdtool/releases/tag/v1.0.0