前言¶

在 DSH 中使用 Roblox Studio MCP 时，如果同时连接多个 Studio 实例，常见的问题是：Agent 应该操作哪一个实例？官方 Script Sync 当前同步了哪些目录？磁盘脚本是否应该优先直接编辑？

dsh-roblox-studio 把实例选择、MCP 桥状态、官方 Script Sync 状态集中到 DSH 设置页，并将激活选择注入 Agent 运行时上下文。

这是什么¶

dsh-roblox-studio 是 DeepSeek Harness 原生插件，仓库为 bxsexc/dsh-roblox-studio，许可证为 MIT。

它面向 DSH Web profile，为 Roblox Studio MCP 提供设置界面：实时列出已连接 Studio 实例，支持选择激活实例，展示官方 Script Sync 状态，并在设置本地同步目录后引导 Agent 优先编辑本地 Rojo 风格文件。

核心功能¶

实例列表与激活¶

下面介绍设置页中的实例管理部分。

• 在 Settings → Roblox Studio 分区实时列出当前通过 Roblox Studio MCP 连接的 Studio 实例。
• 支持一键激活某个实例或取消激活。
• 显示 MCP 桥状态和实例掉线（stale）标记。

Agent 运行时上下文¶

激活选择通过 ctx.systemPrompt.context 注入 Agent 运行时上下文。

上下文会提示 Agent 在所有 mcp__roblox__* 工具调用中使用指定 studio_id，并在选择失效时收到告警。

选择持久化¶

激活选择持久化在 Settings 提供方 roblox-studio 命名空间，通常为 ~/.dsh/settings.yaml。

官方 Script Sync 状态¶

设置页展示官方 Script Sync 状态，包括：

• 同步根
• 出错树
• 查询失败原因

状态缓存为 45 秒，并支持定时/事件刷新。

官方 Script Sync 没有 MCP 编程接口，插件无法代为启动，也不重复实现单向快照式同步。

文件优先编辑¶

设置本地同步目录后，运行时上下文会引导 Agent 优先直接编辑同步范围内的本地 Rojo 风格文件。

主题¶

界面使用 DSH 设计系统 alias，并跟随 body[data-ds-dark-theme] 自动切换深浅主题。

安装与启用¶

环境要求 Node ^22.19.0 || >=24.0.0。

README 给出的安装命令使用 Gitee 仓库路径：

git clone https://gitee.com/nidiehhh/dsh-roblox-studio.git
dsh plugin --profile web add /path/to/dsh-roblox-studio

安装后重启 Web profile，然后打开：

GUI → 设置 → Roblox Studio

插件声明以下 peerDependencies：

@deepseek-ai/cordis ^4.0.0-rc.7
@deepseek-ai/dsh-settings ^0.0.1
@deepseek-ai/dsh-system-prompt ^0.0.1
@deepseek-ai/dsh-host-webserver ^0.0.1
@deepseek-ai/schemastery ^3.18.0

其中 @deepseek-ai/dsh-host-webserver 为可选依赖。

典型用法¶

1、在设置页激活或取消激活实例，使选择注入 Agent 运行时上下文。

2、设置本地同步目录，让 Agent 优先编辑同步范围内的本地 Rojo 风格文件。

3、磁盘与 Studio 的实时双向脚本同步使用 Roblox Studio 官方 Script Sync，可通过资源管理器右键服务或文件夹 → Sync to… 选择本地目录。

4、调用设置接口获取快照或执行动作。接口为：

/_dsh/roblox-studio/settings

GET 用于获取快照；POST 支持 refresh、activate、clear、saveScriptSyncRoot。执行 activate、clear、saveScriptSyncRoot 时携带 expectedRevision；saveScriptSyncRoot 还需要 scriptSyncRoot。

示例：

GET /_dsh/roblox-studio/settings

POST /_dsh/roblox-studio/settings

{"action":"refresh"}

{"action":"activate","studioId":"<studio-id>","expectedRevision":1}

{"action":"clear","expectedRevision":1}

{"action":"saveScriptSyncRoot","scriptSyncRoot":"/path/to/local-sync-dir","expectedRevision":1}

配置项¶

插件配置项包括：

• serverName
• launcherCommand
• activeStudioId
• activeStudioLabel
• refreshTimeoutMs
• scriptSyncRoot

其中：

• activeStudioId 和 activeStudioLabel 用于维护激活选择。
• scriptSyncRoot 是官方 Script Sync 的本地同步目录；设置后，Agent 会优先直接编辑同步范围内的本地文件。

适用场景与注意¶

适合在 DSH Web profile 中使用 Roblox Studio MCP，并且需要集中查看实例状态、选择激活实例、查看官方 Script Sync 状态的开发者。

插件以当前 dsh 进程权限运行。安装前应检查源码与许可证。官方 Script Sync 需要在 Roblox Studio 中按官方方式配置，插件只展示状态，并为 Agent 提供运行时上下文引导。

链接¶

• 插件目录页：https://www.skillhub.cn/plugins/bxsexc/dsh-roblox-studio
• GitHub 仓库：https://github.com/bxsexc/dsh-roblox-studio

该目录页是社区目录，属于独立站点，与 DeepSeek / 幻方无官方从属关系。