bxsexc/dsh-roblox-studio

DeepSeek Harness 原生插件:Roblox Studio MCP 桥接的设置界面——列出已连接的 Studio 实例,选择活动实例,并将选择结果作为运行时上下文暴露给代理。

Project Overview项目介绍

This is a native plugin built exclusively for DeepSeek Harness (DSH), designed to add a graphical user interface for the Roblox Studio MCP integration that is bridged via the official @deepseek-ai/dsh-mcp-client. The plugin adds a dedicated Roblox Studio settings section to DSH’s existing settings GUI, and pulls a real-time list of all currently connected Roblox Studio instances via a separate MCP stdio connection that does not interfere with the agent’s main tool connection. Users can activate or deactivate any listed instance with one click, and the interface displays the current MCP bridge status and flags any stale (offline) instances for easy visibility.

When a user activates an instance, the plugin injects the selected studio ID into the agent’s runtime context via ctx.systemPrompt.context, which ensures the agent will always use this specific studio ID for all mcp__roblox__* tool calls, and eliminates the risk of accidental modifications to other connected instances. If the activated instance becomes invalid or goes offline, the user will receive an immediate alert about the change in status. The plugin also adds a status panel for Roblox Studio’s official Script Sync feature, which displays the current status of sync roots, any sync errors, and failed queries, with a 45-second cached refresh that updates automatically on a timer or triggered events.

To install the plugin, you first clone its Git repository to your local machine, then run the DSH CLI command dsh plugin --profile web add /path/to/dsh-roblox-studio to register it with your current DSH web profile. After the installation process completes, you must restart your DSH web profile for the plugin to be detected and loaded properly by the host process. All UI elements of the plugin use DSH design system aliases, so it automatically switches between light and dark themes to match your DSH instance’s current theme setting. The plugin is released under the open source MIT license, and requires a pre-configured mcp-roblox-studio MCP server to work correctly.

这是一款专为 DeepSeek Harness 开发的原生插件,为经由 @deepseek-ai/dsh-mcp-client 桥接的 Roblox Studio MCP 服务提供人机交互界面。插件会在 DSH 的设置面板中新增专属的「Roblox Studio」分区,可实时列出当前通过 MCP 连接的所有 Studio 实例,支持一键激活或取消激活指定实例,还能显示 MCP 桥连接状态,标记掉线的 stale 实例。

选中的激活实例信息会被注入到 Agent 运行时上下文中,确保 Agent 调用所有 Roblox 相关工具时都会使用指定的 studio_id,避免误操作其他已连接实例。插件会持久化保存用户的选择,还增加了 Roblox Studio 官方脚本同步状态面板,可实时展示激活实例上同步根的状态和同步错误信息,自带 45 秒缓存定时刷新。

该插件遵循 DSH 设计系统的别名规范,可自动跟随 DSH 深浅主题切换样式,遵循 MIT 许可证开源。安装需要先克隆仓库到本地,再通过 DSH CLI 命令添加到当前的 web 配置文件,安装后需要重启 web profile 才能生效,依赖已完成配置的 mcp-roblox-studio MCP 服务运行。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:bxsexc/dsh-roblox-studio

把 bxsexc/dsh-roblox-studio 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

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)标记
  • 激活选择通过 ctx.systemPrompt.context 注入 Agent 运行时上下文:Agent 会被明确告知在所有 mcp__roblox__* 工具调用中使用该 studio_id,其他已连接实例不会被误操作;选择失效时会收到告警。
  • 选择持久化在 Settings 提供方(roblox-studio 命名空间,通常为 ~/.dsh/settings.yaml)。

关于脚本同步:磁盘 ↔ Studio 的实时双向脚本同步请使用 Roblox Studio 官方 Script Sync(资源管理器中右键服务或文件夹 → “Sync to…” 选择本地目录,重开工程自动恢复)。它没有 MCP 编程接口,无法由插件代为启动,因此本插件不重复实现单向快照式同步,而是围绕它做增值:

  • 官方同步状态面板:设置页通过 InstanceFileSyncService(MCP execute_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
activeStudioId / activeStudioLabel 空 由设置界面维护
refreshTimeoutMs 20000 每次 MCP 请求超时
scriptSyncRoot 空 官方 Script Sync 的本地目录;设置后 Agent 会优先直接编辑同步范围内的本地文件

路线

  • /_dsh/roblox-studio/settings:GET 快照(含 scriptSync 官方同步状态视图);POST {action:'refresh'} / {action:'activate', studioId, expectedRevision} / {action:'clear', expectedRevision} / {action:'saveScriptSyncRoot', scriptSyncRoot, expectedRevision}(同源校验)。
← 上一个 Prev dsh-eval 下一个 Next dsh-tonghuashun →