# ccshortcut

**Repository Path**: carlchai/ccshortcut

## Basic Information

- **Project Name**: ccshortcut
- **Description**: 一个快捷键管理工具
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-06-19
- **Last Updated**: 2025-08-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

---
title: 人生管理系统-事业-快捷键管理
Date: 2025-06-11
---

# 缘起 🚀

<details open>
    <summary>项目概述 ✨</summary>
    <p>一个简单的想法：用键盘完全控制电脑 🖥️</p>
    <ul>
        <li>用快捷键替代鼠标操作 🎯</li>
        <li>未来计划：结合OpenCV实现屏幕元素识别 👀</li>
        <li>未来计划：基于QT的C++版本 🚀</li>
        <li>当前：Python实现原型 💻</li>
    </ul>
</details>

![gif3](./images/gif3.gif)

# 计划 📋

![image-20250618153406990](./images/image-20250618153406990.png)

## 整体规划 🎯

<details open>
    <summary>系统架构设计 🏗️</summary>
    <p>本系统采用模块化设计，主要包含以下核心组件：</p>
    <ul>
        <li>键盘按键系统 ⌨️</li>
        <li>系统命令库 💻</li>
        <li>用户界面 🖥️</li>
        <li>快捷键管理 📝</li>
        <li>可视化操作界面 🎮</li>
        <li>命令映射系统 🔄</li>
    </ul>
</details>

<details open>
    <summary>键盘按键系统 ⌨️</summary>
    <p>支持多种类型的按键输入：</p>
    <pre><code class="language-python">
KEYS = {
    "修饰键": ["ctrl", "alt", "shift", "win"],
    "功能键": [f"f{i}" for i in range(1, 13)],
    "字母键": [chr(i) for i in range(ord('a'), ord('z')+1)],
    # ... 更多按键类型
}
    </code></pre>
</details>

![image-20250618153456328](./images/image-20250618153456328.png)

<details open>
    <summary>系统命令库 💻</summary>
    <p>预置丰富的系统级命令：</p>
    <pre><code class="language-python">
ACTIONS = {
    "系统控制": [
        {"name": "打开任务管理器", "command": "taskmgr", "func": command_cfg_execute_action_OpenTaskManager},
        {"name": "打开控制面板", "command": "control", "func": command_cfg_execute_action_OpenControlPanel},
        # ... 更多系统命令
    ],
    # ... 更多命令类别
}
    </code></pre>
</details>

![image-20250618153517304](./images/image-20250618153517304.png)

<details open>
    <summary>用户界面 📝</summary>
    <p>提供友好的用户交互界面：</p>
    <ul>
        <li>快捷键选择器 🎯</li>
        <li>命令选择器 📋</li>
        <li>实时预览功能 👀</li>
    </ul>
    <pre><code class="language-python">
def display_ui_user_shortcut_operate_actions_combobox_init(combobox):
    actions = database_actions_get()
    action_list = [item['name'] for category in actions.values() for item in category]
    combobox['values'] = [''] + sorted(action_list)
    </code></pre>
</details>

![image-20250618153532004](./images/image-20250618153532004.png)

<details open>
    <summary>快捷键管理 📊</summary>
    <p>提供完整的快捷键管理功能：</p>
    <ul>
        <li>显示已配置的快捷键 📋</li>
        <li>支持编辑和删除 ✏️</li>
        <li>快捷键冲突检测 ⚠️</li>
    </ul>
</details>

<details open>
    <summary>可视化操作界面 🎮</summary>
    <p>提供直观的可视化操作：</p>
    <ul>
        <li>按键可视化选择 🎯</li>
        <li>命令可视化选择 📋</li>
        <li>一键配置功能 ⚡</li>
    </ul>
</details>

<details open>
    <summary>命令映射系统 💾</summary>
    <p>采用优雅的数据库驱动设计：</p>
    <pre><code class="language-python">
def command_cfg_execute_action(action):
    # 从数据库获取所有可用动作
    actions = database_actions_get()
    # 遍历查找并执行对应动作
    for category in actions.values():
        for item in category:
            if item["name"] == action and item["func"]:
                item["func"](action)
                return
    </code></pre>
    <p>特点：</p>
    <ul>
        <li>模块化设计</li>
        <li>易于扩展</li>
        <li>维护简单</li>
    </ul>
</details>
![image-20250618153655096](./images/image-20250618153655096.png)

## 使用示例 📝

<details open>
    <summary>创建快捷键示例 🎯</summary>
    <p>让我们以创建 <code>alt+shift+z</code> 快捷键来打开运行为例：</p>
    <h4>操作步骤 📋</h4>
    <ol>
        <li>在按键选择区依次点击：<code>alt</code>、<code>shift</code>、<code>z</code> ⌨️</li>
        <li>在命令选择区点击：<code>打开运行</code> 💻</li>
        <li>点击 <code>添加</code> 按钮 ➕</li>
        <li>在快捷键列表中查看新增的配置 ✅</li>
    </ol>
    <p>完成！现在你可以使用 <code>alt+shift+z</code> 来快速打开运行窗口了 🚀</p>
</details>
### 一、勾选对应的keys和actions

![image-20250618154541278](./images/image-20250618154541278.png)

### 二、点击add

![image-20250618154559902](./images/image-20250618154559902.png)

### 三、输入快捷键吧

![image-20250618154720398](./images/image-20250618154720398.png)


## 代码路径 📁

<details open>
    <summary>项目结构 📂</summary>
    <ul>
        <li>command/ - 命令处理模块 ⚙️</li>
        <li>database/ - 数据库模块 💾</li>
        <li>display/ - 界面显示模块 🖥️</li>
    </ul>
    <p>打包:pyinstaller --onefile --windowed --icon=database/icon.ico ccshortcut.py</p>
    <p>之后将database文件夹拷贝进exe目录</p>
</details>

## 代码仓库 🏗️

<details open>
    <summary>版本控制 📦</summary>
    <p>项目使用Git进行版本控制，代码托管在私有仓库中 🔒</p>
</details>

# 任务列表 📋

<details open>
    <summary><progress value="90" max="100"></progress> 实现快捷键管理工具的python原型</summary>
    <p>已完成 ✅</p>
</details>

<details open>
    <summary><progress value="10" max="100"></progress> 实现C++增强版本</summary>
    <p>开发中... 🚧</p>
</details>