|
| 1 | +--- |
| 2 | +name: pumpstrategy-migration |
| 3 | +overview: 将 Agent Trade 项目迁移到 pumpstrategy.io 域名,包括品牌替换、Logo 设计、域名配置更新,并输出前端技术文档。 |
| 4 | +todos: |
| 5 | + - id: explore-brand-refs |
| 6 | + content: 使用 [subagent:code-explorer] 搜索项目中所有品牌相关引用 |
| 7 | + status: completed |
| 8 | + - id: design-logo |
| 9 | + content: 设计 PumpStrategy 新 Logo(简约干练风格,体现 AI 交易策略) |
| 10 | + status: completed |
| 11 | + - id: replace-brand |
| 12 | + content: 执行品牌替换:名称、Logo、Favicon 等资源 |
| 13 | + status: completed |
| 14 | + dependencies: |
| 15 | + - explore-brand-refs |
| 16 | + - design-logo |
| 17 | + - id: update-domain-config |
| 18 | + content: 更新域名配置:环境变量、API 端点、Vercel 配置 |
| 19 | + status: completed |
| 20 | + dependencies: |
| 21 | + - explore-brand-refs |
| 22 | + - id: generate-tech-doc |
| 23 | + content: 输出前端技术文档:技术栈、部署、页面结构 |
| 24 | + status: completed |
| 25 | + dependencies: |
| 26 | + - replace-brand |
| 27 | + - update-domain-config |
| 28 | + - id: create-migration-log |
| 29 | + content: 创建迁移记录文档:记录所有操作步骤和变更内容 |
| 30 | + status: completed |
| 31 | + dependencies: |
| 32 | + - replace-brand |
| 33 | + - update-domain-config |
| 34 | +--- |
| 35 | + |
| 36 | +## 产品概述 |
| 37 | + |
| 38 | +将 Agent Trade 项目迁移到 pumpstrategy.io 域名,完成品牌重塑、Logo 设计、域名配置更新,并输出完整的前端技术文档。 |
| 39 | + |
| 40 | +## 核心功能 |
| 41 | + |
| 42 | +- 品牌替换:将所有 "Agent Trade" / "Monnaire" 相关品牌名称替换为 "PumpStrategy" |
| 43 | +- Logo 设计:设计简约干练的新 Logo,体现 AI 交易策略平台定位 |
| 44 | +- 域名配置更新:将前端域名从 agentrade.xyz 迁移到 pumpstrategy.io |
| 45 | +- 技术文档输出:输出前端技术栈、部署服务器、页面结构等完整文档 |
| 46 | +- 操作记录:记录所有替换操作并写入迁移文档 |
| 47 | + |
| 48 | +## 技术栈 |
| 49 | + |
| 50 | +- 前端框架:Vite + React + TypeScript |
| 51 | +- 样式方案:Tailwind CSS |
| 52 | +- 部署平台:前端 Vercel,后端 Replit |
| 53 | +- 当前后端域名:nofx-gyc567.replit.app |
| 54 | + |
| 55 | +## 技术架构 |
| 56 | + |
| 57 | +### 系统架构 |
| 58 | + |
| 59 | +```mermaid |
| 60 | +flowchart TB |
| 61 | + subgraph Frontend["前端 (Vercel)"] |
| 62 | + A[React App] --> B[Vite Build] |
| 63 | + B --> C[Static Assets] |
| 64 | + end |
| 65 | + |
| 66 | + subgraph Backend["后端 (Replit)"] |
| 67 | + D[API Server] |
| 68 | + end |
| 69 | + |
| 70 | + subgraph Domain["域名配置"] |
| 71 | + E[pumpstrategy.io] --> Frontend |
| 72 | + F[nofx-gyc567.replit.app] --> Backend |
| 73 | + end |
| 74 | + |
| 75 | + Frontend <--> Backend |
| 76 | +``` |
| 77 | + |
| 78 | +### 模块划分 |
| 79 | + |
| 80 | +- **品牌资源模块**:Logo、Favicon、品牌名称、品牌色彩 |
| 81 | +- **配置模块**:环境变量、API 端点、域名配置 |
| 82 | +- **页面模块**:各页面组件中的品牌引用 |
| 83 | +- **文档模块**:技术文档、迁移记录 |
| 84 | + |
| 85 | +### 数据流 |
| 86 | + |
| 87 | +用户访问 pumpstrategy.io → Vercel 托管的静态资源 → React 应用加载 → API 请求到 Replit 后端 |
| 88 | + |
| 89 | +## 实施细节 |
| 90 | + |
| 91 | +### 核心目录结构(需修改的文件) |
| 92 | + |
| 93 | +``` |
| 94 | +agentrade/ |
| 95 | +├── public/ |
| 96 | +│ ├── Monnaire_Logo.svg # 需替换为新 Logo |
| 97 | +│ └── favicon.ico # 需更新 Favicon |
| 98 | +├── src/ |
| 99 | +│ ├── assets/ |
| 100 | +│ │ └── logo/ # Logo 资源目录 |
| 101 | +│ ├── components/ |
| 102 | +│ │ └── Header/ # 包含 Logo 引用的组件 |
| 103 | +│ └── config/ |
| 104 | +│ └── constants.ts # 品牌名称、域名常量 |
| 105 | +├── index.html # 标题、meta 信息 |
| 106 | +├── vercel.json # Vercel 部署配置 |
| 107 | +├── .env # 环境变量 |
| 108 | +└── docs/ |
| 109 | + └── migration-log.md # 迁移记录文档(新建) |
| 110 | +``` |
| 111 | + |
| 112 | +### 关键代码结构 |
| 113 | + |
| 114 | +**品牌常量定义**:集中管理品牌相关常量,便于统一替换 |
| 115 | + |
| 116 | +```typescript |
| 117 | +// src/config/constants.ts |
| 118 | +export const BRAND = { |
| 119 | + name: 'PumpStrategy', |
| 120 | + domain: 'pumpstrategy.io', |
| 121 | + tagline: 'AI Trading Strategy Platform', |
| 122 | + logo: '/pumpstrategy-logo.svg' |
| 123 | +} |
| 124 | +``` |
| 125 | + |
| 126 | +**Logo 组件接口**:统一 Logo 组件调用方式 |
| 127 | + |
| 128 | +```typescript |
| 129 | +// Logo 组件 Props |
| 130 | +interface LogoProps { |
| 131 | + size?: 'sm' | 'md' | 'lg'; |
| 132 | + variant?: 'full' | 'icon'; |
| 133 | + className?: string; |
| 134 | +} |
| 135 | +``` |
| 136 | + |
| 137 | +### 技术实施计划 |
| 138 | + |
| 139 | +1. **品牌资源替换** |
| 140 | + |
| 141 | +- 问题:需要替换所有品牌相关资源 |
| 142 | +- 方案:使用全局搜索定位所有引用点,统一替换 |
| 143 | +- 技术:grep/ripgrep 搜索,批量替换 |
| 144 | +- 步骤:搜索 → 记录 → 替换 → 验证 |
| 145 | +- 测试:本地运行验证所有页面显示正确 |
| 146 | + |
| 147 | +2. **Logo 设计与集成** |
| 148 | + |
| 149 | +- 问题:需要设计符合 AI 交易策略平台定位的 Logo |
| 150 | +- 方案:设计简约干练的 SVG Logo |
| 151 | +- 技术:SVG 格式,支持多尺寸适配 |
| 152 | +- 步骤:设计 → 导出 SVG → 集成到项目 → 更新引用 |
| 153 | +- 测试:验证各页面 Logo 显示效果 |
| 154 | + |
| 155 | +3. **域名配置更新** |
| 156 | + |
| 157 | +- 问题:需要更新所有域名引用 |
| 158 | +- 方案:更新环境变量和配置文件 |
| 159 | +- 技术:Vercel 域名绑定,环境变量配置 |
| 160 | +- 步骤:更新配置 → 更新 Vercel 设置 → DNS 配置 |
| 161 | +- 测试:验证域名解析和 HTTPS 证书 |
| 162 | + |
| 163 | +### 集成点 |
| 164 | + |
| 165 | +- Vercel 部署:更新域名绑定配置 |
| 166 | +- DNS 配置:pumpstrategy.io 指向 Vercel |
| 167 | +- API 端点:确保后端 CORS 配置支持新域名 |
| 168 | + |
| 169 | +## Agent Extensions |
| 170 | + |
| 171 | +### SubAgent |
| 172 | + |
| 173 | +- **code-explorer** |
| 174 | +- 用途:全面搜索项目中所有品牌相关引用(Agent Trade、Monnaire、agentrade.xyz 等) |
| 175 | +- 预期结果:输出所有需要替换的文件列表和具体位置,确保无遗漏 |
| 176 | + |
| 177 | +### MCP |
| 178 | + |
| 179 | +- **kuikly-mcp** |
| 180 | +- 用途:咨询 Logo 设计建议和 AI 交易策略平台的视觉风格方向 |
| 181 | +- 预期结果:获取专业的设计建议,指导 Logo 设计方向 |
0 commit comments