前言¶
用 DeepSeek Harness（DSH）驅動智能體操作 Godot 時，MCP 橋是否已連上、工具是否已註冊，往往要翻日誌或試調工具才能確認。Godot 編輯器側 MCP 服務開了、DSH profile 裏配了客戶端，中間任一環節斷開，mcp__godot__* 工具也不會出現在註冊表裏。下面介紹 oceanke100 維護的客戶端插件 dsh-godot-mcp-status：在 Web 界面右下角放一個可拖動的 Godot 圖標角標，用藍/灰圓點和懸停氣泡把「編輯器在不在」與「DSH 是否已連上 MCP」分開呈現。
這是什麼¶
dsh-godot-mcp-status 是給 DeepSeek Harness 使用的 Godot MCP 連接狀態顯示插件（倉庫：oceanke100/dsh-godot-mcp-status）。分類上屬於 客戶端 模塊：Godot 編輯器運行期間，主界面右下角出現帶「MCP」角標的 Godot 圖標；編輯器關閉後圖標消失。它回答一個問題：當前編輯器裏的 MCP 是否可用，智能體能否實際調用 mcp__godot__* 工具。
社區目錄頁：https://www.skillhub.cn/plugins/oceanke100/dsh-godot-mcp-status（獨立生態站點，與 DeepSeek / 幻方無官方從屬關係）。
核心功能¶
界面表現¶
- 狀態圓點：角標文字前有一個圓點。藍色表示 DSH 已連上 Godot MCP 並完成工具發現；灰色表示 Godot 編輯器在跑（或檢測到端點）但 DSH 尚未連通或未註冊工具。
- 懸停提示：鼠標懸停顯示「已連接」或「未連接」等對應氣泡。
- 拖動：按住圖標可拖到窗口內任意位置；鬆手位置會限制在窗口內，並寫入
localStorage鍵dsh-godot-mcp-status:position，同源刷新後保持。移動不足 4px 計爲點擊，避免影響懸停。默認距右 12px、距底 30px。 - 角標尺寸：客戶端在
shell.overlay註冊全窗口單點擊穿席位，每 2 秒輪詢狀態；僅 32px 圖標接收鼠標事件。
未配置 MCP 時的行爲¶
插件無需額外配置即可激活。若 profile 裏尚未配置 Godot MCP，但本機 Godot MCP 端點（9080–9083）在監聽，角標會以灰點出現，氣泡提示「檢測到 Godot MCP，尚未配置」；點擊可彈出可直接複製的 cordis.patch.yml 配置行。探測不到端點則不顯示角標。進程掃描僅在已配置的服務器名稱或地址含 godot 時啓用，避免因機器上其它 Godot 項目誤顯角標。
狀態如何判定（Host）¶
Host 半邊按需計算並通過 /godot-mcp-badge/state.json 返回 JSON，將兩件事分開：
- 編輯器是否在運行：通常對配置的 MCP 端點做 TCP 探測；端口關閉時退回進程掃描（Windows 用
tasklist，其它平臺用ps查找 Godot 編輯器進程，緩存 3.5 秒）。 - DSH 是否已連接：依據實時工具註冊表中的
mcp__<server>__<tool>定義；MCP 橋僅在連接成功並完成工具發現後註冊，連接釋放或重連預算耗盡後移除。
服務器行來自 loader 中帶 serverName 且傳輸爲 stdio 或 streamable-http 的條目。插件不向編輯器寫入狀態；端口探測只建立 socket 後關閉，不打開 MCP 會話。
環境要求¶
- DSH 版本：
>= 0.2.2-rc.1（見package.json的engines.dsh）。 - 運行平臺：Web（桌面版或瀏覽器）。
- 若要出現藍點，profile 中需有 Godot MCP 客戶端配置，例如
@deepseek-ai/dsh-mcp-client，serverName爲godot，transport爲streamable-http。未配置時插件仍可安裝，僅做端點檢測與配置片段提示。
安裝與啓用¶
安裝方式以倉庫 README 爲準，不必手寫臆測的 CLI 包名拼接。
通過插件市場發現¶
- 在 DSH 設置 → 插件 → 發現 中添加列出本插件的索引源。
- 從卡片安裝。倉庫發佈後自帶索引地址爲：
https://oceanke100.github.io/dsh-godot-mcp-status/index.json
索引中固定的 Git 源形式爲：
git+https://github.com/oceanke100/dsh-godot-mcp-status.git#<commit>
（<commit> 以索引所列爲準。）
npm¶
發佈到 npm 後可用包名 dsh-godot-mcp-status 安裝；當前 0.1.0 仍走上述 Git 源（見 package.json 的 version）。
本地目錄¶
用插件管理器的 install_bundle 指向本倉庫根目錄。
安裝後¶
角標屬於客戶端模塊，已打開的頁面需刷新一次纔會出現。不需要爲本插件單獨寫配置；它跟隨 profile 裏已有的 MCP 服務器設置。
典型用法¶
- 在 Godot 中啓用 MCP 插件並保持編輯器運行，在 DSH profile 中配置
serverName: godot的 MCP 客戶端行。 - 安裝本插件並刷新 DSH Web 頁面，觀察右下角 Godot 角標。
- 圓點爲藍且懸停顯示已連接時，可認爲
mcp__godot__*工具已在註冊表中，智能體側可正常選用。 - 若爲灰點且提示尚未配置，點擊角標複製
cordis.patch.yml片段，按提示補全 profile 後重連 MCP。
適用場景與注意¶
適合誰：在 DSH Web UI 裏做 Godot + MCP 聯調、需要一眼確認橋接狀態的開發者。
權限與安全：插件以當前 DSH 進程權限運行；Host 側會探測端口與進程列表。安裝前建議查看 GitHub 倉庫 源碼與 MIT 許可證（LICENSE）。界面使用的 Godot logo 遵循 CC BY 4.0，爲 Godot Foundation 商標，此處僅用於標識 Godot MCP 連接（見 Godot press）。
版本信息：npm 包版本 0.1.0；GitHub 星標以倉庫頁面爲準（目錄線索爲 0）。
結尾¶
dsh-godot-mcp-status 把 Godot MCP 的「編輯器在線」與「DSH 已註冊工具」拆成可見的角標狀態，減少反覆試工具和查日誌的成本。進一步瞭解可訪問目錄頁 skillhub.cn/plugins/oceanke100/dsh-godot-mcp-status 與源碼倉庫 github.com/oceanke100/dsh-godot-mcp-status。
