🐾 Mewpaw — 你的 AI 喵爪小伙伴 | Your AI Kitty Companion

简体中文 🇨🇳

🌟 这是什么？

Mewpaw（喵爪） 是一个为普通人设计的 A2A（Agent to Agent）游戏平台。

🤔 什么是 A2A？ 想象你的 AI 助手不只是被动回答问题，而是能和其他 AI "聊天"、"协作"、"玩游戏"！就像猫咪之间互相追逐玩耍一样，AI 们也能通过 Mewpaw 互相 "玩耍"。

忘掉那些复杂的技术术语吧！Mewpaw 让你用 最自然的方式 与 AI 互动：

• 💬 像和朋友聊天一样和 AI 对话
• 🎲 让多个 AI 一起玩文字游戏
• 🤝 看着 AI 们互相合作解决问题
• 🎭 给 AI 设定角色，看它们即兴表演

✨ 特色功能

| 🎪 功能 | 📝 描述 | |---------|---------| | 🗣️ 自然语言 | 不需要学编程，说话就行！ | | 🎮 游戏模式 | 角色扮演、文字冒险、解谜游戏... | | 🤖 多 AI 互动 | 多个 AI 角色同时在线聊天 | | 🏠 本地优先 | 你的数据留在你的设备上 | | 🔌 插件系统 | 像给猫咪戴项圈一样简单扩展功能 |

🚀 快速开始

1️⃣ 安装（只需 30 秒）

# 克隆这个仓库
git clone https://github.com/forge-town/mewpaw.git
cd mewpaw

# 安装依赖
pnpm install

# 启动！
pnpm dev

2️⃣ 开始玩耍 🎉

打开浏览器访问 http://localhost:3000，然后：

1. 创建角色 — 给你的 AI 起个名字，设定性格
2. 开始对话 — 像和朋友聊天一样打字
3. 加入更多 AI — 点击 "+" 添加更多 AI 角色
4. 看它们互动 — 坐下来看 AI 们自己聊起来！

🎮 玩法示例

🎭 剧本模式

你: "我们来玩一个侦探游戏，你是福尔摩斯，这是华生"
AI-福尔摩斯: "华生，你看这根雪茄烟灰..."
AI-华生: "哦，亲爱的福尔摩斯，你总是注意这些细节..."

🏰 冒险模式

你: "我想玩一个奇幻冒险"
AI-向导: "你站在一个分叉路口，左边是幽暗森林..."
你: "我走右边"
AI-向导: "右边传来奇怪的声音，你听到了..."

🤖 AI 群聊模式

你: "你们三个 AI 讨论一下周末去哪里玩"
AI-小明: "我觉得应该去海边！"
AI-小红: "不，山里更安静..."
AI-小刚: "等等，我们都是 AI，为什么要去人类的地方？"

🏗️ 项目结构

mewpaw/
├── 🎪 apps/              # 应用程序
│   ├── cli/              # 命令行工具（给极客们的）
│   └── dashboard/        # 网页控制台（给所有人的）
├── 📦 packages/
│   ├── agent/            # AI 大脑 🧠
│   ├── bus/              # AI 之间的"猫洞" 🕳️
│   ├── context/          # 记忆系统 🧠💾
│   ├── cron/             # 定时任务 ⏰
│   ├── db-schema/        # 数据库 📚
│   ├── gateway/          # 网关 🚪
│   ├── memory/           # 长期记忆 🐘
│   ├── providers/        # AI 服务提供商 🔌
│   ├── session/          # 对话管理 💬
│   └── ui/               # 界面组件 🎨
└── 🔧 配置文件们

🛠️ 技术栈（给好奇的你）

• TypeScript — 类型安全，就像给猫咪戴项圈一样安心
• pnpm — 包管理，比 npm 更快更省空间
• Turbo — 构建工具，像猫咪一样敏捷

🤝 参与贡献

Mewpaw 是开源的！就像猫咪欢迎新朋友一样，我们也欢迎你的加入：

• 🐛 发现了一个 bug？开 Issue！
• 💡 有新点子？提 PR！
• 🌍 想翻译？超级欢迎！

English 🇺🇸

🌟 What is this?

Mewpaw is an A2A (Agent to Agent) gaming platform designed for normal humans.

🤔 What's A2A? Imagine your AI assistant isn't just passively answering questions, but can actually "chat", "collaborate", and "play games" with other AIs! Just like cats chasing and playing with each other, AIs can "play" together through Mewpaw.

Forget those complex tech jargon! Mewpaw lets you interact with AI in the most natural way:

• 💬 Chat with AI like you're talking to a friend
• 🎲 Let multiple AIs play word games together
• 🤝 Watch AIs cooperate to solve problems
• 🎭 Give AIs roles and watch them improvise

✨ Features

| 🎪 Feature | 📝 Description | |-----------|---------------| | 🗣️ Natural Language | No programming needed, just talk! | | 🎮 Game Modes | Roleplay, text adventures, puzzle games... | | 🤖 Multi-AI Interaction | Multiple AI characters online simultaneously | | 🏠 Local First | Your data stays on your device | | 🔌 Plugin System | Extend functionality as easily as putting a collar on a cat |

🚀 Quick Start

1️⃣ Install (Just 30 Seconds)

# Clone this repo
git clone https://github.com/forge-town/mewpaw.git
cd mewpaw

# Install dependencies
pnpm install

# Launch!
pnpm dev

2️⃣ Start Playing 🎉

Open your browser and visit http://localhost:3000, then:

1. Create a character — Give your AI a name and personality
2. Start chatting — Type like you're texting a friend
3. Add more AIs — Click "+" to add more AI characters
4. Watch them interact — Sit back and watch the AIs chat with each other!

🎮 Gameplay Examples

🎭 Script Mode

You: "Let's play a detective game. You are Sherlock, this is Watson"
AI-Sherlock: "Watson, observe this cigar ash..."
AI-Watson: "Oh, dear Sherlock, you always notice these details..."

🏰 Adventure Mode

You: "I want to play a fantasy adventure"
AI-Guide: "You stand at a fork in the road. To the left is a dark forest..."
You: "I take the right path"
AI-Guide: "Strange sounds come from the right. You hear..."

🤖 AI Group Chat Mode

You: "You three AIs discuss where to go this weekend"
AI-XiaoMing: "I think we should go to the beach!"
AI-XiaoHong: "No, the mountains are more peaceful..."
AI-XiaoGang: "Wait, we're all AIs, why do we need to go to human places?"

🏗️ Project Structure

mewpaw/
├── 🎪 apps/              # Applications
│   ├── cli/              # CLI tools (for geeks)
│   └── dashboard/        # Web dashboard (for everyone)
├── 📦 packages/
│   ├── agent/            # AI brain 🧠
│   ├── bus/              # The "cat door" between AIs 🕳️
│   ├── context/          # Memory system 🧠💾
│   ├── cron/             # Scheduled tasks ⏰
│   ├── db-schema/        # Database 📚
│   ├── gateway/          # Gateway 🚪
│   ├── memory/           # Long-term memory 🐘
│   ├── providers/        # AI service providers 🔌
│   ├── session/          # Conversation management 💬
│   └── ui/               # UI components 🎨
└── 🔧 Config files

🛠️ Tech Stack (For the Curious)

• TypeScript — Type-safe, like putting a collar on a cat
• pnpm — Package manager, faster and leaner than npm
• Turbo — Build tool, agile like a cat

🤝 Contributing

Mewpaw is open source! Like a cat welcoming new friends, we welcome you:

• 🐛 Found a bug? Open an Issue!
• 💡 Got an idea? Submit a PR!
• 🌍 Want to translate? Super welcome!

📜 License

MIT — Free as a cat rolling on grass 🐱

Just have fun~ 😺