diff --git a/README.md b/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..107735ba8948223ba6f1817aba8df2f87cd3ccc6
--- /dev/null
+++ b/README.md
@@ -0,0 +1,69 @@
+# 修仙模拟器 (Xiuxian Simulator)
+
+## 简介
+基于文本的修仙角色扮演游戏，结合AI生成剧情与传统文字冒险机制。玩家将扮演修士在玄幻世界中历练，通过探索、战斗、炼丹等方式突破境界，最终成就大道。
+
+## 核心功能
+- **AI驱动剧情**：动态生成探索/战斗/炼丹场景
+- **灵根系统**：不同灵根影响属性成长与修炼效率
+- **境界突破**：从炼气到渡劫的完整修真体系
+- **资源管理**：灵气/体力/丹药等多重资源调配
+- **存档系统**：支持进度保存与读取
+
+## 安装指南
+```bash
+# 克隆仓库
+git clone https://github.com/yourname/xiuxian-simulator.git
+cd xiuxian-simulator
+
+# 安装依赖（建议使用Python 3.13+）
+pip install -r requirements.txt
+
+# 初始化配置
+python setup.py
+```
+
+## 配置说明
+1. 在`config.json`中配置AI服务参数：
+   ```json
+   {
+     "api_key": "your_api_key",
+     "api_url": "https://api.example.com",
+     "model": "gpt-4"
+   }
+   ```
+2. 通过游戏内指令`set_api_config`动态调整参数
+
+## 游戏操作
+### 启动方式
+```bash
+# Linux/Mac系统
+./run.sh
+
+# 或通用启动方式
+python main.py
+```
+
+### 核心玩法
+1. **角色创建**：选择灵根类型（金木水火土等）
+2. **主菜单**：
+   - 🧘 修炼：提升修为
+   - 🔍 探索：随机遭遇事件
+   - ⚔️ 战斗：遭遇妖兽/修士
+   - 🔥 炼丹：炼制药材获取增益
+   - 📚 问道：获取AI生成的修炼建议
+3. **境界突破**：当修为满时尝试突破瓶颈
+4. **存档管理**：随时保存/读取进度
+
+## 开发贡献
+欢迎参与开发！请遵循：
+1. Fork仓库并创建特性分支
+2. 使用`black`格式化代码
+3. 提交PR时附带中文变更说明
+
+## 许可协议
+MIT License
+
+---
+
+*本项目通过AI生成部分剧情内容，实际效果受API服务质量影响。建议搭配稳定AI服务使用以获得最佳体验。*
\ No newline at end of file