# AetherSwap **Repository Path**: sjb520cxj/AetherSwap ## Basic Information - **Project Name**: AetherSwap - **Description**: ⚗️ AetherSwap：全自动、零代码配置的 Steam 低价余额助手。提供现代化可视化 Web 控制台，基于数学模型智能选品，实现从买入到全自动上架的无人值守交易。 - **Primary Language**: Unknown - **License**: GPL-3.0 - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 10 - **Created**: 2026-04-03 - **Last Updated**: 2026-04-03 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README

⚗️ AetherSwap

全自动、零代码配置的 Steam 低价余额助手
跨区购买 · 行情分析 · 数据复盘 · 全可视化控制台

[![Version](https://img.shields.io/badge/version-v0.1.0--beta-orange)](https://github.com) [![Python 3.10+](https://img.shields.io/badge/Python-3.10%2B-blue?logo=python&logoColor=white)](https://python.org) [![FastAPI](https://img.shields.io/badge/Backend-FastAPI-009688?logo=fastapi&logoColor=white)](https://fastapi.tiangolo.com) [![License: GPL v3](https://img.shields.io/badge/License-GPL%20v3-blue.svg)](LICENSE) [![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20Linux-lightgrey?logo=linux)](https://github.com) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com)

功能亮点 · 快速开始 · 工作原理 · 进阶配置 · 常见问题 · 参与贡献 · 免责声明




> 从选品→下单→上架→确认，全程 **99% 无人工干预**； > 每笔交易的成本与收益被永久记录，折扣率与盈亏一目了然； > 选品与定价基于 **变异系数(CV)、趋势拟合(R²)** 等数学模型，而非靠感觉。
> [!NOTE] > **💡 项目定位与预期管理** > 本项目旨在**为新手降低“倒余额”门槛，为老手节省时间**。 > 请注意，本程序并非专门的套利工具，也不是万能的无风险低价获取余额的神器。自动购买的饰品在经历 7 天（或数天）的交易冷却期后，其市场表现大部分情况下会趋于您所期望的余额价格。但这并非绝对保证，7 天冷却期结束后的实际折扣比例**有可能上升，也有可能下降**。 > **如果您的目的是在短时间内快速获取余额，本工具并不适合您。** --- ## ✨ 核心功能 ### 🌌 直观丝滑的全局仪表盘 告别枯燥的命令行与繁杂的 JSON 配置！系统提供了一个直观、美观且响应丝滑的 Web 前端仪表盘（Dashboard）。所有运行状态、行情看板与系统设置均可在图形界面完成，零代码门槛，让你真正享受现代化的掌控体验。
直观丝滑的全局仪表盘展示
▲ 图：响应式现代化 Web 仪表盘主页
### 🤖 几乎全自动的倒余额流程 从 **选品 → 下单 → 入库 → 上架 → Steam Guard 确认**，整条链路无需人工守候。 内嵌 Playwright 浏览器自动完成 Steam 登录与 Cookie 提取；绑定移动令牌密钥（`identity_secret`）后，商品上架的二次确认也由程序自动签署。你只需要启动一次，剩下的交给 AetherSwap。 ### 📐 基于数学模型的智能选品与定价 不靠感觉，不靠经验，只靠数据： - **变异系数 (CV)**：量化价格波动幅度，自动排除价格剧烈震荡的高风险品 - **趋势拟合度 (R²)**：拟合历史价格线性趋势，识别持续下跌或走势紊乱的冷门品 - **参考价计算**：根据 Steam 寄售深度与历史成交数据，动态选取最优上架价格，而非简单挂最低价 ### 📈 实时行情与大盘追踪 系统支持实时追踪现有饰品折扣状态以及大盘市场变动，让你对市场趋势一目了然，帮助你捕捉最佳交易时机。
实时市场追踪分析展示
▲ 图：实时追踪现有饰品折扣状态以及市场变动
### 📜 历史饰品数据深度分析 系统提供了深度的历史饰品数据分析功能，支持复盘特定饰品在长期时间线上的价格走势、成交量变动及盈亏表现，通过回溯历史数据帮助你进一步优化选品策略。
历史饰品数据深度分析展示
▲ 图：饰品历史价格跳动与成交分析
### 🎮 Steam 游戏折扣获取与动态排序 不仅是饰品倒卖，内置实用的 Steam 商店游戏折扣抓取助手： - **实时折扣拉取**：一键批量获取 Steam 平台当前打折游戏的数据。 - **多维动态排序**：支持按折扣力度、玩家好评率、历史最低价（史低）等维度进行排序与筛选，方便在倒出 Steam 余额后快速寻找高性价比的消费目标。
Steam 游戏折扣面板展示
▲ 图：折扣雷达——按好评率与降价幅度动态排序的 Steam 游戏列表（图片预留位）
### 📊 完整的进销存数据分析 每一笔交易都被永久记录：购入成本、上架价格、最终成交额、实际获得的 Steam 余额，以及综合折扣比率，全部可在数据面板以图表形式呈现。你能清楚地知道每一分钱花在哪、赚了多少。
进销存数据看板
▲ 图：直观的盈亏柱状图与综合余额转化率汇总看板（图片预留位）
--- ### 其他功能（含安全与网路保护） | 功能模块 | 描述 | |---|---| | 🛡️ **Steam 令牌获取与验证** | 内置 Steam 移动令牌（Steam Guard）生成与管理模块，支持提取令牌密钥后在控制台直接生成两步验证码（2FA），无需频繁掏出手机；集成自动确认交易功能，彻底解放双手 | | � **智能代理池中转** | 针对 Steam 严格的风控与区域限制，内置强大的代理池管理（支持自定义长效静止 IP 及 Webshare 自动轮换动态 IP），防止同 IP 频繁请求导致的社区封禁或红信 | | �🎨 **Web 控制台** | 现代化可视化界面，零代码完成所有配置，实时掌控运行状态 | | 🔑 **内嵌 Steam 登录** | 直接在面板输入账号，自动完成登录与 Cookie 提取，无需手动抓包 | | 🔔 **多渠道消息推送** | 内置 PushPlus 微信推送 + 邮件预警，重要事件即时通知 | | 🔒 **一键出厂重置** | 彻底清理代理、令牌、数据库、日志等全部隐私数据，安全迁移无忧 | --- ## 🚀 快速开始 ### 环境要求 - **Python**: 3.10 或更高版本（[下载](https://www.python.org/downloads/)） - **操作系统**: Windows 10/11（推荐），或带有桌面环境的 Linux - **网络**: 需要能够正常访问 Steam 社区 > [!IMPORTANT] > **国内用户必读：** 由于网络限制，运行前请务必开启 **Steam 加速器**（如 [Steam++/Watt Toolkit](https://steampp.net/)、加速器等），否则程序将无法正常连接 Steam 社区，导致登录失败或行情数据拉取超时。 ### 安装步骤 **第 1 步：克隆项目** ```bash git clone https://gitee.com/vexed-wilson/AetherSwap.git cd AetherSwap ``` **第 2 步：安装依赖** ```bash # 安装 Python 依赖（国内用户推荐使用镜像加速） pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple # 安装内嵌浏览器（用于自动化 Steam 登录） python -m playwright install chromium ``` **第 3 步：启动程序** ```bash python run.py ``` 程序启动后将自动弹出 Web 控制台，按照首页的**「快速开始」**卡片引导完成配置即可。 ### 引导流程（约 3 分钟） ``` 打开控制台 → 填写手机令牌密钥 → 添加 Steam 账号并验证 → 启动自动任务 🎉 ``` 1. 观察首页**「快速开始」**待办卡片，逐项完成配置 2. 在【系统设置】中填写 `shared_secret`、`identity_secret` 及通知 Token 3. 在【账号管理】中添加 Steam 账号，点击「验证」自动完成模拟登录 4. 返回首页，点击**「启动任务」**，坐等余额入账 🚀 --- ## ⚙️ 工作原理 AetherSwap 由两条后台 Pipeline 协同驱动： ### 采买 Pipeline ``` iflow 行情接口 → 折扣筛选 → 稳定性分析(CV/R²) → 防呆校验 → Buff 自动下单 ``` 1. **实时选品**：对接 iflow 接口，拉取综合折扣最优的饰品列表 2. **稳定性过滤**：请求 Steam 历史价格数据，计算 `CV`（变异系数）与 `R²`（趋势拟合度），自动剔除高波动品 3. **安全下单**：验证每日限购数量、最低折扣等防呆条件后，在 Buff 自动模拟创建订单 > **支付方式说明**：当前版本仅支持通过 **微信支付** 完成购买结账。支付宝等更多支付方式正在规划中，欢迎关注后续更新。 ### 出售 & 数据沉淀 Pipeline ``` 库存监听 → 获取 Steam 寄售深度 → 自动上架 → 令牌签名确认 → 交易数据入库 ``` 1. **库存监听**：智能检测 Steam 新入库饰品，自动触发上架流程 2. **令牌无感确认**：使用 `identity_secret` 自动签署 Steam 商品上架二次确认 3. **数据沉淀**：订单完成后永久记录进销存信息，精确计算每笔余额的实际折损比率 --- ## 🔧 进阶配置 所有参数均可在 Web 控制台的【系统设置】中实时调整，**修改立即生效，无需重启**。 ### 常用参数说明 | 参数 | 默认值 | 说明 | |---|---|---| | `stability.days` | `30` | 历史价格回溯天数，天数越长分析越稳健 | | `stability.cv_threshold` | `0.05` | 波动率上限，调高可买入更多品类（风险同步上升） | | `stability.r2_threshold` | `0.7` | 趋势拟合度下限，调低可接受更多震荡走势品 | | `pipeline.max_daily_buy` | - | 每日最大购买金额上限，用于资金风控 | | `pipeline.sell_strategy` | `immediate` | 出售策略：`immediate`（立刻）/ `trend`（趋势延迟）/ `hold`（跌破成本不售）| | `proxy_pool` | - | 自定义代理列表，留空则使用内置 Webshare 自动轮换 | > **保守策略提示**：默认参数极度保守（宁少赚不亏本）。若想提高买入频率，可将 `cv_threshold` 放宽至 `0.08`，并适当降低 `r2_threshold`。 ### 📩 自动化配置：关于“邮箱确认” 在程序的自动抢购与下单流程中，支付完成后的确认环节分为两种模式。这取决于你是否在【系统设置】中配置了邮箱（IMAP）信息： - **自动化（配置了邮箱）：** 系统在生成支付链接后，如果你扫码完成了付款，交易平台通常会发送一封通知邮件（如含“已确认成功付款”的字样）。系统通过 IMAP 持续监听你的收件箱，一旦捕捉到付款成功的邮件，即可**自动流转**到后续的“提取并核销饰品、提醒卖家发货”等环节。 - **纯手动（未配置或留空）：** 如果你不填写 `email_user` 或 `email_pass`，程序**不会报错或崩溃**，而是自动降级为纯手动确认模式。此时页面和后台日志将进入等待倒计时，你需要**在 5 分钟（即默认的 `email_timeout_seconds=300`）内手动在界面上点击确认已支付**。如果完成付款但未在 5 分钟内给予系统确认指令，系统会将其视为订单超时并跳过该饰品。 > **💡 建议：** 如果你追求尽可能全程挂机和无感体验，建议配置一个专门接收付款通知的邮箱（如开启 IMAP 的 QQ 邮箱 / 网易邮箱等），这将带给你最流畅的半自动化交易流转。 --- ## 🏗 项目结构 ``` AetherSwap/ ├── app/ # FastAPI 后端核心 │ ├── main.py # 应用入口 & 路由注册 │ ├── pipeline_steps.py # 采买 / 出售 Pipeline 逻辑 │ ├── database.py # SQLModel ORM & 数据库操作 │ └── services/ # 后台任务队列与调度 ├── buff/ # Buff 平台接口封装 ├── steam/ # Steam API & Playwright 自动化 ├── iflow/ # iflow 行情数据接口 ├── utils/ # 公共工具（代理、推送、配置等） ├── web/ # 前端静态文件（HTML/JS/CSS） ├── tests/ # 单元测试套件 ├── run.py # 一键启动入口 └── requirements.txt # Python 依赖清单 ``` --- ## 🧪 运行测试 ```bash # 运行全部单元测试 pytest tests/ -v # 运行特定模块测试 pytest tests/test_pipeline_steps.py -v ``` --- ## 💡 常见问题 FAQ
Q：启动后控制台窗口打不开？ 请确认依赖安装无报错。若为端口占用，可修改 `app/main.py` 中 `28472` 为其他空闲端口，再重新启动。
Q：账号登录失败 / Cookie 提取不到？ 请确保当前网络（加速器）能够访问 Steam 社区。若自动登录持续失败，可在【账号管理】中手动填入从浏览器获取的 Cookie 作为备用方案。
Q：系统频繁提示"因波动率/斜率放弃购买"？ 这是正常的保守行为。若希望增加买入频率，请在设置中将 `cv_threshold` 调至 `0.08`，并降低 `r2_threshold` 至 `0.6` 左右。调整前请充分理解风险。
Q：如何部署到 Linux 服务器？ AetherSwap 的 FastAPI 架构完整支持无头 Linux 环境。直接运行： ```bash python -m uvicorn app.main:app --host 0.0.0.0 --port 28472 ``` 再通过外部浏览器访问服务器 IP 即可。**强烈建议配置 Nginx 反向代理与访问鉴权，不要将管理面板直接暴露在公网。**
Q：Buff Cookie 过期了怎么办？ 在 Web 控制台的【账号管理】中点击「重新登录」，系统将自动拉起内嵌浏览器完成重新授权，Cookie 刷新后自动保存，无需手动操作。
--- ## 🤝 参与贡献 欢迎任何形式的贡献！请遵循以下流程： 1. **Fork** 本仓库 2. 基于 `main` 创建你的特性分支：`git checkout -b feature/my-awesome-feature` 3. 提交你的更改：`git commit -m 'feat: add some awesome feature'` 4. 推送到远端：`git push origin feature/my-awesome-feature` 5. 发起一个 **Pull Request** 提交 Bug 报告或功能建议，请尽量附上完整日志。 --- ## 💬 社区 & 联系 如果你在**余额倒卖方面有丰富经验**，欢迎加入测试、反馈选品策略或参数调优建议——你的实战经验将直接帮助改进算法。 > 📱 **微信**：`13738064065` > 加好友时请备注 **AetherSwap**，方便快速通过。 --- ## 🗺 Roadmap > 以下为计划中的功能，欢迎通过 Issue 或 PR 参与建设！ - [ ] **更多交易平台接入** - [ ] C5Game 平台对接 - [ ] IGXE 平台对接 - [ ] 悠悠有品平台对接 - [ ] **更多支付方式** - [x] 微信支付 - [ ] 支付宝支付 - [ ] **移动端 / 响应式 UI 适配** - [ ] **Docker 一键部署支持** - [ ] **多账号并发任务调度** --- ## 📄 开发者说明 - **后端栈**：`Python 3.10+` · `FastAPI` · `SQLModel (SQLite)` · `Playwright` - **前端栈**：原生 `HTML / JS / CSS`（无框架依赖） - **并发机制**：异步 + 多线程融合的后台 Task Queue（`app/services/workers`） - **扩展性**：高内聚、低耦合的模块化设计，接入 C5、IGXE 等其他平台仅需添加对应 API 封装层 --- ## ⚠️ 免责声明 > **在使用、克隆或下载本项目前，请务必仔细阅读本免责声明。您的任何使用行为（包括但不限于下载、安装、运行、修改及分发本项目代码）均被视为对本声明全部条款的无条件知晓、认可及接受。若您不同意本声明的任何内容，请立即停止使用本项目并删除所有相关文件。** 1. **学习与研究目的**：本项目完全开源且免费，仅作为 Python 自动化操作、数据爬取、全栈架构及数学模型应用的**学习、交流与技术验证**之用。项目本身并未集成任何用于破解、攻击或恶意破坏第三方平台的基础设施。**严禁**将本项目或其任何衍生版本用于任何非法、违规或违反第三方平台（如 Steam、网易 Buff 等）《用户协议》及《服务条款》的商业或黑产行为。因违规使用导致的任何法律红线触碰，均由使用者自行承担全部法律及连带责任。 2. **账号风控与封禁风险**：Steam 及相关饰品交易平台针对“使用自动化脚本、API 滥用、机器批量操作”等行为持有严格的零容忍政策及风控机制。使用本项目进行实盘交易，存在**账号被红信、API 封禁及资产被永久冻结的风险**。使用者应当充分了解此风险，做好风控隔离处理（如使用独立代理、限制请求频率等）。**因使用本项目导致的任何账号限制、封禁或资产清零，本项目及开发者（含代码贡献者）概不负责，不承担任何形式的赔偿或连带责任。** 3. **市场波动与资金损失风险**：虚拟饰品市场受多方因素影响（包括但不限于平台政策变更、游戏更新、外汇波动等），存在极大的市场不确定性与暴雷风险。本项目内置的任何算法、趋势拟合（如 CV、R²）及数据分析功能，仅基于历史数据进行学术性质的模型推演与展示，**不构成任何形式的投资、购买或理财建议**。实际运行中的任何异常（如：网络延迟、接口报错、算法偏差或不可预见的黑天鹅事件）均可能导致高挂低售或财产损失。**由此引发的一切直接或间接的经济损失，开发者免责。** 4. **数据隐私与安全**：本项目在本地运行，涉及敏感信息（如账号 Cookie、移动令牌身份密钥 `identity_secret` 及支付相关参数）均储存于使用者本地设备。使用者需自行妥善保管上述敏感数据。因个人保管不当、设备中毒、代理泄露或服务器被入侵导致的隐私泄露或财产损失，开发者不承担任何责任。 5. **严禁商业滥用与倒卖**：本项目遵循开源协议免费发布，**严禁任何人、工作室或利益团体在未获原作者明确书面授权的情况下，将本项目（包括源代码、衍生修改版本、二次编译封装的二进制程序等）用于商业兜售、代挂收费、知识付费打包或任何变相盈利行为**。对于任何侵权、倒卖或损害开源社区利益的行为，开发者保留依法追究其侵权与不正当竞争责任的权利。 6. **请求频率限制与 DDoS 风险**：因防范恶意滥用与平台风控等安全考量，本项目故意设置并限制了默认的请求频率。如果您擅自更改代码逻辑取消延时保护，或是使用大量代理池进行高并发、无限制的请求，导致被官方服务器认定为恶意爬虫甚至 DDoS 攻击，本项目及开发者概不负责，均由使用者自行承担全部法律责任及封禁后果。 **【最终声明】本项目按“原样”提供，不带有任何明示或暗示的担保。开发者不对代码的准确性、可靠性或适用性做任何承诺。一切使用后果由操作者本人全权负责。** ---
如果 AetherSwap 对你有帮助，欢迎点个 **⭐ Star** 支持一下！ Made with ❤️ for the Steam community