VarAlign – 捕獲AI編程助手在會話間散落的重複變量
VarAlign是一款VS Code擴展,能檢測AI編程助手在不同會話中創建的重複、漂移或錯位的變量。完全本地運行,代碼不會離開機器。它提供重複項、變量和會話視圖,支持生成修復提示,並可與Claude Code或Kilo Code集成自動修復。
VarAlign 是一款專為 VS Code 設計的擴展,旨在解決 AI 編程助手在跨會話編程時產生的變量混亂問題。AI 助手經常忘記之前的操作,在不同的會話中重新引入已存在的變量(但使用了不同的名稱),或者讓變量值偏離之前定義的內容,甚至在文件移動後留下未定義的變量。VarAlign 可以跟蹤 AI 助手編寫的每一個賦值操作,對重複和漂移進行評分,並提供可直接粘貼到 AI 助手中的修復提示。
該擴展完全在本地運行,不需要任何雲服務或遙測,代碼永遠不會離開用户的機器。因此,它可以在嚴格限制或斷網的環境下正常工作。VarAlign 的核心是一個零依賴的 Python 引擎,它隨擴展一起發佈,無需額外安裝。用户界面則是輕量級的只讀客户端。
VarAlign 提供了幾個原生樹形視圖:"重複項"(按高/中/低分組)、"變量"(按文件分組並標記重複級別)和"會話"(顯示每個 AI 會話引入或更改的變量)。在重複項視圖中,用户可以展開配對查看雙方,並通過右鍵菜單進行確認、忽略或添加註釋。狀態欄會顯示高優先級重複項的數量。
使用 VarAlign 非常簡單:安裝擴展後,確保 Python 3.11 或更高版本在 PATH 中,然後打開一個倉庫並點擊活動欄中的 VarAlign 圖標即可開始跟蹤。擴展會在倉庫根目錄創建 .varmem/ 文件夾來存儲跟蹤數據,並自動將其添加到 .gitignore 中。
VarAlign 提供 Pro 版本,解鎖變量合併功能:用户可以直接在編輯器中將重複的變量合併為規範名稱,並自動重寫所有引用和刪除重複定義。Pro 許可證通過 Ed25519 簽名密鑰在本地驗證,即使在離線環境也能工作。
VarAlign 還支持自託管 API,適合團隊集中運行引擎。用户只需在設置中配置 API 地址、令牌和項目 ID,即可讓視圖通過 API 讀取報告。
該擴展的 VS Code 部分採用 BSL 1.1 許可證(源代碼可用),2023年7月15日後轉為 Apache-2.0;底層引擎單獨使用 Apache-2.0 許可證。開發人員可以通過 npm 和 esbuild 進行構建和打包。