常见问题

安装与启动

Windows 提示"未知发布者"

CrossPilot 暂未加 EV 代码签名。SmartScreen 警告点 更多信息 → 仍要运行 即可。后续版本会加签名。

macOS 提示"已损坏，无法打开"

Gatekeeper 拦了。在终端：

xattr -dr com.apple.quarantine /Applications/CrossPilot.app

Linux 启动报缺 WebKitGTK

# Ubuntu / Debian
sudo apt install libwebkit2gtk-4.1-0 libsoup-3.0-0

# Fedora
sudo dnf install webkit2gtk4.1 libsoup3

启动后一片空白

清缓存重启：

# Windows
Remove-Item -Recurse -Force $env:APPDATA\com.agilefr.crosspilot\webview-cache

# macOS
rm -rf ~/Library/Caches/com.agilefr.crosspilot
# Linux
rm -rf ~/.cache/com.agilefr.crosspilot

授权与数据

CrossPilot 会爬亚马逊或模拟操作吗？

不会。 数据只来自官方 SP-API / Ads API / 官方报表。不爬前台、不模拟买家、不做多账号指纹规避、不批量自动操作后台。详见 合规护栏。

我的数据会上传到你们的云吗？

不会。 所有数据落在你本机的 SQLite，SP-API 令牌 / LLM Key 本地 AES-256-GCM 加密，不上传遥测。见 数据本地化与凭据加密。

授权后拉不到某类数据？

确认对应 SP-API 应用已勾选所需角色；广告数据需单独授权 Ads API；部分报表需等待 SP-API 生成。见 授权第一家店铺。

多店数据会不会串？

不会。所有业务表按 store_id + marketplace + currency 分区，查询默认租户过滤。见 店铺中心。

利润为什么算得不准 / 是负的？

多半是成本没导入。利润要准，需先 CSV 导入采购成本 / 头程。见 利润真相。

AI 与 MCP

用 AI 要不要额外付费？

CrossPilot 用你自己的 LLM Key（BYOK），用量与成本自控。CrossPilot 不代管额度。见 AI 模型配置。

AI 会不会拿到我的 SP-API 令牌？

不会。MCP 能力 schema 无凭据字段，令牌只在 Rust 后端请求瞬间解密，出口敏感串自动 [REDACTED] 脱敏。见 数据本地化与凭据加密。

AI 能不能直接改我的广告 / Listing？

不能直接改。写操作强制走「变更计划 → 审批 → 执行 → 审计」，你审批后才落地，且可回滚。见 MCP 读写分级与 Scoped Token。

MCP 会开公网端口吗？

不会。CrossPilot 的 MCP 仅 stdio，不开 HTTP、不监听公网端口。见 MCP 能力网关。

授权与账号

免费试用有什么限制？

首次安装自动开启免费试用，核心功能完整可用。到期后提示激活，本地数据不受影响。见 许可证与订阅。

换电脑后提示未授权？

授权绑定设备指纹，换机需重新激活 / 迁移授权。换机前记得先 备份数据。

其它

卸载会删除我的数据吗？

不会自动删。数据目录需手动清理；重装 / 换机前建议先 备份。

遇到 Bug 去哪反馈？

• QQ 交流群：1082276867（Bug 反馈 / 使用交流）
• B 站：@抓蛙师
• 更多联系方式见 技术服务