返回目錄

openstory

編輯精選維護狀態: 活躍

zju-llms/openstory

基於 LLM 的多智慧體框架,用於模擬互動式、不斷演化的故事世界。

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

412

星數

45

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 相容的模型設定(models_config.yaml / models.yaml,或環境變數 WORLDKERNEL_API_KEY)。

連接埠佔用狀況如何?

紅樓夢與西部世界都使用 8000 連接埠,不能同時執行;WorldKernel 使用 8100 連接埠,可分開啟動。

資料和網路請求的去向?

本機 Redis 作為預設資料匯流排與快取;模型呼叫會發往你自行設定的 OpenAI 相容介面。前端在本機瀏覽器存取 localhost:8000(WorldKernel 為 8100)。

08資料與來源

  • 作者聲明github.com3e4857a07ec1…

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

此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-08-21。發現錯誤?提交更正。

🏆

最佳 DeepSeek Harness 外掛

從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。

DSH Plugins 是獨立的 DeepSeek Harness 外掛市集,與 DeepSeek 官方無關,也不代表官方背書。第三方外掛未經安全稽核,安裝前請審查原始碼。

每週取得最新的 DeepSeek Harness 外掛,絕不濫發。