Stackchan Claude Bridge — Development skill for Claude Code

Stack-chan × Claude Code 桥接

把 [Stack-chan 桌面机器人](https://protopedia.net/prototype/2345)（M5Stack CoreS3 + 双舵机 + 摄像头）变成 **能调你本地 Claude Code 的 AI 桌面伙伴**。

• 🎤 跟 Stack-chan 说话用的是流畅的 小智 AI 协议（DeepSeek/Qwen/豆包 后端，~1 秒响应）
• 🤖 关键时刻调本地 Claude Code，访问你的 memory / skills / 30+ MCP 服务（个人知识库、公众号写作、邮件、wiki 等）
• 🎯 LLM 还能控制头部角度 / 表情 / LED 灯环，所有动作语音可控

"派蒙，查我的知识库里关于 HK 薪酬的笔记" → DeepSeek 看到 `claude_code` 工具 → wss 调到你 Mac → spawn `claude --print` → 用 personal-wiki skill 查 → 念结果给你

---

这是什么

Stack-chan 是日本网友设计的开源桌面机器人，[M5Stack 卖整套套件](https://shop.m5stack.com/products/m5stack-cores3-stackchan-ai-desktop-robot-kit)。配合 [78/xiaozhi-esp32](https://github.com/78/xiaozhi-esp32)（"小智 AI"）固件可以语音对话。

但**官方固件**：

• ❌ 不能换 Claude/GPT 作主模型（官方 server 只支持国产 LLM）
• ❌ 没暴露 servo 角度控制给 LLM
• ❌ 休眠后唤醒词失效
• ❌ 不能查你的个人知识库

**这个项目**：

• ✅ 通过 xiaozhi.me MCP 接入点给 LLM 加了一个 claude_code(task) 工具
• ✅ 工具通过 wss 路由到你 Mac 上的本地 server
• ✅ 本地 server spawn claude --print 跑你的 Claude Code（带 memory + skills + MCP）
• ✅ 异步模式：LLM 立刻回"派蒙正在查"，结果出来后用户说"查到了吗"再念
• ✅ 同时 fork 修了官方固件 3 个 bug（servo MCP 缺失、休眠 mic 关闭、Nod 用错 base）

整体架构：

你说「派蒙，查我的知识库里关于 X 的笔记」
                ↓
        Stack-chan 麦克风 ── 流式 ASR
                ↓
        虾哥后端 api.xiaozhi.me + DeepSeek V4
                ↓ 看到 claude_code 工具就 tools/call
        wss://api.xiaozhi.me/mcp/?token=...
                ↓
        你 Mac launchd 守护的 mcp_pipe.py（wss ↔ stdio）
                ↓
        bridge/server.py (FastMCP, 4 个工具)
                ↓ subprocess
        claude --print "task"
                ↓
        memory + skills + 30+ MCP 服务
                ↓ 写到 /tmp/claude-bridge-outbox/{ts}.txt
        立刻返回 "派蒙正在查 X，稍等一下问我"
                ↓
        TTS → 派蒙说话
        ......稍后......
你说「派蒙，查到了吗」
                ↓
        claude_code_check_results 取最新结果
                ↓
        TTS 念结果（自动截到 600 字）

---

适合谁？

• 已经买了 M5Stack CoreS3 + Stack-chan 套件（或正在考虑）
• Mac 上装了 Claude Code CLI（claude 命令可用）
• 想让 Stack-ch