前言¶
用 DeepSeek Harness（DSH）改遊戲時，智能體通常只能看到倉庫裏的代碼，看不到線上或本地構建裏玩家實際遇到了什麼：哪關掉幀、哪條錯誤影響面最大、昨晚的包有沒有緩解卡頓。Glitchless 做的是遊戲可觀測性——會話裏的幀時間、 hitch 原因、錯誤、關卡進度、退出位置、自定義事件等會彙總到 Glitchless Cloud 或自建服務；glitchless-dsh 把 Glitchless 的 MCP 工具與三條 slash skill 掛進 DSH，讓對話裏可以直接問「這週遊戲哪裏有問題」或按引擎接入 SDK。下面介紹插件定位、能力與安裝用法。
這是什麼¶
glitchless-dsh（GitHub：glitchless-gg/glitchless-dsh）由 glitchless-gg 維護，在 SkillHub 插件目錄 中歸類爲工作流。它在 DSH 裏註冊 glitchless-mcp 服務器，並向模型暴露 25 個以 mcp__glitchless__* 爲前綴的工具，以及 3 個 skill（同樣可作爲 slash 命令使用）。Glitchless Cloud 是獨立於 DSH / DeepSeek 的第三方服務，有免費檔；也可自建 Glitchless 服務端。
核心功能¶
MCP 工具（25 個）¶
README 列出的能力包括：按優先級排序的發現項、按關卡與設備的幀時間、錯誤統計、單局時間線、遊戲自定義事件與漏斗、玩家提交的 bug 報告、商店評價與收入、各遊戲儀表盤、Playtest 機器人、只讀分享鏈接，以及告警相關（規則開關、週報、已接受爲已知的問題、已標記解決的錯誤等）。工具以當前登錄 Glitchless 工作區的身份讀取遊戲數據，並可創建遊戲、保存儀表盤、創建或撤銷只讀分享鏈接；不會刪除數據，也不涉及賬單或成員管理（詳見 README「Permissions」）。
三條 Skill¶
| Skill | 作用 |
|---|---|
glitchless-setup |
在 Unity、Godot、Unreal、Three.js、Phaser、Babylon.js、PlayCanvas 或 GameMaker 項目中接入 Glitchless：SDK、關卡、事件、機器人、隱私設置 |
glitchless-dashboard |
釐清要觀測的指標，補齊埋點，並設計儀表盤 |
glitchless-triage |
找出影響玩家最多的問題，修復並在下一版本中驗證 |
同一套 skill 在 Claude Code、Codex、Cursor 等環境中也有對應版本，見 Glitchless 主倉庫。
安裝與啓用¶
安裝前請確認：
- Node.js 22 或更高必須在 DSH 實際使用的
PATH中。插件通過npx啓動 Glitchless MCP 服務器；若 Node 不可用，25 個工具不會出現且往往沒有明確報錯。在啓動 DSH 的同一 shell 裏執行node --version，應看到 v22 及以上。 - 需要 Glitchless 賬號（瀏覽器授權登錄，見下文）或自建服務（見「自建 Glitchless」）。
官方安裝命令（README 原文）：
dsh plugin --profile web add glitchless-dsh
安裝後重啓 DSH。若使用 TUI 或 headless，將 --profile web 換成 --profile tui 或 --profile headless。
package.json 聲明：engines.node 爲 >=22，engines.dsh 爲 >=0.2.1-rc.5；插件版本 0.1.3，許可證 MIT。README 寫明在 DSH 0.2.1-rc.5 與 DeepSeek V4.1 Flash、macOS 上做過測試。
登錄 Glitchless¶
在 DSH 裏讓智能體「sign in to Glitchless」。會調用 glitchless_sign_in，展示鏈接與驗證碼；在 Glitchless 控制台批准驗證碼後，智能體可訪問工作區內的遊戲。密鑰不會寫入 DSH 配置文件，而是由 MCP 服務器保存在 ~/.config/glitchless/credentials.json（僅本用戶可讀）。退出登錄可執行：
npx -y glitchless-mcp logout
新工作區自帶 demo 遊戲，可在自己的項目上報數據前先試用。控制台 Settings → Keys & access 可查看並撤銷密鑰。
典型用法¶
在遊戲項目目錄打開 DSH，用自然語言或 skill 即可，README 示例包括：
- 「Set up Glitchless for my game」（對應
glitchless-setup） - 「What’s wrong with my game this week?」
- 「Build my game a dashboard: I want to know where players quit and which mode they play」
glitchless_playtest 會在本機對構建跑機器人；setup skill 在你明確要求時會改項目代碼，使用前請確認變更範圍。
自建 Glitchless¶
Glitchless 服務端可自託管。Docker 示例（README 原文）：
docker run -p 7777:7777 -v glitchless-data:/data ghcr.io/glitchless-gg/glitchless
DSH 不會把自身環境變量自動傳給 MCP 服務器，需在 profile 的 patch 裏爲 glitchless-mcp 配置地址與 API Key。在 ~/.dsh/profiles/web/cordis.patch.yml 末尾追加（會替換該 MCP 行的整段 config，需保留文件中其它條目）：
- id: glitchless-mcp
config:
serverName: glitchless
transport: stdio
command: npx
args: ['-y', 'glitchless-mcp']
cwd: !!js process.cwd()
toolCallTimeoutMs: 600000
failOnStartupError: false
env:
GLITCHLESS_URL: http://localhost:7777
GLITCHLESS_API_KEY: gl_sk_…
適用場景與注意¶
適合：已在或計劃在 Unity / Godot / Unreal / Web 遊戲棧中使用 Glitchless，並希望 DSH 智能體直接查幀率、錯誤、漏斗與儀表盤、協助接入與排障的團隊。
注意：
- 插件與 MCP 以當前運行 DSH 的用戶權限執行，工具行爲等同你在 Glitchless 工作區中的角色；安裝前建議閱讀 倉庫源碼 與 MIT 許可證。
- SkillHub 目錄爲社區站點，與 DeepSeek / 幻方無官方從屬關係；DSH 生態本身是「一切皆插件」的擴展方式。
- 隱私與條款見 glitchless.gg/privacy.html；問題可聯繫 support@glitchless.gg。
結尾¶
glitchless-dsh 把遊戲可觀測性接進 DSH：MCP 負責讀數據與告警，三條 skill 負責接入引擎、設計儀表盤和按影響面排障。目錄頁：https://www.skillhub.cn/plugins/glitchless-gg/glitchless-dsh；源碼與說明：https://github.com/glitchless-gg/glitchless-dsh；Glitchless 產品與文檔：https://www.glitchless.gg。
