Stackchan Xiaozhi Firmware — Development skill for Claude Code

🤖 StackChan-XiaoZhi (Claude Code bridge 适配版)

M5Stack Core S3 Stack-chan 陪伴机器人固件 — Servo MCP 工具 + 唤醒词长期在线 + Claude Code 桥接

基于 [xiaozhi-esp32](https://github.com/78/xiaozhi-esp32) 官方固件，在 `main` 分支加了：

• ✨ 4 个 servo MCP 工具（self.head.move / center / nod / shake）暴露给 LLM 语音调用
• 🐛 修 servo "转过去又弹回" bug（FaceTracker + Application + SetEmotion 三重并发）
• 💤 禁用 light sleep，让唤醒词 7×24 在线（默认会 30 秒关麦克风）
• 🤖 Stack-chan ↔ Claude Code 桥接 — 配套项目，让派蒙能查你本地知识库 / 跑 skill / 用 30+ MCP

完整说明 + 部署步骤 → **[heavenchenggong/stackchan-claude-bridge](https://github.com/heavenchenggong/stackchan-claude-bridge)**

下载预编译固件 → [Releases](https://github.com/heavenchenggong/stackchan-xiaozhi-firmware/releases/latest)（`merged-binary.bin` 一键烧录，永久有效）

---

原项目说明（以下保留上游 README）

---

✨ 功能

模块	硬件	说明
🎤 唤醒词	Multinet6	"你好小智"，灵敏度 Low / Medium / High
👆 头顶触摸	SI12T	3 区电容触摸，摸头对话，7 条随机回应
📱 屏幕触摸	FT6336	双击 / 滑动 / 长按 6 种手势，60 条动作文本
🕺 体感检测	BMI270	摇晃 + 抱起互动，说话自动屏蔽，5 分钟冷却
💡 情绪灯环	WS2812×12	21 种情绪颜色，PY32 IO Expander 控制
🎯 舵机追踪	SCS 总线	GC0308 人脸追踪 + 空闲扫视，对话暂停
😴 智能休眠	—	30 秒空闲关灯 / 停舵机 / 熄屏，唤醒词恢复
🔌 重新配网	—	Idle 长按屏幕 5 秒进入 192.168.4.1 配网（页面已美化，升级至 esp-wifi-connect v3.2.1，支持暗色模式）
✂️ 文本打断	—	对话中插文本消息，不静默丢弃
🔧 MCP 工具	—	LED / 音量 / 亮度 / 摄像头 / 系统信息

---

🚀 快速开始

从 [Releases](https://github.com/howecheung/StackChan-XiaoZhi/releases) 下载 `bootloader.bin`、`partition-table.bin`、`ota_data_initial.bin`、`xiaozhi.bin`，一行命令烧录：

pip install esptool
esptool.py --chip esp32s3 -p COM4 -b 460800 \
  --before default_reset --after hard_reset \
  write_flash --