fix pytest

重构事件机制和部分拍卖会机制

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,19 @@
+---
+name: Bug Report 🐛
+about: 报告一个问题 (Report a bug)
+title: "[Bug] "
+labels: bug
+assignees: ''
+---
+
+**问题描述**
+简要描述你遇到的问题。
+
+**复现步骤**
+1. 
+2. 
+
+**环境信息**
+- OS: 
+- 报错信息 (如有):
+

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,14 @@
+---
+name: Feature Request 💡
+about: 建议一个新功能 (Propose a feature)
+title: "[Feat] "
+labels: enhancement
+assignees: ''
+---
+
+**功能描述**
+你希望添加什么功能？
+
+**解决什么问题**
+这个功能解决了什么痛点？
+

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,7 @@
+## Summary
+
+<!-- Brief description of what this PR does -->
+
+## Test Plan
+
+<!-- How was this tested? -->

.github/workflows/test.yml

@@ -0,0 +1,33 @@
+name: Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+          cache-dependency-glob: "requirements.txt"
+
+      - name: Install dependencies
+        run: |
+          uv pip install --system -r requirements.txt
+          uv pip install --system pytest
+
+      - name: Run tests
+        run: pytest -v

.gitignore

@@ -143,9 +143,13 @@ logs/
 *.tmp
 *.temp
 
+# Save files (ignore all files in saves directory but not the directory itself)
+assets/saves/*
+!assets/saves/README.md
+
 TODO
 local_config.yml
 
 台本/
 笔记/
-tmp/
+tmp*/

CONTRIBUTING.md

@@ -0,0 +1,53 @@
+# 贡献指南 (Contributing Guide)
+
+感谢你对 **Cultivation World Simulator** (修仙模拟器) 感兴趣！欢迎任何形式的贡献，包括修复 Bug、改进文档或开发新功能。
+
+为了保持代码库的健康和风格统一，请在贡献前阅读以下指南。
+
+## 🛠️ 开发环境搭建
+
+具体的安装和启动步骤请参考 [README.md](./README.md) 中的说明。
+
+**项目结构说明：**
+- **后端 (Python)**: 位于 `src/` 目录。
+- **前端 (Vue 3)**: 位于 `web/` 目录。
+
+## ✅ 测试要求 (必须)
+
+在提交 Pull Request 之前，请务必确保所有测试通过。这是保证代码质量的关键。
+
+**运行后端测试：**
+```bash
+pytest tests/
+```
+
+请确保所有测试用例都能通过（PASS）。如果你添加了新功能，建议同时也添加相应的测试用例。
+
+## 📝 代码规范
+
+我们追求**简洁、优雅、清晰易读**的代码风格。
+
+### Python 后端
+- 遵循 PEP 8 风格指南。
+- 如果新增了功能，请加入对应的pytest测试。
+
+### Vue 前端
+- 使用 **TypeScript** 编写逻辑。
+- 遵循 Vue 3 Composition API 的最佳实践。
+- 组件命名清晰，保持单一职责。
+
+## 🚀 提交 Pull Request (PR)
+
+1. **Fork** 本仓库到你的 GitHub 账户。
+2. **Clone** 你的 Fork 版本到本地。
+3. 创建一个新的分支进行开发：
+   ```bash
+   git checkout -b feature/你的功能名称
+   # 或者
+   git checkout -b fix/修复的问题
+   ```
+4. 提交你的更改 (Commit)，请使用清晰的提交信息。
+5. 推送 (Push) 到你的远程分支。
+6. 在 GitHub 上发起 **Pull Request**。
+
+感谢你的贡献！一起打造更好的修仙世界。

EN_README.md

@@ -1,92 +1,214 @@
 <!-- Language / 语言 -->
-<p align="center">
+<h3 align="center">
   <a href="README.md">🇨🇳 中文</a> · <a href="EN_README.md">🇺🇸 English</a>
-</p>
+</h3>
 <p align="center">— ✦ —</p>
 
 # Cultivation World Simulator
 
-An AI-driven cultivation world simulator that aims to create a truly living, immersive xianxia world.
+![GitHub stars](https://img.shields.io/github/stars/4thfever/cultivation-world-simulator?style=social)
+[![Bilibili](https://img.shields.io/badge/Bilibili-Watch_Video-FB7299?logo=bilibili)](https://space.bilibili.com/527346837)
+![QQ Group](https://img.shields.io/badge/QQ%20Group-1071821688-deepskyblue?logo=tencent-qq&logoColor=white)
 
-## Overview
+![Last Commit](https://img.shields.io/github/last-commit/4thfever/cultivation-world-simulator)
+![Commit Activity](https://img.shields.io/github/commit-activity/y/4thfever/cultivation-world-simulator)
+![Repo Size](https://img.shields.io/github/repo-size/4thfever/cultivation-world-simulator)
+[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
 
-Cultivation World Simulator combines traditional game-rule systems with large language models. By first establishing a complete ruleset for the cultivation world, it creates an autonomous, vibrant, immersive virtual world with emergent stories.
+![Status](https://img.shields.io/badge/Status-Alpha-tomato)
+![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)
+![Genre: Xianxia](https://img.shields.io/badge/Genre-Xianxia-red)
+![Powered by LLM](https://img.shields.io/badge/Powered%20by-LLM-0077B5)
+![AI Agent](https://img.shields.io/badge/AI-Agent-orange)
+![OpenAI Compatible](https://img.shields.io/badge/OpenAI%20API-Compatible-412991)
 
-Core idea: **Build a credible rule-based world model first, then plug in AI to bring it to life.**
+![Python](https://img.shields.io/badge/Python-3.10%2B-blue?style=flat&logo=python&logoColor=white)
+![FastAPI](https://img.shields.io/badge/FastAPI-005571?style=flat&logo=fastapi&logoColor=white)
+![Vue](https://img.shields.io/badge/Vue.js-3.x-4FC08D?style=flat&logo=vuedotjs&logoColor=white)
+![TypeScript](https://img.shields.io/badge/typescript-%23007ACC.svg?style=flat&logo=typescript&logoColor=white)
+![Vite](https://img.shields.io/badge/vite-%23646CFF.svg?style=flat&logo=vite&logoColor=white)
+![PixiJS](https://img.shields.io/badge/PixiJS-E72264?style=flat&logo=pixijs&logoColor=white)
 
-### Tech Stack
+<p align="center">
+  <img src="assets/screenshot.gif" alt="Game Demo" width="100%">
+</p>
 
-- **Frontend Rendering**: pygame (Web support in the future)
-- **Simulation Engine**: custom event-driven simulator
-- **World Model**: rule-based deterministic systems
-- **AI Integration**: LLM-generated actions, decisions, micro-stories
+> **An AI-driven cultivation world simulator that aims to create a truly living, immersive xianxia world.**
 
-## Background
+## 📖 Introduction
 
-I have been a long-time reader of xianxia novels, from classics to modern works. As a game AI practitioner, I believe today’s LLM capabilities are sufficient to support a xianxia-style world simulation.
+This is an **AI-driven open-world cultivation simulator**.
 
-However, LLM-only NPC decision/dialogue is not enough. A credible rule system must ground the world as the “world model”, and then AI makes it vivid.
+Unlike traditional RPGs where you play a specific character, here **you play as the "Heavenly Dao" (God)**.
+You don't need to personally fight monsters or level up. Instead, you observe all living beings from a god's perspective. In an open world woven together by rules and AI, you witness the rise and fall of sects and the emergence of prodigies. You can quietly watch the world change, or bring down tribulations and alter minds, subtly intervening in the world's progress.
 
-I aim to create a pure, joyful, direct, living sense of immersion. Not a mere marketing demo, nor purely academic like “Stanford Town”, but a world that players can actually feel and inhabit.
+### ✨ Core Highlights
 
-If you like this project, consider starring it~ You can also watch intro videos for this project on my [Bilibili account](https://space.bilibili.com/527346837).
+- 👁️ **Play as "Heavenly Dao" (God Perspective)**: You are not a cultivator, but the **Heavenly Dao** controlling the world's rules. Observe the myriad forms of life and experience their joys and sorrows.
+- 🤖 **Fully AI-Driven**: Every NPC is independently driven by LLMs, with unique personalities, memories, relationships, and behavioral logic. They make decisions based on the current situation, have love and hate, form factions, and even defy the heavens to change their fate.
+- 🌏 **Rules as the Cornerstone**: The world runs on a rigorous numerical system including spiritual roots, realms, cultivation methods, and lifespans. AI imagination is constrained within a reasonable cultivation logic framework, ensuring the world is authentic and credible.
+- 🦋 **Emergent Storytelling**: Even the developer doesn't know what will happen next. There is no preset script, only world evolution woven from countless causes and effects. Sect wars, righteous vs. demonic conflicts, the fall of geniuses—all are deduced autonomously by the world's logic.
 
-![Screenshot](assets/screenshot.png)
+<table border="0">
+  <tr>
+    <td width="33%" valign="top">
+      <h4 align="center">Character Panel</h4>
+      <img src="assets/角色.png" width="100%" />
+      <br/><br/>
+      <h4 align="center">Personality Traits</h4>
+      <img src="assets/特质.png" width="100%" />
+    </td>
+    <td width="33%" valign="top">
+      <h4 align="center">Sect System</h4>
+      <img src="assets/宗门.png" width="100%" />
+      <br/><br/>
+      <h4 align="center">Life Experiences</h4>
+      <img src="assets/经历.png" width="100%" />
+    </td>
+    <td width="33%" valign="top">
+      <h4 align="center">Independent Thinking</h4>
+      <img src="assets/思考.png" width="100%" />
+      <br/><br/>
+      <h4 align="center">Short/Long Term Goals</h4>
+      <img src="assets/目标.png" width="100%" />
+      <br/><br/>
+      <h4 align="center">Nicknames</h4>
+      <img src="assets/绰号.png" width="100%" />
+    </td>
+  </tr>
+</table>
 
-## Development Progress
+### 💭 Why make this?
+The worlds in cultivation novels are fascinating, but readers can only ever observe a corner of them.
+
+Cultivation games are either completely scripted or rely on simple state machines designed by humans, often resulting in forced and unintelligent behaviors.
+
+With the advent of Large Language Models, the goal of making "every character alive" seems reachable.
+
+I hope to create a pure, joyful, direct, and living sense of immersion in a cultivation world. Not a pure marketing tool for some game company, nor pure research like "Stanford Town", but an actual world that provides players with real immersion.
+
+## 📞 Contact
+
+If you have any questions or suggestions, feel free to open an Issue or Pull Request.  
+You're also welcome to leave a message on my [Bilibili account](https://space.bilibili.com/527346837)!  
+You can also join the QQ group for discussion: 1071821688. Verification answer: 肥桥今天吃什么 
+
+## 🚀 Usage
+
+### ⚙️ Run Steps
+1. Clone the repo:
+   ```bash
+   git clone https://github.com/your-username/cultivation-world-simulator.git
+   cd cultivation-world-simulator
+   ```
+
+2. Install dependencies:
+   ```bash
+   # Backend dependencies
+   pip install -r requirements.txt
+   
+   # Frontend dependencies (Node.js environment required)
+   cd web && npm install
+   ```
+
+3. Configure LLM:
+   Edit `static/config.yml`:
+   ```yaml
+    llm:
+      key: "your-api-key-here"           # your api key
+      base_url: "https://api.xxx.com"    # API addr 
+      model_name: "normal_model_name"    
+      fast_model_name: "fast_model_name" 
+   ```
+   Supports all API providers compatible with OpenAI interface format (e.g., Qwen, DeepSeek, SiliconFlow, OpenRouter, etc.)
+
+   You can also configure LLM parameters directly in the frontend:
+   
+   <img src="assets/llm_config.png" alt="Frontend LLM Config" width="100%">
+
+4. Run:
+   ```bash
+   # Start service (Recommended dev mode, automatically starts frontend)
+   python src/server/main.py --dev
+   ```
+   The browser will automatically open the web frontend.
+
+
+## 📊 Project Status
+
+![Repobeats analytics](https://repobeats.axiom.co/api/embed/91667dce0fca651a7427022b2d819d20dd17c5e3.svg "Repobeats analytics image")
+
+## ⭐ Star History
+
+If you find this project interesting, please give us a Star ⭐! It will motivate us to keep improving and adding new features.
+
+<div align="center">
+  <a href="https://star-history.com/#4thfever/cultivation-world-simulator&Date">
+    <img src="https://api.star-history.com/svg?repos=4thfever/cultivation-world-simulator&type=Date" alt="Star History Chart" width="600">
+  </a>
+</div>
+
+## 👥 Contributors
+- Aku, for world design & discussion
+- [@xzhseh](https://github.com/xzhseh), contributed code
+
+## 🙏 Acknowledgments
+- Referenced some UI elements from ailifeengine
+
+## 📋 Development Progress
 
 ### 🏗️ Foundation
-- ✅ World map basics
+- ✅ World map basics, time, event system
 - ✅ Diverse terrain types (plain, mountain, forest, desert, water, etc.)
-- ✅ Time system
-- ✅ Frontend UI
+- ✅ Web-based frontend interface
 - ✅ Simulation framework
-- ✅ Project documentation
-- ✅ Config system
+- ✅ Configuration files
 - ✅ Standalone release (packaged exe)
-- [ ] Menu bar (in progress)
-- [ ] Web frontend (later)
-- [ ] ECS parallel toolkit (later)
-- [ ] Player-configurable prompts (later)
+- ✅ Menu bar & Save & Load
+- ✅ Flexible custom LLM interface
+- ✅ Support macOS
+- [ ] Support multi-language localization
+- [ ] Game settings panel at startup
 
 ### 🗺️ World System
 - ✅ Basic tile mechanics
 - ✅ Normal, cultivate, city, sect regions
 - ✅ Same-tile NPC interactions
 - ✅ Qi distribution and yields
-- [ ] Dynamic worldview, map, history, sect, and notable figure generation
+- ✅ World event
 
 ### 👤 Character System
 - ✅ Core attributes
 - ✅ Cultivation realms
 - ✅ Spiritual roots
 - ✅ Basic movement actions
-- ✅ Personality
+- ✅ Trait & Personality
 - ✅ Breakthrough system
 - ✅ Relationships
-- ✅ Perception radius
-- ✅ Buff system: buffs/debuffs
-- ✅ Artifacts
-- [ ] Character compatibility
-- [ ] Special abilities
-- [ ] Epithets/nicknames
-- [ ] Combat-related
-  - [ ] Attribute points allocation
-  - [ ] Skill system (techniques)
-  - [ ] Equipment system
-- [ ] Skill learning
-  - [ ] Learnable skills
-  - [ ] Personal techniques (flexible integration)
-  - [ ] Life professions (alchemy, formations, farming, forging, etc., with tailored prompts and info space)
-- [ ] Mortals support
+- ✅ Interaction range
+- ✅ Effect system: buffs/debuffs
+- ✅ Techniques
+- ✅ Combat equipment & auxiliary equipment
+- ✅ Elixir
+- ✅ Short/Long term memory
+- ✅ Character's short and long term objectives, supporting player active setting
+- ✅ Avatar nicknames
+- [ ] Life Skills
+  - ✅ Forging
+  - ✅ Refine
+  - [ ] Planting
+  - [ ] Taming
+  - [ ] Evolving skills
+- [ ] Mortals
 - [ ] Prodigies (stronger abilities and AI)
 
 ### 🏛️ Organizations
 - [ ] Sect system
   - ✅ Settings, techniques, healing, base, styles
-  - ✅ Special sect actions: Hehuan Sect (dual cultivation), Hundred Beasts Sect (catch spirit animal)
-  - [ ] sect will AI, tasks, recruiting
-  - [ ] Sect tiers: different titles, abilities, actions
+  - ✅ Special sect actions: Hehuan Sect (dual cultivation), Hundred Beasts Sect (beast taming)
+  - ✅ Sect tiers
+  - [ ] Sect will AI
+  - [ ] Sect tasks
 - [ ] Clans
 - [ ] Court/Empire (TBD)
 - [ ] Inter-organization relations
@@ -94,36 +216,34 @@ If you like this project, consider starring it~ You can also watch intro videos
 ### ⚡ Action System
 - ✅ Basic movement
 - ✅ Action execution framework
-- ✅ Defined actions (rule-complete)
+- ✅ Defined actions
 - ✅ Long-duration actions and settlement
   - ✅ Multi-month actions (cultivate, breakthrough, play, etc.)
   - ✅ Auto-settlement upon completion
 - ✅ Multiplayer actions: initiator + responder flow
 - ✅ LLM actions that affect relationships
 - ✅ Systematic action registration and runtime logic
-- [ ] Richer actions
 
 ### 🎭 Event System
+- ✅ Heaven-earth Qi fluctuations
 - [ ] World-scale events:
   - [ ] Auctions
   - [ ] Secret realm exploration
   - [ ] Martial tournaments
+  - [ ] Sect grand competition
 - [ ] Sudden events
   - [ ] Treasure/cave emergence
-  - [ ] Novelized/CG/film-style presentations
 - [ ] Natural events:
   - [ ] Natural disasters
   - [ ] Beast tides
 
 ### ⚔️ Combat
-- [ ] Combat design (roots influence skills and styles)
-- [ ] Advantages and counters
-- ✅ Win-rate estimation (simple)
+- ✅ Advantages and counters
+- ✅ Win-rate estimation system
 
 ### 🎒 Items
 - ✅ Basic items and spirit stones
-- [ ] Trading mechanics
-- [ ] Economy system
+- ✅ Trading mechanics
 
 ### 🌿 Ecology
 - ✅ Animals and plants
@@ -143,64 +263,27 @@ If you like this project, consider starring it~ You can also watch intro videos
   - ✅ Battle micro-theaters
   - ✅ Dialogue micro-theaters
   - ✅ Multiple writing styles
-- [ ] NPC observation space design
-- [ ] One-off choices (e.g., switch techniques or not)
-- [ ] Long-term memories / unforgettable memories
+- ✅ One-off choices (e.g., switch techniques or not)
 
 ### 🏛️ World Lore
-- [ ] Lore framework
-- [ ] Worldbuilding
-- [ ] Ancient history generation
+- ✅ Inject basic world knowledge
+- ✅ User input history, dynamic generation of techniques, equipment, sects, and region info
 
-### Specials
+### ✨ Specials
 - ✅ Fortuitous encounters
-- [ ] Paths/Daos
+- ✅ Tribulations & Heart devils
 - [ ] Possession & Rebirth
+- [ ] Opportunities & Karma
+- [ ] Divination & Prophecy
+- [ ] Male appearance female traits & Female appearance male traits
+- [ ] Character Secrets & Two-faced
+- [ ] Ascension to Upper Realm
 - [ ] Formations
-- [ ] Opportunities
-- [ ] Tribulations & Heart devils
-- [ ] Flexible world rules
-- [ ] Divination & Omens
-- [ ] Male-female traits inversion
-
-## Usage
-
-### Run Steps
-1. Clone the repo:
-   ```bash
-   git clone https://github.com/your-username/cultivation-world-simulator.git
-   cd cultivation-world-simulator
-   ```
-
-2. Install dependencies:
-   ```bash
-   pip install -r requirements.txt
-   ```
-
-3. Configure LLM:
-   Edit `static/config.yml`:
-   ```yaml
-   llm:
-     model_name: "qwen-plus"  # or another model supported by LiteLLM
-     key: "your-api-key-here"     # your API key
-     base_url: "https://dashscope.aliyuncs.com/compatible-mode/v1"
-   ```
-   For supported models, refer to [litellm documentation](https://docs.litellm.ai/docs/providers)
-
-4. Run the simulator:
-   ```bash
-   python -m src.run.run
-   ```
-
-## Contributors
-- Aku, for world design & discussion
-
-## License
-
-This project is licensed as specified in the [LICENSE](LICENSE) file.
-
-## Contact
-
-If you have any questions or suggestions, feel free to open an Issue or Pull Request.
-You're also welcome to leave a message on my [Bilibili account](https://space.bilibili.com/527346837)!
+- [ ] Paths/Daos
+- [ ] World Secrets & World Laws (Flexible customization)
+- [ ] Gu Refining
+- [ ] World-ending Crisis
 
+### 🔭 Long-term
+- [ ] Novelization/imagery/video for history and events
+- [ ] Avatar calling MCP tools on their own

README.md

@@ -1,86 +1,215 @@
 <!-- 语言 / Language -->
-<p align="center">
+<h3 align="center">
   <a href="README.md">🇨🇳 中文</a> · <a href="EN_README.md">🇺🇸 English</a>
-</p>
+</h3>
 <p align="center">— ✦ —</p>
 
 # 修仙世界模拟器 (Cultivation World Simulator)
 
-一个AI驱动的修仙世界模拟器，旨在创造一个真正活着的、有沉浸感的仙侠世界。
+![GitHub stars](https://img.shields.io/github/stars/4thfever/cultivation-world-simulator?style=social)
+[![Bilibili](https://img.shields.io/badge/Bilibili-%E6%9F%A5%E7%9C%8B%E8%A7%86%E9%A2%91-FB7299?logo=bilibili)](https://space.bilibili.com/527346837)
+![QQ Group](https://img.shields.io/badge/QQ%E7%BE%A4-1071821688-deepskyblue?logo=tencent-qq&logoColor=white)
 
-## 简介
+![Last Commit](https://img.shields.io/github/last-commit/4thfever/cultivation-world-simulator)
+![Commit Activity](https://img.shields.io/github/commit-activity/y/4thfever/cultivation-world-simulator)
+![Repo Size](https://img.shields.io/github/repo-size/4thfever/cultivation-world-simulator)
+[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
 
-修仙世界模拟器是一个结合传统游戏规则和大语言模型的模拟器。通过建立完整的修仙世界规则，创造一个可以自主运行、充满生机、有沉浸感和涌现式剧情的虚拟修仙世界。
+![Status](https://img.shields.io/badge/Status-Alpha-tomato)
+![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)
+![Genre: Xianxia](https://img.shields.io/badge/Genre-Xianxia-red)
+![Powered by LLM](https://img.shields.io/badge/Powered%20by-LLM-0077B5)
+![AI Agent](https://img.shields.io/badge/AI-Agent-orange)
+![OpenAI Compatible](https://img.shields.io/badge/OpenAI%20API-Compatible-412991)
 
-项目的核心理念是：**先建立可信的规则体系作为"世界模型"基础，再接入AI使世界生动起来**。
+![Python](https://img.shields.io/badge/Python-3.10%2B-blue?style=flat&logo=python&logoColor=white)
+![FastAPI](https://img.shields.io/badge/FastAPI-005571?style=flat&logo=fastapi&logoColor=white)
+![Vue](https://img.shields.io/badge/Vue.js-3.x-4FC08D?style=flat&logo=vuedotjs&logoColor=white)
+![TypeScript](https://img.shields.io/badge/typescript-%23007ACC.svg?style=flat&logo=typescript&logoColor=white)
+![Vite](https://img.shields.io/badge/vite-%23646CFF.svg?style=flat&logo=vite&logoColor=white)
+![PixiJS](https://img.shields.io/badge/PixiJS-E72264?style=flat&logo=pixijs&logoColor=white)
 
-### 技术架构
 
-- **前端显示**: pygame (未来可能支持Web)
-- **模拟引擎**: 自研事件驱动模拟器
-- **世界模型**: 基于规则的确定性系统
-- **AI集成**: LLM接口生成动作、决策、小剧场
+<p align="center">
+  <img src="assets/screenshot.gif" alt="游戏演示" width="100%">
+</p>
 
-## 项目背景
+> **一个AI驱动的修仙世界模拟器，旨在创造一个真正活着的、有沉浸感的仙侠世界。**
 
-从小一直是修仙网文的读者，从最早的蜀山仙侠传，到比较新的赤心巡天，修仙网文陪伴了我非常多的时间。
+## 📖 简介
 
-作为游戏AI行业的从业者，对LLM这两年的进步感触很深。我认为，现在的LLM智能水平，已经足够支持起来一些仙侠风格的世界模拟了。
+这是一个 **AI 驱动的开放世界修仙模拟器**。
 
-但是，纯粹只有LLM为NPC提供决策和对话能力是不够的。首先，要有可信的规则打底，作为修仙世界的"世界模型"。之后，才是接入LLM，使其生动起来。
+不同于传统的 RPG 扮演某个角色，在这里，**你将扮演“天道”（上帝）**。
+你不需要亲自打怪升级，而是以上帝视角观察众生，在规则与 AI 共同编织的开放世界中，见证门派兴衰与天骄崛起。你可以静观沧海桑田，也可以降下天劫或魔改心灵，微妙地干预世界进程。
 
-我希望能够创造出纯粹的、快乐的、直接的、活着的修仙世界的沉浸感。不是像一些游戏公司的纯粹宣传工具，也不是像斯坦福小镇那样的纯粹研究，而是能给玩家提供真实代入感和沉浸感的实际世界。
+### ✨ 核心亮点
 
-欢迎大家提出意见或者建议，喜欢的话可以点个star~也可以去[我的B站账号](https://space.bilibili.com/527346837)观看本项目的介绍视频。
+- 👁️ **扮演“天道” (上帝视角)**：你不是修士，而是掌控世界规则的**天道**。观察众生百态，体味苦辣酸甜。
+- 🤖 **全员 AI 驱动**：每个 NPC 都独立基于LLM驱动，都有独立的性格、记忆、人际关系和行为逻辑。他们会根据即时局势做出决策，会有爱恨情仇，会结党营私，甚至会逆天改命。
+- 🌏 **规则作为基石**：世界基于灵根、境界、功法、寿元等严谨的数值体系运行。AI 的想象力被限制在合理的修仙逻辑框架内，确保世界真实可信。
+- 🦋 **涌现式剧情**：开发者也不知道下一秒会发生什么。没有预设剧本，只有无数因果交织出的世界演变。宗门大战、正魔之争、天骄陨落，皆由世界逻辑自主推演。
 
-![游戏截图](assets/screenshot.png)
+<table border="0">
+  <tr>
+    <td width="33%" valign="top">
+      <h4 align="center">宗门体系</h4>
+      <img src="assets/screenshots/宗门.png" width="100%" />
+      <br/><br/>
+      <h4 align="center">城市区域</h4>
+      <img src="assets/screenshots/城市.png" width="100%" />
+      <br/><br/>
+      <h4 align="center">生平经历</h4>
+      <img src="assets/screenshots/经历.png" width="100%" />
+    </td>
+    <td width="33%" valign="top">
+      <h4 align="center">角色面板</h4>
+      <img src="assets/screenshots/角色.png" width="100%" />
+      <br/><br/>
+      <h4 align="center">性格特质</h4>
+      <img src="assets/screenshots/特质.png" width="100%" />
+      <br/><br/>
+      <h4 align="center">自主思考</h4>
+      <img src="assets/screenshots/思考.png" width="100%" />
+      <br/><br/>
+      <h4 align="center">江湖绰号</h4>
+      <img src="assets/screenshots/绰号.png" width="100%" />
+    </td>
+    <td width="33%" valign="top">
+      <h4 align="center">洞府探秘</h4>
+      <img src="assets/screenshots/洞府.png" width="100%" />
+      <br/><br/>
+      <h4 align="center">长短期目标</h4>
+      <img src="assets/screenshots/目标.png" width="100%" />
+      <br/><br/>
+      <h4 align="center">丹药/法宝/武器</h4>
+      <img src="assets/screenshots/丹药.png" width="100%" />
+      <img src="assets/screenshots/法宝.png" width="100%" />
+      <img src="assets/screenshots/武器.png" width="100%" />
+    </td>
+  </tr>
+</table>
 
-## 功能开发进度
+### 💭 为什么要做这个？
+修仙网文中的世界很精彩，但读者永远只能观察到一隅。
+
+修仙品类游戏要么是完全的预设剧本，要么依靠人工设计的简单规则状态机，有许许多多牵强和降智的表现。
+
+在大语言模型出现后，让“每一个角色都是鲜活的”的目标变得似乎可以触达了。
+
+希望能够创造出纯粹的、快乐的、直接的、活着的修仙世界的沉浸感。不是像一些游戏公司的纯粹宣传工具，也不是像斯坦福小镇那样的纯粹研究，而是能给玩家提供真实代入感和沉浸感的实际世界。
+
+## 📞 联系方式
+如果您对项目有任何问题或建议，欢迎提交 Issue 或 Pull Request。  
+欢迎给我的[B站账号](https://space.bilibili.com/527346837)留言！  
+也可以加入QQ群进行讨论：1071821688。进群问题的答案：肥桥今天吃什么
+
+## 🚀 使用方法
+
+### ⚙️ 运行步骤
+1. 克隆项目到本地：
+   ```bash
+   git clone https://github.com/your-username/cultivation-world-simulator.git
+   cd cultivation-world-simulator
+   ```
+
+2. 安装依赖：
+   ```bash
+   # 后端依赖
+   pip install -r requirements.txt
+   
+   # 前端依赖 (需Node.js环境)
+   cd web && npm install
+   ```
+
+3. 配置LLM：
+   在 `static/config.yml` 中配置LLM参数（OpenAI格式）：
+   ```yaml
+    llm:
+      key: "your-api-key-here"           # 你的API密钥
+      base_url: "https://api.xxx.com"    # API地址
+      model_name: "normal_model_name"    # 智能模型名称
+      fast_model_name: "fast_model_name" # 快速模型名称
+   ```
+
+   也支持在前端直接配入LLM参数：
+   
+   <img src="assets/llm_config.png" alt="前端LLM配置" width="100%">
+
+4. 运行：
+   ```bash
+   # 启动服务 (推荐开发模式，会自动启动前端)
+   python src/server/main.py --dev
+   ```
+   浏览器会自动打开网页前端。
+
+
+## 📊 项目状态
+
+![Repobeats analytics](https://repobeats.axiom.co/api/embed/91667dce0fca651a7427022b2d819d20dd17c5e3.svg "Repobeats analytics image")
+
+## ⭐ Star History
+
+如果你觉得这个项目有趣，请给我们一个 Star ⭐！这将激励我们持续改进和添加新功能。
+
+<div align="center">
+  <a href="https://star-history.com/#4thfever/cultivation-world-simulator&Date">
+    <img src="https://api.star-history.com/svg?repos=4thfever/cultivation-world-simulator&type=Date" alt="Star History Chart" width="600">
+  </a>
+</div>
+
+## 👥 贡献者
+* Aku, 世界观\玩法设计与讨论
+* [@xzhseh](https://github.com/xzhseh), 贡献代码
+
+## 🙏 致谢
+- 参考了ai life engine部分ui
+
+## 📋 功能开发进度
 
 ### 🏗️ 基础系统
-- ✅ 基础世界地图系统
+- ✅ 基础世界地图、时间、事件系统
 - ✅ 多样化地形类型（平原、山脉、森林、沙漠、水域等）
-- ✅ 时间系统
-- ✅ 前端显示界面
+- ✅ 基于Web前端显示界面
 - ✅ 基础模拟器框架
-- ✅ 项目文档
-- ✅ 配置文件系统
-- ✅ 单独release打包好的exe文件
-- [ ] 菜单栏（施工中）
-- [ ] Web前端支持（后期考虑）
-- [ ] ECS并行工具（后期考虑）
-- [ ] 玩家自定义prompt（后期考虑）
+- ✅ 配置文件
+- ✅ release 一键即玩的exe
+- ✅ 菜单栏 & 存档 & 读档
+- ✅ 灵活自定义LLM接口
+- ✅ 支持mac os
+- [ ] 支持多语言本地化
+- [ ] 开始游戏时的游戏设定栏
 
 ### 🗺️ 世界系统
 - ✅ 基础tile地块系统
 - ✅ 基础区域、修行区域、城市区域、宗门区域
 - ✅ 同地块NPC交互
 - ✅ 灵气分布与产出设计
-- [ ] 动态世界观设定、地图、历史、宗门、名人生成
+- ✅ 世界事件
 
 ### 👤 角色系统
 - ✅ 角色基础属性系统
 - ✅ 修炼境界体系
 - ✅ 灵根系统
 - ✅ 基础移动动作
-- ✅ 角色性格
+- ✅ 角色特质与性格
 - ✅ 境界突破机制
 - ✅ 角色间的相互关系
 - ✅ 角色交互范围
-- ✅ 角色Buffs系统：增益/减益效果
-- ✅ 法宝
-- ✅ 角色特质
-- [ ] 角色之间的相性
-- [ ] 角色绰号
-- [ ] 战斗相关
-  - [ ] 属性点分配
-  - [ ] 技能系统（功法）
-  - [ ] 装备系统
-- [ ] 技能学习系统：
-  - [ ] 可学习技能
-  - [ ] 个人技（灵活融入代码）
-  - [ ] 生活职业（丹药、阵法、种植、铸造etc，配合特殊prompt和信息空间）
-- [ ] 凡人角色支持
+- ✅ 角色Effects系统：增益/减益效果
+- ✅ 角色功法
+- ✅ 角色兵器 & 辅助装备
+- ✅ 丹药
+- ✅ 角色长短期记忆
+- ✅ 角色的长短期目标，支持玩家主动设定
+- ✅ 角色绰号
+- [ ] 生活技能
+  - ✅ 铸造
+  - ✅ 炼丹
+  - [ ] 种植
+  - [ ] 饲养
+  - [ ] 技能可升级
+- [ ] 凡人系统
 - [ ] 天骄系统（更强能力，更强AI）
 
 ### 🏛️ 组织系统
@@ -88,49 +217,48 @@
   - ✅ 设定、功法、疗伤、驻地、行事风格
   - ✅ 宗门特殊动作：合欢宗（双修），百兽宗（御兽）
   - ✅ 宗门等阶
-  - [ ] 宗门意志ai、宗门任务、接引新人
+  - [ ] 宗门意志ai
+  - [ ] 宗门任务
 - [ ] 世家系统
-- [ ] 朝廷系统（不确定）
+- [ ] 朝廷系统（未定）
 - [ ] 组织间关系网络
 
 ### ⚡ 动作系统
 - ✅ 基础移动动作
 - ✅ 动作执行框架
-- ✅ 有明确规则的定义动作(Defined Action)
+- ✅ 有明确规则的定义动作
 - ✅ 长动作执行和结算系统
   - ✅ 支持多月份持续的动作（如修炼、突破、游戏等）
   - ✅ 动作完成时的自动结算机制
 - ✅ 多人动作：动作发起与动作响应
-- ✅ 影响人际关系的LLM动作(LLM Action)
+- ✅ 影响人际关系的LLM动作
 - ✅ 系统性的动作注册与运行逻辑
-- [ ] 更丰富的角色动作
 
 ### 🎭 事件系统
+- ✅ 天地灵气变动
 - [ ] 世界范围大事件：
   - [ ] 拍卖会
   - [ ] 秘境探索
   - [ ] 比武大会
+  - [ ] 宗门大比
 - [ ] 突发事件
   - [ ] 宝物/洞府出世
-  - [ ] 突发事件的小说化&CG化&影视化
 - [ ] 自然事件：
   - [ ] 自然灾害
   - [ ] 兽潮
 
 ### ⚔️ 战斗系统
-- [ ] 战斗方式设计（灵根影响技能与战斗风格）
-- [ ] 优劣互克关系
-- ✅ 胜率计算系统（简单）
+- ✅ 优劣互克关系
+- ✅ 胜率计算系统
 
 ### 🎒 物品系统
 - ✅ 基础物品、灵石框架
-- [ ] 物品交易机制
-- [ ] 经济系统
+- ✅ 物品交易机制
 
 ### 🌿 生态系统
 - ✅ 动植物
 - ✅ 狩猎、采集、材料系统
-- [ ] 魔兽系统
+- [ ] 魔兽
 
 ### 🤖 AI增强系统
 - ✅ LLM接口集成
@@ -145,62 +273,27 @@
   - ✅ 战斗小剧场
   - ✅ 对话小剧场
   - ✅ 小剧场不同文字风格
-- [ ] NPC观测空间设计
-- [ ] 一次性选择（如是否要切换功法）
-- [ ] 长期记忆/刻骨铭心的记忆
+- ✅ 一次性选择（如是否要切换功法）
 
 ### 🏛️ 世界背景系统
-- [ ] 背景故事框架
-- [ ] 世界观生成
-- [ ] 上古历史生成
+- ✅ 注入基础世界知识
+- ✅ 用户输入历史，动态生成功法、装备、宗门、区域信息
 
-### 特殊
+### ✨ 特殊
 - ✅ 奇遇
-- [ ] 道途
+- ✅ 天劫 & 心魔
 - [ ] 夺舍 & 重生
-- [ ] 阵法
-- [ ] 机缘
-- [ ] 天劫 & 心魔
-- [ ] 可灵活自定义的世界法则
+- [ ] 机缘 & 因果
 - [ ] 占卜 & 谶纬
 - [ ] 男生女相 & 女生男相
+- [ ] 角色隐秘 & 双面人
+- [ ] 飞升上界
+- [ ] 阵法
+- [ ] 道途
+- [ ] 世界秘密 & 世界法则 （可灵活自定义） 
+- [ ] 炼蛊
+- [ ] 灭世危机
 
-## 使用方法
-
-### 运行步骤
-1. 克隆项目到本地：
-   ```bash
-   git clone https://github.com/your-username/cultivation-world-simulator.git
-   cd cultivation-world-simulator
-   ```
-
-2. 安装依赖：
-   ```bash
-   pip install -r requirements.txt
-   ```
-
-3. 配置LLM：
-   在 `static/config.yml` 中配置LLM参数：
-   ```yaml
-   llm:
-     model_name: "qwen-plus"  # 或其他litellm支持的模型名称
-     key: "your-api-key-here"     # 你的API密钥
-      base_url: "https://dashscope.aliyuncs.com/compatible-mode/v1"
-   ```
-   具体支持的模型请参考 [litellm文档](https://docs.litellm.ai/docs/providers)
-
-4. 运行模拟器：
-   ```bash
-   python -m src.run.run
-   ```
-
-## 贡献者
-- Aku, 世界观\玩法设计与讨论
-
-## 许可证
-
-本项目采用 [LICENSE](LICENSE) 文件中指定的许可证。
-
-## 联系方式
-如果您对项目有任何问题或建议，欢迎提交 Issue 或 Pull Request。
-也欢迎给我的[B站账号](https://space.bilibili.com/527346837)留言！
+### 🔭 远期展望
+- [ ] 历史/事件的小说化&图片化&视频化
+- [ ] MCP agent化，修士自行调用工具