Knob v2

flowchart LR
    HW["硬件配件<br/>ESP32-S3 + 编码器 + 圆形屏"]
    subgraph CAR["车机"]
        SHELL["壳 App<br/>车机厂商签名，只签一次"]
        DEX["plugin.dex<br/>全部车控/业务逻辑，可热更新"]
        SHELL -- DexClassLoader --> DEX
    end
    HW <-- "自定义 BLE GATT<br/>双向：事件 / 回显 / 固件 OTA" --> DEX

├── app/                 # 壳 App（Android 工程，cn.icarus.knob）
│   ├── 使用与验证指南.md  # App 用法 / 实车验证步骤说明书
│   └── app/src/
│       ├── byd/ · generic/  # 按平台分的 flavor：权限声明 + PlatformConfig
│       └── main/java/cn/icarus/knob/
│           ├── api/          # 壳↔DEX 契约：KnobPlugin / KnobHost / Ui
│           ├── plugin/       # PluginLoader：导入并加载 plugin.dex
│           ├── host/         # KnobHostImpl：壳向插件提供的能力（只剩日志）
│           ├── util/         # 日志（LogSink）/ CrashHandler
│           └── KnobActivity / KnobApp / BootReceiver / RuntimePerm
├── plugin/               # 插件工程（编译产出 output/plugin.dex，可反复更新）
│   └── src/main/
│       ├── flags-real/ · flags-simulate/  # BuildFlags.kt：真实车控 / 模拟两个变体
│       └── kotlin/cn/icarus/knob/
│           ├── api/               # 与壳完全相同的契约副本（改动须两边同步）
│           └── plugin/
│               ├── MainPlugin.kt      # KnobPlugin 接口实现（入口 + 停靠点状态机 + 页面路由）
│               ├── page/              # 触屏页面，一个页面一个文件
│               ├── CarCommands.kt     # onCommand / onQuery 命令清单
│               ├── CarActions.kt      # 停靠点的车控读写（空调、座椅）
│               ├── CarPermissions.kt  # 车控运行时权限（只在用户点按钮时申请）
│               ├── StartupCheck.kt    # 启动自检（通过才连旋钮）
│               ├── KnobOta.kt         # 旋钮固件自动升级
│               ├── DriveFeed.kt       # 旋钮驾驶页的数据源

# 壳 App（比亚迪车机）→ app/app/build/outputs/apk/bydRelease/app-byd-release-unsigned.apk
cd app && ./gradlew assembleBydRelease

# 插件包（插件 + 旋钮固件）→ plugin/output/knob-plugin-<板子>-<固件版本>.zip
# 板子：Pcb（V1）/ PcbV2 / Devkit；需要 PlatformIO（pio）
cd plugin && ./gradlew pluginPackagePcb

# 只要插件、不带固件 → plugin/output/plugin.dex（SDK 版本见根目录 gradle/libs.versions.toml，SDK 路径自动探测）
cd plugin && ./gradlew pluginDex