> ## Documentation Index > Fetch the complete documentation index at: https://learn.orbexa.io/llms.txt > Use this file to discover all available pages before exploring further. # ORBEXA商家控制台功能指南 > ORBEXA商家控制台全部功能的完整使用指南：详解首页KPI指标监控面板与订单趋势图表、商品目录浏览管理、多平台集成连接配置、数据质量评分实时监控与同步日志追踪排查功能，涵盖团队成员权限管理与API密钥安全设置，采用渐进式引导设计助力新商家快速上手日常操作流程 # 商家控制台 ## 概述 ORBEXA 商家控制台是管理 AI 商务全链路的中枢。在统一界面中，商家可以监控核心经营指标、管理商品目录、配置平台集成、追踪数据质量，并控制协议端点。控制台采用渐进式引导设计：新商家进入后会看到分步设置向导，而已完成配置的用户则可直接使用高级功能。 ## 控制台首页 登录后，商家首先看到的是首页概览视图，核心指标一目了然。 ### KPI 指标卡片 页面顶部展示四张核心指标卡片： | 卡片 | 说明 | | ---------- | ------------------- | | **商品总数** | 所有已连接平台中当前索引的商品总量 | | **活跃集成** | 处于正常运行状态的平台连接数量 | | **本月订单** | 当前自然月的订单总量 | | **数据质量评分** | 综合反映商品数据完整性与准确性的百分比 | ### 订单趋势图 七日订单趋势图以折线形式展示每日订单量，帮助商家快速识别波峰、波谷或季节性规律，无需跳转到完整的订单管理页面。 ### 平台分布图 环形图展示各来源平台的商品占比。对于连接了多个店铺的商家，可以立即看到哪个平台贡献了最多库存。 ### 快捷操作 四个快捷按钮提供一键直达常用功能： * **连接平台** -- 启动平台集成向导，接入新的电商平台 * **导入商品** -- 上传 CSV 文件或手动触发同步 * **数据清洗** -- 进入数据质量精炼台，进行人工审核 * **域名配置** -- 前往自定义域名设置 ### 设置进度 新商家会看到四步引导进度条，指引完成初始配置： 1. **创建账户** -- 注册并完成邮箱验证 2. **连接店铺** -- 至少接入一个电商平台 3. **配置域名** -- 为协议端点设置自定义域名 4. **验证协议** -- 确认 UCP、ACP 和 MCP 端点可正常访问 四步全部完成后，进度条自动收起，替换为标准控制台视图。 ### 协议端点状态 三个状态指示器实时展示协议端点的健康状况： * **UCP** -- 统一商务协议，负责发现服务和商品数据源 * **ACP** -- 智能代理商务协议，提供 JSON-RPC 和 REST 端点 * **MCP** -- 模型上下文协议，工具服务器 每个指示器显示三种状态之一：**在线**（绿色）、**降级**（黄色）或**离线**（红色）。点击指示器可跳转到对应的配置页面。 ### 近期活动时间线 按时间顺序展示账户中的最新事件，包括： * 同步完成与同步失败 * 新订单通知 * 集成状态变更 * 域名验证进展 * 团队成员操作 ## 商品管理 商品管理提供功能完整的目录管理界面。 ### 搜索与筛选 * **文字搜索** -- 支持在商品标题、描述和 SKU 中进行全文检索 * **筛选器** -- 按来源平台、分类、价格区间、库存状态和数据质量等级筛选 * **分页** -- 支持可配置的每页条目数（25、50、100 条） ### 批量操作 选中多个商品后可执行批量操作： | 操作 | 说明 | | -------- | ------------------ | | **批量调价** | 对选中商品按固定金额或百分比调整价格 | | **库存更新** | 批量设置选中商品的库存数量 | | **分类调整** | 将选中商品移至其他分类 | | **批量删除** | 从索引中移除选中商品（需二次确认） | ### 商品导入 支持两种导入方式： * **CSV 上传** -- 上传包含标题、描述、价格、币种、库存、图片地址和分类等列的 CSV 文件，系统逐行校验后导入 * **手动创建** -- 通过表单逐条添加商品，支持所有标准字段 ## 订单管理 订单管理提供协议端点上所有订单流转的全局视图。 ### 搜索与筛选 * **订单号搜索** -- 通过唯一标识定位特定订单 * **客户搜索** -- 按客户姓名或邮箱查找订单 * **状态筛选** -- 按待处理、已确认、已发货、已送达、已取消或已退款进行过滤 ### 订单操作 * **取消** -- 取消尚未发货的订单（会向来源平台发送取消事件） * **退款** -- 发起全额或部分退款，可附加原因代码 * **导出** -- 将订单数据导出为 CSV，用于财务或报表 ## 平台集成 平台集成管理与外部电商平台的连接。 ### 支持的平台 | 平台 | 连接方式 | 核心功能 | | --------------- | ----------- | --------------------- | | **Shopify** | OAuth 2.0 | 自动商品同步、订单转发、库存追踪 | | **WooCommerce** | REST API 密钥 | 双向同步、基于 Webhook 的实时更新 | | **CSV** | 文件上传 | 一次性或定期从结构化文件导入 | | **API** | REST 直连 | 程序化管理商品和订单 | | **手动** | 控制台表单 | 适用于没有电商平台的商家，手动录入商品 | ### 连接管理 每张集成卡片展示以下信息： * **连接状态** -- 已连接、已断开或出错 * **最近同步时间** -- 上次成功同步的时间 * **商品数量** -- 从该来源导入的商品总数 * **手动同步按钮** -- 在计划同步周期之外强制执行一次立即同步 ### 同步日志 每个集成维护详细的同步日志，每条记录包含： * 同步尝试的时间戳 * 新增、更新和删除的商品数量 * 遇到的错误及对应商品标识 * 同步操作的持续时间 ## 数据质量 ORBEXA 持续评估商品数据的完整性与准确性。 ### 总体质量评分 一个百分比综合分数概括目录的健康状况。该分数由字段级完整度、格式有效性和跨字段一致性校验综合计算。 ### 字段级分析 分项表格展示每个商品字段的完整度： | 字段 | 完整度 | 影响级别 | | -- | ---- | ------------------------ | | 标题 | 100% | 关键 -- 所有协议响应的必填字段 | | 描述 | 87% | 高 -- 提升 AI 代理对商品的理解能力 | | 价格 | 100% | 关键 -- 结算必需 | | 币种 | 100% | 关键 -- 必须为有效的 ISO 4217 代码 | | 图片 | 72% | 中 -- 为代理提供商品的视觉信息 | | 分类 | 65% | 中 -- 支持分类筛选检索 | | 库存 | 91% | 高 -- 防止超卖 | ### 质量等级 商品按五级评分体系分级： | 等级 | 分数区间 | 含义 | | ------- | -------- | --------------------- | | **优秀** | 90--100% | 所有关键字段和推荐字段均已填写 | | **良好** | 75--89% | 关键字段完整，部分推荐字段缺失 | | **中等** | 60--74% | 大部分关键字段存在，但有明显缺口 | | **合格** | 40--59% | 满足最低可用标准，仍有较大提升空间 | | **待改进** | 40% 以下 | 关键字段缺失，可能无法出现在代理查询结果中 | ### 精炼台 精炼台是一个人机协作的审核界面，用于处理无法自动修复的数据质量问题。以下情况会进入人工审核队列： * 自动清洗结果置信度较低 * 多数据源之间字段值冲突 * 分类映射存在歧义 审核人员可以对每条建议执行通过、编辑或驳回操作。 ### 异常检测 系统自动标记需要关注的异常模式： * **价格异常** -- 商品价格显著偏离历史均值或同类商品水平 * **字段缺失** -- 同步后字段完整度突然下降（可能是平台配置变更导致） * **重复商品** -- 不同来源的商品共享相同标题、SKU 或图片地址 ## 同步管理 精细控制数据在平台与 ORBEXA 之间的同步方式和频率。 ### 同步周期 为每个集成单独配置自动同步频率： | 周期 | 行为 | | ------- | --------------- | | **手动** | 不自动同步，需从控制台手动触发 | | **每小时** | 每 60 分钟执行一次同步 | | **每天** | 每天在设定时间执行一次同步 | | **每周** | 每周在设定日期执行一次同步 | ### 同步模式 * **增量同步** -- 仅获取自上次同步以来发生变更的商品（速度更快，资源消耗更低） * **全量同步** -- 重新获取完整目录（适用于配置变更后或数据漂移时） ### 同步历史 分页展示所有同步操作的记录，包含以下列： * 开始和结束时间 * 同步模式（增量或全量） * 新增、更新、删除和出错的商品数量 * 整体状态（成功、部分完成或失败） ### 转发日志 对于启用了订单转发的集成，独立的日志记录每个订单向来源平台回传的情况，包括 HTTP 状态码和响应详情。 ## 域名管理 自定义域名功能允许商家从自有品牌域名提供协议端点服务。 ### 添加域名 1. 输入要使用的域名（如 `commerce.yourbrand.com`） 2. 系统生成一条 CNAME 记录值 3. 在域名服务商处添加该 CNAME 记录 4. ORBEXA 定期检测 DNS 解析传播情况 ### DNS 验证状态 | 状态 | 含义 | | ------- | ------------------------------- | | **待验证** | 尚未检测到 CNAME 记录，DNS 传播可能需要 48 小时 | | **已验证** | CNAME 记录确认，SSL 证书正在签发 | | **已生效** | 域名已上线，SSL 证书有效 | | **失败** | 验证超时或检测到错误记录 | ### 域名服务商操作指引 针对主流域名服务商提供分步指引： * **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 的双因素认证，增强登录安全性 * **密码管理** -- 在验证当前密码后修改账户密码 * **活跃会话** -- 查看并吊销各设备上的登录会话 ## 通知系统 通知系统让商家无需时刻守在控制台，也能及时了解重要事件。 ### 通知类别 通知按以下类别组织： | 类别 | 示例 | | ------ | -------------------- | | **订单** | 收到新订单、订单取消、退款完成 | | **同步** | 同步完成、同步失败、部分同步出错 | | **域名** | 域名验证通过、SSL 证书签发、验证失败 | | **系统** | 计划维护、功能更新、套餐变更 | | **警告** | 数据质量下降、接近速率限制 | | **错误** | 集成断开、Webhook 投递失败 | ### 已读/未读追踪 每条通知都有已读/未读状态。未读通知会在导航栏显示角标计数，提供持续的视觉提醒。 通知支持逐条或批量标记为已读，也可按类别筛选以便集中处理。 *** 关于控制台相关 API 端点的详细说明，请参阅[第8章：API 参考与速率限制](/zh/book-7/ch8-api-reference)。 *** 下一章：[故障排查指南](/zh/book-7/ch10-troubleshooting) — 常见错误、Webhook调试、同步失败和域名验证