dsh-tool-browser

在 Harness 里用工具读网页，最难的不是「能不能抓到 HTML」，而是三件事叠在一起：等错了会把加载动画当正文；抽正文时导航和页脚悄悄混进来；真浏览器挂了却静默退回静态抓取，你以为拿到的是渲染后的页面。dsh-tool-browser 把打开、等待、抽取、截图做成一组彼此衔接的能力，并且每次都会告诉你当前用的是哪种引擎。

等待不是单一概念：DOM 就绪、资源加载完、网络安静、或等到某个选择器出现——选错策略，轮询页面会永远等不到 networkidle，而你要的元素其实早就到了。正文抽取不靠猜标签名，而是按正文密度给候选子树打分：链接比例、分段程度、标点密度一起衡量，容器因为夹着杂物密度更低，自然会输给真正的正文块；剥导航、侧栏、评论等杂物在打分之前完成，避免链接农场误胜。

三个工具覆盖常见工作流：browser_status 零成本确认浏览器与默认策略；browser_fetch 取整页 HTML 并可落盘，mode 是承诺而非偏好；browser_extract 输出 text 或 Markdown，并返回选中子树与得分便于诊断；browser_screenshot 只走真浏览器，没有静态兜底。Playwright 是可选依赖，没装时 fetch 与 extract 仍可用，截图会明确报错而不是给一张空图。

适合需要把网页内容喂给 Agent 的开发者与编辑：要读 JS 渲染后的页面、要可控的等待策略、要可复现的正文而不是整页噪音，又希望引擎切换时行为可预期、可解释。