Skip to content

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

Open

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

  1. Cordis798 commented on Sep 11, 2026

    @Cordis798

    claim

  2. github-actions commented on Sep 11, 2026

    @github-actions

    @Cordis798 已认领该 Issue,并已自动设为 Assignee。提交 PR 时请在描述中写 Closes #36。

  3. gmll-star commented on Sep 11, 2026

    @gmll-star
    Contributor

    认领

  4. github-actions commented on Sep 11, 2026

    @github-actions

    @gmll-star 这个 Issue 已经由 @Cordis798 认领。

  5. github-actions commented on Oct 19, 2026

    @github-actions

    @Cordis798 这个 Issue 已认领超过 7 天,目前没有发现关联的 open PR,也没有看到最近 7 天的进度更新。

    如果仍在推进,请在 3 天内 留一条简短进度说明(包括正在等待的前置依赖也可以);如果已经有 PR,请贴出链接。若 3 天内没有回应,认领会自动释放,方便其他贡献者接手。

  6. removed
    claimedClaimed by a contributor and currently in progress
    on Oct 23, 2026
  7. github-actions commented on Oct 23, 2026

    @github-actions

    @Cordis798 在提醒后 3 天内没有进度回应,且仍未发现关联的 open PR;本次认领已自动释放。Issue 保持开放,可以重新认领。

  8. lester076 commented on Oct 27, 2026

    @lester076

    /claim

    我准备提交一个独立的 JSON 研究报告归档导出 PR,接入现有 ExportMenu 与主进程导出通道,保留持久化报告、来源—证据—主张关联、运行身份和已有状态信息,并复用现有隐私处理。

    这个 PR 使用 Refs #36,范围为 JSON 归档这一项,HTML/打印输出等其余验收项仍保留在本 Issue。会用仓库已公开保存的真实模型生成报告验证持久化、重新加载和导出的过程,并说明记录回放与实时模型调用的验证范围。可见菜单变化会按贡献指南处理验收证据。

    OpenAI Codex 协助源码核查、实现与测试;会在 PR 中披露实际验证结果。

  9. github-actions commented on Oct 27, 2026

    @github-actions

    @lester076 已认领该 Issue,并已自动设为 Assignee。提交 PR 时请在描述中写 Closes #36。

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