Output Cards 是 Research-Claw 仪表盘所使用的一套结构化输出卡片 JSON schema 参考文档,旨在为 Agent 撰写的卡片语义提供统一的格式规范。该 schema 覆盖 6 种结构化输出卡片类型。
使用方式方面,文档要求使用围栏代码块,并以卡片类型作为语言标签,且该方式仅适用于 Agent 撰写的卡片语义。卡片内容必须是合法的 JSON,因为仪表盘解析器使用 JSON.parse() 进行解析。Research-Claw 会自动呈现成功的 Workspace 文件事实以及受支持的原始文献结果;不应仅为让这些卡片出现而复制工具 JSON。对于非仪表盘渠道,应将普通路径和安全链接保留在周边文本中。
各卡片类型定义如下:
paper_card:仅用于 Agent 特意突出显示的真实学术出版物,来源可包括 API 查询、library_search 或用户指定的论文。绝不用于概念、工具、非学术内容或每一次原始搜索命中。原始结果仅表示被检索到,围栏并不能证明其已被阅读、引用、保存或验证。必填字段为 type、title、authors(字符串数组)。可选字段包括 venue、year、doi、url、arxiv_id、abstract_preview、read_status(取值为 "unread"|"reading"|"read"|"reviewed")、library_id、tags。
task_card:必填字段为 type、title、task_type(取值为 "human"|"agent"|"mixed")、status(取值为 "todo"|"in_progress"|"blocked"|"done"|"cancelled")、priority(取值为 "urgent"|"high"|"medium"|"low")。可选字段包括 id、description、deadline(ISO 8601 格式)、related_paper_title、related_file_path。
progress_card:必填字段为 type、period、papers_read、papers_added、tasks_completed、tasks_created。可选字段包括 writing_words、reading_minutes、highlights(最多 5 条)。
approval_card:必填字段为 type、action(字符串)、context(字符串)、risk_level(取值为 "low"|"medium"|"high")。对于执行类审批,还需必填来自 exec.approval.requested 的 approval_id,否则仪表盘按钮将无法使用。可选字段为 details,且必须是 JSON 对象而非字符串,例如 {"paper_count": 7}。
file_card:成功的 workspace_save、workspace_export、workspace_append 和 workspace_download 结果会被自动呈现。应在正文中说明普通的工作区相对路径,无需使用围栏。旧式围栏仍然兼容,但绝不应虚构路径。
monitor_digest:必填字段为 type、monitor_name、source_type(自由格式)、target、total_found、findings(由 {title, url?, summary?} 组成的数组,最多 10 条)。可选字段为 schedule。
适用场景为 Research-Claw 仪表盘环境中的结构化卡片输出与呈现。关于收费、价格、平台或效果等信息,资料中暂未提供。