fix: package bug

- Test LLM response parsing (list and dict formats)
- Test null params conversion to empty dict
- Test invalid format handling and skipping
- Test emotion update logic with all emotion types
- Test fallback to CALM on invalid/missing emotion
- Test batch avatar processing
- Test AI.decide wrapper returns NULL_EVENT
- Test thinking field variants (avatar_thinking vs thinking)
- Add testing strategy documentation to test file

Closes #63

.github/workflows/test.yml

@@ -9,6 +9,7 @@ on:
 jobs:
   test:
     runs-on: ubuntu-latest
+    timeout-minutes: 10
 
     steps:
       - uses: actions/checkout@v4
@@ -27,7 +28,14 @@ jobs:
       - name: Install dependencies
         run: |
           uv pip install --system -r requirements.txt
-          uv pip install --system pytest
+          uv pip install --system pytest pytest-cov
 
-      - name: Run tests
-        run: pytest -v
+      - name: Run tests with coverage
+        run: pytest -v --cov=src --cov-report=xml --cov-report=term --cov-fail-under=60
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v4
+        with:
+          files: ./coverage.xml
+          fail_ci_if_error: false
+          token: ${{ secrets.CODECOV_TOKEN }}  # Optional for public repos, but recommended

CONTRIBUTING.md

@@ -2,6 +2,8 @@
 
 感谢你对 **Cultivation World Simulator** (修仙模拟器) 感兴趣！欢迎任何形式的贡献，包括修复 Bug、改进文档或开发新功能。
 
+> **重要**：任何新功能提交请务必提前在 issue 中讨论清楚，得到维护者确认后，再进行贡献。
+
 为了保持代码库的健康和风格统一，请在贡献前阅读以下指南。
 
 ## 🛠️ 开发环境搭建

EN_README.md

@@ -51,34 +51,45 @@ You don't need to personally fight monsters or level up. Instead, you observe al
 
 <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%" />
+      <img src="assets/screenshots/宗门.png" width="100%" />
+      <br/><br/>
+      <h4 align="center">City Regions</h4>
+      <img src="assets/screenshots/城市.png" width="100%" />
       <br/><br/>
       <h4 align="center">Life Experiences</h4>
-      <img src="assets/经历.png" width="100%" />
+      <img src="assets/screenshots/经历.png" width="100%" />
     </td>
     <td width="33%" valign="top">
-      <h4 align="center">Independent Thinking</h4>
-      <img src="assets/思考.png" width="100%" />
+      <h4 align="center">Character Panel</h4>
+      <img src="assets/screenshots/角色.png" width="100%" />
       <br/><br/>
-      <h4 align="center">Short/Long Term Goals</h4>
-      <img src="assets/目标.png" width="100%" />
+      <h4 align="center">Personality Traits</h4>
+      <img src="assets/screenshots/特质.png" width="100%" />
+      <br/><br/>
+      <h4 align="center">Independent Thinking</h4>
+      <img src="assets/screenshots/思考.png" width="100%" />
       <br/><br/>
       <h4 align="center">Nicknames</h4>
-      <img src="assets/绰号.png" width="100%" />
+      <img src="assets/screenshots/绰号.png" width="100%" />
+    </td>
+    <td width="33%" valign="top">
+      <h4 align="center">Cave Exploration</h4>
+      <img src="assets/screenshots/洞府.png" width="100%" />
+      <br/><br/>
+      <h4 align="center">Short/Long Term Goals</h4>
+      <img src="assets/screenshots/目标.png" width="100%" />
+      <br/><br/>
+      <h4 align="center">Elixirs/Artifacts/Weapons</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>
 
-### Why make this?
+### 💭 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.
@@ -87,13 +98,75 @@ With the advent of Large Language Models, the goal of making "every character al
 
 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
+## 📞 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 is my Bilibili nickname.  
+You can also join the QQ group for discussion: 1071821688. Verification answer: 肥桥今天吃什么 
 
-## Development Progress
+## 🚀 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, time, event system
@@ -106,6 +179,7 @@ You can also join the QQ group for discussion: 1071821688. Verification answer i
 - ✅ Flexible custom LLM interface
 - ✅ Support macOS
 - [ ] Support multi-language localization
+- ✅ Start Game Page
 
 ### 🗺️ World System
 - ✅ Basic tile mechanics
@@ -137,7 +211,6 @@ You can also join the QQ group for discussion: 1071821688. Verification answer i
   - [ ] Taming
   - [ ] Evolving skills
 - [ ] Mortals
-- [ ] Prodigies (stronger abilities and AI)
 
 ### 🏛️ Organizations
 - [ ] Sect system
@@ -164,7 +237,7 @@ You can also join the QQ group for discussion: 1071821688. Verification answer i
 ### 🎭 Event System
 - ✅ Heaven-earth Qi fluctuations
 - [ ] World-scale events:
-  - [ ] Auctions
+  - ✅ Auctions
   - [ ] Secret realm exploration
   - [ ] Martial tournaments
   - [ ] Sect grand competition
@@ -204,10 +277,9 @@ You can also join the QQ group for discussion: 1071821688. Verification answer i
 
 ### 🏛️ World Lore
 - ✅ Inject basic world knowledge
-- [ ] Dynamic worldview generation
-- [ ] Dynamic generation of techniques, equipment, sects, and maps based on user input history
+- ✅ User input history, dynamic generation of techniques, equipment, sects, and region info
 
-### Specials
+### ✨ Specials
 - ✅ Fortuitous encounters
 - ✅ Tribulations & Heart devils
 - [ ] Possession & Rebirth
@@ -215,62 +287,13 @@ You can also join the QQ group for discussion: 1071821688. Verification answer i
 - [ ] Divination & Prophecy
 - [ ] Male appearance female traits & Female appearance male traits
 - [ ] Character Secrets & Two-faced
-- [ ] Ascension to Upper Realm
+- [ ] Ascension to Heaven
 - [ ] Formations
 - [ ] Paths/Daos
 - [ ] World Secrets & World Laws (Flexible customization)
 - [ ] Gu Refining
 - [ ] World-ending Crisis
-- [ ] Become a Legend of Later Ages
 
 ### 🔭 Long-term
 - [ ] Novelization/imagery/video for history and events
-- [ ] Avatar calling MCP tools on their own
-
-## 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.
-
-
-## Contributors
-- Aku, for world design & discussion
-- [@xzhseh](https://github.com/xzhseh), contributed code
-
-## Acknowledgments
-- Referenced some UI elements from ailifeengine
+- [ ] Avatar calling MCP tools on their own

README.md

@@ -14,6 +14,7 @@
 ![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)
+[![codecov](https://codecov.io/gh/AI-Cultivation/cultivation-world-simulator/graph/badge.svg)](https://codecov.io/gh/AI-Cultivation/cultivation-world-simulator)
 
 ![Status](https://img.shields.io/badge/Status-Alpha-tomato)
 ![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)
@@ -90,7 +91,7 @@
   </tr>
 </table>
 
-### 为什么要做这个？
+### 💭 为什么要做这个？
 修仙网文中的世界很精彩，但读者永远只能观察到一隅。
 
 修仙品类游戏要么是完全的预设剧本，要么依靠人工设计的简单规则状态机，有许许多多牵强和降智的表现。
@@ -99,12 +100,84 @@
 
 希望能够创造出纯粹的、快乐的、直接的、活着的修仙世界的沉浸感。不是像一些游戏公司的纯粹宣传工具，也不是像斯坦福小镇那样的纯粹研究，而是能给玩家提供真实代入感和沉浸感的实际世界。
 
-## 联系方式
+## 📞 联系方式
 如果您对项目有任何问题或建议，欢迎提交 Issue 或 Pull Request。  
 欢迎给我的[B站账号](https://space.bilibili.com/527346837)留言！  
-也可以加入QQ群进行讨论：1071821688。进群需要输入我的B站昵称。  
+也可以加入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
+   ```
+   浏览器会自动打开网页前端。
+
+
+## 📊 项目状态
+
+<div align="center">
+  <img src="https://github-readme-activity-graph.vercel.app/graph?username=4thfever&repo=cultivation-world-simulator&theme=github-compact&hide_border=true&area=true" width="100%" alt="Activity Graph" />
+</div>
+
+<br/>
+
+![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>
+
+## 👥 贡献者
+
+<a href="https://github.com/4thfever/cultivation-world-simulator/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=4thfever/cultivation-world-simulator&max=100&columns=12" />
+</a>
+
+* **Aku** - 世界观 & 玩法设计与讨论
+* **[@xzhseh](https://github.com/xzhseh)** - 贡献代码
+
+## 🙏 致谢
+- 参考了ai life engine部分ui
+
+## 📋 功能开发进度
 
 ### 🏗️ 基础系统
 - ✅ 基础世界地图、时间、事件系统
@@ -116,8 +189,8 @@
 - ✅ 菜单栏 & 存档 & 读档
 - ✅ 灵活自定义LLM接口
 - ✅ 支持mac os
-- [ ] 支持多语言本地化
-- [ ] 开始游戏时的游戏设定栏
+- [ ] 多语言本地化
+- ✅ 开始游戏页
 
 ### 🗺️ 世界系统
 - ✅ 基础tile地块系统
@@ -149,7 +222,6 @@
   - [ ] 饲养
   - [ ] 技能可升级
 - [ ] 凡人系统
-- [ ] 天骄系统（更强能力，更强AI）
 
 ### 🏛️ 组织系统
 - [ ] 宗门系统
@@ -175,8 +247,8 @@
 
 ### 🎭 事件系统
 - ✅ 天地灵气变动
-- [ ] 世界范围大事件：
-  - [ ] 拍卖会
+- ✅ 多人大事件：
+  - ✅ 拍卖会
   - [ ] 秘境探索
   - [ ] 比武大会
   - [ ] 宗门大比
@@ -216,10 +288,9 @@
 
 ### 🏛️ 世界背景系统
 - ✅ 注入基础世界知识
-- [ ] 动态世界观生成
-- [ ] 基于用户输入历史的动态功法、装备、宗门、地图生成
+- ✅ 用户输入历史，动态生成功法、装备、宗门、区域信息
 
-### 特殊
+### ✨ 特殊
 - ✅ 奇遇
 - ✅ 天劫 & 心魔
 - [ ] 夺舍 & 重生
@@ -236,51 +307,4 @@
 
 ### 🔭 远期展望
 - [ ] 历史/事件的小说化&图片化&视频化
-- [ ] MCP agent化，修士自行调用工具
-
-## 使用方法
-
-### 运行步骤
-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
-   ```
-   浏览器会自动打开网页前端。
-
-
-## 贡献者
-* Aku, 世界观\玩法设计与讨论
-* [@xzhseh](https://github.com/xzhseh), 贡献代码
-
-## 致谢
-- 参考了ai life engine部分ui
+- [ ] MCP agent化，修士自行调用工具