From b7ac714762bf047edb3477941e96147ce7fd9ed1 Mon Sep 17 00:00:00 2001
From: gitee-bot <no-reply@git.oschina.net>
Date: Mon, 23 Jun 2025 09:06:02 +0000
Subject: [PATCH] Update README.md

---
 README.en.md |  3 ++
 README.md    | 91 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 94 insertions(+)
 create mode 100644 README.en.md
 create mode 100644 README.md

diff --git a/README.en.md b/README.en.md
new file mode 100644
index 0000000..a6771ea
--- /dev/null
+++ b/README.en.md
@@ -0,0 +1,3 @@
+
+
+# Xiuxian Simulator
\ No newline at end of file
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e97c4c7
--- /dev/null
+++ b/README.md
@@ -0,0 +1,91 @@
+# 修仙模拟器 (XiuxianSimulator)
+
+## 项目简介
+这是一个融合AI驱动的修仙文字冒险游戏，基于Python实现。玩家将扮演修仙者在动态生成的修真世界中历练，通过探索秘境、斗法、炼丹、参悟功法等方式提升境界，体验从炼气到飞升的完整修仙历程。
+
+## 核心功能
+- 🧠 **AI情景生成**：动态生成探索/战斗/炼丹等场景，提供多样化剧情分支
+- 🌱 **灵根系统**：独特灵根属性影响修炼效率与境界突破
+- 🌍 **开放世界**：随机生成的修真位面与事件系统
+- ⚔️ **战斗系统**：策略性选择战斗决策，影响修为与资源获取
+- 💊 **炼丹系统**：结合随机配方与材料组合的炼丹机制
+- 📜 **功法传承**：可学习多种功法并组合战斗流派
+- 📦 **存档系统**：支持游戏进度保存与读取
+
+## 安装指南
+```bash
+# 克隆仓库
+git clone https://22173.runjs.cn/gigi-two222/xiuxiangame02.git
+cd xiuxiangame02
+
+# 安装依赖（推荐使用虚拟环境）
+pip install -r requirements.txt
+
+# 初始化游戏
+python setup.py
+```
+
+## 快速开始
+```bash
+# 启动游戏
+python main.py
+
+# 或使用启动脚本
+chmod +x run.sh
+./run.sh
+```
+
+## 游戏操作
+1. 创建角色：输入道号与选择灵根属性
+2. 主菜单选项：
+   - 🧘 修炼：恢复灵力/参悟境界
+   - 🔍 探索：触发随机事件与秘境
+   - ⚔️ 战斗：遭遇妖兽或修士切磋
+   - 💊 炼丹：炼制提升修为的丹药
+   - 📚 问道：获取AI生成的修炼建议
+   - 💾 存档：保存当前游戏进度
+3. 使用方向键选择操作，回车确认决策
+
+## 配置AI服务
+编辑`config.json`配置AI接口参数：
+```json
+{
+  "api_key": "your_api_key",
+  "api_url": "https://api.example.com/ai",
+  "model": "qwen-max"
+}
+```
+
+## 开发者指南
+### 项目结构
+```
+game/
+├── ai_interface.py    # AI情景生成接口
+├── player.py          # 玩家属性与行为逻辑
+├── world.py           # 世界状态管理
+├── utils.py           # 工具函数（进度条/骰子等）
+```
+
+### 贡献代码
+1. Fork仓库并创建特性分支
+2. 提交PR时请遵循以下规范：
+   - 添加类型前缀（feat/fix/docs）
+   - 保持函数单一职责原则
+   - 添加单元测试（如新增系统）
+
+## 许可证
+本项目采用MIT License，详见LICENSE文件。第三方AI接口需遵守相应服务商的使用条款。
+
+## 常见问题
+Q: 游戏卡顿或响应慢？
+A: 尝试降低AI生成内容长度，或更换响应更快的AI服务
+
+Q: 如何自定义修炼境界？
+A: 修改`game/player.py`中的境界配置常量，需同步调整突破条件逻辑
+
+Q: 如何添加新功法？
+A: 在`game/utils.py`中扩展technique库，并在`player.py`中实现对应战斗效果
+
+---
+
+愿道友在此体验完整的修仙历程，斩因果，断轮回，证大道！ 🌌
\ No newline at end of file
-- 
Gitee