编写工具可以修改页面并构建它,但这并不能证明页面已加载、交互正常、浏览器无错误,或者结果与预期匹配。dsh-live-loop 为已安装的 DeepSeek Harness Agent 提供了一个连贯的运行时循环。
这是什么¶
这是 DeepSeek Harness 前端运行时验证插件。它让 Agent 能够检测、运行、预览、交互、视觉对比并验证 Web 应用,同时生成持久证据。
- 维护者:POWERRRRRRRR
- 许可证:MIT
- 定位:处理开发服务器生命周期、隔离的浏览器状态、结构化观察、交互、验证和持久证据。它不编辑应用程序代码;DSH 的正常编码工具仍然负责代码修改。
安装与启用¶
从 GitHub 克隆仓库并安装到 web profile。
git clone https://github.com/POWERRRRRRRR/dsh-live-loop.git
cd dsh-live-loop
npm ci --legacy-peer-deps
npm run build
npm pack --ignore-scripts
dsh plugin --profile web add ./dsh-live-loop-1.0.0.tgz
安装完成后,重启 web profile 以确保插件生效:
dsh --profile web web
核心功能¶
- 全流程闭环:检测、运行、预览、交互、视觉对比、验证,全程带有持久证据。
- 结构化检测:支持 Vite、React、Vue、Next.js、通用脚本及 Monorepo,提供明确的歧义解析,避免静默选择错误的运行目标。
- 进程所有权:通过公共 DSH 子进程所有权实现 argv-only 执行,包含有界日志和清理机制。
- 隔离环境:每个 DSH 主题拥有一个独立的 BrowserContext。
- 有界观察:支持 HMR、WebSocket、SSE 和轮询的有界观察窗口。
- 证据管理:生成 DSH Attachment 截图,并附带 Reference(参考)、Current(当前)和 Diff(差异)证据。
- 严格判定:使用严格的四态判定机制,拒绝将缺失的观察结果转化为通过。
- 原生集成:提供原生的 DSH Web Live Preview、Verification Card 和 Settings 面板。
- 诊断能力:在验证失败时提供诊断信息,明确告知 Agent 需要修复的内容。
典型用法¶
Agent 可以通过工具调用完成验证流程。例如,修复表单并验证特定行为:
Fix the form, start or reuse the detected app, fill the Name textbox with Ada,
press Enter, assert that “Hello, Ada!” appears, and do not finish until
live_loop_verify returns VERIFIED with screenshot evidence.
典型的失败处理循环如下:
first verify: FAILED
→ inspect Console / Network / DOM / assertion / visual diff
→ edit the application
→ reload or let HMR apply
→ verify again: VERIFIED
→ deliver the report and evidence
适用场景与注意¶
- 环境要求:需要 DeepSeek Harness 版本
0.1.0-rc.7,Node.js 版本^22.19.0或>=24。 - 代码编辑:插件本身不编辑应用代码,DSH 的编码工具对此负责。
- 证据权重:视觉相似性是支持性证据,绝不覆盖页面加载、诊断、交互或断言的结果。
总结¶
dsh-live-loop 通过将浏览器操作和验证逻辑封装为 DSH 的工具,为前端智能体提供了可复用的运行时验证能力。它确保了验证过程的严谨性和结果的确定性,是构建可靠前端自动化流程的必要组件。
- GitHub:https://github.com/POWERRRRRRRR/dsh-live-loop
- 目录:https://www.skillhub.cn/plugins/POWERRRRRRRR/dsh-live-loop