简体中文 · 繁體中文 · English · Tiếng Việt · 日本語

— ✦ —

修仙世界模拟器 (Cultivation World Simulator)

你将作为“天道”，观察一个由规则系统与 AI 共同驱动的修仙世界模拟器自行演化。 全员 LLM 驱动、群像涌现叙事，已开放桌面版愿望单，也支持 Docker 部署、源码开发与二次创作。

📖 简介

这是一个 AI 驱动的修仙世界模拟器。 模拟器中，每一个修士都是独立的 Agent，可以自由观测环境并做出决策。同时，为了避免 AI 的幻觉与过度发散，编入了复杂灵活的修仙世界观与运行规则。在规则与 AI 共同编织的世界中，修士 Agent 们与宗门意志相互博弈又合作，新的精彩剧情不断涌现。你可以静观沧海桑田，见证门派兴衰与天骄崛起，也可以降下天劫或魔改心灵，微妙地干预世界进程。

✨ 核心亮点

• 👁️ 扮演“天道”：你不是修士，而是掌控世界规则的 天道。观察众生百态，体味苦辣酸甜。
• 🤖 全员 AI 驱动：每个 NPC 都独立基于 LLM 驱动，拥有独立的性格、记忆、人际关系和行为逻辑。他们会根据即时局势做出决策，会有爱恨情仇，会结党营私，甚至会逆天改命。
• 🌏 规则作为基石：世界基于灵根、境界、功法、性格、宗门、丹药、兵器、武道会、拍卖会、寿元等元素共同组成的严谨体系运行。AI 的想象力被限制在合理又足够丰富的修仙逻辑框架内，确保世界真实可信。
• 🦋 涌现式剧情：开发者也不知道下一秒会发生什么。没有预设剧本，只有无数因果交织出的世界演变。宗门大战、正魔之争、天骄陨落，皆由世界逻辑自主推演。

🚀 快速开始

推荐方式

• 想改代码或调试：使用源码部署，并准备 Python 3.10+、Node.js 18+ 和可用的模型服务。
• 想直接体验：可前往 Epic Games Store 加入愿望单；也可以使用 Docker 一键部署。
• 如需快速查阅世界信息、动作、宗门等资料，可在 tools/wiki 生成本地辅助 wiki。

首次启动说明

• 无论使用源码还是 Docker，首次进入后都需要先在设置页配置可用的模型预设（如 DeepSeek / MiniMax / Ollama），再开始新游戏。
• 开发模式下，前端页面通常会自动打开；如果没有自动打开，请访问启动日志中显示的前端地址。

方式一：源码部署（开发模式，推荐）

适合需要修改代码或调试的开发者。

1. 安装依赖并启动

   # 1. 安装后端依赖
   pip install -r requirements.txt
   
   # 2. 安装前端依赖 (需 Node.js)
   cd web && npm install && cd ..
   
   # 3. 启动服务 (自动拉起前后端)
   python src/server/main.py --dev
   

2. 配置模型 在前端设置页选择模型预设（如 DeepSeek / MiniMax / Ollama）后，即可开始新游戏。配置会自动保存到用户数据目录。

3. 访问前端 开发模式会自动拉起前端开发服务器，请访问启动日志中显示的前端地址，通常为 http://localhost:5173。

方式二：Docker 一键部署（未测试）

无需配置环境，直接运行即可：

git clone https://github.com/4thfever/cultivation-world-simulator.git
cd cultivation-world-simulator
docker-compose up -d --build

访问前端：http://localhost:8123

后端容器通过 CWS_DATA_DIR=/data 统一持久化用户数据，包含设置、密钥、存档和日志。默认已映射到宿主机 ./docker-data，即使执行 docker compose down 后重新 up，这些数据也会保留。

局域网/手机访问配置

⚠️ 移动端 UI 暂未完全适配，仅供尝鲜。

1. 后端配置：推荐通过环境变量启动后端，例如 PowerShell 中执行 $env:SERVER_HOST='0.0.0.0'; python src/server/main.py --dev。如需改默认值，可编辑只读配置 static/config.yml 中的 system.host。
2. 前端配置：修改 web/vite.config.ts，在 server 块中添加 host: '0.0.0.0'。
3. 访问方式：确保手机与电脑在同一 WiFi 下，访问 http://<电脑IP>:5173。

外接 API / Agent 接入

这部分适合做外部 Agent 接入、自动化脚本，或者实现“观察 -> 决策 -> 干预 -> 再观察”的闭环游玩。

推荐直接围绕稳定命名空间开发：

• 只读查询：/api/v1/query/*
• 受控写入：/api/v1/command/*

常见起点接口：

• GET /api/v1/query/runtime/status
• GET /api/v1/query/world/state
• GET /api/v1/query/events
• GET /api/v1/query/detail?type=avatar|region|sect&id=
• POST /api/v1/command/game/start
• POST /api/v1/command/avatar/*
• POST /api/v1/command/world/*

最小接入流程通常是：

1. 先调用 GET /api/v1/query/runtime/status 判断当前运行状态。
2. 如未开局，调用