{
  "focus": "StackChan 表达终端",
  "accessed_at": "2026-10-27",
  "priority": "M5 2026 工厂栈优先，社区栈对照",
  "versions": {
    "factory": {
      "repository": "m5stack/StackChan",
      "branch": "main",
      "commit": "eff0d6b5109663faec8f1d98848b4b0e5246bbfc",
      "committed_at": "2026-10-22T01:40:01Z",
      "created_at": "2026-01-07T09:16:45Z"
    },
    "community": {
      "repository": "stack-chan/stack-chan",
      "branch": "develop",
      "commit": "373fad66cec9af4ee5c9a3643fc8832a4014c642",
      "committed_at": "2026-10-25T00:24:34Z",
      "created_at": "2021-06-06T14:31:19Z"
    },
    "hardware": {
      "repository": "m5stack/M5_Hardware",
      "branch": "master",
      "commit": "e29c139cbc7c80b5ccc5557e5ab8025a7a19a109",
      "committed_at": "2026-10-23T06:10:33Z",
      "created_at": "2021-11-04T09:21:19Z"
    },
    "xiaozhi": {
      "repository": "78/xiaozhi-esp32",
      "branch": "v2.2.4",
      "commit": "e77dedb1309153bb63fed285772962c920c97dd4",
      "committed_at": "2026-03-09T11:33:01Z"
    }
  },
  "assets": [
    {
      "asset": "工厂表达层与状态桥接",
      "category": "firmware",
      "paths": [
        "firmware/main/stackchan/avatar",
        "firmware/main/stackchan/modifiers",
        "firmware/main/hal/board/stackchan_display.cc"
      ],
      "repository_key": "factory",
      "reusability": "可作为表达终端主体，需保留 LVGL/HAL 依赖",
      "modification": "将随机嘴部动画替换为播放时钟/能量或音素同步",
      "license": "MIT 自有代码，外部依赖单核",
      "evidence": "https://github.com/m5stack/StackChan/blob/eff0d6b5109663faec8f1d98848b4b0e5246bbfc/firmware/main/hal/board/stackchan_display.cc#L480-L568",
      "version": {
        "repository": "m5stack/StackChan",
        "branch": "main",
        "commit": "eff0d6b5109663faec8f1d98848b4b0e5246bbfc",
        "committed_at": "2026-10-22T01:40:01Z",
        "created_at": "2026-01-07T09:16:45Z"
      },
      "accessed_at": "2026-10-27",
      "verification": "源码/文件清单研究，未做完整构建或硬件验证"
    },
    {
      "asset": "舵机抽象与坐标纯函数",
      "category": "firmware",
      "paths": [
        "firmware/main/stackchan/motion",
        "firmware/main/hal/hal_servo.cpp",
        "firmware/tests/motion_math_test.cpp"
      ],
      "repository_key": "factory",
      "reusability": "可复用接口、限位、零位校准和纯函数测试",
      "modification": "按实际机械范围重标定比例、零位、堵转参数",
      "license": "MIT，FTServo 独立 MIT",
      "evidence": "https://github.com/m5stack/StackChan/blob/eff0d6b5109663faec8f1d98848b4b0e5246bbfc/firmware/main/hal/hal_servo.cpp#L331-L360",
      "version": {
        "repository": "m5stack/StackChan",
        "branch": "main",
        "commit": "eff0d6b5109663faec8f1d98848b4b0e5246bbfc",
        "committed_at": "2026-10-22T01:40:01Z",
        "created_at": "2026-01-07T09:16:45Z"
      },
      "accessed_at": "2026-10-27",
      "verification": "源码/文件清单研究，未做完整构建或硬件验证"
    },
    {
      "asset": "App 与设备 LAN 消息协议",
      "category": "protocol",
      "paths": [
        "app/lib/model/msg_type.dart",
        "app/lib/network/local_area_network_service.dart",
        "firmware/main/hal/utils/local_network/local_network_protocol.h"
      ],
      "repository_key": "factory",
      "reusability": "25 消息类型和 20 字节包头静态一致性已验证",
      "modification": "独立发现、认证、加密、运行时边界及断线测试",
      "license": "已读文件 MIT SPDX",
      "evidence": "https://github.com/m5stack/StackChan/blob/eff0d6b5109663faec8f1d98848b4b0e5246bbfc/firmware/main/hal/utils/local_network/local_network_protocol.h#L17-L89",
      "version": {
        "repository": "m5stack/StackChan",
        "branch": "main",
        "commit": "eff0d6b5109663faec8f1d98848b4b0e5246bbfc",
        "committed_at": "2026-10-22T01:40:01Z",
        "created_at": "2026-01-07T09:16:45Z"
      },
      "accessed_at": "2026-10-27",
      "verification": "源码/文件清单研究，未做完整构建或硬件验证"
    },
    {
      "asset": "Flutter 配网和设备控制 App",
      "category": "app",
      "paths": [
        "app/lib/view/popup/device_wifi_config.dart",
        "app/lib/network/urls.dart",
        "app/pubspec.yaml"
      ],
      "repository_key": "factory",
      "reusability": "可参考完整配网和控制流",
      "modification": "编译期服务地址、HTTPS/WSS、平台权限、依赖锁与素材许可",
      "license": "已读源码 MIT SPDX，插件/模型/素材未全审",
      "evidence": "https://github.com/m5stack/StackChan/blob/eff0d6b5109663faec8f1d98848b4b0e5246bbfc/app/lib/network/urls.dart#L15-L49",
      "version": {
        "repository": "m5stack/StackChan",
        "branch": "main",
        "commit": "eff0d6b5109663faec8f1d98848b4b0e5246bbfc",
        "committed_at": "2026-10-22T01:40:01Z",
        "created_at": "2026-01-07T09:16:45Z"
      },
      "accessed_at": "2026-10-27",
      "verification": "源码/文件清单研究，未做完整构建或硬件验证"
    },
    {
      "asset": "Go 设备管理和转发服务",
      "category": "backend",
      "paths": [
        "server/internal/cmd/cmd.go",
        "server/internal/service/user.go",
        "server/internal/xiaozhi/xiaozhi.go"
      ],
      "repository_key": "factory",
      "reusability": "设备/内容/WS 路由可重用",
      "modification": "远端账号及小智开发者/License 依赖，数据库/密钥配置",
      "license": "server/LICENSE MIT，Go 依赖另核",
      "evidence": "https://github.com/m5stack/StackChan/blob/eff0d6b5109663faec8f1d98848b4b0e5246bbfc/server/internal/service/user.go#L27-L66",
      "version": {
        "repository": "m5stack/StackChan",
        "branch": "main",
        "commit": "eff0d6b5109663faec8f1d98848b4b0e5246bbfc",
        "committed_at": "2026-10-22T01:40:01Z",
        "created_at": "2026-01-07T09:16:45Z"
      },
      "accessed_at": "2026-10-27",
      "verification": "源码/文件清单研究，未做完整构建或硬件验证"
    },
    {
      "asset": "工厂 OTA 和小智适配",
      "category": "integration",
      "paths": [
        "firmware/main/Kconfig.projbuild",
        "firmware/main/hal/hal_ota.cpp",
        "firmware/repos.json",
        "firmware/patches/xiaozhi-esp32.patch"
      ],
      "repository_key": "factory",
      "reusability": "有双端点配置和升级入口",
      "modification": "业务地址与 OTA 发现分别迁移，兼容 App 激活补丁/NVS",
      "license": "M5 与小智自有代码 MIT，运行依赖和模型另核",
      "evidence": "https://github.com/m5stack/StackChan/blob/eff0d6b5109663faec8f1d98848b4b0e5246bbfc/firmware/patches/xiaozhi-esp32.patch#L358-L415",
      "version": {
        "repository": "m5stack/StackChan",
        "branch": "main",
        "commit": "eff0d6b5109663faec8f1d98848b4b0e5246bbfc",
        "committed_at": "2026-10-22T01:40:01Z",
        "created_at": "2026-01-07T09:16:45Z"
      },
      "accessed_at": "2026-10-27",
      "verification": "源码/文件清单研究，未做完整构建或硬件验证"
    },
    {
      "asset": "K151 结构 STL",
      "category": "hardware",
      "paths": [
        "Products/K151_StackChan/Structures"
      ],
      "repository_key": "hardware",
      "reusability": "10 个 STL，可作空间参考或试打",
      "modification": "需机械实测，未见同 SKU STEP/原生 PCB/BOM",
      "license": "仓库根 MIT，子树未发现独立覆盖声明，官网 PDF 不外推",
      "evidence": "https://github.com/m5stack/M5_Hardware/tree/e29c139cbc7c80b5ccc5557e5ab8025a7a19a109/Products/K151_StackChan/Structures",
      "version": {
        "repository": "m5stack/M5_Hardware",
        "branch": "master",
        "commit": "e29c139cbc7c80b5ccc5557e5ab8025a7a19a109",
        "committed_at": "2026-10-23T06:10:33Z",
        "created_at": "2021-11-04T09:21:19Z"
      },
      "accessed_at": "2026-10-27",
      "verification": "源码/文件清单研究，未做完整构建或硬件验证"
    },
    {
      "asset": "K151 原理图 PDF",
      "category": "hardware",
      "paths": [
        "CoreS3",
        "Adapter",
        "Power",
        "Ring",
        "Touch"
      ],
      "repository_key": null,
      "reusability": "官方文档外链 5 个 PDF 可解析",
      "modification": "需 PCB 原生工程/BOM/电气审查",
      "license": "官网 PDF 再分发授权未确认",
      "evidence": "https://docs.m5stack.com/en/StackChan",
      "version": null,
      "accessed_at": "2026-10-27",
      "verification": "源码/文件清单研究，未做完整构建或硬件验证"
    },
    {
      "asset": "社区行为/面部状态与 MOD 扩展",
      "category": "community",
      "paths": [
        "firmware/host/app/main.ts",
        "firmware/host/app/compose.ts",
        "firmware/host/modules/ui/state/face-state.ts"
      ],
      "repository_key": "community",
      "reusability": "可编程行为、TTS/舵机组合与离线分支",
      "modification": "与工厂不是互换固件；Moddable 与外部依赖需单审",
      "license": "自有 Apache-2.0，Moddable LGPL/GPL 等边界见 LICENSES.md",
      "evidence": "https://github.com/stack-chan/stack-chan/blob/373fad66cec9af4ee5c9a3643fc8832a4014c642/firmware/host/app/compose.ts#L128-L165",
      "version": {
        "repository": "stack-chan/stack-chan",
        "branch": "develop",
        "commit": "373fad66cec9af4ee5c9a3643fc8832a4014c642",
        "committed_at": "2026-10-25T00:24:34Z",
        "created_at": "2021-06-06T14:31:19Z"
      },
      "accessed_at": "2026-10-27",
      "verification": "源码/文件清单研究，未做完整构建或硬件验证"
    },
    {
      "asset": "社区结构 STEP/STL 与 KiCad",
      "category": "hardware",
      "paths": [
        "case/v1",
        "schematics/m5-pantilt"
      ],
      "repository_key": "community",
      "reusability": "比 K151 目录多可编辑结构和电路工程",
      "modification": "匹配具体板卡/舵机，重新生成制造文件并补 BOM",
      "license": "根 Apache-2.0 声明，第三方贡献/素材仍需检查",
      "evidence": "https://github.com/stack-chan/stack-chan/tree/373fad66cec9af4ee5c9a3643fc8832a4014c642/schematics/m5-pantilt",
      "version": {
        "repository": "stack-chan/stack-chan",
        "branch": "develop",
        "commit": "373fad66cec9af4ee5c9a3643fc8832a4014c642",
        "committed_at": "2026-10-25T00:24:34Z",
        "created_at": "2021-06-06T14:31:19Z"
      },
      "accessed_at": "2026-10-27",
      "verification": "源码/文件清单研究，未做完整构建或硬件验证"
    }
  ],
  "verification": {
    "status": "PASS",
    "date": "2026-10-27",
    "python": "3.13.9",
    "checks": [
      "25 App wire values equal firmware LAN accepted types",
      "Every explicit firmware dispatch value exists in App",
      "Reserved wire values remain rejected",
      "Header size and maximum payload match",
      "Wire field offset 6 width 8 agrees",
      "Wire field offset 14 width 4 agrees",
      "Wire field offset 18 width 2 agrees",
      "Both decoders reject envelope length mismatch",
      "Firmware validates target MAC for target-bearing frames",
      "Unknown App type is rejected",
      "Assertion detects a deliberately altered type set",
      "Self-hosted StackChan and OTA are distinct settings",
      "XiaoZhi developer and license credentials are separate requirements",
      "Factory patch routes manual activation to StackChan World",
      "K151 fixed tree has ten STL and no other product files"
    ],
    "count": 15,
    "scope": "Source consistency only; no upstream code executed, firmware build, device test, cloud call or model inference."
  },
  "report": "StackChan 表达终端 源码研究.md"
}
