前言¶
DeepSeek Harness（DSH）里不少插件带图形界面：侧栏面板、表单、按钮和异步加载。开发时常见做法是人工切到插件页、点一遍、看控制台有没有红字，再回到对话继续改代码。步骤重复，且样式问题（间距、颜色、字号）靠肉眼和截图很难写成可核对的断言。
下面介绍社区插件 dsh-ui-probe（维护者 yuexizhishang，分类：工作流）。它在当前正在运行的 DSH 桌面/Web 客户端里打开目标插件页，用自动化读布局与计算样式、操作控件、等待异步结果，并收集控制台报错；任务结束后自动回到原来的对话，不占用界面。
这是什么¶
dsh-ui-probe 是 DSH 的图形界面插件测试工具（UI 探针）。一句话定位：在真实界面里自动测试插件页面，读样式、点按钮、填表单、等异步结果、抓控制台报错，测完自动回到原对话。
插件通过 Cordis 补丁接入客户端（client 平台为 web，immediately: true），装好后无需额外配置文件。对话里会多出 ui_probe 和 ui_page 两个工具；技能列表里会出现「dsh-ui-probe」指南，模型根据工具描述决定何时调用。卸载后工具与指南一并消失，不向系统目录遗留独立配置。
当前 npm 包版本为 1.0.0（见仓库 package.json），许可证 MIT。
核心功能¶
验收流程在 README 里概括为三步：
| 步骤 | 做什么 |
|---|---|
| 打开 | 切到目标插件页面，并记住原对话，供之后返回 |
| 操作 | 逐步执行：点击、按文字找元素、读计算样式、填表单、按键、等待元素出现、页面快照（可见标题与按钮清单） |
| 收尾 | 返回时间线 + 页面快照 + 控制台报错，然后自动回到对话 |
具体能力包括：
- 读真实界面：元素尺寸、位置，以及字号、颜色、内外边距、圆角、不透明度等计算样式（不依赖截图像素）。
- 点按钮：按可见文字或 CSS 选择器定位；文字出现在聊天记录里时，可限定在某个容器内查找。
- 填表单：普通输入框、文本域、富文本编辑器；写完后回读校验，写不进去会报失败。
- 按键：回车、Esc、退格等。
- 等异步：轮询等待某元素出现，适合「加载中→出列表」「点完弹提示」等场景。
- 抓报错：汇总控制台错误，界面异常不会静默失败。
若只需快速看一眼面板，可打开、读一次、立刻返回，不必走完整验收链。
收尾与超时：验收结束会主动返回原对话；中间 30 秒无新动作会自动收尾；页面意外刷新后会按记录的起点尝试回到原对话。
安全边界（对自动化封闭）：账号菜单、设置面板内的点击/输入/按键一律拒绝；若误打开会立刻关闭并报告「已拒绝」。唯一例外是插件自带的「UI 探针」设置页（版本、更新、卸载）。
已知限制：
- 不能从一个面板自动推断并切回另一个面板，需显式再点一次。
- 不支持 Canvas / 自绘编辑器内的输入，仅标准输入框、文本域与普通富文本。
- 同时只能跑一个验收任务，后到的排队。
安装与启用¶
在 DeepSeek Harness 的「插件 → 添加插件」中粘贴下列之一并安装（不要自行拼接未在文档出现的 CLI 命令）。
方式一：GitHub（推荐）
github:yuexizhishang/dsh-ui-probe
等价仓库地址：https://github.com/yuexizhishang/dsh-ui-probe。
方式二：npm 预构建包
@yuexizhishang/dsh-ui-probe
无需本地编译。安装后若提示重启，重启一次 DSH 即可。
装完不用配置任何东西。 插件自带发现机制；卸载时在设置侧栏「UI 探针」中二次确认即可，只移除插件本身，不删除用户自己的文件或仓库。
插件设置页还提供：打开时自动与 GitHub 比对版本；有新版时可「更新并安装」；网络或仓库不可达时会如实报错。插件本身不会自动打开设置面板。
典型用法¶
直接对对话说明意图即可，例如：
验收一下便签插件，看一下界面和插件功能有没有问题。
模型会调用 ui_probe / ui_page 等工具，在真实客户端里完成打开 → 操作 → 收尾。你收到的是可核对的尺寸、样式、文字清单与控制台报错，而不是必须依赖截图的主观判断；若需要给他人看观感，仍可用系统截图（如 Windows Win+Shift+S、macOS Shift+Cmd+4）。
适用场景与注意¶
适合谁：正在开发或维护 DSH 图形界面插件的开发者，希望在同一套 DSH 进程里做 acceptance test，减少手工切页与漏看控制台。
运行权限：插件与 DSH 客户端同进程、同 Web 上下文执行自动化。安装前应阅读 GitHub 源码 与 MIT 许可证，确认行为与安全边界符合你的环境要求。
生态说明：DSH 社区插件目录（如 SkillHub 上的 dsh-ui-probe 页）由社区维护，与 DeepSeek / 幻方无官方从属关系；本文事实以仓库 README 与 package.json 为准。
结尾¶
dsh-ui-probe 把「切到插件页 → 操作 → 读样式与报错 → 回到对话」收成对话里一句话就能触发的 workflow，适合在真实 DSH 界面里验收图形插件，而不是只靠截图或人工点测。
