# Maguyva 運行在什麼之上

Canonical source: https://maguyva.ai/zh-hant/stack

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

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

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

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

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

### 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 這項產品本身真正定型的時刻。

- **2025-Q3** (基礎): Maguyva 專注開發啟動 → Voyage voyage-code-3. 產品方向定型，快速迭代循環開始
- **2025-Q3** (儲存): 二進位向量檢索層. 以精簡索引進行量化搜尋，不需要獨立的向量技術棧
- **2025-Q4** (AST 引擎): 程式碼語言引擎上線. 橫跨 285 種語言的自訂查詢、解析器備援機制與基於處理器的啟發式規則
- **2025-Q4** (搜尋): 多模態融合搜尋. 單一查詢即可對語意、文字、AST 與圖譜索引進行排序檢索
- **2026-Q1** (快取): Lance 欄式儲存 + R2 同步. 伺服器端欄式快取，冷啟動更快
- **2026-Q1** (品質): 285 種語言的驗證框架. 針對每種支援語言的自動化擷取測試
- **2026-Q1** (上線): 在 maguyva.ai 正式公開上線. 從專注開發到公開上線，歷時 7 個月
- **2026-Q2** (通訊協定): 以 TypeScript 開發的 Cloudflare Worker MCP 服務. 原生 streamable HTTP 傳輸，延遲更低，在仍有正式流量時完成切換
- **NOW** (向量嵌入): 正式環境向量嵌入 → voyage-4-large. 從 voyage-code-3 切換後，語意搜尋的召回率更高

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

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

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

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

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

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

### 拒絕靜默降級

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

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

### RPC 優先

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

*// PostgreSQL 函式，0 個 ORM*

### CQRS

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

*// 寫入：批次處理 | 讀取：快取*

### 確定性 UUID

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

*// uuid5(namespace, content_hash)*

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

// 最後更新：2026-10

[在你的儲存庫上試試看](https://app.maguyva.ai/auth/sign-up?plan=free)

## 你的程式碼放在哪裡

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

- **裸機伺服器，美國東部** (運算): 位於 Ashburn 的裸機伺服器，針對索引吞吐量調校，而非容易受其他負載干擾的通用型執行個體。
- **Cloudflare 全球 CDN** (邊緣): API 與 MCP 回應在邊緣節點快取，靜態資源則透過 Cloudflare 的全球網路提供。
- **依工作區進行租戶分區** (隔離): 每個工作區在管線與資料庫中都有以租戶為範圍的儲存庫索引。我們使用客戶的程式碼是為了提供程式碼智慧，而不是用來訓練模型或販售資料。
- **在新加坡註冊成立** (法人實體): UT International PTE. LTD. 真實的註冊司法管轄區，真實的法律實體。
- **移除儲存庫，就移除索引** (刪除): 中斷儲存庫連線後，Maguyva 會從服務中移除使用中的已索引原始碼、嵌入向量與圖譜資料。剩餘備份的保留期限則依保留排程屆滿。
- **需要 EU 或 AU 節點？** (區域): 若你有資料留存地要求，額外的部署區域可以另外討論。

## 後續步驟

- [開始使用](https://maguyva.ai/zh-hant/docs): 幾分鐘內索引你的第一個儲存庫。
- [查看定價](https://maguyva.ai/zh-hant/pricing): 以工作區計費，而非依席位計費。免費開始使用。
- [認識團隊](https://maguyva.ai/zh-hant/team): 2 位人類與一群 AI 代理。
- [閱讀部落格](https://maguyva.ai/zh-hant/blog): 來自開發現場的技術筆記。