ai-maker-lab /HachimoDock
A desktop pet that reacts to your Claude Code sessions in real-time — thinking, typing, juggling, sleeping, and more.
★ 1,018⑂ 112👁 5⑃ 40● 14▤ 20
+3
日增长
1,018
stars
112
forks
5
watchers
40
prs
14
issues
20
releases
README
HachimoDock(哈基米机)
面向 AI Agent 的桌面交互终端
通过 Windows/macOS 管理端与 ESP32-P4 设备,呈现任务状态、语音输入与互动组件。
硬件方案
· 硬件端资料
· 图集
· 软件架构
· 复刻与部署
· 快速开始
· 常见问题
项目简介
HachimoDock(哈基米机)是面向 AI Agent 的桌面交互终端,由 Windows/macOS 管理端与 ESP32-P4 设备组成,提供工作状态显示、语音输入、自定义形象和互动组件。桌面应用的安装名称为 HachimiDock,部分开发文档使用 Pet Manager 指代管理端。
English · 下载最新版本 · 问题反馈 · 安全反馈
当前版本与下载
| 项目 | 版本 | 下载 |
| --- | --- | --- |
| Windows x64 | 0.1.230 | 下载安装包 |
| macOS Apple silicon | 0.1.230 | 下载安装包 |
| 配套设备固件 | 0.7.103-p4-r229 | WiFi6 / Pico 完整烧录包 |
0.1.230 新增独立设备设置与局域网发现配对,更新 PetUI 创作、WASM 试玩、组件同步与社区发布流程,并加入「想法与待办」和 WASM 离线音频。客户端内置 WiFi6 与 Pico 的 v1、v3 升级固件;完整烧录请同时核对板型和芯片修订版。请按 v0.1.230 发布页 的 SHA256SUMS 核对下载。
当前预编译客户端支持 Apple silicon Mac 和 Windows x64;不提供 Intel Mac 或 Linux 安装包。本版 macOS 安装包已使用 Developer ID 签名并通过 Apple 公证。Windows 安装器未做数字签名,首次运行可能出现系统提示。公开源码与安装包的对应关系见发布说明;PC 构建和固件构建文档以当前源码为准。
核心能力
| 能力 | 说明 |
| --- | --- |
| Agent 状态跟随 | 将活动会话的思考、执行、等待、完成和错误状态呈现在设备动画与任务气泡中。事件完整程度取决于 Agent 适配器。 |
| 语音输入 | 按住语音键录音,松开后识别并追加到目标输入框;确认后才发送。灰色提示文字不属于草稿。 |
| 实时对话 | 在宠物页面长按 SW2 开始或结束;使用用户配置的识别、对话和语音服务。 |
| 形象与音效 | 内置西高地形象,支持导入或生成自定义外观、状态视频和提示音;兼容固件支持独立下发音效。 |
| 组件中心 | 预览、安装和移除游戏、工具及 PC 数据组件。可用 PetUI 创作声明式或 WASM 组件。 |
| 设备设置 | 在桌面端「设置」中管理音量、城市与 Wi-Fi 配对。设备默认长按 SW3 或从组件中心进入系统设置。 |
| 按键配置 | 配置三个按键与摇杆的操作,组件退出遵循设备全局返回设置。 |
| USB 协同 | 桌面端负责状态、数据、素材与升级传输;连接状态和回执未知时不会自动重放变更。 |
城市定位可关闭;自动模式通过出口 IP 估算城市,不能代替 GPS。详见音量与共享城市。
Agent 兼容范围
当前适配 ChatGPT(Codex)、Claude、OpenClaw、MiMoCode、WorkBuddy 和 DeepSeek Harness。状态跟随、语音草稿、确认发送与桌面对话切换是不同能力;检测到程序不代表其输入框已可用。
- ChatGPT(Codex)、Claude、WorkBuddy、DeepSeek Harness 的桌面语音输入依赖当前可用的系统辅助功能输入框。
- WorkBuddy 与 DeepSeek 的目标对话需在对应应用中打开;设备气泡选择不会自动切换它们的桌面对话。
- MiMoCode 的语音支持与平台相关;OpenClaw 使用其会话路由。具体限制见 Agent 接入与兼容说明。
- 目标不明确、输入框不可用或提交结果未知时,本次操作会停止;不会选取最近的历史会话或自动重复发送。
组件与资源
设备运行声明式组件及受限运行时原语,不是通用浏览器或任意脚本环境。新能力以设备实际声明和对应契约为准;开发配置、离线测试和编译通过不能代替实机兼容与性能验证。
组件通过 PC 同步。缺少可选触控能力不阻止安装,但触控玩法可能无法使用;包格式、资源完整性和存储上限仍需满足。音乐、电台、天气等 PC 数据功能需要管理端保持运行,部分内容需要联网。用户上传内容的权利由相应权利人保留。
1. 在支持的 Agent 中使用 petui Skill 描述游戏或工具。
2. 按设备逻辑画布、输入与资源配额生成组件,通过结构和资源校验。
3. 在组件中心预览,选择“同步到设备”;不用的组件可从设备移除。
开发契约见 PetUI Skill,实时数据见 数据组件、电脑状态与近期待办。
状态跟随演示
快速开始
1. 下载并安装适合电脑系统的客户端,将设备通过数据线连接电脑。
2. 在设备首页确认设备连接与固件版本;已有设备优先使用“固件升级”。
3. 选择跟随的 Agent、形象和按键配置。需要语音输入时,授权客户端的系统辅助功能,并打开目标对话。
4. 配置所需语音与对话服务;按住 SW1 说话,松开后查看草稿,短按确认键发送。
| 默认操作 | 行为 |
| --- | --- |
| SW1 短按 / 摇杆中键 | 确认或进入 |
| 按住 SW1、松开 | 录音、结束并写入语音草稿 |
| SW2 短按 | 切换宠物页面与组件中心;组件可绑定自己的动作 |
| SW2 长按 | 开始或结束实时对话 |
| SW3 短按 | 返回或取消 |
| SW3 长按 | 打开设备系统设置 |
| 摇杆方向 | 选择会话、组件或执行组件映射动作 |
这些是出厂默认值,用户配置优先。语音确认发送不等于批准 Agent 的工具权限请求。WorkBuddy 的操作边界见专门说明。
macOS 安装受阻时,先检查下载来源和校验值,再按系统“隐私与安全性”的提示处理。不要对未知应用解除隔离或关闭 Gatekeeper。语音输入所需权限位于“系统设置 → 隐私与安全性 → 辅助功能”。
新设备或恢复出厂
v0.1.230 Release 提供 WiFi6 和 Pico 原底板的完整烧录包,两种板型各有 v1、v3 版本。包内包含 Bootloader、应用固件、形象、组件及双平台烧录工具。请同时核对板型和实际芯片修订版;微雪 ESP32-P4-WIFI6-M 的 M 不代表芯片版本。同一芯片的固件由 Windows/macOS 共用。完整镜像会覆盖设备现有数据。
v1 与 v3 烧录包不可互刷,具体版本可以咨询客服进行确Top issues
#44关于屏幕能有替代的屏幕吗6 comments · 2026-11-10#47希望支持 语音输入转发模式1 comments · 2026-11-11#45MIMO Desktop1 comments · 2026-11-10#31冷启动 27.5 秒超出首次探测 8 秒窗口,客户端持续停在「正在扫描 USB 设备」1 comments · 2026-11-05#28feat: 接入 Hermes Agent(integrations/hermes-hachimodock)1 comments · 2026-11-04#27咨询:是否有 WiFi 版计划 / 路线图?1 comments · 2026-11-04#22未收到有效的消回声音频1 comments · 2026-11-02#52设备屏文本首屏发虚、出现气泡后自动变清晰(16px 位图放大 vs native 32 字模)0 comments · 2026-11-14
Latest release
HachimiDock v0.1.230 · 设备设置、组件创作与运行优化 v0.1.230 2026-11-13HachimiDock 0.1.230 搭配 R229 固件。以下是相对上一公开版本 0.1.217 / R206 的主要变化。 主要更新 - 设备设置和 Wi-Fi 配对:桌面端新增独立「设置」页,集中管理设备音量、城市与 Wi-Fi 配对,模型配置单独保留。设备连上同一局域网后,可在电脑发现、选择并确认配对,配对后可同步 Agent 状态、任务气泡和完成提示音。默认长按设备 3 键可进入系统设置,也可从组件中心进入。 - PetUI 创作:进入组件中心时自动维护创作工具。简单组件可以一句话开始设计,实现前先确认界面,复杂组件按需确认关键状态。交付使用 .hachiapp,封面采用实际运行画面。新版工具支持从构建、校验、打包到本地发布的完整流程。 - 预览、安装和社区发布:组件详情支持 WASM 试玩,改进原生 640×480 画面与输入映射。发布前检查包的结构与资源,支持提交 WASM 组件。具体设备的兼容性在安装时检查。改进 USB 分片、安装状态确认和固件升级后的重连与版本确认。 - 内置组件:「想法与待办」将语音记录想法和待办清单放在一起,保存的想法可直接加入待办。更新了内置组件和默认资源。 - WASM 离线音频:组件可在碰撞、得分和倒计时结束等事件中触发短音效,并与循环背景音乐同时播放。每个组件的离线音频资源上限为 512 KiB。 桌面客户端 - mac