自动化批量上架Steam激活码到SteamPY平台，支持精确元素定位和错误恢复
# SteamPY 批量上架激活码助手 (正式版) 🚀
> 自动化批量上架 Steam 激活码到 SteamPY 平台的 Tampermonkey 脚本，支持精确元素定位和错误恢复
[](https://github.com/jamespaulzhang/SteamKeyBulkManager/LICENSE)
## ✨ 核心功能
### 🧩 增强型批量处理
- **智能批量上架**：自动处理多游戏激活码上架流程
- **错误恢复机制**：三级重试机制（`retryTimes: 3`）
- **全球区同步**：支持一键全球同步上架（通过复选框控制）
- **视觉定位系统**：自动标记操作元素（蓝/绿/黄/红框）
### ⚙️ 精准操作控制
```javascript
// 配置参数
delayBetweenItems: 2000, // 操作间隔(ms)
batchSize: 5, // 每批处理量
maxWaitTime: 15000, // 最大等待时间
每行格式: Steam链接|激活码|价格(可选)
示例:
https://store.steampowered.com/app/730/CSGO/|ABCDE-FGHIJ-KLMNO|50
// 多维度元素检测
function waitForVisibleElement(selector) {
const style = window.getComputedStyle(el);
return style.display !== 'none'
&& style.visibility !== 'hidden'
&& el.offsetWidth > 0;
}
// 模态窗口层级管理
function waitForNewModal(baseCount) {
// 识别最新模态窗口
const modals = document.querySelectorAll('div.ivu-modal-wrap');
return modals[modals.length - 1];
}
// 安全点击机制
async function safeClick(element) {
element.scrollIntoViewIfNeeded();
await new Promise(resolve => setTimeout(resolve, 500));
// 触发完整点击事件序列
element.dispatchEvent(new MouseEvent('mousedown', { bubbles: true }));
element.dispatchEvent(new MouseEvent('click', { bubbles: true }));
}
Steam商店链接|激活码|价格(可选)
示例：
https://store.steampowered.com/app/292030/Witcher_3/|QWERT-ASDFG-ZXCVB|89.5
https://store.steampowered.com/app/578080/PUBG/|POIUY-MNBVC-LKJHG|
| 参数 | 默认值 | 说明 |
|---|---|---|
defaultPrice |
10 | 未指定价格时的默认值 |
delayBetweenItems |
2000ms | 物品间操作延迟 |
batchSize |
5 | 每批处理数量 |
maxWaitTime |
15000ms | 元素等待超时 |
retryTimes |
3 | 失败重试次数 |
Q：为什么有时会提示「等待 Vue 应用加载超时」？
A：请确保：1）页面完全加载完成 2）处于正确的 CDKey 管理页面 3）网络连接正常
Q：全球同步选项有什么作用？
A：启用后会在全球区同步上架激活码（需要用户自行确认激活码是否为全球key）
Q：如何处理失败项？
A：脚本完成后会显示失败列表，建议：1）检查格式 2）手动重试 3）降低批量大小
Q：是否支持区分标准版/豪华版/DLC？
A：目前的1.0版本暂时不支持，未来会考虑更新
⚠️ 注意：使用前请确保遵守 SteamPY 平台规则
This project is licensed under the MIT License - see the License file for details.
MIT License
Copyright (c) 2025 Yuxiang ZHANG
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
QingJ © 2025
镜像随时可能失效，请加Q群300939539或关注我们的公众号极客氢云获取最新地址