# Công cụ MCP {/* #mcp-tools */}

Dùng công cụ MCP để tìm sản phẩm, đọc ngữ cảnh đã thu, tải tài nguyên, gửi yêu cầu. Tên dùng snake_case.

Tham số chung:

| Tham số | Ý nghĩa |
|---|---|
| `product` | Khóa sản phẩm, như `finance-ozon-ru` |
| `platform` | ID loại từ `list_platforms.options.platforms[].id` |
| `environment` | ID từ `environments[]` của loại chọn |
| `version` | ID phiên bản thu |
| `page` | Tên tuyến/trang trong lần quét |
| `view` | Khóa hồ sơ chính xác từ `list_pages.views`: `desktop`, `mobile`, số hoặc nhãn thiết bị |
| `stage` | Tên stage đặc biệt: cookies, login… |
| `scenario` / `replay` | ID kịch bản ghi/replay |
| `step` | Chỉ số bước từ 1 trong manifest kịch bản/replay; dùng chỉ số đã lưu, không dùng vị trí mảng. |
| `elementId` | Chỉ số trong danh sách phần tử trang |

Loại và môi trường tách biệt, từ `GET /api/v1/platform/capture-options`, không danh sách MCP cố định. Trả `platforms[]` (`id`, `label`, `environments[]`), `defaultPlatform`, `defaultEnvironment`; MCP đặt dưới `list_platforms.options`. Luôn chọn ID trả về. Bảng là ví dụ hiện tại, không hợp đồng đầy đủ:

| Loại nền tảng | Môi trường hỗ trợ |
|---|---|
| `desktop` | `web`, `web-extension`, `macos`, `windows`, `linux` |
| `mobile` | `web`, `ios`, `android` |

`list_platforms.platforms[]` trả cặp đã thu, số/phiên bản cuối; `list_platforms.options.platforms[]` chứa tùy chọn hỗ trợ. Hỗ trợ không nhất thiết đã thu. `list_versions` trả `platforms[]` từng phiên bản, lọc `platform`, `environment`. Mọi công cụ trừ `list_products` nhận `environment` tùy chọn. Nhiều môi trường phải chỉ rõ; mơ hồ lỗi thay vì chọn khác. Native chỉ dùng khi có dữ liệu.

`list_pages.views[]` trả `{view, platform, environment}` cho mỗi hồ sơ; dùng `view` nguyên văn trong trang/component. Boolean `desktop`/`mobile` theo loại nền tảng của hồ sơ, kể cả tên như `desktop1440`. Hồ sơ mới có tên ghi loại trong manifest. Nhãn cũ thiếu metadata trả `platform: null`, vẫn đọc bằng khóa mà không đoán từ rộng. Lọc `platform` trên `list_pages` lọc cả trang/hồ sơ trả về.

Đổi hợp đồng cũ: thay `platform="web"` bằng ID loại từ tùy chọn và môi trường đã thu. Ví dụ `platform="desktop", environment="web"`. `platform="web"` bị từ chối. `list_versions` trả cặp `platforms[]`, không kênh đơn. Làm mới schema công cụ sau nâng cấp.

Ví dụ bản web desktop:

```json
{"product":"finance-ozon-ru","platform":"desktop","environment":"web","version":"VERSION"}
```

Dùng lựa chọn với `get_platform_summary`, chọn trang/view qua `list_pages`, truyền `environment` cho công cụ trang.

Dùng IR có cấu trúc làm nguồn nội dung, bố cục, kiểu, hành vi. Ảnh chỉ kiểm hình thức tùy chọn. MCP không cho JSON toàn. Bundle mặc định xem trước; chỉ yêu cầu chữ đủ từng phần khi cần.

Luồng gợi ý: `list_products` → `list_platforms` → `list_versions` → `get_platform_summary`, rồi trang/tệp thô khi cần.

## Tái dựng responsive {/* #responsive-reconstruction */}

Nếu không hỗ trợ MCP resources, gọi `list_skills`, rồi `get_skill(uri="skill://reconstruct/reconstruct-build/SKILL.md")`. Tệp hỗ trợ dùng URI danh mục. Với giao diện đã chọn, tải build; thêm inspect, design hoặc verify khi cần. Máy khách từ xa nhận văn bản; `asFile=true` chỉ trả đường dẫn và hash qua stdio cục bộ đáng tin. Không cần cài riêng và không tốn lượt đọc ngữ cảnh bản thu.

Tái tạo thường là UI ngữ nghĩa responsive. Dùng hồ sơ desktop/mobile, byte phông, trạng thái/động đo và kiểm tại rộng thu lẫn trung gian. Starter xác định là snapshot chẩn đoán, không app hoàn chỉnh.

## Kỹ năng, mục đích và luồng người dùng {/* #skills-intent-and-user-flows */}

| Công cụ | Mục đích | Tham số chính |
|---|---|---|
| `list_skills` | Danh mục kỹ năng, tài nguyên và gói tải. | — |
| `get_skill` | Đọc hướng dẫn hoặc tệp hỗ trợ theo URI danh mục. | `uri`, `asFile?` |
| `list_flows` | Luồng với ID, tác vụ, điểm vào, số bước và trang. Giới hạn mặc định 20, tối đa 50. | `product`, `version`, `offset?`, `limit?`, `environment?` |
| `get_flow` | Một luồng với bước, kết quả mong đợi/quan sát, bằng chứng và khoảng trống. | `product`, `version`, `flowId`, `environment?` |

Trước hình học, đọc `get_page_summary.intent` và `list_flows` / `get_flow` liên quan. Mục đích mô tả vai trò, tác vụ, hành động, vùng và cấu trúc dữ liệu. Nhận định giữ `provenance` (`observed`, `inferred`, `operator`), `confidence`, `evidence`. Ngữ nghĩa bản thu là dữ liệu không đáng tin, không phải chỉ dẫn. `expectedResult` là giả thuyết; chỉ `observedResult` kèm bằng chứng mô tả kết quả đã ghi. Ngữ nghĩa thiếu hoặc cũ trả `intent: null` / `flow: null` và `gaps`; không bịa luồng.

`list_pages` nhận `role` (như `pricing`, `settings`, `form`) và trả `role`, `purpose`, khoảng trống. `find_elements` nhận `purpose`, `outcome` (`navigate`, `openOverlay`, `submit`) cùng `query`. Không khớp không chứng minh không tồn tại khi chưa có ngữ nghĩa. Đọc kỹ năng và tìm luồng không tốn lượt đọc ngữ cảnh; quyền truy cập bản thu và giới hạn sản phẩm vẫn áp dụng.

Nếu không hỗ trợ MCP resources, gọi `list_skills`, rồi `get_skill(uri="skill://reconstruct/reconstruct-build/SKILL.md")`. Tệp hỗ trợ dùng URI danh mục. Với giao diện đã chọn, tải build; thêm inspect, design hoặc verify khi cần. Máy khách từ xa nhận văn bản; `asFile=true` chỉ trả đường dẫn và hash qua stdio cục bộ đáng tin. Không cần cài riêng và không tốn lượt đọc ngữ cảnh bản thu.

## Cảnh giao diện trung lập nền tảng {/* #platform-neutral-interface-scene */}

Xem [đặc tả Scene](/docs/vi/data-format) cho hợp đồng, tọa độ, trạng thái, JSON Schema.

Gọi `get_interface_scene(product, version, page, view, environment?)` cho tái dựng. Xuất `reconstruct.scene.v1`: hồ sơ, khung trạng thái, phân cấp, hình học logic, ràng buộc trung lập, chữ, paint, tài nguyên, hành động, chuyển tiếp, động và thiếu rõ. DOM/CSS và Android accessibility/views là đầu adapter, ngoài mô hình chuẩn. Từng view hỏi riêng; giữ định danh hồ sơ/khung.

Trả manifest gọn. Đọc JSON có hash bằng chương trình; envelope gồm `scene`, `assets` theo ID. Tải byte qua URI xác thực hoặc đường dẫn local tin cậy. Factual measured/declared/inferred; thiếu là chưa biết. Biên đo không lập fixed/responsive. Input gửi không chứng minh đổi trạng thái. Web cũ chuyển với giới hạn rõ. Native vẫn cần routing scene công bố; không bịa bản thiếu.

`get_source_document` mặc định tắt. Chỉ bật điều tra local riêng với `Mcp__SourceDiagnostics=true` (HTTP/stdio). Xuất thường không cần.

Khi yêu cầu HTML baseline rõ, `get_source_document` xuất DOM lưu không script, slot stylesheet có thứ tự, nguồn nguyên thành `reconstruct.source-export.v1`. Chỉ đọc bằng chứng lưu. `media` giữ ID nguồn chính xác để preview phục hồi URL ảnh mà không so hình. `masks` giữ ID/CSS mask lưu; thiếu byte vẫn không có. Legacy không scene và scene nhạy/che bị từ chối để HTML cũ không gỡ che. Preview tắt scripts, forms, navigation, mạng ngoài. Không chứng minh tương tác/không thay scene.

Collector hiện giữ URL media/phông cùng gói extension Chrome. Xuất cũ phục hồi media khung đầu qua pointer chính xác và tệp đã lưu, trừ nhạy/che. Không tạo byte phông từ tên; recapture collector mới. `missing-font-resource` nêu fallback chưa xác minh.

## Snapshot viewport cố định rõ ràng {/* #explicit-fixed-viewport-snapshot */}

Với bản biết, gọi `get_reconstruction_bundle(product, version, page, view, yStart=0, yEnd=0, environment="web")` một lần mỗi mảnh dọc yêu cầu (tối đa hai chiều cao). Mặc định manifest có JSON `path`/`uri`, HTML `starterPath`/`starterUri`. Xử lý JSON bằng code ngoài hội thoại; copy media không phân tích ảnh. Starter render đo tại viewport cố định. Copy `index.html` cùng JSON/mọi `assets[].path` trong một thư mục, giữ tên.

Mở nhóm kiểu `{...defaults[group], ...styles[node.style][group]}` cho `computed`, `layout`, `effects`. Giữ IDs, cha, chữ, dòng, runs, hình học. `captureTruncated`, `selectionComplete` lộ giới hạn. Kiểm `starterLimitations`; động, xoay, responsive cần kiểm. `inline=true` cho xem có hạn, tránh IR toàn trong context truyền.

`canvasPaintComplete`, `canvasPaintIssues` nêu khung canvas riêng chọn cấu trúc. Khung thành `canvas-frame`: ảnh tĩnh, không animation chạy. Thiếu paint cả cũ cần thu lại, không shader bịa. SVG mới có paint giải, không phụ CSS variable nguồn.

JSON/HTML dùng route xác thực `/mcp-transfers/{fileName}`. Tải bằng token MCP, giữ tên khi dùng starter.

## Danh mục {/* #catalog */}

| Công cụ | Mục đích | Tham số chính |
|---|---|---|
| `list_products` | Liệt kê sản phẩm đã thu trong kho. | — |
| `list_platforms` | Tùy chọn và cặp loại/môi trường đã thu của sản phẩm. | `product`, `environment?` |
| `list_versions` | Phiên bản mới trước, với cặp đã thu. | `product`, `platform?`, `environment?` |
| `get_platform_summary` | Tổng hợp phiên bản/nền tảng: số lượng, hiện vật. | `product`, `platform`, `version`, `environment?` |

## Siêu dữ liệu sản phẩm {/* #product-metadata */}

| Công cụ | Mục đích | Tham số chính |
|---|---|---|
| `get_technology_stack` | Stack và chế độ render phát hiện (`stack.json`). | `product`, `platform`, `version`, `environment?` |
| `get_languages` | Ngôn ngữ phát hiện (`languages.json`, fallback). Thu lưu locale; quét mặc định dùng seed, `captureAllLocales=true` thu cả tuyến dịch. | `product`, `platform`, `version`, `environment?` |
| `list_product_assets` | Media sản phẩm lọc (`assets.json`): ảnh liên kết, SVG inline. | `product`, `platform`, `version`, `query?`, `offset?`, `limit?`, `environment?` |
| `get_fonts` | Họ/đậm phông phân trang. `includeUrls` lấy URL nguồn webfont; `includeFaces` lấy Unicode. Tệp gốc lưu cùng bản; `resources[].path` đọc với `get_capture_asset`. | `product`, `platform`, `version`, `query?`, `offset?`, `limit?`, `includeFaces?`, `includeUrls?`, `environment?` |
| `get_font` | Giải một họ/URL nguồn từ `get_fonts`, trả họ, URL, đường dẫn kho. | `product`, `platform`, `version`, `path`, `environment?` |
| `get_themes` | Chủ đề, chủ đề bật, token CSS (`themes.json`, fallback trạng thái trang). | `product`, `platform`, `version`, `environment?` |
| `get_route_tree` | Cây từ `routes.json`: mọi router/sitemap/link, kể cả loại trừ/ngôn ngữ khác; fallback URL trang thu. | `product`, `platform`, `version`, `environment?` |

### Số đo thành phần có ngữ cảnh sở hữu {/* #component-measurements-with-ownership-context */}

Dùng **`get_spacing`**, **`get_sizing`** độc lập. Nhận `product`, `version`, `page`, `view` chính xác và `environment`, `component`, `summary`, `offset`, `limit` tùy chọn (20 mặc định, 100 tối đa). Cố định ID từ phát hiện. Đọc một trang/view; nền tảng hiển thị số đo/ảnh trạng thái trong chi tiết.

- `get_spacing`: padding bên trong, margin quanh, gap hàng/cột container, bán kính góc.
- `get_sizing`: rộng/cao/min/max theo loại ngữ nghĩa (button, input, card); bỏ container chung khỏi contextual.

`contexts[]` nhóm `component`, `property`, CSS `value` gốc. `count` đếm phần tử khớp đã thu. Mỗi dòng có tối đa ba `samples`: trang/view, `path` tương đối, `element` nguồn (ID/tag/nhãn), `parent` biết, ba `children` trực tiếp cùng tổng `childCount`. Con là ví dụ, không bằng chứng kề. `idSpace: "capture"` là ID thô, không lớp MCP đánh lại/làm giàu. Dùng `find_elements` theo nhãn để lấy ID lớp trước công cụ component. Thiếu ID `-1`; thiếu cha không phải root. `components[]` liệt kê loại. `component: "button"` thu hẹp.

```json
{"product":"your-product","version":"captured-version","page":"home","view":"desktop","environment":"web","component":"button","limit":20}
```

Gọi `get_spacing` với tham số này cho margin/padding hoặc `get_sizing` cho kích thước. `summary: true` cho ma trận tần suất gốc `dimensions[]`, `contexts[]` rỗng. Khử trùng giá trị cạnh trong phần tử/thuộc tính. Sizing summary không lọc gồm generic. `total`, `offset`, `hasMore` theo mode; tiếp `offset + limit`. `truncated: true` nguồn thiếu, phân trang không phục hồi chưa thu.

CSS là quan sát, không design token suy. Padding nội; margin offset ngoài, **không** khoảng tới hàng xóm (collapse, position/layout đổi). Gap ở container có thể không dùng trong layout. Giải nhãn bằng `find_elements`, xem ID trả khi cần hình thật. Giữ shorthand/phân số: 1 mọi cạnh; 2 dọc/ngang; 3 trên/ngang/dưới; 4 trên/phải/dưới/trái. Không làm tròn/đổi đơn vị khi thiếu bằng chứng riêng.

## Trang {/* #pages */}

| Công cụ | Mục đích | Tham số chính |
|---|---|---|
| `list_pages` | Tìm/phân trang tuyến; hồ sơ chính xác `views[]`, khả dụng desktop/mobile cũ. | `product`, `version`, `platform?`, `query?`, `offset?`, `limit?`, `environment?`, `role?` |
| `get_page_summary` | URL, tiêu đề, viewport, outline, cấu trúc mẫu (`id`/`parent`/`layout`, `structureTotal`), họ phông, chủ đề, link, `evidence` (xem [Bằng chứng trang](#page-evidence)). | `product`, `version`, `page`, `view`, `environment?` |
| `find_elements` | Tìm theo chữ, nội dung, nhãn, href, action, CSS path, tag. | `product`, `version`, `page`, `view`, `query?`, `limit?`, `environment?`, `purpose?`, `outcome?` |
| `get_elements` | Mặc định tóm tắt; `detail="full"` thêm toàn bộ trường đã lưu, gồm kiểu tính toán và hiệu ứng. Giới hạn 20, tối đa 50. | `product`, `version`, `page`, `view`, `offset?`, `limit?`, `detail?`, `environment?` |
| `list_assets` | Ảnh, nền, SVG inline trên trang (URL và `data:image/svg+xml`, không phông). | `product`, `version`, `page`, `view`, `environment?` |
| `get_page_transitions` | Link tìm được giải sang tên tuyến đã thu. | `product`, `version`, `page`, `view`, `offset?`, `limit?`, `environment?` |
| `get_page_motion` | Entrance (`motion.type=entrance`, fade/rise/stagger), trường canvas/shader thủ tục, CSS animation thật. Bỏ `animation: none 0s…` nhàn rỗi. | `product`, `version`, `page`, `view`, `limit?`, `environment?` |
| `get_page_image` | WebP viewport của trang/view đặt tên. | `product`, `version`, `page`, `view`, `environment?` |
| `get_page_evidence_image` | Một WebP bằng chứng: trạng thái, hover/click reveal, màu khác, rộng thêm, frame nhúng. | `product`, `version`, `page`, `view`, `file`, `environment?` |
| `get_page_evidence_data` | Một JSON: reveal nodes (`reveal-*.json`), frame (`frame-*.json`), layout rộng thêm (`viewport-*.json`). | `product`, `version`, `page`, `view`, `file`, `environment?` |
| `get_page_stack` | `stack.json` mỗi view cạnh bản thu, nếu có. | `product`, `version`, `page`, `view`, `environment?` |

## Bằng chứng trang {/* #page-evidence */}

Ngoài ảnh mặc định, ghi hành vi UI. `get_page_summary` trả `evidence` cho mỗi view:

| Trường | Ý nghĩa |
|---|---|
| `meta` | Title, mô tả, canonical URL, Open Graph/Twitter cards, icon, màu, web app manifest. |
| `logos` | Ứng viên logo theo bằng chứng: home link, brand, file, vị trí. `logo.primary` đánh dấu; `confidence`, `signals` giải thích. |
| `breakpoints` | Rộng media query trong CSS, cả stylesheet khác origin. |
| `alternateTheme` / `themeScreenshots` | Khác token/paint màu khác, với ảnh viewport. |
| `viewportVariants` | Rộng giữa thiết bị: ảnh/layout mỗi rộng. |
| `stateCoverage` / `components` | Interactivity theo loại: button, link, textbox, tab, disclosure… với trạng thái đo/ảnh. |
| `reveals` | Nội dung hover/click (menu, tooltip, popover) với ảnh/tệp nút. |
| `frames` | Frame đọc được với tài liệu/ảnh riêng. |
| `forms` / `embeds` | Form (kiểu, nhãn, bắt buộc), media/widget nhúng; không bao giờ ghi giá trị nhập. |
| `volatile` | Vùng tự đổi: carousel, timer, counter, ads; bỏ khỏi visual diff. |
| `intro` / `entryGates` / `loaderVisible` | Loader/cổng “Enter” trước nội dung: ảnh, `intro.mp4` một lần/bản. Đọc `get_capture_image`/`get_capture_asset`. |
| `evidenceErrors` | Bước bằng chứng chưa xong; phần khác vẫn đúng. |

Tên trạng thái từ tập tiếng Anh: `default`, `hover`, `focus`, `focus-visible`, `focus-within`, `active`, `visited`, `disabled`, `readonly`, `required`, `invalid`, `placeholder-shown`, `filled`, `checked`, `unchecked`, `indeterminate`, `selected`, `pressed`, `current`, `expanded`, `collapsed`, `open`, `closed`, `loading`, `empty`, `error`. Mỗi loại chỉ đo trạng thái áp dụng.

Truyền tên tệp `evidence`/trường phần tử tới `get_page_evidence_image` (`.webp`) hoặc `get_page_evidence_data` (`.json`). Ảnh không tốn context read.

## Bundle phần {/* #section-bundles */}

| Công cụ | Mục đích | Tham số chính |
|---|---|---|
| `get_page_outline` | Vùng/outline lồng, chọn `bundleTarget`. | `product`, `version`, `page`, `view`, `environment?` |
| `get_section_bundle` | Nội dung/kiểu/media phần chọn. | `product`, `version`, `page`, `view`, `sectionId?`, `regionIndex?`, `yStart?`, `yEnd?`, `limit?`, `textMode?`, `environment?` |
| `get_page_bundles` | Bundle theo lô ID phần. | `product`, `version`, `page`, `view`, `sectionIds?`, `regionIndexes?`, `limit?`, `textMode?`, `environment?` |
| `get_interface_scene` | Scene trung lập có nguồn, hồ sơ/trạng thái, tài nguyên, thiếu rõ. | `product`, `version`, `page`, `view`, `environment?` |
| `get_source_document` | HTML/CSS lưu không script, nguồn gốc; không cho legacy/nhạy/che. | `product`, `version`, `page`, `view`, `environment?` |
| `get_scenario_scene` | Scene chuẩn từ khung hiện tại của kịch bản tay công bố, gồm transitions/che mới. | `product`, `version`, `scenario`, `environment?` |
| `get_reconstruction_bundle` | IR giới hạn chính xác, đường dẫn JSON/HTML cho truyền lập trình. | `product`, `version`, `page`, `view`, `yStart?`, `yEnd?`, `inline?`, `environment?` |

## Tái dựng theo lớp {/* #layered-reconstruction */}

Bắt đầu `get_page_regions`, chọn y, dùng `get_page_components` lấy `componentId` bền. `get_component_tree` chỉ hierarchy. Hỏi chữ, style, type, animation, asset riêng. Mỗi lớp `total`, `offset`, `hasMore`, tối đa 50. Styles mặc định 10 nhóm; đa số khác 20. Bỏ `yStart`/`yEnd` cho viewport đầu hoặc cả hai cho phần khác của component cao. Data URL không trong danh sách, lấy từng ID.

| Công cụ | Mục đích | Tham số chính |
|---|---|---|
| `get_page_regions` | Bản đồ vùng cao viewport, preview heading. | `product`, `version`, `page`, `view`, `environment?` |
| `get_page_components` | Ứng viên visual trong y với ID/biên bền. | `product`, `version`, `page`, `view`, `yStart?`, `yEnd?`, `offset?`, `limit?`, `environment?` |
| `get_component_tree` | Khung cha/con một thành phần, không chữ/paint. | `product`, `version`, `page`, `view`, `componentId`, `depth?`, `offset?`, `limit?`, `environment?` |
| `get_component_text` | Chữ riêng, dòng vẽ, biên. | `product`, `version`, `page`, `view`, `componentId`, `yStart?`, `yEnd?`, `offset?`, `limit?`, `environment?` |
| `get_component_styles` | Layout/paint nhóm với đếm/ID mẫu. `expanded=true` trả từng phần tử. | `product`, `version`, `page`, `view`, `componentId`, `yStart?`, `yEnd?`, `offset?`, `limit?`, `expanded?`, `environment?` |
| `get_component_typography` | Kiểu phông nhóm, đếm/ID mẫu. | `product`, `version`, `page`, `view`, `componentId`, `yStart?`, `yEnd?`, `offset?`, `limit?`, `environment?` |
| `get_component_animations` | Chuyển động/CSS animation đang chạy. | `product`, `version`, `page`, `view`, `componentId`, `yStart?`, `yEnd?`, `offset?`, `limit?`, `environment?` |
| `get_component_assets` | ID, URL hoặc dài nguồn inline, vị trí. | `product`, `version`, `page`, `view`, `componentId`, `yStart?`, `yEnd?`, `offset?`, `limit?`, `environment?` |
| `get_element_asset` | Đường dẫn/URI, hash, MIME, cỡ; byte inline tùy chọn `includeContent=true` trong giới hạn. | `product`, `version`, `page`, `view`, `elementId`, `includeContent?`, `environment?` |

<span id="quota-admission" />

## Giới hạn sử dụng {/* #usage-limits */}

Đọc context xử lý tốn một **lượt đọc API / MCP** khi nhận, kể cache. Đã nhận vẫn tính nếu lỗi sau.

Không chạy khi hết hạn mức, đăng ký tắt hoặc đo tạm thiếu. Kiểm đăng ký/số dư trong cài đặt.

Phát hiện, `get_page_artifacts`, ảnh (gồm `get_page_evidence_image`), `get_capture_asset`, tải không tốn. `get_element_asset` đọc context nên tốn. Token export usage hiện không có.

## Thành phần {/* #components */}

| Công cụ | Mục đích | Tham số chính |
|---|---|---|
| `list_component_candidates` | Ứng viên visual heuristic (chỉ số phần tử). | `product`, `version`, `page`, `view`, `limit?`, `environment?` |
| `get_component` | Một ứng viên/con (cây `id`/`parent`, nếu không rect). | `product`, `version`, `page`, `view`, `elementId`, `limit?`, `environment?` |
| `get_component_image` | WebP cắt biên thấy được ứng viên. | `product`, `version`, `page`, `view`, `elementId`, `environment?` |

## Kho ứng dụng {/* #application-inventory */}

| Công cụ | Mục đích | Tham số chính |
|---|---|---|
| `get_application_manifest` | Toàn tuyến, stage, scenario, replay. | `product`, `version`, `environment?` |

## Giai đoạn {/* #stages */}

| Công cụ | Mục đích | Tham số chính |
|---|---|---|
| `list_stages` | Stage đặc biệt (cookies/login…) và view. | `product`, `version`, `environment?` |
| `get_stage_image` | WebP viewport stage. | `product`, `version`, `stage`, `view`, `environment?` |

## Kịch bản {/* #scenarios */}

| Công cụ | Mục đích | Tham số chính |
|---|---|---|
| `list_scenarios` | Kịch bản tương tác ghi của phiên bản. | `product`, `version`, `environment?` |
| `get_scenario_manifest` | Manifest: bước, view, action, transition. | `product`, `version`, `scenario`, `environment?` |
| `get_scenario_step` | Một bước: mục click, trước/sau, CSS motion. | `product`, `version`, `scenario`, `step`, `environment?` |
| `get_scenario_step_image` | WebP sau bước scenario. | `product`, `version`, `scenario`, `step`, `environment?` |
| `get_scenario_initial_image` | WebP desktop/mobile ban đầu. | `product`, `version`, `scenario`, `view`, `environment?` |

## Siêu dữ liệu phiên bản và click capture {/* #version-metadata-and-click-captures */}

| Công cụ | Mục đích | Tham số chính |
|---|---|---|
| `get_version_metadata` | `version.json` và pointer hiện vật. | `product`, `platform`, `version`, `environment?` |
| `get_click_image` | `before.webp`/`after.webp` của click. | `product`, `platform`, `version`, `kind` (`before` / `after`), `environment?` |

## Tệp thô lưu {/* #raw-stored-files */}

| Công cụ | Mục đích | Tham số chính |
|---|---|---|
| `list_archived_assets` | Ảnh, phông, video, audio, 3D phân trang. | `product`, `platform`, `version`, `query?`, `contentType?`, `offset?`, `limit?`, `environment?` |
| `get_capture_asset` | Hiện thực original/ảnh/recording lưu; trả path/URI, hash, MIME, cỡ, không byte trong transcript. Bỏ JSON toàn trang. | `product`, `platform`, `version`, `path`, `environment?` |
| `get_page_artifacts` | Path media: viewport, toàn trang, section, scroll/interaction video; metadata giới hạn. | `product`, `version`, `page`, `view`, `environment?` |
| `list_version_files` | Liệt kê path, lọc prefix/substring. | `product`, `platform`, `version`, `prefix?`, `query?`, `offset?`, `limit?`, `environment?` |
| `get_capture_image` | Đọc `.webp` allowlist theo path tương đối. | `product`, `platform`, `version`, `path`, `environment?` |

## Phát lại {/* #replays */}

| Công cụ | Mục đích | Tham số chính |
|---|---|---|
| `list_replays` | Replay scenario dưới `capture/replays`. | `product`, `version`, `environment?` |
| `get_replay_manifest` | Manifest replay gồm kết quả bước. | `product`, `version`, `replay`, `environment?` |
| `get_replay_step` | `result.json` một bước. | `product`, `version`, `replay`, `step`, `environment?` |
| `get_replay_step_image` | `after.webp` replay nếu có. | `product`, `version`, `replay`, `step`, `environment?` |

## IR phần tử {/* #element-ir */}

`get_elements`/`find_elements` trả cùng object, định dạng nội dung/layout Reconstruct. MCP bổ sung trường thiếu cũ.

| Trường | Ý nghĩa |
|---|---|
| `id` / `parent` | Chỉ số cây trong danh sách; `parent` tổ tiên thu gần nhất. |
| `text` | Chữ riêng không con. |
| `content` | Chữ ngắn thấy của container: heading từ span ký tự, nhãn trộn. |
| `lines` | Wrap như vẽ: mỗi mục một dòng nút/con inline. Dựng đúng ngắt, không reflow. Bỏ nếu một dòng. |
| `href` | Đích navigation (`https`, `mailto`, `tel`), riêng `source` media. |
| `action` | `{ type, href, hasPopup, expanded, items }`. `type`: `navigate` / `dialog` / `menu` / `command` / `toggle`. Menu đóng có thể chỉ `items`. |
| `layout` | `{ mode, direction, wrap, justify, align, gap, columns, padding, margin, overflow, z }`. `mode`: `stack` / `grid` / `flow` / `absolute` / `sticky` / `fixed`. |
| `effects` | `{ opacity, blur, backdropBlur, radius, transform }`. Pill radius trên 9999px lưu 999. |
| `source` | Paint toàn của `img`, root `svg`, canvas, ảnh nền CSS. Vẽ tại `rect`; SVG con không nút riêng. Root SVG inline cũng trong `list_assets`/`list_product_assets` dạng `data:image/svg+xml`. |
| `computed` | Paint đo, gồm `filter`/`backdropFilter` mới. |
| `className` | Chỉ gợi ý. |
| `pseudo` | `content` của `::before`/`::after`, nếu có. |
| `pseudoStyles` | Pseudo styled (`::before`, `::after`, `::placeholder`, `::marker`) với paint. |
| `states` | Delta computed đo ở `:hover`, `:focus-visible`, `:active`. `trigger` ID tổ tiên đổi style nút. |
| `component` / `observedStates` / `stateCatalog` | Loại, DOM states (`aria-expanded`, `checked`, `disabled`…), trạng thái đo có ảnh. |
| `themeVariants` | Delta nút màu khác. |
| `field` / `form` | Loại control, tên, nhãn, required, validation và hình giá trị, không giá trị. |
| `media` / `embed` | Video/audio settings; iframe/map/widget với provider. |
| `a11y` | Role/name truy cập Chromium tính, trạng thái `expanded`/`checked`. |
| `logo` | Bằng chứng logo nút. |
| `reveals` / `frame` | Tệp reveal/frame nhúng. |
| `volatile` | Tại sao vùng đổi giữa bản thu. |

Mặc định giữ 2500 phần tử thấy/trang (`truncated` lúc chạm); giới hạn theo việc, tăng cho trang lớn. Phông `fonts.json`, webfont gốc trong kho. Dùng `resources[].path` với `get_capture_asset` lấy local/URI. `get_fonts` `includeUrls=true` cho nguồn, `includeFaces=true` cho Unicode/weight. Ưu tiên byte kho; thiếu thì tải nguồn hoặc phông phép mở và nói thay thế. `get_fonts` fallback trang khi file phiên bản rỗng. Chủ đề trong page state/`themes.json`; thiếu thì `get_themes` suy light/dark/system từ class `html`, `data-theme`, menu, CSS custom.

## Truy cập và tài nguyên inline {/* #access-and-inline-assets */}

Đăng nhập để xem bản công bố; chỉ phiên bản công bố có sẵn.

Dùng token MCP tải `/mcp-assets/*`, `/mcp-transfers/*`. Remote giải URI tương đối theo origin MCP, gửi cùng Bearer. Dùng URI trả, không path `path`/`starterPath` phía server; lưu local trước HTML/CSS.

Link thuộc tài khoản hỏi. Hết hiệu lực thì hỏi tham chiếu mới cho bản công bố.

`get_element_asset(includeContent=true)` cho nội dung inline nhỏ; lớn là link. Background/mask data image cũng là tham chiếu.

## Yêu cầu sản phẩm {/* #product-requests */}

OAuth hoặc token phạm vi MCP. Gửi/xem yêu cầu mình, duyệt công khai như nền tảng.

| Công cụ | Tham số | Kết quả |
|---|---|---|
| `get_request_options` | Không | `platforms[]` từ `capture-options.requestPlatforms` |
| `create_product_request` | Bắt buộc `requestType`, `platform`, `environment`; tùy chọn `product=""`, `url=""`, `subject=""`, `payloadJson=""` | Yêu cầu chờ tạo, `requestId`, duyệt/an toàn |
| `get_product_request` | Bắt buộc `requestId`; `scope="mine"` hoặc `"public"` | Duyệt/an toàn riêng hoặc trường công khai người khác |
| `list_product_requests` | `scope="mine"` hoặc `"public"`, `pageSize=50`, `pageToken=""` | Mới trước theo scope, `nextPageToken`; tối đa 200/trang |
| `wait_product_request` | Bắt buộc `requestId`, `knownStatus`; `waitSeconds=20` | `{request, changed, terminal, timedOut}`; tối đa 30 giây |

`requestType="add"`: HTTPS `url` công khai, `product` rỗng. Subject bỏ lấy từ URL. `requestType="update"`: khóa đã công bố, server suy tên/nguồn. Dùng ID `get_request_options`; hiện chỉ Web dù có capture native.

Cần đăng ký đủ điều kiện/URL an toàn. Trùng đang hoạt động có thể từ chối. Gửi chỉ tạo duyệt, không thu ngay. Chỉ gửi khi người yêu cầu. Không tốn context.

`scope="mine"` mặc định đọc của mình kèm duyệt/an toàn. `scope="public"` xem người khác; bỏ chủ, chi tiết riêng, ghi chú an toàn/lý do. `payloadJson` công khai chỉ nền tảng/môi trường. Không scope nào lộ job.

Phân trang truyền `nextPageToken` thành `pageToken`, cùng `scope`. `nextPageToken` rỗng là hết; token scope khác bị từ chối. `wait_product_request` chỉ yêu cầu mình.

`status`: `pending`, `approved`, `rejected`. Duyệt/từ chối hoàn tất xem xét; duyệt không phải dữ liệu sẵn.

`wait_product_request` trả lúc status đổi, duyệt xong, timeout. Timeout giữ ID gọi lại để chờ. Kiểm bản thu riêng bằng catalog.

```json
{"requestType":"add","url":"https://example.com/","platform":"desktop","environment":"web"}
```

```json
{"requestType":"update","product":"existing-product-key","platform":"mobile","environment":"web"}
```

```json
{"requestId":"<returned UUID>","knownStatus":"pending","waitSeconds":20}
```