技能包

d3k:让助手接管本地 Web 调试时间线

适合要让编码助手看同一条本地时间线来排错的人,须 Node.js 24+,并先装 d3k 技能和全局运行时,不要另开一套服务器或浏览器。

官方来源 · d3k

安装

bunx skills add vercel-labs/dev3000 --skill d3k --agent '*' -g -y

适合谁

d3k 面向要在本地调试 Web 应用、并让编码助手看到完整时间线的人。它会启动你的开发服务器,打开带项目稳定 Chrome 配置的受监控浏览器,并把服务器日志、浏览器错误、网络活动、交互和截图收成一条时间线。

主界面就是 d3k 技能:告诉助手你想测什么或查什么,让它接管运行时。它不适合当普通“再开一个浏览器”的脚本,也不适合你自己另起一套开发服务器再让助手去猜日志。

使用前要满足 Node.js 24 或更新版本。技能安装与运行时安装是两条命令,不要混成一句。没有 skill 支持的环境,不要套用技能安装命令。

3 分钟完成第一次尝试

技能的官方命令是:bunx skills add vercel-labs/dev3000 --skill d3k --agent '*' -g -y。仓库地址是 https://github.com/vercel-labs/dev3000 请只按这一页操作。运行时官方命令是:bun install -g dev3000。说明也写了 npm install -g dev3000 可用,但主路径按 bun 走,不要再编第三条安装器。

前置条件:本机 Node.js ≥ 24,有一个可本地启动的 Web 项目,并且你接受助手拉起受监控浏览器。技能装在助手侧(命令带 -g),运行时装在全局 dev3000 包。装完先确认助手能谈到 d3k,再决定是否启动。

低风险第一次任务:用一个可丢弃的本地应用。先明确告诉助手:以非交互方式启动 d3k,保留后台进程,复用它管理的浏览器,只查看统一证据。启动前确认端口和项目目录,避免对着生产环境。成功信号是出现一条带时间戳的时间线(日志、错误、网络或截图),且助手没有再单独打开另一套开发服务器或另一个浏览器。

若只想先确认安装,可以先问助手“如何非交互启动 d3k”,在看到它准备执行的命令后再批准。说明没有写默认端口号,也没有写如何停止进程;第一次先问停止方式再启动。

使用案例

案例一:把调试交给 d3k 技能。安装技能后,直接说明要复现的页面问题,让助手拥有运行时。适合你已经能用一句话描述“哪个页面、什么操作、看到什么错误”的时候。说明没有写固定斜杠命令,因此用自然语言即可。若助手开始自己 npm run dev 再开系统浏览器,应要求它改走 d3k。对照页是 https://github.com/vercel-labs/dev3000

案例二:装好全局运行时后,让助手非交互启动并只读时间线。技能教助手:非交互启动、保留后台进程、复用托管浏览器、检查统一证据,而不是另开服务器或浏览器。适合回归某个已知交互、需要同时看网络和截图的时候。说明没有列出时间线的文件路径或 UI 地址;因此只能做到“启动后在助手给出的入口里看证据”。未看到统一时间线之前,不要同时开第二套监控。

使用边界

版本边界:需要 Node.js 24 或更新。安装边界:技能用 bunx skills add vercel-labs/dev3000 --skill d3k --agent '*' -g -y,运行时用 bun install -g dev3000(npm 也可以)。没有 skill 支持就不要套用前一条。使用边界:主界面是告诉助手目标,让它接管运行时;应复用托管浏览器和统一时间线,不要另开服务器或浏览器。范围边界:它覆盖本地开发服务器、受监控浏览器、日志、错误、网络、交互和截图;说明没有写远程环境或生产探测。停止与端口细节未展开,第一次先问清楚再启动。