返回目录

openstory

编辑精选维护状态: 活跃

zju-llms/openstory

基于 LLM 的多智能体框架,用于模拟交互式、不断演化的故事世界。

安装
$ git clone https://github.com/ZJU-LLMs/Agent-Kernel.git && cd Agent-Kernel && pip install -e "packages/agentkernel-distributed[all]"

381

星标

41

Fork

Python

语言

Apache-2.0

许可证

2026-04-01

创建于

2026-08-19

最近推送

Apache-2.0 的多智能体故事世界模拟框架,通过 dsh-openstory 插件接入 DeepSeek Harness,让 agent 启动模拟、指挥角色并逐回合推进剧情。

DSH 适配

兼容

作者声明

安全审计

未审计

最后核验

2026-08-21

许可证

Apache-2.0

01它能帮你完成什么?

  • Operate OpenStory multi-agent story simulations directly from DeepSeek Harness

    Agent-driven simulation control via dsh-openstory: start simulations, view characters, issue instructions and advance the story turn by turn

    DeepSeek Harness users who want interactive, evolving multi-agent story worlds controlled through their agent

  • Generate an interactive story world from a single sentence

    WorldKernel turns one natural-language idea into characters, locations, paths and rules wired into a runnable multi-agent simulation

    Story designers and hobbyists prototyping evolving story worlds without hand-authoring agents

  • Run and observe character simulations on a visual map

    1:1 visual frontend with agent trajectories on the map, character profiles, real-time state changes and interaction archives; tick-by-tick simulation served by a local API server

    Players and researchers exploring emergent social behavior in LLM agent communities

02如何接入 DeepSeek Harness?

前置条件

  • Python 3.10 or above (recommended)
  • Local Redis service started and listening on port 6379 (default data bus and cache)
  • OpenAI-compatible model configuration for Westworld (examples/WestWorld/configs/models_config.yaml) and WorldKernel (examples/WorldKernel/configs/models.yaml or WORLDKERNEL_API_KEY env var)

安装步骤

  1. 01

    Clone and install Agent-Kernel: `git clone https://github.com/ZJU-LLMs/Agent-Kernel.git && cd Agent-Kernel && pip install -e "packages/agentkernel-distributed[all]"`

    $ git clone https://github.com/ZJU-LLMs/Agent-Kernel.git && cd Agent-Kernel && pip install -e "packages/agentkernel-distributed[all]"

  2. 02

    Run the chosen story from the project root, e.g. Dream of the Red Chamber: `python -m examples.story_of_the_stone.run_simulation` (Westworld: `python -m examples.WestWorld.run_all`; WorldKernel: `pip install -e "examples/WorldKernel"` then `python -m worldkernel.server`)

  3. 03

    For DeepSeek Harness, follow the dsh-openstory plugin configuration and usage guide linked in the README (dsh-openstory/README.zh.md)

验证接入成功

  • Terminal prints `API Server started at http://0.0.0.0:8000`, then open http://localhost:8000/frontend/index.html in a browser (WorldKernel UI is at http://localhost:8100/)

03DSH 适配与能力边界

DSH 适配兼容

Connects to DeepSeek Harness via the `dsh-openstory` plugin, letting the agent start simulations, view characters, issue instructions and advance the story turn by turn

  • Dynamic Agent-Kernel simulation

    story examples, character data and YAML configsmulti-agent simulation that supports adding and removing agents dynamically during runtime

  • One-sentence world generation (WorldKernel)

    one natural-language sentence describing a world ideacharacters, locations, paths and rules generated into an interactive multi-agent simulation

    generates local world data that can be continued latercalls an OpenAI-compatible model endpoint and requires local Redis
  • Visual interactive frontend

    a running simulation (local API server)1:1 map view with agent trajectories, character profiles, state changes and interaction archives at http://localhost:8000/frontend/index.html

    starts an API server listening on 0.0.0.0:8000 (WorldKernel uses port 8100)
  • Plugin-based lifecycle & YAML configuration

    YAML files under configs/ (simulation_config.yaml, models_config.yaml, system_config.yaml)customized simulation rules: Pod count, max ticks, LLM model interface and parameters, Messager (message bus) and Timer (clock)

04适合谁?何时不该用?

适合

  • DeepSeek Harness users who want interactive, evolving multi-agent story worlds controlled through their agent
  • Story designers and hobbyists prototyping evolving story worlds without hand-authoring agents
  • Players and researchers exploring emergent social behavior in LLM agent communities

不适合

  • Requires a local Redis service running and listening on port 6379 as the default data bus and cache; entering WorldKernel simulations also depends on local Redis.
  • Westworld and WorldKernel require you to fill in an OpenAI-compatible model configuration (models_config.yaml / models.yaml, or the WORLDKERNEL_API_KEY env var), so model calls go to an external endpoint you configure.

05兼容性、维护与安全提示

  • Requires a local Redis service running and listening on port 6379 as the default data bus and cache; entering WorldKernel simulations also depends on local Redis.
  • Dream of the Red Chamber and Westworld both bind port 8000 and must not run simultaneously; WorldKernel uses port 8100 and can be started separately.
  • Westworld and WorldKernel require you to fill in an OpenAI-compatible model configuration (models_config.yaml / models.yaml, or the WORLDKERNEL_API_KEY env var), so model calls go to an external endpoint you configure.
2026-04-012026-08-19story-of-the-stone-zh-v1.0.0

Apache-2.0 · actively maintained (last push 2026-08-19, release story-of-the-stone-zh-v1.0.0)

06常见问题

如何把 OpenStory 接入 DeepSeek Harness?

通过 dsh-openstory 插件接入。README 新闻区给出了 DSH 插件配置与使用指南(dsh-openstory/README.zh.md),接入后 agent 可直接启动模拟、查看角色、下达指令并逐回合推进故事。

是原生运行还是通过 MCP?

README 只提到以 DeepSeek Harness 插件(dsh-openstory)的方式接入,没有提及 MCP。

需要什么前置条件?

推荐 Python 3.10 或以上,本地 Redis 需启动并监听 6379 端口;西部世界与 WorldKernel 还需在配置文件中填写 OpenAI-compatible 模型配置(models_config.yaml / models.yaml,或环境变量 WORLDKERNEL_API_KEY)。

端口占用情况如何?

红楼梦与西部世界都使用 8000 端口,不能同时运行;WorldKernel 使用 8100 端口,可分开启动。

数据和网络请求去向?

本地 Redis 作为默认数据总线与缓存;模型调用发往你自行配置的 OpenAI-compatible 接口。前端在本地浏览器访问 localhost:8000(WorldKernel 为 8100)。

08数据与来源

  • 作者声明github.com3e4857a07ec1…

    **✨ OpenStory 现已支持 DeepSeek Harness 插件!** 现在可以通过 `dsh-openstory` 将 OpenStory 多智能体推演接入 DeepSeek Harness,让 agent 直接启动模拟、查看…

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-08-21。发现错误?提交更正。

DSH Plugins 是独立的 DeepSeek Harness 插件市场,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。