哈基米机 HachimoDock：给AI Agent一个身体
简介
哈基米机通过桌宠形象把Agent（如Codex/CC/龙虾等）后台工作状态呈现出来，让你清晰感知到任务完成情况。 此外还有语音下发指令、自定义桌形象、自定义小组件等玩法，让哈基米陪你工作。
简介：哈基米机通过桌宠形象把Agent（如Codex/CC/龙虾等）后台工作状态呈现出来，让你清晰感知到任务完成情况。 此外还有语音下发指令、自定义桌形象、自定义小组件等玩法，让哈基米陪你工作。开源协议
：GPL 3.0
(未经作者授权，禁止转载)描述
HachimoDock（哈基米机）
一只看得见、摸得着的桌面 AI 搭子 —— 把 CLI Agent 的状态变成桌上小宠物的表情和动作，抬头一眼就知道它在做什么。
这是什么
HachimoDock（哈基米机）是一块放在桌上的 Agent 专属小屏。它把电脑里运行的各类 Agent（Codex、Claude Code、OpenClaw 等）变成工位上的一只小宠物 —— 不是看不见摸不着的「虚拟助理」，而是有状态、有回应、有存在感的 AI 搭子。
Agent 状态跟随
Agent 在思考，它跟着思考；在调工具，它开始干活；任务完成它庆祝，报错它发愁。
抬头可见
状态、进度、要你拍板的事，都变成一眼能懂的表情、动作和短标签。
开口即用
不用切窗口、找聊天框，开口就能安排活儿：办公、写作、开发、查资料、记想法。
核心亮点
01状态实时跟随
桌面端与设备屏实时同步，Agent 在做什么，看屏上的表情、动作、颜色和短标签就知道；状态一变，还会弹出字幕提醒。
02空闲与触摸反馈
Agent 闲下来时，它会自己玩耍，时不时换个待机小动作；触摸反馈当前在 Raspberry Pi 方案中已验证，Radxa A7Z 方案预留 XPT2046/PEN 接线与后续 overlay 接入。
03语音交互
Raspberry Pi 方案已接入按住说话与语音转文本链路，可把板端语音输入送到 Codex、Claude Code、OpenClaw 等 Agent；Radxa A7Z 方案当前只保留音频硬件选型和软件扩展位。
04自定义形象
内置一只西高地小狗（16 组状态动画）。上传宠物照片、头像或原创角色，就能生成自己的形象；也可以从 pet 社区导入网友的作品。
05自定义组件
内置摸鱼倒计时、番茄钟、喝水提醒、Token 消耗四个组件。想要新的？在组件中心用自然语言生成 .clawpkg，并在 USB 或 SSH/MQTT 链路可用时下发到设备上。
硬件复刻
3.0 两种硬件方案
| 方案 | 定位 | 当前已验证 | 当前未默认启用 |
|---|---|---|---|
| 方案一：Radxa Cubie A7Z | 默认复刻硬件，性能更高，推荐走 Wi-Fi + MQTT/SSH | Debian 11/12、ILI9341 SPI LCD、/dev/fb0 显示、HTTP/MQTT、桌面端状态同步、负一屏 widget | XPT2046/PEN 触摸 overlay、GPIO 旋钮/按钮、板端语音 PTT、USB gadget /dev/ttyGS0 |
| 方案二：Raspberry Pi Zero 2W | 兼容方案，适合完整体验 USB 直连、触摸、旋钮和语音 | Raspberry Pi OS、ILI9341 SPI LCD、XPT2046/ADS7846 触摸、GPIO 旋钮/按钮、VoiceHAT 语音、USB gadget、HTTP/MQTT、负一屏 widget | 音频设备名、网络和供电稳定性取决于实际镜像、声卡与现场配置 |
// ESP32 暂不是当前 board-runtime 已支持目标；需要单独移植
3.1 整机物料清单（方案一 Radxa A7Z）
// 数量为单套用量 · 点击器件名可打开参考购买链接
| 类别 | 模块 / 器件 | 接口 / 位号 | 数量 | 单价 | 备注 |
|---|---|---|---|---|---|
| 开发板 | 瑞莎 Radxa Cubie A7Z ↗ | 主板 | ×1 | ¥162 | 八核全志 SOC 迷你主板、双屏显示；性能约树莓派 Zero 2W 数倍，尺寸结构与树莓派兼容 |
| SD 卡 | microSD 卡 16G ↗ | TF 卡槽 | ×1 | ¥16.32 | 16GB，A1/A2 级别优先 |
| 屏幕 | 中景园 2.8″ 240×320 SPI TFT 触摸屏 ↗ | 插入 U2 | ×1 | ¥44.60 | ILI9341；A7Z 当前验证显示，XPT2046 触摸预留后续接入 |
| 旋钮 | 可按下旋钮模块 / EC11 编码器模块 ↗ | 接 H2 | ×1 | ¥7.59 | 下单前确认轴长 / 安装方向 |
| 麦克风模块 | INMP441 麦克风模块 ↗ | 接 H1 | ×1 | ¥2.42 | 外挂模块方案（杜邦线接板，免贴片） |
| 喇叭 | 1224 小腔体喇叭（1.25 端子，带双面胶） ↗ | 接 CN7 | ×1 | ¥4.50 | 1224 8Ω 1.25P |
| 麦克风 | 敏芯微 I2S 硅麦克风 MSM261S3526Z0CM ↗ | 底板贴片 | ×1 | ¥3.99 | 底板贴片方案；不外挂模块时用 |
| 功放 | MAX98357A I2S 音频放大器模块 ↗ | 外挂功放 | ×1 | ¥5.10 | 外挂模块方案；不贴片时用，杜邦线接板 |
| 转接线 | Type-C 公上下弯转 Type-C 母直 ↗ | 设备引出 | ×1 | ¥16.40 | Radxa 主控引出 USB-C |
| 线材辅料 | 杜邦线 ↗ | 按钮/旋钮/麦克风 | — | ¥5（估） | 嘉立创商城有 |
| 结构辅料 | 自攻螺丝 M2×8mm | 屏幕固定 | ×4 | ¥1（估） | 商城有 |
| 结构辅料 | 自攻螺丝 M2×5mm | 结构固定 | ×8 | ¥1（估） | 商城有 |
| 外壳结构 | 3D 打印 / CNC 外壳 ↗ | 整机结构 | ×1 | — | 外壳 / 后盖 / 内部固定支架 |
| 定制底板 | HachimoDock（哈基米机）定制 PCB 底板 ↗ | 各模块中转 | 按需投板 | — | 减少杜邦线；底板兼容贴片与外挂模块两种方案 |
// 链接仅供参考，下单前请核对型号；价格与库存以平台页面为准
🛒 一键淘宝购物车导入（点击展开）
⚠️ 免责声明：以下购买入口、价格、库存与型号仅供参考，可能随时变动；下单前请自行核对器件型号、规格与店铺，按需选购。本项目仅提供参考，不对任何采购行为或结果负责。
立即一键下单 · 嘉立创 EDA BOM ↗
3.2 结构件与装配
3.3 板子工艺信息
3.4 主板硬件电路设计
下面是主板与各模块的连接关系与位号分布（U1/U2/U4/U5、H1/H2、CN7 等），方便复刻时对照接线。
3.5 打板与焊接方式
底板的 PCB 源文件已随工程提供，拿到这块板子有两种方式，任选其一。无论选择自己焊接还是嘉立创下单，硬件能力仍以 3.0 的两种主控方案为准：A7Z 当前优先验证显示和 MQTT，Pi 方案覆盖 USB、触摸、旋钮和语音。
下载源文件自行打板焊接
下载工程里的 Gerber 和 BOM，自行打板焊接。音频部分（功放、麦克风）可能需要用到风枪或加热台，其余器件烙铁即可；不需要声音输入输出功能的话，音频部分可以整个省掉，只焊排针排母，不影响显示、状态同步和负一屏核心功能。若没有风枪加热台同时也需要声音功能，可以自行购买 INMP441 与 MAX98357A 功放模块，使用杜邦线连接到板子上。当前底板兼容贴片与外挂模块两种音频装法；软件侧语音功能请优先按 Raspberry Pi 方案验证，A7Z 方案需要后续声卡和 PTT 适配。
直接在嘉立创下单打样 / 贴片
不想动烙铁？直接在嘉立创下单打样和贴片，到手即可装配。下单前仍需按方案一或方案二确认主控、屏幕排针、触摸线、旋钮/按钮和音频器件是否需要实装；A7Z 当前可先只装显示和基础通信必需部分，Pi 方案如要完整交互则需要保留触摸、旋钮/按钮和语音相关器件。
嘉立创一键下单 ↗软件安装
硬件装好后，从源码仓库获取代码，按 README 安装 PC 管理端、烧录板端系统；想二次开发，也从这里开始。
>cd HachimoDock && cat README.md# 按文档安装与运行
使用指南
三步让小搭子上岗。完整的安装、配置与故障排查，请看 GitHub 文档。
连接设备
烧录系统到 SD 卡，连接电脑、打开管理端完成绑定。
检测跟随
管理端自动检测运行中的 Agent，设备屏实时显示它的状态与进度。
抬头互动
看表情和短标签了解进度；触摸屏幕、转旋钮，或直接语音对话。
管理端（PC）
负责设备绑定、Agent 检测与跟随、形象管理、组件中心、按钮配置、语音入口和连接诊断；不同硬件方案会显示不同可用能力。
展示端（设备）
常驻显示宠物和负一屏组件；Pi 方案响应触摸、旋钮和按钮操作，A7Z 方案当前默认不启用这些输入；通过 USB 串口或 MQTT 接收桌面端下发的状态。
常见问题
复刻和使用前最常被问到的问题都在这里；更多讨论欢迎去 GitHub Discussion。
// 主控与选型
Q主控能换吗？一定要用 Radxa 吗？
可以，当前文档照顾两种方案：
· 方案一 Radxa Cubie A7Z：默认复刻硬件，性能更高，当前已验证屏幕显示、MQTT、状态同步和负一屏。
· 方案二 Raspberry Pi Zero 2W：兼容方案，当前已验证 USB gadget、触摸、旋钮/按钮和语音链路。
· ESP32：不是当前 board-runtime 已支持目标，需要另起移植。
Q屏幕 / 麦克风 / 喇叭 / 旋钮可以换型号吗？
可以，BOM 给的是参考选型。屏幕建议保持 2.8″ 240×320 SPI、ILI9341；Pi 方案已验证 XPT2046/ADS7846 触摸和 EC11/按钮，A7Z 方案当前只验证 LCD，触摸、旋钮和语音需要后续 overlay / GPIO / 声卡适配。换非默认型号可能要改引脚、overlay 或驱动配置。
Q屏幕一定要带触摸的版本吗？
不是必须。带触摸（XPT2046）能体验「摸一摸宠物会开心」这类互动；不需要的话，8PIN 无触摸同尺寸版也能用于状态显示。
Q必须做定制 PCB 底板吗？能直接用杜邦线吗？
底板只是为了减少杜邦线、走线整洁，不是必须。按 BOM 接口用杜邦线直连即可。
Q大概成本多少？
方案一 Radxa A7Z 电子料整套约 ¥270（主控约 ¥162），加外壳 / 结构件后整机约 ¥300–350。方案二 Raspberry Pi Zero 2W 的成本取决于主板供货、声卡和转接件；省掉音频部分也能再省。
// 制作与装配
Q不会焊接 / 没有加热台能做吗？
能。音频部分（功放、麦克风贴片）可能需要用到风枪或加热台；不需要声音输入输出功能的话可省掉整个音频部分，只焊排针排母，不影响核心体验；若没有风枪加热台又需要声音功能，可以自行购买 INMP441 与 MAX98357A 功放模块，使用杜邦线连接到板子上（底板兼容贴片与外挂两种方案）。也可以直接在嘉立创下单打样 + 贴片，到手即用。
Q没有 3D 打印机怎么办？
把结构件模型发到嘉立创 3D 打印或第三方打印服务即可，一套外壳几十块。
Q怎么供电？需要电池吗？
USB 供电即可，跟电脑或充电头一起用，不用单独配电池。
// 软件与 Agent
Q软件在哪获取？
全套软件代码已在 GitHub 开源：github.com/YizhengWw/HachimoDock ↗（含 PC 管理端 + 板端运行时 + 文档），可直接 clone 使用。
Q支持哪些 Agent？
面向 CLI Agent 设计，内置适配 Codex、Claude Code、OpenClaw 等；状态协议开放，第三方 Agent 也能接入（欢迎 PR）。
Q设备怎么和电脑通信？需要联网吗？
设备端通过 USB 串口 或 MQTT 接收桌面端下发的状态流。Raspberry Pi 方案支持 USB gadget /dev/ttyGS0 直连；Radxa A7Z 方案当前默认走 Wi-Fi + MQTT/SSH，需要网络。
Q管理端支持什么系统？
支持 macOS 和 Windows。管理端负责设备绑定、Agent 检测跟随、形象管理、组件中心和语音入口。
Q语音交互怎么用？需要联网吗？
当前已验证的是 Raspberry Pi 方案：按住按钮说话，板端转文本后通过 /input/action 送到桌面端，再注入目标 Agent。语音识别链路需要可用网络和 STT 服务；Radxa A7Z 方案当前默认不启动板端语音 PTT。
// 玩法与功能
Q能自定义宠物形象吗？
能。内置西高地小狗（16 个状态动画）；可上传宠物照片、头像或原创角色生成新形象，也能从本机 Codex pet 库或 pet 社区导入网友作品。
Q能自己加组件吗？
能。内置摸鱼倒计时、番茄钟、喝水提醒、Token 消耗四个负一屏组件；用自然语言一句话就能生成新的 .clawpkg 组件，并在 USB 或 SSH/MQTT 链路可用时下发到设备。
// 开源协议与反馈
Q用什么开源协议？能商用吗？
当前仓库软件代码按 GPL-3.0-only 发布；硬件设计、3D 结构件、官方宠物素材和第三方资源请以仓库内 LICENSE、COPYRIGHT、docs/open-source-compliance-prep.md 及对应资源随附声明为准。商用前请按各协议条款执行。
Q怎么反馈问题 / 参与贡献？
GitHub 提 Issue / Discussion / PR：github.com/YizhengWw/HachimoDock ↗。安全问题请先别公开，发邮件到 skyler.wang98@gmail.com。
附录与维护
7.1 参与贡献
欢迎提 Issue、发起讨论或提交 PR，可以从这些方向入手：
- 修复 HachimoDock（哈基米机）或板端运行时问题
- 适配新的硬件屏、主控板、结构件或外壳形态
- 创作宠物资源、动画素材和字幕样式
- 开发新的 .clawpkg 负一屏组件
- 补充装配教程、烧录说明和故障排查
- 改进 Agent 状态协议和第三方 Agent 接入
7.2 开源许可
按内容类型分别声明许可证：
- 软件代码：GPL-3.0-only
- 硬件设计、3D 结构件和官方宠物素材：以仓库内对应资源声明为准
- 第三方资源声明：docs/open-source-compliance-prep.md 或资源随附声明
7.3 安全反馈
发现安全问题，请先不要公开细节，发邮件到下方的安全反馈邮箱，我们会尽快确认并处理。
7.4 联系方式
- 维护者：Skyler Wang（GitHub @YizhengWw）
- GitHub：github.com/YizhengWw/HachimoDock ↗
- 社区 / 交流：GitHub Discussions
- 安全反馈邮箱：skyler.wang98@gmail.com
扫码加入交流群，一起交流复刻与玩法。
交流群扫码加入，交流复刻与玩法设计图
未生成预览图，请在编辑器重新保存一次BOM
暂无BOM
克隆工程
知识产权声明&复刻说明
本项目为开源硬件项目，其相关的知识产权归创作者所有。创作者在本平台上传该硬件项目仅供平台用户用于学习交流及研究，不包括任何商业性使用，请勿用于商业售卖或其他盈利性的用途；如您认为本项目涉嫌侵犯了您的相关权益，请点击上方“侵权投诉”按钮，我们将按照嘉立创《侵权投诉与申诉规则》进行处理。
请在进行项目复刻时自行验证电路的可行性，并自行辨别该项目是否对您适用。您对复刻项目的任何后果负责，无论何种情况，本平台将不对您在复刻项目时，遇到的任何因开源项目电路设计问题所导致的直接、间接等损害负责。
