Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions .github/workflows/production-truth.yml
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,8 @@ jobs:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
with:
fetch-depth: 0 # 乙未/戊午相容性測試要讀修正前的 commit(7ae87f6)作對照;淺層 checkout 抓不到

- uses: actions/setup-node@v4
with:
Expand All @@ -33,3 +35,6 @@ jobs:

- name: Arrival mechanics contracts (incl. 紙落定即入簿)
run: node scripts/test-arrival.mjs

- name: 乙未/戊午 repair — old books, notes and bindings still restore
run: node scripts/test-liushijiazi-book-compat.mjs
8 changes: 4 additions & 4 deletions assets/oracles.draw-pool.js
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
// Every entry passed the fail-closed production gates. Regenerate via: node scripts/build-draw-pool.mjs
window.DRAW_POOL = {
"schema": "draw-pool/1.0",
"content_version": "66068302782a9e690bd1d16c208678ac5022036d36a64b62d9a9d296249e9125",
"content_version": "9433062177a366ccd13b3708955704c73d035929e65a0eca3f9a8798d3f03527",
"policy": {
"allowed_transcription_status": [
"VERIFIED",
Expand Down Expand Up @@ -46,7 +46,7 @@ window.DRAW_POOL = {
"edition_title": "北港朝天宮官方六十甲子籤(modern reference edition)",
"slip_count": 60,
"source_file": "data/corpora/liushijiazi/slip_texts.json",
"source_sha256": "aa54acd813a1d22cca63388ca2a60ff31801de137887b2756fd75dbcdbbc6014",
"source_sha256": "b85e704ea80288b60103a554326461ec3233ab38c21876ce0c941e1bceddbd9c",
"data_quality": {
"decoded_char_refs": 0
},
Expand Down Expand Up @@ -3826,7 +3826,7 @@ window.DRAW_POOL = {
"slip_number": 10,
"original_slip_label": "乙未",
"historical_text": {
"poem_text": "右上角籤首資料\n花開結子一半枯\n可惜今年爾虛度\n漸漸日落西山去"
"poem_text": "花開結子一半枯\n可惜今年爾虛度\n漸漸日落西山去\n勸君不用向前途"
},
"provenance": {
"edition_id": "ref-lsjz-010",
Expand Down Expand Up @@ -4150,7 +4150,7 @@ window.DRAW_POOL = {
"slip_number": 28,
"original_slip_label": "戊午",
"historical_text": {
"poem_text": "右上籤號與卦象\n於今莫作此當時\n虎落平陽被犬欺\n世間凡事何難定"
"poem_text": "於今莫作此當時\n虎落平陽被犬欺\n世間凡事何難定\n千山萬水也遲疑"
},
"provenance": {
"edition_id": "ref-lsjz-028",
Expand Down
25 changes: 25 additions & 0 deletions data/corpora/liushijiazi/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,6 +62,31 @@ python3 data/corpora/liushijiazi/validate_corpus_package.py # 預期 517 PASS /

## 修改指南

### 2026-11-14 詩文 OCR 窄修(#10/#28)

依同版北港官方影像的 agent 目視核圖修復兩筆詩文;不是 human approval,
未升級 authenticity、license、human_verified 或 production eligibility。
原 OCR 錯文、逐句修復、來源 URL/SHA-256 保存在 Study 03 的
`poem-corrections.json`;原始 OCR evidence 不覆寫。詳見
`docs/LIUSHIJIAZI-OCR-REPAIR-2026-11-14.md`。

重建順序(repo root;Python 需 openpyxl,既有 validators 另需 jsonschema):

```bash
python3 research/oracle-corpus-study-03-liushijiazi-full/poem_corrections.py
python3 data/corpora/liushijiazi/build_corpus_package.py
python3 scripts/build-liushijiazi-texts.py
python3 data/corpora/liushijiazi/build_liushijiazi_layer.py
node scripts/build-draw-pool.mjs
python3 scripts/test-liushijiazi-poem-repair.py
node scripts/test-liushijiazi-book-compat.mjs
```

完整 acquisition 重跑時,`generate_ingest.py` 寫出 attestation 前也套用同一修正;
若遇到既有錯文/已核正讀法以外的新讀法會中止,要求重新核圖,不默默覆蓋。
corpus builder 另拒絕兩筆 stale ingest;production builder 拒絕兩個已知 OCR 標題。
這些都是窄範圍回歸防護,不是其餘籤文正確性的證明。

| 想改什麼 | 改哪裡 |
|---|---|
| 新增/修正研究結論 | 改 Study 03 frozen package(research/oracle-corpus-study-03-liushijiazi-full/data/*.jsonl),重跑 `build_corpus_package.py`——本目錄 6 檔為 derived artifact,不要手改 |
Expand Down
8 changes: 4 additions & 4 deletions data/corpora/liushijiazi/attestations.json
Original file line number Diff line number Diff line change
Expand Up @@ -391,14 +391,14 @@
"item_license_status": "unresolved",
"item_url": "https://www.matsu.org.tw/upload_files/web/uploadfile/2024080515/original/240805152108670080.jpg",
"license_status": "unsure",
"notes": "OCR 逐字轉錄官方圖檔,未改字;詩文層跨 carrier 交叉一致為佐證;五行/卦頭/聖意層個別欄位疑 OCR 誤讀待人工複核——不因不通順而猜改",
"notes": "原始 2026-08-15 註記(歷史轉錄聲明,非本次核驗結論):「OCR 逐字轉錄官方圖檔,未改字;詩文層跨 carrier 交叉一致為佐證;五行/卦頭/聖意層個別欄位疑 OCR 誤讀待人工複核——不因不通順而猜改」;2026-11-14 agent 目視核對同版官方原圖,僅修正詩文四句;非 human confirmation,其他欄位與狀態未升級;原 OCR/逐句修復與影像 SHA-256 見 poem-corrections.json#att-bg-010",
"numbering_in_source": "乙未",
"retrieval_date": "2026-08-15",
"slip_id": "slip-lsjz-010",
"slip_number": 10,
"source_id": "src-beigang-official",
"source_type": "primary",
"text": "右上角籤首資料\n花開結子一半枯\n可惜今年爾虛度\n漸漸日落西山去",
"text": "花開結子一半枯\n可惜今年爾虛度\n漸漸日落西山去\n勸君不用向前途",
"text_status": "uncertain",
"title_in_source": "可惜今年爾虛度",
"transcription_by": "agent(autoglm image recognition)",
Expand Down Expand Up @@ -1099,14 +1099,14 @@
"item_license_status": "unresolved",
"item_url": "https://www.matsu.org.tw/upload_files/web/uploadfile/2024080515/original/240805152118799412.jpg",
"license_status": "unsure",
"notes": "OCR 逐字轉錄官方圖檔,未改字;詩文層跨 carrier 交叉一致為佐證;五行/卦頭/聖意層個別欄位疑 OCR 誤讀待人工複核——不因不通順而猜改",
"notes": "原始 2026-08-15 註記(歷史轉錄聲明,非本次核驗結論):「OCR 逐字轉錄官方圖檔,未改字;詩文層跨 carrier 交叉一致為佐證;五行/卦頭/聖意層個別欄位疑 OCR 誤讀待人工複核——不因不通順而猜改」;2026-11-14 agent 目視核對同版官方原圖,僅修正詩文四句;非 human confirmation,其他欄位與狀態未升級;原 OCR/逐句修復與影像 SHA-256 見 poem-corrections.json#att-bg-028",
"numbering_in_source": "戊午",
"retrieval_date": "2026-08-15",
"slip_id": "slip-lsjz-028",
"slip_number": 28,
"source_id": "src-beigang-official",
"source_type": "primary",
"text": "右上籤號與卦象\n於今莫作此當時\n虎落平陽被犬欺\n世間凡事何難定",
"text": "於今莫作此當時\n虎落平陽被犬欺\n世間凡事何難定\n千山萬水也遲疑",
"text_status": "uncertain",
"title_in_source": "虎落平陽被犬欺",
"transcription_by": "agent(autoglm image recognition)",
Expand Down
4 changes: 4 additions & 0 deletions data/corpora/liushijiazi/build_corpus_package.py
Original file line number Diff line number Diff line change
Expand Up @@ -61,6 +61,10 @@ def main():
corpus_rows = load_jsonl(os.path.join(DATA_SRC, "corpus.jsonl"))
slips = load_jsonl(os.path.join(DATA_SRC, "slip.jsonl"))
atts = load_jsonl(os.path.join(DATA_SRC, "attestation.jsonl"))
# Refuse stale ingest even if someone bypasses the acquisition pipeline.
sys.path.insert(0, SRC)
from poem_corrections import validate_corrections
validate_corrections(atts)
items = load_jsonl(os.path.join(DATA_SRC, "concrete_item.jsonl"))
vgs = load_jsonl(os.path.join(DATA_SRC, "variant_group.jsonl"))
sources = load_jsonl(os.path.join(DATA_SRC, "source_record.jsonl"))
Expand Down
4 changes: 2 additions & 2 deletions data/corpora/liushijiazi/slip_texts.csv
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ deity_tradition,corpus_id,slip_number,original_slip_label,poem_text,edition,edit
媽祖(北港朝天宮,living-tradition mapping),liushijiazi,7,乙丑,雲開月出見分明;不須進退問前途;婚姻皆由天註定;和合清吉萬事成,北港朝天宮官方六十甲子籤(modern reference edition),ref-lsjz-007,現代(官方網站版;reference edition 由 Study 03 comparison 建立),https://www.matsu.org.tw/?act=menuinfo&ml_id=20240116002&cmd=list (北港官方籤詩列表);attestation: att-bg-007,PROBABLE,沿用 corpus package authenticity(58 PROBABLE / 2 VERIFIED);historical baseline 維持 0/60(古本文字未取得,不因身分證升級)
媽祖(北港朝天宮,living-tradition mapping),liushijiazi,8,乙卯,禾稻看看結成完;此事必定兩相全;回到家中寬心坐;妻兒鼓舞樂團圓,北港朝天宮官方六十甲子籤(modern reference edition),ref-lsjz-008,現代(官方網站版;reference edition 由 Study 03 comparison 建立),https://www.matsu.org.tw/?act=menuinfo&ml_id=20240116002&cmd=list (北港官方籤詩列表);attestation: att-bg-008,PROBABLE,沿用 corpus package authenticity(58 PROBABLE / 2 VERIFIED);historical baseline 維持 0/60(古本文字未取得,不因身分證升級)
媽祖(北港朝天宮,living-tradition mapping),liushijiazi,9,乙巳,龍虎相隨在深山;君爾何須背後看;不知此去相愛悞;他日與我卻無干,北港朝天宮官方六十甲子籤(modern reference edition),ref-lsjz-009,現代(官方網站版;reference edition 由 Study 03 comparison 建立),https://www.matsu.org.tw/?act=menuinfo&ml_id=20240116002&cmd=list (北港官方籤詩列表);attestation: att-bg-009,PROBABLE,沿用 corpus package authenticity(58 PROBABLE / 2 VERIFIED);historical baseline 維持 0/60(古本文字未取得,不因身分證升級)
媽祖(北港朝天宮,living-tradition mapping),liushijiazi,10,乙未,右上角籤首資料;花開結子一半枯;可惜今年爾虛度;漸漸日落西山去,北港朝天宮官方六十甲子籤(modern reference edition),ref-lsjz-010,現代(官方網站版;reference edition 由 Study 03 comparison 建立),https://www.matsu.org.tw/?act=menuinfo&ml_id=20240116002&cmd=list (北港官方籤詩列表);attestation: att-bg-010,PROBABLE,沿用 corpus package authenticity(58 PROBABLE / 2 VERIFIED);historical baseline 維持 0/60(古本文字未取得,不因身分證升級)
媽祖(北港朝天宮,living-tradition mapping),liushijiazi,10,乙未,花開結子一半枯;可惜今年爾虛度;漸漸日落西山去;勸君不用向前途,北港朝天宮官方六十甲子籤(modern reference edition),ref-lsjz-010,現代(官方網站版;reference edition 由 Study 03 comparison 建立),https://www.matsu.org.tw/?act=menuinfo&ml_id=20240116002&cmd=list (北港官方籤詩列表);attestation: att-bg-010,PROBABLE,沿用 corpus package authenticity(58 PROBABLE / 2 VERIFIED);historical baseline 維持 0/60(古本文字未取得,不因身分證升級)
媽祖(北港朝天宮,living-tradition mapping),liushijiazi,11,乙酉,靈雞漸漸見分明;凡事且看子丑寅;雲開月出照天下;郎君即便見太平,北港朝天宮官方六十甲子籤(modern reference edition),ref-lsjz-011,現代(官方網站版;reference edition 由 Study 03 comparison 建立),https://www.matsu.org.tw/?act=menuinfo&ml_id=20240116002&cmd=list (北港官方籤詩列表);attestation: att-bg-011,PROBABLE,沿用 corpus package authenticity(58 PROBABLE / 2 VERIFIED);historical baseline 維持 0/60(古本文字未取得,不因身分證升級)
媽祖(北港朝天宮,living-tradition mapping),liushijiazi,12,乙亥,長江風浪漸漸靜;于今得進可安寧;必有貴人相扶助;凶事脫出見太平,北港朝天宮官方六十甲子籤(modern reference edition),ref-lsjz-012,現代(官方網站版;reference edition 由 Study 03 comparison 建立),https://www.matsu.org.tw/?act=menuinfo&ml_id=20240116002&cmd=list (北港官方籤詩列表);attestation: att-bg-012,PROBABLE,沿用 corpus package authenticity(58 PROBABLE / 2 VERIFIED);historical baseline 維持 0/60(古本文字未取得,不因身分證升級)
媽祖(北港朝天宮,living-tradition mapping),liushijiazi,13,丙子,命內正逢羅孛關;用盡心機總未休;作福問神難得過;恰是行舟上高灘,北港朝天宮官方六十甲子籤(modern reference edition),ref-lsjz-013,現代(官方網站版;reference edition 由 Study 03 comparison 建立),https://www.matsu.org.tw/?act=menuinfo&ml_id=20240116002&cmd=list (北港官方籤詩列表);attestation: att-bg-013,PROBABLE,沿用 corpus package authenticity(58 PROBABLE / 2 VERIFIED);historical baseline 維持 0/60(古本文字未取得,不因身分證升級)
Expand All @@ -26,7 +26,7 @@ deity_tradition,corpus_id,slip_number,original_slip_label,poem_text,edition,edit
媽祖(北港朝天宮,living-tradition mapping),liushijiazi,25,戊子,總是前途莫心勞;求神問聖枉是多;但看雞犬日過後;不須作福事如何,北港朝天宮官方六十甲子籤(modern reference edition),ref-lsjz-025,現代(官方網站版;reference edition 由 Study 03 comparison 建立),https://www.matsu.org.tw/?act=menuinfo&ml_id=20240116002&cmd=list (北港官方籤詩列表);attestation: att-bg-025,PROBABLE,沿用 corpus package authenticity(58 PROBABLE / 2 VERIFIED);historical baseline 維持 0/60(古本文字未取得,不因身分證升級)
媽祖(北港朝天宮,living-tradition mapping),liushijiazi,26,戊寅,選出牡丹第一枝;勸君折取莫遲疑;世間若問相知處;萬事逢春正及時,北港朝天宮官方六十甲子籤(modern reference edition),ref-lsjz-026,現代(官方網站版;reference edition 由 Study 03 comparison 建立),https://www.matsu.org.tw/?act=menuinfo&ml_id=20240116002&cmd=list (北港官方籤詩列表);attestation: att-bg-026,PROBABLE,沿用 corpus package authenticity(58 PROBABLE / 2 VERIFIED);historical baseline 維持 0/60(古本文字未取得,不因身分證升級)
媽祖(北港朝天宮,living-tradition mapping),liushijiazi,27,戊辰,君爾寬心且自由;門庭清吉家無憂;財寶自然終吉利;凡事無傷不用求,北港朝天宮官方六十甲子籤(modern reference edition),ref-lsjz-027,現代(官方網站版;reference edition 由 Study 03 comparison 建立),https://www.matsu.org.tw/?act=menuinfo&ml_id=20240116002&cmd=list (北港官方籤詩列表);attestation: att-bg-027,PROBABLE,沿用 corpus package authenticity(58 PROBABLE / 2 VERIFIED);historical baseline 維持 0/60(古本文字未取得,不因身分證升級)
媽祖(北港朝天宮,living-tradition mapping),liushijiazi,28,戊午,右上籤號與卦象;於今莫作此當時;虎落平陽被犬欺;世間凡事何難定,北港朝天宮官方六十甲子籤(modern reference edition),ref-lsjz-028,現代(官方網站版;reference edition 由 Study 03 comparison 建立),https://www.matsu.org.tw/?act=menuinfo&ml_id=20240116002&cmd=list (北港官方籤詩列表);attestation: att-bg-028,PROBABLE,沿用 corpus package authenticity(58 PROBABLE / 2 VERIFIED);historical baseline 維持 0/60(古本文字未取得,不因身分證升級)
媽祖(北港朝天宮,living-tradition mapping),liushijiazi,28,戊午,於今莫作此當時;虎落平陽被犬欺;世間凡事何難定;千山萬水也遲疑,北港朝天宮官方六十甲子籤(modern reference edition),ref-lsjz-028,現代(官方網站版;reference edition 由 Study 03 comparison 建立),https://www.matsu.org.tw/?act=menuinfo&ml_id=20240116002&cmd=list (北港官方籤詩列表);attestation: att-bg-028,PROBABLE,沿用 corpus package authenticity(58 PROBABLE / 2 VERIFIED);historical baseline 維持 0/60(古本文字未取得,不因身分證升級)
媽祖(北港朝天宮,living-tradition mapping),liushijiazi,29,戊申,枯木可惜未逢春;如今還在暗中藏;寬心且守風霜退;還君依舊作乾坤,北港朝天宮官方六十甲子籤(modern reference edition),ref-lsjz-029,現代(官方網站版;reference edition 由 Study 03 comparison 建立),https://www.matsu.org.tw/?act=menuinfo&ml_id=20240116002&cmd=list (北港官方籤詩列表);attestation: att-bg-029,PROBABLE,沿用 corpus package authenticity(58 PROBABLE / 2 VERIFIED);historical baseline 維持 0/60(古本文字未取得,不因身分證升級)
媽祖(北港朝天宮,living-tradition mapping),liushijiazi,30,戊戍,漸漸看此月中和;過後須妨未得高;改變顏色前途去;凡事必定見重勞,北港朝天宮官方六十甲子籤(modern reference edition),ref-lsjz-030,現代(官方網站版;reference edition 由 Study 03 comparison 建立),https://www.matsu.org.tw/?act=menuinfo&ml_id=20240116002&cmd=list (北港官方籤詩列表);attestation: att-bg-030,PROBABLE,沿用 corpus package authenticity(58 PROBABLE / 2 VERIFIED);historical baseline 維持 0/60(古本文字未取得,不因身分證升級)
媽祖(北港朝天宮,living-tradition mapping),liushijiazi,31,己丑,綠柳蒼蒼正當時;任君此去作乾坤;花葉結實無殘謝;福祿自有慶家門,北港朝天宮官方六十甲子籤(modern reference edition),ref-lsjz-031,現代(官方網站版;reference edition 由 Study 03 comparison 建立),https://www.matsu.org.tw/?act=menuinfo&ml_id=20240116002&cmd=list (北港官方籤詩列表);attestation: att-bg-031,PROBABLE,沿用 corpus package authenticity(58 PROBABLE / 2 VERIFIED);historical baseline 維持 0/60(古本文字未取得,不因身分證升級)
Expand Down
4 changes: 2 additions & 2 deletions data/corpora/liushijiazi/slip_texts.json
Original file line number Diff line number Diff line change
Expand Up @@ -126,7 +126,7 @@
"corpus_id": "liushijiazi",
"slip_number": 10,
"original_slip_label": "乙未",
"poem_text": "右上角籤首資料\n花開結子一半枯\n可惜今年爾虛度\n漸漸日落西山去",
"poem_text": "花開結子一半枯\n可惜今年爾虛度\n漸漸日落西山去\n勸君不用向前途",
"edition_id": "ref-lsjz-010",
"edition_title": "北港朝天宮官方六十甲子籤(modern reference edition)",
"edition_date_period": "現代(官方網站版;reference edition 由 Study 03 comparison 建立)",
Expand Down Expand Up @@ -360,7 +360,7 @@
"corpus_id": "liushijiazi",
"slip_number": 28,
"original_slip_label": "戊午",
"poem_text": "右上籤號與卦象\n於今莫作此當時\n虎落平陽被犬欺\n世間凡事何難定",
"poem_text": "於今莫作此當時\n虎落平陽被犬欺\n世間凡事何難定\n千山萬水也遲疑",
"edition_id": "ref-lsjz-028",
"edition_title": "北港朝天宮官方六十甲子籤(modern reference edition)",
"edition_date_period": "現代(官方網站版;reference edition 由 Study 03 comparison 建立)",
Expand Down
Binary file modified data/corpora/liushijiazi/slip_texts_review.xlsx
Binary file not shown.
4 changes: 2 additions & 2 deletions data/corpora/liushijiazi/slips.json
Original file line number Diff line number Diff line change
Expand Up @@ -214,7 +214,7 @@
"reference_attestation_id": "att-bg-010",
"reference_basis": "北港官方圖檔版為 comparison-based reference edition(60-vs-60 全量比對;#7 #19 #38 #41 #46 #48 #57 #60 另經 human 目視確認 observed transcription)",
"reference_edition_id": "ref-lsjz-010",
"reference_text": "右上角籤首資料\n花開結子一半枯\n可惜今年爾虛度\n漸漸日落西山去",
"reference_text": "花開結子一半枯\n可惜今年爾虛度\n漸漸日落西山去\n勸君不用向前途",
"slip_id": "slip-lsjz-010",
"slip_number": 10,
"source_package_notes": "干支 乙未(官網列表 label)"
Expand Down Expand Up @@ -610,7 +610,7 @@
"reference_attestation_id": "att-bg-028",
"reference_basis": "北港官方圖檔版為 comparison-based reference edition(60-vs-60 全量比對;#7 #19 #38 #41 #46 #48 #57 #60 另經 human 目視確認 observed transcription)",
"reference_edition_id": "ref-lsjz-028",
"reference_text": "右上籤號與卦象\n於今莫作此當時\n虎落平陽被犬欺\n世間凡事何難定",
"reference_text": "於今莫作此當時\n虎落平陽被犬欺\n世間凡事何難定\n千山萬水也遲疑",
"slip_id": "slip-lsjz-028",
"slip_number": 28,
"source_package_notes": "干支 戊午(官網列表 label)"
Expand Down
Loading
Loading