一個(gè)做DXF文件對(duì)比的開(kāi)源工具，在24小時(shí)內(nèi)把自己"殺死"了5次。

2024年3月，cad-dxf-agent的GitHub倉(cāng)庫(kù)突然靜默。不是 abandoned，是 metamorphosis。開(kāi)發(fā)者把過(guò)去18個(gè)月積累的確定性比對(duì)引擎——那個(gè)能逐像素檢測(cè)工程圖紙差異的CLI工具——連根拔起，種進(jìn)了一個(gè)叫IntentCAD的新骨架里。

同一天，5個(gè)EPIC（工程史詩(shī)）通過(guò)PR #73到#82集體落地。這不是版本迭代，是物種躍遷。

從"比對(duì)兩個(gè)文件"到"理解你想干什么"

舊工具的工作流很誠(chéng)實(shí)：你丟進(jìn)兩個(gè)DXF，它吐出差異報(bào)告。像一臺(tái)精密的天平，只回答"哪里不同"。

新架構(gòu)的核心是intent router（意圖路由器），PR #74。用戶(hù)用自然語(yǔ)言描述需求——"找出這張圖紙里所有重復(fù)的標(biāo)注模式"——系統(tǒng)不再硬編碼響應(yīng)，而是走一套契約驅(qū)動(dòng)的管道：

解析意圖 → 匹配能力契約 → 驗(yàn)證前置條件 → 執(zhí)行最高優(yōu)先級(jí)匹配

代碼很直白。每個(gè)能力（capability）注冊(cè)時(shí)聲明三件事：處理什么意圖類(lèi)型、需要什么會(huì)話狀態(tài)、產(chǎn)出什么結(jié)果。路由器本身不碰任何領(lǐng)域邏輯，新能力即插即用。

這不是聊天機(jī)器人套殼。是顯式階段（explicit stages）對(duì)隱式方法簽名的取代。

PR #75的提交信息很說(shuō)明問(wèn)題："Harden contracts against spec"。能力契約上線第一天就被加固——松散的類(lèi)型提示變成嚴(yán)格schema，本該必填的可選字段被修正。契約剛誕生就需硬化，這恰恰證明顯式schema比隱式簽名更值得維護(hù)。

單用戶(hù)CLI的"器官移植"

比對(duì)引擎最初為單人命令行會(huì)話設(shè)計(jì)。平臺(tái)化需要三件器官：認(rèn)證、授權(quán)、工作區(qū)隔離。

PR #80的UserManager類(lèi)暴露了遷移的殘酷性。Google身份令牌驗(yàn)證后，系統(tǒng)檢查白名單、upsert用戶(hù)記錄、隔離會(huì)話狀態(tài)。舊引擎的假設(shè)——"運(yùn)行這段代碼的人就是操作者"——被徹底推翻。

更隱蔽的改動(dòng)在PR #76：繪圖上下文（DrawingContext）現(xiàn)在攜帶用戶(hù)ID作用域。同一個(gè)比對(duì)算法，執(zhí)行時(shí)看到的圖紙視圖可能完全不同。多租戶(hù)不是加個(gè)字段，是重新設(shè)計(jì)數(shù)據(jù)流經(jīng)的每一條血管。

被低估的第五個(gè)EPIC

PR #78和#81處理了看似邊緣的場(chǎng)景：標(biāo)記語(yǔ)言解析（markup interpretation）和區(qū)域問(wèn)答（region Q&A）。

工程圖紙的標(biāo)記不是裝飾。紅圈、引線、云線批注承載著審查者的意圖——"這里有問(wèn)題"。舊工具把這些當(dāng)像素差異處理，新系統(tǒng)嘗試?yán)斫?這個(gè)紅圈指向的公差標(biāo)注是否與其他視圖沖突"。

區(qū)域問(wèn)答更激進(jìn)。用戶(hù)框選圖紙一角，問(wèn)"這個(gè)裝配間隙的歷史變更記錄"。系統(tǒng)需要關(guān)聯(lián)幾何位置、版本歷史、變更工單——把靜態(tài)圖紙變成可查詢(xún)的知識(shí)庫(kù)。

這兩個(gè)能力沒(méi)出現(xiàn)在早期產(chǎn)品路線圖上。是intent router的架構(gòu)彈性讓它們成為可能：新契約注冊(cè)，路由器自動(dòng)識(shí)別，無(wú)需改動(dòng)核心管道。

命名即戰(zhàn)略

從cad-dxf-agent到IntentCAD，刪除的是文件格式名，增加的是主語(yǔ)。

舊名字描述工具能處理什么文件。新名字描述用戶(hù)能表達(dá)什么意圖。這個(gè)重命名發(fā)生在PR #73，比五個(gè)EPIC早幾個(gè)小時(shí)——不是事后貼標(biāo)簽，是預(yù)先框定架構(gòu)方向。

開(kāi)發(fā)者在一個(gè)commit message里坦承："Calling it 'cad-dxf-agent' was underselling it by a factor of five." 低估五倍。五個(gè)EPIC恰好對(duì)應(yīng)五個(gè)被低估的能力維度：路由、契約硬化、多用戶(hù)、標(biāo)記理解、區(qū)域查詢(xún)。

GitHub的contribution graph顯示，這一天有11個(gè)contributor提交記錄。對(duì)于一個(gè)小眾工程工具，這密度暗示著某種協(xié)作模式的轉(zhuǎn)變——從個(gè)人維護(hù)者的問(wèn)題驅(qū)動(dòng)，到平臺(tái)架構(gòu)的能力驅(qū)動(dòng)。

IntentCAD的README至今保留著一行小字："Formerly cad-dxf-agent"。不是懷舊，是考古層。下一個(gè)從這個(gè)地基上長(zhǎng)出來(lái)的能力會(huì)是什么——當(dāng)用戶(hù)開(kāi)始用自然語(yǔ)言追問(wèn)"為什么這個(gè)設(shè)計(jì)在2023年Q2被否決"時(shí)，系統(tǒng)需要嫁接多少新的數(shù)據(jù)源？