README.md

LingYaoKeys - 灵曜按键

✨基于.NET8.0+WPF开发的灵动、优雅的开源按键工具✨

简体中文 / English

❤ 如果喜欢本项目可右上角送作者一个Star🌟 ❤

✨ 主要功能

🎮 基础功能

• 支持全局热键，支持侧键滚轮触发
• 支持窗口句柄嗅探
• 支持顺序/按压模式触发按键
• 支持开启/停止语音提醒
• 支持正常/游戏模式切换
• 支持自定义开启/停止音频
• 支持按键列表拖拽排序
• 支持浮窗置顶显示按键启动状态

🚀 驱动特性

• 基于DeviceIoControl内核级驱动实现
• 支持离线运行
• 完善的反Hook和内存保护机制
• 支持32位/64位系统架构
• 支持USB/PS2键鼠设备
• 兼容Win7/Win10/Win11系统
• 支持驱动热插拔，程序退出无痕卸载

🌏 直接下载

您可以从以下位置下载最新版本：

• 最新版本下载
• 查看所有版本

注意：请始终从 GitHub Releases 页面下载最新版本，以确保获得最新的功能和安全更新。

📖 使用说明

Important

经过长时间的测试并且结合其他按键的测试结果，按键速度每秒高于两三百的话会导致按键响应延迟或者造成卡位移(看自己cpu内存性能)，原因可能是windows的消息机制导致的，所以玩游戏的话按键速度，不需要太快。根据测试结果我取了一个合适的区间，所以就加入了针对游戏进行优化的游戏模式
DEFAULT_KEY_PRESS_INTERVAL：按键按下到松开的固定时间
MIN_KEY_INTERVAL: 最小可设置的按键间隔

• 游戏模式打开(默认)：测试后平均按键速度为120+，适用于游戏内
• 游戏模式关闭：解除按键速度限制平均速度320+，适用于一般场景
• 自定义音频：打开 C:\Users\用户\.lykeys\sound，保持文件名替换 start.mp3/stop.mp3 即可

📃常见问题

因为本项目使用的微软最新的.Net Core 8.0，有部分用户可能需要下载内核

🖼️ 项目展示

🎙 关于与建议

• 该项目是本人利用工作之余首次尝试使用C#和WPF以及Cursor AI技术栈进行开发的实践项目
• 目前项目处于开发初期，新功能正在持续添加中，如果你对软件有任何功能与建议，欢迎在 Issues 中提出，如果对项目感兴趣，欢迎参与讨论
• 如果你也喜欢本软件的设计思想，欢迎提交 pr，非常感谢你对本项目的支持！

⚙️ 开发相关

运行

• dotnet run

发布打包

• dotnet publish -c Release

🔧 驱动使用说明

驱动文件说明

• Resource\lykeysdll\lykeysdll.dll: 核心驱动动态链接库(*必须)
• Resource\lykeysdll\lykeys.sys: 内核级驱动文件(*必须)
• Resource\lykeysdll\lykeys.cat: 驱动签名文件
• Resource\lykeysdll\README.md: 驱动接口&调试说明
• Resource\lykeysdll\csharp_example\*: C#示例代码
• Resource\lykeysdll\python_example\*: Python示例代码

⚠️ 注意事项

1. 驱动签名

   • 驱动已通过正版签名认证
   • 请勿修改驱动文件，否则会导致签名失效

2. 系统要求

   • 支持 Windows 7/10/11 (x86/x64)
   • 需要管理员权限运行

3. 使用限制

   • 仅供个人学习研究使用
   • 禁止修改或反编译驱动文件

☕️ Buy me a coffee

♥ 驱动签名为自费购买，如果您喜欢这个项目可以支持一下作者，这将是对我极大的鼓励 ♥

📢 免责声明

• 仅供个人学习研究使用，禁止用于商业及非法用途
• 开发者拥有本项目的最终解释权
• 严禁用于任何违反中华人民共和国(含台湾省)或使用者所在地区法律法规的用途
• 请使用者在使用本项目时遵守相关法律法规，不要将本项目用于任何商业及非法用途。如有违反，一切后果由使用者自负。 同时，使用者应该自行承担因使用本项目而带来的风险和责任。本项目开发者不对本项目所提供的服务和内容做出任何保证
• 若您遇到商家使用本软件进行收费，产生的任何问题及后果与本项目无关

📜 开源许可

LingYaoKeys 使用 GNU General Public License v3.0 开源许可证

Copyright © 2025 by Cassianvale.