# 知识卡导出索引文件
schema_version: 1
locale: zh-CN
commit: 43d42ad891b652f79db1f37091141cb7a2b4e314
branch: main
exported_at: "2026-09-06T19:46:36Z"
modules:
    frontend_pages:
        dir_name: ESP32_DCU 调试控制台前端页面集
        title: ESP32/DCU 调试控制台前端页面集
        scope:
            - pages/
            - css/
            - tabs.html
        source_files: []
        children: []
        depends_on: []
        related_to:
            - path: python_server
              reason: esp32_server.py 作为静态文件服务器提供 tabs.html、pages/ 与 lab/ 目录下的 HTML，页面由本服务同源 serving。
    js_frontend:
        dir_name: ESP32 DCU 前端 Web 控制台集合
        title: ESP32 DCU 前端 Web 控制台集合
        scope:
            - js/
        source_files: []
        children:
            - js_frontend/app_entries
            - js_frontend/ble
            - js_frontend/can
            - js_frontend/common
            - js_frontend/motor
            - js_frontend/ota
        depends_on: []
        related_to: []
    js_frontend/app_entries:
        dir_name: 前端应用入口聚合层（ESP32 OTA _ BLE OTA _ CAN 诊断）
        title: 前端应用入口聚合层（ESP32 OTA / BLE OTA / CAN 诊断）
        scope:
            - js/app.js
            - js/ble_ota.js
            - js/can.js
        source_files: []
        children: []
        depends_on: []
        related_to:
            - path: python_server
              reason: OTA、BLE、CAN 控制台页面均由 python_server 的静态文件服务提供，并通过 base-url.js 中 localStorage 存储的 dcu_esp_ip 以同源请求访问设备 API。
    js_frontend/ble:
        dir_name: BLE 通道 OTA 客户端（Web Bluetooth GATT）
        title: BLE 通道 OTA 客户端（Web Bluetooth GATT）
        scope:
            - js/ble/
        source_files: []
        children: []
        depends_on: []
        related_to: []
    js_frontend/can:
        dir_name: CAN 控制台前端：DBC 解析、报文发送与接收监控
        title: CAN 控制台前端：DBC 解析、报文发送与接收监控
        scope:
            - js/can/
            - js/can_monitor.js
        source_files: []
        children: []
        depends_on: []
        related_to: []
    js_frontend/common:
        dir_name: 前端公共工具库（连接_轮询_日志_Toast_IndexedDB）
        title: 前端公共工具库（连接/轮询/日志/Toast/IndexedDB）
        scope:
            - js/common/
        source_files: []
        children: []
        depends_on: []
        related_to: []
    js_frontend/motor:
        dir_name: 电机控制台多传输模块
        title: 电机控制台多传输模块
        scope:
            - js/motor/
        source_files: []
        children: []
        depends_on: []
        related_to:
            - path: js_frontend/can
              reason: CAN 控制台与电机控制台均通过 POST /can/send_batch 发送帧到 ESP32 设备，但 CAN 用于通用报文编辑而电机用于特定 CMD/CONFIG 控制流程。
            - path: python_server
              reason: 电机控制台通过 /ecat/api/* 反向代理访问本地 ecat_native.exe 的 /api/motor/*（transport-ecat.js 中拼接路径发送）。
    js_frontend/ota:
        dir_name: 前端 OTA 刷写会话与进度管理
        title: 前端 OTA 刷写会话与进度管理
        scope:
            - js/ota/
        source_files: []
        children: []
        depends_on: []
        related_to:
            - path: js_frontend/ble
              reason: 两者均为浏览器端固件升级方案：js/ota 走 WiFi ESP32 HTTP（分块上传+SHA-256），js/ble 走 Web Bluetooth GATT（分包 ACK+窗口+SHA-256），同一业务目标的不同实现。
    lab:
        dir_name: 调试诊断与 EtherCAT 采样数据
        title: 调试诊断与 EtherCAT 采样数据
        scope:
            - lab/
            - ecat_slots_raw.csv
        source_files: []
        children: []
        depends_on: []
        related_to: []
    python_server:
        dir_name: ESP32 调试控制台本地 Web 服务器与窗口外壳
        title: ESP32 调试控制台本地 Web 服务器与窗口外壳
        scope:
            - esp32_server.py
            - esp32_app.vbs
            - esp32_web.vbs
        source_files: []
        children: []
        depends_on: []
        related_to: []
    root:
        dir_name: ESP32 DCU 调试控制台仓库根
        title: ESP32 DCU 调试控制台仓库根
        scope:
            - README.md
            - CHANGELOG.md
            - .gitignore
            - .gitattributes
            - esp32_server.py
            - esp32_app.vbs
            - esp32_web.vbs
            - tabs.html
            - serve.bat
        source_files: []
        children:
            - frontend_pages
            - js_frontend
            - lab
            - python_server
            - scripts_and_tests
        depends_on: []
        related_to: []
    scripts_and_tests:
        dir_name: ECAT 调试、固件刷写与端到端测试脚本集
        title: ECAT 调试、固件刷写与端到端测试脚本集
        scope:
            - scripts/
        source_files: []
        children: []
        depends_on: []
        related_to:
            - path: python_server
              reason: 脚本 test_app_lease_e2e.mjs 等连接本地页面服务器的 /ws/app-lease 端点做端到端断言（端口探测与 POST 触发）。