320 lines
15 KiB
Markdown
320 lines
15 KiB
Markdown
# TradeMate 产品策略：Agent Skills + 浏览器插件
|
||
|
||
## 一、市场背景
|
||
|
||
### 1.1 AI Agent Skills 生态（2026）
|
||
|
||
SKILL.md 开放标准已被 20+ 工具原生支持，包括 Cursor、Claude Code、OpenAI Codex CLI、OpenCode、Gemini CLI、GitHub Copilot、VS Code 等。这意味着**一份 SKILL.md 文件可以分发到几乎所有主流 AI 编程工具**。
|
||
|
||
商业化现状：
|
||
- 头部 skill 月收入 $500-$3,000，中位数 < $50/月
|
||
- 定价 $5-$25 一次性购买为主，订阅制尚在试验
|
||
- 平台抽成：Agensi 等第三方市场抽 20%
|
||
|
||
### 1.2 外贸工具浏览器插件生态
|
||
|
||
Chrome Web Store 上已有数十款外贸工具插件：
|
||
- **Topease** — AI 客户开发、邮箱提取、LinkedIn 线索
|
||
- **瞬悉** — 商品采集、店铺分析、AI 生成标题/开发信
|
||
- **生意助手** — 国际站选品/搬品
|
||
- **外贸侠** — 询盘分析、访客分析、聊天记录分析
|
||
- **信风AI** — 海关数据、社媒拓客、AI 电话
|
||
|
||
共同特征：
|
||
- 全部为 Chrome 插件
|
||
- 核心卖点：获客 + 运营提效
|
||
- 定价：几十到几百人民币/月
|
||
- 模式：免费版限制用量 → 付费订阅
|
||
|
||
## 二、TradeMate 的定位
|
||
|
||
TradeMate 的核心优势：
|
||
- **已有完整后端 API**：翻译、客户管理、营销生成、客户发现、报价单等
|
||
- **多 AI 提供商**：商汤、NVIDIA、阿里翻译，不依赖单一厂商
|
||
- **轻量级**：无需部署，已有 Vue 3 前端工作台
|
||
|
||
定位差异化：**不做阿里国际站垂直插件，做通用的外贸 AI 工作台**，覆盖从获客到成交的全链路。
|
||
|
||
## 三、三产品线架构
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────────┐
|
||
│ TradeMate 生态架构 │
|
||
├─────────────────┬──────────────────┬────────────────────────────┤
|
||
│ 项目本身 │ Agent Skills │ 浏览器插件 │
|
||
│ (trade-assistant)│ (SKILL.md) │ (Chrome Extension) │
|
||
├─────────────────┼──────────────────┼────────────────────────────┤
|
||
│ Vue 3 前端 │ OpenCode 标准 │ Chrome Web Store │
|
||
│ FastAPI 后端 │ 跨平台兼容 │ 轻量级 popup 交互 │
|
||
│ PostgreSQL │ 零部署分发 │ 调用后端 API │
|
||
├─────────────────┼──────────────────┼────────────────────────────┤
|
||
│ 独立运营 │ 独立运营 │ 独立运营 │
|
||
│ SOHO/小团队 │ 开发者/高级用户 │ 传统外贸人员 │
|
||
└─────────────────┴──────────────────┴────────────────────────────┘
|
||
```
|
||
|
||
三者关系：
|
||
- **共享同一后端 API**，不重复开发逻辑
|
||
- **项目本身**是全功能工作台
|
||
- **Agent Skills** 是给 AI 编程助手用的轻量能力包
|
||
- **浏览器插件**是非技术用户最顺手的入口
|
||
- 用户可以从任一入口开始使用，随需求升级自然流向其他产品
|
||
|
||
## 四、Agent Skills 规划
|
||
|
||
### 4.1 Skill 列表
|
||
|
||
| Skill 名称 | 功能 | 调用后端 API |
|
||
|-----------|------|-------------|
|
||
| `translate-reply` | AI 翻译 + 智能回复生成 | `POST /api/v1/translate`, `POST /api/v1/translate/reply` |
|
||
| `customer-discovery` | Google 搜索客户 + 信息提取 | `POST /api/v1/discovery/search` |
|
||
| `marketing-content` | 营销文案/关键词生成 | `POST /api/v1/marketing/generate`, `POST /api/v1/marketing/keywords` |
|
||
| `quotation-gen` | 从询盘生成报价单 | `POST /api/v1/quotations` |
|
||
| `followup-scan` | 沉默客户扫描 + 提醒 | `POST /api/v1/followup/scan` |
|
||
|
||
### 4.2 分发策略
|
||
|
||
1. **免费发布**到 Agensi.io、cursor.directory、skills.sh
|
||
2. 内置在项目 `.opencode/skills/` 中，项目自身用 OpenCode 开发时可直接使用
|
||
3. 每个 SKILL.md 描述清晰的目标、输入、输出，独立可用
|
||
|
||
### 4.3 格式标准
|
||
|
||
遵循 SKILL.md 标准格式：
|
||
- `name` — 技能名称
|
||
- `description` — 一句话说明
|
||
- `trigger` — 触发关键词
|
||
- `steps` — 执行步骤
|
||
- `api_endpoints` — 调用的后端接口（需用户自行配置 BASE_URL 和 API Key）
|
||
|
||
## 五、浏览器插件规划
|
||
|
||
### 5.1 功能模块
|
||
|
||
| 模块 | 功能 | 对应后端 |
|
||
|------|------|---------|
|
||
| AI 翻译 | 输入文本自动翻译、划词翻译 | `POST /api/v1/translate` |
|
||
| 智能回复 | 根据客户询盘生成回复建议 | `POST /api/v1/translate/reply` |
|
||
| 客户发现 | 输入关键词搜索目标客户 | `POST /api/v1/discovery/search` |
|
||
| 营销文案 | 生成营销内容/关键词 | `POST /api/v1/marketing/generate` |
|
||
| 快速报价 | 从询盘内容生成报价单 | `POST /api/v1/quotations` |
|
||
|
||
### 5.2 技术架构
|
||
|
||
```
|
||
browser-extension/
|
||
├── manifest.json # Chrome Extension v3 manifest
|
||
├── popup/ # 弹出窗口 UI
|
||
│ ├── index.html
|
||
│ ├── popup.js
|
||
│ └── popup.css
|
||
├── background/ # Service Worker
|
||
│ └── background.js
|
||
├── content/ # 内容脚本（划词翻译等）
|
||
│ └── content.js
|
||
├── api/ # 后端 API 客户端
|
||
│ └── client.js
|
||
└── icons/ # 插件图标
|
||
```
|
||
|
||
### 5.3 统一积分体系
|
||
|
||
三产品线共享同一套积分系统（后端已实现）：
|
||
|
||
```
|
||
┌─────────────────────────┐
|
||
│ TradeMate 后端 │
|
||
│ CreditService │
|
||
│ ┌──────────────────┐ │
|
||
│ │ 积分池 │ │
|
||
│ │ Free: 30 一次性 │ │
|
||
│ │ Starter: 200/月 │ │
|
||
│ │ Pro: 1000/月 │ │
|
||
│ │ Enterprise: 2500/月│ │
|
||
│ └──────────────────┘ │
|
||
└─────────────────────────┘
|
||
│
|
||
┌─────────────────────┼─────────────────────┐
|
||
│ │ │
|
||
网页工作台 浏览器插件 Agent Skills
|
||
(消耗积分) (消耗积分) (需要有效 Token)
|
||
```
|
||
|
||
**关键设计**：
|
||
- 积分（credits）是唯一货币，跨三产品线通用
|
||
- 用户在一个地方订阅，所有入口自动升级
|
||
- 后端已有 `CreditService` + `SubscriptionPlan` + `CreditPackage` 完整体系
|
||
- 浏览器插件通过 API 自动获取当前用户积分余额和套餐信息
|
||
|
||
**消耗标准**（后端已定义 `DEFAULT_CONSUMPTION_RATES`）：
|
||
|
||
| 功能 | 消耗积分 | 说明 |
|
||
|------|---------|------|
|
||
| 翻译 | 1/1000 字符 | 每日前 1000 字符免费 |
|
||
| 客户搜索 (lead_search) | 10 | 单次 Google 搜索 + 结果提取 |
|
||
| 客户分析 (company_analysis) | 5 | 单个网站信息提取 |
|
||
| 营销生成 (marketing_content) | 5 | 单次 AI 文案生成 |
|
||
| 智能回复 (reply_suggest) | 2 | 单次回复建议生成 |
|
||
| 竞品分析 | 10 | 单次竞品对比 |
|
||
| 报价单 | 2 | 从询盘生成报价单 |
|
||
| AI 对话 | 1/10 条 | AI 数字员工对话 |
|
||
|
||
### 5.4 认证方案
|
||
|
||
- 使用 JWT Token 认证，与项目本身共享同一套用户体系
|
||
- 首次使用输入 API 地址和 Token（或扫码登录）
|
||
- Token 存储在 `chrome.storage.local`
|
||
|
||
### 5.5 定价模型
|
||
|
||
#### 5.5.1 月度订阅
|
||
|
||
| 层级 | 月付 | 年付 (折合/月) | 月积分 | 核心权益 |
|
||
|------|------|---------------|--------|---------|
|
||
| **Free** | ¥0 | — | 30 一次性 + 1000字/天免费翻译 | 体验客户搜索 x3 + 基本翻译 |
|
||
| **Starter** | ¥9.9 | ¥99 (¥8.25) | 200 | 解除日限，含翻译/回复/发现/营销/报价 |
|
||
| **Professional** | ¥49 | ¥499 (¥41.6) | 1000 | AI 数字员工 + 团队 (3人) + 优先支持 |
|
||
| **Enterprise** | ¥99 | ¥999 (¥83.3) | 2500 | 不限团队 + API 调用 + SLA 保障 |
|
||
|
||
**Free → Starter 转化逻辑**：
|
||
- 新用户一次性赠送 30 积分 ≈ 3 次客户搜索 或 6 次营销生成
|
||
- 用完即触发升级提示，不走"每日限制"——集中的体验窗口比分散的每日限额更能驱动转化
|
||
- 每日 1000 字免费翻译作为持续留存钩子，不让用户完全流失
|
||
|
||
**Starter ¥9.9/月**：
|
||
- 200 积分/月 ≈ 20 次客户搜索 或 40 次营销生成
|
||
- 足够轻度 SOHO 用户日常使用 20 天
|
||
- 不是"无限量"（后端 AI 调用有成本），但大部分用户用不完 200 积分
|
||
- 积分的**滚动/过期策略**：未用完的积分最多累积到月配额的 2x，鼓励持续付费
|
||
|
||
**Professional ¥49/月** — 利润引擎：
|
||
- AI 数字员工（AgentOrchestrator）是差异化的核心功能
|
||
- 1000 积分 ≈ 100 次客户搜索，覆盖重度用户
|
||
- 团队协作（3 人）增加粘性和替换成本
|
||
|
||
**Enterprise ¥99/月** — 高价值客户：
|
||
- 不限团队成员数
|
||
- 开放 API 调用权限（用于自定义集成）
|
||
- SLA 保障
|
||
|
||
#### 5.5.2 一次性积分包（低门槛入门付费）
|
||
|
||
为"偶尔用用"的用户设计，降低首次付费心理门槛：
|
||
|
||
| 积分包 | 价格 | 折合单价 | 有效期 |
|
||
|-------|------|---------|-------|
|
||
| 50 积分 | ¥2.9 | 0.058/积分 | 30 天 |
|
||
| 200 积分 | ¥9.9 | 0.050/积分 | 90 天 |
|
||
| 600 积分 | ¥24.9 | 0.042/积分 | 180 天 |
|
||
|
||
积分包的作用：
|
||
- 用完 Free 额度的用户只需花 **¥2.9** 就能继续用，而不是直接跳到 ¥9.9/月
|
||
- ¥2.9 的支付摩擦远低于 ¥9.9，付费转化率会显著提升
|
||
- 多次购买积分包后，用户自然过渡到订阅（"我每个月都花 ¥9.9 买积分包，不如直接订阅"）
|
||
|
||
#### 5.5.3 三产品线统一定价映射
|
||
|
||
```
|
||
Free Starter (¥9.9) Professional (¥49) Enterprise (¥99)
|
||
网页工作台 ✓ ✓ ✓ ✓
|
||
浏览器插件 ✓ ✓ ✓ ✓
|
||
Agent Skills (需自备Key) (需自备Key) 含 Token 含 Token
|
||
```
|
||
|
||
用户只需订阅一次，所有入口通用。后端判断权限的依据是**当前用户的积分余额和订阅计划**，而不是产品入口。
|
||
|
||
### 5.6 付费转化设计（升级触发器）
|
||
|
||
定价只是桌子，付费转化才是把客人请进来坐下。以下是每个触点的设计：
|
||
|
||
#### 5.6.1 Free 用完积分
|
||
|
||
```
|
||
触发时机：用户发起请求，后端返回 402 Payment Required
|
||
{ "detail": "次数不足 (剩余 0.0, 需要 10)" }
|
||
|
||
插件显示：
|
||
┌──────────────────────────────────────────────┐
|
||
│ ⚡ 体验积分已用完 │
|
||
│ 30 次体验积分已用完，本次搜索需要 10 积分。 │
|
||
│ │
|
||
│ [买 50 积分 ¥2.9] [订阅 Starter ¥9.9/月] │
|
||
│ 或者下次再说 │
|
||
└──────────────────────────────────────────────┘
|
||
```
|
||
|
||
#### 5.6.2 功能灰化预览
|
||
|
||
```
|
||
AI 数字员工 Tab 始终可见，但 Professional 以下层级显示：
|
||
|
||
┌──────────────────────────────────────────────┐
|
||
│ 🔒 AI 数字员工 │
|
||
│ 自动搜索客户 → 分析公司 → 生成开发信 → 保存 CRM │
|
||
│ 全流程自动化，每天可处理 10+ 潜在客户 │
|
||
│ │
|
||
│ [升级 Professional ¥49/月 解锁] │
|
||
└──────────────────────────────────────────────┘
|
||
```
|
||
|
||
#### 5.6.3 活跃度推送
|
||
|
||
首次使用后第 3 天：
|
||
|
||
```
|
||
通知标题：TradeMate 还够用吗？
|
||
内容：你已使用了 12 次翻译、2 次客户搜索
|
||
升级 Starter 可解除所有限制，仅 ¥9.9/月
|
||
```
|
||
|
||
#### 5.6.4 积分仪表盘
|
||
|
||
Footer 始终显示：
|
||
|
||
```
|
||
剩余 15 积分 · 可用 1 次搜索 · 升级 ↑
|
||
```
|
||
|
||
点击"升级"弹出价格对比卡片——**即时可见可用性**是转化核心驱动力。
|
||
|
||
#### 5.6.5 限时 Pro 试用
|
||
|
||
在新用户注册后，自动赠送 3 天 Pro 体验（300 积分 + 完整功能）：
|
||
- 体验结束后恢复到 Free 层
|
||
- 体验期间展示："还剩 2 天 Pro 体验 · 到期自动降级"
|
||
- 到期前 24 小时推送转化："Pro 体验即将结束，订阅仅 ¥9.9/月"
|
||
|
||
## 六、实施路线图
|
||
|
||
### Phase 1：文档 + Agent Skills（已完成）
|
||
- [x] 产品策略文档（本文档）
|
||
- [x] 创建 `.opencode/skills/` 目录
|
||
- [x] 完成 `translate-reply` SKILL.md
|
||
- [x] 完成 `customer-discovery` SKILL.md
|
||
- [x] 完成 `marketing-content` SKILL.md
|
||
|
||
### Phase 2：浏览器插件骨架（已完成）
|
||
- [x] 创建 `browser-extension/` 项目
|
||
- [x] 完成 manifest.json 配置
|
||
- [x] 完成 popup 基础 UI
|
||
- [x] 对接翻译 API
|
||
- [x] 对接客户发现 API
|
||
- [x] 对接营销生成 API
|
||
- [x] 积分余额展示 + 配额不足升级引导
|
||
|
||
### Phase 3：上架与运营（持续）
|
||
- [ ] 定价模型数据库化：配置 SubscriptionPlan + CreditPackage 种子数据
|
||
- [ ] 插件端积分展示 + 升级引导 UI 绑定实际 API 响应
|
||
- [ ] 发布 SKILL.md 到 Agensi / cursor.directory
|
||
- [ ] 发布 Chrome 插件到 Chrome Web Store
|
||
- [ ] 配置 Stripe/PayPal 订阅支付（复用后端现有支付系统）
|
||
|
||
## 七、兼容性保证
|
||
|
||
1. **后端无侵入** — Skills 和插件调用已有 API 端点，不改动现有路由
|
||
2. **前端无侵入** — 浏览器插件是独立项目，不修改 user-frontend/admin-frontend
|
||
3. **数据共享** — 同一用户在不同入口产生的数据互通（共用同一数据库）
|
||
4. **可单独部署** — 后端可独立运行，Skills 和插件只是客户端
|
||
5. **积分互通** — 所有入口共享 `CreditService`，消费记录统一记录在 `credit_consumptions` 表
|
||
6. **套餐配置化** — `SubscriptionPlan` 和 `CreditPackage` 存储在 DB 中，不硬编码在前端，管理员可随时调整价格和配额
|