讀大型代碼庫(kù)最頭疼的不是代碼本身，是找不到北。你clone下來(lái)，打開(kāi)文件東翻西看，很快就忘了哪個(gè)模塊調(diào)用了誰(shuí)。哪些文件被依賴最多？哪里有循環(huán)依賴？改一個(gè)文件會(huì)不會(huì)牽一發(fā)而動(dòng)全身？

Orbis用可視化的方式解決這些問(wèn)題。輸入GitHub倉(cāng)庫(kù)地址，它自動(dòng)clone、解析代碼，把整個(gè)項(xiàng)目渲染成一張可交互的3D力導(dǎo)向圖。支持Python、JavaScript/TypeScript、Go、Rust、Java五種語(yǔ)言，基于tree-sitter做AST解析。

圖上的節(jié)點(diǎn)按代碼行數(shù)定大小，按類(lèi)型分顏色，依賴關(guān)系用帶方向粒子的連線表示。點(diǎn)擊任意模塊，能查看它的依賴項(xiàng)、指標(biāo)和導(dǎo)出符號(hào)。內(nèi)置的AI助手可以回答"應(yīng)該先重構(gòu)哪個(gè)模塊"這類(lèi)問(wèn)題，回答基于實(shí)際的代碼結(jié)構(gòu)。

核心功能包括：

1. 3D力導(dǎo)向圖——節(jié)點(diǎn)大小對(duì)應(yīng)代碼行數(shù)，顏色區(qū)分類(lèi)型，連線有動(dòng)畫(huà)方向粒子
2. 多語(yǔ)言AST解析——Python、JavaScript/TypeScript、Go、Rust、Java
3. AI聊天助手——基于Claude，可問(wèn)"哪些模塊有循環(huán)依賴""該在哪加功能X"
4. 架構(gòu)洞察——自動(dòng)檢測(cè)上帝模塊、高耦合、循環(huán)依賴等問(wèn)題，帶嚴(yán)重程度評(píng)級(jí)
5. 專(zhuān)注模式——淡化無(wú)關(guān)節(jié)點(diǎn)，清晰追蹤依賴路徑
6. 可分享URL——?repo=參數(shù)自動(dòng)觸發(fā)分析，方便分享特定代碼庫(kù)視圖
7. 最近歷史——本地存儲(chǔ)最近5個(gè)倉(cāng)庫(kù)，快速重新分析
8. 演示模式——無(wú)需clone，直接加載預(yù)分析快照

項(xiàng)目結(jié)構(gòu)很簡(jiǎn)潔：FastAPI后端負(fù)責(zé)SSE流式傳輸，neo_parser.py做單文件AST解析，前端是原生JS配合3d-force-graph和Three.js，沒(méi)有構(gòu)建步驟。AI功能需要Anthropic API key，缺失時(shí)會(huì)優(yōu)雅降級(jí)，聊天面板顯示錯(cuò)誤信息，不影響其他功能。

本地部署只需幾步：clone倉(cāng)庫(kù)、建虛擬環(huán)境、裝依賴、復(fù)制.env文件填入API key，然后uvicorn啟動(dòng)。也可以用Docker一鍵運(yùn)行。啟動(dòng)后訪問(wèn)localhost:8001即可使用。

這個(gè)工具的價(jià)值在于把抽象的代碼依賴關(guān)系變成直觀的空間關(guān)系。對(duì)于接手遺留項(xiàng)目、做代碼審查、或者向團(tuán)隊(duì)解釋架構(gòu)，比看文件夾結(jié)構(gòu)高效得多。