Skip to content

[Research Export] Export reports with citations, evidence provenance, and reproducible metadata #36

Description

@helsome

Background

Deep Research 的价值最终往往要离开应用本身:发给同事、归档、写投资笔记、进入投委会材料或后续复盘。如果导出只是把当前 DOM 截成 PDF,citation、evidence provenance、数据时间口径和 run metadata 很容易丢失。

需要把 Research Report Export 设计成 report artifact,而不是简单“另存为文本”。

Related: #13 #20 #21 #29 #30 #31

Requirements

Export formats

首版至少支持:

  • Markdown;
  • HTML;
  • PDF 或 print-ready output;
  • machine-readable JSON(用于归档/再处理)。

Content fidelity

导出需尽量保留:

  • report title / generated_at;
  • Markdown headings/lists/tables;
  • typed financial blocks 的可读 fallback;
  • inline citations;
  • source list;
  • evidence/provenance metadata;
  • financial data as_of / currency / unit;
  • run/model/config metadata 的适量摘要;
  • unsupported/conflicted/stale 等重要状态。

Citation behavior

  • Markdown/HTML/PDF 中 citation 编号与正文稳定对应;
  • Web/document source 提供可读 URL/来源信息;
  • structured financial evidence 不伪造 URL,而是导出 provider/instrument/metric/as_of 等 provenance;
  • source unavailable/drifted 时保留原始 evidence 状态。

Reproducibility

JSON export 至少能够包含 report、claims、citations/evidence refs、run manifest reference 等 machine-readable 数据,以支持未来重新导入或审计。

Privacy

Acceptance Criteria

  • 同一 Research Report 可至少导出 Markdown + HTML/PDF + JSON。
  • 表格、标题、引用、evidence 信息在导出后仍可读。
  • Web citation 和 structured financial evidence 都能正确导出。
  • financial data 的时间/币种/单位口径不会在导出中丢失。
  • JSON export 能关联 report → claim → evidence → source/run metadata。
  • reload 后再导出与原报告引用关系一致。
  • canary secret 不出现在任何 export artifact。
  • PR 必须用一份真实 Deep Research 报告完成导出 E2E,至少包含 Web 来源、金融 API evidence、表格和 citation,并附各格式产物截图/样例。

Non-goals

  • 首版不做复杂排版编辑器。
  • 不要求完全复刻应用 UI;重点是内容、证据链和可归档性。

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

claimedClaimed by a contributor and currently in progress

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions