快速开始

本页带你在 5 分钟内跑通 CrossPilot 的核心闭环：装好 → 授权一家店 → 看到跨店驾驶舱。

第 1 步：下载安装

前往下载页获取对应平台的安装包：

Windows：.exe 安装程序，双击安装
macOS：.dmg，拖入「应用程序」
Linux：.deb 或 .AppImage

详细安装说明见安装指南。首次安装自动开启免费试用，无需注册。

第 2 步：授权第一家店铺

打开 CrossPilot，进入 店铺中心：

点「添加店铺」，填写店铺备注名、选择站点（Marketplace）与结算币种
按引导完成 SP-API 授权（Login with Amazon 授权，拿到刷新令牌）
令牌在录入瞬间被 AES-256-GCM 加密 存入本地，之后 AI 与前端都看不到明文

详细的授权流程、受限数据（PII）授权说明，见授权第一家店铺。

第 3 步：首次同步

店铺接入后，CrossPilot 的同步引擎会拉取订单、报表、广告、库存等数据：

内置令牌桶限流 + 指数退避重试，不会因为打爆 SP-API 配额被限流
支持 resume（断点续传）与幂等写入，中途中断可安全恢复
首次全量同步耗时取决于店铺数据量与 SP-API 报表生成速度，请耐心等待

第 4 步：看你的第一屏数据

同步完成后进入 聚合驾驶舱：

你会看到	含义
跨店销售额 / 净利 / 订单	所有已授权店铺汇总
ACOS	广告花费占销售额比例
店铺健康状态	红 / 黄 / 绿，异常店铺置顶

再进 商品中心 → 某个 ASIN → ASIN 360，就能看到单品的销量、真实利润、广告、库存全景。

第 5 步（可选）：接入 AI

如果你想让 AI 帮你写 Listing、优化 PPC、起草客服回复：

在 设置 → AI 模型配置 填入自己的 LLM Key（自带 Key，用量自控）
在 MCP 能力网关 签发一个 Scoped Token，一键写入 Claude Code / Codex 配置

详见接入第一个 AI 客户端。

常见第一步问题

现象	处理
授权后拉不到数据	确认该店铺 SP-API 应用已勾选所需角色；等待 SP-API 报表生成
利润为负 / 不准	先在利润页确认已导入成本（采购价 / 头程），见利润真相
多店数据看着串了	CrossPilot 按 `store_id` 分区，确认顶部选中的是正确店铺 / 全部店铺

下一步

授权第一家店铺 — SP-API 授权详解
利润真相 — 把成本导进来，让利润能对账
接入第一个 AI 客户端 — 让 AI 受控地帮你运营