《方志数据标注手册》框架 V1.0

定位:面向社内资深编辑(非技术背景)的操作指南,不是给工程师看的技术文档。 核心目标:让不懂数据库的老编辑,在2周内达到”双人独立标注一致率≥95%”的验收线。 配套文件:附件A《事件类型受控词表》、附件B《P0指标模板全集》、抽取流水线提示词模板包(另行交付)。 版本纪律:V1.0冻结期90天,本手册只补案例、不改规则;规则变更须本体负责人+首席编辑双签。


〇、写在最前面:致各位编辑老师

您手里这本手册,不是让您学编程,也不是让您背字段名。它是把您几十年读志、修志、审志的经验,翻译成机器能听懂的话。

机器抽出来的东西对不对,只有您能判。您的判断就是数据质量的天花板。

手册里所有规则,都来自您熟悉的志书体例与记述习惯。遇到规则和您的经验冲突时,以您的经验为准,但请标记”待裁”而不是自行变通——我们会据此修订规则,而不是让您适应一条错的规则。

这本手册会随试抽取不断长厚。您每一次”待裁”标记,都是在帮它长大。

一、手册结构总览(7章 + 4附录)

标题内容性质阅读对象预计用时
1我们在做什么项目意义、数据产品形态、编辑的角色全员必读30分钟
2标注工作台使用界面操作、快捷键、提交/待裁/异议流程标注员1小时(含上机)
3核心概念速查六类实体、事件vs观测、溯源锚点、置信度、时态标注员1小时
4分类判定流程主章:从原文到event_type的决策树+30条判例标注员反复查阅
5字段填写规范measures各字段的填写口径、模糊值处理、单位换算标注员按类目查阅
6质检与校准自检清单、双人校准流程、待裁处理、异议申诉标注员+质检员首次通读+日常查阅
7敏感内容处理GA0304/MI0405/SO0903/PE0804的分级流程标注员+审核员30分钟
A受控词表速查卡62个二级类目一页纸索引+消歧规则摘要桌面常备
B古今对照速查朝代纪年换算、度量衡换算、政区层级对照桌面常备
C30条种子判例集每条例子=原文+标注结果+判定理由+易错点培训教材
D常见问题FAQ试抽取阶段积累的真实问题(动态更新)日常查阅

二、各章内容要点与设计意图

第1章 我们在做什么(解决”为什么要这样标”)

  • 1.1 一句话讲清项目:”我们把志书变成可查询、可计算、可卖给保险/研究/AI公司的结构化数据集,您的标注就是数据集的质量底线。”
  • 1.2 数据产品的样子:展示水灾事件数据集demo截图、建置沿革时间轴可视化、人物关系图谱——让编辑看到自己标的东西最终长成什么样(看见产出,才有质量感);
  • 1.3 编辑 vs 机器 的分工边界:机器做初抽(准确率约60—70%),编辑做复核与裁决(目标是95%+);编辑不是给机器纠错,是在定义”什么叫对”
  • 1.4 标注成果的去向:L1知识层→数据集产品→客户付费→反哺加工业务→更多志书进入标注循环(闭环叙事,避免”标完就散”的项目制心态)。

设计意图:老编辑最容易产生的抵触是”我又不是程序员,为什么要干这个”。本章不回避这个问题,直接把”为什么是你”讲透。

第2章 标注工作台使用(解决”怎么点”)

  • 2.1 界面三区布局:左=原文图像+OCR文本(可缩放、可跳转页码);中=标注表单(实体/字段/值);右=上下文面板(同段其他已标实体、关联事件预览);
  • 2.2 核心操作:选中文本→创建实体→填字段→绑定溯源→提交/存草稿/标待裁;
  • 2.3 快捷键表(一页纸):Tab切换字段、Ctrl+S暂存、F1调出当前字段帮助、Ctrl+Z撤销;
  • 2.4 待裁与异议按钮这两个按钮的使用频率是健康度指标——用得少说明规则不清或编辑不敢标;用得多说明规则需要修订。本章明确告诉编辑:”标待裁不是能力不足,是负责任。”
  • 2.5 上机练习任务:用3条预置样例走完提交流程,不计入正式标注。

设计意图:工具恐惧是老编辑的第一道坎。本章只做最小必要操作教学,不讲原理;复杂功能(批量操作、高级检索)放到进阶培训,不在V1.0手册出现。

第3章 核心概念速查(解决”这些词是什么意思”)

志书语言类比解释技术概念,禁止直接用技术术语定义:

技术概念志书语言类比一句话解释
实体(Entity)志书里的”条目”一个可被单独指称的人、地、事、物、机构、数值
事件(Event)大事记里的一条有明确时间点、涉及主体、产生变化的记述单元
指标观测(Observation)食货志里的一行数字某时某地的某个数值记录,本身不构成事件
溯源(Provenance)注释里的出处这条数据从哪部志书哪一页哪一段来的
置信度(Confidence)审校时的”存疑”标记这条数据有多可靠,分AI初抽/人工初检/专家定稿三级
时态(Temporal)建置沿革里的”某年至某年”关系和属性都有有效期,不是永恒的
不确定度(Uncertainty)“约””不详””一说”原文本身的模糊性,如实记录,不伪造精度
异说(Conflict)新旧志书的矛盾记载不裁决,并存呈现,让下游用户自己判断

设计意图:概念对齐是后续所有规则理解的前提。用类比而非定义,降低认知负荷;每个概念配一个志书原文例子,让抽象落地。

第4章 分类判定流程(主章,解决”这条算哪类”

这是整本手册的核心,采用决策树+判例双层结构

4.1 五步决策树(从原文到event_type)

Step 1: 这条记述有没有明确时间点?
   → 无时间点且为静态描述 → 不是事件,归地点/机构属性或指标观测
   → 有时间点(含模糊时间)→ Step 2

Step 2: 这条记述的主体是什么?
   → 灾害现象 → ND大类
   → 政区/地名变化 → AD大类
   → 工程营建废毁 → EN大类
   → 人物生平节点 → PE大类
   → 制度/政策/会议 → GA大类
   → 战事/驻防 → MI大类
   → 经济生产变动 → EC大类
   → 文教科技活动 → CU大类
   → 社会民生事件 → SO大类
   → 无法判断 → 标"待裁"

Step 3: 在大类内,按附件A词表的"收录边界"匹配二级类目
   → 匹配成功 → Step 4
   → 匹配多个 → 走消歧规则R1-R7(见4.2)
   → 都不匹配 → 标"待裁"

Step 4: 检查是否为附属信息(R3规则)
   → 是灾后赈济/重建等附属记述,且无独立规模数据 → 回填主事件的measures,不单建事件
   → 有独立规模、独立成段 → 建独立事件,挂caused关系

Step 5: 确认时代适用性
   → 按志书断限核对附件B模板的时代标记,禁用不适用字段

4.2 消歧规则实操版(把附件A第三节改写为编辑语言)

每条规则 = 规则表述 + 正反例各1条 + 常见误判提醒

示例(R3 附属信息不独立建条):

规则:灾害条文里附带一句赈济信息,没有独立的粮款数额、施赈机构、持续时间等规模数据时,不单独建SO0902事件,而是填到主灾事件的relief_attached字段里。

✅ 正确:“光绪三年大旱,饥民流徙,知县某某设粥厂三处赈之。” → 赈济信息填入ND0102的relief_attached,不单建SO0902。 ❌ 错误:同上原文,单独建了一条SO0902事件。

✅ 正确:“光绪三年大旱……冬,巡抚奏请拨银五万两,设局于城南,自十一月至次年二月,日赈三千人。” → 有独立规模(银数、局址、时长、日赈人数),建独立SO0902,挂caused→ND0102。

⚠️ 常见误判:看到”赈””恤””蠲”就建SO0902。关键词不是判定依据,规模数据和段落独立性才是。

4.3 30条种子判例索引(附录C的导读)

按类目分组,每条判例标注:

  • 难度星级(★基础 / ★★边界 / ★★★争议)
  • 涉及的消歧规则编号
  • 易错点标签(如”易混淆EN0501与ND0101″”易漏时态字段””币种换算陷阱”)

设计意图:决策树给路径,判例给手感。老编辑的学习方式是”看例子”而非”读规则”,判例集的权重应高于规则文本。30条覆盖全部P0类目×古/今,确保每个编辑在正式标注前至少精读10条。

第5章 字段填写规范(解决”这个格子怎么填”)

按附件B模板逐字段说明,每个字段 = 定义 + 填写口径 + 正反例 + 特殊情形

重点强调三类高频出错字段:

  1. 模糊数值:重申value_type六值枚举,给出”千余人””无算””十之七八””斗米千钱”四类典型原文的标准填法;
  2. 单位换算:哪些必须换算双存、哪些只存原值、哪些永不换算(币种);换算规则ID怎么查(附录B);
  3. 时态字段:valid_from/valid_to的填写规范,”不详”vs空值的区别,开放区间(延续至今)的标记方式。

设计意图:本章是”字典”,不需要通读,按字段名检索即可。排版上采用字段名醒目标题+折叠详情,方便快速定位。

第6章 质检与校准(解决”怎么知道我标对了”)

  • 6.1 自检清单(提交前过一遍):
    • 每条事实都有溯源锚点(chunk_id非空)
    • 数值字段的value_type已填,无裸数字
    • 时态关系的valid_from/valid_to已填或明确标记”不详”
    • 币种字段未做跨代换算
    • 待裁项已填写”待裁理由”(不少于10字)
  • 6.2 双人校准流程
    • 同一批原文,两人独立标注→系统自动比对→不一致项进入校准会→首席编辑裁决→裁决结果写入FAQ(附录D);
    • 校准会每周一次,每次不超过1小时,只讨论不一致项
    • 一致率<95%时暂停新标注,先修订规则/补充判例;
  • 6.3 待裁处理SLA
    • 普通待裁:48小时内由首席编辑回复;
    • 争议待裁(多人标同一原文结论不同):纳入下次校准会;
    • 超时未回复的待裁,标注员有权跳过该条继续后续工作(不让流程卡住);
  • 6.4 异议申诉:标注员对裁决不服,可发起二次复核,由本体负责人终审;终审结果写入规则修订日志。

设计意图:质检不是”找错”,是”对齐”。双人校准的核心产出不是分数,是FAQ和规则修订。待裁SLA保护编辑的工作节奏,避免”标了没人理”的挫败感。

第7章 敏感内容处理(解决”这条敢不敢标”)

  • 7.1 四类敏感类目清单:GA0304(政治运动)、MI0405(起事平乱)、SO0903(治安/群体事件)、PE0804(轶事传说);
  • 7.2 分级处理流程
    • L1(默认受限):GA0304、MI0405、SO0903 → 正常标注,visibility=受限,不进入对外数据集;
    • L2(强制标记):PE0804 → fact_level=传说confidence≤0.5,仅供C端文化产品;
    • L3(脱敏审查):涉及在世人物、未解密档案、民族宗教敏感表述 → 标”待审”,由审核员(非标注员)处理后决定是否入库;
  • 7.3 立场中立化原则:旧志”寇””匪””逆”等称谓照录原文,不加现代价值判断;如需现代史实标注,由编辑规则库统一提供标准表述,标注员不自行发挥;
  • 7.4 免责条款:按本手册流程标注的敏感内容,责任在规则设计方,不在标注员个人。

设计意图:敏感内容是老编辑最大的心理负担。本章的核心信息是”按流程做,责任不在你”。免责条款必须白纸黑字写出来,否则编辑会倾向于”宁可不标”,导致数据缺失。

三、附录设计要点

附录A 受控词表速查卡(单页A4,可打印贴工位)

  • 62个二级类目按大类色块分区;
  • 每个类目只列:编码+名称+一句话收录边界+优先级星标;
  • 底部印消歧规则R1-R7的七字口诀版(如”一体记述不拆分””主体决定归哪类”);
  • 这张卡是标注员的”方向盘”,必须做到一眼能查到。

附录B 古今对照速查(单页A4)

  • 朝代纪年↔公历对照表(明洪武—2005,按帝号/年号分段);
  • 度量衡换算表(尺/丈/里/斤/石/亩,按朝代分列,标注conv-xxx规则ID);
  • 政区层级对照表(古/民/今三列并排);
  • 禁止标注员心算换算,一律查表填规则ID。

附录C 30条种子判例集(独立装订,便于翻阅)

格式统一:

【判例编号】ND0101-古-03 ★★
【原文】"万历十四年秋,大水,决堤三十六处,溺毙千余人,
        知县某某捐俸赈之,民赖以全。"
【标注结果】event_type=ND0101; flood_type=洪灾; 
           breach_count={raw:"三十六处",value:36,value_type:exact};
           death_toll={raw:"千余人",value:1000,value_type:approx};
           relief_attached={raw:"知县某某捐俸赈之",方法:发银,actor:知县某某}
【判定理由】赈济信息无独立规模数据(无粮款数额、无持续时间),
           依R3规则回填relief_attached,不单建SO0902。
【易错点】看到"赈"就建SO0902;"千余人"存为exact。
【关联规则】R3、value_type=approx

附录D 常见问题FAQ(动态更新,电子版为主)

  • 按”分类判定””字段填写””工具操作””敏感内容”四组分类;
  • 每条FAQ = 问题+回答+来源(哪次校准会/哪位编辑提出);
  • 每周校准会后24小时内更新,标注员开工前先扫一眼新增条目。

四、手册的产出计划与验收

阶段产出物负责人工期验收标准
W1第1-3章初稿 + 附录A/B本体设计+首席编辑5个工作日编辑通读后能复述项目意义与核心概念
W2第4章决策树 + 附录C前15条判例本体设计+2名资深编辑5个工作日2名编辑独立标注同一批20条原文,一致率≥85%(W2门槛)
W3第5-7章 + 附录C后15条 + 附录D初版本体设计+质检员5个工作日2名编辑独立标注同一批30条原文,一致率≥90%(W3门槛)
W4全册统稿 + 上机练习任务 + 培训本体设计5个工作日正式验收:双人独立标注50条P0样章,一致率≥95%

附件B 《P0类目指标模板全集》 V1.0

归属:《方志知识层数据本体规范》附件B(附件A《事件类型受控词表》第五节之展开) 覆盖范围:全部P0类目,共15套模板(ND×7、AD×6、EN×1、SO×1;ND0101、AD0205已在附件A发布,此处收录修订版并统一编号) 设计铁律重申:只设志书真实会出现的字段。判断依据=历代旧志+新编志书的实际记述能力,不是现代行业统计标准。字段设了而志书里没有,数据集完整度就会被自己的模板拖垮。


〇、先立通用规则(所有模板共用,避免每表重复)

0.1 数值型字段的统一结构(value对象)

任何measures字段中的量值,一律不存裸数字,存如下结构:

{
  "raw": "决堤三十六处,溺毙千余人",     // 原文照录(必填)
  "value": 1000,                        // 数值(可为空)
  "unit_original": "人",                 // 原文单位
  "unit_modern": "人",                   // 规范单位
  "value_type": "approx",               // 见0.2
  "range": [1000, null],                // value_type=range时必填
  "conversion_rule": null,              // 单位换算规则ID(见0.3),无换算为空
  "granularity_note": null              // 口径备注("含"约"字""无算"等)
}

0.2 value_type 受控枚举(处理模糊数量的唯一合法方式)

含义原文特征示例
exact精确值“决口三处,各长十二丈”
approx约数“千余人””约三十万斤”
range区间“死伤二三千人”
uncounted不可计数“无算””不可胜数””溺毙甚众”
qualitative纯定性“大饥””房屋倒塌殆尽”
absent原文未载—(字段留空,区别于uncounted

禁止行为:将”千余人”存为1000/exact;将”无算”存为0;将未载字段留空却不记value_type。这三种是抽取质检的一票否决项。

0.3 单位换算规则登记制

换算不自造,引用统一换算规则表(conv-xxx),每条规则带依据与适用时代:

规则ID换算依据/备注
conv-mu1亩 = 666.67 m²通用;民国地方习惯亩另立规则
conv-jin1斤(市) = 0.5 kg1959年前旧制1斤=16两,涉及重量金额时须断代
conv-shi1石(清) ≈ 103.5 kg(粮)按朝代分设:conv-shi-ming / conv-shi-qing / conv-shi-minguo,换算值必须带朝代断代,无断代信息则只存原值不换算
conv-zhang1丈 ≈ 3.2 m(清)/ 3.33 m(民国后)同上分代
conv-chi1尺 按朝代分设同上
银两/钱文/银元/法币/金圆券/旧人民币/新人民币币种一律照录,永不换算(跨时代购买力换算是下游研究者的事,数据库做了反而错)

0.4 时代适用性标记

每套模板的字段标注适用时代:[古](明清及以前旧志)、[民](民国志)、[今](1949年后新志)。抽取时按志书断限自动提示可用字段集,避免标注员在明代记载里找”直接经济损失(万元)”这种不可能字段。

0.5 公共字段包(所有事件模板默认继承,不再重复列出)

event_time(含粒度)、place_id(多级)、actors[](带角色)、provenance、confidence、review_status。以下各表只列专属measures字段。

一、ND 自然灾害类(7套)

mt-ND0101 水灾(修订版)

字段类型时代必/选说明
flood_type枚举全部洪灾/涝灾/山洪/溃堤溃坝/风暴潮/城市内涝/冰凌灾
rain_descvalue今(古多为定性)降雨量mm;旧志”大雨连旬””雨七日”存qualitative+持续天数
duration_daysvalue全部成灾持续天数
water_levelvalue米;须带测点地名;旧志”水高数丈”存原文
breach_count / breach_lengthvalue全部决口处数/长度(丈→conv-zhang双存)
damaged_area / destroyed_areavalue全部受灾/成灾面积,口径词照录(”淹””浸””没”分级存原文)
damaged_pop / damaged_householdsvalue全部受灾人口/户
death_tollvalue全部“溺毙无算”→uncounted
houses_collapsedvalue全部倒塌房屋间数
livestock_lossvalue全部牲畜损失头数
economic_lossvalue(币种照录)旧志无此字段
relief_attached结构组全部R3规则:附属赈济信息(粮款数额/方式),不独立建SO0902
crop_impact枚举+value全部绝收/减产+比例;”是岁大饥”存qualitative

mt-ND0102 旱灾

字段类型时代必/选说明
drought_type枚举全部春旱/夏旱/秋旱/冬旱/跨年连旱
onset_time时间对象全部旱象始现时间(”自春不雨”→春季,粒度=季)
rainless_daysvalue全部连续无雨天数;古志多定性(”数月不雨”)
precipitation_deficitvalue降雨距平,仅现代水文记载
river_status枚举全部河湖干涸情况:溪流断流/河湖见底/井泉枯竭(”河底可行人”类原文照录)
damaged_area / destroyed_areavalue全部同水灾口径规则
damaged_popvalue全部
famine_level枚举古/民饥荒程度分级:歉收/饥/大饥/人相食——四级受控枚举,这是气候与社会史研究的刚需字段,原文表述照录于raw
price_surgevalue(币种照录)全部米价涨幅(”斗米千钱”→raw照录+单位换算尝试,无断代则不换算)
relief_attached结构组全部同ND0101
social_impact枚举多选全部流民/卖儿鬻女/抢粮/迁徙(关联SO0901线索)

mt-ND0103 地震

字段类型时代必/选说明
quake_time时间对象全部含时辰(”子夜””晡时”照录+换算尝试);夜震/昼震是烈度感知研究变量
epicenter_desc文本+place_id全部原文震中表述(”地震,声如雷,自西北来”);方位信息单列 direction字段
magnitudevalueM值;古地震的推定震级仅当志书明载(新志常回溯标注)才收,字段加 source_of_estimate
intensityvalue罗马数字烈度;同上规则
intensity_qualitative枚举古/民感受分级:微感/器物动摇/房屋损伤/倒塌/毁灭——旧志烈度的唯一合法表达方式
ground_effects枚举多选全部地裂/地陷/喷沙冒水/山崩/滑坡/河湖壅塞改道/”山移”
damaged_area_scopeplace_id列表全部波及范围(”邻县俱震”→列place)
buildings_collapsedvalue全部分类计数:民居间数/城墙雉堞/衙署/寺观塔(塔倒、城颓是旧志必载项,单设字段
death_toll / injury_countvalue全部
aftershocksvalue+时间组全部余震次数与持续期(”余震月余”)
precursors文本全部前兆记载(地声、地光、井水异常、动物异常)照录
post_quake枚举全部赈济/蠲免/重建(caused关系挂SO0902/EN类事件)

mt-ND0104 风灾

字段类型时代必/选说明
wind_type枚举全部台风(飓风)/大风/龙卷风(飓风拔木类)/风暴潮/焚风
typhoon_name_id文本台风名称/编号(1949后)
wind_forcevalue蒲福级;旧志存定性枚举:拔木/发屋/偃禾
wind_force_qualitative枚举古/民三级:拔木发屋级/偃禾级/微损级
wind_direction枚举全部八方位照录(”东北风大作”)
durationvalue全部持续时长(”自辰至酉”→换算小时段,原文照录)
accompanying_rainvalue全部伴随降雨
storm_surge_heightvalue增水米
houses_collapsed / boats_sunk / trees_uprootedvalue全部三项旧志标配
damaged_areavalue全部
death_tollvalue全部
economic_lossvalue(币种照录)
salt_field_crop_impactvalue全部盐场/农田分列(沿海志书特色,样章验证后决定保留与否)

mt-ND0106 霜冻雪灾

字段类型时代必/选说明
disaster_subtype枚举全部暴雪/严寒/春霜/秋霜/冰冻(雨凇)
extreme_tempvalue最低气温℃;旧志无温度计数据,此字段[古][民]置absent,禁止从”大寒”推数
snow_depthvalue全部尺→conv-chi双存(”深数尺””平地丈余”)
duration_daysvalue全部降雪/严寒持续天数
frost_period枚举全部春霜(伤花伤苗)/秋霜(杀青)——物候研究关键
river_lake_freeze文本+value全部河湖结冰:冰厚、可通车马否(”冰坚可渡”照录)
damage_to_plants枚举多选全部竹柏死/果木冻死/麦苗冻死——旧志植物灾情是物候重建的一手数据,单设
damaged_areavalue全部
death_toll(human) / livestock_deathvalue全部冻毙人数/牲畜分列
famine_level枚举古/民复用ND0102四级枚举

mt-ND0107 生物灾害

字段类型时代必/选说明
pest_type受控枚举全部蝗/螟/粘虫/稻飞虱/棉铃虫/松毛虫/鼠害/牲畜疫(牛瘟猪瘟)/其他(二级枚举表单独维护,随样章扩充
locust_stage枚举全部蝻(幼)/蝗(成)——蝗灾专属,治理窗口期判断依据
swarm_scale枚举+value全部定性:蔽日/蔽野/方数十里;定量:面积
spread_direction枚举全部迁入方向(”自北而来”)——蝗虫迁飞路径研究字段
damaged_areavalue全部
crop_loss_ratevalue全部损失成数照录(”伤稼十之七八”→range[0.7,0.8])
control_measures枚举多选全部[古]捕瘗/官民扑捕/祈祷;[今]药剂/飞机喷洒/生物防治/人工扑打
control_inputvalue防治投工/药械/经费
control_effect枚举全部扑灭/控制/蔓延
durationvalue全部灾期

mt-ND0109 疫病

字段类型时代必/选说明
disease_name_raw文本全部原文病名照录(”大头瘟””痧症””时疫””霍乱”)
disease_name_modern受控枚举今(古为推定)现代病名对照;旧志病名的现代对照一律标 mapping_confidence 且注明对照依据(志书自注/学者考订),无依据则留空——这是本类目最大的学术争议点,宁可空缺不可妄断
epi_type枚举全部呼吸道/肠道/虫媒/动物源/不明
onset_spread时间组全部始发时间、流行期、终止时间
spread_scopeplace_id列表全部波及乡村/街区清单(旧志”沿村传染”存qualitative)
origin_route文本全部传入路径记载(”自口岸传入””灾后有疫”——灾后关联疫用caused关系挂灾害事件,此字段只存文字线索
case_countvalue发病数;古志多absent
death_tollvalue全部“死者枕藉””十室九病”→uncounted/qualitative
mortality_qualitative枚举古/民四级:偶有死亡/死亡众多/死亡惨重/灭绝性(村坊几空)
control_measures枚举多选全部[古]施药/设局义诊/掩埋/隔离(”徙避”);[今]检疫/接种/消杀/定点医院/封锁
control_bodiesorg_id列表防疫机构
relief_attached结构组全部同ND0101

二、AD 建置政区类(6套)

mt-AD0201 政区设置

字段类型必/选说明
setup_type枚举新置/析置(割某地置)/升置/侨置/迁置
new_placeplace_id新设政区(Place实体同批创建)
admin_level受控枚举分时代层级表:[古]州/府/县/乡/都/图;[民]县/市/区/乡镇/闾邻;[今]省级/地级/县级/乡级/村级——层级词表按时代切换,不混用
parent_placeplace_id隶属上级(挂Place.evolution[])
source_territoryplace_id列表+说明析置来源(”割XX县东境三乡置”→列源政区+原文)
jurisdiction_scope文本+place列表辖域描述/下辖单位清单
seat_locationplace_id治所
area / households / populationvalue设置时点规模(旧志”户X口X”→双字段)
approval_bodyorg_id+文号[今]必收(批准机关+文件号);[古]存”奉旨””部议”类文本
effective_time时间对象批准时间与生效时间分列(今志常两者不同)
naming_reason文本得名缘由(志书多载,地名文化产品素材)
setup_reason枚举+文本析置原因:辖境过广难治/人口滋繁/防务需要/资源开发/政策规定

mt-AD0202 政区撤并

字段类型必/选说明
removal_type枚举裁撤/并入/省并/改置(转他类政区)/自然消亡
removed_placeplace_id被撤政区(Place.existence关闭)
level_before受控枚举撤销前层级
successor_placesplace_id列表+份额说明辖域去向(”析入甲乙两县”→列明分配)
seat_disposition枚举治所处置:降为乡镇/废弃/他迁
population_area_at_removalvalue撤销时点规模
approval_body / effective_time同AD0201
removal_reason枚举+文本精简机构/区划调整政策/灾毁/战毁/合并发展

mt-AD0203 政区改名

字段类型必/选说明
placeplace_id硬校验:建制延续(Place.existence不中断),若实为撤旧设新则拒收,改归AD0201+AD0202事件对
old_name / new_name文本各挂Place.names[]并带有效时间区间
rename_type枚举用字变更/全称更换/规范化(俗名转正)/恢复旧名/避讳改字
rename_reason枚举+文本避讳/避重名(全国同名)/政治寓意/复旧/地名义雅化
approval_body / effective_time同上
name_revertedevent_id若后又改回,前向链接(改名链条自动串接)

mt-AD0204 政区升格降格

字段类型必/选说明
placeplace_id建制延续(校验同AD0203)
direction枚举升格/降格/平级改类(县改区/地区改市)
level_from / level_to受控枚举分时代层级表
accompanying_changesevent_id列表伴随的辖界调整(AD0205)/治所迁移(AD0206)/改名(AD0203)——R6规则:一事件一主类,伴随变化独立建条用caused/伴随关系互链
approval_body / effective_time同上
reason枚举+文本经济发展/城镇化/政策安排/行政中心转移

mt-AD0205 辖界调整(修订收录)

字段类型必/选说明
adjust_type枚举析出/划入/互换/勘定/飞地处置
partiesplace_id列表(甲方乙方)涉及政区
transferred_unitsplace_id列表+说明划转的具体乡/村/地块清单
area_change / population_changevalue各方增减(正负号建模)
boundary_desc文本新界描述原文(”以XX河为界”)——GIS复原的依据
approval_body / approval_doc / effective_time同上政务核验刚需
dispute_note文本界务纠纷背景(旧志”界讼”记载,单设——历史边界纠纷是稀缺席位数据)

mt-AD0206 治所迁移

字段类型必/选说明
placeplace_id
seat_from / seat_toplace_id新旧驻地(挂Place.location时态链)
move_distancevalue里程(里→换算双存)
move_reason枚举+文本水毁/战毁/火灾/发展需要/交通枢纽变迁/政策指令
old_seat_disposition枚举降为村镇/保留旧址/废弃
approval_body / effective_time同上
temp_seat_note文本临时驻地记载(”暂驻XX”——迁移过程中常有过渡态,单设)

三、EN0501 水利工程

字段类型时代必/选说明
project_type枚举全部水库/堤防/堰坝/闸/渠/圩垸/塘陂/河道整治/排灌站/海塘
project_nameplace_id(人文地点)全部工程本身作为人文地点实体创建(与Place体系打通)
project_nature枚举全部新建/重修/加固/改建/扩建/废毁
water_bodyplace_id全部所在河流湖塘(关联自然地理地点实体——水灾事件与水利工程通过water_body互查,这是水灾数据集的杀手级关联
scale_by_type分组结构全部按project_type挂不同指标组:堤防→长/高/顶宽;水库→坝高/库容/集雨面积;渠→长/流量/灌溉面积;塘陂→蓄水容量。每组字段=raw照录+换算双存
irrigated_area / drained_areavalue全部灌溉/排涝面积(古今皆有,旧志”溉田千顷”→顷按朝代换算规则)
construction_period时间组全部始工/竣工(旧志”越三年告成”→换算)
investmentvalue(币种照录)全部造价;[古]银两/钱文分列
labor_inputvalue全部[古]役夫工数(”役民夫十万”);[今]投工工日/民工动员数
materials_note文本全部建材与工艺记载(石工/夯土/现代混凝土——工程史研究字段)
organizerorg_id+person_id全部主持者([古]知县/乡绅;[今]建设单位)——人物库与工程事件的核心连接点
beneficiary_scopeplace_id列表全部受益乡村
subsequent_fateevent_id列表全部后续溃决(→ND0101)/重修(→新EN0501条)/报废,前向链接成工程生命史
stele_record文本古/民碑记存目(”有碑记,见艺文志”——跨篇章线索,供CU0703关联)

四、SO0902 赈灾救济

字段类型时代必/选说明
related_disasterevent_id全部强制字段:必须挂接主灾事件(ND类)。无法确定主灾的”孤立赈济记载”进入待裁队列——这是R3规则(附属vs独立)的执行闸口:有独立规模数据、独立成段者建本条并挂主灾;一笔带过者回填主灾的relief_attached
relief_actor_type枚举全部朝廷(官赈)/地方政府/民间慈善(义赈)/侨汇/国际援助/以工代赈专项
relief_actorsorg_id+person_id列表全部具体施赈机构与人物(善人义举→关联PE0802线索)
relief_methods枚举多选全部放粮/发银/施粥(粥厂)/平粜/蠲免/缓征/以工代赈/安置移民/发放物资
grain_amountvalue全部石/斤按朝代换算规则双存
money_amountvalue(币种照录)全部银两/钱文/银元/人民币分列,永不跨代换算
tax_reliefvalue古/民蠲免数额或成数(”蠲免钱粮十之三”)
congee_stationsvalue+place列表古/民粥厂数与地点(旧志特色字段)
relief_duration时间组全部起止
beneficiariesvalue全部受赈人口/户数
work_relief_projectevent_id古/民/今以工代赈所修工程→链接EN类事件(赈灾与工程的跨类连接,社会史+工程史双料数据
effect_note文本+枚举全部效果记载(”民赖以全””流亡复业”)+定性分级

五、样章级示例(标注手册种子案例,2条)

例1(古·地震) 原文:“康熙七年六月十七日戌时地震,有声如雷,自西北来,城堞民居倾圮无数,学宫颓,压毙百余人,余震经月乃息。”

{
  "event_type": "fz:evt:ND0103",
  "time": {"raw":"康熙七年六月十七日戌时","公历":"1668-07-25","粒度":"时辰级","换算":"人工"},
  "place": "xx县城",
  "measures": {
    "quake_time": {"raw":"戌时","换算尝试":"19-21时","value_type":"exact"},
    "intensity_qualitative": "房屋损伤级",
    "ground_effects": [],
    "buildings_collapsed": {"raw":"城堞民居倾圮无数","value_type":"uncounted"},
    "death_toll": {"raw":"压毙百余人","value":100,"value_type":"approx","range":[100,null]},
    "aftershocks": {"raw":"余震经月乃息","value":30,"unit_original":"日","value_type":"approx"}
  },
  "备注": "学宫颓→buildings_collapsed.raw已含;'声如雷,自西北来'→direction=西北+precursors照录"
}

例2(今·旱灾) 原文:“1978年大旱,自6月中旬至9月上旬无透雨,全县受旱42万亩,成灾18万亩,绝收5.3万亩,投入抗旱机井1200眼,发放抗旱贷款37万元。”

{
  "event_type": "fz:evt:ND0102",
  "time": {"start":"1978-06-15","end":"1978-09-10","粒度":"约","备注":"原文为旬级表述"},
  "measures": {
    "drought_type":"夏秋连旱",
    "rainless_days":{"raw":"无透雨","value_type":"qualitative"},
    "damaged_area":{"value":42,"unit_original":"万亩","unit_modern":"亩","换算值":420000,"value_type":"exact"},
    "destroyed_area":{"value":180000,"unit_modern":"亩","value_type":"exact","口径":"成灾"},
    "crop_impact":{"raw":"绝收5.3万亩","value":53000,"value_type":"exact"},
    "control_input":{"raw":"抗旱机井1200眼,抗旱贷款37万元","币种":"人民币(现行)"}
  }
}

这两个例子的作用:让编辑和工程师在同一页上对齐”什么叫一条合格的结构化事实”。标注手册的案例库从每个P0类目×古/今各1条起步,共约30条种子案例。

六、全集统计与质检指标

  • 模板总量:15套,专属字段合计约 180个,其中必填约35个;
  • 受控枚举表(须随词表一并冻结):灾害类型、饥荒四级、烈度定性三级、政区层级分时代表、赈济方式、工程类型、指标模板挂载表——共7张;
  • 完整度验收线(对应90天验收标准):P0数据集对外发布时,必填字段完整度100%,专属选填字段完整度≥80%(低于80%说明模板设计超出志书记述能力,须裁字段而不是催标注);
  • 模板健康度监控:某字段在试抽取中 absent 占比>90% → 标记”疑似过设”,进入复审;某类目”待裁”高发 → 边界说明修订(与附件A治理规则联动)。

附件A 《事件类型受控词表》 V1.0

归属:《方志知识层数据本体规范》附件A 适用范围:L1知识层 Event 实体的 event_type 字段取值 设计依据:历代旧志门类(祥异、舆地、建置、秩官、武备、食货、学校、人物、杂记)+ 新方志篇目体系(自然、政治、经济、文化、社会)双轨归并 版本状态:V1.0草案(90天试抽取验证期内冻结二级类目,只补定义与边界,不新增类目)


一、编码规则

fz:evt:{大类码}{四位序号}

示例:fz:evt:ND0101 = 自然灾害大类·水灾
大类码为两位字母(稳定,永不变更);
四位序号中前两位=大类内分组(预留扩展位),后两位=类目。
  • 编码一经发布永不复用、永不改义;类目废弃时标记 deprecated,新数据不再使用,旧数据保留;
  • 每个二级类目携带五项元数据:定义、收录边界、排除边界、优先级、挂载的指标模板ID。边界说明是词表的灵魂——它解决的不是”分类”问题,而是抽取时”这条记载算不算、算哪类”的一致性问题(不同标注员对同一文本判断一致率应≥95%,这是验收指标)。

二、词表总表(9大类 · 62个二级类目)

ND 自然灾害类(P0 · 第一个垂直切片)

编码名称定义收录边界排除边界优先级
ND0101水灾因降雨、融雪、溃决等导致的水体泛滥致灾事件洪灾、涝灾、山洪、溃堤溃坝、城市内涝、风暴潮倒灌;含灾后的灾情记载与赈济附属信息水利工程本身的兴修→EN0501;单纯水位/雨量数值记录→指标观测P0
ND0102旱灾因长期降水不足致灾事件春旱、夏旱、秋旱、连年旱;含”大饥””人相食”等伴生记载旱情数值(连续无雨日数)单独出现→指标观测P0
ND0103地震有感及成灾地震事件含震级、烈度、前兆、损失、震后重建记载地震监测台站建设→EN0504P0
ND0104风灾台风、飓风、大风、龙卷风致灾事件含风力等级、路径、损失P0
ND0105雹灾降雹致灾事件含雹块大小、持续时间、受灾范围P1
ND0106霜冻雪灾霜冻、冰冻、严寒、暴雪致灾事件含异常低温记载(”冬大雪,竹柏皆死”)常年气候数据→指标观测P0(气候研究刚需)
ND0107生物灾害蝗灾、虫灾、鼠害、森林病虫害、畜禽疫病含历史上”蝗蔽日”类记载人传染疫病→ND0109P0
ND0108地质灾害滑坡、泥石流、崩塌、地陷、山崩含旧志”山移””地裂”类记载P1
ND0109疫病人类传染病流行事件瘟疫、霍乱、疟疾、新冠等流行记载;含流行范围、死亡数、防疫措施医院/防疫机构建设→EN0504P0
ND0110复合及其他灾害多灾并发或无法归入上述类目水火并至、震后疫等原文一体记述可拆分为单一灾种的必须拆分,本类目占比>5%时触发词表复审P2(兜底)

AD 建置政区类(P0 · 第一个垂直切片)

编码名称定义收录边界排除边界优先级
AD0201政区设置新设各级政区析置、新置、置县置州、设市设区;含设置时间、辖域、治所P0
AD0202政区撤并撤销、并入、降级消失省并、裁撤、县改区前的撤县改名而建制存续→AD0203P0
AD0203政区改名政区名称变更而建制延续含改名原因、新旧名对照同一政区多次改名逐次建条,不合并P0
AD0204政区升格降格行政级别变更县升州、州升府、地区改市、县级市升格P0
AD0205辖界调整政区间边界划转析出划入、边界勘定、飞地调整、边界纠纷及裁决整体设置/撤并已含辖域变化→AD0201/0202P0
AD0206治所迁移政区治所驻地迁移含迁址原因、新旧驻地治所衙署建筑本身的营建→EN0504P0
AD0207功能区设立非法定政区的管理功能区设立/撤销/扩区开发区、高新区、新区、风景区管委会、林区特区单纯挂牌仪式性记载信息量不足者不收P1

GA 政治政务类

编码名称定义收录边界排除边界优先级
GA0301机构设立改革地方党政机关、事业单位的设立、改组、撤并含机构沿革(”文教局改教育局”)、体制改革(机构改革方案实施)机构驻地建设→EN0504P1
GA0302主要官员任免地方党政主要负责人、历史职官的到任离任知县/县长/书记任免、重大人事变动普通职员任免不收;职官名录整体→人物库任职关系,非事件P1
GA0303政策法规颁行地方性法规、规章、重大政策文件的出台含文件名称、文号、施行时间、主要内容政策的执行过程性记载→按内容归各业务类目P1
GA0304重大会议运动重要会议、政治运动在本地的开展党代会人代会、历次政治运动的地方记载(如实记录,敏感表述走脱敏审查流程P2
GA0305荣誉表彰本地获得的国家级、省级荣誉,重大表彰文明城市、示范县等称号授予个人荣誉→PE0802P2
GA0306外事交流对外交往、缔结友好关系、重要来访友好城市缔结、外国政要来访领导人视察本地→PE0801P2

MI 军事类

编码名称定义收录边界排除边界优先级
MI0401战事战斗发生于本地或涉及本地的战事历代战事、抗战战役、解放战争战斗;含时间、双方、经过、结果P1
MI0402驻防调防军队、武装力量的驻防与调离含历代汛塘营汛、近现代驻军P2
MI0403军事设施建设城防、关隘、工事、军事设施之建废城墙修筑、炮台、国防工程古城墙作为文物的保护修缮→EN0505P2
MI0404兵事制度征兵、民兵、兵役制度的地方实施含历次征兵记载制度文件颁行→GA0303P2
MI0405起事平乱历史上的民变、起事、镇压记载旧志”兵燹””寇乱”类记载,保留原文表述并加现代史实标注(立场中立化处理由编辑规则库统一规定)P2

EN 工程建设类

编码名称定义收录边界排除边界优先级
EN0501水利工程河湖治理、水库、堤防、灌渠、闸坝之兴建改建含工程规模指标(长、高、库容、灌溉面积)、工期、造价、主持者工程溃决致灾→ND0101(溃坝事件),工程本体沿革仍在ENP0(与水灾切片强关联)
EN0502交通工程道路、桥梁、铁路、港口、机场之建废改扩建含古桥古道、驿路P1
EN0503市政工程供水排水、供电照明、园林绿化、市容工程P1
EN0504公共建筑衙署、学校、医院、场馆、纪念建筑之营建含旧志”公署””学宫””书院”营建修缮学校作为机构的设立沿革→CU0701(区分:建筑归EN,机构归CU)P1
EN0505文保工程文物建筑修缮、迁移、复建;考古发掘含考古发现事件(出土文物清单)P1
EN0506能源通信工程电厂、电网、燃气、通信设施之建设P2
EN0507生态治理工程造林、水土保持、流域治理、污染治理工程P2

EC 经济生产类

编码名称定义收录边界排除边界优先级
EC0601生产制度变革土地改革、合作化、包产到户、集体林权改革等制度性事件含变革过程、覆盖范围、政策依据P1
EC0602企业兴废改制重要企业的创办、破产、改制、重组、上市收录门槛:县志立传级企业或有重大就业/税收影响者企业名录整体→机构库,非事件P1
EC0603物产资源开发矿产发现与开采、特产认定、地理标志、新品种培育成功含旧志”物产”门类中动态记载(某年始发现/引种某物)静态物产名录→机构/地点属性或指标观测P1
EC0604商贸大事市场开闭、重大展会、对外经贸协议、商圈兴衰年度商业统计数据→指标观测P2
EC0605财税金融事件金融机构设立撤并、货币改革实施、重大财税事件含旧志”赋役””盐法”制度性变革记载历年税收数额→指标观测P2

CU 文教科技类

编码名称定义收录边界排除边界优先级
CU0701学校机构沿革学校(含书院、学宫、私塾)之创办、改名、合并、停办、升格含创办时间、创办人、初名校舍建设→EN0504P1
CU0702科技成果科技发明、获奖成果、重大技术突破、新品种审定含成果名称、完成单位、获奖等级P2
CU0703文化著述出版志书谱牒编纂成书、重要著作出版、文献发现、重大文化活动本次数据生产自身的著录(哪些志书何时纂修成书——Work实体的事件化表达)P1
CU0704民俗非遗重要民俗活动记载、非遗项目认定、传统节会兴废含庙会、集市传统之兴革静态风俗描述→非事件,入地点/主题属性P2
CU0705宗教事件寺观教堂之创建兴废、重大宗教活动、宗教政策实施建筑兴废与EN0504区分:宗教场所沿革以机构视角归此处,纯建筑工程视角归EN,双写互链P2
CU0706体育赛事承办赛事、破纪录、重大体育成就P2

PE 人物活动类

编码名称定义收录边界排除边界优先级
PE0801视察到访领导人视察、历史名人到访、重要人物过境含时间、地点、活动内容、题词P2
PE0802人物事迹义举、慈善、殉职、重大贡献等单人事迹收录门槛:志书人物传/人物表立传级,或有专段记述者人物任职→Person.office_holds关系,非事件P1
PE0803人物生平大事生卒、就义、重要人生节点,仅当原文独立成条记述时建事件与Person实体双写互链从人物传中推导的生卒年→Person.bio_dates字段,不建事件P2
PE0804轶事传说传闻、轶事、民间传说类记载强制标注 confidence≤0.5fact_level=传说,永不进入严肃数据集,仅供C端文化产品使用P2

SO 社会民生类

编码名称定义收录边界排除边界优先级
SO0901人口迁徙安置移民、迁徙、安置事件水库移民、垦荒移民、灾民迁徙、政策性安置;含规模、来源去向历年人口数→指标观测P1
SO0902赈灾救济独立记述的赈济、救济、抚恤行动灾后进行专项、成规模的赈济记载灾害条文中附带一笔的赈济信息→作为ND事件的measures字段,不单建事件(规则详见消歧R3)P0
SO0903治安事件重大刑事案件、群体性事件如实收录历史记载;当代敏感事件走脱敏分级流程P2
SO0904安全事故生产安全、交通事故、火灾等重大事故含伤亡、损失、处理结果火灾若为战事所致→MI0401P1
SO0905民生保障事件低保、社保、医保、保障房等重大民生制度的本地实施与GA0303区分:文件出台归GA,实施落地与覆盖情况归此处P2
SO0906物价供应异动抢购、物价暴涨、物资短缺等突发事件仅收事件性异动常规物价数据→指标观测P2

三、消歧规则(抽取一致性的执法依据)

标注员遇到边界冲突时,按以下规则裁决,规则优先级从高到低:

规则内容示例
R1 原文一体性优先原文将多事一体记述且不可自然切分时,建复合条目归ND0110或依主体事件归类,关联事件用 caused 关系互联,不强行拆分“八月大水,溃堤三十六处,溺毙千余人,冬大疫”→ ND0101为主事件,caused→ND0109疫病子事件
R2 主体决定归属记述重心在哪一主体,归哪一类“教育局迁址”重心在机构→GA0301;”教育局新楼建成”重心在建筑→EN0504
R3 附属信息不独立建条灾后赈济、灾后重建若与灾害同段记述且无独立规模数据,作为主事件的measures/关联事实,不单建事件见SO0902排除边界
R4 变更类逐次建条建置、改名、隶属变更每一次独立建条,禁止合并为”沿革概述”一条某县1949—2005年间7次辖界调整→7条AD0205事件,由Place.evolution[]串联
R5 事件与观测分流含时间点的动态变化→Event;周期性/年度性数值记录→IndicatorObservation。同一句话两者兼有时双写(事件建条+数值入观测表)“2003年粮食总产12万吨,较上年减3成(因旱)”→观测表收产量值;ND0102旱灾若无独立记述则不建事件
R6 一事件一主类,多关联每条事件有且仅有一个event_type;跨类关联通过 caused / involved 关系表达,不允许多主类地震引发水库溃坝→ND0103为主,caused→ND0101
R7 存疑归高不归低无法判断类目时,标注员标记”待裁”进入专家复核队列,禁止自行归入P2兜底类目兜底类目占比是词表健康度指标

四、与传统志书门类的映射(Crosswalk)

抽取时按志书篇章定位候选类目,可大幅提升效率与一致性:

旧志门类新志篇章(通行名)映射类目
祥异 / 灾异 / 祥灾自然灾害志、大事记ND0101—0110
舆地 / 疆域 / 建置沿革建置区划、地理AD0201—0207、ND0103(地震多附舆地)
公署 / 秩官 / 选举政权政务、人事GA0301—0302、PE0803
武备 / 兵事 / 兵燹军事MI0401—0405
水利 / 河防水利EN0501、ND0101(灾与工在此门类最易混淆,重点培训)
城池 / 桥梁 / 津渡城乡建设、交通EN0502—0504
食货 / 赋役 / 盐法 / 物产经济、农业EC0601—0605
学校 / 书院 / 艺文教育、文化CU0701、CU0703
祠祀 / 寺观 / 坛庙宗教、民俗CU0704—0705
人物 / 列传 / 忠义 / 烈女人物PE0802—0804
风俗 / 民政 / 社会社会、民政SO0901—0906
大事记大事记全类目来源——大事记是事件抽取密度最高的篇章,首个切片应从大事记+水利志+建置志三篇入手

五、指标模板挂载(P0类目详表)

指标模板定义每类事件的 measures{} 结构化字段。原则:只设志书真实会出现的字段,宁缺毋滥;每个字段带单位规范与”原文值/换算值”双存规则。以下给出两个示范,其余P0类目模板在试抽取阶段由编辑依据样章补全。

ND0101 水灾 · 指标模板 mt-ND0101

字段单位规范必/选备注
雨情毫米 / “大雨连旬”类定性定性表述存原文,粒度标记
水位米(原文如”丈”须换算双存)标注测点位置
决口/溃堤处、丈
受灾面积亩/公顷(换算双存)区分”受灾/成灾/绝收”三级口径,照录志书口径词
受灾人口人/户
死亡人数旧志”溺毙无算”存为区间[不详]
经济损失原文币种+单位(两、元、万元)币种必须照录,不做跨时代购买力换算(换算留给下游研究客户)
赈济粮款数额、赈济方式R3规则下作为附属字段

AD0205 辖界调整 · 指标模板 mt-AD0205

字段单位规范必/选备注
调整类型析出/划入/互换/勘定受控枚举
涉及政区place_id列表(甲方、乙方)
面积变化平方公里/亩(双存)
人口变化人/户
批准机关与文号文本政务客户核验刚需
生效时间时间对象批准时间与生效时间分开记录

方志数据本体框架 V1.0

一、五条设计原则(先立法,后建模)

#原则含义违反的后果
1溯源优先任何一条结构化事实,必须绑定原文出处(志书版本+卷/篇+页+原文摘录)。无溯源的数据不入库数据不可信→卖不出价;”信史”是方志相对其他数据源的唯一垄断优势,溯源就是它的凭证
2双时间轴每条事实区分事件时间(事情发生在何时)与记录时间(哪一年的志书这样记载)。二者都建模清代志书对明代事件的记载、新旧志书对同一事件的不同记载,无法区分→数据不可考证
3允许不确定每个字段可携带不确定度标注(存疑/异说/约数),宁可标”不确定”不可强行确定AI抽取必然有错;不建模不确定性,一次数据事故就毁掉”权威”人设
4对齐不重造地名对齐CHGIS+现行行政区划代码,时间对齐GB/T 7408,元数据对齐江苏著录规范/DC。自己只做别人没做的知识层重造轮子→数据成孤岛→永远无法与学术、政务数据流通
5事件为中心六类实体中,事件(Event)是原子核心——灾害、建置变更、工程、任免、物产记录都是事件,实体通过事件相互关联若按”实体档案卡”建模(人物一张卡、地名一张卡),得到的是百科全书;按事件建模,得到的才是时间序列数据集——后者才有买家

二、总体架构:三层模型

┌────────────────────────────────────────────────────────┐
│ L2 资产层(对外销售的产品形态)                            │
│   垂直数据集(水灾事件库/建置沿革库/人物库…)               │
│   = L1知识层按主题视图打包 + 授权/许可元数据                │
├────────────────────────────────────────────────────────┤
│ L1 知识层(核心资产,私有)                                │
│   六类实体 + 关系 + 事实(五元组)+ 溯源 + 置信度            │
│   存储:图数据库(关系网络)+ 关系库(结构化查询)双写       │
├────────────────────────────────────────────────────────┤
│ L0 文献层(对甲方交付的形态,兼容现有全部标准)              │
│   原版图像 → OCR双层PDF → 篇章树(编章节目)→ 段落切片       │
│   元数据对齐:江苏著录规范 / 成都DB5101 / 湖南规范           │
└────────────────────────────────────────────────────────┘

关键机制:L0与L1之间通过”锚点”连接。 L1中每条事实的溯源对象,精确指向L0的段落切片ID。这一条连接同时满足三个需求:甲方要的”点击答案看原文”(C端体验)、买家要的”可考证”(数据定价)、你内部要的”抽取质量回溯”(质检)。锚点是整个体系的承重墙,先建它。

三、L1核心:六类实体的字段定义

3.1 事件 Event(原子核心,最先做)

字段类型必填说明
event_idURI全局唯一,规则:fz:event:{志书代码}:{序号}
event_type受控词表一级分类:自然灾害/建置沿革/工程营造/政事/军事/经济生产/文教/人物活动/物产记录…(词表见附件A,约60个二级类目)
title文本规范化事件名,如”1998年XX江特大洪水”
time_start / time_end时间对象支持精确日期、模糊时间(”是年秋”→季节粒度)、朝代纪年(”万历十四年”→含换算公历+换算置信度)
time_granularity枚举年/季/月/日/约,如实记录原文精度,不伪造精度
place_id→地点实体事发地(多级:流域→县→乡镇→具体地点)
actors[]→人物/机构实体参与方,带角色(受灾方/主持者/施工方…)
measures{}结构化指标组按事件类型挂载不同指标模板:水灾→水位/流量/受灾面积/死亡人数/经济损失;建置→变更类型(析置/省并/改名/升格)/上级政区/治所;工程→长度/造价/工期
description_raw文本原文摘录(溯源锚点绑定处)
provenance_id→溯源对象见3.7
confidence0—1 + 等级AI抽取置信度 + 人工复核等级(未检/初检/专家定稿)
statements_conflict[]数组异说登记:不同志书对同一事件的矛盾记载,不裁决、并存呈现(这本身是学术价值)

指标模板(measure schema)是数据集定价的核心。 每类事件的指标表由资深编辑依据历代志书实际记载能力设计——例如水灾指标只设志书中真实会出现的字段,不照搬现代水文标准。这是”方志编辑知识”转化为”数据结构”的地方,也是通用软件公司做不了的地方。

3.2 地点 Place

字段说明
place_id全局唯一URI
names[]历史名称集合(正名+别名+俗名),每个名称带有效时间区间
place_type政区(省/府/州/县/乡/村)/ 自然地理(山川湖河)/ 人文地点(城池、衙署、学校、桥梁、寺观)
chgis_id对齐CHGIS地名ID(可空,逐步补)
gb2260_code对应现行行政区划代码(建立古今对照,这是政务客户的刚需)
location经纬度(点)或GeoJSON(面),带定位精度与定位依据
evolution[]沿革链:[时间区间, 隶属上级place_id, 事件event_id]——每次变更都指向引发它的事件实体

3.3 人物 Person

字段说明
person_idURI
names[]姓名/字/号/谥/曾用名,各带时间区间
bio_dates生卒年(支持”约””不详”),朝代纪年+公历换算
identity_tags受控词表:官员/乡贤/艺文/革命人物/科技…(对齐志书”人物传”类目)
office_holds[]任职记录:[机构, 职务, 起讫时间, 溯源]——任职本身就是事件,双写
place_links[]籍贯/寓居/活动地 → place_id
disambiguation同名消歧字段(生卒+籍贯+事迹指纹),同名不同人是人物库最大质量风险,必须建模

3.4 机构 Organization

字段说明
org_idURI
names[]历用名称(带时间区间)——”教育局→文教局→教育局”这类机构改名沿革是政务查询高频需求
org_type政权机构/学校/企业/社团/宗教场所/军事单位
existence设立—撤销/延续 时间区间,设立与撤销各关联event_id
hierarchy[]隶属关系链(带时间区间)——隶属关系随政区变化而变,必须时态化
location驻地 → place_id(可多次迁移,带时间区间)

3.5 指标观测 IndicatorObservation(时序数据的载体)

志书中大量”某年粮食总产X万斤”类记载,不属于事件,单独建一类观测值实体

字段说明
obs_idURI
indicator_id受控指标词表(粮食产量/人口/耕地面积/税收/降雨量/物价…约200项起步)
value + unit数值+单位,原文单位与现代单位双存(”万斤”照录,换算”吨”另存,换算规则登记)
time / place观测时点与地域范围
scope_note统计口径备注(志书口径与现代统计口径的差异说明——数据能否用于建模,全看这个字段是否诚实)
provenance_id溯源

这一类实体直接决定你能否卖给研究机构”某流域1949—2005年粮食产量时间序列”这样的数据集产品。

3.6 文献 Work(L0的元数据壳)

志书/年鉴/旧志本身作为实体:版本、纂修者、成书年代、断限(记述起止年)、篇目树、数字化状态。对齐江苏《地方志著录元数据规范》字段,L0交付物的元数据直接从这里导出——一份维护,两处使用。

3.7 溯源对象 Provenance(承重墙,独立成类)

provenance = {
  work_id      哪部志书(→Work实体,含版本)
  section_path 篇目路径(卷三·水利志·防汛)
  page         页码(对应扫描图像ID)
  chunk_id     L0段落切片ID(精确锚点)
  raw_text     原文摘录(≤200字)
  extractor    抽取方式(人工/AI模型名+版本)
  reviewed_by  复核人 + 复核时间
}

每条事实(L1任何实体的任何字段)都指向一个provenance对象。没有provenance的字段不允许入库——这是入库校验的硬规则。

四、关系体系(L1的边)

只定义12种核心关系,克制为上(关系爆炸是本体工程第一死因):

关系连接时态
发生于 occurred_atEvent→Place自带时间洪水发生于XX县
参与涉及 involvedEvent↔Person/Org带角色某人主持修堤
引发 causedEvent→Event水灾引发赈济
建置变更 alteredEvent→Place/Org析置事件改变县界
隶属 belongs_toPlace/Org→Place/Org✔ 区间XX乡隶属XX县(1958—1984)
曾用名 former_namePlace/Org自关联✔ 区间名称沿革链
任职 holds_officePerson→Org✔ 区间任知县
籍贯/活动地 linked_placePerson→Place寓居
观测于 observed_atObservation→Place+Time内嵌
见于记载 attested_in任何实体→Work溯源的关系化表达
异说 conflicts_withEvent↔Event矛盾记载互联
同指 same_as跨库实体对齐CHGIS、对齐其他志书同一实体

所有带✔的关系必须有 valid_from / valid_to 字段。 时态是历史数据与普通数据的根本区别,CHGIS的核心价值就在于此,必须全盘继承。

五、时间建模细则(最容易出错的地方)

  1. 时间对象统一结构{原文表述, 纪年类型(公历/朝代年号/民国/干支), 换算公历值, 换算方式(自动/人工), 换算置信度, 粒度}
  2. 模糊时间如实降粒度:”是年秋”→存为当年9月±,粒度=季,禁止伪造成精确日期
  3. 朝代纪年换算表内置为受控资源(万历十四年→1586,多来源交叉验证);
  4. 区间开放语义:valid_to为空=延续至今;”不详”是合法值,不同于空值。

六、与现有标准的对齐映射(验收与流通的两张通行证)

你的层对齐对象方式
L0元数据江苏《地方志著录元数据规范》、成都DB5101/T 221、湖南加工规范Work实体字段与其一一映射,导出即合规
L0加工流程各省数字化加工规范加工合同直接引用其条款,降低投标响应成本
L1地点CHGIS地名辞典(tgaz.fudan.edu.cn,有开放API)place.chgis_id + same_as关系
L1地点GB/T 2260行政区划代码place.gb2260_code
L1时间GB/T 7408日期表示公历值字段格式
L1概念模型CIDOC-CRM(国际文化遗产本体)写一份轻量映射文档(Event≈E5, Actor≈E39/E74…),这张映射表是未来发论文、申标准、谈国际合作的接口