🐺 Wolfcha (猹杀) - 本地运行版

⚠️ 声明 / Disclaimer

本项目是 Wolfcha (猹杀) 的修改版本。

原作者: oil-oil 及原开发团队 原仓库: https://github.com/oil-oil/wolfcha

本版本仅供学习和自娱自乐，请大家支持原作者和原团队！

主要修改内容：

• ✨ 新增自定义 OpenAI/ZenMux 格式 API 支持
• 🔓 移除强制登录和邀请码限制
• 🏠 适配本地环境运行

---

🐺 Wolfcha (猹杀) 本地运行指南

本文档将指导你如何在本地配置并运行 Wolfcha 项目。

---

📋 前置要求

在开始之前，请确保你的电脑已安装以下软件：

软件	版本要求	下载地址
Node.js	>= 18.0	nodejs.org
pnpm	>= 8.0	安装 Node.js 后运行 npm install -g pnpm

---

🚀 快速开始

第一步：安装依赖

安装 Node.js 运行 npm install -g pnpm

打开终端，进入项目目录，运行：

pnpm install

第二步：配置环境变量

1. 在项目根目录找到 .env.example 文件
2. 复制一份并重命名为 .env.local
3. 按照下方说明填写配置

Windows 用户可以运行：

Copy-Item .env.example .env.local

Mac/Linux 用户可以运行：

cp .env.example .env.local

第三步：启动项目

pnpm dev

或者双击项目根目录的 start.bat（仅 Windows）

启动成功后，打开浏览器访问：http://localhost:3000

---

⚙️ 环境变量配置详解

打开 .env.local 文件，按照以下说明填写：

1. AI 模型配置（必填）

这是游戏的核心，用于驱动 AI 角色的对话和决策。

## AI API 配置
# API Key（必填）- 你的 AI 服务密钥
ZENMUX_API_KEY=sk-xxxxxxxxxxxxxxxx

# API 地址（必填）- 完整的 Chat Completions 接口地址
# 注意：必须包含完整路径，通常以 /v1/chat/completions 结尾
ZENMUX_CHAT_COMPLETIONS_URL=https://api.example.com/v1/chat/completions

常见 AI 服务配置示例

服务商	API 地址
OpenAI	https://api.openai.com/v1/chat/completions
DeepSeek	https://api.deepseek.com/v1/chat/completions
月之暗面 (Kimi)	https://api.moonshot.cn/v1/chat/completions
阿里云百炼	https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions
本地 Ollama	http://127.0.0.1:11434/v1/chat/completions
自定义代理	http://127.0.0.1:8317/v1/chat/completions

2. AI 模型名称配置

## AI 模型配置
# 主模型：用于角色扮演和对话（必填）
# 填写你的 AI 服务支持的模型名称
NEXT_PUBLIC_AI_MODEL=gpt-4o

# 生成器模型：用于角色生成（可选，留空则使用主模型）
NEXT_PUBLIC_GENERATOR_MODEL=

# 总结模型：用于游戏总结（可选，留空则使用主模型）
NEXT_PUBLIC_SUMMARY_MODEL=

常见模型名称示例

服务商	模型名称示例
OpenAI	gpt-4o, gpt-4o-mini, gpt-3.5-turbo
DeepSeek	deepseek-chat, deepseek-v3
月之暗面	moonshot-v1-8k, moonshot-v1-32k
阿里云	qwen-plus, qwen-turbo, qwen-max
Anthropic	claude-3-opus, claude-3-sonnet

3. Supabase 配置（必填）

Supabase 用于用户认证和数据存储。你需要：

1. 访问 supabase.com 注册账号
2. 创建一个新项目
3. 进入 Project Settings → API
4. 复制以下信息：

## Supabase 配置
# Project URL（在 API 页面的 Project URL）
NEXT_PUBLIC_SUPABASE_URL=https://xxxxxx.supabase.co

# Publishable Key 或 Anon Key（二选一填写即可）
NEXT_PUBLIC_SUPABASE_ANON_KEY=
NEXT_PUBLIC_SUPABASE_PUBLISHABLE_DEFAULT_KEY=eyJxxxxxxx

💡 提示：如果你只是想本地测试，可以随便创建一个 Supabase 项目，不需要配置数据库表。

4. 语音配置（可选）

如果你想让 AI 角色有语音，需要配置 MiniMax TTS：

## TTS (MiniMax) - 可选
# 访问 https://platform.minimaxi.com/ 获取
MINIMAX_API_KEY=your_minimax_api_key
MINIMAX_GROUP_ID=your_minimax_group_id

💡 提示：不配置语音功能也不影响游戏，只是角色不会说话。

5. 调试模式（可选）

开发调试时可以开启详细日志：

## 调试模式
# 设置为 true 开启详细的 AI 调用日志
NEXT_PUBLIC_DEBUG=true

---

📝 完整配置示例

以下是一个使用 DeepSeek API 的完整配置示例：

## LLM gateway
ZENMUX_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx
ZENMUX_CHAT_COMPLETIONS_URL=https://api.deepseek.com/v1/chat/completions

## TTS (可选，不填则无语音)
MINIMAX_API_KEY=
MINIMAX_GROUP_ID=
MINIMAX_API_BASE_URL=
MINIMAX_TTS_MODEL=speech-01-turbo

## Supabase
NEXT_PUBLIC_SUPABASE_URL=https://xxxxxx.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=
NEXT_PUBLIC_SUPABASE_PUBLISHABLE_DEFAULT_KEY=eyJxxxxxxxxxxxxxxx

## App
NEXT_PUBLIC_APP_VERSION=0.0.0
NEXT_PUBLIC_SHOW_DEVTOOLS=true

## 调试模式
NEXT_PUBLIC_DEBUG=false

## AI 模型配置
NEXT_PUBLIC_AI_MODEL=deepseek-chat
NEXT_PUBLIC_GENERATOR_MODEL=
NEXT_PUBLIC_SUMMARY_MODEL=

---

❓ 常见问题

Q: 启动时报错 "Missing Supabase env vars"

A: 请检查 .env.local 文件中是否正确填写了 NEXT_PUBLIC_SUPABASE_URL 和 NEXT_PUBLIC_SUPABASE_PUBLISHABLE_DEFAULT_KEY（或 NEXT_PUBLIC_SUPABASE_ANON_KEY）。

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

A: 请检查：

1. ZENMUX_API_KEY 是否正确
2. ZENMUX_CHAT_COMPLETIONS_URL 是否包含完整路径（以 /v1/chat/completions 结尾）
3. NEXT_PUBLIC_AI_MODEL 是否是你的 API 服务支持的模型名称

Q: 如何更换 AI 模型？

A: 修改 .env.local 中的 NEXT_PUBLIC_AI_MODEL，然后重启服务（Ctrl+C 停止后重新运行 pnpm dev）。

Q: 如何开启调试日志？

A: 设置 NEXT_PUBLIC_DEBUG=true，然后重启服务。日志会输出到：

• 浏览器控制台（F12 打开）
• 终端控制台

Q: pnpm 命令找不到

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

---

🎮 开始游戏

配置完成后，访问 http://localhost:3000，点击"开始游戏"即可体验！

祝你玩得开心！🐺🎉