「河流是土地的神經脈絡，而目錄樹就是最直觀的空間記憶。」
查閱水文資料時最直覺的痛點，莫過於看到溪名卻對不上它歸屬哪條大河、最後從哪個縣市出海。在 v2.5 中，我們把全台灣 150 條獨立入海主流與 1,400 多條支流親緣關係，全面「目錄樹 (Directory Tree)」實體化！

💡 痛點直擊：為什麼要用「縣市 ➔ 水系 ➔ 支流樹」目錄來呈現？#

過去大家在走讀或尋找河川資料時，常遇到「見樹不見林」的困境。雖然資料庫有完美的拓樸程式碼，但對探索者來說，最親切的語言還是**「這條河從哪個縣市出海？」**

在 v2.5 版本中，我們以大眾直覺的**「出海口歸屬縣市」**為第一層基石，把龐雜的水系拓樸重構為人人電腦裡都有的檔案資料夾結構。現在，只要打開檔案總管，就能像翻閱家族樹一樣，直觀地理解每一條溪流的來龍去脈。

🌳 樹狀結構設計與閱讀架構#

整體目錄採用了三階遞進的親緣架構，兼顧直觀空間感與詳細的人文資訊：

data/river_tree/
├── 67000_臺南市/                   <-- 第一層：出海口歸屬縣市 (全台 16 縣市)
│   ├── 166000_二仁溪/               <-- 第二層：獨立入海主流 (172 條幹流)
│   │   ├── 166000-C01_三爺宮溪/      <-- 第三層：一級支流 (親緣鏈)
│   │   │   └── record.json          <-- 水脈記憶卡 (詳細履歷與地名備註)
│   │   ├── 166000-C02_松子腳溪/     <-- 第三層：一級支流
│   │   │   └── record.json
│   │   └── record.json
│   └── record.json

🧭 出海口定位與縣市歸類邏輯#

要讓全台灣 172 條獨立入海主流 100% 歸屬至 16 個縣市（徹底消除「未定縣市」），我們建立了四階遞進的定位與仲裁邏輯：

  1. 第一階：權威界河「右岸原則」仲裁 (Border Arbitration)
    • 對於淡水河、濁水溪、頭前溪等跨縣市界河，依據水理地理慣例與出海口右岸管轄權進行確定性仲裁（例如：淡水河仲裁至新北市、濁水溪仲裁至雲林縣、頭前溪仲裁至新竹市）。
  2. 第二階：出海口 GPS 點位與空間疊合 (GPS Spatial Join)：
    • 透過出海口的實體經緯度座標，與內政部全台縣市多邊形邊界進行空間疊合（Spatial Join），並輔以經濟部水利署河川分署管轄邊界進行交叉防護。
  3. 第三階：地名語意與條目內文萃取 (Locality Text Extraction)：
    • 若為維基百科或地方志紀錄之溪流，自動提取名稱或內文中的傳統鄉鎮與地方關鍵字進行語意推導（例如：從「鹿港溪」推導歸屬至彰化縣，從「公司田溪」推導歸屬至新北市）。
  4. 第四階：親緣繼承與分署預設 fallback (Basin & Office Fallback)：
    • 支流自動繼承母水系主流之縣市歸屬；少數小型獨立野溪則依經濟部水利署該管河川分署的主力縣市進行補齊。

📖 結語與專書公開#

這次 v2.5 的釋出，不僅是資料庫與工具鏈的升級，更是希望給所有喜愛台灣河流、走讀土地的朋友，一套最直觀、最容易使用的「數位雙生河流地圖」。

  • GitHub 開源水系親緣樹目錄：RiverExploration / data / river_tree
  • 專書合訂本：events/AIBooks/RiverExploration/RiverExploration_FullBook.md
  • 本機實體親緣樹目錄：events/AIBooks/RiverExploration/data/river_tree/

歡迎大家打開 GitHub 或本地資料夾，一起探索咱台灣母親之河的親緣脈絡！

AI 協作聲明： 本文由筆者提供原始概念與寫作架構，由 AI 助手 Antigravity 彙整修辭與技術內容。結合了 WalkGIS 的地理紀錄特點與哈爸筆記的敘事風格，展現人機協作下的流域探索成果。