@dsh-external/dsh-roblox-studio
DeepSeek Harness-native Roblox Studio MCP companion: Settings UI listing connected Studio instances, active-instance selection exposed to the agent as runtime context, plus live visibility into Studio's official Script Sync and agent guidance for file-first editing.
安装
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:bxsexc/dsh-roblox-studio说明文档
阅读完整 README ↗dsh-roblox-studio
DeepSeek Harness 原生插件:为 mcp-roblox-studio(@deepseek-ai/dsh-mcp-client 桥接的 Roblox Studio MCP)补充一个人机界面。
功能
- Settings → Roblox Studio 设置分区:
- 实时列出当前通过 Roblox Studio MCP 连接的 Studio 实例(
list_roblox_studios,独立 MCP stdio 连接,不影响 Agent 的工具连接) - 一键激活某个实例、取消激活
- 显示 MCP 桥状态、实例掉线(stale)标记
- 实时列出当前通过 Roblox Studio MCP 连接的 Studio 实例(
- 激活选择通过
ctx.systemPrompt.context注入 Agent 运行时上下文:Agent 会被明确告知在所有mcp__roblox__*工具调用中使用该studio_id,其他已连接实例不会被误操作;选择失效时会收到告警。 - 选择持久化在 Settings 提供方(
roblox-studio命名空间,通常为~/.dsh/settings.yaml)。
关于脚本同步:磁盘 ↔ Studio 的实时双向脚本同步请使用 Roblox Studio 官方 Script Sync(资源管理器中右键服务或文件夹 → “Sync to…” 选择本地目录,重开工程自动恢复)。它没有 MCP 编程接口,无法由插件代为启动,因此本插件不重复实现单向快照式同步,而是围绕它做增值:
- 官方同步状态面板:设置页通过
InstanceFileSyncService(MCPexecute_luau可达)实时显示激活实例上处于官方同步的服务/文件夹(同步根)、出错树与查询失败原因,45s 缓存 + 定时/事件刷新。 - Agent 文件优先引导:设置「本地同步目录」后,当激活实例存在同步根时,运行时上下文会告知 Agent——同步范围内的脚本优先直接编辑本地 Rojo 风格文件(
*.server/.client/.local/.legacy.luau、文件夹/init.*.luau),磁盘变更由官方同步实时回写 Studio,比走 MCP 写入更快也更不易冲突。
安装
git clone https://gitee.com/nidiehhh/dsh-roblox-studio.git
dsh plugin --profile web add /path/to/dsh-roblox-studio
安装后重启 Web profile(宿主在进程启动时发现浏览器 bundle)。打开 GUI → 设置 → Roblox Studio。
深浅主题
界面全部走 DSH 设计系统 alias(--dsw-alias-*),跟随 body[data-ds-dark-theme] 自动切换深/浅色。
配置(Settings / profile patch)
| 字段 | 默认 | 说明 |
|---|---|---|
serverName | roblox | 对应 mcp-client 条目的 serverName,用于工具名提示 |
launcherCommand | 自动探测 | StudioMCP 启动命令;空 = ~/.dsh/roblox-studio-mcp.cmd → 最新 StudioMCP.exe |