# Steam 卡牌一键助手

当前版本：2.5.2。该版本启用正式官网 `https://steamcard.app`，同时保留原地址兼容；继续支持 US$9.99 PayPal 直连、简体中文 / English、单设备内多 Steam 账号隔离、分批连续升级、钱包余额预检、累计提交金额统计、可选自动提交与确认弹窗跳过，以及 24 小时断点恢复。

免费版提供10组低价卡牌扫描、徽章剩余次数识别和单套官方购买清单。专业版为一次性买断，解锁目标等级规划、重复购买、持续续购和批量合成。

这是一个本地安装的 Chrome / Edge Manifest V3 扩展，用于：

- 扫描参考价格较低的普通 Steam 卡组；
- 根据当前账户已持有的卡牌估算完成下一套徽章的成本；
- 检测当前徽章等级，并将同一游戏的计划合成次数限制在 `5 - 当前等级`；
- 选择同一套卡牌重复购买1至5次，并自动扣除库存中已有的重复卡；
- 设置目标 Steam 等级，按当前总 XP 计算还需要多少个100 XP徽章；
- 在所有候选游戏的5级上限内，组合出预计总成本最低的升级方案；
- 将多个游戏的卡牌合并成一张 Steam 官方批量订单；
- 购买后检测卡牌到账，并按升级方案自动合成；
- Steam 因价格或库存变化只完成部分购买时，重新读取实际库存；
- 通过“继续购买剩余卡牌”只为仍缺的卡生成新订单，避免重复购买已到账卡牌；
- 每轮仍有缺卡时等待12秒并自动生成下一张剩余订单，不限制为只重试一次；
- 提供“停止自动续购”，可随时终止循环；
- 初次生成计划时保存每个游戏的完整卡牌清单；续购必须逐张达到计划数量才会判定完成；
- 生成并打开 Steam 官方 `multibuy` 批量购买页面；
- 在官方页面核对最终金额、预算上限并一键提交；
- 可选自动提交每一批官方订单，并可跳过助手自己的确认弹窗；
- 自动读取 Steam 钱包余额，余额不足时暂停购买与续购；
- 按 Steam 账号分别保存预算、购买计划、升级进度和累计提交金额；
- 大目标自动拆分为多批订单，逐批购买并连续合成到指定等级；
- 网络、库存检查或合成临时失败时自动重试，并保存 24 小时断点；
- 批量合成当前完整的普通卡组。

## 安装

1. 从官网下载 `Steam卡牌一键助手-v2.5.2-Chrome安装包.zip` 并完整解压；开发测试也可使用 `Steam卡牌一键助手-v2.5.2-开发测试.crx`。
2. 在支持本地 CRX 的 Chromium 浏览器中打开扩展程序管理页。
3. 开启“开发者模式”，点击“加载已解压的扩展程序”，选择解压后的文件夹。Chrome 正式版通常会阻止商店外 CRX 直接安装。
5. 在浏览器登录 `https://steamcommunity.com/`。
6. 打开“个人资料 → 徽章”，点击右下角“卡牌一键助手”。

Windows 版 Chrome 正式渠道会拒绝直接安装未从 Chrome 应用商店发布的本地 CRX。遇到这种情况并非安装包损坏；要在 Chrome 中实现完全正常的非文件夹安装，需要把同时提供的商店上传 ZIP 发布到 Chrome 应用商店。

## 推荐操作

1. 点击“扫描低价卡组”。
2. 默认选择预计补齐成本最低的候选，也可以手动选择其他候选。
3. 在“同一套计划合成”中选择次数。扩展只允许选择该徽章到5级之前还能合成的次数。
4. 点击“打开官方批量购买”。扩展会计算每一种卡实际需要补买的数量，并扣除现有库存。
5. 等 Steam 官方页面加载所有卡牌价格。
6. 查看最终金额，并设置本次预算上限。
7. 勾选页面底部 Steam 订户协议。
8. 点击“确认金额并一键购买”。如已开启“跳过助手确认”，扩展不会再弹出自己的确认框。
9. 购买到账后回到徽章页，点击“一键合成现有完整卡组”。

## 按目标等级自动升级

1. 在自己的 Steam“个人资料 → 徽章”页面打开助手。
2. 根据目标高低选择扫描10、20、30或50个低价卡组。
3. 在“目标 Steam 等级”输入希望达到的等级。
4. 点击“生成最低价升级方案”。
5. 检查当前 XP、需要合成的徽章数量、涉及的游戏及参考成本。
6. 点击“一次性购买并自动合成”并确认计划。
7. 在 Steam 官方批量购买页等待价格加载，设置足够但不过高的预算上限。
8. 勾选 Steam 订户协议。开启自动提交后，扩展会在预算、钱包余额和数量检查通过后自动点击购买。
9. 卡牌全部到账后，扩展会返回徽章页并自动执行方案中的合成次数。

如果 Steam 只完成了部分购买，助手会显示当前仍缺多少张卡：

1. 扩展重新读取每种卡牌的实际库存；
2. 已经到账的卡从订单中移除；
3. 使用当前库存和计划合成次数计算剩余数量；
4. 等待12秒冷却后自动打开新的 Steam 官方订单；
5. 再次核对最新价格、预算和订户协议并提交；
6. 如果第二轮、第三轮仍为部分成交，将继续执行相同流程；
7. 重复至全部卡牌到账，然后继续自动合成。

“全部到账”要求计划中的每一种卡牌都达到所需数量；任意一张仍缺少时都不会进入自动合成。

等待期间也可以点击“继续购买剩余卡牌”立即进入下一轮，或点击“停止自动续购”结束循环。
扩展可以自动提交后续订单，但不会自动勾选 Steam 订户协议，也不会绕过 Steam Guard、市场限制或 Steam 官方必须完成的安全步骤。

目标等级所需经验按 Steam 的分段规则计算。由于社区任务等徽章可能提供非100整数倍经验，
扩展读取账户当前显示的总 XP，再向上取整计算所需游戏徽章数量。

## 安全设计

- 不收集、保存或上传 Steam 密码、Steam Guard、Cookie、Session ID 或 API Key。
- 购买使用 Steam 官方批量购买页面；扩展不连接第三方交易机器人。
- 下单前同时检查 Steam 显示的最终金额和用户设置的预算上限。
- 能读取到钱包余额时，订单超过余额会立即暂停；无法读取余额时仍保留预算和 Steam 官方按钮状态检查。
- 目标方案购买前会显示涉及的游戏、次数、参考成本和预计 XP。
- 每种卡牌数量限制为最多5张。
- 普通游戏徽章达到5级后不会继续生成购买订单。
- 重复购买次数依据当前徽章等级计算，并结合每张卡的实际库存生成数量。
- 默认在合成前列出数量并再次确认；用户可主动开启“跳过助手确认”，但卡牌合成后仍无法恢复。
- 参考价格来自 `cdn.steam.tools`，最终价格始终以 Steam 官方页面为准。

## 已知限制

- Steam 可能对短时间内大量访问或购买进行限流。建议一次处理一套，不要反复刷新。
- 单批最多选择80种卡牌；更大的目标会自动拆成多批连续处理。
- 个别卡牌价格快速变化时，Steam 可能只完成部分购买；扩展会保存进度并只续购仍缺的卡牌。
- 自动提交仍以每一页最新显示的价格为准，且每批都重新检查预算和钱包余额。
- 花费统计记录“助手已提交的订单金额”；如果 Steam 最终只成交部分，统计可能高于实际扣款，应以 Steam 钱包历史记录为最终依据。
- Steam 修改网页结构后，扩展的页面选择器可能需要更新。
- 扫描只检查价格最低的前10、20、30或50个卡组，默认20个。
- 扩展只处理普通卡，不处理闪卡和特殊活动徽章。
- 一键合成默认只扫描当前徽章列表页面能访问到的游戏；徽章很多时可逐页执行。

## 卸载

进入 `chrome://extensions/` 或 `edge://extensions/`，找到“Steam 卡牌一键助手”，点击“移除”。

## 免责声明

Steam 社区市场购买不可退款；徽章合成会永久消耗卡牌。请先用小额订单测试，并自行承担市场价格变化、限流和 Steam 页面改版带来的风险。本工具与 Valve 或 Steam 没有关联。
