跳至主要內容

給 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 萬行儲存庫程式碼,免信用卡。

  1. // step 01

    在 maguyva.ai 索引一個程式碼庫

    挑一個你已經熟悉的,這樣你才能評分答案。

  2. // 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 }}
    
  3. // step 03

    加入金鑰並切換到代理模式

    在 ~/.continue/.env 寫入 MAGUYVA_API_KEY=,後面接上你的金鑰。切換到代理模式,問一個你已經知道答案的問題。