前言¶

在 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 / 幻方無官方從屬關係。