這個開發(fā)者把AI當(dāng)文盲，寫了份只有機器能懂的"說明書"

AI讀網(wǎng)頁的方式，像極了你讓奶奶操作Excel——她得盯著每個單元格猜這表格是干嘛的，而你知道表頭、公式、數(shù)據(jù)驗證全藏在代碼里。Om Raj發(fā)現(xiàn)，今天的AI代理和編碼工具就是這么"讀"網(wǎng)站的：瞇著眼睛看原始HTML，試圖從壓縮后的JavaScript里反推開發(fā)者的真實意圖。組件之間的關(guān)系？品牌色的細(xì)微差別？底層API的數(shù)據(jù)結(jié)構(gòu)？全丟了。

他把這個問題量化得很具體：一個典型的Next.js項目里，設(shè)計令牌（design tokens）散落在Tailwind配置、CSS變量和組件props里，路由邏輯埋在文件系統(tǒng)約定中，API契約只有后端知道。AI看不到這些"隱式知識"，只能硬猜。

WebDNA是他給的解決方案——一份放在固定地址的站點"基因圖譜"。

從"盲人摸象"到"開卷考試"

這套系統(tǒng)直接嵌進(jìn)Next.js的構(gòu)建流程。項目打包時，WebDNA自動掃描三件事：路由樹長什么樣、Tailwind配置里提取了哪些設(shè)計令牌、組件層級如何嵌套。開發(fā)者不需要寫額外文檔，隱式知識被翻譯成顯式結(jié)構(gòu)，任何來訪的AI都能拿到一份完整簡報。

Om Raj對比了現(xiàn)有方案：站點地圖（sitemap）只給URL列表，robots.txt只會說"這里別爬"，純文本的AI說明文件（llms.txt）最多提供高層摘要。它們都不解釋設(shè)計系統(tǒng)，不說明動態(tài)路由的具體數(shù)據(jù)需求，更不告訴你哪個組件負(fù)責(zé)什么功能。

WebDNA的manifest文件填補了這個空缺。開發(fā)者可以標(biāo)記哪些區(qū)域是私有的，哪些組件承擔(dān)特定角色，品牌規(guī)范直接寫進(jìn)機器可讀的結(jié)構(gòu)。AI訪問時，不再是"看到什么算什么"，而是帶著完整上下文進(jìn)場。

安全設(shè)計被放在核心位置。manifest是靜態(tài)JSON，只讀且不可執(zhí)行。Om Raj加了元素級排除功能——給DOM節(jié)點加個屬性，就能讓這部分內(nèi)容對AI不可見。"這是基于同意的結(jié)構(gòu)化訪問，"他在文檔里寫，"不是讓AI工具能刮到什么算什么。"

為什么偏偏是現(xiàn)在

這個時機選得微妙。AI代理正在從"聊天窗口"變成"能動手"的工具——它們不只回答問題，還要幫你訂機票、改代碼、管理后臺。但網(wǎng)頁對它們來說，界面和API混成一團，操作風(fēng)險極高。

Om Raj舉了個具體場景：一個AI代理想幫用戶修改網(wǎng)站配色。沒有WebDNA，它得從CSS里猜主色、輔色、語義化顏色的區(qū)別，很可能把"錯誤紅"當(dāng)成"品牌紅"。有了manifest，設(shè)計令牌直接標(biāo)注用途，AI知道#EF4444是"destructive"（破壞性操作），不是品牌色。

另一個場景更實際：動態(tài)路由。/dashboard/[teamId]/settings 這個路徑，AI需要知道teamId從哪來、需要什么權(quán)限、設(shè)置頁面有哪些可配置項。傳統(tǒng)爬蟲只能看到最終HTML，WebDNA在構(gòu)建階段就把這些元數(shù)據(jù)打包好了。

這套方案目前鎖定Next.js生態(tài)，Tailwind是硬依賴。Om Raj的解釋很直接：這是現(xiàn)代Web開發(fā)最集中的技術(shù)棧，先解決這里的問題，再考慮擴展。GitHub倉庫和官方文檔（webdna.omraj.guru）已經(jīng)開放，但還沒看到大規(guī)模采用案例。

一個老問題的機器翻譯版本

WebDNA本質(zhì)上在做一件很熟悉的事：給機器寫注釋。只是注釋對象從"下一任維護(hù)代碼的人類"變成了"來訪的AI代理"。

這個思路有先例。Schema.org讓搜索引擎理解頁面內(nèi)容，Open Graph協(xié)議讓社交分享卡片更精準(zhǔn)，robots.txt給了爬蟲行為邊界。WebDNA想做的是同一類事，但針對AI代理的認(rèn)知需求——它們需要的不只是"這是什么"，而是"這東西怎么用、有什么限制、和其他東西什么關(guān)系"。

Om Raj的表述很克制。他沒提"顛覆"或"下一代Web標(biāo)準(zhǔn)"，只說"減少摩擦和錯誤"。但技術(shù)社區(qū)的反饋分化明顯：一部分人覺得這是必要的中間層，另一部分人擔(dān)心又多了一個需要維護(hù)的配置文件，而且鎖定在Vercel生態(tài)。

一個未被回答的問題是：如果AI代理的能力繼續(xù)提升，這種"顯式聲明"會不會變得多余？畢竟GPT-4已經(jīng)能從截圖里還原UI代碼， Claude能直接操作瀏覽器。WebDNA押注的是"結(jié)構(gòu)化信息永遠(yuǎn)比反向工程更高效"，但這個賭注的期限是多久？

項目GitHub倉庫的星標(biāo)數(shù)、首批采用者的反饋、以及Vercel官方是否會內(nèi)置支持——這三個信號，大概能告訴我們這份"機器說明書"有沒有未來。