CRM 快捷键
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md 的指南,将规范名 @user_f1b049da/rjvx2026647 的技能安装到 AI 助手中。
技能介绍
键盘操作的隐形障碍
在 CRM 系统中,业务员高频执行新建客户、搜索、保存等操作。如果每次都依赖鼠标点击菜单,不仅打断思路,还会拖慢数据录入节奏。然而,直接引入全局快捷键往往带来误触问题——当用户在搜索框或备注输入框中打字时,按下的字符或组合键(如 Ctrl+K)可能会意外触发页面级指令,导致输入丢失或页面跳转。
基于 hotkeys-js 的绑定机制
该技能基于 hotkeys-js 库封装了一套安全的快捷键管理方案。核心能力包括提供可配置的映射表,结构定义为 { combo, actionId, handler }。在实现上,推荐开发者将绑定与解绑逻辑接入路由页的 onMounted 与 onUnmounted 生命周期钩子中,确保组件卸载时调用 hotkeys.unbind 防止内存泄漏。
针对输入冲突,技能内置了严格的过滤机制。默认情况下,它会在 INPUT、TEXTAREA、SELECT 及 contenteditable 等元素内忽略全局快捷键,避免打字时误触发作。对于「保存」这类需要跨输入框触发的场景,允许按需配置例外,但必须在代码注释或文档中明确说明。此外,当多个动作绑定相同组合键时,后注册的规则将覆盖前者,并在控制台输出 console.warn 提醒开发者。
边界与风险控制
在集成时需注意,技能不会拦截浏览器的关键系统键(如 Ctrl+W 关闭标签页),除非业务有极其特殊的硬性需求且开发者已充分评估风险。同时,建议在界面中提供快捷键帮助面板,并根据操作系统自动适配展示符号,macOS 显示 ⌘,Windows 展示 Ctrl,降低用户的学习成本。
使用场景
- CRM 列表页需要频繁新建客户、保存记录,想通过键盘快速触发操作
- 业务员在搜索框输入关键词时,不希望按 Ctrl+K 等快捷键意外触发搜索
- 需要为 CRM 系统的保存客户操作绑定快捷键,且在输入框内不冲突
- 团队希望统一快捷键展示样式,Mac 显示 ⌘、Windows 显示 Ctrl
适合人员
- 前端开发者,需要为 CRM 系统集成安全的快捷键功能,处理绑定与解绑逻辑
- CRM 产品经理,计划设计键盘操作规范,需要明确快捷键的触发规则与冲突处理
- 全栈开发者,正在开发 CRM 模块,需要将快捷键功能接入路由页生命周期
- 测试工程师,负责验证 CRM 系统的快捷键功能,需确认输入框内不误触、动作可正常触发