# Continue 靠設定運轉。加一個懂你儲存庫的區塊。

Canonical source: https://maguyva.ai/zh-hant/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，再問一個你能查證的問題。