EdgeHub 云平台

← 返回使用指南
平台地址：https://zhihongos.cn/edgehub
更新日期：2026-09-03

平台定位与核心概念
三类资产与包结构
VERSION.info 版本管理详解
发布前：素材准备（实测步骤）
发布流程（Skill / Agent / AI 模型）
审核与治理
我的发布：版本与状态管理
发布后详情页：概览 / 文件 / 版本
搜索、下载与 CLI 安装
可见性与权限策略
实测结果汇总
常见问题与排错

1. 平台定位与核心概念

EdgeHub 是面向 AIOS 的边缘 AI 资产注册中心，统一管理三类可分发资产：

资产类型	Hub 名称	入口包文件	典型用途
Skill（技能）	Skill Hub	`SKILL.md` + `VERSION.info`	指导 Agent 如何使用工具/流程
Agent（智能体）	Agent Hub	`AGENT.md` + `agent.json` + `VERSION.info`	可执行的子智能体定义
AI 模型	AI Model Hub	`README.md` + `VERSION.info`	边缘推理模型包（ONNX/RKNN 等）

平台完整生命周期：

本地打包 → Web 上传发布 → （可选）安全扫描 → 审核 → 已发布 → 搜索/下载/CLI 安装 → 版本迭代

首页 快速开始 提供三种接入方式（Agent / 人工 / CLI），CLI 安装说明指向 Registry 文档：

阅读 https://zhihongos.cn/edgehub/registry/skill.md，并设置相应的环境变量

2. 三类资产与包结构

2.1 Skill：`skill_set/build-agent-cli.zip`

原始包结构（缺少 VERSION.info，无法直接发布）：

build-agent-cli/
├── SKILL.md          # 技能入口（OpenSkills 风格 frontmatter）
├── checklist.md
└── principles.md

SKILL.md 头部元数据示例：

yaml

---
name: build-agent-cli
description: >-
  Design and implement Agent-friendly CLI tools following 22 proven principles...
---

功能说明：该 Skill 指导 Agent 设计「Agent 友好型 CLI」，包含 22 条原则（JSON stdout、dry-run、幂等、Schema 自省等），是 CLI 工具接入 AIOS 的编排层文档。

2.2 Agent：`agent_set/devops_enginer.zip`

devops_enginer/
├── AGENT.md              # 智能体角色与能力说明（Markdown）
├── agent.json            # 机器可读配置（版本、skills 列表、tools 等）
├── VERSION.info          # 【发布时必须】版本元数据
└── skills/               # 7 个子 Skill 目录
    ├── docker-diagnosis/SKILL.md
    ├── hilog_analyzer/SKILL.md
    └── ...

agent.json 关键字段：

json

{
  "name": "devops_enginer",
  "version": "1.1",
  "skills": ["Hilog Diagnosis", "hilog_analyzer", "Docker Diagnosis", ...],
  "tools": ["bash", "read_file", "grep", ...]
}

功能说明：端侧运维工程师智能体，覆盖 OpenHarmony Hilog、SA/Ability、网络、SELinux、Docker 等 7 类诊断 Skill。

2.3 AI 模型：`aimodel_set/people_count_yolov10-v1.zip`

people_count_yolov10-v1/
├── VERSION.info          # 模型包元信息（已包含）
├── README.md             # 模型说明（EdgeHub 必填）
├── generic/              # ONNX 通用推理
│   ├── manifest.json
│   └── yolov10n.ort
└── rk3588/               # RK3588 NPU 加速
    ├── manifest.json
    └── yolov10n_fp16.rknn

功能说明：基于 YOLOv10n 的 COCO 80 类目标检测模型，支持 generic（ORT）与 rk3588（RKNN）两种部署变体，适用于人数统计等边缘 AI 场景。

3. VERSION.info 版本管理详解

EdgeHub 三类资产均要求根目录包含 VERSION.info（JSON 格式）。平台用它完成：

版本号解析与冲突检测
命名空间归属
与 agent.json 等业务文件的交叉校验
详情页「版本」Tab 展示

3.1 字段说明

字段	必填	说明
`author`	推荐	发布者标识，如 `zhihongos`
`name`	是	资产 slug，与包内主文件名一致
`version`	是	语义化版本，如 `1.0.0`、`1.1`
`namespace`	是	通常 `global` 对应 `@global`
`create_date`	推荐	创建时间字符串
`description`	可选	简短描述
`algorithm`	模型专用	如 `yolov10`
`platform`	模型专用	如 `["generic", "rk3588"]`

3.2 实测可用的 VERSION.info 示例

Skill（build-agent-cli） — 发布成功版本：

json

{
  "author": "zhihongos",
  "name": "build-agent-cli",
  "create_date": "2026-07-08 10:16",
  "version": "1.0.0",
  "namespace": "global"
}

Agent（devops_enginer） — 注意 version 必须与 agent.json 中 "version": "1.1" 完全一致：

json

{
  "author": "zhihongos",
  "name": "devops_enginer",
  "create_date": "2026-07-10 15:22",
  "version": "1.1",
  "namespace": "global"
}

⚠️ 实测踩坑：若 VERSION.info 写 "version": "v1.1.0" 而 agent.json 为 "1.1"，会报错 error.version.info.version.mismatch。

AI 模型（people_count_yolov10） — 原包已包含：

json

{
  "author": "edgehub",
  "name": "people_count_yolov10",
  "create_date": "2026-08-04 13:55",
  "version": "v1.1",
  "namespace": "global",
  "algorithm": "yolov10",
  "platform": ["generic", "rk3588"]
}

3.3 版本号在界面中的映射

VERSION.info	详情页显示	CLI 安装参数
`"1.0.0"`	v1.0	`-v v1.0`
`"1.1"`	v1.1	`-v v1.1`
`"v1.1"`	v1.1	`-v v1.1`

平台坐标格式：{namespace}/{name}@{version}，例如 global/build-agent-cli@1.0.0。

4. 发布前：素材准备（实测步骤）

原始 skill_set 与 agent_set 的 ZIP 不含 VERSION.info，需先补全再上传。本项目已在 upload_set/ 生成就绪包：

就绪包	来源	说明
`upload_set/build-agent-cli-v1.0.0.zip`	skill_set	已注入 VERSION.info
`upload_set/devops_enginer-v1.1.zip`	agent_set	已注入 VERSION.info，version=1.1
`aimodel_set/people_count_yolov10-v1.zip`	原包	已含 VERSION.info + README.md

补全 VERSION.info 的 Python 逻辑见 scripts/edgehub_workflow_v2.py 中 build_zip() 函数。

5. 发布流程（Skill / Agent / AI 模型）

入口：导航栏 → 发布 → 选择 Tab（技能 / 智能体 / AI模型）

发布表单-技能

5.1 表单字段详解

字段	选项	说明
命名空间	`Global (@global)`	全局命名空间；团队包可选自定义 namespace
可见性	公开 / 仅登录用户可见 / 私有	见第 10 节
包文件	`.zip`	拖拽或点击选择，仅支持 ZIP

右侧说明面板：

发布审核说明：提交后需经管理员审核（管理员账号可能直接发布，见实测）
包格式说明：
- Skill：SKILL.md + VERSION.info
- Agent：AGENT.md + agent.json + VERSION.info
- Model：README.md + VERSION.info

5.2 实测：发布 Skill（build-agent-cli）

步骤：

发布 → 技能 Tab
命名空间：Global (@global)
可见性：选择私有（公开发布需启用安全扫描器，见排错节）
上传 upload_set/build-agent-cli-v1.0.0.zip
点击 发布技能
弹出 发布前风险提醒：Disallowed file extension: VERSION.info
点击 继续发布（平台要求包含 VERSION.info，但扫描器会警告 .info 后缀，可忽略继续）

风险提醒弹窗

发布成功提示：「global/build-agent-cli@1.0.0 已发布，现在可以下载使用」

Skill 发布成功详情页

发布后状态标签：global · 正常 · 私有

安装命令（详情页右侧）：

bash

edgeclaw skillhub install zhihongos/build-agent-cli -v v1.0

5.3 实测：发布 Agent（devops_enginer）

步骤：

发布 → 智能体 Tab
上传 upload_set/devops_enginer-v1.1.zip（VERSION.info 中 version 必须为 1.1）
可见性：私有
点击 发布智能体

Agent 发布成功-概览 Tab

发布后信息：

坐标：zhihongos/devops_enginer
版本：v1.1
状态：ACTIVE · 私有 · AGENT
概览 Tab 渲染 AGENT.md 全文（角色定位、7 项 Skill 能力表、触发场景路由表）
安装命令：

bash

edgeclaw agenthub install zhihongos/devops_enginer -v v1.1

5.4 实测：发布 AI 模型（people_count_yolov10）

步骤：

发布 → AI模型 Tab
上传 aimodel_set/people_count_yolov10-v1.zip（约 12 MB）
可见性：公开
点击 发布 AI 模型，按钮显示「发布中...」

模型发布中

发布后（我的发布 → AI模型）：

我的发布-模型列表

名称：people_count_yolov10
版本：v1.1
状态：已发布（绿色）
可见性：公开（@global）

安装命令：

bash

aiengie modelhub install edgehub/people_count_yolov10 -v v1.1

算法 / 平台：yolov10 · generic, rk3588

6. 审核与治理

6.1 审核中心

路径：个人中心 → 审核中心（/edgehub/dashboard/reviews）

审核中心-待审核

界面结构：

区域	功能
顶部 Tab	技能审核 / 资料审核
状态筛选	待审核 / 已通过 / 已拒绝
资产类型筛选	SKILL / AGENT / AI_MODEL
排序	最新优先

标准审核流程（普通发布者）：

上传 ZIP → 状态变为「待审核」→ 管理员打开审核详情
→ 检查包结构、VERSION.info、安全扫描结果
→ 点击「通过」或「拒绝（附原因）」→ 通过后公开可见

实测说明：使用 admin 账号发布时，Skill / Agent / Model 均直接变为已发布，审核中心「待审核」列表为空。这是管理员权限下的快速通道。教程中应区分：

普通用户：必须走审核中心
管理员：可即时发布，但仍可在「已通过」Tab 查看历史

治理中心

6.2 治理中心

路径：个人中心 → 治理中心

功能概览：

模块	说明
待审核 / 待提升审核 / 待处理举报	聚合计数
治理待办	按审核/提升/举报分类的任务列表
治理通知 / 治理活动	审计日志
搜索索引维护	超级管理员可「重建全部搜索索引」

公开发布前需在治理中心启用 安全扫描器（否则报错见排错节）。

7. 我的发布：版本与状态管理

路径：导航栏 → 我的发布

三类 Tab 独立管理：

我的发布-Agent 列表

Tab	实测资产	版本	状态
技能	build-agent-cli	v1.0	正常 / 私有
智能体	devops_enginer	v1.1	已发布 / 私有
AI模型	people_count_yolov10	v1.1	已发布 / 公开

列表页功能：

搜索：按名称、Slug、描述
命名空间筛选：全部命名空间
状态筛选：全部 / 已发布 / 已隐藏 / 已归档
操作：「更新」按钮 → 上传新版本 ZIP（VERSION.info 中 version 需递增）

点击卡片右侧 > 进入详情页（与公开发布详情相同结构）。

8. 发布后详情页：概览 / 文件 / 版本

每个已发布资产详情页包含三个 Tab，以 Skill build-agent-cli 为例：

8.1 概览 Tab

渲染 SKILL.md / AGENT.md / README.md 正文
显示来源标注（如「来源：SKILL.md」）
右侧：安装命令、版本、下载量、评分、收藏/订阅、下载/分享按钮

Skill 概览

8.2 文件 Tab

列出当前版本包内所有文件，可按版本号切换：

Skill 文件列表

build-agent-cli v1.0 文件清单（4 个文件，36.8 KB）：

文件	大小	作用
`SKILL.md`	9.1 KB	技能主文档
`checklist.md`	2.7 KB	设计检查清单
`principles.md`	24.8 KB	22 条 CLI 原则详解
`VERSION.info`	145 B	版本元数据

8.3 版本 Tab

展示版本历史、发布时间、文件数/大小，支持 对比版本 与 重新发布：

Skill 版本 Tab

Agent devops_enginer v1.1：

Agent 版本 Tab

10 个文件 · 35.5 KB
状态：已发布 · 当前版本
时间：2026-08-26 21:16

AI 模型 people_count_yolov10 v1.1：

Model 版本 Tab

8 个文件 · 15410 KB
含 generic/ 与 rk3588/ 两套推理文件

8.4 模型详情页（公开）

Model 概览

概览 Tab 渲染 README.md，包含：

目录结构（标注 VERSION.info 为「模型包元信息」）
generic / rk3588 部署变体对比表
manifest.json 参数说明（输入 640×640、80 类、confidence 0.25 等）
COCO 类别 ID 对照表

9. 搜索、下载与 CLI 安装

9.1 搜索页

Hub	路径	排序	筛选
技能	`/edgehub/skills`	相关性 / 下载量 / 最新	只看已收藏
智能体	`/edgehub/agents`	同上	同上
AI 模型	`/edgehub/models`	同上	同上

AI 模型搜索

实测：

people_count_yolov10（公开）可在 AI 模型搜索中找到
build-agent-cli、devops_enginer（私有）在公开搜索中不可见（符合权限设计）

9.2 下载

详情页右侧下载按钮 → 下载当前版本 ZIP 包。

9.3 CLI 安装命令汇总

资产	命令
Skill	`edgeclaw skillhub install zhihongos/build-agent-cli -v v1.0`
Agent	`edgeclaw agenthub install zhihongos/devops_enginer -v v1.1`
Model	`aiengie modelhub install edgehub/people_count_yolov10 -v v1.1`

配置 Registry：

bash

export CLAWHUB_REGISTRY=https://zhihongos.cn/edgehub
clawhub login --token <API_TOKEN>

API Token 创建路径：个人中心 → API 令牌

API 令牌

10. 可见性与权限策略

可见性	搜索可见	下载权限	安全扫描
公开	所有人	匿名可下载（@global）	必须启用安全扫描器
仅登录用户可见	登录用户	需登录	需扫描
私有	不可搜索	仅 owner/授权用户	可绕过部分扫描限制

实测策略：

Skill / Agent 使用私有发布成功
Model 使用公开发布成功（平台已有扫描器配置或模型包通过扫描）

若公开发布 Skill 报错：

「发布公开或命名空间可见技能前必须启用安全扫描器」

需管理员在 治理中心 启用安全扫描器后重试。

11. 实测结果汇总

素材	包名	版本	可见性	发布结果	详情页 URL
skill_set	build-agent-cli	1.0.0	私有	✅ 已发布	`/edgehub/space/global/build-agent-cli`
agent_set	devops_enginer	1.1	私有	✅ 已发布	`/edgehub/space/global/devops_enginer`
aimodel_set	people_count_yolov10	v1.1	公开	✅ 已发布	`/edgehub/space/global/people_count_yolov10`

完整工作流截图目录：docs//images/edgehub/workflow/

自动化脚本：

bash

# 补全 VERSION.info 并发布
python3 scripts/edgehub_workflow_v2.py

# 完成 Skill 发布并采集详情 Tab
python3 scripts/edgehub_skill_final.py

# 一键全流程（发布 + 审核尝试 + 预览）
python3 scripts/edgehub_full_workflow.py

12. 常见问题与排错

Q1：`error.version.info.version.mismatch`

原因：VERSION.info 的 version 与 agent.json（或平台解析规则）不一致。
解决：Agent 包中两处均写 "1.1"，不要一处写 v1.1.0 另一处写 1.1。

Q2：发布前风险提醒 `Disallowed file extension: VERSION.info`

原因：安全扫描器对 .info 后缀告警。
解决：点击 继续发布；该文件为平台强制要求，并非真正禁止。

Q3：公开发布失败「必须启用安全扫描器」

解决：治理中心启用扫描器，或改用「私有」可见性先完成发布验证。

Q4：私有资产搜索不到

预期行为。私有 Skill/Agent 仅 owner 通过「我的发布」或直链 URL 访问，不会出现在公开搜索。

Q5：原始 skill_set / agent_set 缺少 VERSION.info

解决：参考第 4 节，发布前注入 VERSION.info；模型包 aimodel_set 已自带。

Q6：更新版本

修改 VERSION.info 中 version（递增）
Agent 需同步修改 agent.json 的 version
我的发布 → 对应资产 → 更新 → 上传新 ZIP

附录 A：截图索引（workflow 目录）

截图	说明
`skill_final_upload.png`	Skill 发布表单（私有 + ZIP 已选）
`skill_04_after_submit.png`	VERSION.info 风险提醒弹窗
`skill_final_success.png`	Skill 发布成功 + 概览 Tab
`skill_pub_tab_文件.png`	Skill 文件清单（含 VERSION.info）
`skill_pub_tab_版本.png`	Skill 版本 Tab v1.0
`agent_result_待审核.png`	Agent 发布后概览
`agent_my_pub_tab_版本.png`	Agent 版本 Tab v1.1
`my_model_list.png`	模型我的发布列表
`my_model_detail.png`	模型详情概览（README 渲染）
`model_tab_version.png`	模型版本 Tab v1.1
`review_pending_before.png`	审核中心（管理员无待审）

附录 B：端到端 Checklist

[ ] 确认界面语言为中文
[ ] 为 Skill/Agent 包补全 VERSION.info（Agent 版本与 agent.json 一致）
[ ] 确认 Model 包含 README.md + VERSION.info
[ ] 选择命名空间与可见性
[ ] 上传 ZIP → 处理风险弹窗 → 确认发布成功 Toast
[ ] 在「我的发布」确认版本与状态
[ ] 打开详情页检查 概览 / 文件 / 版本 三个 Tab
[ ] 公开资产：在搜索页验证可发现性
[ ] 复制 CLI 安装命令并在边缘节点验证
[ ] （普通用户）在审核中心完成通过/拒绝操作

本文档所有截图均来自 中文界面 下的真实操作，非静态占位。

EdgeHub 云平台 ​

目录 ​

1. 平台定位与核心概念 ​

2. 三类资产与包结构 ​

2.1 Skill：skill_set/build-agent-cli.zip ​

2.2 Agent：agent_set/devops_enginer.zip ​

2.3 AI 模型：aimodel_set/people_count_yolov10-v1.zip ​

3. VERSION.info 版本管理详解 ​

3.1 字段说明 ​

3.2 实测可用的 VERSION.info 示例 ​

3.3 版本号在界面中的映射 ​

4. 发布前：素材准备（实测步骤） ​

5. 发布流程（Skill / Agent / AI 模型） ​

5.1 表单字段详解 ​

5.2 实测：发布 Skill（build-agent-cli） ​

5.3 实测：发布 Agent（devops_enginer） ​

5.4 实测：发布 AI 模型（people_count_yolov10） ​

6. 审核与治理 ​

6.1 审核中心 ​

6.2 治理中心 ​

7. 我的发布：版本与状态管理 ​

8. 发布后详情页：概览 / 文件 / 版本 ​

8.1 概览 Tab ​

8.2 文件 Tab ​

8.3 版本 Tab ​

8.4 模型详情页（公开） ​

9. 搜索、下载与 CLI 安装 ​

9.1 搜索页 ​

9.2 下载 ​

9.3 CLI 安装命令汇总 ​

10. 可见性与权限策略 ​

11. 实测结果汇总 ​

12. 常见问题与排错 ​

Q1：error.version.info.version.mismatch ​

Q2：发布前风险提醒 Disallowed file extension: VERSION.info ​

Q3：公开发布失败「必须启用安全扫描器」 ​

Q4：私有资产搜索不到 ​

Q5：原始 skill_set / agent_set 缺少 VERSION.info ​

Q6：更新版本 ​

附录 A：截图索引（workflow 目录） ​

附录 B：端到端 Checklist ​

EdgeHub 云平台

目录

1. 平台定位与核心概念

2. 三类资产与包结构

2.1 Skill：`skill_set/build-agent-cli.zip`

2.2 Agent：`agent_set/devops_enginer.zip`

2.3 AI 模型：`aimodel_set/people_count_yolov10-v1.zip`

3. VERSION.info 版本管理详解

3.1 字段说明

3.2 实测可用的 VERSION.info 示例

3.3 版本号在界面中的映射

4. 发布前：素材准备（实测步骤）

5. 发布流程（Skill / Agent / AI 模型）

5.1 表单字段详解

5.2 实测：发布 Skill（build-agent-cli）

5.3 实测：发布 Agent（devops_enginer）

5.4 实测：发布 AI 模型（people_count_yolov10）

6. 审核与治理

6.1 审核中心

6.2 治理中心

7. 我的发布：版本与状态管理

8. 发布后详情页：概览 / 文件 / 版本

8.1 概览 Tab

8.2 文件 Tab

8.3 版本 Tab

8.4 模型详情页（公开）

9. 搜索、下载与 CLI 安装

9.1 搜索页

9.2 下载

9.3 CLI 安装命令汇总

10. 可见性与权限策略

11. 实测结果汇总

12. 常见问题与排错

Q1：`error.version.info.version.mismatch`

Q2：发布前风险提醒 `Disallowed file extension: VERSION.info`

Q3：公开发布失败「必须启用安全扫描器」

Q4：私有资产搜索不到

Q5：原始 skill_set / agent_set 缺少 VERSION.info

Q6：更新版本

附录 A：截图索引（workflow 目录）

附录 B：端到端 Checklist