HachimoDock：零基础制作一台 AI 桌面搭子
制作状态：准备中，尚未采购和实物验证。 这是独立复刻学习记录，不是上游官方教程。项目资料截至 2026-11-06 核对；设备、材料、屏幕和 PCB 需要你到货后逐步实测。
HachimoDock 不是在小盒子里运行大语言模型：它通过 USB 与电脑上的 HachimiDock 管理端通信，让 Codex 等 Agent 的状态变成小屏动画，并通过按键、摇杆、语音与电脑交互。我们的目标是原样复刻第一台，完全跑通后再定制。
视频：从购买前的兼容检查开始
HachimoDock 原创 Remotion 采购前视频教程 解释主控、屏幕排线、PCB 与键帽的关键关系；当前是结构示意，不是实物操作。真实购买、3D 打印、焊接和亮屏将用实际制作证据逐段补充。
新手先从两个版本里选择
- 人类制作版（推荐）：没有设备也能先开始；每一关告诉你“Agent 已负责什么、你需要亲手做什么、验收怎样判断”。可走自有打印机、借用机器或代打印路线。
- Agent 执行版：给能访问源码、工程文件和供应商资料的 Agent，让它自己完成公开资料调查、兼容矩阵、采购清单和数字模拟；人不必替它阅读 GitHub。
- AI 新手入口：尚不确定打印机、电脑、焊接技能，先识别个人资源，再分流。
旧的 13 章是深入解释，早期写作以作者持有的 P1S 和 Apple silicon Mac 为背景；不构成所有读者的必备设备清单。个别章节中的品牌参数是例子，不应直接应用到陌生设备。当前标准任务顺序以双视图为准。
最终要做成什么
- 获得适配的外壳与屏幕外框：可以自己用任意适配的 3D 打印机打印、借用机器或选择代打印服务；P1S 只是作者的实测设备之一。
- 将 ESP32-P4-WIFI6-M、2.8 英寸 MIPI-DSI 屏、3 个按键、摇杆、扬声器和 PCB 组合起来。
- 在 Apple silicon Mac 上安装客户端、正确烧录 v1 或 v3 对应固件。
- 展示真实的 Codex 工作状态，并完成按键、摇杆、声音和重新连接测试。
- 整个过程留下材料采购、测试证据、照片、短视频和复盘，供其他新手参考。
没有电子制作经验，也可以做吗？
可以把整个项目拆成小关卡来做。不需要先买 3D 打印机：有打印机走本地切片/打印路线，没有就走代打印路线。焊接、识别排线方向和烧录是按具体任务需学习或委托有能力的人员完成的步骤。建议第一次焊接先练习废板，不要拿正式 PCB 直接试手。
按顺序走的路线图
- 不花钱：理解设备，下载官方文件，确认版权和版本。
- 不花钱：整理购物表，确认芯片修订版、屏幕排线、机械轴与 PCB 兼容。
- 不花钱：在 FreeCAD / Bambu Studio 模拟外壳、主板、屏幕位置。
- 再付款：PCB 打样、购买电子元件；试打印配合件。
- 装配调试：焊接 → 裸机检查 → 烧录 → 连接 Mac → 完整装壳。
- 出作品：功能验收 → 拍照 → 视频 → 实际成本与失败记录。
当前正在执行： 采购执行单——当前不下单。可在 采购核对 Issue #1 和 结构模拟 Issue #2 勾选进度。
首次使用请从 人类制作版 开始；Agent 应读 执行版。原 13 章保留为按需查阅的技术细节，不要跳过采购门禁。
第一台项目的三个购物红灯
- 芯片版本：ESP32-P4-WIFI6-M 的
M表示带排针版本，不表示 ESP32-P4 silicon v3。v1/v3 的完整烧录包不能互刷。 - 屏幕和排线：仅有“2.8 英寸 480×640”还不够；必须同时核对 MIPI-DSI、FFC Pin 数、方向、长度和驱动/初始化兼容性。
- 机械轴与 PCB：官方文字建议 BOX 轴，但立创 BOM 中写的是 CPG135001D01（CHOC 系）。PCB_V1.2 网表/封装也曾有复刻者提问；先核实再下单。
预算与时间
基础电子物料网页参考价合计约 ¥167 起（不含 PCB、排线、键帽、邮费、耗材和工具）；用于做预算的单台估算 ¥220–360，不是商家实时报价。预计主动操作 约 8–15 小时，物流和试错另算。
下载 BOM CSV · 官方硬件项目 · 官方软件仓库 · 固件与客户端 Release
这里不包含什么
本仓库不会在不明确许可的情况下转载上游 STEP、官方装配 MP4、完整 PCB 工程或宠物素材；请从官方链接下载。文档中所有“预计”“待核实”都不是已通过实物测试的结果。照片和视频素材目录当前留空，制作时再补真实素材。
本篇验收
- 已理解它是 USB 桌面交互终端，不是离线 AI 推理盒子。
- 已阅读三个采购红灯，不直接照 BOM 下单。
- 已决定先完成 Mac + Codex 的最小可行版本。