SuperAPI AI 工具集

debugging-output-and-previewing-html-using-ray

测试与质量

查看项目

更新于 10-15 20:28

技能介绍

用途:该技能说明如何通过向 Ray 本地服务器发送 HTTP 请求,把调试数据、日志、表格、HTML 内容或图表发送到 Spatie 的桌面调试应用 Ray 中查看。适用于调试应用、预览设计或 logo 等视觉内容,也是 PHP 中 ray() 函数底层所做的事。

连接方式:默认主机 localhost(环境变量 RAY_HOST),端口 23517(RAY_PORT),地址 http://localhost:23517/。请求方法为 POST,Content-Type 为 application/json,User-Agent 为 Ray 1.0。

请求结构:请求体包含 uuid(Ray 实例唯一标识,复用同一 uuid 可更新已有条目)、payloads(载荷数组)和可选 meta(如 ray_package_version、project_name、php_version)。每个载荷含 type、content 和 origin(file、line_number、hostname)。

主要载荷类型:log 发送值;custom 发送 HTML 或文本内容;table 以表格展示;color 设置条目颜色(green、orange、red、purple、blue、gray);screen_color 设置屏幕背景色;label 添加标签;size 设置大小(sm、lg);notify 发送桌面通知;new_screen 新建屏幕;measure 记录性能计时;separator、clear_all、hide、remove、confetti、show_app、hide_app 等无内容载荷。可在一次请求中发送多个载荷,用同一 uuid 让 color、label、size 等修饰符作用于日志条目。

可用性检查:GET http://localhost:23517/_availability_check,服务器运行时返回 HTTP 404。获取窗口信息:GET http://localhost:23517/windows。获取主题颜色:GET http://localhost:23517/theme,可用于让自定义 HTML 内容与 Ray 当前主题匹配。

限制:资料未提供安装步骤、收费方式、支持平台及更多使用限制。