简体中文 · English

面向 AI 编程与桌面工作流的开放硬件入口

官方硬件 · 桌面客户端 · BLE 协议 · Awesome AhaKey · 受控硬件共创

AhaKey 是一个面向 AI 编程与桌面工作流的开放硬件项目。我们希望把键盘、语音输入、AI coding agent、桌面状态反馈和社区 workflow 连接起来，让开发者可以更自然地控制 Claude、Cursor、Codex 等 AI 编程工具。

AhaKey 不是只卖一个键盘，而是希望长期建设：

硬件入口
→ 桌面客户端
→ BLE 协议
→ 第三方客户端 / workflow
→ Awesome AhaKey
→ 受控硬件 / 固件共创

AhaKey 采用 “开源客户端 + 开放协议 + Awesome AhaKey 社区共创 + 受控硬件资料” 的分层开放机制。

我们默认开放：

• 官方桌面客户端源码
• BLE 协议文档
• 客户端开发示例
• Awesome AhaKey / 社区项目展示入口
• 第三方客户端、脚本、workflow、教程共创入口

第三方客户端、脚本、workflow、教程、非敏感硬件二创等，默认提交到 Awesome AhaKey；硬件 / 固件相关反馈、patch、proposal 和实验记录，走受控硬件源码访问计划。

PCB layout、Gerber、BOM、生产测试资料等更完整硬件资料不默认通过仓库开放，如确有需要请联系企业微信专人客服进一步沟通。

AhaKey 尊重用户对自己设备的本地控制权。
我们不会故意通过远程认证、云端锁定或固件更新，破坏已公开协议下的合理本地开发和第三方客户端使用。

提交 Hardware Source Access Program 表单时，请真实填写 GitHub 用户名。
如果申请通过，我们会根据表单里的 GitHub 用户名，把你加入对应的私有仓库。

进入 desktop/releases
→ 下载最新版本
→ 安装桌面客户端
→ 连接 AhaKey
→ 开始使用

入口：desktop/releases

进入 protocol
→ 阅读 BLE 协议
→ 参考 examples
→ 创建自己的 repo
→ 做出 demo
→ 提交到 awesome-ahakey

适合：

• 自己写 macOS / Windows 客户端
• 做 Cursor / Claude / Codex 工作流工具
• 做快捷键脚本
• 做 OLED / RGB / 配置工具
• 做自动化集成

入口：protocol

进入 desktop
→ 阅读 README
→ Fork 仓库
→ 修改代码
→ 本地测试
→ 提交 Pull Request

适合：

• 修 bug
• 改 UI
• 优化安装体验
• 增加 macOS / Windows 适配
• 改进官方默认体验

入口：desktop

进入 awesome-ahakey
→ 按模板提交项目
→ 社区收录
→ 优秀功能可进一步评估是否进入官方 desktop

适合：

• 第三方客户端
• 工具脚本
• 使用教程
• 工作流 preset
• 桌面 setup 展示
• 视频 / 图文教程
• 非敏感硬件二创，例如外壳、键帽、支架、桌面 setup

入口：awesome-ahakey

提交 Hardware Source Access Program 表单
→ 真实填写 GitHub 用户名
→ AhaKey 团队判断用途
→ 通过后邀请你的 GitHub 账号进入对应私有仓库
→ 查看官方基线源码
→ 本地学习、编译、调试和实验
→ 按协作流程提交硬件 / 固件反馈或 patch
→ AhaKey 团队 review

入口：AhaKey 硬件源码访问计划

简单理解：

不确定 → 先 Discussion
明确问题 → 提 Issue
客户端 / 文档已改好 → 提 Pull Request
做了独立项目或 workflow → 提到 awesome-ahakey
涉及官方硬件 / 固件源码 → 走 Hardware Source Access Program

这些文件不是新的用户入口，而是 AhaKey 社区的基础维护规则。
普通用户不需要一开始全部阅读；当你准备提 Issue、PR、报告安全问题或参与社区协作时，再查看对应文档即可。

你可以贡献：

• bug report
• 文档修正
• 安装教程
• macOS / Windows 客户端改进
• BLE 协议反馈
• 第三方客户端
• workflow / preset / 脚本
• 使用视频、截图、教程
• 非敏感硬件二创展示
• 固件问题反馈、patch、proposal、实验记录

建议尽量保持：

• 小步提交
• 说明清楚
• 有截图 / 日志 / demo 更好
• 不提交密钥、token、私人文件
• 大功能先 Discussion，再 PR
• 硬件 / 固件相关内容，先走 Hardware Source Access Program

如果你想了解 AhaKey、下载软件、购买设备、加入讨论或联系官方，可以从下面这些入口开始。

扫码加入中文社群 / 联系客服

微信公众号	微信讨论群	QQ 讨论群
关注公众号	加入微信讨论群	加入 QQ 讨论群
小红书群	企业微信客服	更多入口
加入小红书群	联系专人客服	ahakey.com 官网与下载入口

↑ Back to top

An open hardware entry point for AI coding and desktop workflows

Official Hardware · Desktop Client · BLE Protocol · Awesome AhaKey · Controlled Hardware Collaboration

AhaKey is an open hardware project for AI coding and desktop workflows. We connect keyboards, voice input, AI coding agents, desktop status feedback, and community workflows, so developers can control Claude, Cursor, Codex, and similar tools more naturally.

AhaKey is not just a keyboard. We are building:

Hardware entry point
→ Desktop client
→ BLE protocol
→ Third-party clients / workflows
→ Awesome AhaKey
→ Controlled hardware / firmware collaboration

AhaKey follows a layered openness model: open-source client + open protocol + Awesome AhaKey community collaboration + controlled hardware materials.

We open the official desktop client source code, BLE protocol documentation, client development examples, and Awesome AhaKey community showcase by default. We encourage developers to build their own clients, scripts, tools, and AI workflows based on the public protocol.

Third-party clients, scripts, workflows, tutorials, and non-sensitive hardware remixes should be submitted to Awesome AhaKey by default. Hardware / firmware feedback, patches, proposals, and experiments should go through the controlled hardware source access flow.

PCB layout, Gerber, BOM, production test materials, and other complete hardware production files are not provided through repositories by default. If needed, please contact AhaKey WeCom support for further discussion.

AhaKey respects users' local control over their own devices.
We will not intentionally use remote authentication, cloud lock-in, or firmware updates to break reasonable local development or third-party clients built on published protocols.

Please provide your real GitHub username when submitting the Hardware Source Access Program form.
If approved, we will use that GitHub username to invite you to the relevant private repository.

Go to desktop/releases
→ Download the latest version
→ Install the desktop client
→ Connect AhaKey
→ Start using it

Entry: desktop/releases

Go to protocol
→ Read the BLE protocol
→ Check examples
→ Create your own repo
→ Build a demo
→ Submit it to awesome-ahakey

Entry: protocol

Go to desktop
→ Read the README
→ Fork the repository
→ Modify the code
→ Test locally
→ Submit a Pull Request

Entry: desktop

Go to awesome-ahakey
→ Submit your project with the template
→ Get listed by the community
→ High-value features may later be evaluated for the official desktop

Entry: awesome-ahakey

Submit the Hardware Source Access Program form
→ Provide your real GitHub username
→ AhaKey team reviews the purpose
→ Your GitHub account may be invited to the relevant private repository
→ Read the official baseline source
→ Learn, build, debug, and experiment locally
→ Submit hardware / firmware feedback or patches through the controlled collaboration flow
→ AhaKey team reviews it

Entry: AhaKey Hardware Source Access Program

Simple rule:

Not sure → Discussion
Clear problem → Issue
Client / docs already changed → Pull Request
Built an independent project or workflow → awesome-ahakey
Official hardware / firmware source involved → Hardware Source Access Program

These files are not extra entry points for new users.
They are the basic rules and support files that help keep the AhaKey community maintainable.

You can contribute:

• bug reports
• documentation improvements
• installation guides
• macOS / Windows client improvements
• BLE protocol feedback
• third-party clients
• workflows / presets / scripts
• videos, screenshots, and tutorials
• non-sensitive hardware remixes
• firmware feedback, patches, proposals, and experiments

Please try to keep contributions:

• small and reviewable
• clearly explained
• accompanied by screenshots / logs / demos when helpful
• free of secrets, tokens, or personal files
• discussed first if the feature is large
• hardware / firmware related contributions should go through the Hardware Source Access Program

If you want to learn about AhaKey, download software, buy the device, join discussions, or contact the team, start here.

Chinese community QR codes / support contact

WeChat Official Account	WeChat Group	QQ Group
Follow us	Join WeChat group	Join QQ group
Xiaohongshu Group	WeCom Support	More
Join Xiaohongshu group	Contact support	ahakey.com Website and downloads

↑ Back to top