附录 常见问题

适用版本 v4.0.1。每条按"现象、原因、处理"写。拿不准的标了（以实际软件为准）。不要在向他人求助时贴出账号、密码、令牌、代理账号密码。

一、启动与界面

1. 启动时弹出「WebView2 初始化失败」

• 原因：软件界面依赖 WebView2 运行库，初始化没成功。弹窗里还会带一段具体原因。
• 处理：确认电脑是 Windows 系统，并已安装 WebView2 运行库；安装或修复后重新双击启动。若 exe 放在路径很深的文件夹里，可尝试移到较短的路径再试（以实际软件为准）。仍不行，请把弹窗文字截图（不含账号信息）反馈。

2. 双击后没有窗口或一闪而过

• 原因：可能是运行库缺失、被安全软件拦截，或同一个程序已在运行（以实际软件为准）。
• 处理：先查看任务栏和后台是否已有该程序；暂时放行安全软件后重试；仍不行按第1条处理。

3. 全家桶里看不到挂卡助手的账号，或反过来

• 原因：两个产品的数据目录和登录状态是分开的（全家桶 data，挂卡助手 farming-data）。
• 处理：这是正常设计，在各自产品里分别导入和登录。

4. 部分页面还是中文，切到「EN」没变

• 原因：语言切换目前只覆盖部分页面（CS2 弹窗、导出、CS2 筛选等）。
• 处理：属正常现象。

二、登录与二次验证

5. 账号登录提示"需要 maFile / SDA 验证，请切换到 maFile 登录模式"

• 原因：账号开了手机令牌，而当前是邮箱登录或账密登录模式，这两种模式不会算令牌码。
• 处理：把「登录」切换为「maFile」，并导入对应的 maFile（见第3、4章）。

6. 提示"需要邮箱验证码，请切换到邮箱登录模式"

• 原因：账号登录需要邮箱验证码，而当前是 maFile 或账密模式。
• 处理：切换为「邮箱登录」，并确认账号带有辅助邮箱及其取件凭据（见第3、4章）。

7. 账号状态显示「需要验证码」

• 原因：账号需要二次验证，但软件没能自动完成（比如缺 maFile、缺辅助邮箱凭据，或自动取邮箱码失败）。
• 处理：按上面第5、6条补齐对应凭据；这类失败不会自动重试，处理完后对该账号重新查询。

8. 点「获取邮箱验证码」拿不到码

• 原因：常见原因有：还没在 Steam 登录页触发发送验证码；邮箱密码或取件凭据不对；代理不通；邮箱服务商限频。
• 处理：先在 Steam 登录页触发发送，再点按钮；核对邮箱凭据；检查代理；稍等再试。不要连续反复点击。

9. 点「复制最新令牌」提示"该账号缺少 SDA 共享密钥"

• 原因：该账号没有匹配的 maFile，或 maFile 里没有共享密钥（状态为「未匹配」）。
• 处理：先导入正确的 maFile 使状态变为「完全体」或「阉割版」。复制出来的令牌码每 30 秒换一次，请尽快使用；若系统时间明显不准，码可能无效，建议先校准系统时间（以实际软件为准）。

10. 提示"短期内来自您所在位置的失败登录过多"或"登录请求限流"

• 原因：Steam 对当前出口网络临时限制了登录。
• 处理：停止继续点击；降低线程数；换一条出口线路（代理）；隔一段时间再试。

11. 状态是「密码错误」，但我确定密码对

• 原因：「密码错误」是根据登录失败的文字判断的，可能存在误判；也可能是导入时密码带了多余字符或分隔符冲突。
• 处理：回到导入文本核对密码；用少量账号重新验证；其他失败原因会显示为「查询失败」，不要把它当成密码错。

三、导入与查询

12. 导入后提示有"无效 N 行"

• 原因：这些行不符合当前登录方式的要求。例如账号或密码为空；账号名含非英文字符；邮箱登录模式下写了邮箱却缺邮箱密码。
• 处理：按第3章的格式修正后重新导入。支持的分隔符有 ----、---、制表符、:。

13. 切换登录方式后，账号列表"少了"

• 原因：切换后账号列表会按当前登录方式重新载入，账密登录使用独立账号库，与其他两种模式不互通。
• 处理：切回原来的登录方式即可看到原来的账号。

14. 提示"邮箱登录模式下没有可查询的有效账号"

• 原因：所选账号都缺少邮箱取件所需的凭据，被跳过了。
• 处理：自建邮箱需要邮箱密码；微软邮箱需要邮箱密码，或同时有 ClientId 与 RefreshToken。补齐后重新导入。

15. maFile 显示不完整 / 大量「未匹配」

• 原因：选的令牌目录不对，或 maFile 与账号对不上。
• 处理：重新选择正确目录，核对 maFile 内的账号名与导入的账号是否一致。导入后会提示「完整 N，阉割 N，未匹配 N」可供核对。

16. 查询长时间没有进展 / 大面积失败

• 原因：代理不通、线程过高被限流，或网络波动。
• 处理：打开「日志与反馈」看具体原因；到「全局代理」重新检测；降低线程数；只对上轮失败的账号重试（按钮「查询上轮失败信息」）；仍不明确就先停下，不要反复重试。

17. 部分字段是空的

• 原因：对应的查询项没有勾选或没有查询成功。
• 处理：确认已勾选需要的查询项并完成查询；失败项可单独补查。

四、代理

18. 代理检测显示「可访问」，但查询还是失败

• 原因：「可访问」只代表检测那一刻能连通 Steam，不等于已经生效，也不保证不被限流。
• 处理：确认在「全局代理」右栏已经选中该代理并看到「生效」；再点「预检」；降低线程数后少量重试。

19. 选了代理却像没生效

• 原因：配置资源和选择页面策略是两件事；或者选中的资源没配置完整（显示「待配置」）。
• 处理：先在左栏配置并检测，再在右栏「查询项」「账号安全」里选中它。

20. 「账号安全」里选不了外部加速器

• 原因：外部加速器只支持查询，账号安全需要稳定出口，不支持。
• 处理：账号安全改选本地代理、内置代理、API代理、皇家代理或蜘蛛粘性代理。

21. API代理提示「代理商拒绝连接（403）」

• 原因：可能是认证格式、账号权限或出口网络被代理商限制。
• 处理：先核对完整用户名、密码和服务权限；如果代理商限制当前出口，可以填「前置代理端口」（或点「自动检测」），再点「重新检测」。

五、导出与安全

22. 导出的文件里有明文密码吗？能发给别人吗？

• 原因：导出的目的是保存账号资料，是否包含密码、邮箱凭据等取决于您勾选的导出项（以实际软件为准）。
• 处理：把导出文件当作敏感文件保管，不要发到聊天或公开位置；确需发送时先打开检查并去掉敏感列。

23. 安全类任务（改密、换绑）显示「待复核」

• 原因：结果不明确（比如网络中断，不确定 Steam 端是否已经生效）。
• 处理：不要重复提交；先用校验功能核对账号当前状态，再决定是否继续。

24. 武库兑换或其他任务中途中断了，要不要重来

• 原因：中断时可能已经提交到 Steam。
• 处理：优先恢复任务跟踪或先核对结果，确认前不要重新兑换，以免重复花费。

25. 向别人求助时该提供什么

• 处理：在「日志与反馈」导出反馈包（会脱敏），发送前自己打开检查；截图时遮盖账号、密码、邮箱、令牌、代理账号密码。详见第14章。