dsh-region-probe

在 Harness 里做界面联调时，渲染错位、区域空白或一闪而过的失败往往只能靠人盯屏或截屏，Agent 很难在真实运行环境里自行判断「画出来了什么」。dsh-region-probe 是挂在 Cordis Inspect 上的只读提供者：它不造 UI、不联网，只读取 Shell 为每个区域留下的稳定 slot 锚点，把当前 DOM 里实际出现的区域、几何与文本样本交给 Agent。

核心能力围绕三个只读方法展开。outline() 汇总页面上所有区域及其失败、空渲染与屏幕包围盒；snapshot() 按 slot 或选择器拉取某一区域的节点树（路径、角色、可见性、样式等，深度与节点数有上限）；failures() 则维护一份有界失败账本，记录某 slot 是否曾渲染失败、复发次数以及是否已恢复，弥补「只看当下快照会漏掉瞬时故障」的盲区。插件会遍历同源 iframe 与 Shadow DOM，并区分「无区域」「选择器无效」「渲染错误」等不同空结果原因；跨域 iframe 与 canvas 内绘制内容则如实说明无法读取。

适合在开发、调试 Harness 客户端或第三方插件 UI 时使用：希望让 Agent 对照真实界面做自检、定位区域级渲染问题，又不需要给它点击、写入或导航能力时，可以安装并在会话中通过 cordis_inspect 使用 Regions 提供者。请注意它会读取界面上的可见文本与样式信息，若不希望会话能读自己的界面，应在非调试环境禁用。