Skip to content

PorunC/valuescan

BranchesTags

Repository files navigation

ValueScan 加密货币交易系统

一个完整的加密货币交易解决方案，包含信号监控和自动化交易两大模块。

📦 项目模块

1. 信号监控模块 (signal_monitor/)

监听 valuescan.io API 并将加密货币告警消息自动发送到 Telegram。

支持有头模式（显示浏览器）和无头模式（后台运行），适用于开发调试和服务器部署。

2. Binance 自动化交易模块 (binance_trader/)

基于信号聚合策略的智能交易系统，在 FOMO + Alpha 信号同时出现时自动执行交易。

  • 🎯 多信号聚合策略（Confluence Trading）
  • 🛡️ 完善的风险管理和仓位控制
  • 📊 自动止损止盈
  • ⚙️ 高度可配置

👉 查看 Binance 交易模块文档

✨ 特性

  • 🔄 自动监听 API 请求并实时推送
  • 📱 支持 Telegram 消息推送
  • 🖥️ 有头模式 - 显示浏览器窗口，方便调试和首次登录
  • 🚀 无头模式 - 后台运行，适合服务器和长期运行
  • 🌍 无头模式自动打开网站并监听
  • 📊 显示 Chrome 进程 ID，便于管理
  • 🔐 自动保持登录状态，共享用户数据
  • 📝 完善的日志系统，支持日志轮转
  • ⚡ 自动去重，避免重复通知

🚀 快速开始

选择你需要的模块

方案 A: 仅使用信号监控

如果你只想接收交易信号通知，使用 signal_monitor/ 模块：

cd signal_monitor
pip install -r requirements.txt
cp config.example.py config.py
# 编辑 config.py 填入 Telegram 配置
python start_with_chrome.py

方案 B: 完整自动化交易系统

如果你想基于信号自动交易，使用两个模块：

# 1. 安装所有依赖
pip install -r requirements.txt
cd binance_trader
pip install -r requirements.txt

# 2. 配置 Binance 交易
cd binance_trader
cp config.example.py config.py
# 编辑 config.py 填入 API Key 等配置

# 3. 运行交易系统
python futures_main.py

👉 详细配置请查看 Binance 交易模块文档

📢 v1.0 重大更新说明

项目重构（2025-10-13）

变化:

  • ✅ 将信号监控代码移到 signal_monitor/ 目录
  • ✅ 新增 Binance 自动化交易模块 binance_trader/
  • ✅ 清理根目录，保持整洁
  • ✅ 完善文档体系

老用户迁移:

如果你之前直接在根目录运行 start_with_chrome.py，现在需要：

# 旧方式（已废弃）
python start_with_chrome.py

# 新方式（推荐）
cd signal_monitor
python start_with_chrome.py

你的配置文件已保留在根目录，可以：

cp config.py signal_monitor/config.py  # 复制配置到新位置

功能完全一致，只是目录结构更清晰！

✨ 信号监控模块快速开始

1. 安装依赖

pip install -r requirements.txt

或手动安装：

pip install DrissionPage requests psutil

2. 配置文件

复制 config.example.py 为 config.py 并填写配置：

# Windows
copy config.example.py config.py

# Linu## 🔗 相关链接

### 外部资源
cp config.example.py config.py

编辑 config.py，填入以下必要信息：

  • TELEGRAM_BOT_TOKEN: Telegram Bot Token（从 @BotFather 获取）
  • TELEGRAM_CHAT_ID: 你的 Telegram 用户 ID（从 @userinfobot 获取）
  • HEADLESS_MODE: 选择运行模式（True=无头模式，False=有头模式）

3. 首次登录（重要）

无论后续使用哪种模式，首次使用都必须用有头模式登录：

# 1. 确保配置文件中 HEADLESS_MODE = False
# 2. 运行启动脚本
python start_with_chrome.py

# 3. 在打开的浏览器中登录 valuescan.io 账号
# 4. 登录成功后，按 Ctrl+C 停止程序

登录状态会自动保存在 chrome-debug-profile 目录中。

4. 日常使用

方式一：通过配置文件控制（推荐）

编辑 config.py：

# 有头模式（显示浏览器）
HEADLESS_MODE = False

# 无头模式（后台运行）
HEADLESS_MODE = True

然后运行：

python start_with_chrome.py

方式二：直接运行主程序

python valuescan.py

📖 运行模式

🖥️ 有头模式（Headed Mode）

适用场景：

  • ✅ 首次登录账号
  • ✅ 调试和测试
  • ✅ 需要查看浏览器状态

特点：

  • 显示浏览器窗口
  • 需要手动在浏览器中操作
  • 占用较多资源

启动方式：

# config.py 中设置
HEADLESS_MODE = False

# 运行
python start_with_chrome.py

🚀 无头模式（Headless Mode）

适用场景：

  • ✅ 服务器后台运行
  • ✅ 长期7×24小时监控
  • ✅ 节省系统资源
  • ✅ VPS/云服务器部署

特点：

  • 不显示浏览器窗口
  • 自动打开 valuescan.io 网站
  • 自动开始监听 API
  • 显示 Chrome 进程 ID
  • 资源占用低（节省 30-50% 内存）

启动方式：

# config.py 中设置
HEADLESS_MODE = True

# 运行
python start_with_chrome.py

无头模式启动流程：

  1. 自动清理现有 Chrome 进程
  2. 启动无头 Chrome 浏览器
  3. 显示进程 ID
  4. 自动打开 valuescan.io
  5. 开始监听 API 请求
  6. 自动捕获和推送消息

📊 模式对比

特性 有头模式 无头模式
显示浏览器窗口 ✅ 是 ❌ 否
资源占用 较高 较低
内存使用 ~300-500 MB ~150-250 MB
可以手动登录 ✅ 是 ❌ 否（需已登录）
适用场景 首次登录、调试 长期后台运行
服务器使用 ⚠️ 需要图形界面 ✅ 完美支持
自动打开网站 ❌ 需手动 ✅ 自动
进程ID显示 ❌ 否 ✅ 是

⚙️ 配置说明

Telegram 配置

  • 获取 Bot Token: 在 Telegram 中找到 @BotFather，发送 /newbot 创建机器人
  • 获取用户 ID: 在 Telegram 中找到 @userinfobot，发送任意消息获取你的 ID
  • 频道推送: 如果要推送到频道，使用频道 ID（-100 开头的数字）

浏览器配置

  • CHROME_DEBUG_PORT: Chrome 调试端口（默认 9222）
  • HEADLESS_MODE: 运行模式（True=无头，False=有头）

日志配置

  • LOG_LEVEL: 日志级别（DEBUG, INFO, WARNING, ERROR, CRITICAL）
  • LOG_TO_FILE: 是否输出到文件
  • LOG_FILE: 日志文件路径
  • LOG_MAX_SIZE: 单个日志文件最大大小（默认 10MB）
  • LOG_BACKUP_COUNT: 保留的历史日志文件数量（默认 5 个）

消息类型

程序支持以下类型的告警消息：

  • 100: 下跌风险
  • 108: 资金异动
  • 109: 上下币公告
  • 110: Alpha
  • 111: 资金出逃
  • 112: FOMO加剧 - FOMO情绪加剧，注意止盈防风险
  • 113: FOMO
  • 114: 资金异常

📁 项目结构

valuescan/
├── signal_monitor/           # 信号监控模块
│   ├── api_monitor.py        # API 监听模块（核心）
│   ├── message_handler.py    # 消息处理模块
│   ├── telegram.py           # Telegram 消息发送模块
│   ├── database.py           # 数据库模块
│   ├── logger.py             # 日志工具模块
│   ├── valuescan.py          # 主程序入口
│   ├── start_with_chrome.py  # 统一启动脚本
│   ├── kill_chrome.py        # Chrome 进程管理
│   ├── config.example.py     # 配置文件模板
│   └── README.md             # 模块文档
│
├── binance_trader/           # Binance 自动化交易模块
│   ├── signal_aggregator.py  # 信号聚合器（核心策略）
│   ├── futures_trader.py     # 合约交易执行器
│   ├── futures_main.py       # 合约主程序入口
│   ├── trailing_stop.py      # 移动止损 / 分批止盈
│   ├── risk_manager.py       # 风险管理器
│   ├── config.example.py     # 配置文件模板
│   ├── requirements.txt      # 依赖包列表
│   └── README.md             # 模块文档（详细）
│
├── README.md                 # 项目总文档（本文件）
├── config.py                 # 配置文件（需自行创建）
├── config.example.py         # 配置文件模板
├── requirements.txt          # 依赖包列表
├── chrome-debug-profile/     # Chrome 用户数据目录
└── valuescan.db              # 数据库文件

🌍 跨平台支持

自动平台适配

ValueScan 已实现完整的跨平台支持，可在 Windows、Linux 和 macOS 上无缝运行：

✅ 自动检测运行平台
✅ 自动查找 Chrome/Chromium 路径
✅ 自动适配系统命令
✅ 自动处理路径分隔符
✅ 统一的配置文件

平台对比

平台 有头模式 无头模式 推荐用途 Chrome 路径
Windows ✅ 完美 ✅ 支持 开发/测试 C:\Program Files\Google\Chrome\
Linux ⚠️ 需要 X11 ✅ 完美 生产部署 /usr/bin/google-chrome
macOS ✅ 完美 ✅ 支持 开发/测试 /Applications/Google Chrome.app

Chrome 自动检测

程序会自动检测以下 Chrome/Chromium 路径：

Windows:

  • C:\Program Files\Google\Chrome\Application\chrome.exe
  • C:\Program Files (x86)\Google\Chrome\Application\chrome.exe
  • %LOCALAPPDATA%\Google\Chrome\Application\chrome.exe

Linux:

  • /usr/bin/google-chrome
  • /usr/bin/chromium-browser
  • /usr/bin/chromium
  • /snap/bin/chromium

macOS:

  • /Applications/Google Chrome.app/Contents/MacOS/Google Chrome
  • /Applications/Chromium.app/Contents/MacOS/Chromium

💡 无需手动配置路径，程序会自动找到第一个可用的 Chrome 安装。

使用示例

相同的代码，任何平台：

# Windows
python start_with_chrome.py

# Linux
python3 start_with_chrome.py

# macOS
python3 start_with_chrome.py

配置文件完全通用，在所有平台上使用相同的 config.py。

🐧 Linux 服务器部署

快速部署步骤

1. 安装系统依赖和 Chromium/Chrome

# Ubuntu/Debian
sudo apt update

# 安装基础工具
sudo apt install -y wget curl unzip git

# 安装 Chromium 浏览器
sudo apt install -y chromium-browser

# 安装 Chrome 所需的系统库
sudo apt install -y \
    fonts-liberation \
    libasound2 \
    libatk-bridge2.0-0 \
    libatk1.0-0 \
    libcups2 \
    libdbus-1-3 \
    libgbm1 \
    libgtk-3-0 \
    libnspr4 \
    libnss3 \
    libxcomposite1 \
    libxdamage1 \
    libxrandr2 \
    xdg-utils

# CentOS/RHEL
sudo yum update -y

# 安装基础工具
sudo yum install -y wget curl unzip git

# 安装 Chromium
sudo yum install -y chromium

# 验证安装
chromium-browser --version
# 或
chromium --version

2. 安装 Python 依赖

# 创建虚拟环境（推荐）
python3 -m venv venv
source venv/bin/activate

# 安装依赖
pip install -r requirements.txt

3. 配置文件

# 复制配置模板
cp config.example.py config.py

# 编辑配置（重要：设置为无头模式）
nano config.py

关键配置：

HEADLESS_MODE = True  # Linux 服务器必须使用无头模式

4. 传输登录状态

从 Windows 传输到 Linux：

# 在 Windows 上先用有头模式登录
python start_with_chrome.py

# 然后传输用户数据目录到 Linux
scp -r chrome-debug-profile user@linux-server:~/valuescan/

5. 启动服务

# 测试运行
python3 start_with_chrome.py

# 后台运行
nohup python3 start_with_chrome.py > output.log 2>&1 &

systemd 服务配置（推荐）

创建服务文件：

sudo nano /etc/systemd/system/valuescan.service

内容：

[Unit]
Description=ValueScan API Monitor
After=network.target

[Service]
Type=simple
User=your_username
WorkingDirectory=/home/your_username/valuescan
Environment="PATH=/home/your_username/valuescan/venv/bin"
ExecStart=/home/your_username/valuescan/venv/bin/python3 start_with_chrome.py
Restart=always
RestartSec=10
StandardOutput=append:/home/your_username/valuescan/output.log
StandardError=append:/home/your_username/valuescan/error.log

[Install]
WantedBy=multi-user.target

启动服务：

# 重载配置
sudo systemctl daemon-reload

# 启用开机自启
sudo systemctl enable valuescan

# 启动服务
sudo systemctl start valuescan

# 查看状态
sudo systemctl status valuescan

# 查看日志
sudo journalctl -u valuescan -f

Linux 常见问题

问题 1: 缺少系统依赖

症状：

error while loading shared libraries: xxx.so

解决方案：

# Ubuntu/Debian - 安装基础工具
sudo apt install -y wget curl unzip git python3 python3-pip python3-venv

# Ubuntu/Debian - 安装 Chrome 运行库
sudo apt install -y \
    fonts-liberation \
    libasound2 \
    libatk-bridge2.0-0 \
    libatk1.0-0 \
    libcups2 \
    libdbus-1-3 \
    libgbm1 \
    libgtk-3-0 \
    libnspr4 \
    libnss3 \
    libxcomposite1 \
    libxdamage1 \
    libxrandr2 \
    xdg-utils

# CentOS/RHEL
sudo yum install -y wget curl unzip git python3 python3-pip \
    liberation-fonts alsa-lib atk cups-libs dbus-libs \
    libdrm libXcomposite libXdamage libXrandr gtk3 nss

问题 2: 显示相关错误

如果遇到 No usable sandbox! 错误：

# 安装虚拟显示
sudo apt install -y xvfb

# 启动虚拟显示
Xvfb :99 -screen 0 1920x1080x24 &
export DISPLAY=:99

程序已添加 --no-sandbox 参数，通常无需额外配置。

问题 3: 内存不足

# 添加 swap
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

# 永久生效
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

迁移检查清单

  • 安装 Chromium/Chrome
  • 安装 Python 3.8+
  • 安装项目依赖 (pip install -r requirements.txt)
  • 复制并配置 config.py（设置 HEADLESS_MODE = True）
  • 传输 chrome-debug-profile 目录
  • 测试运行
  • 配置 systemd 服务
  • 验证日志输出
  • 测试 Telegram 推送

性能对比

环境 内存占用 CPU 占用 适用场景
Windows 有头 ~400MB 5-10% 开发调试
Windows 无头 ~250MB 3-5% 本地后台
Linux 无头 ~200MB 2-4% 服务器部署

💡 建议：Windows 用于开发和首次登录，Linux 用于生产部署。

🔧 高级功能

进程管理

查看 Chrome 进程：

# Windows
tasklist | findstr chrome.exe

# 查看占用的端口
netstat -ano | findstr :9222

手动关闭 Chrome：

python kill_chrome.py

后台运行（Linux/macOS）

# 使用 nohup
nohup python start_with_chrome.py > output.log 2>&1 &

# 查看日志
tail -f valuescan.log

# 停止程序
ps aux | grep python
kill <PID>

使用 systemd（Linux）

创建服务文件 /etc/systemd/system/valuescan.service：

[Unit]
Description=ValueScan API Monitor
After=network.target

[Service]
Type=simple
User=your_username
WorkingDirectory=/path/to/valuescan
ExecStart=/usr/bin/python3 start_with_chrome.py
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

启动服务：

sudo systemctl enable valuescan
sudo systemctl start valuescan
sudo systemctl status valuescan

🧪 测试工具

测试 Telegram 功能

python test_telegram.py

测试日志功能

python test_logger.py

🔍 故障排查

无法启动 Chrome

症状：

错误: 启动浏览器失败

解决方案：

  1. 确保已安装 Chrome 浏览器
  2. 检查端口 9222 是否被占用
  3. 确认有足够的系统权限
  4. 尝试手动运行 python kill_chrome.py 清理进程

无法获取 API 数据

症状：

未捕获到任何请求

解决方案：

  1. 检查是否已登录 valuescan.io 账号
  2. 有头模式：手动在浏览器中访问网站
  3. 无头模式：程序会自动打开网站，等待2-3秒
  4. 检查 API_PATH 配置是否正确
  5. 查看 valuescan.log 了解详细信息

Telegram 消息发送失败

解决方案：

  1. 检查 TELEGRAM_BOT_TOKEN 是否正确
  2. 检查 TELEGRAM_CHAT_ID 是否正确
  3. 确保网络可以访问 api.telegram.org
  4. 运行 python test_telegram.py 测试连接
  5. 检查 Bot 是否被封禁

无头模式登录状态丢失

解决方案：

  1. Cookie 可能过期，重新用有头模式登录
  2. 确保 chrome-debug-profile 目录完整
  3. 不要手动删除该目录中的文件
  4. 两种模式共享同一个用户目录

进程冲突

症状：

Handshake status 404 Not Found

原因： 同一个 Chrome 用户目录不能被多个进程同时使用

解决方案：

  1. 无头模式会自动清理冲突进程
  2. 不要同时运行两种模式
  3. 手动运行 python kill_chrome.py
  4. 重启计算机（最后手段）

💡 最佳实践

开发阶段

# 使用有头模式，方便调试
HEADLESS_MODE = False
python start_with_chrome.py

生产部署

# 使用无头模式，节省资源
HEADLESS_MODE = True
python start_with_chrome.py

服务器部署建议

  1. ✅ 使用无头模式
  2. ✅ 配置为系统服务（systemd）
  3. ✅ 启用日志文件输出
  4. ✅ 定期检查日志文件大小
  5. ✅ 设置 Telegram 告警

⚠️ 注意事项

  1. 配置文件安全: 不要将包含真实 Token 的 config.py 提交到版本控制
  2. 首次必须登录: 无论使用哪种模式，首次都要用有头模式登录
  3. 用户目录共享: 有头和无头模式共享 chrome-debug-profile 目录
  4. 不要同时运行: 两种模式不能同时运行（会自动清理冲突）
  5. 定期检查日志: 日志文件会自动轮转，但建议定期检查

📄 许可

本项目仅供学习和个人使用。

� 相关文档

项目文档

外部链接

🤝 贡献

欢迎提交 Issue 和 Pull Request！

贡献指南

  1. Fork 本仓库
  2. 创建特性分支 (git checkout -b feature/AmazingFeature)
  3. 提交更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 提交 Pull Request

📝 更新日志

v2.0 (2025-10-11)

  • ✨ 新增完整的跨平台支持（Windows/Linux/macOS）
  • ✨ 自动检测 Chrome 路径，无需手动配置
  • ✨ 无头模式自动打开网站并监听
  • ✨ 显示 Chrome 进程 ID
  • ✨ 统一有头和无头模式启动脚本
  • 📝 完善 Linux 部署文档
  • 🐛 修复多个平台兼容性问题
  • 🔧 删除自动重启功能，简化代码

v1.0 (2025-10-10)

  • 🎉 初始版本发布
  • ✅ 支持 API 监听和 Telegram 推送
  • ✅ 支持有头和无头模式

更新日期: 2025-10-11
版本: 2.0
作者: PorunC
仓库: github.com/PorunC/valuescan

About

No description, website, or topics provided.

Resources

Readme
Activity

Stars

14 stars

Watchers

0 watching

Forks

11 forks
Report repository

Releases

2 tags

Packages

No packages published

Contributors 2

  •  
  •  

Languages