ARHG — AI 可讀超連結圖層
AI 可讀超連結圖層
與一般網站並存的機器可讀導覽圖,讓 agent 不必解析選單、不必猜測網址,就能發現並遍歷它被允許存取的部分。
01 · 定義
ARHG 是位於本站其他協議之下的發現與可見性語義層。Sitemap 回答「有哪些網址存在」;robots.txt 回答「爬蟲原則上允許抓哪些路徑」;ARHG 回答的則是「這項資源是什麼、它跟其他資源有什麼關係、我接下來能去哪裡」。它把一個網站(或一組網站)建模為一個型別化、分級授權的圖 G=(V,E,M,P),並依角色各自算出一個經過過濾的子圖 G_a = G[V_a]——因此一個公開爬蟲、一個已驗證的 agent,跟一位管理員,看到的不是同一張地圖。它的核心公理是:知道一個網址,永遠不等於擁有存取權——KnowURL(a,v) 不蘊含 Access(a,v)——因此授權必須在伺服器端獨立驗證,絕不能只靠不把連結放進頁面來「隱藏」。ARHG 刻意不決定一項資源被找到之後,agent 能不能對它做什麼:內容使用的問題留給 AICR/AILP,行動與權力的問題留給 AARS/AADP。它回答的是這兩者之前更上游的問題——這項資源能不能被找到、被誰找到,以及找到之後能走向哪裡。
02 · 目的
- 以一個機器可遍歷的、明確型別化的圖,取代猜測網址與解析選單。
- 把發現跟授權分開:一個節點出現在公開清單裡,本身永遠不代表取得對它的讀取、寫入或執行權。
- 讓每個節點與邊,都擁有獨立於網址之外的穩定身分,並附帶明確宣告的可見性級別。
- 提供 AICR/AILP 的內容權利與 AARS/AADP 的行動權利,兩者都建立其上、卻都沒有定義的那個發現層。
03 · 範圍
四級可見性 — —public/preview/internal/private
依角色而異的子圖 — —public、crawler、agent、editor、admin、owner 各自看到自己的 G_a = G[V_a]
型別化節點 — —website、page、project、paper、repository、dataset、api、agent、service、protocol 等
型別化邊 — —parent、child、related、depends_on、implements、extends、replaces、source、canonical、mirror 等
建議的發現端點 — —/.well-known/agent-map、/links/、/links/index.json、/links/index.md
可被發現不代表可被讀取 — —一個節點可以出現在清單中,其內容仍可能需要另外的存取授權
04 · 機器可讀範例
本站自己的圖 — /links/index.json
{
"arhg_version": "0.1",
"site": {
"id": "agiright",
"title": "AGIRight.org",
"canonical_url": "https://agiright.org",
"version": "v0.12.1"
},
"role": "public",
"nodes": [
{
"id": "section.protocols",
"type": "section",
"title": "Protocols",
"canonical_url": "https://agiright.org/protocols",
"visibility": "public",
"discoverable": true,
"allowed_roles": ["public", "crawler", "agent", "editor", "admin", "owner"]
},
{
"id": "protocol.arhg",
"type": "protocol",
"title": "ARHG -- Agent-Readable Hyperlink Graph",
"canonical_url": "https://agiright.org/protocols/arhg",
"visibility": "public",
"discoverable": true,
"allowed_roles": ["public", "crawler", "agent", "editor", "admin", "owner"]
}
],
"edges": [
{ "from": "section.protocols", "to": "protocol.arhg", "relation": "child", "visibility": "public", "traversable": true }
]
} 05 · 限制與邊界
- ARHG 描述的是發現與可見性語義;它本身並不決定一項被發現的資源,能不能被讀取、被學習,或被據以採取行動——這些問題請見 AICR/AILP 與 AARS/AADP。
- 目前為開放研究草案,尚非已採納的標準;本站不主張目前有任何爬蟲或 agent 框架,已經會去讀取 /.well-known/agent-map。
- 本站目前沒有 preview/internal/private 內容,因此本站自己的即時圖,目前只用到 public 這一級——分級可見性的機制已在程式碼中實作並強制執行,但尚未在真實的非公開資料上驗證過。
- 改編自一份更大的來源規格文件(Neo.K/EveMissLab,2026-09-22);其參考實作還包含一套用於 agent 對 agent 支付與跨站合約清算的經濟/結算/聯邦擴充層——AGIRight 尚未採用這一層,詳見本站原始碼中的 reference/arhg-source/README.md。