SuperAPI AI 工具集

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

编程与开发

查看项目

更新于 10-16 04:04

技能介绍

用途 该技能面向开发者调试场景:将数据、日志、HTML/文本内容或图表直观地发送并显示在 Ray 桌面应用中,也可用于预览设计、Logo 或其他可视化内容。其底层原理与 ray() PHP 函数相同,即向 Ray 的本地服务器发起 HTTP 请求。

主要能力 通过 HTTP 请求向 Ray 发送多种载荷(payload):

  • log:发送一组值(values 数组)。
  • custom:发送 HTML 或文本内容,可带 label。
  • table:以表格形式展示 values,可带 label。
  • color:为前一条日志条目设置颜色,可选 green、orange、red、purple、blue、gray。
  • screen_color:设置屏幕背景色。
  • label:为条目添加标签。
  • size:设置条目尺寸,可选 sm、lg。
  • notify:发送桌面通知。
  • new_screen:创建新屏幕。
  • measure:性能计时,包含 name、is_new_timer、total_time、time_since_last_call、max_memory_usage_during_total_time、max_memory_usage_since_last_call 等字段;后续测量将 is_new_timer 设为 false 并提供实际计时值。
  • 简单载荷(仅需 type 与空 content):separator(分隔线)、clear_all(清空全部条目)、hide(隐藏该条目)、remove(移除该条目)、confetti(彩带动画)、show_app(将 Ray 置于前台)、hide_app(隐藏 Ray 窗口)。

使用方式 连接信息:Host 默认 localhost(环境变量 RAY_HOST),Port 默认 23517(环境变量 RAY_PORT),URL 为 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)。每个 payload 需包含 origin,即 file、line_number、hostname。 可在一次请求中发送多个载荷;配合相同 uuid,用 color、label、size 等修饰前一条日志条目。 可用性检查:GET http://localhost:23517/_availability_check,Ray 返回 HTTP 404 表示服务在运行(该端点不存在,但服务器可用)。 获取窗口:GET http://localhost:23517/windows,返回窗口对象数组(id 与 name)。 获取主题:GET http://localhost:23517/theme,返回主题信息与配色(如 name、colors 中的 primary、secondary、accent)。发送自定义 HTML 时可使用这些配色,使内容与 Ray 当前主题保持一致、视觉统一。

适用场景 调试应用程序、输出日志数据、可视化数据结构、以表格方式查看数据、预览 HTML 或设计内容、给日志添加颜色与标签以便区分、用桌面通知提示任务完成、用 measure 计时与内存信息进行性能观察,以及通过彩带、分隔线等增强调试会话的直观性。

限制 需在本地运行 Ray 桌面应用,并通过 localhost:23517 或对应环境变量配置的地址访问;文中未提供安装方式、收费或价格、可用平台及其他使用步骤,相关事实暂未提供。