GenerativeAgentsCN 的项目扩展与二次开发

1. 项目的基础介绍

GenerativeAgentsCN 是基于斯坦福大学和谷歌开源的 Generative Agents 项目进行的重构和深度汉化版本。该项目通过模拟一个由多个智能体组成的虚拟世界，来展现真实的人类生活模式和行为习惯。项目的主要目的是为中文用户提供一个易于维护的基础版本，方便后续的实验和功能拓展。

2. 项目的核心功能

• 智能体模拟：项目中的智能体可以自主组织活动，如派对、会议等，并展现出类似人类的行为模式。
• 断点恢复：支持从上次中断的地方继续运行虚拟小镇，保证了模拟的连续性和稳定性。
• 本地部署：通过集成 Ollama API 和 LlamaIndex，实现了完全的本地部署，降低了实验成本。
• 回放功能：提供了回放服务，可以查看智能体在虚拟小镇中的活动记录和对话内容。

3. 项目使用了哪些框架或库？

• Python：作为主要的编程语言，用于实现智能体模拟和项目的主要逻辑。
• 前端框架：使用了 HTML、CSS 和 JavaScript 实现了回放界面的构建。
• Ollama：用于加载本地量化模型，并提供 OpenAI 兼容 API 的工具。
• 其他：还包括了用于处理数据、生成地图等功能的库和工具。

4. 项目的代码目录及介绍

GenerativeAgentsCN/
├── docs/              # 项目文档
├── generative_agents/ # 主要的项目代码
├── .gitignore         # git忽略文件
├── LICENSE            # 项目许可证
├── README.md          # 项目说明文件
├── README_en.md       # 项目说明文件（英文版）
├── requirements.txt   # 项目依赖
└── start.py           # 启动虚拟小镇的脚本

• docs/：包含项目的文档资料。
• generative_agents/：包含项目的主要代码，包括智能体的逻辑、地图数据、配置文件等。
• .gitignore：指定 git 忽略的文件和目录。
• LICENSE：项目的开源许可证。
• README.md 和 README_en.md：项目的说明文件，分别提供中文和英文版本。
• requirements.txt：列出项目所需的 Python 依赖库。
• start.py：用于启动虚拟小镇的 Python 脚本。

5. 对项目进行扩展或者二次开发的方向

• 智能体行为优化：可以进一步优化智能体的行为逻辑，使其更加贴近真实人类的行为模式。
• 模型集成：集成更多的大语言模型，如 GLM-4、Qwen3 等，以提供更丰富的对话和交互体验。
• 地图编辑和生成：开发更加灵活的地图编辑工具，允许用户自定义地图和场景。
• 交互界面改进：改进前端交互界面，提供更友好的用户体验。
• 多语言支持：扩展项目，使其支持更多语言，吸引更多非中文用户的关注和使用。