很多企業(yè)的自動化項目，第一眼看起來都“成功”了：瀏覽器點到了按鈕，頁面彈出綠色提示，流程也沒有報錯。月底一查，系統(tǒng)記錄卻沒寫進去，或者重復(fù)寫了兩次。真正難的不是讓電腦完成點擊，而是確認業(yè)務(wù)結(jié)果真的落賬。

如果舊后臺沒有 API，企業(yè)不一定要立刻重寫系統(tǒng)，也不應(yīng)該直接把真實賬號交給一個“會點網(wǎng)頁”的 Agent。更穩(wěn)妥的順序是：先選一個低風(fēng)險任務(wù)，錄制一次，編譯成可讀的流程包，重放后從獨立的 system of record 回讀結(jié)果，再決定是否擴大。

本文依據(jù) OpenAdapt 官方倉庫與 README、官方 pyproject.toml、MIT LICENSE 和 v1.16.0 Release 整理。我們沒有在本機安裝、下載 Chromium、運行 quickstart 或錄制真實流程；命令和回執(zhí)均標(biāo)為官方說明。

OpenAdapt 先解決什么問題

OpenAdapt 的官方定位不是“讓模型自由操作所有軟件”，而是把一次 GUI 演示編譯成確定性、可在本地執(zhí)行的程序。健康運行不把模型放在執(zhí)行回路中；運行結(jié)束前，還要對照獨立系統(tǒng)記錄檢查聲明的業(yè)務(wù)效果。

這對舊系統(tǒng)尤其重要。頁面出現(xiàn)“保存成功”只能說明界面畫了一個狀態(tài)，不能證明數(shù)據(jù)庫、訂單表或后臺記錄已經(jīng)更新。一個值得交接的流程至少要回答四件事：寫了哪條記錄、由誰的身份寫、寫入后從哪里讀回來、讀不到時誰有權(quán)暫停。

官方最低安裝與 quickstart

官方 pyproject.toml 要求 Python >=3.10,<3.13，也就是 Python 3.10、3.11 或 3.12。基礎(chǔ)安裝路徑為：

python -m pip install --upgrade openadapt
openadapt quickstart

README 寫明，基礎(chǔ) quickstart 不要求賬號、API Key 或額外包；第一次瀏覽器動作會自行下載 Chromium。官方示例在 MockMed 合成練習(xí) fixture 中完成記錄、編譯、認證、執(zhí)行和只讀回查，示例回執(zhí)包含：

VERIFIED in 4.1s; 0 model calls
VERIFIED: openadapt-quickstart/run/REPORT.md
effects 2/2 confirmed at evidence tier 1 (independent system of record)

這里的秒數(shù)、模型調(diào)用數(shù)和記錄數(shù)量都屬于 README 的示例環(huán)境，不能改寫成本機性能或企業(yè)結(jié)果。基礎(chǔ)包之外，原生桌面、RDP、Windows UI Automation、macOS Accessibility、Linux AT-SPI 和隱私清洗等能力需要按目標(biāo)環(huán)境安裝相應(yīng) extras。

錄制、編譯、重放：一條流程的官方路徑

真實 Web 流程的 README 示例是：

openadapt flow record --backend web --url https://your-app.example --out rec
openadapt flow compile rec --out bundle --name my-workflow
openadapt flow replay bundle --url https://your-app.example --run-dir run

這三步不等于“任意后臺都能穩(wěn)定運行”。錄制前先寫清應(yīng)用邊界、身份、動作風(fēng)險、目標(biāo)唯一性和效果字段；編譯后檢查 bundle 是否包含這些契約；重放后從獨立記錄讀取，不要只看頁面顏色或成功橫幅。openadapt flow visualize 可以幫助審閱圖形化流程，openadapt flow lint 可以檢查編譯內(nèi)容和未覆蓋的條件。

企業(yè)試點應(yīng)按什么順序做

第一輪建議使用合成或公開 Web 表單，不接客戶真實賬號、不改真實業(yè)務(wù)數(shù)據(jù)：

1. 選一個任務(wù)：例如測試環(huán)境中的新增記錄、報表錄入或內(nèi)部樣品歸檔。
2. 列出效果字段：明確什么記錄變化才算成功，如何識別重復(fù)寫入。
3. 固定身份與權(quán)限：寫下運行者、批準(zhǔn)者、暫停者和目標(biāo)系統(tǒng)的最小權(quán)限。
4. 錄制并編譯：保留原始錄制、bundle 版本、目標(biāo)環(huán)境和回滾點。
5. 重放并回讀：執(zhí)行后用獨立只讀接口或人工核對確認記錄真的存在。
6. 制造一個失敗分支：讓頁面顯示成功但記錄不落賬，確認運行會停下。
7. 做停止決定：根據(jù)錯誤類型、維護成本和業(yè)務(wù)方反饋決定繼續(xù)、縮小邊界或停止。

失敗狀態(tài)不能混寫

README 把不同結(jié)果分開命名：

• VERIFIED：聲明的效果和旁作用檢查都通過，才是生產(chǎn)意義上的成功。
• HALTED_BEFORE_EFFECT：在產(chǎn)生后果前安全停止，并有證據(jù)表明沒有發(fā)生業(yè)務(wù)效果。
• RECONCILIATION_REQUIRED：狀態(tài)沖突、交付不確定或暫時無法核對，必須重新讀取現(xiàn)場，不能盲目重試。
• FAILED_PLATFORM、CANCELED、REJECTED_POLICY、COMPLETED_UNVERIFIED 和 ROLLED_BACK：分別說明平臺失敗、主動取消、策略拒絕、只有演示完成但缺少生產(chǎn)級證據(jù)，或重復(fù)/旁作用已補償并重新核驗。

其中最容易被忽略的是 RECONCILIATION_REQUIRED。如果頁面說成功、獨立記錄卻查不到，正確動作不是再點一次，而是保留證據(jù)、暫停流程、讓負責(zé)人重新核對目標(biāo)記錄和權(quán)限。把不確定狀態(tài)寫成成功，后續(xù)的重復(fù)寫入和責(zé)任追蹤都會更難。

七天驗證一條可停止流程

| 天數(shù) | 動作 | 需要留下的證據(jù) | | ---: | --- | --- | | 1 | 選合成或公開 Web 任務(wù) | 唯一目標(biāo)和不做什么 | | 2 | 列動作、身份、權(quán)限和效果字段 | 業(yè)務(wù)負責(zé)人確認 | | 3 | 按官方命令安裝 | Python、版本、Chromium 狀態(tài) | | 4 | 錄制、編譯、重放一次 | bundle、運行目錄和回執(zhí) | | 5 | 制造頁面成功但未落賬 | 停止?fàn)顟B(tài)與人工核對記錄 | | 6 | 給三位潛在買方看樣品 | 是否愿意提供脫敏流程 | | 7 | 做停、縮小或繼續(xù)決定 | 維護成本和下一步 |

這張表的目的是縮短試錯，不是承諾七天交付生產(chǎn)系統(tǒng)。真實系統(tǒng)的頁面改版、驗證碼、網(wǎng)絡(luò)波動、權(quán)限變化、效果接口和數(shù)據(jù)權(quán)利，都要在目標(biāo)環(huán)境重新驗收。

交接前的八項清單

• 一個明確的流程邊界，以及明確不做的動作；
• 動作、身份、權(quán)限和目標(biāo)記錄的唯一性；
• 獨立 system of record 的讀取方式和證據(jù)等級；
• 頁面改版、網(wǎng)絡(luò)異常和失敗分支的處理方式；
• 憑據(jù)、審批、日志和運行權(quán)限的歸屬；
• 回執(zhí)、版本、原始錄制和 bundle 的留檔位置；
• 停用、回滾、重復(fù)寫入保護和人工接管步驟；
• 客戶資料、模型/第三方服務(wù)條款和持續(xù)維護成本。

本地、客戶控制和托管邊界

官方 README 區(qū)分 Local / self-hosted、Customer-controlled 和 Managed execution。原始錄制與現(xiàn)場觀察默認留在本地；只有經(jīng)過顯式清洗和逐字節(jié)批準(zhǔn)，產(chǎn)物才跨越邊界。企業(yè)不能因為“本地運行”四個字，就推斷目標(biāo)系統(tǒng)、遠程桌面、模型或日志都沒有離開自己的控制范圍。

如果目標(biāo)是桌面應(yīng)用、RDP、Citrix 或私有網(wǎng)絡(luò)，需確認對應(yīng) adapter、屏幕/窗口范圍、憑據(jù)隔離和回讀證據(jù)。基礎(chǔ) quickstart 的瀏覽器樣例不能代替這些環(huán)境的資格驗證。

適用邊界與服務(wù)入口

OpenAdapt 適合操作固定、風(fēng)險可控、效果可讀取、有人負責(zé)的流程小樣；不適合沒有數(shù)據(jù)負責(zé)人、無法定義業(yè)務(wù)效果、要求一次上線永遠正確，或尚未取得目標(biāo)系統(tǒng)授權(quán)的項目。流程梳理、錄制/編譯、目標(biāo)環(huán)境適配、驗收、回執(zhí)巡檢和版本維護可以成為服務(wù)項，但本文沒有價格、客戶、訂單、節(jié)省比例或收入證據(jù)。

上海煜企智能科技有限公司可協(xié)助上海及周邊企業(yè)梳理流程邊界、搭建低敏感樣品、設(shè)置獨立效果校驗和交接文件。具體系統(tǒng)、身份、數(shù)據(jù)權(quán)限、第三方條款與服務(wù)范圍，仍要以企業(yè)審批、官方文檔和目標(biāo)環(huán)境實測為準(zhǔn)。

資料來源

• OpenAdapt 官方倉庫與 README
• 官方 pyproject.toml
• 官方 MIT LICENSE
• v1.16.0 Release
• OpenAdapt 官方文檔