graph TB
    subgraph HS["HarmonyOS System"]
        subgraph APP["OHcode Application"]
            subgraph HAP["electron — HAP 入口模块"]
                EA["EntryAbility"]
                BA["BrowserAbility"]
                SA["StatelessAbility"]
                SBE["StatusBarEntryAbility"]
                BEA["BrowserEmbeddedAbility"]
                IDX["Index · 启动加载页"]
                QR["QemuRunner · prepareQemuImages"]
            end

            subgraph HAR["web_engine — HAR 引擎库"]
                subgraph AB["Adapter 层 · 37 个系统适配器"]
                    A1["窗口管理"]
                    A2["对话框 / 文件选择"]
                    A3["蓝牙 / BLE"]
                    A4["输入法 / 手势"]
                    A5["通知 / 状态栏"]
                    A6["… 更多"]
                end
                subgraph JB["JSBindings · 37 个绑定"]
                    JBM["JsBindingMethod · 注册中心"]
                end
                subgraph CMP["UI 组件"]
                    WW["WebWindow"]
                    WSW["WebSubWindow"]
                    WEW["WebEmbeddedWindow"]
                    MB["MessageBox"]
                end
                subgraph INF["基础设施"]
                    DI["InjectModule · IoC 容器"]
                    AM["AbilityManager"]
                    BS["BaseAdapter"]
                    JBU["JsBindingUtils"]
                end
            end

            subgraph NAT["Native Bridge"]
                LA["libadapter.so<br/>Chromium / Electron"]
                LE["libentry.so<br/>NAPI 模块"]
            end

            subgraph QEMU["QEMU Linux Guest"]
                QG["ARM64 Linux<br/>bash · node · rg"]
                V9["virtio-9p 文件共享"]
                VS["virtio-serial 命令桥"]
                VN["virtio-net 网络转发"]
            end
        end
    end

    EA -->|extends| WW
    BA -->|extends| WW
    EA -->|boots| QR
    QR -->|dlopen + thread| LE
    LE -->|启动| QG
    JB -->|bindFunction| LA
    AB -->|调用| JBU
    CMP -->|XComponent| LA
    LE -->|HostCmd| VS
    QG <-->|文件| V9
    QG <-->|网络| VN

    style HAP fill:#1a1a2e,stroke:#e94560,color:#eee
    style HAR fill:#16213e,stroke:#0f3460,color:#eee
    style NAT fill:#0f3460,stroke:#533483,color:#eee
    style QEMU fill:#1a1a2e,stroke:#e94560,color:#eee

classDiagram
    class WebProxy {
        <<interface>>
        +getWindowStage()
        +getWindow()
        +getWindowId()
        +getOriginWindowId()
        +closeWindow()
        +setWindowTitle()
        +createSubWindow()
    }

    class WebBaseAbility {
        +xcomponentId: string
        +startUri: string
        +nativeContext: NativeContext
        +hideTitleBar: boolean
        +useDarkMode: boolean
        +electronRelaunchArgs: string[]
        +initParameters(want)
        +getContentPath(): string
    }

    class WebBaseExtensionAbility {
        +hostModuleId: string
        +session: UIExtensionContentSession
        +onSessionCreate(want, session)
    }

    class WebAbility {
        +onCreate()
        +onWindowStageCreate()
        +onConfigurationUpdate()
    }

    class WebEmbeddedAbility {
        +onSessionCreate()
        +onSessionDestroy()
    }

    WebProxy <|.. WebBaseAbility : implements
    WebProxy <|.. WebBaseExtensionAbility : implements
    WebBaseAbility <|-- WebAbility
    WebBaseExtensionAbility <|-- WebEmbeddedAbility
    WebAbility <|-- EntryAbility
    WebAbility <|-- BrowserAbility
    WebAbility <|-- StatelessAbility
    WebEmbeddedAbility <|-- BrowserEmbeddedAbility

mindmap
  root((37 Adapters))
    🖥️ 窗口管理
      AppWindowAdapter · 主窗口创建/管理
      SubWindowAdapter · 子窗口池 (max 20)
      PopupWindowAdapter · 弹出窗口
      SystemFloatingWindowAdapter · 悬浮置顶窗口
      RunningLockAdapter · 防休眠
    💬 对话与交互
      DialogAdapter · 消息框/文件选择/照片选择
      FilePickerAdapter · 文件打开/保存 (MIME 过滤)
      MultiInputAdapter · 手势路由 (鼠标/触控/手写笔)
      IMFAdapter · 输入法框架 (软键盘/光标/文本插入)
    📡 连接与通信
      BluetoothAdapter · 经典蓝牙状态
      BluetoothLowEnergyAdapter · BLE 扫描/GATT 读写
      DeviceAdapter · USB 枚举与热插拔
      NotificationAdapter · 系统通知
      StatusBarManager · 状态栏托盘图标
    🔐 安全与权限
      CertManagerAdapter · 客户端证书安装/枚举/删除
      PermissionManagerAdapter · 运行时权限 (定位/相机/麦克风)
      BrowserPolicyAdapter · MDM 企业策略
      DeviceUserAuthAdapter · 生物识别 (指纹/面部/PIN)
    🎨 显示与外观
      DisplayAdapter · 多显示器/分辨率
      NativeThemeAdapter · 深色/浅色主题
      CursorAdapter · 光标样式/自定义光标
      FontAdapter · 系统字体枚举
    📸 媒体与视觉
      MediaAdapter · 摄像头预览
      ScreenshotAdapter · 全屏截图
      ShapeDetectionAdapter · 人脸检测 + OCR 文字识别
      SpeechAdapter · TTS 语音合成
    ⚙️ 应用基础
      ElectronAppAdapter · 应用信息/重启/区域设置
      AppLifecycleAdapter · 引擎生命周期
      ProcessAdapter · 子进程启动
      ContextAdapter · 上下文/活跃窗口持有
      ContextPathAdapter · 资源目录/系统设置/下载路径
    📁 文件与拖放
      FileManagerAdapter · 在文件管理器中显示
      DragDropAdapter · 跨窗口拖放 (UDC)
      MimeTypeAdapter · MIME ↔ 扩展名转换
      PrintAdapter · 系统打印对话框
    🌍 国际化
      I18nAdapter · 语言/区域 + 时区变化监听
      AccessibilityAdapter · 无障碍 (stub)

sequenceDiagram
    participant C as Chromium / libadapter.so
    participant NC as NativeContext
    participant JB as JSBindings
    participant AD as Adapters
    participant HO as HarmonyOS APIs

    Note over NC: 引擎启动时由 WebAbilityStage 初始化

    rect rgb(30, 30, 60)
        Note over C,HO: 正向调用 — ArkTS → Chromium
        WW->>NC: runBrowser(args)
        WW->>NC: ExecuteCommand(kNewWindow, {url})
        NC->>C: 执行 Chromium 命令
    end

    rect rgb(60, 30, 30)
        Note over C,HO: 反向回调 — Chromium → ArkTS
        C->>NC: 需要打开对话框
        NC->>JB: Dialog_ShowMessageBox(params)
        JB->>AD: DialogAdapter.showMessageBox()
        AD->>HO: AlertDialog.show()
        HO-->>AD: 用户点击
        AD-->>C: 返回结果
    end

    rect rgb(30, 60, 30)
        Note over C,HO: 绑定注册 — 启动时一次性
        JB->>NC: JSBind.bindFunction("Dialog_ShowMessageBox", fn)
        NC->>C: 注册回调句柄
    end

flowchart LR
    subgraph DI["InjectModule · IoC 容器"]
        AM["AdapterModule<br/>核心 Adapter 预注册"]
        GO["getOrCreate<br/>按需自动绑定"]
    end

    subgraph Core["核心流程"]
        WA["WebAbility"]
        WW["WebWindow"]
    end

    subgraph Adapters["Adapter 实例"]
        DA["DialogAdapter"]
        DDA["DragDropAdapter"]
        MIA["MultiInputAdapter"]
        NTA["NativeThemeAdapter"]
        PMA["PermissionManagerAdapter"]
        CA["ContextAdapter"]
        CTA["ContextPathAdapter"]
        DSP["DisplayAdapter"]
        DOT["… 其余 29 个"]
    end

    WA -->|Inject.get| DI
    WW -->|Inject.get| DI
    AM --> DA & DDA & MIA & NTA & PMA & CA & CTA & DSP
    GO --> DOT

sequenceDiagram
    actor User
    participant OS as HarmonyOS
    participant AS as WebAbilityStage
    participant EA as EntryAbility
    participant QR as QemuRunner
    participant IDX as Index Page
    participant WW as WebWindow
    participant CH as Chromium
    participant VS as VS Code

    User->>OS: 点击 OHcode 图标
    OS->>AS: onCreate()
    AS->>AS: initNativeContext(kMainProcess)
    AS->>AS: JsBindingMethod.bind() — 注册全部回调

    OS->>EA: onCreate(want)
    EA->>EA: handleOpenWant() — 处理文件打开意图
    EA->>QR: startQemu(context)
    QR->>QR: prepareQemuImages() — 首次拷贝内核/rootfs
    QR->>QR: ensureWorkspaceDir()
    QR->>QR: native.startQemu() — dlopen + 启动线程

    OS->>EA: onWindowStageCreate()
    EA->>IDX: 加载 pages/Index

    IDX->>IDX: 显示流光渐变加载页
    IDX->>IDX: 清除残留的就绪标记
    IDX->>IDX: 开始轮询 ohcode-ready.flag (200ms)

    IDX->>WW: WebWindow 组件渲染
    WW->>WW: buildArgs() — 读取标记文件
    WW->>CH: runBrowser(args)
    CH->>CH: 初始化 V8 / 加载 VS Code

    CH->>VS: VS Code 启动
    VS->>VS: onStartupFinished
    VS->>VS: 写入 ohcode-ready.flag

    IDX->>IDX: 轮询到标记 → hideLoading()
    IDX->>IDX: 加载页淡出 (500ms)
    User->>User: 🎉 VS Code 工作台就绪

flowchart TB
    EA["EntryAbility.onCreate()"]
    QR["QemuRunner.startQemu(context)"]

    subgraph Prep["准备阶段"]
        PQI["prepareQemuImages()<br/>拷贝 Image + rootfs.cpio.gz"]
        EWD["ensureWorkspaceDir()<br/>创建 /data/.../workspace"]
    end

    subgraph Native["Native 层 · libentry.so"]
        SQ["startQemu() — NAPI"]
        DLO["dlopen libqemu-system-aarch64.so"]
        HCB["StartHostCommandBridge()<br/>连接 Unix Socket"]
        QET["qemu_system_entry()<br/>独立线程运行"]
    end

    subgraph Guest["QEMU Guest · ARM64 Linux"]
        INIT["/sbin/init"]
        OHPTYD["ohptyd — PTY 守护进程"]
        MOUNT["mount -t 9p usershare /share"]
        TOOLS["bash · node · rg · …"]
    end

    EA --> QR
    QR --> PQI --> EWD --> SQ
    SQ --> DLO --> HCB --> QET
    QET --> INIT
    INIT --> OHPTYD & MOUNT & TOOLS

    style Prep fill:#1a3a1a,stroke:#4caf50,color:#eee
    style Native fill:#1a1a3a,stroke:#5c6bc0,color:#eee
    style Guest fill:#3a1a1a,stroke:#ef5350,color:#eee

graph LR
    subgraph Guest["QEMU Guest"]
        G9["/share<br/>virtio-9p 挂载点"]
        GVS["ohcode.hostcmd<br/>virtio-serial 端口"]
        GCON["ttyAMA0<br/>串口控制台"]
        GNET["7681 端口<br/>ohptyd 监听"]
    end

    subgraph Host["HarmonyOS Host"]
        H9["/storage/Users/currentUser<br/>用户工作目录"]
        HSK["hostcmd.sock<br/>Unix Socket"]
        HLOG["console.log<br/>日志文件"]
        HPT["127.0.0.1:39001<br/>终端连接"]
    end

    G9 <-->|"双向文件共享<br/>编辑即保存"| H9
    GVS -->|"Guest 发命令<br/>Host popen 执行"| HSK
    GCON -->|"内核日志<br/>启动诊断"| HLOG
    HPT -->|"hostfwd TCP 转发<br/>VS Code 终端"| GNET

    style Guest fill:#3a1a1a,stroke:#ef5350,color:#eee
    style Host fill:#1a1a3a,stroke:#5c6bc0,color:#eee

flowchart LR
    A["编译 ArkTS / C++"] --> B["PackageHap<br/>打包 HAP"]
    B --> C["RepackHapWithHnp<br/>注入 HNP 包"]
    C --> D["SignHap<br/>签名"]
    D --> E["安装到设备"]

flowchart LR
    C["Chromium<br/>libadapter.so"] -->|"调用已注册的<br/>JSBind 回调"| B["XxxAdapterBind<br/>提取参数"]
    B -->|"委托"| A["XxxAdapter<br/>调用 HarmonyOS API"]
    A -->|"返回结果"| C

sequenceDiagram
    participant HV as Hvigor 构建系统
    participant PH as PackageHap 任务
    participant RH as RepackHapWithHnp 插件
    participant PS as PowerShell 脚本
    participant JT as app_packing_tool.jar
    participant SH as SignHap 任务

    HV->>PH: 打包 HAP
    PH-->>RH: unsigned HAP 就绪
    RH->>PS: execFileSync(powershell)
    PS->>PS: 检查 hnp/ 目录
    PS->>PS: 检查 DEVECO_SDK_HOME
    PS->>JT: java -jar app_packing_tool.jar<br/>--hnp-path hnp/
    JT-->>PS: 重新打包的 HAP（含 HNP）
    PS-->>RH: 完成
    RH->>SH: 签名

sequenceDiagram
    actor FM as 文件管理器
    participant EA as EntryAbility
    participant MF as 标记文件
    participant WW as WebWindow
    participant CH as Chromium

    FM->>EA: onNewWant(want)<br/>want.uri = "file:///data/.../main.ts"
    EA->>EA: handleOpenWant()
    EA->>EA: FileUri(uri).path → 真实路径
    EA->>EA: statSync(path).isDirectory()?
    EA->>MF: 写入 "file|file:///data/.../main.ts"
    Note over MF: ohcode-open-target.txt

    Note over WW: 下次 WebWindow 加载时
    WW->>WW: buildArgs()
    WW->>MF: 读取标记
    MF-->>WW: "file|file:///data/.../main.ts"
    WW->>MF: 删除标记（一次性消费）
    WW->>CH: --file-uri=file:///data/.../main.ts
    Note over CH: VS Code 打开该文件

graph TB
    subgraph Layer1["Layer 1 · Chromium ↔ ArkTS"]
        CH["Chromium / libadapter.so"]
        JB["JSBindings<br/>(36 个回调注册)"]
        NC["NativeContext<br/>runBrowser / ExecuteCommand"]
    end

    subgraph Layer2["Layer 2 · ArkTS ↔ HarmonyOS"]
        AD["Adapters<br/>(37 个系统封装)"]
        HO["HarmonyOS APIs"]
    end

    subgraph Layer3["Layer 3 · ArkTS 组件间"]
        EA["EntryAbility"]
        WW["WebWindow"]
        IDX["Index Page"]
        MF["标记文件<br/>(ohcode-open-target.txt 等)"]
    end

    subgraph Layer4["Layer 4 · Guest ↔ Host"]
        QG["QEMU Guest"]
        V9["virtio-9p"]
        VS["virtio-serial"]
        VN["virtio-net"]
        HP["Host Process"]
    end

    CH <-->|"JSBind 回调<br/>+ ExecuteCommand"| NC
    JB -->|bindFunction| CH
    AD -->|"调用"| HO
    JB -->|"委托"| AD
    EA -->|"写入"| MF
    WW -->|"读取+删除"| MF
    IDX -->|"轮询"| MF

    QG <-->|"文件"| V9 <--> HP
    QG -->|"命令"| VS --> HP
    HP -->|"终端"| VN --> QG