一個(gè)腳本標(biāo)簽，讓網(wǎng)頁(yè)上所有表單變成AI可調(diào)用的工具——不用手寫JSON Schema。這是auto-webmcp第一版的承諾。過(guò)去48小時(shí)，他們?cè)庥隽苏鎸?shí)網(wǎng)頁(yè)的每一種刁難：React表單跟你對(duì)著干、游離在form標(biāo)簽外的輸入框、撒謊的下拉菜單，還有新版WebMCP規(guī)范里讓工具好用10倍的新字段。

好消息是，v0.3.0全解決了。

React的"影子狀態(tài)"：你改了DOM，它裝沒(méi)看見

原生表單像敞開的倉(cāng)庫(kù)，直接進(jìn)去搬東西就行。React表單是個(gè)黑箱——你往input.value塞數(shù)據(jù)，界面變了，React的狀態(tài)管理卻毫無(wú)知覺。

DOM顯示"foo"，React內(nèi)部記的還是空字符串。表單提交時(shí)，數(shù)據(jù)干干凈凈地消失了。

auto-webmcp的解法很粗暴：繞過(guò)React的合成事件系統(tǒng)，直接操作HTMLInputElement的原型方法。先調(diào)用原生setter改值，再手動(dòng)拋出一個(gè)冒泡的input事件，騙過(guò)React的onChange監(jiān)聽：

// 內(nèi)部處理React受控輸入的方式 const nativeSetter = Object.getOwnPropertyDescriptor( HTMLInputElement.prototype, 'value' ).set; nativeSetter.call(input, value); input.dispatchEvent(new Event('input', { bubbles: true }));

老舊的content-editable編輯器用execCommand插入文本？也做了降級(jí)兼容。

更隱蔽的坑：AI填完表，React觸發(fā)重渲染，字段值可能被重置?，F(xiàn)在他們?cè)谔畛渫瓿珊罅⒓床东@快照，提交時(shí)用這個(gè)快照構(gòu)造響應(yīng)，而不是回頭去查可能已經(jīng)變了的DOM。

多步React流程里，表單字段是懶加載的。MutationObserver的重新分析加了防抖——新字段出現(xiàn)時(shí)自動(dòng)更新schema，不會(huì)重復(fù)注冊(cè)工具。

ARIA角色：屏幕讀者能讀的，AI也該能讀

網(wǎng)頁(yè)上大量輸入框根本不是input元素。富文本編輯器、自定義下拉、日期選擇器——它們靠role="textbox"、role="combobox"、role="spinbutton"告訴屏幕閱讀器"我是輸入框"。

auto-webmcp現(xiàn)在讀同樣的信號(hào)。帶ARIA輸入角色的元素會(huì)被納入schema，字段名從aria-label或關(guān)聯(lián)的label元素推斷。

React里常見一種情況：輸入框沒(méi)有name屬性，表單狀態(tài)存在JS里而非DOM中?，F(xiàn)在用id或aria-label作為schema字段的key，AI仍能按名稱引用和填充。

一個(gè)具體修復(fù)：Ghost的郵件訂閱表單用了input type="email"，沒(méi)有name也沒(méi)有id，只有一個(gè)placeholder。以前這種表單被靜默忽略，現(xiàn)在placeholder直接當(dāng)字段key和標(biāo)題用。

WebMCP規(guī)范：讓工具從"能用"變"好用"

v0.3.0完整支持新版WebMCP規(guī)范的幾個(gè)關(guān)鍵字段。destinations字段讓工具聲明自己能往哪發(fā)請(qǐng)求——某些代理會(huì)據(jù)此決定是否調(diào)用。annotations.cost提示工具的執(zhí)行成本，幫助代理做預(yù)算控制。示例字段直接告訴AI"這個(gè)參數(shù)該填什么格式"。

這些不是裝飾。一個(gè)沒(méi)填destinations的工具，可能在代理眼里根本不存在；沒(méi)給annotations.cost的，可能在復(fù)雜工作流里被無(wú)限期擱置。

schema生成也有改進(jìn)。textarea現(xiàn)在正確標(biāo)記為多行文本，number和range輸入框帶上min/max約束，checkbox和radio的選項(xiàng)從label文本提取而非留空。

錯(cuò)誤處理更細(xì)了。表單驗(yàn)證失敗時(shí)，返回的結(jié)構(gòu)包含具體字段的錯(cuò)誤信息，代理可以針對(duì)性重試而非盲目再填一遍。

性能方面，大型表單的schema生成快了約40%。他們緩存了DOM查詢結(jié)果，避免在復(fù)雜表單里反復(fù)遍歷同一棵樹。

一個(gè)被反復(fù)請(qǐng)求的功能：現(xiàn)在支持通過(guò)data-auto-webmcp="exclude"屬性手動(dòng)排除特定字段。敏感信息、CSRF令牌、裝飾性輸入——開發(fā)者可以精確控制AI能看到什么。

文檔站點(diǎn)同步更新，每個(gè)新特性都有可運(yùn)行的代碼片段。GitHub Releases頁(yè)面列出了完整的遷移指南，從v0.2.x升級(jí)通常只需改幾行配置。

團(tuán)隊(duì)在社區(qū)討論里提到，下一個(gè)版本的重點(diǎn)是多頁(yè)應(yīng)用支持——目前auto-webmcp假設(shè)所有表單都在當(dāng)前頁(yè)面上，SPA路由切換后的新表單需要重新初始化。他們正在探索與React Router、Vue Router等主流方案的無(wú)縫集成。

如果你在用React做后臺(tái)系統(tǒng)，表單復(fù)雜到讓人頭疼，現(xiàn)在有個(gè)問(wèn)題：你會(huì)愿意讓AI代理直接操作這些表單，還是寧可自己封裝API？