Appearance
使用指南总览
更新日期：2026-09-03 适用平台：OpenHarmony 标准系统（RK3588） 云平台主站：
https://zhihongos.cn· EdgeIOThttps://zhihongos.cn/iot· EdgeHubhttps://zhihongos.cn/edgehub· 小米云https://zhihongos.cn/mi_cloud
1. 生态全景
| 服务 | CLI | 框架 |
|---|---|---|
| EdgeComputer | edgecomputer | EdgeComputer 框架 |
| EdgeMCP | edgemcp | EdgeMCP 框架 |
| EdgeClaw | edgeclaw | EdgeClaw 框架 |
| Edge Engine | edgeengine | Edge Engine 框架 |
| EdgePipe | edgepipe | Edge Pipe 框架 |
2. 推荐学习顺序（三阶段课程）
阶段一：IoT 基础链
| 时段 | 内容 | 手册章节 |
|---|---|---|
| 上午 | EdgeComputer 连云、插件、子设备 | EdgeComputer 第三～七章 |
| 下午 | EdgeMCP 五大工具、分层排障 | EdgeMCP 第三～七章 |
阶段二：智能体编排
| 时段 | 内容 | 手册章节 |
|---|---|---|
| 上午 | EdgeClaw 对话、MCP 控设备 | EdgeClaw 第三、四章 |
| 下午 | EdgeHub 安装、联邦 invoke | EdgeClaw 第五、十一章 |
阶段三：端侧 AI
| 时段 | 内容 | 手册章节 |
|---|---|---|
| 上午 | Edge Engine 模型安装与推理 | Edge Engine 第三～六章 |
| 下午 | EdgePipe YAML 流水线 | Edge Pipe 第三～九章 |
3. 服务启动顺序
bash
# IoT + 智能体链（板端）
service_control start edgecomputer_service
service_control start edgemcp
service_control start edgeclaw_service
# 视觉 AI 链（板端，独立）
service_control start ai_engine_service
service_control start edge_cpipe_service4. 平台对接速查
4.1 EdgeIOT（物联网云）
完整教程：EdgeIOT 物联网云平台
| 步骤 | 操作 | 截图 |
|---|---|---|
| 1 | 登录 EdgeIOT https://zhihongos.cn/iot | 登录页 |
| 2 | 配置网络组件与设备接入网关 | 设备接入网关 |
| 3 | 创建产品、定义物模型 | 产品管理 |
| 4 | 创建设备实例 | 设备列表 |
| 5 | 板端 edgecomputer cloud/gateway/child set + config apply | EdgeComputer 第八章 |
4.2 EdgeHub（Skill/Agent/模型）
完整教程：EdgeHub 云平台
| 步骤 | 操作 | 截图 |
|---|---|---|
| 1 | 浏览 EdgeHub 首页 https://zhihongos.cn/edgehub | 首页 |
| 2 | 发布或搜索 Skill | 技能搜索 |
| 3 | 发布或搜索 Agent | 智能体搜索 |
| 4 | 板端 edgeclaw skillhub/agenthub install | EdgeClaw 第 6 章 |
| 5 | 板端 edgeengine modelhub install | Edge Engine 第四章 |
4.3 小米云 Token 工具
完整教程：小米云 Token 提取工具
| 步骤 | 操作 | 截图 |
|---|---|---|
| 1 | 访问 https://zhihongos.cn/mi_cloud | 首页 |
| 2 | 二维码或账号密码登录 | 二维码登录 |
| 3 | 选择区域并获取设备列表 | 获取设备列表 |
| 4 | 复制 IP 与 Token 到 Home Assistant / EdgeIOT | mi-cloud 教程第 6 节 |
5. 一键验证脚本
bash
# 【宿主机】培训环境自检（需 hdc 连接板子）
bash foundation/ai/docs/scripts/training_env_verify.sh
# 培训结业测验（20 题，≥80% 通过）
bash foundation/ai/docs/scripts/training_quiz.sh
# 联邦双板 E2E（需两块板）
bash foundation/ai/edgeclaw/docs/scripts/federation_post_reboot_ready.sh
bash foundation/ai/edgeclaw/docs/scripts/federation_e2e_quick.sh
# 重新生成平台截图
python3 foundation/ai/docs/scripts/capture_platform_screenshots.py6. 各手册章节地图
EdgeClaw（十三节）
| 节 | 主题 | 难度 |
|---|---|---|
| 一～二 | 开始之前、连接开发板 | ★☆☆ |
| 三～四 | 快速开始、对话控设备 | ★★☆ |
| 五 | EdgeHub 扩展 Skill/Agent | ★★☆ |
| 六～八 | 原理、功能一览、JetLinks 端云 | ★★☆ |
| 九～十 | 命令手册、Skill/子 Agent 深入 | ★★☆ |
| 十一 | 联邦群体智能 | ★★★ |
| 十二～十三 | 常见问题、附录 | ★★☆ |
EdgeComputer（十一节）
| 节 | 主题 | 难度 |
|---|---|---|
| 一～二 | 开始之前、连接开发板 | ★☆☆ |
| 三～四 | 快速连云、加载插件 | ★★☆ |
| 五～七 | 端云原理、功能一览、JetLinks 配置 | ★★☆ |
| 八 | 命令手册 | ★★☆ |
| 九 | 插件开发 | ★★★ |
| 十～十一 | 常见问题、附录 | ★★☆ |
EdgeMCP（十一节）
| 节 | 主题 | 难度 |
|---|---|---|
| 一～二 | 开始之前、连接开发板 | ★☆☆ |
| 三～四 | 快速跑通、查看状态与数据 | ★★☆ |
| 五～六 | 逻辑原理、功能一览 | ★★☆ |
| 七 | EdgeClaw 联调 | ★★☆ |
| 八～九 | 命令手册、MCP 协议 | ★★☆ |
| 十～十一 | 常见问题、附录 | ★★☆ |
Edge Engine（十节）
| 节 | 主题 | 难度 |
|---|---|---|
| 一～二 | 开始之前、连接开发板 | ★☆☆ |
| 三～四 | 快速开始、EdgeHub 安装模型 | ★★☆ |
| 五～六 | 工作原理、功能一览 | ★★☆ |
| 七 | 命令手册 | ★★☆ |
| 八 | 进阶专题 | ★★★ |
| 九～十 | 常见问题、附录 | ★★☆ |
Edge Pipe（十二节）
| 节 | 主题 | 难度 |
|---|---|---|
| 一～二 | 开始之前、连接开发板 | ★☆☆ |
| 三～四 | 快速开始、模型安装联调 | ★★☆ |
| 五～六 | 工作原理、功能一览 | ★★☆ |
| 七 | 编写流水线 YAML | ★★☆ |
| 八 | 命令手册 | ★★☆ |
| 九 | 手把手实验 | ★★☆ |
| 十 | 进阶专题 | ★★★ |
| 十一～十二 | 常见问题、附录 | ★★☆ |
7. 文档结构
| 类型 | 文档 | 说明 |
|---|---|---|
| 总览 | 使用指南总览 | 生态全景、学习路线、平台速查（本文） |
| 框架 | EdgeComputer 框架 | IoT 网关 |
| 框架 | EdgeMCP 框架 | MCP 设备控制 |
| 框架 | EdgeClaw 框架 | 边缘智能体 |
| 框架 | Edge Engine 框架 | 端侧推理 |
| 框架 | Edge Pipe 框架 | 视觉流水线 |
| 云平台 | EdgeIOT 物联网平台 | 设备接入、物模型、规则引擎 |
| 云平台 | EdgeHub 资产中心 | Skill / Agent / AI 模型发布 |
| 云平台 | 小米云 Token 工具 | 米家设备 Token 提取 |
| 资源 | docs/public/images/ | 云平台操作截图 |
建议从本文开始，按阶段一 → 阶段三 顺序学习。