Keychron/Keychron-Keyboards-Hardware-Design
GitHub: Keychron/Keychron-Keyboards-Hardware-Design
Keychron官方开源的生产级键盘与鼠标工业设计文件合集，涵盖135+型号的CAD资源，支持社区学习、改装和兼容配件开发。
Stars: 3354 | Forks: 264
# Keychron 硬件设计
[](https://github.com/Keychron/Keychron-Keyboards-Hardware-Design)
[](https://github.com/Keychron/Keychron-Keyboards-Hardware-Design)
[](https://github.com/Keychron/Keychron-Keyboards-Hardware-Design/tree/main/docs)
[](https://github.com/Keychron/Keychron-Keyboards-Hardware-Design)
Keychron 键盘和鼠标的生产级硬件设计文件。
研究真实的 CAD。混合改造定位板和外壳。设计兼容配件。从真实产品的构建方式中学习。
## 最新更新
- **2026-05-08:** 添加了 BM25 和更多 K3 Pro 文件。
- **2026-05-07:** 将文件下载链接移至对应产品型号文件夹内“Readme 文件”的“下载部分”。**添加了更多 K3 Pro 文件。
- **2026-04-29:** 添加了更多 K4 Pro 和 K8 Pro 文件。
- **2026-04-28:** 添加了 K6 HE、Q10 Max、Q60 Max 和 Q65 Max 文件。
- **2026-04-27:** 添加了 K8 文件。
- **2026-04-24:** 添加了 Q0 Max、Q5 Max、Q12 Max、Q13 Max、Q15 Max 和 K8 QMK 文件。
- **2026-04-22:** 添加了 V3 和 V3 8K 文件。
- **2026-04-21:** 添加了更多 K7 Pro 文件。
- **2026-04-17:** 添加了 Q1 Max、Q8 Max 和 Q14 Max 文件。
- **2026-04-14:** 添加了更多 P6 Ultra 8K、K10 QMK 和 B6 Pro 文件。
- **2026-04-13:** 添加了 P6 Ultra 8K、K2 QMK、K10 QMK 文件。
- **2026-04-12:** 添加了 V1 8K、V3 8K、V5 8K 和 V6 8K 系列文件夹及 README 页面。
- **2026-04-12:** 添加了 V0 Ultra 8K、V1 Ultra 8K、V3 Ultra 8K、V5 Ultra 8K、V6 Ultra 8K 和 V10 Ultra 8K 系列文件夹及 README 页面。
- **2026-04-12:** 添加了 Q1 HE 8K、Q2 HE 8K、Q3 HE 8K、Q5 HE 8K、Q6 HE 8K 和 Q16 HE 8K 系列文件夹及 README 页面。
- **2026-04-12:** 添加了 Q1 Ultra 8K、Q3 Ultra 8K、Q5 Ultra 8K 和 Q13 Ultra 8K 系列文件夹及 README 页面。
- **2026-04-11:** 添加了 C3 Pro 8K、K4 HE、K8 HE、K2 QMK、Q0 HE 和 Q12 HE。
- **2026-04-10:** 添加了更多 K0 Max 文件、Q12 HE 和更多 Q6 Max 文件以及更多键帽轮廓。
- **2026-04-09:** 添加了 K10 HE、Q6 Max 和 K0 Max 设计文件。更新：使配件不受许可证限制。
- **2026-04:** 添加了 Q HE 和鼠标设计文件。
- **2026-03:** 扩展了 K Max 系列的覆盖范围。
- 更多里程碑更新将发布在 [GitHub Releases](https://github.com/Keychron/Keychron-Keyboards-Hardware-Design/releases) 中。
## 从这里开始
如果您是新手，请从以下途径之一开始：
- **浏览键盘文件**
探索 C Pro 8K、Q、Q Pro、Q HE、Q Max、Q Ultra 8K、K Pro、K Max、K HE、K QMK、V Max 和 P HE 型号。
- **浏览鼠标文件**
探索 M 和 G 系列鼠标的外壳和完整型号文件。
- **在 CAD 软件中打开文件**
阅读 [文件格式指南](docs/file-format-guide.md) 以了解 STEP、DWG、DXF 和 PDF 的兼容性。
- **了解如何混合改造或修改设计**
从 [入门指南](docs/getting-started.md) 开始。
- **查看当前文件系统清单**
打开从仓库本身生成的 [仓库清单](docs/repo-inventory.md)。
- **贡献修复或改进**
阅读 [贡献指南](docs/CONTRIBUTING.md) 以了解工作流程、文件标准和提交规则。
- **加入社区**
加入 [Keychron Discord](https://discord.com/invite/HAYbRrTsjN) 来分享您的构建、提出问题，并帮助发展硬件改装社区。
- **在构建之前了解许可证**
阅读 [许可证常见问题解答](docs/license-faq.md)。
## 您可以对此仓库做些什么
- 研究真实的工业设计和硬件封装文件
- 创建外壳、定位板和配件的混合改造
- 检查尺寸、结构和组件集成
- 构建社区模组和兼容的附加组件
- 贡献符合许可证的文档、更正和新变体
## 包含内容
| 系列 | 类型 | 型号 | 组件 |
|---|---|---|---|
| **C Pro 8K 系列** | 键盘 | C1 Pro 8K, C2 Pro 8K, C3 Pro 8K | 外壳, 定位板, 完整模型, 卫星轴 |
| **Q 系列** | 键盘 | Q0 Plus, Q1–Q12, Q60, Q65 | 外壳, 定位板, 旋钮, 完整模型, 卫星轴, OSA 键帽 |
| **Q Pro 系列** | 键盘 | Q1 Pro–Q14 Pro (10 个型号) | 外壳, 定位板, 旋钮, 完整模型, 卫星轴, KSA 键帽 |
| **Q HE 系列** | 霍尔效应 | Q0 HE, Q1 HE, Q2 HE, Q3 HE, Q4 HE, Q5 HE, Q6 HE, Q12 HE | 特定型号的已发布文件；较新的 Q HE 文件夹也包含用于未来 CAD 上传的 README/型号页面 |
| **Q HE 8K 系列** | 霍尔效应 | Q1 HE 8K, Q2 HE 8K, Q3 HE 8K, Q5 HE 8K, Q6 HE 8K, Q16 HE 8K | 为未来的 CAD 上传准备了 README/型号页面 |
| **Q Max 系列** | 键盘 | Q0 Max, Q1 Max, Q2 Max, Q3 Max, Q5 Max, Q6 Max, Q8 Max, Q10 Max, Q12 Max, Q13 Max, Q14 Max, Q15 Max | 已发布 Q6 Max 的 CAD 文件；其他型号已准备 README/型号页面 |
| **Q Ultra 8K 系列** | 键盘 | Q1 Ultra 8K, Q3 Ultra 8K, Q5 Ultra 8K, Q6 Ultra 8K, Q13 Ultra 8K | 已发布 Q6 Ultra 8K 的定位板文件；其他型号已准备 README/型号页面 |
| **K Pro 系列** | 键盘 | K1 Pro–K17 Pro (16 个型号) | 外壳, 定位板, 完整模型, 卫星轴 |
| **K Max 系列** | 键盘 | K0 Max, K1 Max, K2 Max, K3 Max, K4 Max, K5 Max, K7 Max, K8 Max, K9 Max, K10 Max, K11 Max, K13 Max, K15 Max, K17 Max | 外壳, 定位板, 完整模型, 卫星轴, 特定型号的键帽；为 K4 Max 和 K9 Max 准备了 README/型号页面 |
| **K HE 系列** | 霍尔效应 | K2 HE, K4 HE, K6 HE, K8 HE, K10 HE | 已发布型号包含外壳、定位板、完整模型、卫星轴和特定键帽文件；K6 HE 目前仅有文件夹 |
| **K QMK 系列** | 键盘 | K1 QMK, K2 QMK, K3 QMK, K4 QMK, K5 QMK, K8 QMK, K10 QMK | 已发布 K2 QMK 的 CAD 文件；其他型号已准备 README/型号页面 |
| **L 系列** | 键盘 | L1, L3 | 外壳, 定位板, 旋钮, 完整模型, 卫星轴 |
| **V 8K 系列** | 键盘 | V1 8K, V3 8K, V5 8K, V6 8K | 为未来的 CAD 上传准备了 README/型号页面 |
| **V Ultra 8K 系列** | 键盘 | V0 Ultra 8K, V1 Ultra 8K, V3 Ultra 8K, V5 Ultra 8K, V6 Ultra 8K, V10 Ultra 8K | 为未来的 CAD 上传准备了 README/型号页面 |
| **V Max 系列** | 键盘 | V1 Max–V10 Max | 外壳, 定位板, 旋钮, 完整模型, 卫星轴, OSA 键帽 |
| **P HE 系列** | 霍尔效应 | P1 HE, P2 HE, P3 HE | 已发布 P1 HE 的文件；为 P2 HE 和 P3 HE 准备了 README/型号页面 |
| **鼠标系列** | 鼠标 | M1–M7, G1, G2 (11 个型号) | 外壳, 完整模型 |
**135 个设备型号。734+ 份设计文件。源码可见。对配件友好。**
## 目录结构
```
C-Pro-8K-Series/
C3 Pro 8K/ — Wired C Pro 8K hardware files, with C1 Pro 8K and C2 Pro 8K also present
Q-Series/
Q0 Plus/ — Numpad files alongside Q1–Q12, Q60, and Q65
Q-HE-Series/
Q0 HE/ — Hall Effect numpad files alongside Q1, Q2, Q3, Q4, Q5, Q6, and Q12 HE models
Q-HE-8K-Series/
Q1 HE 8K/ — README and product page reference, ready for future CAD uploads alongside Q2, Q3, Q5, Q6, and Q16 HE 8K
Q-Pro-Series/
Q1 Pro/ — Wireless Q-series hardware files across 10 models
Q-Max-Series/
Q0 Max/ — README and product page reference, with Q1, Q2, Q3, Q5, Q6, Q8, Q10, Q12, Q13, Q14, and Q15 Max model folders also present
Q-Ultra-8K-Series/
Q1 Ultra 8K/ — README and product page reference, ready for future CAD uploads alongside Q3, Q5, Q6, and Q13 Ultra 8K
K-Pro-Series/
K1 Pro/ — Low-profile and standard K Pro models through K17 Pro
K8 Pro/ — Example model folder with `K8-Pro-Keycap.stp`
K-Max-Series/
K0 Max/ — Numpad files alongside K1, K2, K3, K4, K5, K7, K8, K9, K10, K11, K13, K15, and K17 Max keyboard model folders
K-HE-Series/
K2 HE/ — Example model folder with Cherry and OSA keycap STEP files
K-QMK-Series/
K1 QMK/ — README and product page reference, with K2, K3, K4, K5, K8, and K10 QMK model folders also present
V-Max-Series/
V1 Max/ — Tri-mode keyboard hardware files across V1–V10 Max
V-Ultra-8K-Series/
V0 Ultra 8K/ — README and product page reference, ready for future CAD uploads alongside V1, V3, V5, V6, and V10 Ultra 8K
V-8K-Series/
V1 8K/ — README and product page reference, ready for future CAD uploads alongside V3, V5, and V6 8K
P-HE-Series/
P1 HE/ — Lemokey Hall Effect keyboard files, with P2 HE and P3 HE model pages also present
L-Series/
L1/ — Aluminum keyboard files with plate, case, knob, and stabilizers
Mice/
M1/ — Shell and full model
Keycap Profiles/
Cherry Profile/ — Reference profile docs alongside KSA, LSA, MDA, OEM, and OSA
docs/
file-format-guide.md — How to open and edit these files
getting-started.md — First-stop guide for browsing and remixing
3d-printing-guide.md — Practical printing guidance for compatible parts
CONTRIBUTING.md — Contribution workflow and file standards
CODE_OF_CONDUCT.md — Community participation guidelines
scripts/
repo_inventory.py — Regenerates the repository inventory from the live tree
```
## 为什么这很重要
公开生产级别的硬件文件是对更广泛的硬件和键盘社区的一项有意义的贡献。
- 它降低了入门门槛，为爱好者、学生和工程师提供了真实的 STEP 和 DXF 文件，他们可以对其进行研究、混合改造和在此基础上构建，而不是从零开始。
- 它扩展了定制的可能性。有了外壳、定位板和组件设计的访问权限，社区可以探索更深层次的硬件更改、新材料、结构调整和原创变体。
- 它提供了真正的教育价值。这些是生产级别的设计，人们可以从安装系统、公差和组件集成等实际决策中学习。
- 它通过支持基于现有设计的兼容配件、修改和个人项目，帮助生态系统发展。
- 它也体现了信任和透明度。分享内部设计文件展示了对产品的信心，并将用户作为创造者而不仅仅是客户来支持。
该许可证旨在支持 Keychron 产品周围的生态系统，同时仍保护 Keychron 的核心硬件业务。实际上，原创的兼容配件和附加组件不受此许可证中商业用途限制的约束，但复制和销售 Keychron 键盘或鼠标，或利用 Keychron 商标进行交易是不允许的。
## 许可证
本项目是**源码可见**的。这些文件可用于个人和教育工作。原创的兼容配件和附加组件不受此许可证中商业用途限制的约束。
**您不得使用这些文件来复制、制造、销售或分发 Keychron 键盘或鼠标，或实质性相似的产品，您也不得将 Keychron 商标用作您自己的品牌。**
有关完整条款，请参阅 [LICENSE](LICENSE) 文件。
## 链接
- [Keychron 官网](https://www.keychron.com)
- [Keychron Discord 社区](https://discord.com/invite/HAYbRrTsjN)
- [Keychron 固件 (QMK, main 分支)](https://github.com/Keychron/qmk_firmware/tree/master/keyboards/keychron)
- [Keychron 固件 (蓝牙主板)](https://github.com/Keychron/qmk_firmware/tree/bluetooth_playground/keyboards/keychron)
- [Keychron 固件 (2.4 GHz 无线主板)](https://github.com/Keychron/qmk_firmware/tree/wireless_playground/keyboards/keychron)
- [Keychron 固件 (霍尔效应主板)](https://github.com/Keychron/qmk_firmware/tree/hall_effect_playground/keyboards/keychron)
- [Keychron 固件 (ZMK)](https://github.com/Keychron/zmk)
- [开源游戏鼠标固件 (ZGM）](https://zgm.gg/)
*由 [Keychron](https://www.keychron.com) 构建 — 面向社区的源码可见硬件设计文件。*
标签：3D建模, CAD文件, DWG文件, DXF文件, Keychron, STEP文件, 产品设计, 周边配件开发, 客制化键盘, 工业设计, 工程制图, 开源图纸, 开源硬件, 机械图纸, 电脑外设, 硬件设计, 结构设计, 键盘客制化, 键盘设计, 鼠标设计