investment-simulator/README.md

比特币马丁格尔策略回测模拟器

一个基于 Vue 3 + TypeScript 开发的加密货币投资策略回测工具，专门用于模拟马丁格尔（Martingale）策略在比特币合约交易中的表现。

🚀 功能特色

• 实时K线图显示：支持自定义时间周期的K线图展示
• 马丁格尔策略模拟：完整实现马丁格尔加仓策略算法
• 合约交易支持：支持3倍杠杆合约交易模拟
• 风险管理：包含强平机制和维持保证金计算
• 详细数据统计：总资产、收益率、完成周期、爆仓次数等指标
• 历史数据导入：支持CSV格式的历史价格数据导入
• 收益对比图表：策略收益vs基准收益的可视化对比

📊 策略参数

• 杠杆倍数：3倍
• 跌幅加仓：价格下跌1.87%时加仓
• 止盈目标：单周期止盈3%
• 最大加仓：最多6次加仓
• 初始比例：1/1.32
• 资金管理：单周期最大投入为账户余额的44%

🛠 技术栈

• 前端框架：Vue 3 (Composition API)
• 开发语言：TypeScript
• 构建工具：Vite
• 图表库：ECharts
• 样式预处理：SCSS
• 数据处理：PapaParse (CSV解析)

📦 安装与运行

环境要求

• Node.js 18+
• npm 或 yarn 或 bun

安装依赖

# 使用 npm
npm install

# 使用 yarn  
yarn install

# 使用 bun
bun install

开发模式运行

# 使用 npm
npm run dev

# 使用 yarn
yarn dev

# 使用 bun
bun run dev

构建生产版本

# 使用 npm
npm run build

# 使用 yarn
yarn build

# 使用 bun
bun run build

📋 使用说明

1. 准备数据：准备CSV格式的比特币历史价格数据，包含时间、开盘价、最高价、最低价、收盘价、成交量等字段

2. 上传文件：在页面中点击"选择CSV文件"按钮，上传历史数据文件

3. 开始模拟：文件上传后会自动开始回测模拟，实时显示交易过程

4. 查看结果：

   • 实时K线图显示价格走势和交易订单
   • 下方信息面板显示关键指标
   • 模拟完成后显示收益对比图表

5. 暂停/继续：点击顶部标题可以暂停或继续模拟

📁 项目结构

src/
├── components/           # Vue组件
│   ├── KLineChart.vue   # K线图组件
│   ├── CashChart.vue    # 收益对比图组件
│   └── ...
├── martingale.ts        # 马丁格尔策略核心算法
├── analysis.ts          # 数据分析工具
├── App.vue             # 主应用组件
├── main.ts             # 应用入口
└── style.css           # 全局样式

⚠️ 风险提示

• 本项目仅用于教育和研究目的，展示马丁格尔策略的运作机制
• 不构成任何投资建议，实际交易存在重大风险
• 马丁格尔策略在极端市场条件下可能导致重大损失
• 参与加密货币交易时，请遵守当地法律法规

📊 数据指标说明

• 总资产：当前账户总价值（现金+持仓市值）
• 总收益：相对于初始资金的收益金额
• 收益率：收益占初始资金的百分比
• 浮动收益：当前持仓的未实现盈亏
• 已完成周期：完成止盈或强平的交易周期数
• 已爆仓次数：触发强平的次数