前言¶
用 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。
