​

商家控制台

​

概述

ORBEXA 商家控制台是管理 AI 商务全链路的中枢。在统一界面中，商家可以监控核心经营指标、管理商品目录、配置平台集成、追踪数据质量，并控制协议端点。控制台采用渐进式引导设计：新商家进入后会看到分步设置向导，而已完成配置的用户则可直接使用高级功能。

​

控制台首页

登录后，商家首先看到的是首页概览视图，核心指标一目了然。

​

KPI 指标卡片

页面顶部展示四张核心指标卡片：

​

订单趋势图

七日订单趋势图以折线形式展示每日订单量，帮助商家快速识别波峰、波谷或季节性规律，无需跳转到完整的订单管理页面。

​

平台分布图

环形图展示各来源平台的商品占比。对于连接了多个店铺的商家，可以立即看到哪个平台贡献了最多库存。

​

快捷操作

四个快捷按钮提供一键直达常用功能：

• 连接平台 — 启动平台集成向导，接入新的电商平台
• 导入商品 — 上传 CSV 文件或手动触发同步
• 数据清洗 — 进入数据质量精炼台，进行人工审核
• 域名配置 — 前往自定义域名设置

​

设置进度

新商家会看到四步引导进度条，指引完成初始配置：

1. 创建账户 — 注册并完成邮箱验证
2. 连接店铺 — 至少接入一个电商平台
3. 配置域名 — 为协议端点设置自定义域名
4. 验证协议 — 确认 UCP、ACP 和 MCP 端点可正常访问

四步全部完成后，进度条自动收起，替换为标准控制台视图。

​

协议端点状态

三个状态指示器实时展示协议端点的健康状况：

• UCP — 统一商务协议，负责发现服务和商品数据源
• ACP — 智能代理商务协议，提供 JSON-RPC 和 REST 端点
• MCP — 模型上下文协议，工具服务器

每个指示器显示三种状态之一：在线（绿色）、降级（黄色）或离线（红色）。点击指示器可跳转到对应的配置页面。

​

近期活动时间线

按时间顺序展示账户中的最新事件，包括：

• 同步完成与同步失败
• 新订单通知
• 集成状态变更
• 域名验证进展
• 团队成员操作

​

商品管理

商品管理提供功能完整的目录管理界面。

​

搜索与筛选

• 文字搜索 — 支持在商品标题、描述和 SKU 中进行全文检索
• 筛选器 — 按来源平台、分类、价格区间、库存状态和数据质量等级筛选
• 分页 — 支持可配置的每页条目数（25、50、100 条）

​

批量操作

选中多个商品后可执行批量操作：

​

商品导入

支持两种导入方式：

• CSV 上传 — 上传包含标题、描述、价格、币种、库存、图片地址和分类等列的 CSV 文件，系统逐行校验后导入
• 手动创建 — 通过表单逐条添加商品，支持所有标准字段

​

订单管理

订单管理提供协议端点上所有订单流转的全局视图。

​

搜索与筛选

• 订单号搜索 — 通过唯一标识定位特定订单
• 客户搜索 — 按客户姓名或邮箱查找订单
• 状态筛选 — 按待处理、已确认、已发货、已送达、已取消或已退款进行过滤

​

订单操作

• 取消 — 取消尚未发货的订单（会向来源平台发送取消事件）
• 退款 — 发起全额或部分退款，可附加原因代码
• 导出 — 将订单数据导出为 CSV，用于财务或报表

​

平台集成

平台集成管理与外部电商平台的连接。

​

支持的平台

​

连接管理

每张集成卡片展示以下信息：

• 连接状态 — 已连接、已断开或出错
• 最近同步时间 — 上次成功同步的时间
• 商品数量 — 从该来源导入的商品总数
• 手动同步按钮 — 在计划同步周期之外强制执行一次立即同步

​

同步日志

每个集成维护详细的同步日志，每条记录包含：

• 同步尝试的时间戳
• 新增、更新和删除的商品数量
• 遇到的错误及对应商品标识
• 同步操作的持续时间

​

数据质量

ORBEXA 持续评估商品数据的完整性与准确性。

​

总体质量评分

一个百分比综合分数概括目录的健康状况。该分数由字段级完整度、格式有效性和跨字段一致性校验综合计算。

​

字段级分析

分项表格展示每个商品字段的完整度：

​

质量等级

商品按五级评分体系分级：

​

精炼台

精炼台是一个人机协作的审核界面，用于处理无法自动修复的数据质量问题。以下情况会进入人工审核队列：

• 自动清洗结果置信度较低
• 多数据源之间字段值冲突
• 分类映射存在歧义

审核人员可以对每条建议执行通过、编辑或驳回操作。

​

异常检测

系统自动标记需要关注的异常模式：

• 价格异常 — 商品价格显著偏离历史均值或同类商品水平
• 字段缺失 — 同步后字段完整度突然下降（可能是平台配置变更导致）
• 重复商品 — 不同来源的商品共享相同标题、SKU 或图片地址

​

同步管理

精细控制数据在平台与 ORBEXA 之间的同步方式和频率。

​

同步周期

为每个集成单独配置自动同步频率：

​

同步模式

• 增量同步 — 仅获取自上次同步以来发生变更的商品（速度更快，资源消耗更低）
• 全量同步 — 重新获取完整目录（适用于配置变更后或数据漂移时）

​

同步历史

分页展示所有同步操作的记录，包含以下列：

• 开始和结束时间
• 同步模式（增量或全量）
• 新增、更新、删除和出错的商品数量
• 整体状态（成功、部分完成或失败）

​

转发日志

对于启用了订单转发的集成，独立的日志记录每个订单向来源平台回传的情况，包括 HTTP 状态码和响应详情。

​

域名管理

自定义域名功能允许商家从自有品牌域名提供协议端点服务。

​

添加域名

1. 输入要使用的域名（如 commerce.yourbrand.com）
2. 系统生成一条 CNAME 记录值
3. 在域名服务商处添加该 CNAME 记录
4. ORBEXA 定期检测 DNS 解析传播情况

​

DNS 验证状态

​

域名服务商操作指引

针对主流域名服务商提供分步指引：

• Cloudflare — 进入 DNS 设置，添加 CNAME 记录并关闭代理（选择仅 DNS 模式）
• GoDaddy — 进入 DNS 管理面板，添加 CNAME 并填入目标值
• Namecheap — 使用”高级 DNS”选项卡创建 CNAME 记录
• AWS Route 53 — 在对应托管区域中创建类型为 CNAME 的新记录集

​

团队与权限

支持多人协作，同时保持合理的访问控制。

​

邀请成员

通过邮箱邀请团队成员加入。每份邀请都需指定角色，决定新成员的访问范围。

​

角色定义

​

细粒度权限

在角色之外，还可按功能模块精细调整权限：

• 商品 — 创建、编辑、删除、导入商品
• 订单 — 查看、取消、退款
• 集成 — 连接、断开、配置平台集成
• 设置 — 修改账户设置、API 密钥和 Webhook
• 报表 — 访问数据质量报告和分析面板

​

系统设置

系统设置包含账户级别的全局配置项。

​

账户信息

• 显示名称 — 在协议响应中展示的商家名称
• 邮箱 — 接收通知的主联系邮箱
• 时区 — 用于同步调度和时间戳显示
• 默认币种 — 未明确指定币种的商品所使用的默认货币

​

协议端点配置

配置三个协议端点的基础地址和行为：

• UCP 端点 — 发现文档地址和商品数据源设置
• ACP 端点 — JSON-RPC 和 REST 端点配置
• MCP 端点 — 工具服务器地址和能力声明

​

API 密钥管理

• 生成 — 创建新的 API 密钥，可设置标签和过期时间
• 吊销 — 立即作废现有密钥（不可恢复）
• 复制 — 将密钥复制到剪贴板，用于外部集成

已生效的 API 密钥会显示创建日期、最近使用日期和标签。已吊销的密钥保留在历史记录中以供审计。

​

Webhook 配置

注册 Webhook 端点以接收以下事件的实时通知：

• 新订单创建
• 同步完成与失败
• 数据质量告警
• 域名验证状态变更

每个 Webhook 可配置密钥，用于 HMAC 签名验证，确保接收端能够确认请求的真实性。

​

安全设置

• 双因素认证 (2FA) — 启用基于 TOTP 的双因素认证，增强登录安全性
• 密码管理 — 在验证当前密码后修改账户密码
• 活跃会话 — 查看并吊销各设备上的登录会话

​

通知系统

通知系统让商家无需时刻守在控制台，也能及时了解重要事件。

​

通知类别

通知按以下类别组织：

​

已读/未读追踪

每条通知都有已读/未读状态。未读通知会在导航栏显示角标计数，提供持续的视觉提醒。 通知支持逐条或批量标记为已读，也可按类别筛选以便集中处理。

---

---

下一章：故障排查指南 — 常见错误、Webhook调试、同步失败和域名验证