عن المشروع

Steam Trading Card Helper 是一款面向 Steam 社区的 Tampermonkey 用户脚本。它用于扫描 Steam 卡牌价格、估算徽章成本、辅助购买、管理长期订购单、批量合成徽章，以及处理多余社区物品。脚本不是 Valve 或 Steam 的官方产品，使用风险由使用者承担。 安装后，用户可在自己的 Steam 徽章页打开脚本。界面包含价格扫描、订购卡牌、订购单、价格走势、徽章合成、黑名单、多余物品、物品收藏和设置等页面。价格扫描可扫描普通或闪卡徽章、剩余掉落、拥有数量、卡牌价格、单套与满级成本。扫描结果可保存到订订购卡牌，也可通过 AppID 手动加入游戏并重新计算。订购单页面可查看现有买单、剩余数量、占用金额和最低售价，并支持批量撤销。 价格数据优先读取 Steam Market listing 商品页，一次取得当前订单簿和近期成交记录；所需字段缺失时才回退 priceoverview。所有 priceoverview 请求共享每分钟 20 次的限制。价格方式包括在售最低、平均价格和求购最高。缺失价格不会按零元计算，币种不一致、响应损坏或请求失败时会保留为缺价。 成本估算只使用扫描时已取得的数据，不会因切换价格方式或勾选结果而发送额外请求。估算项目包括补全总价、全套总价和满级总价。顶部总价只合计选中项；任一选中游戏存在缺价时，合计显示为“-”。手动模式下估算会加上买价调整并保证不低于当前币种市场最低价；智能定价模式使用所选策略的无墙调整。 购买数量逻辑支持补全单套、补至五级、购买单套和购买五套。长期订购单可选择在售最低、平均价格或求购最高作为基准，并应用买价调整。智能定价只用于长期订购单，会读取完整买单深度，识别顶部孤立高价和最近订单墙，再按保守、平衡或抢单策略选择价格，最终价格不低于市场最低价，且存在最低卖价时不高于最低卖价减 0.01。 扫描与筛选支持普通卡和闪卡、最大徽章页数、是否包含仍有掉落的游戏。单套价格超过上限时跳过；提前预测会在少量有效样本已明显超限时减少后续请求。扫描结果可缓存到订购卡牌，自动黑名单可记录完整查价或提前预测结果，固定黑名单不会被过期清理；满级估算颜色用于区分近期成交量情况。 徽章合成可扫描已集齐的卡组并排除黑名单游戏，支持逐级升级或一次升满，也可逐项填写次数或全部设为 1、最大、清零，提交前必须确认。多余物品功能会按目标徽章等级预留仍需要的套数，再列出真正多余的数量；背景和表情可设置默认保留份数并选择是否包含点数商店物品。建议会比较市场出售税后金额与分解为宝石后的税后价值，实际出售和分解始终在确认后串行提交。物品收藏可保护指定物品，使其不进入出售或分解候选。 并发设置中，HTML 类请求并发默认关闭、并发数 4；其他请求并发默认开启、并发数 8；并发数可设为 1–20。分页读取以及下单、撤单、出售、分解和合成等写操作不会并行。宝石袋价格每次打开插件自动读取一次，用户点击刷新会强制重新读取。个性化支持拖动顶部 Tab 调整顺序、为每个 Tab 设置六位 HEX 标签颜色、调整日志区域高度，并可导出或导入 JSON 数据，包括设置、缓存、价格历史、收藏和界面状态。导入失败时会尝试恢复原数据；备份不包含 Steam 登录状态。 使用提醒包括市场价格、订单深度和库存会随时变化，估算不等于最终成交金额；遇到连续请求失败或 429 时应降低并发数或暂停后重试；下单、撤单、出售、分解和合成前需检查确认窗口，分解不可恢复，出售可能需要 Steam 手机确认。开发方面，npm test 运行自动化测试，npm run build 生成用户脚本，npm run check 运行测试并重新构建。项目采用 MIT 许可证。