面向 Continue 用户

Continue 靠配置运转。加一个懂你仓库的块。

Continue 的智能体依靠你给的上下文和配置允许的工具工作。Maguyva 为整个仓库建立索引并通过 MCP 提供，所以智能体模式会先问代码在哪里，而不是一个接一个地读文件。

Free 层级：3 个代码仓库, 最多 5 万行索引代码，无需信用卡。

一个 YAML 块：一个 URL、一个请求头，外加 .env 里的一个密钥。

Continue 需要知道的事

Continue 特有的四件事。

// 配置文件

一个 YAML 块

把这个块存为工作区里的 .continue/mcpServers/maguyva.yaml，或把其中的 mcpServers 条目加到 ~/.continue/config.yaml。config.json 已弃用。

// 传输通道

streamable-http

Continue 通过 Streamable HTTP 连接 Maguyva 的端点；请求头放在 requestOptions 下。没有本地进程，也不需要 Node.js。

// 密钥

一个密钥引用

${{ secrets.MAGUYVA_API_KEY }} 先从 ~/.continue/.env 解析，再看工作区的 .continue/.env 和 .env，最后看进程环境。块本身不含任何密钥。

// 模式

仅限智能体模式

Continue 只在智能体模式下提供 MCP 工具，聊天模式不行。其他客户端的 JSON 配置也能用：放进 .continue/mcpServers/ 即可。

规则是一份工作约定。用起来。

# .continue/rules/testing.md
---
globs: "src/**/*.ts"
---
宣布改动完成前，先运行这个包的测试。

Continue 从 .continue/rules/ 加载 Markdown 规则。规则可以始终生效，也可以只在上下文中有匹配文件时生效（globs），或在智能体判断其 description 适用时生效。用规则来写：

构建、测试和 lint 命令。
按语言或目录区分的约定。
智能体不该碰的目录。

规则告诉智能体怎么干活。它没法告诉智能体：今早合并之后，代码到底写成了什么样。

手选上下文的尽头

智能体模式只能靠读文件来填补的三个缺口。

// 上下文只是你挑的那些

你添加自己认为重要的文件。智能体真正需要的实现，往往就在你没想到的那个文件里。

// 调用方不在文件里

“改了这里会坏什么？”是一个图问题。没有索引，智能体只能一个个读文件来回答。

// 本地模型的窗口很小

Continue 可以运行上下文限制很紧的本地模型。十次探索性读取放不下的地方，一条带 file:line 的排序答案放得下。

Maguyva 作为 Continue 中的 MCP 块

一个 mcpServers 块为智能体模式带来：

面向已索引仓库的 11 个工具 语义、结构（AST）、图和文本搜索，外加符号查找、依赖方和文件检索。
带文件路径和行号的答案 覆盖 285+ 种语言，小模型也能拿到正确的文件，而不是一长串清单。
只读的工具 Maguyva 的工具只查询索引，没有一个会修改你的文件。

规则告诉 Continue怎么干活。
Maguyva 给 Continue代码的地图。

两种工作流

先问地图，再动手编辑。

// workflow 01

不往上下文塞十个文件也能找到对的那个

continue agent> 我们在哪里校验 webhook 签名？

semantic_search("verify webhook signature")
  src/webhooks/verify.ts:17   verifySignature()
  docs/webhooks.md:40   ← 文档说明

→ 智能体只读 verify.ts，别的都不读。
[exit 0]

按语义搜索，即使实现的名字和你的措辞对不上，也能找到它。

// workflow 02

下线客户端前先列出导入方

continue agent> 还有谁在导入旧的计费客户端？

dependency_search("LegacyBillingClient", dependents)
  3 个包中有 4 个导入方

→ 智能体迁移完这四处，再删除该客户端。
[exit 0]

导入方清单在删除之前就已完整，而不是事后由构建发现。

在 Continue 中配置

三个步骤。Free 层级：3 个代码仓库, 最多 5 万行索引代码，无需信用卡。

// step 01

在 maguyva.ai 索引一个代码仓库

挑一个你已经熟悉的，这样你能给答案打分。

// step 02

把块存为 .continue/mcpServers/maguyva.yaml

.continue/mcpServers/maguyva.yaml

name: Maguyva
version: 0.0.1
schema: v1
mcpServers:
  - name: maguyva
    type: streamable-http
    url: https://maguyva.tools/mcp
    requestOptions:
      headers:
        Authorization: Bearer ${{ secrets.MAGUYVA_API_KEY }}

// step 03

添加密钥并切换到智能体模式

在 ~/.continue/.env 里写入 MAGUYVA_API_KEY=，后面跟上你的密钥。切换到智能体模式，问一个你已经知道答案的问题。