README

HachimoDock（哈基米机）
  面向 AI Agent 的桌面交互终端
  
    通过 Windows/macOS 管理端与 ESP32-P4 设备，呈现任务状态、语音输入与互动组件。
  
  
    
      
    
  
  
    硬件方案
    · 硬件端资料
    · 图集
    · 软件架构
    · 复刻与部署
    · 快速开始
    · 常见问题
  
  
    
    
    
  
  
    
    
  


 项目简介

HachimoDock（哈基米机）是面向 AI Agent 的桌面交互终端，由 Windows/macOS 管理端与 ESP32-P4 设备组成，提供工作状态显示、语音输入、自定义形象和互动组件。桌面应用的安装名称为 HachimiDock，部分开发文档使用 Pet Manager 指代管理端。

English · 下载最新版本 · 问题反馈 · 安全反馈

 当前版本与下载

| 项目 | 版本 | 下载 |
| --- | --- | --- |
| Windows x64 | 0.1.217 | 下载安装包 |
| macOS Apple silicon | 0.1.217 | 下载安装包 |
| 配套设备固件 | 0.7.103-p4-r206 | WiFi6 / Pico 完整烧录包 |

0.1.217 改善实时对话断线后的恢复和 WASM 组件预览。客户端内置 WiFi6 与 Pico 的 v1、v3 升级固件；完整烧录请同时核对板型和芯片修订版。请按 v0.1.217 发布页 的 SHA256SUMS 核对下载。

当前预编译客户端支持 Apple silicon Mac 和 Windows x64；不提供 Intel Mac 或 Linux 安装包。macOS 安装包已签名并通过 Apple 公证。Windows 安装器未做发行者签名。公开源码与安装包的对应关系见发布说明；PC 构建和固件构建文档以当前源码为准。

 核心能力

| 能力 | 说明 |
| --- | --- |
| Agent 状态跟随 | 将活动会话的思考、执行、等待、完成和错误状态呈现在设备动画与任务气泡中。事件完整程度取决于 Agent 适配器。 |
| 语音输入 | 按住语音键录音，松开后识别并追加到目标输入框；确认后才发送。灰色提示文字不属于草稿。 |
| 实时对话 | 在宠物页面长按 SW2 开始或结束；使用用户配置的识别、对话和语音服务。 |
| 形象与音效 | 内置西高地形象，支持导入或生成自定义外观、状态视频和提示音；兼容固件支持独立下发音效。 |
| 组件中心 | 预览、安装和移除游戏、工具及 PC 数据组件；通过 petui Skill 创作声明式有界组件。 |
| 音量与城市 | 首页语音输入模块下方统一调整设备总音量、自动识别城市或搜索并保存手动城市/区县。 |
| 按键配置 | 配置三个按键与摇杆的操作，组件退出遵循设备全局返回设置。 |
| USB 协同 | 桌面端负责状态、数据、素材与升级传输；连接状态和回执未知时不会自动重放变更。 |

公开发行版不提供服务 Key。需要语音、对话或内容生成能力时，请在客户端“API 配置”中填写自己的凭据。城市定位可关闭；自动模式通过出口 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 短按 | 返回或取消 |
| 摇杆方向 | 选择会话、组件或执行组件映射动作 |

这些是出厂默认值，用户配置优先。语音确认发送不等于批准 Agent 的工具权限请求。WorkBuddy 的操作边界见专门说明。

macOS 安装受阻时，先检查下载来源和校验值，再按系统“隐私与安全性”的提示处理。不要对未知应用解除隔离或关闭 Gatekeeper。语音输入所需权限位于“系统设置 → 隐私与安全性 → 辅助功能”。

 新设备或恢复出厂

v0.1.217 Release 提供 WiFi6 和 Pico 原底板的完整烧录包，两种板型各有 v1、v3 版本。包内包含 Bootloader、应用固件、形象、组件及双平台烧录工具。请同时核对板型和实际芯片修订版；微雪 ESP32-P4-WIFI6-M 的 M 不代表芯片版本。同一芯片的固件由 Windows/macOS 共用。完整镜像会覆盖设备现有数据。

v1 与 v3 烧录包不可互刷，具体版本可以咨询客服进行确认。 包内脚本需要 Python 3.10+，自动安装 esptool 5.4.0。屏幕连接 DSI，不是 CS

Top issues

Latest release

HachimiDock 0.1.217 搭配 R206 固件。

- 改善实时对话中 USB 音频传输异常后的恢复，设备重启并重新连接后可发起新对话。
- 改善 WASM 组件的桌面预览与设备画面一致性；R206 支持更大的 WASM 模块和运行内存。
- PetUI 组件构建、校验与打包无需安装 Python，组件中心打开时不会自动运行构建自检。

 下载

- Windows x64：下载安装包
- macOS（Apple silicon）：下载安装包（已签名并通过 Apple 公证）

 设备固件

日常升级请使用桌面客户端。以下完整烧录包仅用于首次安装或恢复出厂，会覆盖设备数据。请同时核对板型与芯片修订版，WiFi6 与 Pico、v1 与 v3 不可混刷。

| 板型 | ESP32-P4 v1.x | ESP32-P4 v3.x（含 v3.2） |
| --- | --- | --- |
| WiFi6 | WiFi6 v1 | WiFi6 v3 |
| Pico（原底板） | Pico v1 | Pico v3 |

请用 SHA256SUMS 核对下载。第三方软件许可与源码获取方式见第三方声明。

本发布提供安装包和固件。GitHub 自动生成的源码归档对应公开仓库基线，并非本次二进制的构建源码。