一、核心功能

• 热键映射与自定义配置加载：读取注册表及配置文件中的按键映射表，将 Fn 组合键、功能键上报的原始扫描码解析为对应的功能指令，使用户自定义的快捷键方案可以生效。
• OSD 屏幕提示渲染：调用渲染接口在屏幕指定位置绘制亮度、音量、麦克风静音、无线开关等状态提示条，并处理淡入淡出、透明度、偏移定位以及多显示器环境下的落点计算。
• 回调注册与消息分发：以导出函数和组件接口的形式，向热键服务、Lenovo Vantage 等上层程序暴露回调注册点，实现插件式的功能扩展。
• 资源本地化与图标索引：依据系统语言标识动态加载对应的字符串与图标资源，保证提示内容随系统语言切换。
• 配置校验与策略回退：对自定义配置进行合法性检查，遇到格式错误或缺失项时回退至出厂默认方案，避免功能整体失效。

Fn 热键失灵或响应迟滞：按击亮度、音量、投影切换等组合键时无动作，或需要长按多次才有反应，硬件本身的驱动往往仍在工作，但界面反馈链路已断开。

OSD 提示缺失或异常：屏幕上不再弹出状态提示条；也可能出现空白方框、乱码字符或图标错位，因为本地化资源无法被正确索引。

启动阶段报错弹窗：常见提示包括“找不到 TPFCustom.dll”或“应用程序无法正常启动（0xc000007b）”，多由文件被杀毒软件误删、系统升级覆盖或版本不匹配引起。

依赖组件加载失败：热键服务、Lenovo Vantage 及部分系统托盘常驻进程在启动时调用该模块失败，可能表现为程序闪退、功能面板空白。

事件日志记录错误：系统“应用程序”日志中会反复出现模块加载失败条目，长期积累会干扰其他故障的排查定位。

自定义设置丢失：用户此前配置的热键方案与 OSD 样式无法被读取，重启后仍回落到默认状态。