前言¶
在 DSH（DeepSeek Harness）里做直播或互动演示，常见做法是单独拼弹幕、语音、形象渲染和 OBS 推流脚本，会话状态也难和智能体工作台对齐。dsh-studio-live 把直播页、角色渲染、弹幕与语音队列、OBS 桥接以及可选游戏适配器收进一个可独立安装的 studio 插件；共享工作台只提供容器与会话控制，不会替你安装本 studio 或任何游戏。
下面按定位、功能、安装与限制说明如何使用和维护者 1997liuyh-boop 发布的当前版本。
这是什么¶
dsh-studio-live 是声明在 package.json → dsh.bundle.patch 上的 DSH 客户端插件（仓库：1997liuyh-boop/dsh-studio-live）。README 将其描述为：在 DSH 会话中运行 AI 游戏直播工作室，支持分会话处理观众消息与游戏控制、弹幕队列、语音形象、OBS 叠加层，以及 Live2D/VRM 导入与可选游戏适配器。
维护者：1997liuyh-boop。社区目录分类为客户端。许可证：MIT（见仓库 LICENSE）。
核心功能¶
以下能力均来自仓库 README，未在资料中出现的细节不作延伸。
会话与队列¶
- 为观众消息与游戏控制分别运行 DSH 会话，支持状态记录与停止操作。
- 弹幕与语音：队列化、去重；最多 20 条消息、8 条语音；支持过期、取消与可见的失败状态。
B 站弹幕¶
- 通过 WBI 鉴权、心跳、解压、有界重试接收 B 站弹幕；Cookie 在内存中处理。
- 需要有效房间号与用户自行提供的登录 Cookie（非插件内置）。
角色与口型¶
- 导入 VRM，以及 PNG/WebP/JPG、Live2D Cubism 3/4 模型 ZIP；模型持久化在本地 IndexedDB。
- 首次启动显示内置 whale-girl 静态图；导入本地模型或图片后优先生效。
- 口型可由云端语音包络或本地系统语音近似驱动；同一渲染器可用于预览与 OBS。
OBS¶
- 通过 OBS WebSocket v5 连接；提供带随机 token 的本地只读 overlay URL。
可选游戏适配¶
- 在用户自备受支持的游戏、mod/运行时与本地服务器时，提供有界 Stardew Valley（需 SMAPI、.NET 6 等）与 Minecraft 适配；含紧急停止，不提供通用寻路、战斗、钓鱼或自动选装。
安装与启用¶
在 DSH Desktop 插件管理器中安装。README 要求先添加控制包，再添加下列带标签的源（勿凭仓库名自行拼接未在文档中出现的命令）：
github:1997liuyh-boop/dsh-studio-library#v0.1.3
github:1997liuyh-boop/dsh-studio-live#v0.3.8
确认插件管理器列出 dsh-studio-live 版本 0.3.8 后，打开 Live studio。该包需要兼容的 dsh-worktable ^0.6.0 与 dsh-studio-projects ^0.5.0，由控制包提供。
package.json 中 DSH 引擎声明为 0.2.1-rc.2 || >=0.2.2-rc.1 <0.2.2，并标注与 0.2.2-rc.1 等为 experimental 兼容。本地开发需 Node.js 22：
npm install --include=dev --legacy-peer-deps
npm run build
npm run check
公开发布包含编译后的插件与 Web 资源，不包含 Live2D Cubism Core、Haru 样例或私有角色模型；导入受许可的本地 Live2D 资源前请阅读仓库 LIVE2D.md。
典型用法（按 README 流程）¶
- 安装
dsh-studio-library与dsh-studio-live指定标签，确认版本0.3.8。 - 在工作台打开 Live studio，按需配置 B 站房间号与 Cookie、云端语音（需网络与配额）、OBS WebSocket v5。
- 导入 VRM、图片或合规的 Live2D ZIP；默认图为静态透明图，非绑定 Cubism 模型。
- 使用 OBS 只读 overlay URL 叠加画面；游戏相关功能仅在自备环境满足 README 所列外部依赖时启用。
适用场景与注意¶
适合谁： 已在 DSH 生态中使用 dsh-worktable / dsh-studio-projects，需要把弹幕、语音队列、虚拟形象和 OBS 与 DSH 会话绑在一起的直播或演示场景。
权限与安全： 插件在当前 DSH 进程权限下运行。安装前应审阅源码与 MIT 许可证及 THIRD_PARTY_NOTICES.md；模型与语音数据留在本地，资料写明插件不读取其他应用的 API 密钥或私有配置。Live2D ZIP 在本地校验并有大小、文件数与纹理上限；拒绝 ZIP 脚本、外链与路径穿越。
外部依赖： OBS、星露谷/SMAPI/.NET 6、Minecraft 与本地 Java 测试服务器等均由用户自备，插件不会自动安装或启动。B 站与云端语音受平台可用性与配额限制。游戏动作为有界操作，非全功能游戏 bot。
生态上，DSH 奉行「一切皆插件」；社区目录 skillhub.cn 为独立站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-studio-live 把直播页、队列、形象、OBS 与可选游戏适配收成独立 studio，与 dsh-studio-library 控制包和指定版本的 worktable/projects 配套使用。查阅目录页与源码：
