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

Canonical source: https://maguyva.ai/zh-hans/for-continue

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).

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

> 一个 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/` 即可。

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

```text
# .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*代码的地图*。

## 两种工作流

先问地图，再动手编辑。

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

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

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

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

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

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

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

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

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

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

## 在 Continue 中配置

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

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

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

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

`.continue/mcpServers/maguyva.yaml`

```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 }}

```

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

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

Continue 的 [MCP 文档](https://docs.continue.dev/customize/deep-dives/mcp)介绍了传输方式、密钥以及其他客户端的 JSON 配置。

## 索引一个你已经熟悉的代码仓库。

通过 MCP 连接 Continue，然后问一个你能核实的问题。