本页目录

Wolfcha(AI 狼人杀):单人入座、LLM 智能体补位的多智能体狼人杀

wolfcha · oil-oil/wolfcha

Wolfcha 是 TypeScript 编写的 AI 狼人杀:玩家只占一个座位,其余由 LLM 智能体补位,玩家可自选身份进入 8–12 人局。据 README,每个 AI 在隐藏身份之上叠加稳定人格,会跟随发言、投票与出局情况调整怀疑,并按阵营目标指控、辩护或伪...

策略 模拟经营 桌面游戏 无明确引擎 TypeScript 对话系统 游戏状态管理 动画系统 音频系统 中级
★ Stars 746 Forks 68 License Apache-2.0 更新 2026-11-09

国内开发环境适配

Windows
未知
Linux
未知
macOS
未知
引擎 / 框架:无明确引擎 暂无中文教程标记 未标记站长实测
README 未说明平台支持情况;本地运行需 Node.js 与 pnpm,并需在 .env.local 中配置模型服务商。国内访问在线试玩与模型 API 的网络情况待核验。

中文项目介绍

Wolfcha 是一款以 AI 智能体为核心的多智能体狼人杀游戏。玩家只占据一个座位,其余 7–11 个座位由 LLM 驱动的 AI 玩家补位,组成 8–12 人的完整对局。项目由 TypeScript 编写,基于 Next.js 构建,目标是把线下狼人杀中最难凑齐的“一桌性格各异的玩家”用 AI 还原出来。

据 README 描述,Wolfcha 诞生于 Watcha × ModelScope Global Hackathon。名字由 Wolf 与 Cha(猹) 组合而成,既指狼人杀,也暗含“围观一桌 AI 人格碰撞”的旁观者视角。

玩法指南

一局 Wolfcha 的流程与常规狼人杀类似,README 将其拆为四个阶段:

  1. 夜幕降临:狼人选择袭击目标,特殊角色依据私有信息行动。
  2. 桌面发言:每位存活玩家依次解释、怀疑、误导或推动自己的判断。
  3. 全体投票:把对话转化为一次集体决策。
  4. 故事变化:新的死亡与公开信息重塑下一轮局势。

玩家可选择的身份包括:村民、狼人、白狼王、预言家、女巫、猎人、守卫、白痴。由于对话是实时生成的,相同的身份配置也可能产生截然不同的一桌表现。

核心功能

角色优先(Characters first)

每个 AI 在隐藏的游戏身份之上,还叠加了一层稳定的人格设定,使同一身份在不同对局中也能表现出不同的说话风格与决策倾向。

桌面感知记忆(Table-aware memory)

AI 玩家会跟随发言、投票、死亡事件以及不断变化的怀疑对象来更新自己的判断,而不是只对当前一句话做出反应。

有意图的决策(Decisions with intent)

AI 会依据所属阵营的目标,选择指控、辩护、伪装、跟票或按兵不动。

技术架构分析

技术要点

README 列出的技术栈如下:

  • Next.js 16:应用框架;
  • TypeScript:主要开发语言;
  • Tailwind CSS 4:样式方案;
  • Jotai:状态管理;
  • Radix UI:无障碍 UI 组件;
  • Framer Motion:动画;
  • Tiptap:富文本编辑相关能力。

从项目定位看,Wolfcha 属于多智能体(multi-agent)与社会推理(social deduction)结合的 AI 原生游戏,AI 玩家的记忆、人格与阵营目标共同构成了对局的核心逻辑。

补充说明

本地开发

README 提供了本地运行步骤,要求 Node.js 与 pnpm:

git clone https://github.com/oil-oil/wolfcha.git
cd wolfcha
pnpm install
cp .env.example .env.local
pnpm dev

启动后访问 http://localhost:3000。需要在 .env.local 中配置所需的模型服务商,可用变量在 .env.example 中有说明。README 同时提供了在线试玩入口 https://wolf-cha.com 与中文游戏规则文档。

项目路线

README 的 Roadmap 列出了后续方向:

  • 改进移动端体验;
  • 赛后复盘与自由聊天;
  • 更丰富的记忆、伪装与桌面行为;
  • 时间回溯、AI 洞察等特殊机制;
  • 与好友及 AI 玩家共同进行的多人模式;
  • 社区对出色 AI 人格的评分。

开源许可证与版权说明

许可证标识:Apache-2.0。源码、资源与依赖许可可能不同,请以官方仓库为准。本站仅做索引,不托管源码。

相似项目