跳转到内容

> 演进日志查看中

Maguyva 运行在什么之上

为速度、可调试性和持续改进而打造:核心采用经过验证的基础设施,只有在代码智能确实需要的地方才使用专门构建的组件。

PostgreSQL + Lance量化向量搜索代码语言引擎无处不在的 MCP279+ 种语言

> lsmod | grep production

生产环境中运行着什么

这些是历经多轮迭代之后留下来的核心层。它们每一个都是靠着让调试更容易、或者减少智能体执行时的阻力,才赢得了自己的一席之地。

数据库

PostgreSQL + Lance

按租户分区的存储和索引。你的代码保持隔离,不会和其他用户的索引混在一起。

嵌入向量

Voyage AI: voyage-4-large

为智能体搜索、检索和扎根提供高召回率的代码嵌入向量。

向量搜索

Binary Quantized HNSW

嵌入向量被压缩为 2048 位签名,并使用 HNSW 建立索引。存储空间减少 32 倍,搜索延迟低,且无需额外的基础设施。

语言引擎

代码语言引擎

一套经过大幅改造的 Tree-sitter 技术栈,具备自定义语法、处理器启发式规则,以及覆盖 279 种语言的提取能力

协议

MCP 协议

面向 Claude Code、Claude Desktop、Cursor、VS Code、Windsurf和other MCP-compatible clients 的远程 MCP 服务器。在 TypeScript Cloudflare Worker 上提供 11 个工具和原生可流式 HTTP 传输。

缓存

Lance 列式 + R2

列式缓存、云端同步的嵌入向量

架构时间线

走过死胡同之后的技术栈

Maguyva 并不是一下子就变成现在这个样子的。每一层之所以能留下来,是因为它让系统更容易推理、运行成本更低,或者在压力之下更容易调试。

编排方面的实验开始得更早。这条时间线从 2025 年 9 月开始算起,那时候 Maguyva 这个产品本身才真正聚焦成形。

1
2025-Q3基础

专注的 Maguyva 开发正式启动 → Voyage voyage-code-3

产品方向逐渐明确,快速迭代循环开始

2
2025-Q3存储

二进制向量检索层

带紧凑索引的量化搜索,无需单独的向量技术栈

3
2025-Q4AST 引擎

代码语言引擎正式上线

覆盖 279 种语言的自定义查询、解析器回退机制和基于处理器的启发式规则

4
2025-Q4搜索

多模态融合搜索

在一次查询中,跨语义、文本、AST 和图谱索引进行排名检索

5
2026-Q1缓存

Lance 列式 + R2 同步

服务器端列式缓存,冷启动更快

6
2026-Q1质量

覆盖 279 种语言的验证框架

对每种受支持的语言进行自动化提取测试

7
2026-Q1发布

在 maguyva.ai 正式公开发布

从专注开发到公开可用,历时 7 个月

8
2026-Q2协议

基于 TypeScript Cloudflare Worker 的 MCP

原生可流式 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-07

在你的仓库上试试

> ssh infra@maguyva -- status

你的代码存放在哪里

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

算力

裸机服务器,位于美国东部

位于阿什本的裸机服务器,针对索引吞吐量做了调优,而不是嘈杂的通用型实例。

边缘

Cloudflare 全球 CDN

API 和 MCP 响应在边缘节点缓存。静态资源通过 Cloudflare 的全球网络提供。

隔离

按工作区进行租户分区

每个工作区在整个流水线和数据库中,都拥有按租户划分范围的仓库索引。我们使用客户代码来提供代码智能,而不是用来训练模型或出售数据。

主体

在新加坡注册成立

UT International PTE. LTD. 真实司法管辖区,真实法律实体。

删除

移除一个仓库,索引也随之移除

断开一个仓库的连接后,Maguyva 会从服务中移除已索引的活跃源代码、嵌入向量和图谱数据。残留的备份会按保留期限自动过期。

地区

需要欧盟或澳大利亚区域?

如果客户有数据驻留方面的需求,我们可以聊聊追加部署区域的事。