# shortcut-manager

**Repository Path**: DamonT/shortcut-manager

## Basic Information

- **Project Name**: shortcut-manager
- **Description**: 快捷键管理器
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-07
- **Last Updated**: 2026-05-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Shortcut Manager - 快捷键管理工具

一款功能完善的跨平台快捷键管理工具，允许用户自定义快捷键与对应操作的关联。

## 功能特性

### 核心功能
1. **快捷键自定义配置**
   - 支持设置组合键（如 Ctrl+1）与目标操作的映射
   - 支持的操作类型：
     - 启动指定应用程序
     - 打开指定文档文件
     - 打开特定项目目录

2. **冲突检测与管理**
   - 自动检测与系统快捷键的冲突
   - 提供冲突警告和解决方案建议

3. **激活状态机制**
   - 通过自定义激活按键（默认 Tab）触发激活状态
   - 仅在激活状态下自定义快捷键才生效
   - 非激活状态保持系统默认快捷键功能

## 技术架构

- **Electron**: 跨平台桌面应用框架
- **Node.js**: 后端逻辑处理
- **electron-store**: 配置持久化存储
- **globalShortcut**: 全局快捷键监听

## 项目结构

```
shortcut-manager/
├── src/
│   ├── main/
│   │   ├── index.js      # 主进程入口
│   │   └── preload.js    # 预加载脚本
│   └── renderer/
│       ├── index.html    # 主界面
│       ├── styles.css    # 样式文件
│       └── app.js        # 渲染进程逻辑
├── resources/            # 资源文件（图标等）
├── package.json          # 项目配置
└── README.md            # 项目说明
```

## 安装与运行

### 安装依赖
```bash
npm install
```

### 开发模式运行
```bash
npm start
```

### 打包构建
```bash
# Windows
npm run build:win

# macOS
npm run build:mac

# Linux
npm run build:linux

# 所有平台
npm run build
```

## 使用指南

### 基本配置
1. 打开应用后，点击 "Add Shortcut" 添加新快捷键
2. 设置快捷键组合（如 Ctrl+1）
3. 选择操作类型：
   - Application: 启动应用程序
   - Document: 打开文档
   - Directory: 打开目录
4. 输入或浏览目标路径
5. 保存配置

### 激活使用
1. 按下激活键（默认 Tab）进入激活状态
2. 状态栏显示 "Active" 表示已激活
3. 按下预设的快捷键触发对应操作
4. 再次按下激活键退出激活状态

### 冲突检测
1. 切换到 "Conflicts" 标签页
2. 点击 "Scan for Conflicts" 扫描冲突
3. 查看与系统快捷键的冲突列表
4. 修改冲突的快捷键配置

### 设置
- 在 "Settings" 标签页可修改激活键
- 默认激活键为 Tab
- 可设置为其他按键如 CapsLock、F1 等

## 快捷键格式

支持的快捷键格式：
- `Ctrl+1`, `Ctrl+Shift+A`, `Alt+F4`
- `F1` - `F12`
- `Tab`, `CapsLock`, `Space`
- 组合键：`Ctrl+Alt+Delete`

## 系统要求

- **Windows**: Windows 10 或更高版本
- **macOS**: macOS 10.14 或更高版本
- **Linux**: Ubuntu 18.04 或兼容发行版

## 注意事项

1. 部分系统快捷键（如 Ctrl+Alt+Delete）可能无法被覆盖
2. 建议避免使用与常用系统功能冲突的快捷键
3. 激活键设置后需要重启应用才能完全生效
4. 应用最小化后会驻留在系统托盘

## 开发计划

- [ ] 支持更多操作类型（脚本执行、URL打开等）
- [ ] 快捷键分组管理功能
- [ ] 导入/导出配置功能
- [ ] 多语言支持
- [ ] 快捷键使用统计

## License

MIT License