跳至主要內容

> cat /etc/evolution.log

Maguyva 運行在什麼之上

為速度、可除錯性與持續改進而打造:核心採用經過驗證的基礎設施,只有在程式碼智慧確實需要之處,才使用專門打造的元件。

  • PostgreSQL + Lance
  • 量化向量搜尋
  • 程式碼語言引擎
  • 無所不在的 MCP
  • 285+ 種語言

> lsmod | grep production

正式環境中實際運行的東西

這些是歷經多次迭代後留下來的核心層。每一層都是靠著讓除錯更容易,或消除代理執行時的阻力,才贏得自己的位置。

資料庫

PostgreSQL + Lance

以租戶分區的儲存與索引。你的程式碼保持隔離,不會有跨使用者索引混雜的問題。

嵌入向量

Voyage AI: voyage-4-large

為代理搜尋、檢索與有憑有據的回答提供高召回率的程式碼嵌入向量。

向量搜尋

Binary Quantized HNSW

嵌入向量壓縮為 2048 位元簽章,並以 HNSW 建立索引。儲存空間減少 32 倍,搜尋延遲低,且不需要額外基礎設施。

語言引擎

程式碼語言引擎

一套大幅改造的 Tree-sitter 技術棧,具備自訂文法、處理器啟發式規則,涵蓋 285 種語言的擷取範圍

協定

MCP 協定

支援 Claude Code、Claude Desktop、Cursor、VS Code、Devin Desktop和其他支援 MCP 的用戶端 的遠端 MCP 伺服器。在以 TypeScript 開發的 Cloudflare Worker 上提供 11 個工具,並原生支援 streamable HTTP 傳輸。

快取

Lance 欄式儲存 + R2

欄式快取、雲端同步的嵌入向量

架構時間軸

走過死路之後的技術棧

Maguyva 不是一次就長成這個樣子。每一層之所以能留下來,是因為它讓系統更容易理解、降低運作成本,或在壓力下更容易除錯。

指揮系統的實驗更早就開始了。這條時間軸從 2025 年 9 月開始,也就是 Maguyva 這項產品本身真正定型的時刻。

1
2025-Q3 基礎

Maguyva 專注開發啟動 → Voyage voyage-code-3

產品方向定型,快速迭代循環開始

2
2025-Q3 儲存

二進位向量檢索層

以精簡索引進行量化搜尋,不需要獨立的向量技術棧

3
2025-Q4 AST 引擎

程式碼語言引擎上線

橫跨 285 種語言的自訂查詢、解析器備援機制與基於處理器的啟發式規則

4
2025-Q4 搜尋

多模態融合搜尋

單一查詢即可對語意、文字、AST 與圖譜索引進行排序檢索

5
2026-Q1 快取

Lance 欄式儲存 + R2 同步

伺服器端欄式快取,冷啟動更快

6
2026-Q1 品質

285 種語言的驗證框架

針對每種支援語言的自動化擷取測試

7
2026-Q1 上線

在 maguyva.ai 正式公開上線

從專注開發到公開上線,歷時 7 個月

8
2026-Q2 通訊協定

以 TypeScript 開發的 Cloudflare Worker MCP 服務

原生 streamable HTTP 傳輸,延遲更低,在仍有正式流量時完成切換

✓
NOW 向量嵌入

正式環境向量嵌入 → voyage-4-large

從 voyage-code-3 切換後,語意搜尋的召回率更高

> ps aux | grep maguyva

我們自己用自己交付的東西

Maguyva 是由運行在 Maguyva 之上的代理打造的。

我們的指揮系統協調專門的 AI 代理,使用的是與你完全相同的 MCP 工具、搜尋索引與正式環境基礎設施。沒有內部特供版。團隊頁面上列著:「1x Maguyva($149)—我們付錢給自己。」這不是玩笑,是真實帳單。

// 自家頭號客戶每天都上線到正式環境

> cat /etc/principles.d/*.conf

在正式環境中存活下來的規則

這些是在正式環境中依然實用的限制條件。與其說是意識形態,不如說是為了在代理快速變更程式碼的同時,讓系統保持易於理解。

!

拒絕靜默降級

快速失敗,快速修復。每個錯誤都會立即浮現,不會有優雅降級把正式環境的錯誤藏起來。

// 直接中止執行 > 靜默資料毀損

λ

RPC 優先

把邏輯放在資料庫端以求效能。PostgreSQL 函式在資料旁邊直接執行,省去往返延遲。

// PostgreSQL 函式,0 個 ORM

↔

CQRS

把寫入與讀取路徑分開。索引管線負責寫入,MCP 工具負責讀取,各自套用不同的最佳化策略。

// 寫入:批次處理 | 讀取:快取

#

確定性 UUID

不用查資料庫就能維持快取一致性。相同輸入 = 相同 ID,天生冪等的操作設計。

// uuid5(namespace, content_hash)

最好的架構,是你凌晨三點也能除錯的那種。
(我們親自測試過。)

// 最後更新:2026-10

在你的儲存庫上試試看

> ssh infra@maguyva -- status

你的程式碼放在哪裡

沒有任何神秘之處。以下就是你連接儲存庫後,程式碼會發生的確切過程。

運算

裸機伺服器,美國東部

位於 Ashburn 的裸機伺服器,針對索引吞吐量調校,而非容易受其他負載干擾的通用型執行個體。

邊緣

Cloudflare 全球 CDN

API 與 MCP 回應在邊緣節點快取,靜態資源則透過 Cloudflare 的全球網路提供。

隔離

依工作區進行租戶分區

每個工作區在管線與資料庫中都有以租戶為範圍的儲存庫索引。我們使用客戶的程式碼是為了提供程式碼智慧,而不是用來訓練模型或販售資料。

法人實體

在新加坡註冊成立

UT International PTE. LTD. 真實的註冊司法管轄區,真實的法律實體。

刪除

移除儲存庫,就移除索引

中斷儲存庫連線後,Maguyva 會從服務中移除使用中的已索引原始碼、嵌入向量與圖譜資料。剩餘備份的保留期限則依保留排程屆滿。

區域

需要 EU 或 AU 節點?

若你有資料留存地要求,額外的部署區域可以另外討論。