Cat feeder

cat-feeder — 一台由 AI Agent 团队设计的猫咪自动喂食机

ESP32-C3 + HX711 称重 + 电机下料。外壳、电路板、固件、App 由不同的 Agent（Z.ai ZCode 多 Agent 团队）分工完成， 这里是整条链路的产物：原理图、两版 PCB（Gerber / BOM / 贴片坐标）、固件、外壳、方案文档和运行记录，按两个轮次整理。

状态：Rev A 和 Rev B，都只做到「设计 + 文件」这一步。 没有在真机上验证过：固件只通过了主机测试和编译（没有烧录真机），电路板的元件取值/极性没有对照数据手册查过 （只检查了引脚一致性和可制造性，DRC 0 错误 / 0 未连接）。 Rev A 的 Gerber 已备好给嘉立创（jlc.com）；Rev B 的订单包是给人工审阅的，文件里写明「没有下单」。 本仓库不记录是否付款、是否生产。

两个轮次

各轮的详细说明见 round-1/README.md 和 round-2/README.md。 公共的部分在根目录：docs/（场景、技术路线、营销方案、Demo 准备度、给 Hi3D 的 API 需求草稿，docs/site/ 是配套的静态展示页）和 tools/（原理图生成脚本）。

原理图

第一轮 Rev A（第二轮 Rev B 在 round-2/schematic/，多一个「6 电机电流检测」功能块）：

这些图是怎么来的：PCB 是直接从规格 JSON 生成的，流水线本身不出原理图 （引擎文档写明 "No schematic is generated"）。所以原理图是事后用 tools/gen_schematic.py 按同一份规格画出来的：元件、取值、引脚、网络都来自规格， 符号取自官方 KiCad 库，只有摆放位置是手工定的。

已核对：

• 导出的网表与各自的规格逐网络一致（Rev A 18 个网络，Rev B 21 个，引脚集合完全相同）；
• Rev A 画图所用规格与交给嘉立创那块板（round-1/hardware/handed-off-to-jlc/cat_feeder.spec.json）的元件和网络完全一致； Rev B 画图所用规格与订单包对应工程里的规格（cat_feeder_rev_b_kicad_project.zip 内的 spec）也完全一致；
• KiCad ERC：两版都是 0 错误，0 警告。

没有核对：符号的引脚名/编号来自 KiCad 官方库，没有对照数据手册（库里偶有错误）。

Rev A 嘉立创 EDA 工程包里自带的那张原理图（round-1/schematic/easyeda/cat_feeder_eprj3_sch_overview.png）是「网格摆一个个零件 + 网络标签」的机器布局， 大部分零件摆在图框外面，不是给人读的；它存在的目的是让 EDA 里有同一份网表。

重新生成：

python3 -I tools/gen_schematic.py round-1/hardware/cat_feeder_rev_a_spec.json out/ round-1/schematic/cat_feeder.kicad_pro
python3 -I tools/gen_schematic.py round-2/hardware/cat_feeder_rev_b_spec.json out/ round-2/schematic/cat_feeder_rev_b.kicad_pro --rev B

（需要 macOS 上安装的 KiCad 10；脚本里的路径是 /Applications/KiCad/KiCad.app。）

已知限制

Rev A 的完整列表见 round-1/hardware/NOTES.md：没有电机电流检测；5 V 输入没有保险丝/防反接/ESD； J1 与 J4 分别在板子左侧和中央，线缆会从三个方向进出；没有给元件映射嘉立创料号（LCSC）。 Rev B 解决了「电流检测」和「线缆方向」这两条，其余仍在，见 round-2/hardware/NOTES.md 和订单包。

说明

• docs/ 里的文档引用了一些没有放进本仓库的文件（JLC_NOTES.md、skills/… 等，属于驱动这条流水线的引擎仓库 fxp/zcode-magic，目前是私有的），那些链接在这里是断的。
• docs/05-hi3d-api-request.md 里的测试订单号已打码。
• 许可证：暂未指定（添加之前保留所有权利）。