Cat Café Tutorials

从零搭建 AI 猫猫协作系统 — 一个真实项目的完整复盘

这是什么

这是 Cat Café 项目的配套教程，记录三只 AI 猫猫（Claude/Codex/Gemini）如何真正协作起来的故事。

不是理想化的"从零开始"路径，而是还原我们真实走过的路 —— 包括错误的尝试、关键的转折、以及血泪教训。

三只猫猫

猫猫	模型	角色
布偶猫	Claude Opus	主架构师，核心开发
缅因猫	Codex	Code Review，安全，测试
榹罗猫	Gemini	视觉设计，创意

🎬 功能演示

想先看看成品长什么样？ → 查看功能演示（含视频）

源代码

Cat Café 已正式开源！ 完整源代码在这里：

github.com/zts212653/clowder-ai

教程里提到的所有代码、架构、配置，都可以在开源仓库中找到对应实现。

教程目录

→ 查看完整教程目录

Part 0: 概念入门

• 第零课：AI Agent 概念演进 — Function Call → MCP → Skills → Agent 怎么来的？

Part 1: 选型与架构

• 第一课：选型之路 — 从 SDK 到 CLI — 为什么 SDK 方案行不通？
  • 课后作业：动手写最小可运行示例
• 第二课：从玩具到生产 — 一场辩论赛引发的连环惨案 — stderr 教训 + Redis 隔离 + 幻觉
  • 课后作业：CLI 工程化自检提示词
• 第三课：驯化 AI 的元规则 — 为什么 WHY 比 WHAT 重要 — 从 AI 弱点出发设计协作规范

Part 2: 协作机制

• 第四课：多猫路由 — 当 AI 开始互相 @ — @mention 怎么分发？两条路径的灾难
• 第五课：MCP 回传 — 让猫猫主动说话 — 被动响应不够，猫怎么主动发言？
  • 课后作业：搭建最小 MCP 回传系统

Part 3: 生产化

• 第六课：消失的 28 秒 — 当 AI 闯了生产事故 — 两次数据丢失 + 取证恢复 + 三层防线
  • 课后作业：数据丢失演练 + 防腐门

Part 4: 进阶话题

• 第七课：从猫咖到猫猫平台 — 当 AI 不只是工具 — SillyTavern 取经 + Rich Blocks + 手机猫猫 + 悄悄话

  • 课后作业：最小 Rich Blocks 管线

• 第八课：Session 管理 — 茶话会夺魂 bug — 跨 thread 污染怎么来的？

  • 课后作业：搭建最小 Session Chain 模拟器

• 第九课：100% Pass — 12 条验收全绿，铲屎官说"不是我要的" — 为什么 AI 做的不是你想要的？

  • 课后作业：Skill 描述三件套 + AC 审计 + 冷启动验证

• 第十课：别让 AI 随地大小拉 markdown — 三层记忆架构 + 知识工程

  • 课后作业：蜘蛛网审计 + frontmatter + 7-slot 模板

• 第十一课：让猫猫开口说话 — 从"五年前机器朗读"到 11 只猫 11 种声线 — ASR + TTS + Voice Identity 全链路

  • 课后作业：TTS 对比 + 克隆实验 + Autoplay 策略

即将推出

• 第十二课：降级与容错 — 猫猫挂了怎么办？

适合谁

• 想让多个 AI Agent 协作的开发者
• 对 Claude/Codex/Gemini CLI 感兴趣的人
• 想看真实项目演进过程的人
• 想避开我们踩过的坑的人

联系我们

如果你有问题或想交流，欢迎：

• 提 Issue
• 关注后续更新

---

这个教程由三只猫猫和铲屎官共同编写。