Skillget

trademind-ai

agent
Guvenlik Denetimi
Uyari
Health Uyari
  • License — License: Apache-2.0
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Gecti
  • Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

Open-source AI cross-border e-commerce operation platform.

README.md

贸灵 TradeMind

开源 AI 跨境电商运营平台

商品采集 · 商品草稿 · AI 标题优化 · AI 描述生成 · 图片管理 · 店铺授权 · 订单同步 · AI 客服建议

License Go React TypeScript Docker pnpm PRs Welcome Stars Welcome

简体中文 | English

贸灵 TradeMind 是一个面向跨境电商卖家的开源 AI 运营工具，当前支持商品采集、商品草稿、AI 标题优化、AI 描述生成、图片管理、AI 图片任务、店铺授权、订单同步、SKU 匹配、商品刊登、库存同步和 AI 客服建议等运营能力。

项目截图 / Demo

以下为管理后台实际界面（本地开发环境），展示 商品采集 → 草稿 → AI 内容优化 的主线能力。

采集中心 采集任务
1688 等采集器入口、立即/批量采集 提交链接、任务状态与商品草稿关联
采集中心 采集任务
采集监控 AI 描述生成（商品草稿）
Worker 与任务/批次状态分布 Prompt 生成描述、卖点与规格，可应用至草稿
采集监控 AI 描述生成

同款能力亦支持 AI 标题优化、图片任务、店铺授权与订单同步等模块，详见 核心功能 与 文档导航。欢迎提交 PR 补充更多截图。

目录

项目介绍

贸灵 TradeMind 是一个开源 AI 跨境电商运营平台，面向需要高效完成商品上新、内容优化、图片处理、店铺运营和订单处理的跨境电商卖家与开发团队。

当前项目已经围绕商品运营链路提供一组可运行的能力：采集商品链接后生成商品草稿，维护 SKU 与商品图片，调用 AI 生成标题和描述，执行图片处理任务，配置多平台店铺，拉取订单，进行 SKU 匹配、库存同步、商品刊登，并在客服场景中生成 AI 建议回复。项目通过 Provider 抽象接入 AI、存储、图片处理、采集源和跨境平台，便于私有化部署和二次开发。

商品采集 → 商品草稿 → AI 标题优化 → AI 描述生成 → 图片管理
  → AI 图片处理 → 店铺授权 → 商品刊登 → 订单同步
  → SKU 匹配 → 库存同步 → AI 客服建议

为什么做这个项目

跨境卖家的日常运营中存在大量重复工作：采集商品、整理标题、生成多语言描述、处理商品图、维护平台店铺、同步订单、回复买家消息。传统 ERP 更偏数据录入与流程管理，而 TradeMind 更强调把 AI 能力嵌入商品运营和跨平台协作流程。

TradeMind 希望提供一个开源、可部署、可二次开发的基础平台，让个人卖家、运营团队和开发者都能围绕自己的业务流程接入 AI Provider、Storage Provider、Image Provider、Collector Provider 与 Platform Provider。

核心功能

模块 能力 当前状态
商品采集 1688 / 拼多多 / 淘宝天猫已可用，自定义链接基础可用，AliExpress 测试中，SHEIN/Temu 规划中 阶段验收通过
商品草稿 统一草稿模型、商品、SKU、图片、库存阈值、采集 warning、发布前检查 已支持
AI 标题优化 OpenAI-compatible Provider、Prompt 模板、任务记录、应用结果 已支持
AI 描述生成 商品描述生成、Prompt 模板、AI 任务追踪 已支持
SKU 候选推荐 订单行 SKU 候选、人工绑定、匹配审计 已支持
图片管理 本地 / 云存储文件上传、商品图片管理、对象存储 Provider 已支持
AI 图片处理 remove.bg、OpenAI Image、ComfyUI Provider、异步任务队列 已支持
店铺授权 抖店 OAuth 授权闭环、API Client / 签名层、token 加密保存与自动刷新、刷新 / 解除 / 真实测试连接、类目 / 属性缓存、平台商品草稿创建、订单同步 MVP、库存同步 MVP、SKU 绑定校准与手动兜底；TikTok Shop / Shopee / Lazada / Amazon 授权基座保留 抖店 Phase 9.2 已支持
多平台配置 平台开放配置 Schema、抖店配置、Service ID、敏感配置加密与脱敏 已支持
订单同步 多平台订单同步框架、任务队列、异常工作台；抖店 order.searchList 自动分页 MVP（默认 5 页 / 500 条） 抖店 Phase 8.1 已支持
商品刊登 定价规则、图片同步、发布前检查、抖店刊登草稿映射预览、人工调整保存、刊登任务、失败中心 生产级完善中
库存同步 本地库存、平台库存镜像、库存预警、同步任务；抖店 sku.syncStock MVP（手动同步，绑定校验通过后可用，受 inventory_sync_enabled 开关控制） 抖店 Phase 9.2 已支持
AI 客服 客服消息同步、AI 建议回复、人工确认外发 开发中
自动化运营 失败任务中心、告警、批量 AI、任务重试 预留架构

产品能力地图

AI 商品运营工具
├── 商品采集：1688 / 拼多多 / 淘宝天猫已可用；自定义基础可用；AliExpress 测试中
├── 商品草稿：标题、描述、SKU、图片、库存阈值、采集 warning
├── AI 文本：标题优化、描述生成、Prompt 模板、调用记录
├── AI 图片：去背景、换背景、场景图、异步处理任务
└── 商品发布前检查、定价规则、图片同步与批量 AI 操作

多平台跨境 ERP MVP
├── 真实平台闭环：抖店优先（OAuth 授权、API Client / 签名层、类目 / 属性缓存、商品字段映射与刊登草稿预览、图片上传、平台商品草稿创建、订单同步 MVP、**库存同步 MVP** 已打通）
├── 店铺授权：Douyin Shop OAuth 已支持；TikTok Shop / Shopee / Lazada / Amazon 后续保留
├── 订单同步：平台订单拉取、本地订单、SKU 匹配
├── 库存同步：库存预警、平台库存任务、失败重试
├── 商品刊登：发布任务、平台映射、刊登快照、失败中心
└── AI 客服：消息同步、建议回复、人工确认发送

快速开始

TradeMind 提供两种启动方式：

  1. 本地开发一键启动：适合开发者调试和二次开发。
  2. Docker 部署启动：适合快速试用完整项目。

方式一：本地开发一键启动

pnpm install
pnpm install:collector:browsers
pnpm dev

pnpm dev 会使用根目录脚本并行启动：

  • PostgreSQL / Redis 基础设施（默认 Docker Compose；无 Docker 时若本机已运行 PostgreSQL / Redis 则自动跳过 Compose）
  • backend Go 服务
  • admin 管理端
  • collector 采集服务

常用开发命令：

pnpm check:dev
pnpm dev:infra
pnpm dev:backend
pnpm dev:admin
pnpm dev:collector
pnpm dev:stop
pnpm dev:reset
pnpm build:admin
pnpm build:collector
pnpm collect:test

pnpm dev:reset 会重置默认 Compose 数据卷，可能清空本地 PostgreSQL 数据，请谨慎使用。

方式二：完整 Docker 部署

仓库已包含 docker-compose.full.yml、backend/Dockerfile、admin/Dockerfile、collector/Dockerfile 与 admin/nginx.conf。

cp .env.docker.example .env
docker compose -f docker-compose.full.yml up -d --build

Windows PowerShell：

Copy-Item .env.docker.example .env
docker compose -f docker-compose.full.yml up -d --build

默认访问地址：

服务 地址
Admin http://127.0.0.1:8000
Backend Health http://127.0.0.1:8080/health
Collector Health http://127.0.0.1:3001/health

停止服务：

docker compose -f docker-compose.full.yml down

登录态目录：Compose 会挂载 ./data/browser-profiles 持久化 1688 采集浏览器 Cookie；该目录含敏感运行时数据，已在 .gitignore 中忽略，请勿提交到 Git。

查看日志：

docker compose -f docker-compose.full.yml logs -f backend
docker compose -f docker-compose.full.yml logs -f admin
docker compose -f docker-compose.full.yml logs -f collector

Docker 部署启动

Docker 完整编排包含：

  • PostgreSQL 16
  • Redis 7
  • Go Gin backend
  • React / Ant Design Pro admin（nginx 托管）
  • Node.js / Playwright collector

默认端口可通过 .env 中的变量覆盖：

变量 默认值 说明
ADMIN_PUBLISH_PORT 8000 管理端宿主机端口
BACKEND_PUBLISH_PORT 8080 后端 API 宿主机端口
COLLECTOR_PUBLISH_PORT 3001 Collector 宿主机端口
POSTGRES_PUBLISH_PORT 5432 PostgreSQL 宿主机端口
REDIS_PUBLISH_PORT 6379 Redis 宿主机端口

生产或公网部署前，请务必修改 .env 中的 JWT_SECRET、APP_MASTER_KEY、ADMIN_BOOTSTRAP_PASSWORD、数据库密码等敏感配置。

1688 采集浏览器登录态目录：docker-compose.full.yml 将 ./data/browser-profiles 与 ./data/storage-states 挂载到 collector 容器，用于持久化 Playwright 登录 Cookie（含 Login Data、Cookies、History、 Local Storage、Session Storage 等 Chromium 用户数据）。这些目录仅应存在于宿主机或数据卷中，不得提交到 Git；本地开发时 collector/data/browser-profiles/ 同理已被 .gitignore 忽略。

自定义链接采集与登录状态

  1. 公开商品页：先创建 采集规则，测试标题、价格、图片能识别后再开始采集。
  2. 需要登录的商品页：在管理端创建 采集浏览器登录状态（按适用网站），点击 打开浏览器去登录 自行登录。
  3. 登录后点击 重新检测登录状态，再测试规则或提交采集任务。
  4. 系统 不保存账号密码，不自动破解验证码；登录信息仅保存在本机采集浏览器中。
  5. 请勿在公共电脑保留登录状态；Docker 无头环境无法弹出登录窗口，本地开发请开启采集浏览器的可视化模式（见 docs/env.md 中 COLLECTOR_HEADLESS）。

术语说明（面向用户）

  • 采集规则：告诉系统从网页哪里读取商品标题、图片、价格等内容。
  • 页面位置：开发者常说的 selector；普通用户无需手写，推荐用「AI 帮我生成规则」。
  • 登录状态：商品页需登录时，可在采集浏览器中手动登录，系统不保存账号密码。

更多说明见 docs/docker-deployment.md、docs/custom-collect-rules.md。

拼多多采集器

适合从 拼多多批发详情页（pifa.pinduoduo.com/goods/detail/?gid=）采集商品草稿。移动端商品页（mobile.yangkeduo.com）当前会提示换用批发链接。

  1. 启动采集服务：本地执行 pnpm dev:collector（或 Docker 完整栈中的 collector 服务）；管理端 设置 → 采集设置 确认采集服务地址可达。
  2. 登录拼多多：打开 设置 → 采集设置 → 拼多多，点击 打开拼多多采集浏览器登录，在弹出窗口中完成拼多多 / 微信扫码登录；可填写一条 用于检测的商品链接 后点 重新检测。
  3. 单链接采集：在 采集中心 选择拼多多采集器，粘贴批发商品详情链接并提交；采集完成后在 商品草稿 中检查标题、价格、主图、规格与库存。
  4. 批量采集：在 采集 → 批量采集 选择拼多多（默认 并发 1、任务间隔 4–9 秒随机）；建议先少量测试。可在采集设置中调整并发、间隔与重试策略。
  5. 发布前检查：主图缺失、价格无效、SKU 缺价等会在 发布前检查 拦截；详情图/参数/库存识别不全通常为 警告，可人工补全后发布。

常见失败原因

情况 处理建议
需要登录 打开拼多多采集浏览器登录后重试
需要微信授权 在采集浏览器中完成微信扫码
页面需要验证 在浏览器中手动完成验证后重试
App 引导页 / 非商品详情链接 换用 pifa.pinduoduo.com/goods/detail/?gid= 链接
商品下架 确认链接是否有效

安全说明：系统 不保存账号密码，不破解验证码，不绕过风控；登录态仅保存在本机采集浏览器 Profile 中。

淘宝/天猫采集器（已可用）

适合从 淘宝 / 天猫商品详情页 采集商品草稿。支持域名：

  • item.taobao.com
  • detail.tmall.com / detail.tmall.hk
  • world.taobao.com
  • chaoshi.tmall.com
  • ju.taobao.com

店铺页、搜索页等非标准详情链接会提示 UNSUPPORTED_TAOBAO_URL，请复制商品详情页链接后重试。

  1. 启动采集服务：本地执行 pnpm dev:collector；管理端 设置 → 采集服务 → 淘宝/天猫 配置超时、重试、详情图等待、SKU 点击采集、批量限速 等。
  2. 登录（如需要）：点击 打开淘宝/天猫采集浏览器（独立登录浏览器，不与 1688/拼多多混用），完成登录或安全验证后点 重新检测。
  3. 单链接采集：在 采集中心 选择淘宝/天猫采集器（状态 已可用），粘贴商品详情链接并提交。
  4. 批量采集：采集中心 → 批量采集，或进入 批量采集 页选择淘宝/天猫；每行一条链接，建议每批不超过 20 条；系统会逐条打开商品页，低并发执行。
  5. 核对草稿：商品详情页顶部会提示采集风险；价格/规格/详情图不完整时会有 warning，发布前检查会拦截缺价/缺主图。
  6. 同步图片（可选）：商品草稿 图片管理 可将外链主图/详情图同步到当前存储设置（本地/COS/OSS/S3/R2/MinIO）。
常见问题 建议操作
需要登录 打开淘宝/天猫采集浏览器登录后重试
需要验证 在采集浏览器中手动完成滑块/验证码（系统不绕过验证）
批量部分失败 查看批次详情或失败任务中心，逐条重试
商品下架 检查链接是否有效
主图为空 任务失败，请确认页面加载完整后重试
价格缺失 草稿可创建，发布前须手动填写价格
规格/详情图不完整 草稿可创建，发布前人工复核

验收清单见 docs/collector-taobao-tmall-test-links.md。自定义链接采集器 不会 处理上述域名（会提示使用专用采集器）。

AI 帮我生成采集规则

适合不会手写规则的新用户：

  1. 先在 设置 → AI 设置 配置大模型并通过 测试 AI。
  2. 打开 采集 → 采集规则，点击 AI 帮我生成规则（或在自定义链接采集弹窗中触发）。
  3. 输入 商品链接，勾选要采集的内容（商品标题、价格、主图、详情图片、商品参数；商品规格为高级可选项）。
  4. 系统先读取页面上的商品信息，再让 AI 生成采集规则，并自动测试识别效果。
  5. 确认无误后 保存采集规则；高级用户可在「采集规则内容（高级）」中微调。
  6. 商品规格、库存、实时价格 常由网站动态加载，不一定都能自动识别。
  7. 已有 1688 / 速卖通 等专用采集器的链接会提示优先使用专用采集器。

管理员可在 采集设置 → 自定义链接 中开关「启用 AI 帮我生成规则」等功能（对应配置项见 docs/env.md）。

本地开发启动

本地开发需要：

  • Node.js
  • pnpm 9.15+
  • Go 1.22+
  • Docker / Docker Compose

开发基础设施：

pnpm dev:infra

分服务启动：

pnpm dev:backend
pnpm dev:admin
pnpm dev:collector

Collector 浏览器依赖：

pnpm install:collector:browsers

更多说明见 docs/development.md。

环境变量说明

本仓库提供两份环境变量模板：

文件 用途
.env.example 本地开发环境变量示例
.env.docker.example Docker 完整部署环境变量示例

关键变量：

变量 默认 / 示例 说明
APP_HTTP_ADDR :8080 backend 监听地址
DB_DRIVER postgres 默认 PostgreSQL，MySQL 仅作为可选兼容
DB_PORT 5432 PostgreSQL 默认端口
REDIS_ADDR 127.0.0.1:6379 Redis 地址
COLLECTOR_BASE_URL http://127.0.0.1:3100 本地 backend 访问 Collector 的地址
COLLECTOR_HTTP_ADDR :3100 本地 Collector 监听地址
JWT_SECRET change-me-in-production JWT 密钥，生产必须修改
APP_MASTER_KEY 空 / 示例密钥 AES-GCM 配置加密主密钥，生产必须设置
ADMIN_BOOTSTRAP_EMAIL 空 / 示例账号 首个管理员邮箱
ADMIN_BOOTSTRAP_PASSWORD 空 / 示例密码 首个管理员密码，生产必须修改

敏感信息不要提交到仓库。AI Key、存储 Secret、平台 App Secret、店铺 Token 等应通过后台配置并加密存储。

AI 文本 Provider（settings.ai）

在管理端 系统设置 → AI 设置 配置（或写入 settings 表）。所有文本 AI（标题优化、描述生成、客服建议、批量 AI）均经后端 AI Gateway 调用，前端不直连模型服务商。api_key 使用 AES-GCM 加密存储，界面脱敏为 ****。

provider 说明 base_url 示例 model 示例
openai OpenAI 官方 Chat Completions https://api.openai.com/v1 gpt-4o-mini
openai_compatible 任意 OpenAI 兼容接口（Ollama 等） 按服务商文档填写 按服务商文档填写
deepseek DeepSeek（第一版：Chat Completions） https://api.deepseek.com/v1 deepseek-chat
qwen 通义千问 DashScope OpenAI 兼容模式 https://dashscope.aliyuncs.com/compatible-mode/v1 qwen-plus

示例（勿将真实 Key 提交到仓库）：

# DeepSeek
provider: deepseek
base_url: https://api.deepseek.com/v1
model: deepseek-chat
api_key: <你的 DeepSeek API Key>

# 通义千问 / Qwen
provider: qwen
base_url: https://dashscope.aliyuncs.com/compatible-mode/v1
model: qwen-plus
api_key: <你的 DashScope API Key>

base_url 为接口根路径，不含 /chat/completions。具体地址与模型名以服务商官方控制台为准。生产环境建议保存配置后执行 测试连接（POST /api/v1/settings/test-ai）。

图片 AI 配置（settings.image）

在管理端 系统设置 → 图片 AI 设置 配置。所有图片任务经后端 image_tasks + Image Worker 执行，前端不直连任何图像服务商。api_key 等敏感项 AES-GCM 加密存储，界面脱敏为 ****；平台不会内置任何第三方密钥，需自行到服务商控制台申请。

Provider 说明 典型能力
noop 占位 / 演示 联调
removebg remove.bg 去背景 商品白底图
openai_image OpenAI Images 场景图、替换背景
comfyui 本地 ComfyUI 工作流（需自部署） 场景图、替换背景
dashscope_image 通义万相（DashScope） 场景图
volcengine_image 火山方舟 Ark 图像 场景图
siliconflow_image 硅基流动图像（beta） 场景图
hunyuan_image 腾讯混元（预留，暂不可真实调用） 后续版本

图片文字翻译（OCR 与局部擦除）配置

在 系统设置 → 图片 AI 设置 的下方，可以配置 OCR 与局部擦除：

  • OCR 服务：支持 ai_vision（AI 视觉大模型）、paddleocr（本地推荐）、aliyun（阿里云 OCR）、tencent（腾讯云 OCR）。百度 OCR 暂不显示，完整实现后再上线。
  • PaddleOCR 配置：选择 paddleocr 后，需填写本地部署的 OCR 服务地址（如 http://127.0.0.1:3101）。
  • 腾讯云 OCR 配置：选择 tencent 后填写 Endpoint、Region、SecretId、SecretKey、接口类型、超时与最低置信度。SecretKey 只在后端加密保存，前端仅脱敏展示。
  • 严格 OCR 模式：图片文字翻译必须先完成 OCR 配置并通过真实调用测试。系统不会自动降级或偷偷切换 OCR；选择阿里云 OCR 就真实使用阿里云，选择腾讯云 OCR 就真实使用腾讯云，选择 PaddleOCR 就真实使用本地服务，选择 AI 视觉 OCR 才会调用视觉模型。
  • 局部擦除方式：支持 auto、precise_mask（默认优先，精细擦字）、background_sample、blur_fill、opencv_inpaint、ai_inpaint。
  • ComfyUI 局部擦除：若选择 ai_inpaint，可配置专用的 ComfyUI 地址与工作流 JSON（支持 {{sourceImageUrl}} 与 {{maskImageUrl}} 变量）。
腾讯云 OCR 配置教程
  1. 在腾讯云控制台搜索并开通 文字识别 OCR 服务，确认账号未欠费且有可用资源包或按量计费额度。
  2. 在 访问管理 CAM → API 密钥管理 创建 SecretId / SecretKey，并为当前账号或子用户授予 OCR 调用权限。
  3. 在 设置 → 图片 AI 设置 → OCR 配置 选择 腾讯云 OCR。
  4. Endpoint 默认填写 ocr.tencentcloudapi.com，Region 默认填写 ap-guangzhou。
  5. 接口类型默认选择 GeneralBasicOCR（通用印刷体识别）；需要更高吞吐时可选择 GeneralFastOCR，但建议配合较低并发与请求间隔使用。
  6. 保存后点击 真实测试 OCR 调用。测试会真实调用当前 OCR Provider，成功后会提示识别文字数量与平均置信度。
  7. 图片文字翻译任务会读取该配置；腾讯云 OCR 成功后转换为统一 OCR blocks，后续翻译、擦除、排版和渲染继续走统一链路。若 OCR 未配置、测试未通过、调用失败或未识别到文字，任务会停止并提示修复 OCR 配置。

腾讯云 OCR 常见失败原因：服务未开通、CAM 权限不足、SecretId / SecretKey 无效、账号欠费、资源包耗尽、图片 URL 无法公网访问、调用频率过高、图片未检测到文字。

小白推荐配置

  • 文本 AI：通义千问 / DeepSeek / OpenAI Compatible
  • 图片 AI：通义万相 / OpenAI Image
  • OCR：PaddleOCR
  • 存储：本地磁盘或腾讯云 COS

未配置时的处理策略

  • OCR 未配置或测试未通过：图片文字翻译不会执行。请先到 设置 → 图片 AI 设置 选择 AI 视觉 OCR、本地 PaddleOCR、阿里云 OCR 或腾讯云 OCR，并通过真实 OCR 调用测试。

  • 不自动降级 OCR：为了保证文字坐标准确、避免原文残留、避免中英文重叠并提升商用可用性，系统不会把失败的云 OCR 自动切换为 AI 视觉 OCR。

  • 局部擦除未配置：若选择了 ai_inpaint 但未配置 ComfyUI，将自动降级使用程序擦除方式（优先 precise_mask，再按质量重试 blur_fill / opencv_inpaint）。

  • 图片服务未配置：图片任务将提示“图片处理服务未配置，请先到「设置 → 图片 AI 设置」选择图片处理服务”。

  • 存储未配置：图片任务将提示“图片存储未配置，请先到「设置 → 存储设置」配置图片保存位置”。

  • 能力矩阵：GET /api/v1/image/providers（不含密钥）

  • 配置测试：POST /api/v1/settings/test-image（默认 config_only，不产生图片费用）

  • live 测试与真实图片生成可能产生费用；ComfyUI 需自行部署可访问实例

项目结构

trademind-ai/
├── .github/                 # GitHub 配置：CI、Issue / PR 模板、CODEOWNERS、Dependabot、Labeler
├── .cursor/rules/           # Cursor / AI Agent 持久规则
├── backend/                 # Go + Gin + GORM 主业务服务
├── admin/                   # React + TypeScript + Ant Design Pro 管理后台
├── collector/               # Node.js + TypeScript + Playwright 采集服务
├── docs/                    # 项目文档、API 契约、环境变量、Provider 模板、AI 协作规则
├── scripts/                 # 本地开发编排脚本
├── data/uploads/            # 本地上传目录
├── docker-compose.yml       # 本地开发基础设施：PostgreSQL + Redis
├── docker-compose.full.yml  # 完整 Docker 部署编排
├── .env.example             # 本地开发环境变量模板
├── .env.docker.example      # Docker 部署环境变量模板
├── AGENTS.md                # 通用 AI Agent 协作入口
├── CHANGELOG.md             # 版本与重要变更记录
├── README.md                # 中文 README
├── README.en.md             # 英文 README
├── CONTRIBUTING.md          # 贡献指南
└── LICENSE                  # Apache-2.0 License

技术架构

React + Ant Design Pro Admin
        ↓
Go Gin API
        ↓
PostgreSQL + Redis
        ↓
Node Playwright Collector

Provider 扩展架构：

Go Gin API
├── AI Provider
│   ├── OpenAI / OpenAI-compatible
│   ├── DeepSeek / Qwen（Chat Completions，共享 compatclient）
│   ├── Doubao / Gemini / Claude / Ollama 等（可经 openai_compatible 接入）
│   └── Prompt 模板与调用记录
├── Storage Provider
│   ├── local
│   ├── S3 / R2 / MinIO
│   ├── Tencent COS
│   └── Aliyun OSS
├── Image Provider
│   ├── remove.bg
│   ├── OpenAI Image
│   └── ComfyUI
├── Platform Provider
│   ├── Douyin Shop（抖店，下一阶段真实平台优先）
│   ├── TikTok Shop
│   ├── Shopee
│   ├── Lazada
│   └── Amazon
└── Collector Provider
    ├── 1688
    ├── AliExpress
    └── custom rules

详细设计见 docs/architecture.md 与 docs/provider.md。

当前开发优先级

  1. 第一优先级：AI 商品运营工具
    • 商品采集、商品草稿、AI 标题、AI 描述、图片管理、AI 图片处理、批量 AI 操作。
  2. 第二优先级：多平台跨境 ERP MVP
    • 先把抖店真实平台闭环跑通：店铺授权、类目属性缓存、商品字段映射与刊登草稿预览、图片上传、平台商品草稿创建、订单同步 MVP、库存同步 MVP 已完成；下一阶段进入直接上架 / SKU 校准增强；TikTok Shop / Shopee / Lazada / Amazon 作为后续平台接入，不多平台并行铺开。
  3. 后续迭代：完整 ERP 增强
    • 多仓、采购、复杂售后退款、复杂财务结算、WMS / OMS、复杂 BI、自动补货、自动直接上架等能力后置。

路线图 Roadmap

版本 重点 状态
v0.1.0 项目地基、登录、配置中心、本地存储、Docker 已完成 / 持续完善
v0.2.0 AI 文本能力、Prompt 模板、标题与描述生成 已支持
v0.3.0 商品草稿、SKU、图片管理、AI 结果应用 已支持
v0.4.0 采集服务、采集任务、1688 / 自定义规则 已支持
v0.5.0 AI 图片任务、remove.bg / OpenAI Image / ComfyUI 开发中
v0.6.0 店铺授权、平台配置、订单同步、刊登 / 库存 开发中
v0.7.0 AI 客服建议、平台消息同步、人工确认外发 开发中
v1.0.0 开源稳定版、完整文档、可部署与可扩展生态 规划中

详细路线图见 docs/roadmap.md。

文档导航

完整文档入口见 docs/README.md。

分类 文档
快速开始 本地开发 · Docker 部署 · 环境变量
架构扩展 架构设计 · API 契约 · Provider 扩展 · 路线图
协作规范 贡献指南 · AI Agent 规则 · AI 工作流 · 分支规则 · AI 编程规则 · 模块关联索引
社区治理 安全策略 · 行为准则 · 赞助支持 · NOTICE
多语言 English README

合作商展示

合作商 方向 状态
Coming soon AI / 平台 / 存储 / 采集 / 运营服务 预留

贡献榜

贡献者 贡献方向 链接
Coming soon Code / Docs / Provider / Prompt / Docker -

赞助榜

赞助者 支持方式 链接
Coming soon WeChat / Alipay / GitHub Sponsor -

开源使用规范

本项目基于 Apache-2.0 协议开源。你可以自由学习、使用、修改、二次开发和商业化使用，但必须遵守以下要求：

  1. 保留原始 LICENSE 文件。
  2. 在二次开发项目的 README、文档或关于页面中注明本项目来源。
  3. 明确标注原项目地址。
  4. 不得移除代码文件中的版权声明。
  5. 如果你修改了源码，建议在文档中说明主要修改内容。

原项目地址：

https://github.com/lien0219/trademind-ai

贡献指南

欢迎任何形式的贡献：

  • 提交 Bug
  • 提交功能建议
  • 改进文档
  • 接入新的 AI Provider
  • 接入新的 Storage Provider
  • 接入新的跨境平台 Provider
  • 优化采集规则
  • 优化 Prompt 模板
  • 完善 Docker 部署

请先阅读 CONTRIBUTING.md。如果你不确定某个方向是否适合当前阶段，可以先提交 Issue 讨论。

赞助支持

如果这个项目对你有帮助，欢迎通过以下方式支持：

  • Star 本项目
  • Fork 并参与贡献
  • 提交 Issue / PR
  • 分享给更多跨境电商卖家或开发者
  • 赞助项目持续维护

微信 / 支付宝赞助二维码见 docs/sponsor.md。

License

本项目采用 Apache License 2.0 开源协议。

致谢

感谢所有关注、使用和贡献 TradeMind 的朋友。也感谢 Go、Gin、GORM、PostgreSQL、Redis、React、Ant Design Pro、TypeScript、Playwright 及开源 AI 生态提供的基础能力。

如果你觉得 TradeMind 有价值，欢迎 Star、Fork、提交 Issue 或 PR，一起把它建设成更好用的开源 AI 跨境电商运营平台。

Yorumlar (0)

Sonuc bulunamadi