cultivation-world-simulator

环境要求

• Python 环境（用于运行后端与 pip 安装依赖）
• Node.js（用于安装并运行 web 前端）
• 可用的 LLM 模型服务：DeepSeek / MiniMax / Ollama 之一
• Docker + docker-compose（仅选择 Docker 部署方式时需要）

安装与启动步骤

1. 1获取项目源码

   把仓库克隆到本地并进入项目目录，后续所有命令都在该目录下执行。

   git clone https://github.com/4thfever/cultivation-world-simulator.git
   cd cultivation-world-simulator

   复制

2. 2安装后端依赖

   在项目根目录安装后端 Python 依赖，需保证 pip 指向你打算使用的 Python 环境。

   pip install -r requirements.txt

   复制

3. 3安装前端依赖

   进入 web 目录用 npm 安装前端依赖，完成后回到项目根目录，需已装好 Node.js。

   cd web && npm install && cd ..

   复制

4. 4启动服务

   用 --dev 启动，会自动拉起前后端；开发模式下前端通常会自行打开页面。

   python src/server/main.py --dev

   复制

5. 5配置模型预设

   首次进入后先在设置页选择可用的模型预设（DeepSeek / MiniMax / Ollama），配置会保存到用户数据目录。

6. 6访问前端界面

   若浏览器没有自动打开，请访问启动日志中显示的前端地址，通常为 http://localhost:5173。

关键配置

如何确认成功

浏览器能打开启动日志中显示的前端地址（通常为 http://localhost:5173），并在设置页配置好模型预设即可开始新游戏。

常见问题

注意事项

• README 中 Docker 一键部署标注为“未测试”，源码部署是推荐方式。
• 移动端 UI 尚未完全适配，仅供尝鲜。
• 开发模式下前端页面通常会自动打开，没打开就看启动日志中的地址。
• 外接 API 的完整接口清单与扩展约定见 docs/specs/external-control-api.md。