自架服務
zzet/gortex avatar
zzet/gortex

Gortex:用持久化程式圖縮小代理人的查碼範圍

適用於 AI 代理和 IDE 的高效能程式碼智慧引擎,支援 257 種語言、多儲存庫、基於圖形、可透過 CLI、MCP 伺服器和 API 存取。 AI 編碼代理隊友 - 僅公開所需的信息,將代幣使用量減少高達 50 倍。 100%本地化。不和諧:。

1,575 個 Star151 個 ForkGoApache-2.0

秒懂

它是什麼?
Gortex 將多倉庫程式碼索引成圖,透過 CLI、MCP Server、HTTP API 與 Web UI 提供符號、呼叫鏈、影響範圍與契約查詢。
適合誰用?
適合需要跨倉庫程式理解、希望讓 AI agent 查詢圖資料而非反覆讀完整檔案的團隊;不適合尚未釐清程式碼索引權限與語言涵蓋範圍的環境。先安裝 v0.63.8,依序執行 `gortex install`、`gortex daemon start --detach`、`gortex track ~/projects/myapp` 與 `gortex init`,再核對 `.mcp.json`、hooks、contracts 查詢及 telemetry 狀態。
可以商用嗎?
可以。Apache-2.0 是寬鬆授權:你可以使用、修改並販售以它為基礎的軟體,只需保留著作權與授權聲明。
還在維護嗎?
有在維護。儲存庫最近一次提交在 2 天前。
用什麼語言寫的?
主要是 Go(依據 GitHub 的語言統計)。

以上回答依據專案的 GitHub 資料(最近同步於 2026年9月14日)與我們的分析,不構成法律意見。

開源專案深度解析

從 tree-sitter 到持久化圖

Gortex README 將核心描述為 code-intelligence engine:以 tree-sitter AST 分析 257 種語言或 grammar,搭配 in-process resolvers 與部分 compiler-grade resolution,產生帶 provenance tier 的知識圖。圖中的函式、類別、呼叫鏈、HTTP route 與跨服務契約,是後續 CLI、MCP 與 UI 查詢的共同資料基礎。 zzet-gortex-deep-analysis 的 README 把這項能力放在明確的使用脈絡中,因此本文只據此整理可核對的邊界。實際採用時,應把 zzet-gortex-deep-analysis、tree-sitter AST 與輸出結果放在同一份測試紀錄裡,觀察它是否符合你的輸入、權限與部署條件。文件沒有說明的行為不應自行推定,尤其是版本差異、錯誤處理、資料保存與外部服務依賴。Gortex README 將核心描述為 code-intelligence engine:以 tree-sitter AST 分析 257 種語言或 grammar,搭配 in-process resolvers 與部分 compiler-grade resolution,產生帶 provenance tier 的知識圖。圖中的函式、類別、呼叫鏈、HTTP route 與跨服務契約,是後續 CLI、MCP 與 UI 查詢的共同資料基礎。 這個判斷對 zzet-gortex-deep-analysis 很具體:先用 README 指出的入口完成最小流程,再檢查 tree-sitter AST 的結果是否可重現。若結果只在特定環境成立,就應把該環境列為限制,而不是把 README 的描述擴大成保證。

多倉庫與契約追蹤

多倉庫支援是預設路徑,README 指出 contracts MCP tool 與 Web UI Contracts page 會偵測 provider、consumer 並匹配 API 契約。HTTP routes 可從 gin、Express、FastAPI、Spring 等框架標註辨識,再對照 fetch 或 `http.Get` 等呼叫;跨 repo 結果仍要檢查證據與信心層級。 zzet-gortex-deep-analysis 的 README 把這項能力放在明確的使用脈絡中,因此本文只據此整理可核對的邊界。實際採用時,應把 zzet-gortex-deep-analysis、contracts 與輸出結果放在同一份測試紀錄裡,觀察它是否符合你的輸入、權限與部署條件。文件沒有說明的行為不應自行推定,尤其是版本差異、錯誤處理、資料保存與外部服務依賴。多倉庫支援是預設路徑,README 指出 contracts MCP tool 與 Web UI Contracts page 會偵測 provider、consumer 並匹配 API 契約。HTTP routes 可從 gin、Express、FastAPI、Spring 等框架標註辨識,再對照 fetch 或 `http.Get` 等呼叫;跨 repo 結果仍要檢查證據與信心層級。 這個判斷對 zzet-gortex-deep-analysis 很具體:先用 README 指出的入口完成最小流程,再檢查 contracts 的結果是否可重現。若結果只在特定環境成立,就應把該環境列為限制,而不是把 README 的描述擴大成保證。

安裝驗證與單一二進位

macOS/Linux 的入口是 `curl -fsSL https://get.gortex.dev | sh`,Windows 則是 PowerShell 安裝指令。README 稱安裝器會偵測 OS/arch、驗證 SHA256 與 cosign、將檔案放入 PATH;docs/installation.md 另列 Homebrew、套件與原始碼方式。這些步驟可用來核對供應鏈,而不是只看下載是否成功。 zzet-gortex-deep-analysis 的 README 把這項能力放在明確的使用脈絡中,因此本文只據此整理可核對的邊界。實際採用時,應把 zzet-gortex-deep-analysis、SHA256 + cosign 與輸出結果放在同一份測試紀錄裡,觀察它是否符合你的輸入、權限與部署條件。文件沒有說明的行為不應自行推定,尤其是版本差異、錯誤處理、資料保存與外部服務依賴。macOS/Linux 的入口是 `curl -fsSL https://get.gortex.dev | sh`,Windows 則是 PowerShell 安裝指令。README 稱安裝器會偵測 OS/arch、驗證 SHA256 與 cosign、將檔案放入 PATH;docs/installation.md 另列 Homebrew、套件與原始碼方式。這些步驟可用來核對供應鏈,而不是只看下載是否成功。 這個判斷對 zzet-gortex-deep-analysis 很具體:先用 README 指出的入口完成最小流程,再檢查 SHA256 + cosign 的結果是否可重現。若結果只在特定環境成立,就應把該環境列為限制,而不是把 README 的描述擴大成保證。

Quick Start 的四個狀態

`gortex install` 做一次性的 MCP、skills 與 slash commands 設定;`gortex daemon start --detach` 啟動背景服務;`gortex track ~/projects/myapp` 把 repository 加入圖;進入該 repo 後執行 `gortex init`,建立 `.mcp.json`、hooks 與 community routing。少掉其中一步,agent 可能沒有得到預期的圖查詢上下文。 zzet-gortex-deep-analysis 的 README 把這項能力放在明確的使用脈絡中,因此本文只據此整理可核對的邊界。實際採用時,應把 zzet-gortex-deep-analysis、gortex daemon start --detach 與輸出結果放在同一份測試紀錄裡,觀察它是否符合你的輸入、權限與部署條件。文件沒有說明的行為不應自行推定,尤其是版本差異、錯誤處理、資料保存與外部服務依賴。`gortex install` 做一次性的 MCP、skills 與 slash commands 設定;`gortex daemon start --detach` 啟動背景服務;`gortex track ~/projects/myapp` 把 repository 加入圖;進入該 repo 後執行 `gortex init`,建立 `.mcp.json`、hooks 與 community routing。少掉其中一步,agent 可能沒有得到預期的圖查詢上下文。 這個判斷對 zzet-gortex-deep-analysis 很具體:先用 README 指出的入口完成最小流程,再檢查 gortex daemon start --detach 的結果是否可重現。若結果只在特定環境成立,就應把該環境列為限制,而不是把 README 的描述擴大成保證。

查詢密度與代理人介面

README 列出 100 多個 MCP tools、16 resources 與 3 prompts,涵蓋 symbol lookup、call chains、blast radius、dataflow、clone detection 與 refactoring。另有 preview_edit、simulate_chain、live editor overlays 與 GCX1 wire format;README 對 token 減少的 50 倍和額外 27% 數字屬專案自報,應以 BENCHMARK.md 的條件解讀。 zzet-gortex-deep-analysis 的 README 把這項能力放在明確的使用脈絡中,因此本文只據此整理可核對的邊界。實際採用時,應把 zzet-gortex-deep-analysis、preview_edit 與輸出結果放在同一份測試紀錄裡,觀察它是否符合你的輸入、權限與部署條件。文件沒有說明的行為不應自行推定,尤其是版本差異、錯誤處理、資料保存與外部服務依賴。README 列出 100 多個 MCP tools、16 resources 與 3 prompts,涵蓋 symbol lookup、call chains、blast radius、dataflow、clone detection 與 refactoring。另有 preview_edit、simulate_chain、live editor overlays 與 GCX1 wire format;README 對 token 減少的 50 倍和額外 27% 數字屬專案自報,應以 BENCHMARK.md 的條件解讀。 這個判斷對 zzet-gortex-deep-analysis 很具體:先用 README 指出的入口完成最小流程,再檢查 preview_edit 的結果是否可重現。若結果只在特定環境成立,就應把該環境列為限制,而不是把 README 的描述擴大成保證。

運維、遙測與授權邊界

Gortex 是長駐 daemon,使用 fsnotify、磁碟 SQLite graph store 與增量重啟;也提供 HTTP `/v1/*`、MCP Streamable HTTP 和 Next.js 15 UI。遙測預設關閉,可用 `gortex telemetry on|off|status` 管理,README 稱僅在設定 endpoint 後傳送匿名工具或命令計數。倉庫資料標示 Apache-2.0,分發二進位或修改程式時要履行授權要求,不能把這些說明當成完整資安審計。 zzet-gortex-deep-analysis 的 README 把這項能力放在明確的使用脈絡中,因此本文只據此整理可核對的邊界。實際採用時,應把 zzet-gortex-deep-analysis、gortex telemetry status 與輸出結果放在同一份測試紀錄裡,觀察它是否符合你的輸入、權限與部署條件。文件沒有說明的行為不應自行推定,尤其是版本差異、錯誤處理、資料保存與外部服務依賴。Gortex 是長駐 daemon,使用 fsnotify、磁碟 SQLite graph store 與增量重啟;也提供 HTTP `/v1/*`、MCP Streamable HTTP 和 Next.js 15 UI。遙測預設關閉,可用 `gortex telemetry on|off|status` 管理,README 稱僅在設定 endpoint 後傳送匿名工具或命令計數。倉庫資料標示 Apache-2.0,分發二進位或修改程式時要履行授權要求,不能把這些說明當成完整資安審計。 這個判斷對 zzet-gortex-deep-analysis 很具體:先用 README 指出的入口完成最小流程,再檢查 gortex telemetry status 的結果是否可重現。若結果只在特定環境成立,就應把該環境列為限制,而不是把 README 的描述擴大成保證。

編輯結論

適合需要跨倉庫程式理解、希望讓 AI agent 查詢圖資料而非反覆讀完整檔案的團隊;不適合尚未釐清程式碼索引權限與語言涵蓋範圍的環境。先安裝 v0.63.8,依序執行 `gortex install`、`gortex daemon start --detach`、`gortex track ~/projects/myapp` 與 `gortex init`,再核對 `.mcp.json`、hooks、contracts 查詢及 telemetry 狀態。

官方來源

  1. Official documentation
  2. Official README
  3. Project repository
  4. Release notes
社群筆記

社群筆記