跳至內容

架構

瀏覽不是你寫的程式碼。

開啟儲存庫,Panolayer 就會對應出它的架構,包括模組、函式、類別、呼叫端與相依關係。這張地圖是從原始碼剖析而來,而非由模型生成,因此相同的程式碼永遠產生相同的地圖。你、你的代理,以及 Panolayer Verification Engine,都以它為工作基礎。

下載 Panolayer閱讀文件

macOS 公開測試版。免費開始使用,不需信用卡。

架構

你已深入某個服務三層,還在試著弄清楚是誰呼叫了它。

檔案樹能告訴你程式碼放在哪裡,卻無法告訴你有什麼依賴它。當程式碼是代理寫的,而你手上只有一份上千行的 diff 時,這件事就更難了。Panolayer 會對應出相依關係,讓你依據誰呼叫誰,以視覺化方式在系統中移動,而不是依資料夾瀏覽。

你可以用它做什麼

01 / 架構

從整個系統開始

開啟儲存庫後,你首先看到的就是它如何組合在一起,包括各個服務、每個服務包含的內容,以及它們之間如何連接。這通常是只有在這份程式碼上工作過一段時間的人才能給你的全貌。

從整個系統開始

02 / 架構

深入到你需要的地方

點進某個服務查看其模組,再點進模組查看其函式。圖表、欄位與路徑三種檢視以不同方式呈現相同的結構,你可以切換到最適合目前程式碼的檢視。

03 / 架構

在脈絡中閱讀任何函式

開啟 getPrice(),你就能看到它做什麼、接收與回傳什麼、誰呼叫它、它依賴什麼、適用於它的規則,以及它目前是否通過驗證。這些資訊原本得從五個檔案和一次搜尋中拼湊出來。

在脈絡中閱讀任何函式

04 / 架構

看出一項變更會影響到哪裡

在你請代理將 getPrice() 從「分」改為「元」之前,先查看誰呼叫它:商品頁面、購物車和結帳。Panolayer 能從任何函式沿著相依性圖追蹤,讓你在任何人動手之前就知道一項變更可能觸及什麼。

05 / 架構

你的代理看到的是同一張地圖

你執行的代理可以透過 MCP 工具查詢這張地圖,因此它們能在變更某個函式之前先查出誰呼叫它,而不是只根據被提供的檔案工作。驗證也依據同一張地圖檢查每項變更,這表示你、你的代理和驗證,都從同一幅系統全貌出發。

06 / 架構

跟得上腳步的文件

活文件從架構產生,並隨著程式碼變更保持同步,因此文件描述的是系統現在的樣子,而不是某人上次更新時的樣子。

Panolayer 會記住你的專案

每個新的代理工作階段都從零開始。你得再次解釋相同的慣例、相同的限制,以及為什麼沒人去碰那個遷移。Panolayer 會跨工作階段保存專案的結構化記憶,包括你做過的決策、你的慣例與限制、遷移歷史,以及過去的錯誤是如何修正的。你在 Panolayer 中處理一個程式碼庫的時間越長,需要重複說明的就越少。

常見問題

這張圖是由 LLM 生成的嗎?

不是。它是從原始碼剖析而來。模型可以在你要求時加上淺白的說明,但不會決定結構。

不執行代理也能使用架構地圖嗎?

可以。開啟儲存庫,用它來摸清不是你寫的程式碼。

支援哪些語言?

TypeScript、JavaScript、Python、Go、Rust 和 Java 等。動態呼叫和生成的程式碼較難追蹤,可能需要更仔細地檢查。

查看支援的語言
它適用於 monorepo 嗎?

適用。

在你的程式碼庫上試用 Panolayer。

下載 Panolayer閱讀文件

macOS 公開測試版。免費開始使用,不需信用卡。

下一步: 建構