Skip to content

Latest commit

 

History

History
36 lines (22 loc) · 3.5 KB

File metadata and controls

36 lines (22 loc) · 3.5 KB

独立的数据与资料来源清单

默认交付

写成完整报告时同步交付《报告题名.docx》和《报告题名—数据与资料来源清单.docx》。用户只要选题、提纲或问卷时不强制生成整套报告;用户明确指定其他交付形式时优先遵从。没有引用外部事实的稿件也应说明证据范围,不为填满清单编造来源。

来源包括统计数据、政策文件、案例事实和引用研究;写作过程中持续整理,不在成文后凭印象补链接。正文用10磅上标〔1〕、〔2〕,同一来源重复使用沿用同号,标在它实际支撑的表述后,避免一段多项事实只笼统标一个来源。清单编号正常显示。

每条记录包含编号、材料名、发布机构或提供方、发布日期或材料时间、正文对应的数据/判断、原文链接和访问日期。无日期时如实写“原文未注明”,不猜日期。优先原始发布页面;链接可点击,且显示完整网址。未查阅原文不能记作已核验,搜索摘要只作线索。

内部材料注明提供方、材料时间、适用范围,不伪造公网链接;注意脱敏,不公开私人附件路径或用户敏感信息。推算结果记录原始数据及来源、计算方法、单位、口径与限制,不将推算说成官方直接发布值。来源存在不等于判断被证明,仍需审查代表性、因果与适用边界。

统一输入与生成

使用一个 UTF-8 JSON 保存 report 与 sources。report 沿用格式合同;sources 中 id 为正整数,kind 取 public、internal、derived。所有类型要求 title、publisher、date、supports;supports 为该来源所支撑正文片段的原文列表(不含引用编号)。

  • public 额外要求 url(HTTP/HTTPS 原文链接)、accessed(实际访问日期)。
  • internal 不填 url,按需以 limitations 说明提供范围与核验状态。
  • derived 额外要求 basis(基础数据、来源及口径)、calculation(公式、单位及计算过程);基础公开资料可在正文同时引用并单列 public 来源。
  • 所有类型可填 limitations;正文段落或表格单元格 text 中用〔id〕关联来源,不在标题、署名或问卷选项中放事实引用。

参见 examples/report-with-sources.json,这是明确标注为虚构的格式测试资料,不得作为真实报告证据。

python scripts/build_report_bundle.py input.json report.docx sources.docx
python scripts/validate_report_docx.py report.docx
python scripts/validate_report_docx.py sources.docx

生成器检查重复编号、缺少来源、未被引用的记录、supports 与对应引文段落不匹配、公开链接字段及推算说明;任一输出存在时默认拒绝覆盖,明确重建整套文件时用 --force。旧 build_report_docx.py 保留为单文档排版工具,不能以其成功代替配套来源文件交付。

正文删改后同步修改同一份 JSON,重新生成两个文件,不沿用旧来源清单。数字相同不代表来源相同,不按数据值去重。每条来源的 supports 应明确到具体数据或判断,不能只写整章标题。

验收

两个文件分别通过结构校验、逐页视觉检查。引用上标字号正确,来源网址可点击且不越界。逐条核对“表述—来源—日期与口径”;脚本只检查结构和关联,不会自动证明页面内容真实、链接当前可访问或证据足以支持结论。无联网或其他能力受限时如实标明未完成事项,不虚报终稿。