深色模式
第11章 武库兑换
适用版本 v4.0.1。本章你将学会：把账号载入「武库兑换」页，查询账号与星星余额，按需购买/激活武库通行证，并用星星兑换饰品；以及兑换结果不明确时如何安全处理。
11.0 开始之前
- 已使用您获得的软件授权账号登录软件（见第1章）。
- 武库兑换使用独立的账号库：不会沿用「账号工作台」里的勾选或账号。在这里导入、删除账号，只影响武库账号库，不影响主账号库。
- 每个要使用的账号必须具备 Steam 密码 和 手机令牌（maFile）。武库登录只使用「Steam 密码 + maFile 生成的验证码」，不支持邮箱验证码。只有邮箱令牌、没有手机令牌的账号无法在这里使用；需要先到「绑定 SDA」页面处理（见相关章节）。
- 提前在「全局代理」页的「内购｜武库」卡片里配置好代理（见 11.2）。没有配置，所有会真正连接 Steam 的操作都会被拒绝。
- 本章示例账号一律为：账号 demo_account_01，密码 ********，邮箱 demo01@example.test。
高风险操作（总提示）
本章的「兑换饰品」「购买通行证」「激活通行证」都是不可逆操作。
- 会发生什么：星星或 Steam 钱包余额被真实消耗。
- 不能撤销：提交后无法取消、无法退回，软件也不会自动重试。
- 何时不要点：账号、饰品、数量没有核对清楚时；上一次结果为「待复核」或提示「任务跟踪已中断」时。
- 结果不明确时：先用「查询武库信息」或「查询账号信息」核对，不要重复提交。
- 请逐次确认、先用 1～2 个账号试一次，再扩大范围。
11.1 进入「武库兑换」页
在哪里：鼠标移到窗口最左侧的竖向导航栏，从上往下第 5 项「武库兑换」（窄栏时显示简称「武库」），单击。 怎么做：
- 将鼠标移到左侧导航栏，点击「武库兑换」。
- 看页面大标题（注意：大标题显示的是「武库操作」，与导航文字不同，属正常）。
- 认识页面分区：
- 顶部条：左侧「武库操作」，右侧三个按钮「刷新列表」「查询账号信息」「查询武库信息」。
- 左侧大卡片「武库账号」：工具栏、账号表格。
- 右侧窄栏两张卡片：「武库通行证」和「星星兑换」。 这一步的作用：自动读取武库账号和可兑换饰品目录；如果浏览器里留有上次未完成的兑换任务，会自动恢复跟踪。 你会看到：账号表格为空时提示「暂无武库账号，点击「打开载入」或「粘贴载入」导入」。如果上次有未完成的兑换，「兑换饰品」按钮会处于转圈或锁定状态（见 11.13）。 注意：接口失败时由软件统一弹出错误提示，页面不会另外提示。
图 11-1 武库兑换页整体布局
11.2 先配置「内购｜武库」代理策略
在哪里：鼠标移到左侧导航栏下方的「代理」图标 → 页面右侧「页面策略」面板 → 第三张卡片「内购｜武库」。 怎么做：
- 点击左侧导航栏的「代理」。
- 在「页面策略」面板找到卡片「内购｜武库」（说明：「TF2 GC 内购与武库共用这一项策略，不跟随查询项或账号安全切换。」）。
- 在卡片的下拉框里选择一项：「内置代理」「皇家代理」「API 代理池」「蜘蛛粘性代理」。选择后立即保存，提示「内购｜武库代理已切换：{所选项}」。
- 按所选项补齐对应配置：
- 内置代理：必须已选择内置 mihomo 配置。
- 皇家代理：必须已填写皇家代理的用户名与密码，并选择出口区域。
- API 代理池：必须已选择出口国家，并已加载长效 IP（有效期至少 30 分钟，建议 2 小时）。
- 蜘蛛粘性代理：必须已在中间的「蜘蛛粘性代理」面板导入节点。
- 卡片右上角标签显示「资源已配置」即表示资源齐备。 这一步的作用：武库里所有会真正连接 Steam 的操作（查询武库信息、购买/激活通行证、兑换饰品）都按这一项走代理，并且宁可拒绝也不会直连。 你会看到：
- 代理未配置齐备时，武库页顶部出现警告横幅，标题可能是「武库需配置 API 代理池（长效 IP）」「武库需配置内置代理」或「武库需皇家代理（IPRoyal）」。此时「查询武库信息」「购买通行证」「激活通行证」「兑换饰品」会被禁用或点击后被拒绝。
- 例如皇家代理未填凭据，横幅写：「武库需先配置皇家代理（IPRoyal）：请在代理策略中心的「皇家代理」卡片填写用户名与密码。」
- 软件后端还会再校验一次，可能返回以「已拒绝执行」「fail-closed 拒绝建立连接」结尾的提示（例如代理真实出口无法验证、代理出口国家与所选国家不符、代理池为空或全部失效），这是保护措施，不是软件坏了。 注意：
注意
这一项没有设置过时，默认等同于皇家代理。没有皇家代理凭据的用户，第一次执行就会被拒绝，请先改选其他模式或补齐皇家代理凭据。 注意：选「API 代理池」时，短效代理可能在兑换中途失效，导致结果需要人工复核，务必使用长效 IP。 注意：选「蜘蛛粘性代理」时，如果「皇家代理」卡片还没有填写用户名与密码，页面会显示「武库需皇家代理（IPRoyal）」横幅，并禁用「查询武库信息」和「激活通行证」。这是当前版本的界面限制。遇到时，可以先在「皇家代理」卡片填好凭据，或改用已配置好的其他模式。 提示：「查询账号信息」不受这个策略限制（它只登录网页读取信息，使用查询模块的代理设置）。
图 11-2 武库代理守卫横幅
图 11-3 全局代理页「内购｜武库」卡片
11.3 把账号载入武库（三种方式）
在哪里：「武库账号」卡片顶部工具栏，从左数：第 1 个「同步主列表」，第 2 个「打开载入」，第 3 个「粘贴载入」。 怎么做：
方式一：从主账号工作台同步
- 点击「同步主列表」，打开对话框「同步主列表到武库」。
- 等待读取完成，页面显示「来源：{令牌登录|邮箱登录|账密登录}」和「主列表共 N 个账号」。
- 默认勾选「全部分组（含未分组）」。要只同步部分分组，取消该勾选，再勾选需要的分组（每项显示「{分组名或“未分组”} N 个」）；空分组不可选。
- 确认「本次选择 N 个账号」，点击「开始同步」。
- 同步成功后出现「同步完成」和「选中 N 个，新增 N 个，更新 N 个，未变 N 个。」，点击左下角「完成」。
方式二：从 TXT 文件载入
- 点击「打开载入」，在系统文件框里选择 TXT 文件（格式：每行
账号----密码----邮箱----邮箱密码）。 - 选定后自动导入。
方式三：粘贴载入
- 点击「粘贴载入」，打开对话框「粘贴导入武库账号」。
- 在文本框中粘贴，每行一个账号，格式：
账号----密码----邮箱----邮箱密码，示例：demo_account_01----********----demo01@example.test----********。 - 点击「开始导入」（文本框为空时该按钮不可点）。 这一步的作用：把账号放进武库独立账号库。 你会看到：
- 导入成功：「导入成功 N 个，无效 M 行，共解析 K 行」。
- 空文件：「所选 TXT 文件没有可导入的账号内容」。
- 同步过程中失败：「同步失败，已保留选择，请重试。」，按钮变为「重试同步」。
- 武库当前有任务时同步会被拦住：「武库当前有任务进行中，请等待任务结束后同步。」 注意：
注意
「同步主列表」是增量同步：保留武库已有的余额、星星和操作结果，不会删除武库里多出来的账号；空密码不会覆盖已有密码；新令牌整套更新，未提供有效令牌时保留已有令牌。 注意：来源是软件当前登录模式下的主列表，不是固定的某个令牌库。 注意：粘贴载入只写入账号密码，邮箱和邮箱密码对武库登录不起作用，令牌要按 11.4 另行导入。TXT 文件里是明文密码，请妥善保管，截图时务必用假数据。 注意：「粘贴导入武库账号」对话框里的提示文字写的是「导入令牌」，实际工具栏上对应的按钮叫「选择令牌目录并导入」或「使用默认令牌目录导入」，请以后者为准。
图 11-4 工具栏与三种载入方式
图 11-5 同步主列表到武库对话框
图 11-6 粘贴导入武库账号对话框
11.4 导入令牌（maFile）
在哪里：「武库账号」工具栏第 4 个，带钥匙图标的按钮。已保存过目录后，右侧会多出第 5 个按钮「更换令牌目录」；工具栏下方有一行小字「默认令牌目录：{路径}」。 怎么做：
- 首次使用：点击「选择令牌目录并导入」，在弹出的文件夹选择框（标题「选择武库令牌（maFile）文件夹」）里选择存放 maFile 的文件夹。选定后立即导入。
- 以后：按钮变成「使用默认令牌目录导入」，点击即可复用已保存的目录。
- 要换目录：点击「更换令牌目录」，重新选择文件夹，选定后立即导入。 这一步的作用：按账号名把 maFile 匹配到武库里的账号，补全验证码所需信息。 你会看到：
- 成功：「令牌导入完成：匹配 N 个账号（完全体 a，阉割版 b），仍未匹配账号 c 个。」
- 武库账号列表为空时：「武库账号列表为空，请先粘贴导入账号，再导入令牌。」
- 目录无效：「未找到可用的令牌目录，请先选择正确的 maFile 文件夹。」
- 表格「令牌」列显示「完全体」「阉割版」或「未匹配」。 注意：
注意
缺少令牌的账号在查询、购买、兑换时会提示「该账号缺少 maFile 令牌（shared_secret），请先导入令牌。」，需先补齐令牌。 注意：maFile 是高敏感文件，截图只展示目录名，不展示文件内容。
图 11-7 令牌目录导入按钮与路径行
11.5 认识账号表格各列
在哪里：工具栏下方的账号表格。左上方统计「共 N 个 · 已选 N 个」。 怎么做：
- 在表格最左列勾选账号（表头复选框为全选）。后面的所有操作都以勾选的账号为准。
- 将鼠标移到「执行状态」标签上，可看到后端给出的逐条中文说明。 这一步的作用：了解每一列的意思。
| 列名 | 含义 |
|---|---|
| 账号名 | 账号 |
| 执行状态 | 该账号最近一次不可逆操作的结果，形如「购买·成功」「激活·失败」「兑换·余额不足」「兑换·待复核」；没有记录显示「—」。请以标签文字（「成功」「待复核」「余额不足」「失败」）为准 |
| 令牌 | 「完全体」「阉割版」「未匹配」 |
| 国家 | Steam 钱包国家，没查询过显示「—」 |
| 余额 | Steam 钱包余额，没查询过显示「—」 |
| 购买记录 | 武库通行证购买记录状态，未知显示「未知」 |
| 通行证库存 | 通行证张数，未知显示「未知」 |
| 当前星余额 | CS2 星星数量（来自「查询武库信息」），未知显示「未知」 |
| 优先 | CS2 优先状态，未查询显示「未查询」 |
注意：
注意
「余额」是钱包余额，「当前星余额」是星星数量，不要混淆。 注意：「执行状态」列只保存在当前页面里，刷新页面或重启软件后会消失。需要留存请自行记录，或到「日志与反馈」页面查看。通行证库存也不落库，重启后会显示「未知」，请重新「查询账号信息」。
图 11-8 账号表格各列与执行状态标签
11.6 刷新列表与删除选中
在哪里：「刷新列表」在页面顶部条右侧第 1 个按钮；「删除选中」是账号工具栏最后一个按钮（垃圾桶图标）。 怎么做：
- 重新读取武库账号：点击「刷新列表」，表格转圈结束即完成，无成功弹窗。
- 删除账号：先勾选账号，点击「删除选中」，在确认框「删除武库账号」（正文：「确定删除选中的 N 个武库账号吗？该操作仅影响武库独立库，不涉及主账号库。」）里点「删除」。 这一步的作用：刷新是重新读取；删除是把账号从武库账号库移除，并清除这些账号的「执行状态」记录。 你会看到：成功提示「成功删除 N 个武库账号」。 注意：
注意
删除后无法恢复（仅武库账号库，不会动 Steam 上的真实账号，也不影响主账号库）。有购买、激活、兑换任务进行时此按钮不可用。 注意：刷新列表后，通行证库存由页面用旧快照回填，不是重新查询的结果。
11.7 查询账号信息（只读）
在哪里：页面顶部条右侧第 2 个按钮（信息图标）「查询账号信息」。 怎么做：
- 先在账号表格里勾选账号（没勾选时按钮不可点）。
- 点击「查询账号信息」。 这一步的作用：登录 Steam 网页，读取每个账号的国家、钱包余额、CS2 优先状态、通行证购买记录与库存。只读，不花钱，可重复。它不连接 CS2 游戏，也不受「内购｜武库」代理策略限制。 你会看到：
- 全部成功：「账号信息查询完成：成功 N 个。」
- 有失败：「账号信息查询完成：成功 N 个，失败 M 个，详情见结果面板。」，并自动打开「账号信息查询结果」抽屉，列出失败原因；抽屉底部有「重试失败（N）」。常见失败原因：
- 「登录被 Steam 拒绝：账号密码错误，请核对并重新导入该账号的正确密码。」
- 「登录过于频繁，已被 Steam 临时限制，请稍后再试。」
- 「Steam 登录暂时出错，请稍后重试。」
- 「该账号需要有效的 maFile / SDA 令牌，请先导入正确令牌后重试。」
- 「账号缺少 Steam 密码。」 注意：这个查询结果用于兑换前核对钱包与通行证；「购买记录」「优先」两列的具体取值以实际显示为准（以实际软件为准）。
图 11-9 账号信息查询结果抽屉
11.8 查询武库信息（读取星星余额）
在哪里：页面顶部条右侧第 3 个按钮（星星图标）「查询武库信息」。 怎么做：
- 勾选要查询的账号。
- 点击「查询武库信息」。任务在后台运行，可以离开页面。
- 需要时点击进度条上的「明细」查看逐个账号状态，或点「停止」。 这一步的作用：连接 CS2 游戏服务读取每个账号的星星数量，写入「当前星余额」列。只读，可重试，但会真实登录 Steam。 你会看到：
- 运行中：账号表头上方出现进度条「武库信息查询进行中」，并显示「已耗时 X 分 Y 秒 · 首次需逐个登录，之后保持在线会快很多」，以及「账号 a/b」「成功」「失败」「进行」；按钮「明细」「停止」。
- 工具栏下方还有任务栏，显示「N 个任务运行中」或「N 个任务已结束」。
- 明细抽屉标题为「武库信息查询明细 · 进行中/停止中/已完成/已停止」，列为「账号」「状态」「星星」「说明」；状态值有「成功」「失败」「查询中」「未完成」；按钮「停止任务」「重试失败（N）」「关闭」。
- 全部成功：「武库信息查询完成：成功 N 个，已取消成功账号的勾选。」——成功的账号会被自动取消勾选，失败账号保持勾选，方便直接重试。
- 有失败或手动停止：「武库信息查询结束（已手动停止）：成功 N 个，失败 M 个，已保留失败账号的勾选，详情见明细。」并自动打开明细。
- 点停止：「已请求停止：未开始的账号不再查询，进行中的账号会尽快结束。」
- 连接中断：「武库信息查询进度连接已中断，后台查询可能仍在进行，请稍后重新进入页面查看结果。」
- 常见单账号失败说明：
- 「该账号查询超过 2 分钟仍未完成，已放弃（避免卡住整批），可稍后重试。」
- 「该账号库中没有 CS2（从未领取或游玩过），游戏服务不会响应，无法查询武库信息。」
- 「游戏服务未响应（已补发请求仍超时），未发送任何操作，可稍后重试。」
- 「Steam 限制该账号短时间内反复登录，请约 10 分钟后再重试（登录成功后会保持在线，之后查询不再重复登录）。」
- 「首次登录被 Steam 临时限流（已等待后重试仍被限），请过几分钟再重试该账号。」
- 「该账号缺少 maFile 令牌（shared_secret），请先导入令牌。」 注意：
注意
软件后端的部分提示里写的是「查询星星余额」，它和界面按钮「查询武库信息」是同一个动作。 提示：大批量账号请分批查询，避免被 Steam 限流。
图 11-10 查询武库信息进行中（进度条与任务栏）
图 11-11 武库信息查询明细抽屉
11.9 购买与激活武库通行证
本节两个操作也不可逆；如果您只需要兑换饰品而账号已有星星，可跳过本节。
在哪里：右侧窄栏第 1 张卡片「武库通行证」：一行「购买通行证数量」数字框（1～20，默认 1），下面两个按钮「购买通行证」与「激活通行证」。 怎么做： 购买：
- 勾选账号，在「购买通行证数量」中填入每个账号要买的张数。
- 点击「购买通行证」。
- 在确认框「确认购买通行证」里核对内容，点击「确认购买」。
激活：
- 勾选账号。
- 点击「激活通行证」。
- 在确认框「确认激活通行证」里点击「确认激活」。
高风险操作
购买通行证会按 GC 返回的动态本地价格，从每个所选账号的 Steam 钱包扣款；激活通行证会激活所选账号库存中的全部通行证。
- 会发生什么：确认框正文：「将为 N 个账号各购买 Q 张武库通行证，使用 GC 返回的动态本地价格和 Steam 钱包结算。提交后不会自动重试。」或「将激活 N 个账号库存中的全部武库通行证。提交后不会自动重试。」
- 不能撤销：已扣的钱包余额、已激活的通行证无法撤回；激活的是库存里的全部通行证，不是指定张数。
- 何时不要点：账号数量、张数没有核对时；钱包币种/余额没查过时；上一次结果为「待复核」时。
- 结果不明确时：先点「查询账号信息」核对通行证库存和钱包余额，并检查 Steam 的购买记录，切勿重复购买或重复激活。
你会看到：
- 购买进度框「购买通行证进度」、激活进度框「激活通行证进度」；结束后打开「购买通行证结果」「激活通行证结果」抽屉（四种分组，见 11.12），并自动刷新账号信息（只刷新网页信息，不会自动查星星）。
- 数量越界：「购买数量必须在 1 到 20 之间。」
- 未能启动：「购买任务未启动：{错误码}」，可能带「，冲突任务：{编号}」；「激活任务未启动：{错误码}」。
- 有待复核账号时，激活结果提示：「存在「待复核」账号：激活请求可能已生效。请点「查询账号信息」核对通行证库存，切勿重复激活。」
- 有未完成的购买任务时，「购买通行证」按钮变成「恢复购买任务」，数量框不可改。 注意：钱包不足、地区限制等具体失败原因的文案（以实际软件为准）。
图 11-12 武库通行证卡片与确认框
11.10 选择兑换饰品与数量
在哪里：右侧窄栏第 2 张卡片「星星兑换」：第一行左侧下拉「兑换饰品」，右侧「兑换数量」数字框；第二行开关「全部兑换」。 怎么做：
- 点击「兑换饰品」下拉（占位「选择要兑换的饰品」），可输入文字搜索，选择一项。选项格式为「{饰品中文名}_{单价星星}」，例如「果蔬印花_1」。
- 在「兑换数量」中填入每个账号要兑换的次数（1～200 的整数，默认 1；失焦时填入非法值会回填 1）。
- 或者打开「全部兑换」开关：按各账号的星星余额兑换到不足为止（仍受每账号最多 200 次限制）。开启后数量框不可编辑。 这一步的作用：决定兑换什么、每个账号兑换多少次。这一步只是选择，不会真正提交。 你会看到：目录加载中下拉显示转圈。 注意：
高风险操作
「全部兑换」开关。
- 会发生什么：每个勾选账号都会一直兑换到星星不足为止，预计总消耗事先无法确定，确认框里只会写「按各账号余额兑至耗尽」。
- 不能撤销：已兑换的饰品和已消耗的星星无法退回。
- 何时不要点：不确定账号星星余额、不确定要把星星全部花掉时；账号很多时。
- 结果不明确时：先用「查询武库信息」核对每个账号的星星余额，不要重复提交。 提示：建议先用固定数量（如 1）试一个账号，再决定是否使用「全部兑换」。
图 11-13 星星兑换卡片（含下拉展开与「全部兑换」开关）
11.11 点击「兑换饰品」并完成最终确认
在哪里：「星星兑换」卡片底部整宽的按钮「兑换饰品」（带播放图标）。 怎么做：
- 确认已完成 11.2 的代理配置，已勾选账号，已选好饰品和数量。
- 建议先对目标账号点一次「查询武库信息」，确认「当前星余额」够用。
- 点击「兑换饰品」，弹出确认框「确认开始星星兑换」。
- 逐行核对确认框内容：
- 「兑换饰品」：饰品名
- 「单价星星」：单价
- 「每账号数量」：Q 个（开启「全部兑换」时显示「兑换数量」：兑至耗尽）
- 「勾选账号」：N 个
- 「预计总消耗」：单价 × Q × N 星（醒目显示；全部兑换时为「按各账号余额兑至耗尽」）
- 阅读以「 兑换为不可逆写操作」开头的警示块，确认无误后点击「确认兑换（不可逆）」；有任何疑问点「取消」。
高风险操作
星星兑换。
- 会发生什么：确认后立即对每个勾选账号逐次兑换，消耗星星并获得饰品。警示块原文：「 兑换为不可逆写操作，提交后无自动重试；每账号将逐次确认兑换，出现失败或结果不清晰即停止该账号。请确认账号与饰品无误后再继续。」
- 不能撤销：已成功的兑换无法撤回；软件不会自动重试，也没有「停止兑换」的撤销功能。
- 何时不要点：账号、饰品、数量任一项没核对清楚；「预计总消耗」超过您愿意花的数量；账号状态为「兑换·待复核」或页面出现「任务跟踪已中断」警告条；星星余额未知。
- 结果不明确时：先用「查询武库信息」核对「当前星余额」，不要重复提交同一兑换。
这一步的作用：真正提交兑换。点击确认后，软件先把本次任务的防重复提交标记保存在浏览器里，再提交给后端，每 800 毫秒查询一次进度。 你会看到：
- 点击后条件不满足时的提示：代理横幅文案；「请先在下拉中选择要兑换的饰品。」；「请先勾选要兑换的武库账号。」
- 任务结束总结：「武库星星兑换任务完成：成功 N，失败 M，待复核 K。」
- 所选项不在目录中：「武库星星兑换任务完成：所选兑换项不在本地目录，未发送任何兑换。」
- 异常中止：「武库星星兑换任务异常中止：{原因}」
- 同一账号已有兑换任务时会被拒绝。 注意：
注意
同一时间只能有一个武库任务（购买、激活、兑换、查询互斥）。
图 11-14 「确认开始星星兑换」最终确认框（定量版）
图 11-15 「确认开始星星兑换」最终确认框（全部兑换版）
11.12 兑换进度与结果抽屉（四种结果）
在哪里：确认后屏幕中央弹出「武库星星兑换进度」对话框；任务结束后右侧弹出抽屉「星星兑换结果」。 怎么做：
- 在进度框观察「总数」「完成」「成功」「失败」。运行中可点「后台运行」，结束后点「关闭」。进度框点遮罩不会关闭。
- 任务结束后阅读结果抽屉，按分组核对每个账号：
| 分组 | 含义 | 星星有没有动 |
|---|---|---|
| 成功 | 该账号兑换成功，说明如「成功兑换 n 个 {饰品名}」 | 已扣 |
| 失败 | 兑换未成功 | 以说明为准，先核对再决定 |
| 余额不足 | 发送前被拦截，说明：「runtime 星星余额不足以支付所选兑换项，已在发送前拦截，星星未动。」 | 没动 |
| 待复核 | 已发送但结果不清晰 | 可能已消耗 |
- 出现「待复核」时，抽屉顶部提示：「存在「待复核」账号：星星可能已消耗但结果不清晰。请点「查询武库信息」核对当前星余额，切勿重复兑换。」按提示先点「查询武库信息」，对比兑换前后的「当前星余额」，确认后再决定是否继续。 这一步的作用：告诉您每个账号到底发生了什么。结果同时写入账号表格的「执行状态」列。 你会看到：无结果时显示「暂无结果」；每组显示「N 个」，条目为账号名加说明。常见说明：
- 「兑换成功：XPShop 余额已减少。」
- 「成功兑换 n 个 {名称}，剩余星星不足以继续，已停止。」
- 「已发送兑换但连接中断，结果不清晰，标记为待复核，绝不自动重试。请稍后用“查询星星余额”人工复核。」（“查询星星余额”即界面上的「查询武库信息」）
- 「成功兑换 n 个 {名称} 后连接中断，已停止（未重试）。」
- 「连接在就绪前中断，未发送兑换，请稍后重试。」（发送前失败，未消耗星星） 注意：
注意
兑换结果抽屉没有「重试失败」按钮（只有查询类结果有）。「失败」或「待复核」的账号需要您核对后，自己决定是否重新发起。 注意：关闭抽屉后结果只留在「执行状态」列里，刷新页面或重启软件会消失，请在关闭前记录。
图 11-16 兑换进度对话框
图 11-17 星星兑换结果抽屉（四种分组）
11.13 任务跟踪中断时的处理：恢复任务跟踪
在哪里：「兑换饰品」按钮下方出现的警告条（只在跟踪中断时出现）。 怎么做：
- 看到警告条标题「任务跟踪已中断，但兑换锁仍保留」，描述「请恢复原任务，切勿重新发起兑换。」
- 点击「恢复任务跟踪」。
- 恢复完成后会自动弹出「星星兑换结果」抽屉，按 11.12 核对。 这一步的作用：沿用原来的任务和防重复提交标记继续查看进度，不会产生第二笔兑换。 你会看到：可能出现的提示：
- 「武库兑换任务结果尚未确认，幂等键和任务锁已保留。请恢复跟踪，切勿重新发起兑换。」
- 「武库兑换任务跟踪暂时中断，任务仍保持锁定。请稍后点击“恢复任务跟踪”，切勿重复兑换。」
- 存在未完成任务时再次开始：「已有武库兑换任务尚未完成，请先恢复该任务。」
- 进度对话框在跟踪中断时显示：「查询武库兑换进度连续失败，任务仍在后台锁定，请稍后恢复跟踪。」 注意：
高风险操作
结果待确认的账号，请不要再发起同一个兑换。
- 会发生什么：「待复核」「跟踪已中断」说明上一次兑换可能已经发出，星星可能已经被消耗。
- 不能撤销：如果重复发起，可能多兑一次，星星无法退回。
- 何时不要点：账号显示「兑换·待复核」时，不要再点「兑换饰品」；先「恢复任务跟踪」或「查询武库信息」核对。
- 结果不明确时：先用「查询武库信息」核对「当前星余额」，确认没有扣减或扣减已完成后，再决定是否继续。 注意：本软件在前端防重复提交，依赖浏览器本地保存的标记。换浏览器或环境、或清除浏览器缓存/站点数据后，这个标记会丢失，页面将不再提醒您上一次尚未完成。此时务必先用「查询武库信息」核对每个账号的星星余额。后端对同一账号并发兑换仍有拒绝保护，但重启软件后是否仍保留（以实际软件为准）。
图 11-18 任务跟踪已中断警告条与「恢复任务跟踪」
11.14 常见问题
Q1：点「兑换饰品」没有反应，或提示要皇家代理？ 先看页面顶部是否有警告横幅，按横幅提示到「全局代理」页的「内购｜武库」卡片补齐配置（见 11.2）。从未设置过时默认等同于皇家代理，需要先填写皇家代理凭据。
Q2：提示「该账号缺少 maFile 令牌（shared_secret），请先导入令牌。」？ 按 11.4 重新导入令牌，确认「令牌」列不是「未匹配」。
Q3：为什么表格里「当前星余额」是「未知」？ 还没有对该账号点「查询武库信息」，或软件重启后需重新查询。
Q4：账号显示「兑换·待复核」，可以再兑换一次吗？ 不可以。先点「查询武库信息」看「当前星余额」有没有减少，确认后再决定（见 11.13）。
Q5：查询时账号提示被 Steam 限流？ 按提示等待约 10 分钟后只重试失败的账号，不要连续反复点击。
Q6：换了电脑或浏览器，还能看到上次的兑换结果吗？ 看不到。「执行状态」列和防重复提交标记都保存在当前页面或浏览器里，需要自行记录。
Q7：武库页的账号和「账号工作台」不一样？ 正常，武库使用独立账号库，可用「同步主列表」增量同步（见 11.3）。