一、产品概述

1.1 产品定位

JHCC（Automation System）是一款智能中控自动化平台，采用 FastAPI 后端 + Quasar/Vue.js 前端 架构，提供从设备接入、实体管理、自动化编排到 AI 对话、分布式集群、音视频处理的一体化解决方案。

JHCC 在AI 深度融合与国产化适配方面具有显著特色——平台内置大模型对话、MCP 协议支持、本地知识库、分布式推理等能力，将 AI 从“附加功能”升级为“核心引擎”。

1.2 产品目标

  • 全设备接入：覆盖涂鸦、小米米家、Zigbee、Matter、KNX、Modbus、BACnet 等 60+ 通信协议与智能家居生态
  • AI 原生架构：大模型对话、工具调用、记忆与任务规划、技能与工作流编排
  • 分布式集群：Hub + Leaf 架构，支持异构算力（GPU/NPU/CPU）分布式推理
  • 全栈自包含：后端 + 前端 + 边缘 Agent，一套代码全场景部署
  • 国产化适配：支持 RK3588、鲲鹏等 ARM 平台，全离线部署能力

二、AI 与智能能力

这是 JHCC 区别于传统智能家居平台的核心差异点。

2.1 AI 对话（MCP 客户端）

JHCC 内置 MCP（模型上下文协议）客户端，可连接 OpenClaw、Claude Desktop、Cursor 等 MCP Server：

  • 工具调用：系统实体、服务、自动化、场景、技能、工作流均注册为 AI 工具
  • 记忆：长期记忆库（Memories）持久化
  • 任务规划：/plan 规划 + /plan/execute 执行 + 执行审计
  • 确认机制：危险操作需 /confirm 确认
  • LLM 对话：支持 OpenAI 兼容 API，前端“聊天”页提供多会话、消息记录、导出、Token 统计

2.2 技能（Skill）与工作流（Workflow）

  • 技能：单个能力封装（llm_prompt / http_call / service_call），定义于 config/skills/*.yaml，自动注册为 AI 工具
  • 工作流：技能的编排组合，画布式串联多个技能节点，AI 通过 execute_workflow 调用
  • AI 可生成技能/工作流/自动化，创建操作需对话确认后落盘

2.3 知识库（Knowledge Base）

基于 ChromaDB 向量数据库的文档知识管理；支持文档导入、语义搜索、上下文检索，为 AI 对话提供领域知识。

2.4 分布式推理

将推理任务拆分为 DAG 子任务，分配到集群 Leaf 节点执行；支持异构算力（GPU/NPU/CPU），模型注册表管理；前端“分布式推理”页提交任务并查看节点分配。

2.5 MCP Server（对外提供）

JHCC 自身也可作为 MCP Server（JSON-RPC over SSE），将实体/状态/服务暴露给任意 MCP 客户端。

2.6 组件生成器

通过自然语言描述自动生成新集成组件（manifest.json + __init__.py + config_flow.py）。

三、语音与音视频

3.1 语音管道

  • 唤醒词（Vosk）：小爱小爱 / 你好小爱 等，可配置
  • 语音识别 STT：Vosk 实时识别（离线）或 faster-whisper 高精度识别
  • 语音活动检测 VAD：WebRTC VAD
  • TTS 语音合成：Aliyun（云端）、Edge（微软在线免费）、pyttsx3（本地离线）、ChatTTS（本地中文高质量）四种后端
  • 实时语音流：WebSocket /api/voice/ws 实时音频流交互

3.2 摄像头

  • Camera 组件：RTSP/ONVIF 接入 IP 摄像头，实时 HLS 视频流、快照抓取、PTZ 云台控制、预置位
  • Camera Analyzer 组件：YOLOv8 ONNX 实时目标检测（80 类 COCO）+ 人体姿态估计（17 关键点动作识别），支持单次/连续检测模式

3.3 媒体

  • 媒体浏览器：DLNA/UPnP 发现并浏览局域网媒体服务器
  • 投屏：DLNA/Chromecast 协议推送媒体到电视/音响
  • QQ 音乐：扫码登录、搜索、歌单/排行榜/推荐、歌词、在线播放

四、分布式集群与边缘 Agent

4.1 集群架构（Hub + Leaf）

  • Hub：JHCC 主节点，负责连接 Leaf、心跳检测、集群状态 API
  • Leaf：agent/ 程序（轻量级，可打包为 EXE 或安装为系统服务），部署在远程电脑
  • 连接：WebSocket /ws/agent，API Token 认证，断线自动重连

4.2 Leaf 能力

  • 系统监控：CPU/内存/磁盘/进程/网络，支持 GPU（NVIDIA/AMD）与 NPU（Apple ANE/Rockchip/Qualcomm）采集
  • 命令执行：远程执行命令（安全配置：allow_exec、allowed_commands 白名单）
  • 通知：Toast / 消息
  • 远程控制：关机、重启、锁定、休眠、唤醒、通知、执行、注销

五、应用场景与价值

场景 核心需求 JHCC 解决方案
全屋智能 多品牌设备统一管理 涂鸦+小米+Zigbee+Matter 等多协议接入
AI 语音控制 自然语言控制设备 完整语音管道 + LLM 对话
自动化编排 复杂场景自动化 YAML 规则引擎 + 节点链可视化编辑器
隐私保护 数据不上云 全本地部署，可选全离线运行
边缘计算 在 ARM 设备运行 支持树莓派、RK3588、鲲鹏等
AI 能力验证 大模型 IoT 应用研究 MCP + 工具调用 + 知识库 + 分布式推理

六、交付说明

本文档为 JHCC 智能中控平台 产品说明，涵盖系统概述、核心功能模块、AI 与智能能力、语音与音视频、分布式集群、系统管理、技术规格与竞品对比。适用于：

  • 产品选型与方案评估
  • 项目投标与技术方案
  • 研发团队了解平台能力
  • 用户部署与运维参考