# Continue chạy bằng cấu hình. Thêm một khối hiểu repo của bạn.

Canonical source: https://maguyva.ai/vi/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).

Agent của Continue làm việc với ngữ cảnh bạn đưa và các công cụ cấu hình cho phép. Maguyva lập chỉ mục toàn bộ repo và trả về qua MCP, nên chế độ agent hỏi code nằm ở đâu trước khi đọc hết tệp này đến tệp khác.

> Một khối YAML: một URL, một header và một secret từ .env của bạn.

## Những điều Continue cần biết

Bốn điều riêng của Continue.

### Một khối YAML

Lưu khối dưới tên `.continue/mcpServers/maguyva.yaml` trong workspace, hoặc thêm mục `mcpServers` của nó vào `~/.continue/config.yaml`. `config.json` đã bị ngừng dùng.

### streamable-http

Continue kết nối tới endpoint của Maguyva bằng Streamable HTTP; header nằm dưới `requestOptions`. Không có tiến trình cục bộ, không cần Node.js.

### Tham chiếu secret

`${{ secrets.MAGUYVA_API_KEY }}` được lấy từ `~/.continue/.env`, rồi từ `.continue/.env` và `.env` của workspace, cuối cùng từ môi trường tiến trình. Bản thân khối không chứa khóa nào.

### Chỉ ở chế độ agent

Continue cung cấp công cụ MCP ở chế độ agent, không có trong chat. Cấu hình JSON từ các client khác cũng dùng được: chỉ cần đặt vào `.continue/mcpServers/`.

## Rules là thỏa thuận làm việc. Hãy dùng chúng.

```text
# .continue/rules/testing.md
---
globs: "src/**/*.ts"
---
Chạy test của package trước khi coi một thay đổi là xong.
```

Continue nạp rules Markdown từ `.continue/rules/`. Một rule có thể luôn áp dụng, chỉ áp dụng khi có tệp khớp trong ngữ cảnh (`globs`), hoặc khi agent thấy `description` của nó phù hợp. Dùng rules cho:

- Lệnh build, test và lint.
- Quy ước theo ngôn ngữ hoặc thư mục.
- Thư mục agent không được động vào.

Rule cho agent biết cách làm việc. Nó không thể cho biết code nói gì sau lần merge sáng nay.

## Nơi ngữ cảnh chọn tay kết thúc

Ba khoảng trống chế độ agent lấp bằng cách đọc tệp.

### // ngữ cảnh là thứ bạn chọn

Bạn thêm những tệp bạn nghĩ là quan trọng. Phần cài đặt agent cần thường nằm ở tệp bạn không nghĩ tới.

### // hàm gọi không nằm trong tệp

“Đổi chỗ này thì cái gì hỏng?” là câu hỏi về đồ thị. Không có chỉ mục, agent phải đọc từng tệp một để trả lời.

### // mô hình cục bộ có cửa sổ nhỏ

Continue có thể chạy mô hình cục bộ với giới hạn ngữ cảnh chật. Một câu trả lời đã xếp hạng kèm file:line vừa chỗ mà mười lần đọc thăm dò không vừa.

## Maguyva làm khối MCP trong Continue

Một khối mcpServers cho chế độ agent:

- **11 công cụ trên repo đã lập chỉ mục của bạn**: tìm kiếm ngữ nghĩa, cấu trúc (AST), đồ thị và văn bản, cùng tra cứu ký hiệu, thành phần phụ thuộc và truy xuất tệp.
- **Câu trả lời kèm đường dẫn tệp và số dòng**: trên 285+ ngôn ngữ, để ngay cả mô hình nhỏ cũng nhận đúng tệp thay vì một danh sách dài.
- **Công cụ chỉ đọc**: Công cụ của Maguyva truy vấn chỉ mục. Không công cụ nào sửa tệp của bạn.

> Rules cho Continue biết *cách làm việc*.
> Maguyva cho Continue *bản đồ của code*.

## Hai quy trình làm việc

Hỏi bản đồ trước, rồi mới sửa.

### 01. Tìm đúng tệp mà không phải thêm mười tệp vào ngữ cảnh

```text
continue agent> mình xác minh chữ ký webhook ở đâu?

semantic_search("verify webhook signature")
  src/webhooks/verify.ts:17   verifySignature()
  docs/webhooks.md:40   ← văn bản

→ Agent chỉ đọc verify.ts, không đọc gì khác.
[exit 0]
```

Tìm kiếm theo nghĩa tìm ra phần cài đặt ngay cả khi tên của nó không khớp với từ bạn dùng.

### 02. Liệt kê nơi import trước khi bỏ một client

```text
continue agent> còn gì import client thanh toán cũ?

dependency_search("LegacyBillingClient", dependents)
  4 nơi import trong 3 package

→ Agent chuyển cả bốn, rồi xóa client.
[exit 0]
```

Danh sách nơi import đầy đủ trước khi xóa, không phải để build phát hiện sau.

## Cài đặt trong Continue

Ba bước. Gói Free: 3 repository, Tối đa 50K dòng repo đã index, không cần thẻ tín dụng.

### 01. Lập chỉ mục một repo tại maguyva.ai

Chọn một repo bạn đã biết, để bạn có thể đánh giá các câu trả lời.

### 02. Lưu khối dưới tên .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. Thêm khóa và chuyển sang chế độ agent

Viết `MAGUYVA_API_KEY=` rồi đến khóa của bạn vào `~/.continue/.env`. Chuyển sang chế độ agent và hỏi một câu mà bạn đã biết câu trả lời.

[Tài liệu MCP](https://docs.continue.dev/customize/deep-dives/mcp) của Continue nói về transport, secret và cấu hình JSON từ client khác.

## Lập chỉ mục một repo mà bạn đã biết rõ.

Kết nối Continue qua MCP, rồi hỏi một câu bạn có thể kiểm chứng.