使用说明

整体架构

技术栈

核心模块

• 认证模块 (auth.js)：用户登录、注册、会话管理
• 分析模块 (analysis.js)：股票数据分析、评分计算
• 图表模块 (chart.js)：可视化图表渲染
• UI模块 (ui.js)：界面交互、DOM操作
• API客户端 (api-client.js)：封装API调用

1. 圣手抓龙模块 (dragon-hunter.js)

功能：自动筛选符合龙头特征的强势股票

核心算法：

function identifyDragonStocks(stocks) {
    return stocks.filter(stock => {
        return stock.score >= 70 &&
               stock.change5d >= 3 &&
               stock.volumeRatio >= 1.2 &&
               stock.mainCapital > 0 &&
               stock.bullishRatio >= 0.5;
    }).sort((a, b) => b.score - a.score);
}

2. 技术指标分析模块 (technical-indicators.js)

功能：计算13个技术指标并进行AI智能分析

关键方法：

• calculateDetailedTechnicalIndicators() - 计算13个技术指标
• recognizePattern() - 识别10种经典技术形态
• getMarketSentimentInfo() - 计算市场情绪指标
• requestAiAnalysis() - 调用AI API进行智能分析

3. 中线交易分析模块 (midterm-analysis.js)

功能：多周期MACD分析，给出波段操作建议

MACD参数配置：

const MACD_CONFIGS = {
    longTerm: { fast: 20, slow: 42, signal: 120 },
    midTerm: { fast: 9, slow: 19, signal: 7 },
    shortTerm: { fast: 7, slow: 15, signal: 6 },
    basePower: { fast: 10, slow: 20, signal: 7 },
    confirmation: { fast: 13, slow: 21, signal: 8 }
};

4. 收藏管理模块 (favorites.js)

功能：保存和管理用户收藏的股票列表

存储方式：localStorage + 服务器数据库双重存储

股票分析流程

1. 用户输入股票代码/名称
   ↓
2. 调用麦瑞API匹配股票信息
   ├─ /api/stock/match （股票匹配）
   ├─ /api/stock/finance （财务数据）
   └─ /api/stock/kline （K线数据）
   ↓
3. 前端计算技术指标
   ├─ MACD、KDJ、RSI等13个指标
   ├─ 技术形态识别（10种形态）
   ├─ 主力资金分析
   └─ 市场情绪计算
   ↓
4. 综合评分计算
   ├─ 基本面评分（30%）
   ├─ 技术面评分（30%）
   ├─ 资金面评分（20%）
   └─ 情绪面评分（20%）
   ↓
5. 生成投资建议
   ├─ 强烈建议建仓
   ├─ 建议建仓
   ├─ 观望等待
   ├─ 建议减仓
   └─ 建议清仓
   ↓
6. AI智能分析（可选）
   └─ 调用阿里百炼API生成详细分析报告

AI分析流程

1. 收集多维度数据
   ├─ 当前股价、涨跌幅、估值（PE/PB）
   ├─ 13个技术指标状态
   ├─ 主力资金流向（超大单、大单、控盘度）
   ├─ 技术形态（10种经典形态）
   ├─ 市场情绪（涨跌比、涨跌停、成交额）
   ├─ 所属板块热度
   └─ 价格趋势（5/10/20/30日涨幅）
   ↓
2. 联网搜索最新新闻
   └─ 调用阿里百炼搜索功能获取实时新闻
   ↓
3. 构建AI提示词
   └─ 整合所有数据，生成180-200字分析要求
   ↓
4. 调用AI API
   ├─ 模型：qwen-plus
   ├─ temperature: 0.7
   └─ max_tokens: 500
   ↓
5. 解析AI响应
   ├─ 提取分析文本
   ├─ 计算置信度（1-5星）
   ├─ 计算信号强度（0-100%）
   └─ 展示可视化结果

1. 并发控制

使用信号量（Semaphore）控制API并发请求数量，避免频繁调用导致限流：

const concurrencyLimit = 5;
const semaphore = new Semaphore(concurrencyLimit);

2. 数据缓存

• 股票数据缓存：避免重复获取相同股票数据
• AI分析缓存：10分钟内复用AI分析结果
• 新闻缓存：5分钟内复用新闻数据

3. 懒加载

• 图表可视化：切换到对应标签页时才渲染
• 技术指标：点击详情时才计算完整指标
• AI分析：手动点击按钮触发

后端API接口

外部API接口

数据库概述

股票分析平台使用 MySQL 数据库存储用户信息、配置、持仓记录和收藏股票等数据。数据库设计遵循 ACID 原则，确保数据的一致性和完整性。

核心数据表

安全设计

数据库在设计时充分考虑了安全性：

• 密码安全：用户密码使用 bcrypt 算法进行哈希存储，确保即使数据库泄露也无法直接获取用户密码
• 外键约束：通过外键约束确保数据完整性，如 user_stocks 表中的 user_id 字段关联 users 表
• 记住我功能安全：remember_tokens 表使用随机生成的令牌和过期时间，防止令牌被长期滥用
• 数据类型限制：对字段长度和类型进行严格限制，防止SQL注入等安全风险
• 索引优化：为常用查询字段创建索引，提高查询效率的同时减少数据库负载
• 数据备份：建议定期备份数据库，防止数据丢失
• 访问控制：通过数据库用户权限管理，限制对敏感数据的访问

性能优化

数据库在设计时也考虑了性能优化：

• 索引策略：为经常查询的字段创建索引，如 user_id、stock_code 等
• 数据归档：对于历史持仓记录，可以考虑定期归档以减少主表数据量
• 分区表：对于大量历史数据，可以考虑使用分区表提高查询性能
• 连接池：在应用层使用连接池管理数据库连接，提高并发处理能力

表结构详情

CREATE TABLE `users` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `phone` varchar(20) NOT NULL COMMENT '手机号',
  `username` varchar(50) NOT NULL COMMENT '用户昵称',
  `password_hash` varchar(255) NOT NULL COMMENT '密码哈希',
  `created_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP,
  `updated_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
  `last_login` timestamp NULL DEFAULT NULL COMMENT '最后登录时间',
  `status` enum('active','inactive') DEFAULT 'active' COMMENT '用户状态',
  PRIMARY KEY (`id`),
  UNIQUE KEY `phone` (`phone`)
) ENGINE=InnoDB

CREATE TABLE `user_api_config` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `user_id` int(11) NOT NULL COMMENT '用户ID',
  `stock_api_key` varchar(255) DEFAULT '' COMMENT '股票API密钥',
  `ai_api_key` varchar(255) DEFAULT '' COMMENT 'AI API密钥',
  `created_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
  `updated_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
  `total_capital` decimal(12,2) DEFAULT '20.00' COMMENT '总资金（万元）',
  PRIMARY KEY (`id`),
  UNIQUE KEY `idx_user_id` (`user_id`)
) ENGINE=InnoDB

CREATE TABLE `user_stocks` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `user_id` int(11) NOT NULL COMMENT '用户ID',
  `stock_code` varchar(20) NOT NULL COMMENT '股票代码',
  `stock_name` varchar(100) DEFAULT NULL COMMENT '股票名称',
  `created_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`),
  UNIQUE KEY `unique_user_stock` (`user_id`,`stock_code`),
  CONSTRAINT `user_stocks_ibfk_1` FOREIGN KEY (`user_id`) REFERENCES `users` (`id`) ON DELETE CASCADE
) ENGINE=InnoDB

CREATE TABLE `user_positions` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `user_id` int(11) NOT NULL COMMENT '用户ID',
  `position_type` tinyint(1) NOT NULL COMMENT '仓位类型: 1-长线T仓 2-中线T仓 3-短线T仓 4-T+0仓 5-预备金',
  `stock_code` varchar(10) NOT NULL COMMENT '股票代码',
  `stock_name` varchar(50) NOT NULL COMMENT '股票名称',
  `buy_price` decimal(10,2) NOT NULL COMMENT '买入价格',
  `buy_shares` int(11) NOT NULL COMMENT '买入股数',
  `buy_amount` decimal(12,2) NOT NULL COMMENT '买入金额(万元)',
  `buy_date` date NOT NULL COMMENT '买入日期',
  `current_price` decimal(10,2) DEFAULT NULL COMMENT '当前价格',
  `profit_loss` decimal(12,2) DEFAULT NULL COMMENT '盈亏金额',
  `profit_rate` decimal(8,2) DEFAULT NULL COMMENT '盈亏比例(%)',
  `status` tinyint(1) NOT NULL DEFAULT '1' COMMENT '状态: 1-持仓中 2-已止盈 3-已止损',
  `sell_date` date DEFAULT NULL COMMENT '卖出日期',
  `sell_price` decimal(10,2) DEFAULT NULL COMMENT '卖出价格',
  `notes` text COMMENT '备注',
  `created_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
  `updated_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
  `stock_type` varchar(100) DEFAULT '' COMMENT '股票类型（如：板块龙头、题材股等）',
  PRIMARY KEY (`id`),
  KEY `idx_user_id` (`user_id`),
  KEY `idx_position_type` (`position_type`),
  KEY `idx_stock_code` (`stock_code`),
  KEY `idx_status` (`status`),
  KEY `idx_stock_type` (`stock_type`)
) ENGINE=InnoDB

CREATE TABLE `remember_tokens` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `user_id` int(11) NOT NULL,
  `token` varchar(64) NOT NULL,
  `expires_at` datetime NOT NULL,
  `created_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`),
  UNIQUE KEY `token` (`token`),
  KEY `user_id` (`user_id`),
  KEY `idx_token` (`token`),
  KEY `idx_expires` (`expires_at`),
  CONSTRAINT `remember_tokens_ibfk_1` FOREIGN KEY (`user_id`) REFERENCES `users` (`id`) ON DELETE CASCADE
) ENGINE=InnoDB

安全措施

• 密码加密：使用bcrypt算法
• SQL注入防护：使用PDO预处理语句
• XSS防护：输出时转义特殊字符
• CSRF防护：验证请求来源
• 会话管理：HttpOnly Cookie + Session
• API密钥保护：敏感信息加密存储
• 数据库安全：通过外键约束、数据类型限制和访问控制确保数据安全

性能优化

• 数据库索引：为常用查询字段创建索引，提高查询效率
• 连接池管理：使用连接池管理数据库连接，提高并发处理能力
• 数据缓存：对频繁访问的数据进行缓存，减少数据库查询压力
• 查询优化：使用预编译语句和优化查询逻辑，减少数据库负载