商家控制台
概述
ORBEXA 商家控制台是管理 AI 商务全链路的中枢。在统一界面中，商家可以监控核心经营指标、管理商品目录、配置平台集成、追踪数据质量，并控制协议端点。控制台采用渐进式引导设计：新商家进入后会看到分步设置向导，而已完成配置的用户则可直接使用高级功能。控制台首页
登录后，商家首先看到的是首页概览视图，核心指标一目了然。KPI 指标卡片
页面顶部展示四张核心指标卡片：订单趋势图
七日订单趋势图以折线形式展示每日订单量，帮助商家快速识别波峰、波谷或季节性规律，无需跳转到完整的订单管理页面。平台分布图
环形图展示各来源平台的商品占比。对于连接了多个店铺的商家，可以立即看到哪个平台贡献了最多库存。快捷操作
四个快捷按钮提供一键直达常用功能：- 连接平台 — 启动平台集成向导，接入新的电商平台
- 导入商品 — 上传 CSV 文件或手动触发同步
- 数据清洗 — 进入数据质量精炼台，进行人工审核
- 域名配置 — 前往自定义域名设置
设置进度
新商家会看到四步引导进度条，指引完成初始配置：- 创建账户 — 注册并完成邮箱验证
- 连接店铺 — 至少接入一个电商平台
- 配置域名 — 为协议端点设置自定义域名
- 验证协议 — 确认 UCP、ACP 和 MCP 端点可正常访问
协议端点状态
三个状态指示器实时展示协议端点的健康状况：- UCP — 统一商务协议，负责发现服务和商品数据源
- ACP — 智能代理商务协议，提供 JSON-RPC 和 REST 端点
- MCP — 模型上下文协议，工具服务器
近期活动时间线
按时间顺序展示账户中的最新事件，包括：- 同步完成与同步失败
- 新订单通知
- 集成状态变更
- 域名验证进展
- 团队成员操作
商品管理
商品管理提供功能完整的目录管理界面。搜索与筛选
- 文字搜索 — 支持在商品标题、描述和 SKU 中进行全文检索
- 筛选器 — 按来源平台、分类、价格区间、库存状态和数据质量等级筛选
- 分页 — 支持可配置的每页条目数（25、50、100 条）
批量操作
选中多个商品后可执行批量操作：商品导入
支持两种导入方式：- CSV 上传 — 上传包含标题、描述、价格、币种、库存、图片地址和分类等列的 CSV 文件，系统逐行校验后导入
- 手动创建 — 通过表单逐条添加商品，支持所有标准字段
订单管理
订单管理提供协议端点上所有订单流转的全局视图。搜索与筛选
- 订单号搜索 — 通过唯一标识定位特定订单
- 客户搜索 — 按客户姓名或邮箱查找订单
- 状态筛选 — 按待处理、已确认、已发货、已送达、已取消或已退款进行过滤
订单操作
- 取消 — 取消尚未发货的订单（会向来源平台发送取消事件）
- 退款 — 发起全额或部分退款，可附加原因代码
- 导出 — 将订单数据导出为 CSV，用于财务或报表
平台集成
平台集成管理与外部电商平台的连接。支持的平台
连接管理
每张集成卡片展示以下信息：- 连接状态 — 已连接、已断开或出错
- 最近同步时间 — 上次成功同步的时间
- 商品数量 — 从该来源导入的商品总数
- 手动同步按钮 — 在计划同步周期之外强制执行一次立即同步
同步日志
每个集成维护详细的同步日志，每条记录包含：- 同步尝试的时间戳
- 新增、更新和删除的商品数量
- 遇到的错误及对应商品标识
- 同步操作的持续时间
数据质量
ORBEXA 持续评估商品数据的完整性与准确性。总体质量评分
一个百分比综合分数概括目录的健康状况。该分数由字段级完整度、格式有效性和跨字段一致性校验综合计算。字段级分析
分项表格展示每个商品字段的完整度：质量等级
商品按五级评分体系分级：精炼台
精炼台是一个人机协作的审核界面，用于处理无法自动修复的数据质量问题。以下情况会进入人工审核队列：- 自动清洗结果置信度较低
- 多数据源之间字段值冲突
- 分类映射存在歧义
异常检测
系统自动标记需要关注的异常模式：- 价格异常 — 商品价格显著偏离历史均值或同类商品水平
- 字段缺失 — 同步后字段完整度突然下降（可能是平台配置变更导致）
- 重复商品 — 不同来源的商品共享相同标题、SKU 或图片地址
同步管理
精细控制数据在平台与 ORBEXA 之间的同步方式和频率。同步周期
为每个集成单独配置自动同步频率：同步模式
- 增量同步 — 仅获取自上次同步以来发生变更的商品（速度更快，资源消耗更低）
- 全量同步 — 重新获取完整目录（适用于配置变更后或数据漂移时）
同步历史
分页展示所有同步操作的记录，包含以下列：- 开始和结束时间
- 同步模式（增量或全量）
- 新增、更新、删除和出错的商品数量
- 整体状态（成功、部分完成或失败）
转发日志
对于启用了订单转发的集成，独立的日志记录每个订单向来源平台回传的情况，包括 HTTP 状态码和响应详情。域名管理
自定义域名功能允许商家从自有品牌域名提供协议端点服务。添加域名
- 输入要使用的域名（如
commerce.yourbrand.com） - 系统生成一条 CNAME 记录值
- 在域名服务商处添加该 CNAME 记录
- 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 密钥，可设置标签和过期时间
- 吊销 — 立即作废现有密钥（不可恢复）
- 复制 — 将密钥复制到剪贴板，用于外部集成
Webhook 配置
注册 Webhook 端点以接收以下事件的实时通知：- 新订单创建
- 同步完成与失败
- 数据质量告警
- 域名验证状态变更
安全设置
- 双因素认证 (2FA) — 启用基于 TOTP 的双因素认证，增强登录安全性
- 密码管理 — 在验证当前密码后修改账户密码
- 活跃会话 — 查看并吊销各设备上的登录会话
通知系统
通知系统让商家无需时刻守在控制台，也能及时了解重要事件。通知类别
通知按以下类别组织：已读/未读追踪
每条通知都有已读/未读状态。未读通知会在导航栏显示角标计数，提供持续的视觉提醒。 通知支持逐条或批量标记为已读，也可按类别筛选以便集中处理。关于控制台相关 API 端点的详细说明，请参阅第8章：API 参考与速率限制。
下一章：故障排查指南 — 常见错误、Webhook调试、同步失败和域名验证