fix: pack i18n

* feat: add vue-i18n

* feat: add vue-i18n

* feat: add vue-i18n

* feat: add language class

* add: en templates and configs

* add: en names

* refactor: name gender id and sect id

* feat(i18n): add gettext infrastructure for dynamic text translation (#81)

* feat(i18n): add gettext infrastructure for dynamic text translation

- Add src/i18n/ module with t() translation function
- Add .po/.mo files for zh_CN and en_US locales
- Update LanguageManager to reload translations on language change
- Add comprehensive tests (14 tests, all passing)
- Add implementation spec at docs/specs/i18n-dynamic-text.md

Phase 1 of i18n dynamic text implementation.

* feat(i18n): expand .po files with comprehensive translation entries

Add translation messages for:
- Battle result messages (fatal/non-fatal outcomes)
- Fortune event messages (item discovery, cultivation gains)
- Misfortune event messages (losses, damage, regression)
- Death reason messages
- Item exchange messages (equip, sell, discard)
- Single choice context and option labels
- Common labels (weapon, auxiliary, technique, elixir)

Both zh_CN and en_US locales updated with matching entries.

* test: add .po file integrity tests

* feat: i18n for actions

* feat: i18n for effects

* feat: i18n for gathering

* feat: i18n for classes

* feat: i18n for classes

* feat: i18n for classes

* feat: i18n for classes

* fix bugs

* fix bugs

* fix bugs

* fix bugs

* fix bugs

* fix bugs

* fix bugs

* fix bugs

* update csv

* update world info

* update prompt

* update prompt

* fix bug

* fix bug

* fix bug

* fix bug

* fix bug

* fix bug

* fix bug

* fix bug

* fix bug

* update

* update

* update

* update

* update

* update

* update

---------

Co-authored-by: Zihao Xu <xzhseh@gmail.com>

.github/CODEOWNERS

@@ -0,0 +1,2 @@
+/README.md wangxin4qiao@163.com
+/EN_README.md wangxin4qiao@163.com

.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,59 @@
+name: Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+
+    steps:
+      - uses: actions/checkout@v4
+
+      # --- Backend Tests ---
+      - 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 Python dependencies
+        run: |
+          uv pip install --system -r requirements.txt
+          uv pip install --system pytest pytest-cov
+
+      - name: Run backend tests with coverage
+        run: pytest -v --cov=src --cov-report=xml --cov-report=term --cov-fail-under=60
+
+      # --- Frontend Tests ---
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+          cache-dependency-path: web/package-lock.json
+
+      - name: Install Node dependencies
+        working-directory: web
+        run: npm ci
+
+      - name: Run frontend tests with coverage
+        working-directory: web
+        run: npm run test:coverage
+
+      # --- Upload Coverage ---
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v4
+        with:
+          files: ./coverage.xml,./web/coverage/coverage-final.json
+          fail_ci_if_error: false
+          token: ${{ secrets.CODECOV_TOKEN }}

CONTRIBUTING.md

@@ -0,0 +1,84 @@
+# 贡献指南 (Contributing Guide)
+
+感谢你对 **Cultivation World Simulator** (修仙模拟器) 感兴趣！欢迎任何形式的贡献，包括提出Bug、修复 Bug、改进文档或开发新功能。
+
+> **重要**：任何新功能提交，特别是业务功能提交，请务必提前在 issue 中讨论清楚，得到维护者确认后，再进行贡献。
+
+为了保持代码库的健康和风格统一，请在贡献前阅读以下指南。
+
+## 🛠️ 开发环境搭建
+
+具体的安装和启动步骤请参考 [README.md](./README.md) 中的说明。
+
+**项目结构说明：**
+- **后端 (Python)**: 位于 `src/` 目录。
+- **前端 (Vue 3)**: 位于 `web/` 目录。
+
+## ✅ 测试要求 (必须)
+
+在提交 Pull Request 之前，请务必确保所有测试通过。这是保证代码质量的关键。
+
+**运行后端测试：**
+
+本项目在 CI 环境中使用 Python 3.11。
+
+1. 确保已安装测试依赖（包含在 requirements.txt 中）：
+   ```bash
+   pip install -r requirements.txt
+   ```
+
+2. 运行测试并检查覆盖率（需满足 60% 覆盖率要求）：
+   ```bash
+   pytest -v --cov=src --cov-report=term --cov-fail-under=60
+   ```
+
+**运行前端测试 (Vue/Vitest)：**
+
+前端测试位于 `web/` 目录。
+
+1. 进入前端目录并安装依赖：
+   ```bash
+   cd web
+   npm install
+   ```
+
+2. 运行单元测试：
+   ```bash
+   npm run test:run
+   ```
+
+3. 运行测试并查看覆盖率：
+   ```bash
+   npm run test:coverage
+   ```
+
+请确保所有测试用例都能通过（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**。
+
+感谢你的贡献！一起打造更好玩有趣的AI修仙世界。

EN_README.md

@@ -6,6 +6,30 @@
 
 # Cultivation World Simulator
 
+![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)
+
+![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-CC%20BY--NC--SA%204.0-lightgrey)](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)
+![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)
+
+![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)
+
 <p align="center">
   <img src="assets/screenshot.gif" alt="Game Demo" width="100%">
 </p>
@@ -28,34 +52,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/en-US/screenshots/宗门.png" width="100%" />
+      <br/><br/>
+      <h4 align="center">City Region</h4>
+      <img src="assets/en-US/screenshots/城市.png" width="100%" />
       <br/><br/>
       <h4 align="center">Life Experiences</h4>
-      <img src="assets/经历.png" width="100%" />
+      <img src="assets/en-US/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/en-US/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/en-US/screenshots/特质.png" width="100%" />
+      <br/><br/>
+      <h4 align="center">Independent Thinking</h4>
+      <img src="assets/en-US/screenshots/思考.png" width="100%" />
       <br/><br/>
       <h4 align="center">Nicknames</h4>
-      <img src="assets/绰号.png" width="100%" />
+      <img src="assets/en-US/screenshots/绰号.png" width="100%" />
+    </td>
+    <td width="33%" valign="top">
+      <h4 align="center">Dungeon Exploration</h4>
+      <img src="assets/en-US/screenshots/洞府.png" width="100%" />
+      <br/><br/>
+      <h4 align="center">Short/Long Term Goals</h4>
+      <img src="assets/en-US/screenshots/目标.png" width="100%" />
+      <br/><br/>
+      <h4 align="center">Elixirs/Treasures/Weapons</h4>
+      <img src="assets/en-US/screenshots/丹药.png" width="100%" />
+      <img src="assets/en-US/screenshots/法宝.png" width="100%" />
+      <img src="assets/en-US/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.
@@ -64,13 +99,80 @@ 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/en-US/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
+
+<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** - World design & discussion
+- **[@xzhseh](https://github.com/xzhseh)** - Code & Repo maintenance
+
+## 🙏 Acknowledgments
+- Referenced some UI elements from ailifeengine
+
+## 📋 Development Progress
 
 ### 🏗️ Foundation
 - ✅ World map basics, time, event system
@@ -81,6 +183,10 @@ You can also join the QQ group for discussion: 1071821688. Verification answer i
 - ✅ Standalone release (packaged exe)
 - ✅ Menu bar & Save & Load
 - ✅ Flexible custom LLM interface
+- ✅ Support macOS
+- [ ] Android support
+- ✅ Support multi-language localization
+- ✅ Start Game Page
 
 ### 🗺️ World System
 - ✅ Basic tile mechanics
@@ -88,7 +194,6 @@ You can also join the QQ group for discussion: 1071821688. Verification answer i
 - ✅ Same-tile NPC interactions
 - ✅ Qi distribution and yields
 - ✅ World event
-- [ ] Dynamic worldview, map, history, sect, and notable figure generation
 
 ### 👤 Character System
 - ✅ Core attributes
@@ -102,15 +207,17 @@ You can also join the QQ group for discussion: 1071821688. Verification answer i
 - ✅ 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
-- [ ] Character compatibility
-- [ ] Skill learning system:
-  - [ ] Learnable skills
-  - [ ] Life professions (alchemy, formations, planting, forging, etc.)
+- [ ] Life Skills
+  - ✅ Forging
+  - ✅ Refine
+  - [ ] Planting
+  - [ ] Taming
+  - [ ] Evolving skills
 - [ ] Mortals
-- [ ] Prodigies (stronger abilities and AI)
 
 ### 🏛️ Organizations
 - [ ] Sect system
@@ -126,7 +233,7 @@ You can also join the QQ group for discussion: 1071821688. Verification answer i
 ### ⚡ 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
@@ -137,7 +244,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
@@ -176,11 +283,10 @@ You can also join the QQ group for discussion: 1071821688. Verification answer i
 - ✅ 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
 - ✅ Tribulations & Heart devils
 - [ ] Possession & Rebirth
@@ -194,60 +300,7 @@ You can also join the QQ group for discussion: 1071821688. Verification answer i
 - [ ] World Secrets & World Laws (Flexible customization)
 - [ ] Gu Refining
 - [ ] World-ending Crisis
-- [ ] Become a Legend of Later Ages
 
 ### 🔭 Long-term
-- [ ] ECS parallel toolkit
 - [ ] 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 base URL
-      model_name: "model-name"        # main model name
-      fast_model_name: "fast-model"   # 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
-
-## Acknowledgments
-- Referenced some UI elements from ailifeengine
-
-## License
-
-This project is licensed as specified in the [LICENSE](LICENSE) file.
+- [ ] Avatar calling MCP tools on their own

LICENSE

@@ -1,21 +1,155 @@
-MIT License
+Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International Public License
 
-Copyright (c) 2024 cultivation-world-simulator
+By exercising the Licensed Rights (defined below), You accept and agree to be bound by the terms and conditions of this Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International Public License (“Public License”).  To the extent this Public License may be interpreted as a contract, You are granted the Licensed Rights in consideration of Your acceptance of these terms and conditions, and the Licensor grants You such rights in consideration of benefits the Licensor receives from making the Licensed Material available under these terms and conditions.
 
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+Section 1 – Definitions.
 
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+a. Adapted Material means material subject to Copyright and Similar Rights that is derived from or based upon the Licensed Material and in which the Licensed Material is translated, altered, arranged, transformed, or otherwise modified in a manner requiring permission under the Copyright and Similar Rights held by the Licensor. For purposes of this Public License, where the Licensed Material is a musical work, performance, or sound recording, Adapted Material is always produced where the Licensed Material is synched in timed relation with a moving image.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+b. Adapter’s License means the license You apply to Your Copyright and Similar Rights in Your contributions to Adapted Material in accordance with the terms and conditions of this Public License.
+
+c. BY-NC-SA Compatible License means a license listed at CreativeCommons.org/compatiblelicenses, approved by Creative Commons as essentially the equivalent of this Public License.
+
+d. Copyright and Similar Rights means copyright and/or similar rights closely related to copyright including, without limitation, performance, broadcast, sound recording, and Sui Generis Database Rights, without regard to how the rights are labeled or categorized. For purposes of this Public License, the rights specified in Section 2(b)(1)-(2) are not Copyright and Similar Rights.
+
+e. Effective Technological Measures means those measures that, in the absence of proper authority, may not be circumvented under laws fulfilling obligations under Article 11 of the WIPO Copyright Treaty adopted on December 20, 1996, and/or similar international agreements.
+
+f. Exceptions and Limitations means fair use, fair dealing, and/or any other exception or limitation to Copyright and Similar Rights that applies to Your use of the Licensed Material.
+
+g. License Elements means the license attributes listed in the name of a Creative Commons Public License. The License Elements of this Public License are Attribution, NonCommercial, and ShareAlike.
+
+h. Licensed Material means the artistic or literary work, database, or other material to which the Licensor applied this Public License.
+
+i. Licensed Rights means the rights granted to You subject to the terms and conditions of this Public License, which are limited to all Copyright and Similar Rights that apply to Your use of the Licensed Material and that the Licensor has authority to license.
+
+j. Licensor means the individual(s) or entity(ies) granting rights under this Public License.
+
+k. NonCommercial means not primarily intended for or directed towards commercial advantage or monetary compensation. For purposes of this Public License, the exchange of the Licensed Material for other material subject to Copyright and Similar Rights by digital file-sharing or similar means is NonCommercial provided there is no payment of monetary compensation in connection with the exchange.
+
+l. Share means to provide material to the public by any means or process that requires permission under the Licensed Rights, such as reproduction, public display, public performance, distribution, dissemination, communication, or importation, and to make material available to the public including in ways that members of the public may access the material from a place and at a time individually chosen by them.
+
+m. Sui Generis Database Rights means rights other than copyright resulting from Directive 96/9/EC of the European Parliament and of the Council of 11 March 1996 on the legal protection of databases, as amended and/or succeeded, as well as other essentially equivalent rights anywhere in the world.
+
+n. You means the individual or entity exercising the Licensed Rights under this Public License. Your has a corresponding meaning.
+
+Section 2 – Scope.
+
+a. License grant.
+
+1. Subject to the terms and conditions of this Public License, the Licensor hereby grants You a worldwide, royalty-free, non-sublicensable, non-exclusive, irrevocable license to exercise the Licensed Rights in the Licensed Material to:
+
+   A. reproduce and Share the Licensed Material, in whole or in part, for NonCommercial purposes only; and
+
+   B. produce, reproduce, and Share Adapted Material for NonCommercial purposes only.
+
+2. Exceptions and Limitations. For the avoidance of doubt, where Exceptions and Limitations apply to Your use of the Licensed Material, this Public License does not apply, and You do not need to comply with its terms and conditions.
+
+3. Term. The term of this Public License is specified in Section 6(a).
+
+4. Media and formats; technical modifications allowed. The Licensor authorizes You to exercise the Licensed Rights in all media and formats whether now known or hereafter created, and to make technical modifications necessary to do so. The Licensor waives or agrees not to assert any right or authority to forbid You from making technical modifications necessary to exercise the Licensed Rights, including technical modifications necessary to circumvent Effective Technological Measures applied by the Licensor. For purposes of this Public License, making modifications authorized by this Section 2(a)(4) does not produce Adapted Material.
+
+b. Other rights.
+
+1. Moral rights, whether asserted or not, are not licensed under this Public License, nor are publicity, privacy, and/or other similar personality rights; however, to the extent possible, the Licensor waives or agrees not to assert any such rights held by the Licensor to the limited extent necessary to allow You to exercise the Licensed Rights.
+
+2. Patent and trademark rights are not licensed under this Public License.
+
+3. To the extent possible, the Licensor waives the right to collect royalties from You for the exercise of the Licensed Rights, whether directly or through a collecting society under any voluntary or waivable statutory or compulsory licensing scheme. In all other cases the Licensor expressly reserves the right to collect such royalties.
+
+Section 3 – License Conditions.
+
+Your exercise of the Licensed Rights is expressly made subject to the following conditions.
+
+a. Attribution.
+
+1. If You Share the Licensed Material (including in modified form), You must:
+
+   A. retain the following if it is supplied by the Licensor with the Licensed Material:
+
+      i. identification of the creator(s) of the Licensed Material and any others designated to receive attribution, in any reasonable manner requested by the Licensor (including by pseudonym if designated);
+
+      ii. a copyright notice;
+
+      iii. a notice that refers to this Public License;
+
+      iv. a notice that refers to the disclaimer of warranties;
+
+      v. a URI or hyperlink to the Licensed Material to the extent reasonably practicable;
+
+   B. indicate if You modified the Licensed Material and retain an indication of any previous modifications; and
+
+   C. indicate that the Licensed Material is licensed under this Public License, and include the text of, or the URI or hyperlink to, this Public License.
+
+2. You may satisfy the conditions in Section 3(a)(1) in any reasonable manner based on the medium, means, and context in which You Share the Licensed Material. For example, it may be reasonable to satisfy the conditions by providing a URI or hyperlink to a resource that includes the required information.
+
+3. If requested by the Licensor, You must remove any of the information required by Section 3(a)(1)(A) to the extent reasonably practicable.
+
+b. ShareAlike.
+
+   In addition to the conditions in Section 3(a), if You Share Adapted Material You produce, the following conditions also apply.
+
+   1. The Adapter’s License You apply must be a Creative Commons license with the same License Elements, this version or later, or a BY-NC-SA Compatible License.
+
+   2. You must include the text of, or the URI or hyperlink to, the Adapter’s License You apply. You may satisfy this condition in any reasonable manner based on the medium, means, and context in which You Share Adapted Material.
+
+   3. You may not offer or impose any additional or different terms or conditions on, or apply any Effective Technological Measures to, Adapted Material that restrict exercise of the rights granted under the Adapter’s License You apply.
+
+Section 4 – Sui Generis Database Rights.
+
+Where the Licensed Rights include Sui Generis Database Rights that apply to Your use of the Licensed Material:
+
+1. for the avoidance of doubt, Section 2(a)(1) grants You the right to extract, reuse, reproduce, and Share all or a substantial portion of the contents of the database for NonCommercial purposes only;
+
+2. if You include all or a substantial portion of the database contents in a database in which You have Sui Generis Database Rights, then the database in which You have Sui Generis Rights (but not its individual contents) is Adapted Material, including for purposes of Section 3(b);
+
+3. You must comply with the conditions in Section 3(a) if You Share all or a substantial portion of the contents of the database.
+
+For the avoidance of doubt, this Section 4 supplements and does not replace Your obligations under this Public License where the Licensed Rights include other Copyright and Similar Rights.
+
+Section 5 – Disclaimer of Warranties and Limitation of Liability.
+
+1. Unless otherwise separately undertaken by the Licensor, to the extent possible, the Licensor offers the Licensed Material “as-is” and as-available, and makes no representations or warranties of any kind concerning the Licensed Material, whether express, implied, statutory, or other. This includes, without limitation, warranties of title, merchantability, fitness for a particular purpose, non-infringement, absence of latent or other defects, accuracy, or the presence or absence of errors, whether or not known or discoverable. Where disclaimers of warranties are not allowed in full or in part, this disclaimer may not apply to You.
+
+2. To the extent possible, in no event will the Licensor be liable to You on any legal theory (including, without limitation, negligence) or otherwise for any direct, special, indirect, incidental, consequential, punitive, exemplary, or other losses, costs, expenses, or damages arising out of this Public License or use of the Licensed Material, even if the Licensor has been advised of the possibility of such losses, costs, expenses, or damages. Where a limitation of liability is not allowed in full or in part, this limitation may not apply to You.
+
+3. The disclaimer of warranties and limitation of liability provided above shall be interpreted in a manner that, to the extent possible, most closely approximates an absolute disclaimer and waiver of all liability.
+
+Section 6 – Term and Termination.
+
+a. Term.
+
+   This Public License applies for the term of the Copyright and Similar Rights licensed here. However, if You fail to comply with this Public License, then Your rights under this Public License terminate automatically.
+
+b. Reinstatement.
+
+   Where Your right to use the Licensed Material has terminated under Section 6(a), it reinstates:
+
+   1. automatically as of the date the violation is cured, provided it is cured within 30 days of Your discovery of the violation; or
+
+   2. upon express reinstatement by the Licensor.
+
+   For the avoidance of doubt, this Section 6(b) does not affect any right the Licensor may have to seek remedies for Your violations of this Public License.
+
+c. The Licensor may also offer the Licensed Material under separate terms or conditions or stop distributing the Licensed Material at any time; however, doing so will not terminate this Public License.
+
+d. Sections 1, 5, 6, 7, and 8 survive termination of this Public License.
+
+Section 7 – Other Terms and Conditions.
+
+a. The Licensor shall not be bound by any additional or different terms or conditions communicated by You unless expressly agreed to.
+
+b. Any arrangements, understandings, or agreements regarding the Licensed Material not stated herein are separate from and independent of the terms and conditions of this Public License.
+
+Section 8 – Interpretation.
+
+a. For the avoidance of doubt, this Public License does not, and shall not be interpreted to, reduce, limit, restrict, or impose conditions on any use of the Licensed Material that could lawfully be made without permission under this Public License.
+
+b. To the extent possible, if any provision of this Public License is deemed unenforceable, it shall be automatically reformed to the minimum extent necessary to make it enforceable. If the provision cannot be reformed, it shall be severed from this Public License without affecting the enforceability of the remaining terms and conditions.
+
+c. No term or condition of this Public License will be waived and no failure to comply consented to unless expressly agreed to by the Licensor.
+
+d. Nothing in this Public License constitutes or may be interpreted as a limitation upon, or waiver of, any privileges and immunities that apply to the Licensor or You, including from the legal processes of any jurisdiction or authority.
+
+---
+
+Creative Commons is not a party to its public licenses.  Notwithstanding, Creative Commons may elect to apply one of its public licenses to material it publishes and in those instances will be considered the “Licensor.”  Except for the limited purpose of indicating that material is shared under a Creative Commons public license or as otherwise permitted by the Creative Commons policies, Creative Commons does not authorize the use of the trademark “Creative Commons” or any other trademark or logo of Creative Commons without its prior written consent including, without limitation, in connection with any unauthorized modifications to any of its public licenses or any other arrangements, understandings, or agreements concerning use of licensed material.  For the avoidance of doubt, this paragraph does not form part of the public licenses.  Creative Commons may be contacted at https://creativecommons.org.

README.md

@@ -2,13 +2,36 @@
 <h3 align="center">
   <a href="README.md">🇨🇳 中文</a> · <a href="EN_README.md">🇺🇸 English</a>
 </h3>
+<blockquote align="center">
+  This project now supports English. Don't hesitate to give it a try!
+</blockquote>
 <p align="center">— ✦ —</p>
 
 # 修仙世界模拟器 (Cultivation World Simulator)
 
-![Python](https://img.shields.io/badge/Python-3.10%2B-blue)
-![Vue](https://img.shields.io/badge/Vue.js-3.x-4FC08D)
-[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+![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-CC%20BY--NC--SA%204.0-lightgrey)](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)
+![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)
+
+![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)
 
 
 <p align="center">
@@ -33,34 +56,45 @@
 
 <table border="0">
   <tr>
-    <td width="33%" valign="top">
-      <h4 align="center">角色面板</h4>
-      <img src="assets/角色.png" width="100%" />
-      <br/><br/>
-      <h4 align="center">性格特质</h4>
-      <img src="assets/特质.png" width="100%" />
-    </td>
     <td width="33%" valign="top">
       <h4 align="center">宗门体系</h4>
-      <img src="assets/宗门.png" width="100%" />
+      <img src="assets/zh-CN/screenshots/宗门.png" width="100%" />
+      <br/><br/>
+      <h4 align="center">城市区域</h4>
+      <img src="assets/zh-CN/screenshots/城市.png" width="100%" />
       <br/><br/>
       <h4 align="center">生平经历</h4>
-      <img src="assets/经历.png" width="100%" />
+      <img src="assets/zh-CN/screenshots/经历.png" width="100%" />
     </td>
     <td width="33%" valign="top">
-      <h4 align="center">自主思考</h4>
-      <img src="assets/思考.png" width="100%" />
+      <h4 align="center">角色面板</h4>
+      <img src="assets/zh-CN/screenshots/角色.png" width="100%" />
       <br/><br/>
-      <h4 align="center">长短期目标</h4>
-      <img src="assets/目标.png" width="100%" />
+      <h4 align="center">性格特质</h4>
+      <img src="assets/zh-CN/screenshots/特质.png" width="100%" />
+      <br/><br/>
+      <h4 align="center">自主思考</h4>
+      <img src="assets/zh-CN/screenshots/思考.png" width="100%" />
       <br/><br/>
       <h4 align="center">江湖绰号</h4>
-      <img src="assets/绰号.png" width="100%" />
+      <img src="assets/zh-CN/screenshots/绰号.png" width="100%" />
+    </td>
+    <td width="33%" valign="top">
+      <h4 align="center">洞府探秘</h4>
+      <img src="assets/zh-CN/screenshots/洞府.png" width="100%" />
+      <br/><br/>
+      <h4 align="center">长短期目标</h4>
+      <img src="assets/zh-CN/screenshots/目标.png" width="100%" />
+      <br/><br/>
+      <h4 align="center">丹药/法宝/武器</h4>
+      <img src="assets/zh-CN/screenshots/丹药.png" width="100%" />
+      <img src="assets/zh-CN/screenshots/法宝.png" width="100%" />
+      <img src="assets/zh-CN/screenshots/武器.png" width="100%" />
     </td>
   </tr>
 </table>
 
-### 为什么要做这个？
+### 💭 为什么要做这个？
 修仙网文中的世界很精彩，但读者永远只能观察到一隅。
 
 修仙品类游戏要么是完全的预设剧本，要么依靠人工设计的简单规则状态机，有许许多多牵强和降智的表现。
@@ -69,12 +103,82 @@
 
 希望能够创造出纯粹的、快乐的、直接的、活着的修仙世界的沉浸感。不是像一些游戏公司的纯粹宣传工具，也不是像斯坦福小镇那样的纯粹研究，而是能给玩家提供真实代入感和沉浸感的实际世界。
 
-## 联系方式
+## 📞 联系方式
 如果您对项目有任何问题或建议，欢迎提交 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：
+
+   **推荐方式：在前端直接配置（支持快速填充预设）**
+   
+   <img src="assets/zh-CN/llm_config.png" alt="前端LLM配置" width="100%">
+
+   也可以在 `static/local_config.yml` 中手动配置（OpenAI兼容格式）：
+   ```yaml
+   llm:
+     base_url: https://api.deepseek.com       # API地址
+     key: your-api-key-here                   # 你的API密钥
+     model_name: deepseek-chat                # 智能模型名称
+     fast_model_name: deepseek-chat           # 快速模型名称
+     mode: default                            # 运行模式 (default/normal/fast)
+   ```
+
+   **本地部署 (Ollama)：** 也支持对接本地 Ollama，在前端选择 "Ollama (本地)" 预设即可。
+
+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>
+
+## 👥 贡献者
+
+<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)** - 代码与repo维护
+
+## 🙏 致谢
+- 参考了ai life engine部分ui
+
+## 📋 功能开发进度
 
 ### 🏗️ 基础系统
 - ✅ 基础世界地图、时间、事件系统
@@ -85,6 +189,10 @@
 - ✅ release 一键即玩的exe
 - ✅ 菜单栏 & 存档 & 读档
 - ✅ 灵活自定义LLM接口
+- ✅ 支持mac os
+- [ ] 安卓支持
+- ✅ 多语言本地化
+- ✅ 开始游戏页
 
 ### 🗺️ 世界系统
 - ✅ 基础tile地块系统
@@ -92,7 +200,6 @@
 - ✅ 同地块NPC交互
 - ✅ 灵气分布与产出设计
 - ✅ 世界事件
-- [ ] 动态世界观设定、地图、历史、宗门、名人生成
 
 ### 👤 角色系统
 - ✅ 角色基础属性系统
@@ -106,15 +213,17 @@
 - ✅ 角色Effects系统：增益/减益效果
 - ✅ 角色功法
 - ✅ 角色兵器 & 辅助装备
+- ✅ 丹药
 - ✅ 角色长短期记忆
 - ✅ 角色的长短期目标，支持玩家主动设定
 - ✅ 角色绰号
-- [ ] 角色间相性
-- [ ] 技能学习系统：
-  - [ ] 可学习技能
-  - [ ] 生活职业（丹药、阵法、种植、铸造etc）
+- [ ] 生活技能
+  - ✅ 铸造
+  - ✅ 炼丹
+  - [ ] 种植
+  - [ ] 饲养
+  - [ ] 技能可升级
 - [ ] 凡人系统
-- [ ] 天骄系统（更强能力，更强AI）
 
 ### 🏛️ 组织系统
 - [ ] 宗门系统
@@ -130,18 +239,18 @@
 ### ⚡ 动作系统
 - ✅ 基础移动动作
 - ✅ 动作执行框架
-- ✅ 有明确规则的定义动作(Defined Action)
+- ✅ 有明确规则的定义动作
 - ✅ 长动作执行和结算系统
   - ✅ 支持多月份持续的动作（如修炼、突破、游戏等）
   - ✅ 动作完成时的自动结算机制
 - ✅ 多人动作：动作发起与动作响应
-- ✅ 影响人际关系的LLM动作(LLM Action)
+- ✅ 影响人际关系的LLM动作
 - ✅ 系统性的动作注册与运行逻辑
 
 ### 🎭 事件系统
 - ✅ 天地灵气变动
-- [ ] 世界范围大事件：
-  - [ ] 拍卖会
+- ✅ 多人大事件：
+  - ✅ 拍卖会
   - [ ] 秘境探索
   - [ ] 比武大会
   - [ ] 宗门大比
@@ -180,11 +289,10 @@
 - ✅ 一次性选择（如是否要切换功法）
 
 ### 🏛️ 世界背景系统
-- [ ] 背景故事框架
-- [ ] 世界观生成
-- [ ] 上古历史生成
+- ✅ 注入基础世界知识
+- ✅ 用户输入历史，动态生成功法、装备、宗门、区域信息
 
-### 特殊
+### ✨ 特殊
 - ✅ 奇遇
 - ✅ 天劫 & 心魔
 - [ ] 夺舍 & 重生
@@ -198,59 +306,7 @@
 - [ ] 世界秘密 & 世界法则 （可灵活自定义） 
 - [ ] 炼蛊
 - [ ] 灭世危机
-- [ ] 成为后世传奇
 
 ### 🔭 远期展望
-- [ ] ECS并行
 - [ ] 历史/事件的小说化&图片化&视频化
-- [ ] 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: "qwen-plus"         # 智能模型名称
-      fast_model_name: "qwen-turbo"   # 快速模型名称
-   ```
-
-   也支持在前端直接配入LLM参数：
-   
-   <img src="assets/llm_config.png" alt="前端LLM配置" width="100%">
-
-4. 运行：
-   ```bash
-   # 启动服务 (推荐开发模式，会自动启动前端)
-   python src/server/main.py --dev
-   ```
-   浏览器会自动打开网页前端。
-
-
-## 贡献者
-- Aku, 世界观\玩法设计与讨论
-
-## 致谢
-- 参考了ai life engine部分ui
-
-## 许可证
-
-本项目采用 [LICENSE](LICENSE) 文件中指定的许可证。
+- [ ] MCP agent化，修士自行调用工具