# 策展 · X (Twitter) 🔥

> 作者：4ier (@yangfourier) · 平台：X (Twitter) · 日期：2026-03-12

> 原始來源：https://x.com/yangfourier/status/2029745636166291518?s=46

## 中文摘要

Neo 是一個 Chrome 擴充程式，能將任意網頁應用轉變為可呼叫的 API。與其他方法相比，它提供了第三條路：不依賴官方 API（大多數 SaaS 要嘛沒有 API，要嘛只開放 10% 功能），也不使用瀏覽器自動化（截圖 → OCR → 點擊的緩慢脆弱方案）。Neo 的核心洞察是，每個網頁應用都已經有完整的內部 API——前端在每次操作時都會呼叫它。Neo 會捕捉這些呼叫並使其可重播。

**三步工作原理** 構成 Neo 的核心流程：

- 捕捉——Chrome 擴充程式會攔截所有 fetch() 和 XMLHttpRequest，記錄網址、標頭、請求與回應主體、計時以及觸發呼叫的 DOM 元素
- 學習——執行 neo-schema 命令自動生成 API 地圖，包含端點、必需的認證標頭、查詢參數和回應結構
- 執行——通過 Chrome DevTools Protocol 在瀏覽器標籤頁的上下文中執行 API 呼叫，Cookie、CSRF token 和工作階段認證會自動繼承

**v1.3.0 改進** 帶來了幾項關鍵更新：

- snapshot --diff 功能省卻 95% 的 token 使用量
- 新增 HTTP REST bridge 讓使用者能直接用 curl 呼叫，無需 WebSocket
- doctor --fix 命令可一鍵修復環境問題
- Profile 功能提供多項目隔離環境

**v2 UI 自動化層** 實現了更完整的能力。當 API 存在時使用直接呼叫，當不存在時 Neo 可通過無障礙樹（accessibility tree）驅動 UI，支援的互動命令包括：

- snapshot、click、fill、type、press、hover、scroll、select、screenshot、get 和 wait

**CLI 工具涵蓋** 多個管理面向：

- 連線與工作階段管理：neo connect、neo launch、neo discover
- 捕捉與流量分析：neo capture list、neo capture watch、neo capture export
- API 重播與執行：neo replay、neo exec
- Schema 分析：neo schema generate、neo schema openapi
- UI 自動化以及診斷工具：neo doctor

**多應用環境支援** 不限於 Chrome——任何具備 CDP 支援的應用都能使用，包括 Electron 應用。工作階段會自動保存，可通過 --session 標誌在應用間切換。

**Electron 應用整合** 方面，例如可用 neo launch code --port 9230 啟動 VS Code 並連線，然後用 neo snapshot 檢視可及樹，用 neo click @14 點擊選單項。

**儲存管理機制** 採用以下規則：每個網域最多儲存 500 筆捕捉，最舊的記錄會自動清理；回應主體限制在 100KB；資料保存在 Chrome 的 IndexedDB 中；Schema 可匯出為 JSON 檔案以便跨裝置持久化。

**自動過濾噪聲** 排除以下類型的請求：

- 靜態資源（圖像、字體、CSS、JavaScript）
- 分析追蹤（Google Analytics、Meta Pixel、Sentry）
- 瀏覽器內部呼叫
- 每個 URL 模式每分鐘最多限制三筆捕捉，以防止輪詢端點爆炸

**隱私與安全設計** 方面，Neo 完全在本地執行，無外部伺服器、無遙測、無資料外洩。但因為 Neo 在所有網站上都能看到 fetch、XHR 和 WebSocket 呼叫，包括銀行、電子郵件和醫療入口網站，這在設計上具有侵略性。認證標頭值（Bearer token、CSRF token、Cookie、工作階段 ID）在捕捉時就會被編輯，IndexedDB 只儲存標頭名稱，不儲存值。執行 API 呼叫時，--auto-headers 會通過 CDP 從瀏覽器即時取得認證標頭，永不重播儲存的認證資料。

**技術堆疊** 採用 TypeScript、Vite 多入點建置、Chrome Manifest V3、Dexie.js（IndexedDB 包裝器）和 Chrome DevTools Protocol，無後端伺服器，執行時無外部依賴。

**已完成功能** 涵蓋範圍相當完整，包括：

- 捕捉與儲存、統一 CLI、儲存管理、Schema 分析、智慧過濾
- WebSocket 捕捉、捕捉重播、匯入匯出、智慧 API 呼叫
- 流程分析、依賴鏈分析、Schema 版本控制、診斷工具
- Agent 技能匯出、Mock 伺服器、HAR 格式匯出、OpenAPI 3.0 規格生成
- 批次 Schema 生成、語義端點標籤、多步驟工作流程發現執行以及 v2 UI 層

## 標籤

Web, 其他, Neo