环境要求

• 任意一个 LLM API Key：Claude / DeepSeek / Kimi / MiniMax / GLM / Qwen
• 浏览器引擎——Chrome 或紫鸟

安装

快速开始 —— 选你的系统

<details open> <summary><b>🪟 Windows —— 原生安装包（推荐）</b></summary>

无需 WSL，无需配置 Python。从 最新 release 下载 VibeSeller-Setup.exe 双击运行。

或在 PowerShell 里：

irm https://raw.githubusercontent.com/zpoint/vibe-seller/main/installer/windows/install.ps1 | iex

</details>

<details open> <summary><b>🍎 macOS / 🐧 Linux</b></summary>

curl -sSL https://raw.githubusercontent.com/zpoint/vibe-seller/main/install.sh | bash
vibe-seller start

打开 <http://localhost:7777>。升级：vibe-seller upgrade。卸载：uv tool uninstall vibe-seller。

_{环境要求（<code>install.sh</code> 自动处理）：Python 3.11+（经 <a href="https://docs.astral.sh/uv/"><code>uv</code></a>）、Node.js 22+。}

</details>

<details> <summary>🪟 Windows 走 WSL2（进阶）</summary>

优先用上面的原生安装包。WSL2 方案是服务跑在 Ubuntu/WSL 里、浏览器在 Windows 宿主侧——需要 mirrored 网络模式（仅 Windows 11+ 支持）。完整步骤见 开发者指南。

```bash

3. 启动

vibe-seller start

服务会在后台跑起来，终端打印 PID 和日志路径就完事——可以关掉终端窗口，服务不会停。需要停掉的时候用 vibe-seller stop。

3. 启动

vibe-seller start

服务会在后台跑起来，终端打印 PID 和日志路径就完事——可以关掉终端窗口，服务不会停。需要停掉的时候用 vibe-seller stop。

首次配置

<details> <summary><b>🪟 Windows —— 首次配置（4 步）</b></summary>

刚用原生安装包装完的话，跟着这 4 步走：

7. （可选）配置邮件 / 企业微信

想让 Agent 每天出邮件巡检报告、把异常推到企业微信群？设置 → 集成 里加：

• 邮件：填店铺对应邮箱地址，IMAP 服务器会自动识别（gmail / outlook / 自建都支持），你只用填 secrets（应用密码 / app password）。不知道怎么生成？把邮箱供应商名字问任意 AI 就行。保存后 Agent 每天自动扫一遍。
• 企业微信：建群机器人，把 webhook URL 粘进来。重要异常自动推到群。
• TickTick / Google Workspace：要把结果同步到日程或文档的话，这里也能接。

跳过没关系，先把第一个任务跑通再说。

7. （可选）配置邮件 / 企业微信

想让 Agent 每天出邮件巡检报告、把异常推到企业微信群？设置 → 集成 里加：

• 邮件：填店铺对应邮箱地址，IMAP 服务器会自动识别（gmail / outlook / 自建都支持），你只用填 secrets（应用密码 / app password）。不知道怎么生成？把邮箱供应商名字问任意 AI 就行。保存后 Agent 每天自动扫一遍。
• 企业微信：建群机器人，把 webhook URL 粘进来。重要异常自动推到群。
• TickTick / Google Workspace：要把结果同步到日程或文档的话，这里也能接。

跳过没关系，先把第一个任务跑通再说。

集成的服务

除了浏览器，Agent 还能直接调用下面这些外部服务（首次配置里挂上权限就行，不用写代码）：

一个任务可以同时用浏览器 + 这些服务。比如「找出所有店铺滞销的 SKU」可以这样跑：浏览器抓库存 → 生成 Google Sheet 报表 → 把摘要发企微 → 在滴答清单里给你建个「下周降价」的待办。

常见问题

<details> <summary><b>要花多少钱？</b></summary>

Vibe Seller 本身免费开源，花钱的只有你自己的 LLM API Key——直接给供应商付费。粗略量级：用 DeepSeek 跑一次广告调优大概 ¥1。

</details>

<details> <summary><b>该选哪个 LLM？</b></summary>

不同任务对模型推理能力的需求差很多，建议按任务类型挑：

为什么？复杂任务里 Agent 要边读 Skill、边判断页面状态、边调用工具、边记笔记。便宜模型（比如 MiniMax 的低端档）在这种场景下经常出现：

• 不按 Skill 步骤来，跳着走
• 工具调用参数错乱
• 长上下文里把前面的判断忘掉

另外一个常被忽视的点：上下文窗口大小。Claude 和 DeepSeek v4 都是 1M 上下文，大多数其他模型在 200k 左右。跑一个复杂任务时（多页表格、跨流程对话历史、累积下来的笔记），200k 很容易爆——模型开始忘掉前面的判断、丢失细节，甚至直接出错。1M 上下文跑同样的任务从容得多。

简单任务用什么模型差别不大，能省 token 就用便宜的；难任务上贵模型不是奢侈、是必要——一次失败的复杂任务消耗的 token + 时间，比直接用 SOTA 模型一次跑通要多得多。

</details>

<details> <summary><b>紫鸟接入是怎么回事？开发者模式 vs 普通模式 / 需要的凭据 / 存哪</b></summary>

紫鸟同一时间只能跑一种模式：

• 普通模式——你双击紫鸟图标启动的就是这个。只有 UI，给你日常手动用，外部程序进不来。
• 开发者模式（WebDriver）——同一个紫鸟，启动时带了额外参数，会在 127.0.0.1:16851 开一个 HTTP API。这是 Vibe Seller（或者任何外部工具）能驱动紫鸟的唯一入口。

两个模式共用同一个紫鸟进程，不能同时跑。切换模式 = 重启紫鸟：

• macOS / 原生 Windows：Vibe Seller 自己来——打开店铺时它会先把普通模式的紫鸟杀掉，然后带 --run_type=web_driver 重新拉起，两个平台都一样自动接管，不用你操心。
• Windows（WSL）：WSL 这边没法跨虚拟机边界重启 Windows 上的紫鸟，所以 Windows 侧需要跑一个一行的 .bat 启动器（从 设置 → 店铺 → 下载启动器 里下载）来完成杀掉 + 重启。双击跑一次就行，之后 Vibe Seller 通过「刷新」按钮就能识别到开发者模式的会话。

需要的凭据——在 设置 → 店铺 里加一个「紫鸟账号」，填三个字段：

跟你平时登紫鸟用的是同一套——Vibe Seller 把这三个字段传给开发者模式的 HTTP API，用来列出你的浏览器档案、启动会话。

主账号（BOSS 账号）需要先在紫鸟开放平台开通开发者模式（一次性管理员配置，见 <https://open.ziniao.com/docSupport?docId=99>）。没开通的话紫鸟会拒绝登录（报错 statusCode: -10003——紫鸟自己的错误码，意思就是「这个公司没开通开发者模式」）。

凭据存在哪——全部在你本地 ~/.vibe-seller/data/vibe_seller.db（SQLite）。没有上传，遥测通道也不带走。

• 密码：落盘前加密，密钥从你本地安装派生，任何 HTTP 接口都不会把密码返回给前端——只在 Vibe Seller 要调紫鸟 HTTP API 那一刻才在内存里解密。
• 公司名称 和 用户名：明文存储——这俩是身份标识，跟邮箱地址一个性质。

让你填密码这件事是没办法的：紫鸟开发者模式的 HTTP API 走的就是账号密码，没有 OAuth / token 替代。不能接受就走普通 Chrome：设置 → 店铺 → 添加 Chrome 店铺。想看具体加密实现的可以翻 docs/dev-guide.md。

</details>

<details> <summary><b>绑定店铺时紫鸟提示「无权限通过 webdriver 登录」怎么办？</b></summary>

主账号（BOSS）还没给子账号开通 WebDriver 登录权限。按紫鸟官方指南，在开放平台控制台里把 WebDriver 登录选项勾上：

<img width="1857" height="903" alt="紫鸟开放平台——勾选 WebDriver 登录" src="https://github.com/user-attachments/assets/c6066eff-f877-470e-a061-6abd73b6d2f8" />

只需要主账号操作一次，保存之后子账号就能通过 WebDriver 登录，回到 Vibe Seller 点「刷新」就能绑上店铺。

</details>

<details> <summary><b>绑定店铺时紫鸟提示「检测到您在新终端登录」怎么办？</b></summary>

这是紫鸟的新设备安全检测，不是 Vibe Seller 的问题。同一个账号第一次在某台机器上登录时，紫鸟要求人工审批一次：

1. 在这台机器上手动打开紫鸟（普通模式，不是 WebDriver），用同一个子账号登录。
2. 紫鸟会弹出新设备提示——按提示提交审批申请。
3. 主账号（BOSS）到紫鸟后台批准这台设备。

批准之后这台设备就被信任了，回到 Vibe Seller 点「刷新」，WebDriver 登录就能直接通过。

</details>

<details> <summary><b>能不能跑在云服务器上？</b></summary>

可以，需要自己解决浏览器和 GUI 的问题。Vibe Seller 本身跑在无 GUI 的服务器上没问题；紫鸟（以及想看操作过程的 Chrome 后端）需要有地方渲染画面——虚拟显示（Xvfb）、云桌面 VM，或者 VNC 进一个真实 GUI 会话都行。不过更省事的常见做法还是本地摆一台常开的小机器——Mac mini、装了 WSL 的迷你 Windows 主机、或者一台闲置笔记本——团队通过内网连上去用。

</details>

<details> <summary><b>我的店铺数据会不会泄露？</b></summary>

数据库、截图、日志全在你硬盘上的 ~/.vibe-seller/ 目录里。唯一出本地的流量是你发给 LLM 供应商的 Prompt（包含 Agent 要读的页面片段），其他什么都不外发。

</details>

<details> <summary><b>Agent 的「记忆」存哪？</b></summary>

每个店铺的知识积累在 ~/.vibe-seller/stores/<店铺 slug>/ 下的纯 markdown 文件里——你能看、能改、能在不同机器之间拷贝。Skill 也是 markdown。没有任何东西锁在二进制里。

</details>