mitmproxy / mitmproxy · 架構

分析器把四個頂層目錄當作子系統：docs、mitmproxy、test 和 web。這個 repository 有 1292 個被分析的檔案：mitmproxy 285 個、test 427 個、web 286 個、docs 166 個、examples 73 個、release 33 個、.github 9 個，另有 13 個根目錄層級的項目。mitmproxy 目錄是 Python 套件；從模組路徑可以看到一個 proxy/layers 區域，裡面有 HTTP 層，而 dns、tls、websocket、quic、http2 和 http3 等層則在 test/ 底下被測試。web/ 是 JavaScript 前端：它的 package.json 定義了執行 vite 的 start 指令稿，並記錄了 React、Redux 和 CodeMirror 等執行期依賴。程式碼周邊：docs/ 有一支錄製 CLI 的腳本，examples/ 放著 mitmproxywrapper.py 這類 contrib 包裝程式，release/ 有建置、部署和發行用的腳本，test/ 貢獻了 194 個類測試檔案。GitHub metadata 列出的主要語言是 Python，topics 包括 http、proxy、tls 和 websocket。

分析器偵測到 28 個進入點和 245 條有界執行路徑。記錄到的 __main__ 守衛集中在幾處：release 腳本（release/build.py、release/deploy.py、release/release.py）、web/gen/ 底下的五個產生器、測試輔助工具，以及 version.py、proxy/server.py 和 platform/windows.py 這類函式庫模組；version.py 的守衛會印出 VERSION。mitmproxy/tools/main.py 和 mitmproxy/tools/web/app.py 依檔名啟發式規則被標記為可能的可執行進入點；web/package.json 的 start 指令稿會執行 vite。分析器的摘要把 mitmproxy/version.py 稱為起點（這是推論出的解讀）。列出的十條執行路徑中，來自 docs/scripts/clirecording/record.py:__main__ 的五條，走一步就停在 CliDirector 或某個 screenplays.record_* 函式，terminal_reason 都是 unresolved_boundary。來自 examples/contrib/mitmproxywrapper.py:__main__ 的兩條，停在 Wrapper.ensure_superuser 和 Wrapper.main。有一條留在本地：mitmproxy/contentviews/_view_css.py:__main__ 在同一模組內到達 ViewCSS，然後以葉節點（leaf）結束；另外兩條同源路徑停在內建的 open 和 f.read。列出的路徑沒有一條被截斷或形成循環；它們停下，是因為被呼叫者在外部或無法解析，或是走到了葉節點。分析資料還回報有一條進入點路徑沒有靜態偵測到的呼叫步驟，所以它接下來怎麼走無法確定。

角色標籤是分析器依已解析的靜態呼叫次數和是否屬於進入點推出的候選：它們是從呼叫計數推論的，不是確認過的行為；全部 20 筆角色記錄都建立在這個依據上。在正式程式碼的模組中，mitmproxy/proxy/commands.py（853 個呼入、0 個呼出）和 mitmproxy/proxy/events.py（514 個呼入、0 個呼出）是 leaf/data-boundary 候選，mitmproxy/proxy/layers/http/__init__.py（416 個呼入、152 個呼出）是 service/core 候選。mitmproxy/http.py（217 入、71 出）、mitmproxy/contentviews/__init__.py（179 入、12 出）和 mitmproxy/tools/console/common.py（100 入、84 出）也是 service/core 候選。呼入次數以測試支援程式碼最多：test/mitmproxy/proxy/tutils.py（1118 入）、mitmproxy/test/tflow.py（553）、mitmproxy/test/taddons.py（317）和 mitmproxy/test/tutils.py（254）。在 web 端，web/src/js/filt/filt.js 的呼入與呼出持平：193 個呼入、193 個呼出；test_modes.py（252 個呼出）和 test_dns.py（225 個呼出）是沒有任何呼入的 orchestration 候選。

呼叫一離開可分析的程式碼，靜態路徑就停下。在記錄到的 33086 條關係中，12217 條是本地的，20869 條是外部或未解析；總計 28836 個呼叫和 4250 個 import。列出的邊界是解析範圍以外的模組層級目標：來自 docs/scripts/clirecording/record.py 的 CliDirector 和 screenplays.record_* 函式，以及來自 examples/contrib/mitmproxywrapper.py 的 Wrapper.ensure_superuser / Wrapper.main。內建函式也會讓分析停下：從 mitmproxy/contentviews/_view_css.py 到達的 open 和 f.read；既然有 20869 條未解析的邊，列出的邊界只是樣本，不是完整的地圖。當被呼叫者無法解析到已解析的程式碼時，路徑就以 terminal_reason unresolved_boundary 結束；反射、動態 import、monkey-patching、產生的程式碼、框架在執行期的接線和動態分派，都記錄為未解析。列出的十條路徑沒有一條結束在外掛載入；靠分派運作的機制只會以未解析的邊出現。

全部 44 筆依賴記錄都來自 web/package.json：18 筆執行期記錄（react、react-dom、react-redux、@reduxjs/toolkit、codemirror 及其語言與主題套件、lodash、lucide-react、qrcode）和 26 筆開發用記錄（vite、jest、typescript、eslint、testing-library 系列套件、prettier 等）。Python 端沒有任何依賴記錄：這次使用的分析器版本（v0.10）只解析 requirements 形式的依賴清單，不解析 pyproject.toml 的依賴表，雖然 pyproject.toml 是專案層級的重要檔案。以下引自分析資料中已解析關係的摘要樣本（一段文字清單，不是可引用的記錄）：mitmproxy/addonmanager.py import 了 mitmproxy/exceptions.py、mitmproxy/flow.py 和 mitmproxy/hooks.py，AddonManager 的方法會呼叫 hook 類別（ConfigureHook、LoadHook、UpdateHook、DoneHook）以及 traverse、safecall 這類輔助函式。分析器無法解析的部分：20869 條外部或未解析的邊，以及完全沒有 Python 套件的依賴記錄，所以這裡無法確定 Python 的第三方依賴。

執行期的接線不在這次分析的範圍內：反射、執行期依賴注入、動態 import、monkey-patching、產生的程式碼、框架在執行期的接線和動態分派都沒有解析。程式碼中確實有產生程式碼的部分：web/gen 底下有五個守衛透過 asyncio.run(make()) 寫出前端產物；壓縮打包檔以及過大或 vendored 的檔案只被清點、沒有被解析。有四個檔案落在這個未解析的類別；分析資料把這一點標為未解析。代理本身在執行期的流程無法確定：分析資料裡有一條陳述說，沒有可用來說明執行期流程的有界靜態執行路徑，儘管重建結果回報了 245 條有界路徑。分析資料計算出 194 個類測試檔案，但它們在執行時確立了哪些行為，靜態資料無法解答。安裝、執行與建置的推論並不完整，安裝指令也沒有驗證，所以這份分析資料不支援任何執行說明。

先讀 README.md、pyproject.toml 和 LICENSE：三者都被標為專案層級的重要檔案。分析資料有依據的順序是：先看依賴清單和重要符號，再看有界執行路徑，改程式之前再看未解析邊界。如果要修改程式，分析器建議從偵測到的進入點 mitmproxy/tools/main.py 開始，並手動檢查下游的影響。