Skip to content

onebai123/wolfcha-web

Repository files navigation

🐺 Wolfcha (猹杀) - 纯前端版

🎮 这是什么?

Wolfcha (猹杀) 是一款 AI 驱动的单人狼人杀游戏

你将作为唯一的人类玩家,与 9 个 AI 角色一起进行一场完整的狼人杀对局。每个 AI 都有独特的性格和策略,会根据场上局势进行推理、发言、投票,甚至撒谎!

🌟 原项目: oil-oil/wolfcha

本项目基于原作者 oil-oil 的优秀作品进行二次开发,遵循 MIT License 开源协议。向原作者致敬!🙏


⚡ 本版本特点(二次开发)

相比原项目,本版本做了以下改进:

特点 说明
🌐 纯前端架构 无需后端服务器,一个网页所有人都能用
💾 浏览器存储 API Key 保存在本地,无需担心数据安全
🎮 开箱即玩 无需注册账号,打开网页直接开始
自定义 API 支持 DeepSeek、硅基流动、OpenAI 等任意接口
📱 多端适配 电脑、平板、手机都能流畅游玩
隐私优先 数据仅存储在你的浏览器中

🔮 下一版本预告

v2.0 - 无后台联机版

基于 Redis 或 OSS 对象存储实现房间同步,多人联机对战,依然无需自建后端服务器!敬请期待 🎮


⚡ 一键部署

Vercel 部署(推荐)

Deploy with Vercel

  1. 点击按钮 → 登录 Vercel → 等待部署完成
  2. 访问生成的网址,配置 API Key 即可游戏!

💡 部署后无需任何配置,用户在网页上自行填写 API Key。


🔑 支持的 AI 服务商

本项目支持任意 OpenAI 兼容接口,包括但不限于:

服务商 推荐模型 说明
DeepSeek deepseek-chat, deepseek-v3 🔥 推荐,性价比高,中文效果好
硅基流动 deepseek-ai/DeepSeek-V3 国内访问快,免费额度
OpenAI gpt-4o, gpt-4o-mini 官方 API,效果稳定
月之暗面 moonshot-v1-8k Kimi 模型,中文友好
阿里云百炼 qwen-plus, qwen-max 通义千问,国内直连
Anthropic claude-3-opus, claude-sonnet Claude 系列
本地 Ollama llama3, qwen2 本地运行,完全免费
自定义代理 任意模型 支持任意 OpenAI 格式接口

🚀 本地运行

1. 安装依赖

确保已安装 Node.js (>= 18.0),然后运行:

# 安装 yarn(如果没有)
npm install -g yarn

# 安装项目依赖
yarn install

2. 启动项目

yarn dev

或者双击 start.bat(仅 Windows)

3. 配置 API

  1. 打开浏览器访问 http://localhost:3000
  2. 点击欢迎页面的 "API 配置" 按钮
  3. 填写你的 API Key 和选择服务商
  4. 保存后即可开始游戏!

💡 无需配置环境变量! 所有配置都在界面上完成,保存在浏览器本地存储中。


❓ 常见问题

Q: 游戏中 AI 不说话 / 报错

A: 点击 "API 配置" 检查:

  1. API Key 是否正确
  2. 服务商是否选择正确
  3. 模型名称是否支持

Q: 如何更换 AI 模型?

A: 点击 "API 配置",修改模型名称,保存即可。无需重启。

Q: yarn 命令找不到

A: 运行 npm install -g yarn 安装 yarn。


🎮 开始游戏

访问 http://localhost:3000,配置 API Key 后点击"开始游戏"即可体验!

祝你玩得开心!🐺🎉


🏗️ 技术架构(开发者参考)

┌─────────────────────────────────────────────────────┐
│                    用户浏览器                        │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐  │
│  │  游戏界面   │  │  API 配置   │  │ localStorage │  │
│  │  (React)    │  │  (用户填写)  │  │  (数据存储)  │  │
│  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘  │
│         │                │                │         │
│         └────────────────┼────────────────┘         │
│                          ▼                          │
│                   直接调用 AI API                    │
└─────────────────────────────────────────────────────┘
                           │
                           ▼
              ┌─────────────────────────┐
              │   AI 服务商 (用户自选)   │
              │  DeepSeek / OpenAI / …  │
              └─────────────────────────┘

技术栈: Next.js 16 + React 19 + TypeScript + Tailwind CSS + Jotai

About

Wolfcha (猹杀) 二开版 — 纯前端 AI 狼人杀,支持自定义 API,一个网页所有人都能玩

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors