alai-dev/trade-assistant

Fork 0

Files

T

wlt 7b03d803b5 feat: add product strategy, agent skills (3 SKILL.md), and Chrome browser extension

2026-06-24 10:37:58 +08:00

15 KiB

Raw Blame History

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 分发策略

免费发布到 Agensi.io、cursor.directory、skills.sh
内置在项目 .opencode/skills/ 中，项目自身用 OpenCode 开发时可直接使用
每个 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（已完成）

产品策略文档（本文档）
创建 .opencode/skills/ 目录
完成 translate-reply SKILL.md
完成 customer-discovery SKILL.md
完成 marketing-content SKILL.md

Phase 2：浏览器插件骨架（已完成）

创建 browser-extension/ 项目
完成 manifest.json 配置
完成 popup 基础 UI
对接翻译 API
对接客户发现 API
对接营销生成 API
积分余额展示 + 配额不足升级引导

Phase 3：上架与运营（持续）

定价模型数据库化：配置 SubscriptionPlan + CreditPackage 种子数据
插件端积分展示 + 升级引导 UI 绑定实际 API 响应
发布 SKILL.md 到 Agensi / cursor.directory
发布 Chrome 插件到 Chrome Web Store
配置 Stripe/PayPal 订阅支付（复用后端现有支付系统）

七、兼容性保证

后端无侵入 — Skills 和插件调用已有 API 端点，不改动现有路由
前端无侵入 — 浏览器插件是独立项目，不修改 user-frontend/admin-frontend
数据共享 — 同一用户在不同入口产生的数据互通（共用同一数据库）
可单独部署 — 后端可独立运行，Skills 和插件只是客户端
积分互通 — 所有入口共享 CreditService，消费记录统一记录在 credit_consumptions 表
套餐配置化 — SubscriptionPlan 和 CreditPackage 存储在 DB 中，不硬编码在前端，管理员可随时调整价格和配额

15 KiB Raw Blame History Unescape Escape