From a826a75312f0110e637c7a651e999e952c8a4654 Mon Sep 17 00:00:00 2001 From: bridge Date: Sat, 30 Aug 2025 22:27:18 +0800 Subject: [PATCH] update --- README.md | 56 ++++++++++++++++++++++++++++------------------- requirements.txt | 12 ++++++++++ src/classes/ai.py | 8 +++++++ 3 files changed, 54 insertions(+), 22 deletions(-) create mode 100644 requirements.txt diff --git a/README.md b/README.md index 9a91f43..40f2490 100644 --- a/README.md +++ b/README.md @@ -21,14 +21,14 @@ - ✅ 前端显示界面（pygame） - ✅ 基础模拟器框架 - ✅ 项目文档（README） -- [ ] 配置文件系统（config） -- [ ] Web前端支持（从pygame切换） +- ✅ 配置文件系统（config） +- [ ] Web前端支持（后期考虑） - [ ] ECS并行工具（后期考虑） ### 🗺️ 地块系统 - ✅ 基础tile地块系统 - [ ] 同tile内NPC相互交互 -- [ ] 乡村和城镇的机制 +- [ ] 城市/宗派据点的机制 - [ ] 灵气分布与产出设计 - [ ] 地块间移动（move_to_region action） @@ -37,7 +37,7 @@ - ✅ 修炼境界体系 - ✅ 灵根系统 - ✅ 基础移动动作 -- [ ] 动态的突破成功概率 +- [ ] 角色突破机制：动态的突破成功概率、不同突破结果和效果 - [ ] 角色关系系统 - [ ] 性格系统设计 - [ ] 角色特殊能力 @@ -53,7 +53,7 @@ - [ ] 个人技（灵活融入代码） - [ ] 生活技能 - [ ] 凡人角色支持 -- [ ] 角色突破机制 +- [ ] 天骄系统（更强能力，更强AI） ### 🏛️ 组织系统 - [ ] 宗门系统 @@ -97,13 +97,15 @@ - [ ] 生物间相互关系 ### 🤖 AI增强系统 -- [ ] 角色AI系统（规则AI + LLM接口预留） -- [ ] LLM驱动的NPC对话 +- ✅ LLM接口集成 +- ✅ 角色AI系统（规则AI + LLM AI） +- [ ] AI动作链系统（长期规划和目标导向行为） +- [ ] 突发动作响应系统（对外界刺激的即时反应） +- [ ] LLM驱动的NPC对话、思考、互动、事件总结 - [ ] 智能决策系统 - [ ] 动态剧情生成 - [ ] NPC观测空间设计 - [ ] NPC之间关系交互 -- [ ] LLM接口集成 ### 🏛️ 世界背景系统 - [ ] 上古历史生成 @@ -112,11 +114,6 @@ ## 使用方法 -### 环境要求 -- Python 3.8+ -- pygame -- PyYAML - ### 运行步骤 1. 克隆项目到本地： ```bash @@ -124,14 +121,23 @@ cd cultivation-world-simulator ``` -2. 安装依赖（如需要的话）： +2. 安装依赖： ```bash - pip install pygame pyyaml + pip install -r requirements.txt ``` -3. 运行模拟器： +3. 配置LLM（可选）： + 在 `static/config.yml` 中配置LLM参数： + ```yaml + llm: + model_name: "gpt-3.5-turbo" # 或其他litellm支持的模型名称 + key: "your-api-key-here" # 你的API密钥 + ``` + 具体支持的模型请参考 [litellm文档](https://docs.litellm.ai/docs/providers) + +4. 运行模拟器： ```bash - python src/tools/run.py + python -m src.run.run ``` ### 基本操作 @@ -162,19 +168,25 @@ cultivation-world-simulator/ │ ├── front/ # 前端显示模块 │ │ └── front.py # pygame界面 │ ├── sim/ # 模拟引擎 -│ │ ├── simulator.py # 核心模拟器 -│ │ └── event.py # 事件系统 -│ ├── tools/ # 工具脚本 +│ │ └── simulator.py # 核心模拟器 +│ ├── run/ # 运行脚本 │ │ ├── run.py # 主程序入口 │ │ └── create_map.py # 地图生成工具 │ └── utils/ # 实用工具 +│ ├── config.py # 配置管理 +│ ├── llm.py # LLM接口 │ └── strings.py # 字符串处理 ├── assets/ # 游戏资源 │ ├── tiles/ # 地形贴图 │ ├── males/ # 男性角色头像 │ └── females/ # 女性角色头像 -├── configs/ # 配置文件 +├── static/ # 静态配置文件 +│ ├── config.yml # 基础配置 +│ ├── local_config.yml # 本地配置（优先级更高） +│ └── templates/ # AI提示词模板 +├── configs/ # 其他配置文件 ├── tests/ # 测试代码 +├── requirements.txt # Python依赖列表 └── README.md # 项目说明 ``` @@ -187,7 +199,7 @@ cultivation-world-simulator/ ## 贡献指南 -欢迎对修仙世界模拟器项目的贡献！无论是代码、创意还是测试反馈都非常宝贵。 +欢迎对修仙世界模拟器项目的贡献！ ## 许可证 diff --git a/requirements.txt b/requirements.txt new file mode 100644 index 0000000..9459fe8 --- /dev/null +++ b/requirements.txt @@ -0,0 +1,12 @@ +# 修仙世界模拟器依赖 +# Core dependencies +pygame>=2.0.0 +PyYAML>=6.0 + +# LLM integration +litellm>=1.0.0 +omegaconf>=2.3.0 +langchain>=0.1.0 + +# Development and testing (optional) +pytest>=7.0.0 diff --git a/src/classes/ai.py b/src/classes/ai.py index 540b5f3..b1453da 100644 --- a/src/classes/ai.py +++ b/src/classes/ai.py @@ -61,6 +61,14 @@ class LLMAI(AI): """ LLM AI """ + # TODO：动作链 + """ + AI动作应该分两类： + 1. 动作链，一定时间内的长期规划，动作按照这个动作链来执行（以及何时终止并执行下一个动作） + 2. 突发情况，比如突然有人要攻击NPC，这个时候的反应 + 不能每个单步step都调用一次LLM来决定下一步做什么。这样子一方面动作一直乱变，另一方面也太费token了。 + decide的作用是，拉取既有的动作链（如果没有了就call_llm），再根据动作链决定动作，以及动作之间的衔接。 + """ def decide(self, world: World) -> tuple[str, dict]: """ 决定做什么