DreamSoul研究
源码与架构 /

HachimoDock 桌面入口 源码初查

固定源码 · 研究快照 2026-10-27Markdown 下载 ↓
本页为正式研究文档的网页阅读版。固定 GitHub 证据保留;本机研究底稿未发布,相关链接已改为文字说明。原文中的历史发布状态对应研究当时。

信息与访问日期:2026年10月27日。对象为用户提到的“小米哈吉米”,已定位为 HachimoDock(哈基米机)。本轮覆盖项目文档、固定源码中的会话总线与气泡逻辑、组件契约、许可及发行记录;不构成完整系统审计。

后续深入结果见 HachimoDock 源码架构 与 StackChan 对比及授权边界。本文保留早期产品/市场与局部代码初查,当前筛选以 开源资产专项 为准。

判断与定位

值得作为近期桌面 Agent 产品参照,但当前不能计为已获商用授权的代码资产。 它的价值在于把电脑上正在工作的 Agent 变成可见、可交互的桌面角色,并以低成本屏幕承载语音入口和用户自创组件。当前自有代码采用非商业源码可见许可,独立产品开发也需要另行书面授权;最新二进制与公开应用源码存在版本差距。

原五项为StackChan、Reachy Mini、Petoi、Coglet、Doly,小智列为共享依赖。HachimoDock本轮已从观察初查提升为主机外设架构重点对照,补读USB与固件结果链;许可、发行源码对应与商业证据缺口继续单列,不登记为已获商业采用授权。

HachimoDock 项目实拍
HachimoDock 项目实拍 · 点击查看原图

图片来自项目 README 所引用的立创平台素材,展示外观用途;未重新生成产品图。已保存本地并检查图片可读性;可访问和研究展示不授予额外再分发或产品使用权。

问题 核查结果与口径 直接入口
是哪款产品 HachimoDock,中文名“哈基米机”;部分新发行文件使用 HachimiDock 拼写 项目仓库与说明
与小米的关系 现场采访报道归于“小米技术委创新产品团队孵化”;软件仓库位于个人账号 YizhengWw,许可证权利人为 Yizheng Wang。这里分别记录团队孵化与代码权属,不据此推定小米零售、售后或授权主体 澎湃新闻现场采访转载、仓库许可证
核心形态 ESP32-P4、32MB Flash/PSRAM、2.8英寸480×640屏、三个按键和四向中按摇杆,连接电脑管理端。当前交互不要求触摸屏 固定硬件说明
价格 新闻所述“约150元”为自行复刻成本估计,不能当作成品售价、量产BOM或含服务的总成本。本轮未取得可下单的官方整机报价 团队展会报道、项目成本说明
开售、众筹及销量 本轮未取得官方整机开售、众筹或出货量数据。仓库关注数、复刻评论及安装包下载均不能折算销量;未取得数据也不表示零销量 发行下载入口
硬件资料 README 指向 OSHWHub 的PCB、BOM、结构与装配页;本轮直接读取返回403,GitHub固定树未发现完整原生PCB/机械制造包,因此只确认资料入口,未确认制造资料完整性及授权 硬件复刻入口

新在哪里:分开仓库、亮相与发行

时间/版本 确认到的事实 依据
2026-06-10 GitHub仓库创建时间;不是正式开售日,也不能当成首次公开日期 GitHub仓库元数据
2026-10-22 WTCC展会现场采访已介绍该项目 现场报道
2026-10-24至25日 观猹大会展示,10月26日集中出现报道;不是此前不存在项目的证据 展会采访
本轮固定源码 main 提交 b56375a6329caf5acb4952b5bb3cd8ddd91fe501,2026-10-26T11:14:19Z;最近提交改二维码,不能据此称核心代码刚升级 固定提交
公开应用源码基线 pc/package.json 为0.1.101;仓库 latest-release.json 为桌面0.1.101、固件0.7.72-p4 源码版本、仓库内版本清单
实际最新发行 v0.1.167 于2026-10-24T12:56:37Z发布,固件基于0.7.103-p4-r1;发布说明明确配套应用源码尚未同步,自动生成的Source code包不是此版构建快照 v0.1.167发布说明

所以,“仓库最近更新”“有公开源码”“最新功能可从源码复现”是三件不同的事。本轮代码判断限于固定公开源码,未把0.1.167新增或修复功能当作已审阅实现。此前媒体或聚合页所写GPL-3.0,也不能覆盖当前固定版本的自定义许可;历史版本许可需逐个版本复核。

代码真正值得看的三处

Agent会话与桌宠表现分开

电脑侧的会话总线把不同Agent的会话发现、打开与文字注入归一化,流式返回 token/tool/done 等事件;桌宠气泡逻辑再决定哪些任务出现、何时消失。这样,表达终端可以围绕统一状态工作,而不用理解每家Agent的私有格式。

实际边界并不对称:WorkBuddy适配器明确不支持后台注入或新建会话,其桌面语音路径使用当前可见输入框;MiMoCode Windows语音也在项目接入说明中标为尚未实现。“支持五类Agent”不能解释成五套完整、等价的双向接口。

具体代码/机制 可研究之处 限制与来源
agent-session-bus 用适配器隔离会话发现、创建、注入与流式响应,便于上层语音前端共用接口 接口与各Agent写入方式;包元数据标UNLICENSED,不能解释为独立MIT模块
session-display.js 活跃任务准入、显式终态保留60秒、权威快照连续缺失15秒的容忍、按可见内容消除重复卡片 纯函数实现;按标题和内容去重可能合并外观相同的不同任务,采用前需核对产品语义
本地HTTP边界 回环地址、Host/端口、浏览器Origin/Fetch Metadata和请求目标校验,将本地原生客户端与网页请求区分 边界函数;同一OS用户下原生进程仍在共同信任边界,不能等同于用户逐次授权
平台能力显式降级 未支持的注入路径返回明确错误,不把安装/检测成功当作可写入 WorkBuddy适配器、Agent接入说明

会话总线的取消接口触发本地 AbortController,并把信号交给具体适配器。它不是一份“所有Agent任务及已发出的工具操作均撤回”的保证;是否中止底层执行还需逐个适配器验证。取消实现

自创组件依靠有界运行时

PetUI面向用户需求生成声明式组件包,经PC侧校验,再通过USB下发。契约限制变量、状态、实体、规则、资源路径与字节数;第三方组件不直接执行任意脚本,也不自行读本机文件或访问网络。实时数据需要产品已经提供的电脑侧数据通道。

这提供了一个有价值的产品方向:让用户能改变玩法,同时把设备能力保持在可检查的范围。它仍受运行时表达能力和资源上限约束,不能用“自然语言生成任意应用”概括。当前结论来自契约文档与协议阅读,本轮未逐项审计固件解释器和组件发布器。

组件边界 固定来源
统一v4有界运行时、无任意代码/网络/文件访问 PetUI契约
紧凑runtime JSON不超过4095字节,限制fetchers/readers 包预算与数据边界
状态、音频、资源、组件通过有主题的USB消息交互 设备协议

同一小屏承载两条不同任务路径

下面是根据项目文档和已读源码整理的分析示意;不是实际部署图,也没有把逻辑模块画成独立进程。

HachimoDock 桌面入口 源码初查 图示
HachimoDock 桌面入口 源码初查 图示 · 点击查看原图
查看 Mermaid 图源
flowchart LR
  A[电脑上的外部Agent] -->|状态与会话事件| B[电脑管理端与Bridge]
  B -->|USB状态、资源与组件| D[ESP32-P4屏幕与输入]
  D -->|录音与实体按键| B
  B -->|语音文字与确认后的输入| A
  B -->|实时对话请求| C[用户配置的语音与模型服务]
  C -->|回复或工具请求| B
  B -->|账号及能力校验后的家居请求| M[米家云与已授权设备]

外部Agent语音输入与设备实时聊天/家居工具是不同路径。项目文档说明,后者通过用户配置的ASR、LLM、TTS服务工作;米家能力也需要账号授权和联网。设备通过USB通信,不能推出整个系统离线。

家居文档还区分了命令受理与属性读回核验,并说明停止任务不会撤回已发出的命令。其具体控制流程本轮只读文档,未使用真实账号发起控制。这些边界比“可以控制智能家居”这一功能标签更适合下一轮比较。

依据:实时对话链路、智能家居与数据边界。

可研究、可采用与尚缺的证据

层次 本轮结论 依据/待补内容
当前自有源码 允许许可范围内非商业学习、运行、修改及项目内组件创作;商业使用和独立产品开发另需书面授权。本轮未将代码拷入公司产品 LICENSE第2、3、8条
第三方资产 保留各自许可证,不能将项目自定义条款反向覆盖第三方,也不能由某个依赖的宽松许可推出整体可商用 第三方声明
品牌、角色和素材 当前许可不授予商标或背书权;角色/照片/音色仍需分别检查权利 品牌条款
最新应用完整复现 尚未闭合;需要与0.1.167二进制一致的应用源码、锁文件、资源和构建溯源 最新发行说明
可制造硬件 尚未确认完整性;需要能访问的原生EDA、结构文件、BOM、版本和各自许可,不能仅靠新闻“全开源”描述 作者给出的硬件入口
国内成品售价、开售与销量 本轮无可确认数据,需要官方商品、订单/交付或出货披露;关注数与下载数不代替销售数据 暂无可作为销售依据的直接入口

这张表记录项目文件的声明和技术采用条件,不替代针对拟采用版本及用途的授权确认。即使获得HachimoDock自有部分授权,第三方依赖仍需单独核对。

检索中还发现更接近可运动桌面机器人的 Brufik v2。其固定版本将固件、服务和结构分别置于GPLv3、GPLv3-or-later、CERN-OHL-S-2.0范围,与HachimoDock当前的非商业许可不同;但本轮仅筛查文档、许可和文件树,未审运行源码,且README所链主板Gerber包未出现在固定完整树中,不能认定制造资产齐备。先保留 筛查证据(研究底稿,未随本专区发布),不单独占本轮五个主对象名额,也不构成可采用结论。

本地验证范围

在Windows、Node.js v24.19.0下,运行固定源码的原始 session-display.js 与仓库现有 session-display.test.js,13项测试通过。覆盖活跃状态筛选、冷启动不导入历史终态、完成/错误保留时间、状态修订、快照遗漏、容量优先级和重复气泡合并。没有改算法,没有安装依赖,也未启动真正的Agent。

测试结果仅支持该纯函数在这些输入上的行为;不证明日志监听、桌面输入定位、USB同步、Windows客户端、实时语音或家居控制可用。项目发行清单里的其他回归数量属于作者声明,本轮未复跑,不混入本轮通过数。

证据:测试与版本记录(研究底稿,未随本专区发布)、上游现有测试。Mermaid保留源码,尚未单独渲染验收。本次仅更新本地源码专项,没有更新网站、上传飞书、安装客户端或购买硬件。