ZJU-LLMs/OpenStory
✨ Story 3《WorldKernel》现已上线! 现在只需一句话,就能生成属于你的可交互故事世界。无论是海底城邦、轨道集市,还是神话森林、末日列车,examples/WorldKernel 都会把你的设想拆解为角色、地点、路径与规则,并接入多智能体模拟。
catalog 简介 / catalog descriptioncatalog description:An LLM-powered multi-agent framework for simulating interactive, evolving story worlds.
项目介绍Project Overview
OpenStory 是基于大语言模型与 Agent-Kernel 的多智能体推演框架,通过 dsh-openstory 插件接入 DeepSeek Harness,让 agent 启动模拟、查看角色、下达指令并逐回合推进故事。内置红楼梦、西部世界等故事,以及 WorldKernel 一句话生成世界。适用于多角色剧情推演、互动小说与世界构建。注意:多个故事共享 8000 端口,请勿同时启动;需本地 Redis 与 OpenAI-compatible 模型配置。
OpenStory is a multi-agent simulation framework built on large language models and Agent-Kernel, available as a dsh-openstory plugin for DeepSeek Harness. The plugin lets agents start simulations, inspect characters, issue commands, and advance stories turn by turn. It ships with stories such as Dream of the Red Chamber and West World, plus WorldKernel for generating worlds from a single prompt. Use it for multi-character role-playing, interactive fiction, and world-building. Note: stories share port 8000, so run one at a time, and Redis plus an OpenAI-compatible model configuration are required.
请帮我了解并安装插件:【OpenStory】【https://github.com/ZJU-LLMs/OpenStory】
把上面这条消息直接发给当前会话里的 DSH,让它帮你了解并安装。安装命令不一定准确,发给 DSH 更稳。Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.
或使用命令行安装(适合开发者)Or use CLI install (for developers)
命令行安装CLI Install
dsh plugin --profile web add github:ZJU-LLMs/OpenStory
把 ZJU-LLMs/OpenStory 加入你的 DSH 配置(web profile)即可启用。
READMEREADME

OpenStory (万象谱)
🌟 重要新闻
✨ Story 3《WorldKernel》现已上线!
现在只需一句话,就能生成属于你的可交互故事世界。无论是海底城邦、轨道集市,还是神话森林、末日列车,examples/WorldKernel 都会把你的设想拆解为角色、地点、路径与规则,并接入多智能体模拟。
✨ OpenStory 现已支持 DeepSeek Harness 插件!
现在可以通过 dsh-openstory 将 OpenStory 多智能体推演接入 DeepSeek Harness,让 agent 直接启动模拟、查看角色、下达指令并逐回合推进故事。查看 DSH 插件配置与使用指南。
✨《西部世界》现已上线! 全新故事《西部世界》现已加入 OpenStory。进入西部世界主界面后,你可以选择自由模式,观察角色在乐园循环中的自主行动;也可以进入剧情模式,扮演一名 Host,在记忆、觉醒与监管者的重重压力下,亲手推演逃离乐园的故事。
✨ 我们的 OpenStory Launcher 客户端上线啦!
之前各位穿越者经常反馈不知道如何安装游戏,让我们意识到了当前的门槛太高的问题。于是我们连夜开发了客户端版本,支持一键点击即玩!前往 release 下载!快点参与到红楼梦世界来吧!
✨ 我们的项目被《新智元》报道啦!
https://mp.weixin.qq.com/s/1Z9LAoombuvMGBkpyyMCrg
✨ 《红楼梦》的剧情模式现已上线!
全新剧情模式将带你走进《红楼梦》,以复兴大观园为目标。你可自由向角色下达指令,AI 会根据你的选择推演剧情走向,影响整个复兴进程。同时新增故事回溯功能,可回到过往节点重选。你的每一次抉择都会衍生全新剧情分支,体验不断变化的故事冒险。
OpenStory 是一个基于大语言模型(LLM)和 Agent-Kernel 开发的多智能体推演与模拟框架。
✨ 我们诚挚地邀请大家一起来共创故事! 无论你是想续写经典、打破原著框架,还是创造一个完全属于你的平行宇宙,只要你的故事创意足够有趣、脑洞足够大,欢迎提交 PR!我们会将精彩的推演剧本和自定义配置合并到项目中,让更多人看到你的杰作。
🌟 核心特性
- 基于 Agent-Kernel 的动态框架:底层采用强大的 Agent-Kernel 架构,支持在推演过程中动态增删智能体。告别僵化的静态设定,赋予系统无限的扩展能力,让你尽情发挥想象力!
- 一比一复刻的红楼梦大观园前端:精心打造的 1:1 仿真可视化交互界面。你不仅能直观地看到智能体在地图上的动态轨迹,更能随时点击查看人物的详细信息、状态变化与互动档案。
- 富有冲击力的推演剧情:打破常规的刻板对话,智能体之间将产生深度的化学反应。系统能够根据性格设定与环境变化,自动生成跌宕起伏、精彩绝伦且极具戏剧张力与冲击力的推演剧情!
- 丰富的插件化机制与高可配性:涵盖智能体感知、计划、执行、反思等完整生命周期插件,并支持通过 YAML 文件灵活管理系统、环境、动作与智能体配置。
- 一句话生成世界(WorldKernel):输入一句自然语言设想,系统自动生成角色、地点、路径与规则,并接入可交互的多智能体模拟。
📖 Story 1: 红楼梦 (Dream of the Red Chamber)
作为 OpenStory 框架的第一个官方落地故事,本项目中的 examples/story_of_the_stone 示例以中国古典名著《红楼梦》为背景。我们利用多智能体系统(MAS)技术,在一比一仿真的红楼梦大观园地图中,生动模拟了书中人物的日常行为、社交互动与故事推演。在这里,你可以看到林黛玉的敏感多思、贾宝玉的叛逆多情,以及整个贾府在历史车轮下的命运交织。
📖 Story 2: 西部世界(West World)
作为 OpenStory 框架的第二个官方故事,本项目中的 examples/WestWorld 示例以科幻剧集《西部世界》为背景,构建了一座由多智能体共同驱动的仿真乐园。Host 会感知场景、规划行动、移动交谈并积累记忆;那些反复出现的日常、难以解释的熟悉感与他人的只言片语,也会让他们逐渐发现循环背后的真相。在这里,你既可以在自由模式中观察 Dolores、Maeve、Teddy 等角色的自主互动与命运分岔,也可以在剧情模式中扮演一名 Host,选择结盟、隐藏异常或逃离乐园,并在 Overseer 的监控与干预下亲手推演属于自己的觉醒故事。
📖 Story 3: WorldKernel(一个想法,一个世界)
作为 OpenStory 框架的第三个官方故事,本项目中的 examples/WorldKernel 不再绑定单一原著,而是把一句自然语言设想,生成可以运行的故事世界。系统会拆解出角色、地点、路径与规则,再接入多智能体模拟:你可以创造「西游记·大闹天宫」,也可以生成一座靠交易记忆运转的风暴档案城。写下你的想法,或继续本地已生成的世界,亲手推演接下来的故事。
📖 Story 4:进行中...

🚀 快速开始
📚 想要更详细的操作指南? 我们为您准备了详尽的图文教程,带您从零开始玩转红楼梦沙盘世界: 👉 点击查看 OpenStory 红楼梦互动教程
1. 环境准备
- Python 版本:推荐 Python 3.10 或以上。
- 中间件:
- Redis:作为默认的数据总线与缓存,请确保本地 Redis 服务已启动并在
6379端口监听。
- Redis:作为默认的数据总线与缓存,请确保本地 Redis 服务已启动并在
2. 安装依赖
git clone https://github.com/ZJU-LLMs/Agent-Kernel.git
cd Agent-Kernel
pip install -e "packages/agentkernel-distributed[all]"
cd ../../..
3. 运行推演系统
在项目根目录下,选择要运行的故事并执行相应命令。
红楼梦
python -m examples.story_of_the_stone.run_simulation
启动过程中:
- 系统会初始化
Ray的运行时环境。 - 构建并加载所有的插件、配置文件和《红楼梦》人物数据。
- 启动 API Server,默认监听在
0.0.0.0:8000。
西部世界
启动前,请确认 Redis 已运行,并在 examples/WestWorld/configs/models_config.yaml 中填写可用的 OpenAI-compatible 模型配置。西部世界与红楼梦都会使用 8000 端口,因此请勿同时运行两者。
python -m examples.WestWorld.run_all
启动完成后,打开 西部世界主界面
http://localhost:8000/frontend/index.html
并在页面中选择游玩自由模式或剧情模式。
详细玩法和模型配置请参阅 西部世界说明。
WorldKernel
WorldKernel 使用 8100 端口,可与红楼梦 / 西部世界分开启动。启动前请在 examples/WorldKernel/configs/models.yaml 中填写可用的 OpenAI-compatible 模型配置,或设置环境变量 WORLDKERNEL_API_KEY。进入模拟时仍需本地 Redis。
pip install -e "examples/WorldKernel"
python -m worldkernel.server
启动完成后,打开 WorldKernel 主界面:
http://localhost:8100/
在页面中描述你想生成的世界,或选择已有本地世界进入模拟。
4. 访问可视化界面
当看到终端输出 API Server started at http://0.0.0.0:8000 后,在浏览器中打开以下地址:
👉 http://localhost:8000/frontend/index.html
在界面中,你可以:
- 查看大观园等场景地图。
- 点击开始推演 / 下一回合 (Tick) 观察人物的行动与交互。
- 点击左侧人物列表,查看详细的“人物档案”与实时状态。
⚙️ 核心配置说明
在 configs/ 目录下,您可以自定义推演规则:
simulation_config.yaml:全局主入口,配置 Pod 数量、最大 Tick 数及各配置文件的路径。models_config.yaml:配置 LLM 模型接口及参数。system_config.yaml:系统级配置,如 Messager(消息总线)与 Timer(时钟)。
🛠️ 数据生成
如果您需要修改或重新生成《红楼梦》的人物数据,可以参考 data/raw/ 目录下的生成脚本。例如:
profile_generator.py:基于database.jsonl过滤存活角色并生成唯一的编码 ID 与基础设定。
QQ交流群:1091827223
nexu-io/open-design
ruvnet/ruflo
amruthpillai/reactive-resume
esengine/DeepSeek-Reasonix
volcengine/OpenViking
Molunerfinn/PicGo
titanwings/distilly
titanwings/colleague-skill