HachimiDock v0.1.217

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 自动生成的源码归档对应公开仓库基线，并非本次二进制的构建源码。

HachimiDock v0.1.201

• 改善 USB 冷启动连接。客户端在同一连接上等待设备启动，避免扫描期间反复打开串口导致设备复位。
• 缩短设备启动时的组件目录检查，保留组件完整性验证。
• 改善 Codex 桌面会话的状态同步。普通回复结束后保留气泡且不播放完成提示音；确认完成的任务只提示一次。
• 客户端内置 ESP32-P4 v1 和 v3 的 R181 升级固件。

平台	安装包
macOS · Apple silicon（Developer ID 签名，已通过 Apple 公证）	下载 DMG
Windows · x64	下载安装程序

请使用 SHA256SUMS 核对下载文件。上一版的完整更新说明见 v0.1.199。

R181 完整烧录包

适用于新设备或恢复出厂。完整烧录会清除设备上的设置、形象和组件；日常升级请使用客户端。请确认芯片版本，v1 和 v3 不可互刷。

• ESP32-P4 v1 完整烧录包
• ESP32-P4 v3 完整烧录包

ESP32-P4-Pico v3.2 专用完整烧录包（测试版）

• 下载 Pico v3.2 专用烧录包
• 适用于微雪 ESP32-P4-Pico（芯片修订版 v3.2、32 MB Flash）搭配 HachimoDock 原底板。适配按键引脚：SW1 → GPIO14、SW2 → GPIO6、SW3 → GPIO5。保留 29 个出厂组件。
• 实机已验证三个按键、屏幕显示、触控点击和左滑，以及扬声器播放与板载麦克风采集。USB 长连接稳定性尚未验收。
• 这是独立的完整烧录包，请勿用于 ESP32-P4-WIFI6 等其他板型，也不要用通用 v3 固件覆盖 Pico 版。完整烧录会清除设备设置、自定义形象及组件。

HachimiDock v0.1.199

0.1.199

• 修复形象详情中的提示音状态始终默认选中“任务完成”的问题，切换动作时自动选中对应状态。
• 保留手动选择提示音状态的功能，切换状态不会修改已保存的音效。
• 提示音继续由全部形象共用，上传与下发独立于视频。

本次仅更新桌面客户端，继续使用 R179 固件；已安装 R179 的设备无需重复升级。

下载 0.1.199

平台	当前安装包
macOS · Apple silicon	HachimiDock_0.1.199_macOS-arm64.dmg
Windows · x64	HachimiDock_0.1.199_Windows-x64-setup.exe

双端均为无 Key 包。配套固件仍为 R179；下方附件中的 R179 烧录包继续适用，已安装 R179 的设备无需重复刷机。

下载与升级

macOS 安装包适用于 Apple silicon，Windows 安装包适用于 x64。两个安装包均为 0.1.199，不附带服务 Key。

Mac 请先完全退出旧客户端，再将新版本拖入“应用程序”并替换旧版，从“应用程序”启动。Windows 请运行新版安装程序完成更新。

源码归档与 v0.1.199 标签一致。macOS 安装包已使用 Developer ID 签名并通过 Apple 公证，Windows 安装包未附数字签名。

完整烧录包继续提供 R179 的 v1/v3 版本，请按实际芯片选择。完整出厂烧录会清除设备设置、自定义形象和组件，日常客户端更新无需完整烧录。

查看 0.1.198 完整更新说明

历史更新：0.1.198 与 0.1.197

0.1.198

本次是 0.1.197 的后续修正版，包含上一版的全部功能更新。

• 修复切换 Agent 和内置形象时，提示音设置引发的不必要视频同步及切换失败。
• 提示音改为全局设置，所有形象共用；音效上传、移除和下发独立于视频。
• 改善 Windows 与 macOS 的跨平台兼容性。
• 修正组件运行时的数值边界处理，保持设备与桌面预览一致。
• 更新共享预览资源及配套 ESP32-P4 固件 R179。

0.1.197 主要更新（保留）

• 新增独立音效下发，支持单独更新或移除状态提示音，无需重新传输整套形象视频。
• 优化音效配置入口，将“下发音效”放到 WAV 上传与移除操作旁。
• 优化任务完成提示音的触发逻辑，避免同一任务重复提醒，保留原有提示音效果。
• 优化宠物状态气泡的切换顺序，修复空完成提示和休息状态残留。
• 改进 ChatGPT（Codex）、WorkBuddy、DeepSeek Harness 的语音输入与目标会话处理。
• 改进 Agent 切换、形象同步、USB 连接恢复和固件升级的状态处理。
• 提供统一城市设置和整体音量控制，优化组件安装、素材显示及城市电台播放体验。
• 改进形象生成的动作适配与任务恢复，支持更多外观形态。

HachimiDock v0.1.198

0.1.198

本次是 0.1.197 的后续修正版，包含上一版的全部功能更新。

• 修复切换 Agent 和内置形象时，提示音设置引发的不必要视频同步及切换失败。
• 提示音改为全局设置，所有形象共用；音效上传、移除和下发独立于视频。
• 改善 Windows 与 macOS 的跨平台兼容性。
• 修正组件运行时的数值边界处理，保持设备与桌面预览一致。
• 更新共享预览资源及配套 ESP32-P4 固件 R179。

0.1.197 主要更新（保留）

• 新增独立音效下发，支持单独更新或移除状态提示音，无需重新传输整套形象视频。
• 优化音效配置入口，将“下发音效”放到 WAV 上传与移除操作旁。
• 优化任务完成提示音的触发逻辑，避免同一任务重复提醒，保留原有提示音效果。
• 优化宠物状态气泡的切换顺序，修复空完成提示和休息状态残留。
• 改进 ChatGPT（Codex）、WorkBuddy、DeepSeek Harness 的语音输入与目标会话处理。
• 改进 Agent 切换、形象同步、USB 连接恢复和固件升级的状态处理。
• 提供统一城市设置和整体音量控制，优化组件安装、素材显示及城市电台播放体验。
• 改进形象生成的动作适配与任务恢复，支持更多外观形态。

下载与升级

macOS 安装包适用于 Apple silicon，Windows 安装包适用于 x64。完整烧录包按 ESP32-P4 v1、v3 分别提供，请选择与设备芯片匹配的版本。

源码附件与 v0.1.198 标签一致。macOS 安装包未经过 Apple 公证，Windows 安装包未附数字签名。

安装包不附带服务 Key，使用相关在线服务时请自行配置。日常固件升级可使用客户端；完整出厂烧录会清除设备设置、自定义形象和组件。

查看 0.1.197 的完整功能更新说明

0.1.197 · 设备协同与音效同步优化

HachimiDock 0.1.197 · 设备协同与音效同步优化

本次更新

• 新增独立音效下发，支持单独更新或移除状态提示音，无需重新传输整套形象视频。
• 优化音效配置入口，将“下发音效”放到 WAV 上传与移除操作旁。
• 优化任务完成提示音的触发逻辑，避免同一任务重复提醒，保留原有提示音效果。
• 优化宠物状态气泡的切换顺序，修复空完成提示和休息状态残留。
• 改进 ChatGPT（Codex）、WorkBuddy、DeepSeek Harness 的语音输入与目标会话处理。
• 改进 Agent 切换、形象同步、USB 连接恢复和固件升级的状态处理。
• 提供统一城市设置和整体音量控制，优化组件安装、素材显示及城市电台播放体验。
• 改进形象生成的动作适配与任务恢复，支持更多外观形态。

下载与升级

• macOS：选择 macOS-arm64.dmg，适用于 Apple 芯片 Mac。
• Windows：选择 Windows-x64-setup.exe，适用于 Windows x64。
• 配套固件为 0.7.103-p4-r178；请先更新客户端和固件，再使用独立音效下发。
• 已有设备建议通过客户端升级固件。完整烧录包用于首次初始化或恢复出厂，会清空设备数据；操作前请备份，并按实际芯片修订版选择 v1 或 v3，二者不可混刷。
• macOS 安装包尚未经过 Apple 公证；Windows 安装包未附数字签名。

附件的 SHA-256 校验值见 SHA256SUMS。许可证与第三方声明已包含在安装包和烧录包中，FFmpeg 对应源码可单独下载。

源码说明

• HachimiDock_0.1.197_Source.zip 提供与本次安装包及 R178 固件构建记录核对的产品源码和资源，附逐文件 SHA-256 清单。两端桌面代码一致，目标工具链和生成的运行时依赖不同；固件使用独立的对应源码目录。
• 归档不包含 Git 历史、构建缓存、生成的第三方可执行文件或开发过程记录。一个仅用于测试的验收入口改为公开的显式路径配置，原始与分发文件摘要均在清单中列明；生产运行时代码和资源未改动。
• 现有 v0.1.197 标签指向较早的源码树，GitHub 自动生成的 Source code (zip/tar.gz) 不是本次安装包的构建来源。请使用上述独立源码附件；原标签及安装包保持不变。
• main 包含发布后的修正，适合后续开发；版本号相同不表示与历史二进制完全同源。源码归档不等于可逐字节复现安装器，也不代表新增实机或声学验收。

0.1.168 · 公开维护版

HachimiDock 0.1.168 · 公开维护版

本次变更

• 提供 macOS arm64、Windows x64 客户端及配套 v1/v3 固件 0.7.103-p4-r2。
• 保留现有用户数据和配置。
• 基于上一正常公开版维护，不包含尚未验收的框架改动，也不包含 0.7.108 分支。

下载

• Apple silicon Mac：HachimiDock_0.1.168_macOS-arm64.dmg
• Windows x64：HachimiDock_0.1.168_Windows-x64-setup.exe
• ESP32-P4 v1：HachimoDock-P4-v1_0.7.103-p4-r2_Factory-Flasher.zip
• ESP32-P4 v3：HachimoDock-P4-v3_0.7.103-p4-r2_Factory-Flasher.zip

升级与兼容
现有设备请优先通过客户端固件升级入口更新应用固件，以保留存储数据。
完整 Factory-Flasher 包用于新设备或明确恢复出厂，会擦除设置、形象和组件。请先备份，按实际芯片修订版选择 v1/v3，不可互刷。设备型号中的 M 不代表芯片修订版。
烧录脚本需要 Python 3.10+，使用 esptool 5.4.0，核对芯片后才执行擦除。显示排线连接 DSI，断电后插拔。
请使用与设备芯片修订版匹配的客户端配套固件。

公开版与隐私
本次为正常公开版，不内置服务 Key、内部证书或构建电脑的固定代理。语音及生成服务请使用自己的 API 配置。
发布前对实际安装包、嵌入前端、资源目录和固件包进行隐私与完整性检查；许可证及对应第三方源码保留。检查结果仅覆盖本次发布产物。
各文件校验值及构建来源见 SHA256SUMS 和 release-manifest.json。

验证边界
已执行自动回归、升级兼容测试及实际包体检查。本次没有刷机或清空任何用户设备，没有录音、播放或调用付费模型。
Windows 安装包为跨平台构建，本次未在 Windows 实机运行；部分电脑的 COM 口打开问题仍在排查，本版本不宣称修复该问题。
macOS 包采用本地 ad-hoc 签名，未公证；Windows 安装包未签名。请只从本仓库下载，并核对校验值。

第三方许可
LICENSE、THIRD_PARTY_NOTICES.md、Xiaomi-Miloco-LICENSE.md、Espressif-ESP-SR-LICENSE.txt、sysinfo-LICENSE.txt 与 FFmpeg 完整对应源码随本 Release 提供；各自适用许可不变。

0.1.167 · 语音、每日资讯与形象生成优化

HachimiDock 0.1.167 · 常规对外发布

本版本同步 2026-10-24 已验证修复，基于 0.1.166 功能快照。
本版本不内置语音、豆包或图像/视频服务 Key；使用云端功能前请在 API 配置中填写自己的凭据。
对应功能源码已同步到 main。2026-10-28 清理了公开文档及历史资料，提交和标签指向可能变化；现有安装包、固件及校验附件未替换。旧克隆请重新克隆，勿合并或强推旧历史。GitHub 自动生成的 Source code 按对应清理后的标签生成，最新功能源码请使用 main。

语音与桌面任务

• 统一按键语音和宠物实时对话的输入定位：已有输入框焦点时沿用；无输入框焦点时定位底部主输入框。
• ASR 写入不再等待上一轮写入回执或草稿字数校验；新一轮语音与上轮任务独立。
• 修复任务只写入不发送、发送完成后回执匹配及宠物播报问题；不自动重复派发已提交任务。
• 补充定位、写入、提交、接收和播报的分阶段诊断。

每日资讯与组件

• PC 启动时提前准备每日九条资讯，缓存文字与语音；分类失败仅补失败分类，失败保留上一期可用内容。
• 修复每日新鲜事、每天一本书、每日新知进入自动播放及播放诊断；主动停止后不自行恢复。
• 城市电台进入即播放；修复组件列表进入后闪烁与顺序跳变。
• 固件基于 0.7.103-p4-r1，包含组件资源完整性检查及逐组件恢复，避免单项损坏导致整体回退无图启动版。
• 未引入实验性的 0.7.108 分支。

照片与形象生成

• 补齐 macOS 照片图库兼容读取及分阶段错误诊断。
• 参考主体支持人物与动物；保留身份特征和合理随身道具，清理无关背景和杂物。
• 新增可选风格描述与预览；未填写时采用默认风格。
• 选图后自动生成整套动画；保留已有结果，恢复优先查询已提交任务，避免重复收费。
• 修复失败任务阻断新任务、已有部分成功仍显示笼统失败、JSON 解析及模型参数错误分类。
• 不再把同一张图锁作全部动画的相同首尾帧；每个动作族使用独立首帧，保持同一形象身份，不锁定尾帧。
• 独立首帧策略用于新生成；已有成功动画保留，不会为替换旧结果自动再次收费生成。
• 优化模型选择、默认模型初始化和 404 错误处理。

安装与使用说明

• macOS：ARM64（Apple Silicon）DMG；采用本地 ad-hoc 签名，未进行 Apple 公证。
• Windows：x64 安装程序；本轮通过交叉编译与安装包解包检查，未在实体 Windows 系统运行验收，未做代码签名。
• 两份工厂烧录 ZIP 分别适配 P4 v1 / v3，不可互刷。完整工厂烧录会清空设备数据；日常保留数据升级应使用客户端固件升级。
• 本轮打包没有安装客户端、连接设备、录音、刷机或发起付费模型调用。
• 之前已完成的实机/生成验证沿用同源功能证据；本轮执行新的自动回归、构建和安装包静态审查，不冒充新一轮完整实机验收。
• 发布前请核对 SHA256SUMS 与 release-manifest.json。

0.1.144 · 语音输入与 AI 形象生成修复

Pet Manager 0.1.144

本次只发布安装包与固件资源，不更新仓库源代码。客户端在 0.1.138 稳定版本基础上修复和优化。

更新内容

• 修复 macOS 语音输入框定位、光标位置、连续追加、完整文字写入和确认发送校验问题。
• macOS 配置保存改为本机加密存储，正常使用不再调用钥匙串或出现解锁按钮；修复已填写语音识别配置仍提示未配置的问题。
• 对话、提示词和视频生成模型支持选择；更新豆包 Lite 默认值与 Seedream 5.0 Flash 图片处理默认值，明确模型不存在或无权限的错误，不盲目重试收费请求。
• 形象生成先清理参考图中的手和杂物，再确认参考图、试生成一个动作、确认后生成其余动作；缓存中间结果和已提交任务，减少重复生成。
• 补充生成阶段、耗时和脱敏请求编号诊断，调整提示词与 Seedance 模型参数兼容性。
• 保留 29 个内置组件、PetUI 资源和稳定固件。

下载说明

• macOS：Apple Silicon（arm64）DMG。
• Windows：x64 安装程序。
• 固件：沿用已验证的 0.7.103-p4，提供 P4 v1 / v3 两种 Factory Flasher 包。请按芯片版本选择；本次没有引入试验性 Wi-Fi 固件。
• SHA256SUMS 提供校验值；第三方许可证与所需 FFmpeg 源码归档随 Release 提供。

验证与限制

• 前端测试：792 项通过，1 项跳过；连接桥测试：213 项通过；原生测试：657 项通过，79 项忽略。
• 已实测参考图处理、提示词生成及两个短视频，验证参考图确认、试片确认和恢复流程。
• 安装包解包后进行密钥、个人配置、内部地址、本机路径与资源完整性检查；结果以 release-manifest.json 为准。
• macOS 使用本地签名，未经过 Apple 公证；Windows 包通过交叉编译和内容校验，本轮未在实体 Windows 电脑运行验收。
• API 服务需使用者自行配置，安装包不附带服务密钥。公开社区地址是产品服务配置，不是内网地址。

自动生成的 Source code 链接仍指向仓库既有公开提交，不代表本次安装包源码已上传。

0.1.138 · 组件中心与社区体验更新

0.1.138 · 组件中心与社区体验更新

• 社区详情页迁移到服务端，优化评论、昵称编辑及客户端交互。
• 本地预置 29 个组件和最新 PetUI，更新组件封面、名称、排序与交互资源。
• 同步设备输入、组件运行和连接容错相关改进。
• 客户端内置 ESP32-P4 v1 / v3 应用固件 0.7.103-p4，按芯片版本匹配。

下载

• macOS Apple Silicon：HachimoDock-Pet-Manager_0.1.138_macOS-arm64.dmg
• Windows x64：HachimoDock-Pet-Manager_0.1.138_Windows-x64-setup.exe
• 首次完整烧录：选择与实际芯片匹配的 v1 或 v3 Factory-Flasher.zip。不要混刷或使用强制跳过检查参数。完整出厂烧录会清空设备原有数据；日常升级请优先使用客户端应用固件升级。

公开包与验证说明

• 本次仅发布二进制包，不更新项目源码分支。Release 标签指向已有公开提交，GitHub 自动生成的 Source code 压缩包不是本次二进制对应的完整源码快照。
• 公开构建不注入内部 API 凭据、企业证书或内部代理配置，不包含用户聊天、账户设置及本机私有文件。需要模型等云服务的功能，请自行配置凭据。
• 附带 SHA256SUMS、release-manifest.json 及第三方许可。FFmpeg 对应源码附件用于满足第三方许可要求，不属于本次项目源码更新。
• macOS 使用本地 ad-hoc 签名，尚未通过 Apple 公证；Windows 包未做本轮实体 Windows 机器运行验收。固件完成双芯片构建和主机回归，本轮未重新刷机验收。

0.1.115 · 桌面 Agent 协作优化

哈基米桌搭 0.1.115

• 优化桌面 Agent 任务派发：执行中可插入新指令，不停止原有任务，也不因派发失败自动重复执行。
• 改进 ChatGPT（Codex）与 WorkBuddy 的输入框定位、上下文传递及结果回执关联。
• 同步提供 macOS Apple Silicon、Windows x64 客户端，以及 ESP32-P4 v1、v3 配套固件。

下载与安装

• macOS：下载 macOS-arm64.dmg。本次为本地签名，尚未经过 Apple 公证。
• Windows：下载 Windows-x64-setup.exe。
• 已能连接客户端的设备，优先使用客户端固件升级；全量烧录请根据芯片版本选择 v1 或 v3 的 Factory-Flasher.zip，阅读包内指南。全量烧录会清除设备数据，两个版本不可混刷。
• 对外包不内置服务 API Key 或企业证书，相关能力需自行配置。

本次仅发布二进制安装包及固件，不同步更新仓库源码。标签关联的源码归档不代表本次二进制的完整源码快照。

文件校验值见 SHA256SUMS，构建与验证说明见 release-manifest.json。本次尚未完成 Windows 实机运行及设备刷机验收。