# 键位图生成器
**Repository Path**: northland_studio/keymap-generator
## Basic Information
- **Project Name**: 键位图生成器
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-30
- **Last Updated**: 2026-01-30
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# ⌨️ 键盘键位图编辑生成工具
**专为 Minecraft 整合包作者设计的键盘键位图编辑和生成工具**
[](https://www.python.org/downloads/)
[](LICENSE)
[](https://github.com/yourusername/keymap-generator)
---
## 📖 目录
- [✨ 功能特点](#-功能特点)
- [🎯 截图预览](#-截图预览)
- [🚀 安装方法](#-安装方法)
- [💡 使用方法](#-使用方法)
- [📁 文件说明](#-文件说明)
- [👨💻 作者](#-作者)
- [📜 许可证](#-许可证)
- [🔄 更新日志](#-更新日志)
---
## ✨ 功能特点
### 🎨 支持多种键盘布局
| 布局类型 | 键位数量 | 适用场景 |
|:--------:|:--------:|:--------|
| **104键** | 104 | 标准全尺寸键盘 |
| **96键** | 96 | 紧凑型布局 |
| **87键** | 87 | TKL 无小键盘 |
### 🛠️ 强大的自定义功能
- ✅ **可视化键位编辑界面** - 直观易懂的图形化操作
- ✅ **全局配置选项**
- 🔧 键位大小、间距、圆角
- 🎨 键位背景色、边框色、文本色
- 🔤 自定义字体（支持系统字体）
- ✅ **单个键位自定义**
- 📝 自定义标签文本
- 💡 功能描述显示（键位名称下方显示功能，如：Q键显示"左探头"）
- 🎯 自定义键位颜色
- ✍️ 自定义文本颜色
- ✅ **便捷的导出功能**
- 📸 一键导出键位图为 PNG/JPG 图片
- 💾 配置保存和加载功能（JSON 格式）
---
## 🎯 截图预览
> *截图功能即将推出，敬请期待！*
---
## 🚀 安装方法
### 📋 环境要求
- **Python** 3.6 或更高版本
- **pip** 包管理器
### 📦 安装步骤
1. **克隆或下载本项目到本地**
```bash
git clone https://gitee.com/northland_studio/keymap-generator.git
cd 键位图编辑生成
```
2. **安装依赖包**
```bash
pip install -r requirements.txt
```
---
## 💡 使用方法
### 🎬 启动程序
```bash
python main.py
```
### 📖 操作指南
#### 1️⃣ 选择键盘布局
```
📍 位置：左上角下拉菜单
📋 选项：104键 / 96键 / 87键
```
#### 2️⃣ 全局配置
```
📍 位置：右侧"全局配置"选项卡
🔧 可调整项：
├── 键位大小
├── 键位间距
├── 圆角大小
├── 键位背景色
├── 键位边框色
├── 文本颜色
└── 字体设置
```
#### 3️⃣ 编辑单个键位
```
📍 位置：点击键盘上的任意键位 → 右侧"键位编辑"选项卡
🎨 可编辑项：
├── 自定义标签文本
├── 功能描述（如：左探头、右探头等）
├── 键位颜色
├── 文本颜色
└── 重置此键位
```
#### 4️⃣ 导出键位图
```
📍 位置：底部"导出键位图"按钮
📋 格式：PNG / JPG
💾 操作：选择保存位置 → 自动生成并保存
```
#### 5️⃣ 保存/加载配置
```
📍 位置：底部"保存配置"/"加载配置"按钮
📋 格式：JSON
💡 提示：保存当前所有设置，便于下次快速加载
```
---
## 📁 文件说明
| 文件名 | 描述 |
|:------|:-----|
| `main.py` | 主程序文件 |
| `keyboard_layouts.py` | 键盘布局数据定义 |
| `requirements.txt` | Python 依赖包列表 |
| `README.md` | 中文说明文档 |
| `README.en.md` | 英文说明文档 |
---
## 👨💻 作者
**🌟 北域工作室**
[](https://gitee.com/northland_studio)
---
## 📜 许可证
本项目仅供学习和个人使用。
---
## 🔄 更新日志
### 🎉 v1.3.5 (最新版本)
#### 优化
- 🔧 精确调整 104 键布局的占位键宽度，使各区域完美对齐
- 📐 重新计算各区域间距，确保主键盘、导航键、小键盘的正确对齐
- 🎯 统一各区域间隙为 0.5 个标准键宽，更符合真实键盘布局
---
### v1.3.4
#### 修复
- 🐛 修复切换键盘布局的问题：过滤掉占位键的自定义数据，避免切换时出错
- 🐛 修复 96 键布局的重复定义问题，删除多余的小键盘行
#### 优化
- ✨ 优化 104 键布局的占位键位宽度，使布局更精确
- 🔄 改进切换布局时的数据处理逻辑，确保数据正确迁移
---
### v1.3.3
#### 修复
- 🐛 修复切换键盘布局时的 RuntimeError 错误
#### 重大更新
- 🎨 重新设计 104 键布局：使用容器概念实现精确对齐
- 📦 将键盘分为三个主要区域：主键盘区、导航键区、小键盘区
- 📝 添加详细的布局注释，便于维护和修改
---
### v1.3.2
#### 优化
- 🎯 优化 104 键布局：调整占位键位位置和大小，更贴近真实键盘布局
- 📏 精确调整功能键分组的间距
- 🔗 优化导航键（Insert/Home/PgUp 等）与小键盘的对齐方式
---
### v1.3.1
#### 修复
- 🐛 修复预览区自适应缩放功能的 TypeError 错误
- 🐛 修复 QGraphicsView 与 QGraphicsScene 的集成问题
---
### v1.3.0
#### 新增功能
- ✨ 优化 104 键布局：添加占位键位实现真实 104 键布局效果，功能键分组显示
- 🔍 新增预览区自适应缩放功能：键盘自动缩放以适应窗口大小
- 🖱️ 支持拖拽滚动预览区域
- 🎨 优化键盘布局显示效果，更接近真实键盘
---
### v1.2.0
#### 优化
- 🔧 优化 104 键布局：将数字键盘移到右侧，更符合标准键盘布局
- 🌏 修复导出图片时中文显示乱码问题，添加中文字体支持
- 📝 修复原键名称消失问题，确保原键名称始终显示在第一行
- 📏 新增文字大小自适应功能：根据键位大小自动调节文字大小
- 🎨 优化导出图片的字体渲染效果
---
### v1.1.0
#### 新增功能
- 💡 新增功能描述功能：键位名称下方显示功能描述
#### 修复
- 🐛 修复导出图片时的 NameError 错误
---
### 🎊 v1.0.0 (初始版本)
#### 功能发布
- ✅ 支持 104 键、96 键、87 键布局
- ✅ 实现键位编辑和自定义功能
- ✅ 实现图片导出功能
- ✅ 实现配置保存/加载功能
---
**⭐ 如果这个项目对你有帮助，请给个 Star 支持！**
Made with ❤️ by 北域工作室