# Maguyva 运行在什么之上

Canonical source: https://maguyva.ai/zh-hans/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 建立索引。存储占用压缩至原来的 1/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)

## 你的代码存放在哪里

没有任何神秘之处。这里准确说明了当你连接一个仓库时，你的代码会经历什么。

- **裸机服务器，位于美国东部** (算力): 位于阿什本的裸机服务器，针对索引吞吐量做了调优，而不是资源干扰较多的通用型实例。
- **Cloudflare 全球 CDN** (边缘): API 和 MCP 响应在边缘节点缓存。静态资源通过 Cloudflare 的全球网络提供。
- **按工作区进行租户分区** (隔离): 每个工作区在整个流水线和数据库中，都拥有按租户划分范围的仓库索引。我们使用客户代码来提供代码智能，而不是用来训练模型或出售数据。
- **在新加坡注册成立** (主体): UT International PTE. LTD. 真实司法管辖区，真实法律实体。
- **移除一个仓库，索引也随之移除** (删除): 断开一个仓库的连接后，Maguyva 会从服务中移除已索引的活跃源代码、嵌入向量和图谱数据。残留的备份会按保留期限自动过期。
- **需要欧盟或澳大利亚区域？** (地区): 如果客户有数据驻留方面的需求，我们可以聊聊追加部署区域的事。

## 后续步骤

- [开始使用](https://maguyva.ai/zh-hans/docs): 几分钟内索引你的第一个仓库。
- [查看定价](https://maguyva.ai/zh-hans/pricing): 按工作区计费，而非按用户计费。免费起步。
- [认识我们的团队](https://maguyva.ai/zh-hans/team): 2 位人类和一群 AI 智能体。
- [阅读博客](https://maguyva.ai/zh-hans/blog): 来自开发过程的技术笔记。