开源 AI 跨境电商增长与运营平台
从一条商品链接，到可运营、可刊登、可持续协同的商品资产
简体中文 | English
快速开始 · 界面预览 · 核心能力 · 架构与技术栈 · 文档中心
TradeMind 是面向跨境卖家、品牌团队与开发者的开源 AI 运营平台。它把商品采集、信息整理、内容生成、图片处理、草稿协同、平台刊登、订单与库存协同串成一条可观测的工作流，让团队从“重复搬运商品”升级为“持续经营商品资产”。
无论是快速搭建自己的跨境运营工作台，还是为现有业务接入 AI 与平台能力，TradeMind 都提供一套可私有化部署、可审计、可二次开发的开放底座：数据掌握在自己手中，能力可以按团队流程自由组合。
| 方向 | TradeMind 的做法 |
|---|---|
| AI 商品增长 | 将商品采集、草稿管理、AI 标题与描述、图片处理和发布前检查汇聚到同一个运营空间。 |
| 多平台协同 | 店铺授权、订单同步、SKU 匹配、库存镜像与商品刊登围绕统一商品资产协同运转。 |
| 开放与可控 | Provider 架构覆盖 AI、存储、图片、平台和采集器；权限、审计与人工确认守住关键动作。 |
下面的界面预览展示 TradeMind 的核心工作流：商品采集 → 商品草稿 → AI 内容优化。从发现商品开始，到准备好可发布内容，每一步都清晰可追踪。
采集中心：采集器入口与批量采集 |
采集任务：链接提交、状态追踪与草稿关联 |
采集监控：Worker、任务与批次状态分布 |
AI 描述生成：生成卖点、规格与描述并应用到草稿 |
- 商品采集：支持 1688、拼多多、淘宝/天猫与自定义规则采集。
- 商品草稿：统一管理商品、SKU、图片、库存阈值、采集告警与发布前检查。
- AI 内容：支持标题优化、描述生成、Prompt 模板、结果对比、人工应用与撤销。
- AI 图片：支持 remove.bg、OpenAI Image、ComfyUI 等 Provider，并通过异步任务队列执行。
- 店铺授权：支持 Douyin Shop OAuth、敏感配置加密与连接测试。
- 订单协同：支持订单同步、SKU 匹配、异常工作台等基础能力。
- 库存协同：支持库存镜像、预警与平台同步任务。
- 商品刊登：支持多平台刊登中心、单商品与批量草稿创建、批量发布流程、AI 标题/描述复核、AI 图片处理、草稿映射、发布任务、失败恢复与人工校正。
- AI 客服：支持建议回复与人工确认外发；可按店铺显式开启低风险自动回复，默认关闭并保留频率、订单上下文、敏感承诺、审计与人工接管保护。
- Provider 架构：AI、存储、图片、平台、采集能力均通过 Provider 抽象扩展。
- 自部署友好：默认 PostgreSQL + Redis，支持本地开发和 Docker Compose 完整部署。
- Monorepo 协作：backend、admin、collector 与文档规则统一维护，适合团队协作与持续演进。
- 可靠性地基：关键写路径统一幂等，AI 结果应用/撤销保护，Webhook 快速 ACK，异步 Worker 租约防止陈旧写回。
| 层级 | 技术栈 |
|---|---|
| Backend | Go + Gin + GORM |
| Admin | React + TypeScript + Ant Design Pro |
| Collector | Node.js + TypeScript + Playwright |
| Data | PostgreSQL + Redis |
| Deploy | pnpm workspace + Docker Compose |
| Extension Points | AI / Storage / Image / Platform / Collector Providers |
pnpm install
pnpm install:collector:browsers
pnpm dev常用命令：
pnpm check:dev
pnpm dev:infra
pnpm dev:backend
pnpm dev:admin
pnpm dev:collector
pnpm build:admin
pnpm build:collector
pnpm seed:demo-data
pnpm seed:demo-permissions开发环境默认连接隔离的 PostgreSQL 与 Redis；完整自动化回归由 GitHub Actions 持续执行。
cp .env.example .env
# 在 .env 中设置独立随机的 COLLECTOR_SERVICE_TOKEN（至少 32 字符）
docker compose -f docker-compose.full.yml up -d --buildWindows PowerShell：
Copy-Item .env.example .env
# 在 .env 中设置独立随机的 COLLECTOR_SERVICE_TOKEN（至少 32 字符）
docker compose -f docker-compose.full.yml up -d --buildGitHub Actions 会为 backend、admin 和 collector 自动发布 GHCR 多架构镜像。使用预构建镜像：
# 在 .env 中设置 COLLECTOR_SERVICE_TOKEN，并覆盖以下镜像引用
TRADEMIND_BACKEND_IMAGE=ghcr.io/lien0219/trademind-backend:dev-v0.2.0
TRADEMIND_ADMIN_IMAGE=ghcr.io/lien0219/trademind-admin:dev-v0.2.0
TRADEMIND_COLLECTOR_IMAGE=ghcr.io/lien0219/trademind-collector:dev-v0.2.0
docker compose -f docker-compose.full.yml pull backend admin collector
docker compose -f docker-compose.full.yml up -d --no-build分支构建会更新分支、分支版本和 sha-<commit> 标签，但不会更新 latest。正式版本合并到 main 后，推送与 deploy/IMAGE_VERSION 一致的 v<version> Git Tag，工作流才会发布 v<version>、version 和 latest。正式部署应使用工作流输出的 image@sha256:<manifest-digest> 不可变引用。完整发布步骤与包地址见 Docker 部署。
默认访问地址：
| 服务 | 地址 |
|---|---|
| Admin | http://127.0.0.1:8000 |
| Backend Health | http://127.0.0.1:8080/health |
完整 Compose 中 Collector 仅供 backend 通过内部网络访问，不发布宿主机端口；PostgreSQL 与 Redis 仅绑定宿主机回环地址。平台连接默认采用安全的审核式草稿流程：非抖店链路先生成本地刊登草稿，抖店动作经过权限与运营任务审核后写入平台草稿。
Admin 根路径展示公开产品首页，访客可从首页进入登录页或注册页；登录后再进入运营工作台。
更多说明：
- docs/README.md：完整文档入口。
- docs/development.md：本地开发、调试与常用命令。
- docs/docker-deployment.md：Docker Compose 完整部署与运维说明。
- docs/api.md：API 契约、统一返回与鉴权说明。
- docs/provider.md：Provider 扩展机制与安全约束。
- docs/architecture.md：系统架构、分层与数据流说明。
- docs/branching.md：分支策略与 PR 规则。
- 贡献代码或文档前，请先阅读 CONTRIBUTING.md。
- 安全问题请参考 SECURITY.md。
- 如果你愿意补充更好的截图、示例数据或文档，也非常欢迎提交 PR。
- 赞助方式见 docs/sponsor.md。
本项目基于 Apache License 2.0 开源。