# easytouch-plugin-scan

**Repository Path**: easytouchplugins/easytouch-plugin-scan

## Basic Information

- **Project Name**: easytouch-plugin-scan
- **Description**: easytouch-plugin-scan
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-05
- **Last Updated**: 2026-08-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# easytouch-plugin-scan

EasyTouch Client 扫码插件（纯 Flutter，无 rust 端）。

## plugin_id

`client.com.easytouch.scan`

## ui_render_mode

`custom`（mobile_scanner 需要原生交互）

## 职责边界

- ✅ 扫码 UI（ScanPage）
- ✅ QR 解析逻辑（qr_parser）
- ✅ 返回 PeerQrData 数据类
- ❌ Zenoh 设备注册（宿主层职责）
- ❌ Isar 持久化（宿主层职责）
- ❌ tab 切换（宿主层 MainNavigationShell 职责）

## 目录结构

```
client/
  lib/
    pages/scan_page.dart
    models/peer_qr_data.dart
    services/qr_parser.dart
    client_scan_ui_plugin_entry.dart
  test/
    scan_page_test.dart
  manifest.json       # 由 etk build 生成，禁止手编
  pubspec.yaml
```

## manifest 更新

```bash
etk build plugins/scan
```

禁止手工编辑 `client/manifest.json`，由 `etk build` 唯一生成。

## 路由

- `/scan` — 扫码页（返回 `Future<PeerQrData?>`）

## 依赖

- `easytouch_sdk`（path: ../../../easytouch-sdk/flutter）
- `mobile_scanner: ^4.0.1`

## 关联

- ADR-05 主导航 Tab 插件化重构 + scan 新插件
- Phase-11-tab-plugin-refactor