Skip to main content

概述

Artifacts 是一种结构化的工具返回格式,用于在 Trajectory 区域渲染丰富的内容(HTML、代码、Diff、图表等),而不是显示原始文本。渲染采用 VSCode 浅色风格,使用 Prism.js 语法高亮和行号。

问题背景

当前工具返回的结果存在以下问题:
  1. 格式不统一:不同工具返回格式各异
  2. 前端解析困难:依赖正则表达式检测内容类型
  3. 渲染受限:无法区分可渲染内容和普通文本
  4. 扩展性差:每新增一种类型都需要修改前端检测逻辑

数据结构设计

ToolResultContent

工具返回内容的结构化表示,包含以下字段:

ToolResult

标准工具返回格式:

SandboxFile

沙盒操作返回的文件元数据:

内容类型说明

Diff 渲染

对于 editwrite 工具的返回结果,当存在 meta.old_content 时,前端会渲染 DiffPreview 组件而非标准 Artifact 渲染器,提供类 Cursor 的统一 diff 视图。

工作原理

  1. 后端write 工具在覆写前读取文件的旧内容,edit 工具在应用修改前捕获原始文件内容。两者都将旧内容存储在 content.meta.old_content 中。
  2. 前端WorkspaceArea 组件检测到 edit/write 结果包含 meta.old_content 时,使用 react-diff-viewer-continued 渲染 DiffPreview,并基于文件扩展名进行 Prism.js 语法高亮。
  3. 降级方案:对于 meta.old_content 不可用的 edit 调用,前端降级为对比 parameters.old_stringparameters.new_string(片段级 diff)。

ToolCallCard 上的 Diff 统计

工具调用完成后,ToolCallCard 头部会显示行内 diff 统计(+N / -N),由新旧内容计算得出。用户可一目了然地了解增删的代码量。

前端渲染

前端根据 content.type 字段选择对应的渲染组件:
  • HTML:沙盒 iframe 预览,支持设备宽度预设(桌面/平板/手机)和部署功能
  • Markdown:完整 Markdown 渲染器
  • Code:VSCode 风格浅色表格布局,带行号、Prism.js 语法高亮、长文件(>20 行)可折叠
  • JSON:与代码相同的表格布局,JSON 专属高亮
  • Image:直接 <img> 显示
  • Error:红色错误样式
  • Diff(edit/write):统一 diff 视图,增删行高亮

Raw 模式

工作区支持在 PreviewRaw 模式间切换。Raw 模式以 Prism.js 高亮 JSON 显示参数和结果,Section 头部带复制按钮,取代了之前基于 Monaco Editor 的方案,更轻量、渲染更快。

向后兼容

  • 前端同时支持新旧格式
  • 旧格式(纯文本)会被包装为 type: "text" 的 content
  • 渐进式迁移,不影响现有功能