IvyeaOps 本地部署
与配置指南
面向亚马逊卖家的自托管运营工作台。第一次装照着做：下载 → 启动 → 登录，再配两把钥匙就能开始用，10 分钟搞定。
备开始前先备好钥匙
真正必须的只有两把钥匙 —— 一个大模型 Key + 一个数据源 Key，配好全站就能用。第三把生图 Key 用到再配。先去下面的地址注册拿到 Key，备用。
把工作台跑起来
这一段每台电脑都一样，跟着点就行，不用输任何命令。
打开 GitHub，进 Releases 找最新版
打开仓库地址 github.com/Hector-xue/IvyeaOps，进页面后看右侧的 Releases，点最新版本（标着 Latest 的那个，当前是 v1.1.91）。
下载对应你系统的安装包并解压
在版本页面下方的 Assets 列表里，按你的电脑系统下载对应的包，下载完解压到一个固定文件夹（比如 D:\IvyeaOps）：
- Windows 电脑 →
IvyeaOps-Windows-x64-v1.1.91.zip - Mac 电脑 →
IvyeaOps-macOS-v1.1.91.zip
双击启动主程序
Windows：进入解压后的文件夹，双击 IvyeaOpsServer.exe。首次启动若弹 Windows 安全提示，选「更多信息 → 仍要运行」（这是自己下载的开源程序，安全）。Mac：按包内说明启动；若提示身份不明开发者，到「系统设置 → 隐私与安全性」点「仍要打开」。
拿到登录账号和密码
启动后，同文件夹里会生成一个 「IvyeaOps 登录信息.txt」，用记事本打开，里面有：访问地址 http://127.0.0.1:8001、用户名 admin、以及一串随机密码（复制它，下一步用）。
浏览器登录工作台
打开浏览器（推荐 Chrome / Edge），地址栏输入 http://127.0.0.1:8001 回车，输入用户名 admin 和刚才复制的密码，点 SIGN IN 登录。
http://127.0.0.1:8001 收藏成书签。127.0.0.1 是「本机」的意思 —— 工作台只跑在你自己电脑上，数据不出本机。配上刚才备好的两个 Key
登录后进「系统配置」，把大模型 Key 和数据源 Key 填进去，就这两步。
★ 填大模型 Key（全局兜底大模型）
点左侧侧边栏的 系统配置（在「AI & 系统」分组里），找到 「全局兜底大模型」区块 —— 它是所有板块 AI 的统一出口，配好它全站 AI 立刻能用。
- Provider 选 DeepSeek，填入你的
DEEPSEEK_API_KEY，模型名用默认 - 点这个区块右上角的 「保存」 即时生效
填数据源 Key，回「健康检查」确认
在同一页的 「数据源」区块填入 Sorftime Key（sorftime.com → 账户设置 → API），点「保存」。有 SIF、卖家精灵的 Key 也可一并填，系统按情况择优调用。
最后看页面里的 「健康检查」：两样配好后对应项变绿就成了。
按需开启的进阶能力
都不是必须的，在「系统配置 → 系统状态」里点对应项的「安装 / 修复」即可。用得到再开。
两块可选能力
IvyeaAgent 自托管智能体
内置的亚马逊运营专用 Agent（对标 Claude Code，自托管、数据留本机），自带本地知识库、语义检索与长期记忆，无需再单独装其它检索组件。在「系统状态」里安装 ivyea-agent 组件，装完它有自己的引导配主脑模型。不装也能用工作台，只是右下角 IvyeaAgent 会显示未连接。
AI 生图 Listing 套图
生成 Listing 主图 / 场景图。在「AI 生图」区块，模型名默认 gpt-image-2；填上生图 Key（Apimart），API Key / Base URL 留空则复用即可。
配完了，去开干
从左侧侧边栏进任意板块
- 首页 · 运营驾驶舱 —— 每日盯盘：大盘流量 / 关键词 / 竞品 / 自有 ASIN / 类目
- 市场调研 —— 输关键词或 ASIN，一键出结构化调研报告
- Listing 工作台 —— 从采集到文案、主图提示词、A+ 的整套流水线
- 打法推荐 —— 输产品词 + 目标售价，出站内打法手册和广告批量表
- 分析工具 —— ASIN 深度审计、广告 search-term 审计、竞品流量 / 评论聚类等