英文 | 简体中文

Wolfcha

🙏 赞助商

当前赞助商：

• ZenMux - 使用AI模型驱动核心游戏流程、角色扮演和总结功能
• Dashscope - 提供额外的AI模型支持
• Watcha - 提供AI模型能力及展示平台

---

注: 本项目诞生于**“Watcha + ModelScope 全球黑客松”**，是一款原生AI游戏。

“Wolfcha”结合了Wolf（狼人）+ Cha（猹，中国文学中的一个角色）。这既是对黑客松主办方的致敬，也捕捉到了观看AI角色互动的乐趣——就像在看一场表演。

📖 背景

毕业后，要凑齐8到12个人来玩一场像样的狼人杀几乎不可能。虽然狼人杀本质上是一款社交游戏，但其核心魅力——逻辑推理、言语交锋以及言外之意的解读——即便没有社交元素，依然令人着迷。

为了随时随地都能享受狼人杀的乐趣，我们打造了这款基于AI的版本。顾名思义，除了你之外，其他所有玩家（预言家、女巫、猎人、守卫、狼人等）都由AI控制。

✨ 核心功能

1. 双层AI角色扮演

得益于大型语言模型（LLMs）不断增长的上下文窗口和指令遵循能力，我们实现了一个复杂的双层角色扮演系统：

• 第一层：AI扮演一个具有独特个性和背景的“虚拟玩家”。
• 第二层：这个虚拟玩家再扮演狼人角色（如预言家），并根据游戏状态进行发言、 bluff 和推理。

每一次对话都是实时生成的，充满了不可预测性和乐趣。

2. AI模型竞技场

这不仅仅是狼人杀——更是AI模型的竞技场。

我们集成了多个顶尖的AI模型来进行对抗。每局游戏结束后，你可以看到每个角色是由哪个模型驱动的。这其实是一场隐藏的“图灵测试”——观察哪款模型推理犀利，哪款显得“可爱地懵懂”，又哪款听起来最有人性。

当前内置模型（受项目配置影响）：

• DeepSeek V3.2
• Qwen3-235B-A22B
• Kimi K2
• Gemini 3 Flash
• Seed 1.8（字节跳动）

3. 沉浸式复古体验

尽管我们没有专业的美术团队，但我们精心设计了一套流畅的UI/UX：

• 复古设计风格：简洁的布局搭配复古色系。
• 动态交互：
  • 白天/夜晚切换时的眼睛眨眼过渡效果。
  • 角色说话时的口型同步动画。
  • 特殊角色在夜间行动时的独特头像。

🧭 路线图

我们仍在持续改进：

• 移动端优化：在任何设备上都能无缝游玩。
• 灵活的玩家数量：支持8至12人的自定义游戏。
• 赛后回顾/聊天：回顾策略和难忘时刻。
• 特殊能力：独特的机制，如时间回溯和AI洞察。
• 自定义模型选择：选择哪些AI模型加入你的游戏。
• 多人模式：与朋友一起，同时与AI角色同台竞技。
• 角色评分：为表现出色的角色或模型投票，找出最佳狼人玩家。

🛠️ 技术栈

基于现代Web技术构建：

• 框架：Next.js 16（App Router）
• 语言：TypeScript
• 样式：Tailwind CSS 4
• UI组件：Radix UI、Lucide React
• 状态管理：Jotai
• 编辑器：Tiptap（用于富文本交互）
• 动画：Framer Motion
• 头像生成：DiceBear（Notionists风格）
• AI集成：ZenMux（LLMs统一接口）

🚀 本地开发

要在本地运行该项目：

1. 克隆仓库

git clone https://github.com/oil-oil/wolfcha.git
cd wolfcha

2. 安装依赖

# 推荐使用 pnpm
pnpm install

# 或者使用 npm
npm install

3. 配置环境变量

你需要设置API密钥（ZenMux等）才能实现全部功能。请参考.env.example文件，并创建自己的.env.local文件。

4. 启动开发服务器

pnpm dev

然后在浏览器中打开http://localhost:3000。

📄 许可证

MIT

Wolfcha 快速上手指南

Wolfcha 是一个基于 AI 的狼人杀游戏项目，所有非玩家角色均由大语言模型驱动。本指南将帮助中国开发者快速在本地搭建并运行该项目。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Windows, macOS 或 Linux
• Node.js：建议安装最新 LTS 版本 (推荐 v20+)
• 包管理器：推荐使用 pnpm (性能更优)，也可使用 npm
• API Keys：需准备 AI 模型服务密钥（如 ZenMux、Dashscope 等），用于驱动游戏逻辑。

安装步骤

1. 克隆项目代码

首先从 GitHub 获取源代码：

git clone https://github.com/oil-oil/wolfcha.git
cd wolfcha

2. 安装依赖

推荐使用 pnpm 进行依赖安装，速度更快且节省空间：

# 推荐方式
pnpm install

# 或者使用 npm
npm install

提示：如果下载速度较慢，可配置国内镜像源（如淘宝镜像）：

pnpm config set registry https://registry.npmmirror.com

3. 配置环境变量

项目需要 API 密钥才能正常运行。请复制示例配置文件并根据实际情况填写：

cp .env.example .env.local

编辑 .env.local 文件，填入您的 ZENMUX_API_KEY 或其他所需的模型服务商密钥。

基本使用

完成上述配置后，即可启动本地开发服务器：

pnpm dev

启动成功后，在浏览器中访问：

http://localhost:3000

现在您可以开始体验由不同 AI 模型（如 DeepSeek, Qwen, Kimi 等）扮演的狼人杀对局了。您可以在游戏中观察各模型的推理能力与角色扮演表现。