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

在传统的修仙游戏中，你往往扮演一名修士，按部就班地打怪升级，面对的是预设好的剧本和呆板的 NPC。而在 修仙世界模拟器 (Cultivation World Simulator) 中，你将打破这一局限——你不再是修士，而是掌控一切的“天道”。

这是一个由 AI 大语言模型 (LLM) 与 严谨数值规则 共同编织的开放世界。在这里，没有固定的主线剧情，只有无数因果交织出的众生百态。你可以静观沧海桑田，也可以降下天劫、修改人心，微妙地干预世界的进程。

核心亮点：当修仙遇上 AGI

1. 扮演“天道”：上帝视角的极致沉浸

• 非角色扮演：你不需要亲自修炼、战斗或社交。你的身份是世界的观察者与规则制定者。
• 自由干预：你可以选择“无为而治”，静静观察门派兴衰；也可以“降下神罚”，制造天劫考验天骄；甚至直接修改某个角色的心灵，引发蝴蝶效应。

2. 全员 AI 驱动：每个 NPC 都是鲜活的“人”

• 独立灵魂：每一个 NPC（从外门弟子到宗门老祖）都由独立的 LLM 驱动，拥有独特的性格、记忆、人际关系和行为逻辑。
• 自主决策：他们会根据即时局势做出决策：可能会因为一句口角结下死仇，可能会为了宝物结党营私，也可能在绝境中逆天改命。
• 情感模拟：爱恨情仇、师徒情谊、正魔之争，所有情感互动均由 AI 实时生成，而非脚本触发。

3. 规则为骨，AI 为魂

• 严谨体系：世界基于灵根、境界、功法、寿元、丹药等严谨的修仙数值体系运行。
• 逻辑约束：AI 的想象力被限制在合理的修仙逻辑框架内，避免了传统 LLM 游戏的“胡言乱语”，确保世界的真实感与可信度。
• 涌现式剧情：开发者也无法预知下一秒会发生什么。宗门大战、天骄陨落、秘境开启，皆由世界逻辑自主推演而成。

为什么做这个？

• 填补空白：修仙网文中的世界宏大精彩，但读者只能窥见一隅；现有游戏要么剧本僵化，要么规则简陋，缺乏真正的“沉浸感”。
• 技术愿景：利用大语言模型的能力，让“每一个角色都是鲜活的”成为现实，创造一个纯粹、快乐、直接且“活着”的修仙宇宙。
• 拒绝噱头：这不是宣传 Demo，也不是纯学术研究，而是一个旨在提供真实代入感的可玩项目。

快速开始：一键开启你的创世之旅

项目支持多种部署方式，最推荐 Docker 一键部署，无需复杂配置。

方式一：Docker 一键部署（推荐）

只需两条命令，即可在本地启动完整的修仙世界：

# 1. 克隆仓库
git clone https://github.com/AI-Cultivation/cultivation-world-simulator.git
cd cultivation-world-simulator

# 2. 启动服务
docker-compose up -d --build

• 前端访问：http://localhost:8123
• 后端服务：http://localhost:8002

方式二：源码部署（开发模式）

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

# 1. 安装后端依赖
pip install -r requirements.txt

# 2. 安装前端依赖 (需 Node.js)
cd web && npm install && cd ..

# 3. 启动服务 (自动拉起前后端)
python src/server/main.py --dev

模型配置：
服务启动后，浏览器会自动打开设置页面。你可以直接选择预设模型（如 DeepSeek、Ollama 等），或手动修改 static/local_config.yml 配置文件。

高级功能：局域网与移动端访问

虽然移动端 UI 尚未完全适配，但你可以通过简单配置在手机上尝鲜：

1. 后端配置：修改 static/local_config.yml，添加 host: "0.0.0.0"。
2. 前端配置：修改 web/vite.config.ts，在 server 块中添加 host: '0.0.0.0'。
3. 访问：确保手机与电脑在同一 WiFi 下，访问 http://<电脑局域网 IP>:5173。