{
  "access_date": "2026-10-27",
  "snapshot_utc": "2026-10-26T18:26:56Z",
  "scope": "语音底座，与StackChan共用时去重计算",
  "assets": [
    {
      "name": "启动与音频状态机",
      "repository": "78/xiaozhi-esp32",
      "commit": "c435f99a88066029ec2dbd2d758c8cc9d051565b",
      "path": "main/application.cc",
      "local_snapshot_path": "研究底稿（未随网页发布）",
      "symbol": "Application::Initialize / HandleStateChangedEvent",
      "line": 66,
      "license": "MIT（本仓库源码），第三方依赖另核",
      "reuse": "作为ESP32固件主流程起点",
      "boundary": "仍需板卡适配、掉线与打断硬件测试",
      "evidence": "https://github.com/78/xiaozhi-esp32/blob/c435f99a88066029ec2dbd2d758c8cc9d051565b/main/application.cc#L66",
      "evidence_level": "source_read",
      "access_date": "2026-10-27"
    },
    {
      "name": "合法状态转换",
      "repository": "78/xiaozhi-esp32",
      "commit": "c435f99a88066029ec2dbd2d758c8cc9d051565b",
      "path": "main/device_state_machine.cc",
      "local_snapshot_path": "研究底稿（未随网页发布）",
      "symbol": "DeviceStateMachine::IsValidTransition",
      "line": 35,
      "license": "MIT（本仓库源码），第三方依赖另核",
      "reuse": "沿用转换校验与事件监听",
      "boundary": "不是桌面动作安全状态机",
      "evidence": "https://github.com/78/xiaozhi-esp32/blob/c435f99a88066029ec2dbd2d758c8cc9d051565b/main/device_state_machine.cc#L35",
      "evidence_level": "source_read",
      "access_date": "2026-10-27"
    },
    {
      "name": "音频任务队列",
      "repository": "78/xiaozhi-esp32",
      "commit": "c435f99a88066029ec2dbd2d758c8cc9d051565b",
      "path": "main/audio/audio_service.h",
      "local_snapshot_path": "研究底稿（未随网页发布）",
      "symbol": "AudioService / OPUS_FRAME_DURATION_MS",
      "line": 40,
      "license": "MIT（本仓库源码），第三方依赖另核",
      "reuse": "保留队列与编解码流水线",
      "boundary": "ESP codec/SR许可与声学硬件条件另核",
      "evidence": "https://github.com/78/xiaozhi-esp32/blob/c435f99a88066029ec2dbd2d758c8cc9d051565b/main/audio/audio_service.h#L40",
      "evidence_level": "source_read",
      "access_date": "2026-10-27"
    },
    {
      "name": "AFE与唤醒",
      "repository": "78/xiaozhi-esp32",
      "commit": "c435f99a88066029ec2dbd2d758c8cc9d051565b",
      "path": "main/audio/engines/afe_audio_engine.cc",
      "local_snapshot_path": "研究底稿（未随网页发布）",
      "symbol": "AfeAudioEngine::Initialize",
      "line": 51,
      "license": "MIT（本仓库源码），第三方依赖另核",
      "reuse": "在Espressif板卡复用前处理配置",
      "boundary": "ESP-SR 2.4.7限Espressif产品，参考音频/唤醒词权利另核",
      "evidence": "https://github.com/78/xiaozhi-esp32/blob/c435f99a88066029ec2dbd2d758c8cc9d051565b/main/audio/engines/afe_audio_engine.cc#L51",
      "evidence_level": "source_read",
      "access_date": "2026-10-27"
    },
    {
      "name": "WebSocket协议",
      "repository": "78/xiaozhi-esp32",
      "commit": "c435f99a88066029ec2dbd2d758c8cc9d051565b",
      "path": "main/protocols/websocket_protocol.cc",
      "local_snapshot_path": "研究底稿（未随网页发布）",
      "symbol": "WebsocketProtocol::OpenAudioChannel / SendAudio",
      "line": 79,
      "license": "MIT（本仓库源码），第三方依赖另核",
      "reuse": "优先固定v1与自建服务互通",
      "boundary": "v2/v3不能推定与该Python服务完整兼容；帧长校验需审",
      "evidence": "https://github.com/78/xiaozhi-esp32/blob/c435f99a88066029ec2dbd2d758c8cc9d051565b/main/protocols/websocket_protocol.cc#L79",
      "evidence_level": "source_read",
      "access_date": "2026-10-27"
    },
    {
      "name": "MQTT UDP传输",
      "repository": "78/xiaozhi-esp32",
      "commit": "c435f99a88066029ec2dbd2d758c8cc9d051565b",
      "path": "main/protocols/mqtt_protocol.cc",
      "local_snapshot_path": "研究底稿（未随网页发布）",
      "symbol": "MqttProtocol::SendAudio",
      "line": 204,
      "license": "MIT（本仓库源码），第三方依赖另核",
      "reuse": "需要MQTT常连控制时选用",
      "boundary": "需额外网关；AES-CTR不等于完整性认证",
      "evidence": "https://github.com/78/xiaozhi-esp32/blob/c435f99a88066029ec2dbd2d758c8cc9d051565b/main/protocols/mqtt_protocol.cc#L204",
      "evidence_level": "source_read",
      "access_date": "2026-10-27"
    },
    {
      "name": "设备MCP工具",
      "repository": "78/xiaozhi-esp32",
      "commit": "c435f99a88066029ec2dbd2d758c8cc9d051565b",
      "path": "main/mcp_server.cc",
      "local_snapshot_path": "研究底稿（未随网页发布）",
      "symbol": "McpServer::DoToolCall",
      "line": 586,
      "license": "MIT（本仓库源码），第三方依赖另核",
      "reuse": "沿用参数声明与主任务执行，增加受限设备工具",
      "boundary": "user_only是枚举过滤，不是该函数的授权门",
      "evidence": "https://github.com/78/xiaozhi-esp32/blob/c435f99a88066029ec2dbd2d758c8cc9d051565b/main/mcp_server.cc#L586",
      "evidence_level": "source_read",
      "access_date": "2026-10-27"
    },
    {
      "name": "Provider工厂",
      "repository": "xinnan-tech/xiaozhi-esp32-server",
      "commit": "a377d89dcd58e6e18417a57e9357c0dd23657746",
      "path": "main/xiaozhi-server/core/utils/modules_initialize.py",
      "local_snapshot_path": "研究底稿（未随网页发布）",
      "symbol": "initialize_modules",
      "line": 9,
      "license": "MIT（本仓库源码），第三方依赖另核",
      "reuse": "裁剪到单一ASR/LLM/TTS组合",
      "boundary": "本地部署不等于离线，依赖和模型另行部署",
      "evidence": "https://github.com/xinnan-tech/xiaozhi-esp32-server/blob/a377d89dcd58e6e18417a57e9357c0dd23657746/main/xiaozhi-server/core/utils/modules_initialize.py#L9",
      "evidence_level": "source_read",
      "access_date": "2026-10-27"
    },
    {
      "name": "连接编排",
      "repository": "xinnan-tech/xiaozhi-esp32-server",
      "commit": "a377d89dcd58e6e18417a57e9357c0dd23657746",
      "path": "main/xiaozhi-server/core/connection.py",
      "local_snapshot_path": "研究底稿（未随网页发布）",
      "symbol": "ConnectionHandler.chat",
      "line": 1055,
      "license": "MIT（本仓库源码），第三方依赖另核",
      "reuse": "参考流式文本、工具和TTS队列衔接",
      "boundary": "需资源限制、取消与并发验证",
      "evidence": "https://github.com/xinnan-tech/xiaozhi-esp32-server/blob/a377d89dcd58e6e18417a57e9357c0dd23657746/main/xiaozhi-server/core/connection.py#L1055",
      "evidence_level": "source_read",
      "access_date": "2026-10-27"
    },
    {
      "name": "设备MCP执行适配",
      "repository": "xinnan-tech/xiaozhi-esp32-server",
      "commit": "a377d89dcd58e6e18417a57e9357c0dd23657746",
      "path": "main/xiaozhi-server/core/providers/tools/device_mcp/mcp_executor.py",
      "local_snapshot_path": "研究底稿（未随网页发布）",
      "symbol": "DeviceMCPExecutor.execute",
      "line": 18,
      "license": "MIT（本仓库源码），第三方依赖另核",
      "reuse": "把设备工具接入统一工具管理",
      "boundary": "执行白名单及设备权限需补齐",
      "evidence": "https://github.com/xinnan-tech/xiaozhi-esp32-server/blob/a377d89dcd58e6e18417a57e9357c0dd23657746/main/xiaozhi-server/core/providers/tools/device_mcp/mcp_executor.py#L18",
      "evidence_level": "source_read",
      "access_date": "2026-10-27"
    },
    {
      "name": "HMAC认证",
      "repository": "xinnan-tech/xiaozhi-esp32-server",
      "commit": "a377d89dcd58e6e18417a57e9357c0dd23657746",
      "path": "main/xiaozhi-server/core/auth.py",
      "local_snapshot_path": "研究底稿（未随网页发布）",
      "symbol": "AuthManager",
      "line": 13,
      "license": "MIT（本仓库源码），第三方依赖另核",
      "reuse": "可复用三元组协议和签名校验",
      "boundary": "已有7项离线函数检查，尚无密钥生命周期验证",
      "evidence": "https://github.com/xinnan-tech/xiaozhi-esp32-server/blob/a377d89dcd58e6e18417a57e9357c0dd23657746/main/xiaozhi-server/core/auth.py#L13",
      "evidence_level": "source_read_and_function_executed",
      "access_date": "2026-10-27"
    },
    {
      "name": "hello协商",
      "repository": "xinnan-tech/xiaozhi-esp32-server",
      "commit": "a377d89dcd58e6e18417a57e9357c0dd23657746",
      "path": "main/xiaozhi-server/core/handle/helloHandle.py",
      "local_snapshot_path": "研究底稿（未随网页发布）",
      "symbol": "handleHelloMessage",
      "line": 42,
      "license": "MIT（本仓库源码），第三方依赖另核",
      "reuse": "作为握手与MCP初始化契约",
      "boundary": "3项隔离函数检查，不是WebSocket端到端",
      "evidence": "https://github.com/xinnan-tech/xiaozhi-esp32-server/blob/a377d89dcd58e6e18417a57e9357c0dd23657746/main/xiaozhi-server/core/handle/helloHandle.py#L42",
      "evidence_level": "source_read_and_isolated_function_executed",
      "access_date": "2026-10-27"
    },
    {
      "name": "本地短摘要记忆",
      "repository": "xinnan-tech/xiaozhi-esp32-server",
      "commit": "a377d89dcd58e6e18417a57e9357c0dd23657746",
      "path": "main/xiaozhi-server/core/providers/memory/mem_local_short/mem_local_short.py",
      "local_snapshot_path": "研究底稿（未随网页发布）",
      "symbol": "MemoryProvider.save_memory",
      "line": 135,
      "license": "MIT（本仓库源码），第三方依赖另核",
      "reuse": "仅作为可替换摘要接口参考",
      "boundary": "默认总结LLM可外发数据；YAML持久化缺少本次可见的原子更新保护",
      "evidence": "https://github.com/xinnan-tech/xiaozhi-esp32-server/blob/a377d89dcd58e6e18417a57e9357c0dd23657746/main/xiaozhi-server/core/providers/memory/mem_local_short/mem_local_short.py#L135",
      "evidence_level": "source_read",
      "access_date": "2026-10-27"
    },
    {
      "name": "控制台授权路由",
      "repository": "xinnan-tech/xiaozhi-esp32-server",
      "commit": "a377d89dcd58e6e18417a57e9357c0dd23657746",
      "path": "main/manager-api/src/main/java/xiaozhi/modules/security/config/ShiroConfig.java",
      "local_snapshot_path": "研究底稿（未随网页发布）",
      "symbol": "ShiroConfig.shirFilter",
      "line": 54,
      "license": "MIT（本仓库源码），第三方依赖另核",
      "reuse": "按需参考设备管理权限入口",
      "boundary": "需逐资源授权检查；文件保留第三方版权头",
      "evidence": "https://github.com/xinnan-tech/xiaozhi-esp32-server/blob/a377d89dcd58e6e18417a57e9357c0dd23657746/main/manager-api/src/main/java/xiaozhi/modules/security/config/ShiroConfig.java#L54",
      "evidence_level": "source_read",
      "access_date": "2026-10-27"
    },
    {
      "name": "学习部署配置",
      "repository": "xinnan-tech/xiaozhi-esp32-server",
      "commit": "a377d89dcd58e6e18417a57e9357c0dd23657746",
      "path": "main/xiaozhi-server/docker-compose_all.yml",
      "local_snapshot_path": "研究底稿（未随网页发布）",
      "symbol": "services",
      "line": 4,
      "license": "MIT（本仓库源码），第三方依赖另核",
      "reuse": "只作隔离实验部署清单参考",
      "boundary": "默认凭据、unconfined、latest需改造，不能直接生产采用",
      "evidence": "https://github.com/xinnan-tech/xiaozhi-esp32-server/blob/a377d89dcd58e6e18417a57e9357c0dd23657746/main/xiaozhi-server/docker-compose_all.yml#L4",
      "evidence_level": "source_read",
      "access_date": "2026-10-27"
    }
  ]
}