用途:排查已安装的 DSH Web 插件仅在浏览器运行时出现的异常,如粘贴/附件/输入框功能首次可用后失效、标签或面板消失、移除按钮留下占位符、更新标签显示错误版本等。
主要能力:强调先读宿主源码中相关方法的契约(文档注释、守卫、比较类型),而非依赖 API 名称。提出四个关键问题:偏移量针对哪个字符串计数;各表示形式中一个“单位”的宽度是否一致;布尔返回的动词静默失败时谁负责感知;哪一引擎执行该行代码。
使用方式:先复现一次并记录用户可见字符串,映射到发出该字符串的代码路径,打开宿主源码回答四个问题,精确陈述不匹配后再修复。若问题不在控制台可见,需在受控浏览器中用临时插桩的 bundle 复现,参考 references/browser-forensics.md。修复所有传递表示相关值的调用点,并用失败过的交互序列验证。
适用场景:DSH Web 插件运行时调试,包括 URL 自定义 scheme 解析差异、插槽组件抛错导致整块 UI 消失、链接安装模式下 EBUSY、客户端 bundle 含裸 ESM 导致全部插件失效、终端精灵半块 ANSI 渲染残影、进程挂起等。
限制:资料未提供具体安装命令、收费信息或平台支持范围;部分细节依赖 DSH 源码树与特定浏览器版本,需自行验证。