角色创建器头部与发型搜索 (CCHHS) （作者：Serpentine）

角色创建器头部与发型搜索

如果你安装了大量的发型和头部模组，你可能曾在数百个几乎相同的缩略图中翻找，想找一个特定的头部或发型却无法搜索名称。CCHHS 在每个发型/头部方格下显示可读的名称和来源模组，按网格顺序编号，并添加了一个可按名称或模组筛选的搜索框，引导你浏览匹配项。你可以直接在搜索框中选择正确的头部或发型，或自动浏览所有匹配项以找到合适的造型。如果你愿意，编号还能帮你找到正确的缩略图。

https://github.com/Shiney1965/BG3-CC-Mod-Head-and-Hair

---

使用方法 — 请阅读

要使用搜索面板，请在头部或发型画面按 Ctrl+Shift+H。然后在发型和头部标签页之间来回切换，直到两个页面中的缩略图上都出现编号 — 通常往返 1–2 次即可。

• 到达新的面板时按 刷新，以便搜索界面加载正确的名称。
• 在搜索框中输入文字，按发型/头部名称或来源模组筛选。
• 点击一个或多个模组名称，仅选择该模组集合中的发型或头部。
• 点击搜索结果以应用；或使用 上一个 / 下一个 逐步浏览匹配项 — 状态行会显示匹配编号和对应方格的编号。
• 在头部或发型画面随时按 Ctrl+Shift+H 即可关闭并重新打开面板。
• 快捷键在其他画面无效（这是有意设计的）。
• 编号应永久分配；如果游戏中编号消失，只需在重新进入创建面板时再次往返切换即可。

为什么需要标签页往返？ BG3 会回收缩略图方格，并且只在标签页重建时重新绘制标签，所以快速切换 头部↔发型 是让编号显示出来的必要条件。

为什么使用编号？ 这样你可以在网格中找到正确的头部或发型，如果你想查看网格的某个部分。BG3 不支持自动滚动到选中的头部或发型。

---

功能

• 每个发型和头部方格上都有名称标签 — 单行，过长时截断；悬停时显示完整名称。
• 名称下方显示来源模组行（例如 Lydia's Heads、HairUnlocked、Poesielibre's Heads）。游戏原版选项显示为“原版 (Vanilla)”。
• 所有发型/头部方格上都有编号，按网格顺序排列，因此搜索结果可以对应到网格中的位置。
• 游戏内搜索面板 (Ctrl+Shift+H) — 按名称或来源模组筛选，点击结果即可立即应用，或使用 上一个 / 下一个 浏览匹配项。
• 活动方格上有更亮的选中环（键盘/鼠标布局）。
• 支持键盘和手柄 — 标签和编号在两种模式下均显示。
• 零游戏性影响 — 仅外观/信息类；无后台轮询；不会写入存档。

---

系统需求

• 《博德之门3》，补丁 8 或更高版本。
• BG3 Script Extender（版本 29+）。必需 — 驱动标签、编号和搜索面板。
• 模组管理器（例如 BG3 Mod Manager）— 强烈推荐，因为 CCHHS 必须在加载顺序中启用才能运行脚本。

推荐（非必需）： BG3 ImprovedUI — 补丁 8 分支（模组 16649）。CCHHS 无需它也能运行，但两者已经过共同测试。

---

手柄支持

• 名称/模组标签和缩略图编号在手柄布局下会显示。
• 搜索面板仅限键盘/鼠标（它是鼠标驱动的覆盖层）；编号在打开面板时生成，因此也是键盘/鼠标驱动的。
• 更亮的选中环仅限键盘布局 — 手柄会使用游戏原有的高亮。

---

兼容性

• Appearance Edit Enhanced (AEE) 和 Magic Mirror — 兼容；在游戏中期的外观编辑器中一切正常（在头部/发型画面按 Ctrl+Shift+H 打开面板）。
• BG3 ImprovedUI — 兼容且推荐。
• Customizer's Compendium（模组 10）— 不兼容（它会完全替换 CCLib_k.xaml）。请改用 Patch 7 Ready 版本（模组 12111）。
• 任何完全替换 CCLib_k.xaml 或 CCLib_c.xaml 的模组都会冲突 — 加载顺序决定哪个生效。

---

已知限制

• 方格编号在 头部↔发型 标签页往返（1–2 次）后才会出现 — BG3 会回收方格，只在标签页重建时重新绘制标签。每次会话只需操作一次。
• 面板通过快捷键打开；不会自动打开（持续检查自动打开会增加后台开销，因此已移除）。
• 匹配项以编号显示，不会在网格中高亮 — 游戏的发型/头部集合在运行时是只读的，因此模组无法发光、隐藏或滚动到指定方格。方格编号 + 上一个/下一个 是变通方案。
• 游戏未归因于模组来源的选项显示为“原版 (Vanilla)”。
• CCHHS 必须在加载顺序中启用（不仅仅是 Overrides 面板）才能让脚本驱动功能生效。

---

鸣谢

• 作者： Serpentine (SerpentineShel)
• BG3 Script Extender： Norbyte
• BG3 ImprovedUI 及其补丁 8 分支的维护者
• Larian Studios — 本模组扩展的基础角色创建界面
• 感谢 BG3 模组社区提供的测试和反馈。

---

AI 使用声明

CCHHS 在开发过程中大量使用了 AI 编码助手（Anthropic 的 Claude）来协助编写代码、研究和文档。它不包含任何 AI 生成的艺术、图片、音频或其他媒体 — 仅包含代码和文字。所有设计决策、测试和最终发布均由作者完成。

---

源代码

CCHHS 是开源的。完整源代码（界面文件、Script Extender Lua、构建脚本、文档）在 GitHub 上： github.com/Shiney1965/BG3-CC-Mod-Head-and-Hair

---

许可证

MIT（原创 CCNS 代码/内容）。包含 Larian 角色创建界面文件的修改副本；请参阅下载包中的 LICENSE-THIRD-PARTY.md。

---

描述你的模组的主要用途