技术附录

§ 01

Evidence Identity · 60 个唯一 evidence_ref

R2.1 引入研究展示层唯一 evidence_ref WC124575:PAGE<page_id>,与 page_id 一一对应,collision_count = 0。Legacy citation_id SHUGE:p124575:<seq> 保留为次级 pointer。

• total_page_ids = 60
• unique_evidence_refs = 60
• collision_count = 0 ✓
• unique_legacy_citation_ids = 5 (因 seq 仅 1-5)
• max_pages_per_legacy_citation = 14 (seq=1/2/3/4)

1.1 Reliability 分布

• BODY_TEXT: 36
• MIXED_PARTIAL_BODY: 3
• BLANK_OR_HEADER_ONLY: 19
• UNCLASSIFIED: 2 (page_id=1862, 2320 — duplicate_pages 中列出, 未明确分类)

§ 02

9 个 River Evidence Groups

基于 R1 substantial pages 的 body OCR 文本,建立 9 个 river evidence groups (spec 要求 ≥ 5):

river_group_count = 9 · 3 SUPPORTED + 3 PARTIALLY_SUPPORTED + 3 NOT_SUPPORTED。

§ 03

9 个 Historical Places

spec-required 9 个历史地名,在 substantial pages body OCR 中均得到 SUPPORTED 确认。modern_equivalent_status = UNRESOLVED。

§ 04

60-Page Audit

R2 阶段对 60-page sample 进行的页级结构审计结果:

§ 05

Volume / Scan Sequence 分析

5.1 卷次身份 UNRESOLVED

60 个 page_id 共享 5 个 unique page_label (p0001–p0005)。每个 page_seq 值出现在 12–14 个不同 page_id 中。按研究完整性原则:不虚构卷次。source platform (国立公文書館 / 内閣文庫) 未提供 page_id → scan_run metadata。

5.2 扫描序列映射 UNRESOLVED

每个 page_seq 值 (1–5) 出现在 12–14 个不同 page_id 中。例如 SHUGE:p124575:4 同时指向:

• WC124575:PAGE1504
• WC124575:PAGE1594 · 河水_野王_修武 (r2-cl-002)
• WC124575:PAGE1657 · 易水_范陽_容城 (r2-cl-003)
• WC124575:PAGE1714
• WC124575:PAGE1795 · 渭水_關中 (r2-cl-006)
• WC124575:PAGE1865 · 易水_范陽_容城 (r2-cl-003)
• WC124575:PAGE1937
• WC124575:PAGE2005 · 汾水_代城 (r2-cl-004)
• WC124575:PAGE2079 · 汝水_霍陽_梁 (r2-cl-005)
• WC124575:PAGE2135
• WC124575:PAGE2207
• WC124575:PAGE2267
• WC124575:PAGE2323 · 江水_公安_华容 (r2-cl-001)
• WC124575:PAGE2391

page_id → scan_run 映射缺乏元数据。无法判断 page_id=2323 与 page_id=2391 是否来自同一扫描批次。

§ 06

全部 6 条 Evidence-first Claims

R2 阶段共 6 条 evidence-first claims,分布 (R2.1 修正):

• TOTAL = 6
• SUPPORTED = 4 · 已支持 (r2-cl-001, r2-cl-003, r2-cl-004, r2-cl-005)
• PARTIALLY_SUPPORTED = 2 · 部分支持 (r2-cl-002, r2-cl-006)
• NOT_SUPPORTED = 0 · 暂不支持
• METADATA_ONLY = 0 · 禁止进入

r2-cl-001 · RQ1 · 江水 + 公安 / 華容

support_status: SUPPORTED

evidence_ref: WC124575:PAGE2321 · WC124575:PAGE2322 · WC124575:PAGE2323

citation_ids: SHUGE:p124575:2 · SHUGE:p124575:3 · SHUGE:p124575:4

page_ids: 2321, 2322, 2323

r2-cl-002 · RQ2 · 河水 + 野王 / 修武

support_status: PARTIALLY_SUPPORTED

evidence_ref: WC124575:PAGE1593 · WC124575:PAGE1594

citation_ids: SHUGE:p124575:3 · SHUGE:p124575:4

page_ids: 1593, 1594

r2-cl-003 · RQ3 · 易水 + 范陽 / 容城 / 故安城

support_status: SUPPORTED

evidence_ref: WC124575:PAGE1655 · WC124575:PAGE1656 · WC124575:PAGE1657 · WC124575:PAGE1865

citation_ids: SHUGE:p124575:2 · SHUGE:p124575:3 · SHUGE:p124575:4 · SHUGE:p124575:4

page_ids: 1655, 1656, 1657, 1865

r2-cl-004 · BONUS · 汾水 + 代城

support_status: SUPPORTED

evidence_ref: WC124575:PAGE2004 · WC124575:PAGE2005

citation_ids: SHUGE:p124575:3 · SHUGE:p124575:4

page_ids: 2004, 2005

r2-cl-005 · BONUS · 汝水 + 霍陽山 / 梁

support_status: SUPPORTED

evidence_ref: WC124575:PAGE2077 · WC124575:PAGE2078 · WC124575:PAGE2079

citation_ids: SHUGE:p124575:2 · SHUGE:p124575:3 · SHUGE:p124575:4

page_ids: 2077, 2078, 2079

r2-cl-006 · BONUS · 渭水 + 關中

support_status: PARTIALLY_SUPPORTED

evidence_ref: WC124575:PAGE1793 · WC124575:PAGE1795

citation_ids: SHUGE:p124575:2 · SHUGE:p124575:4

page_ids: 1793, 1795

§ 07

Machine IDs 参考

7.1 Canonical Work IDs

• post_id = 124575 (国立公文書館 / 内閣文庫)
• work_id 错配: 168491 = 《园冶》 (Ming garden design by 计成, 1635) — v1.0 article 引用此为《水经注》,已纠正
• institution = 国立公文書館 / 内閣文庫 (Japan's National Archives, Cabinet Library 数字化)
• digital_object_type = scanned volume

7.2 引用 ID 格式

• evidence_ref (R2.1 新主级) = WC124575:PAGE<page_id> · 例: WC124575:PAGE2321
• citation_id (legacy, R1 contract) = SHUGE:p124575:<seq> · 例: SHUGE:p124575:3
• page_object_id (legacy) = p124575:p<seq> · 例: p124575:p3
• page_label = p000N · 例: p0003
• support_status (machine code) = SUPPORTED / PARTIALLY_SUPPORTED / NOT_SUPPORTED

7.3 JSON Schema

• page-structure-r2/1.0 — water_classic_page_structure_r2.json
• evidence-claims-r2/1.0 — water_classic_evidence_claims_r2.json
• river-evidence-groups-r2/1.0 — water_classic_river_evidence_groups.json
• historical-places-r2/1.0 — water_classic_historical_places.json
• evidence-identity-r2_1/1.0 — water_classic_evidence_identity_r2_1.json (新增)

7.4 Frozen Baseline SHA

• v1.0_frozen_baseline_sha = 3a51ef5e698655c215a1f36147d24bfe8c7e6826 (NOT modified in R2 / R2.1)
• v1.0_dossier_sha256 = da4fd267d64f2ae67ac8c3594962c2cd60fdce41f8d03896fb7a8ae27cc10f80 (verified unchanged)

§ 08

Source Downloads

所有源文件均可通过 raw GitHub URL 下载。R1 frozen outputs 与 R2.1 新增 outputs 分开列出。

8.1 R2.1 新增

• water_classic_evidence_identity_r2_1.json · evidence identity (60 refs, collision 0)
• EVIDENCE_IDENTITY_AUDIT_R2_1.md · audit markdown

8.2 R2 frozen outputs (frozen at 3883455b)

• water_classic_page_structure_r2.json
• water_classic_evidence_claims_r2.json
• water_classic_river_evidence_groups.json
• water_classic_historical_places.json
• WATER_CLASSIC_PAGE_STRUCTURE_R2.md
• WATER_CLASSIC_R2_RESEARCH_QUESTIONS.md

8.3 R1 frozen outputs (frozen at 59d258e, 不可修改)

R1 页面:/projects/shuge/research/water-classic-evidence-r1/ · R1 路由保留

§ 09

R1 / R2 / R2.1 版本历史

• R2.1 · 《水经注》数字证据研究 · Evidence Identity + zh-CN focused interfaceSPEC RUN
• R2 · 《水经注》数字证据研究 · Page Structure + River Groups + Places + Claims3883455b
• R1 · Water Classic Evidence Reconstruction Publication59d258e
• v1.0 Cleanup R1 · Metadata reconciliation + PROVENANCE_AUDIT3a51ef5
• v1.0 Candidate · First Real Scholarly Output7738275
• v0.9 Public Research Portfolio39a6ec1
• v0.8 Publication & Scholarly Output7477743
• v0.7 Research Writing Environment4fa8802
• v0.6 Research Graph & Project Pagesfbb5eb3
• v0.5 Research Workspacec32cff0
• v0.4 Evidence Explorer7abe6ae
• v0.3 Rooms + Case Studiesc2e6f1d
• P5-D · Frozen Research Databasef70fd97
• P5-Ca815475

§ 10

R2.2 三层证据状态 (HTML editorial layer)

主页面引入三层证据状态(文本支持 / 空间解释 / 现代对应)作为公开编辑层。这是一个 HTML-only editorial layer,没有新增 JSON schema,原 claims dataset (r2-cl-001..006) 的 machine status 字段保持不变。

10.1 三层状态 · 1-to-1 中文 ↔ machine status 映射

10.2 三组核心证据 · 三层状态矩阵

10.3 三层状态的设计意图

• 文本支持:当前 60-page sample 中,目标水系与城邑是否在真实 body OCR 中出现文本共现。
• 空间解释:基于现有片段,是否足以读出方向或上下游等空间描述;若需要全页 OCR 才能确认,标记为待确认。
• 现代对应:古代水系 / 城邑与现代地理(长江 / 黄河 / 现代坐标)是否对应。本轮统一标记为未确认。

主页面不再使用单一的 SUPPORTED / PARTIALLY_SUPPORTED / NOT_SUPPORTED,而是把研究表达强度拆成三层,使公开页面的"可以确认"严格匹配"证据支持强度"。

10.4 核心发现技术史 (主页面已下沉)

• canonical SHUGE work record = post_id 124575 (R1 阶段校正:此前误将 work-shuge-168491 标为《水经注》,实际是《园冶》。)
• page_label 仅有 5 unique seq (p0001..p0005),无法作为 page-level pointer,故 R2.1 引入 WC124575:PAGE<page_id> 作为唯一 evidence_ref。
• v1.0 frozen baseline (3a51ef5) · R1 frozen (59d258e) · R2 frozen (3883455b) · R2.1 frozen (fda2ecb) 均未修改。

10.5 三个研究问题 (内部编号,主页面已下沉)

• RQ1 — 江水沿岸的 公安 与 華容
• RQ2 — 河水叙事中的 野王 与 修武
• RQ3 — 易水流域的 范陽 / 容城 / 故安

研究问题编号属内部范畴,主页面已不展示。读者可通过本附录查阅 RQ ↔ 三层状态 ↔ linked claim 的对应关系。