﻿BidKing Live 悬浮窗 — 公版使用说明
====================================
具体版本以同目录 BUILD_MANIFEST.txt 为准。

【这是什么】
游戏对局时的实时仓库估价悬浮窗。官方 2026-07-23 版本调整了连接方式，因此需要先
启动 Hero Ref，再启动游戏。软件会在本机读取对局中的公开信息，自动识别英雄、地图、轮次和阶段,
持续吸收件数、格数、均价、技能/道具揭示、小地图等公开证据,
给出「保守 / 参考 / 激进」三档出价建议。估价是统计推理,不是读取隐藏真值。

【当前主要能力】
· 原有五位主要英雄专项适配:艾莎、艾哈迈德、加布里埃拉、伊森、拉文。每位英雄按
  自身技能、揭示方式和轮次节奏处理,不是统一套固定倍率。
· 玛丽亚、伊万已接入各自专属技能证据与显示。其余已支持英雄仍按现有通用/轮次合同处理；
  这不代表所有英雄都已完成与上述五位同等级的专项校准或实战验证。
· 对局证据会逐轮合并:总件/总格、各品质件格、均价/均格、至宝、扫描揭示、
  已识别藏品形状与价值等会共同收窄候选；无法确定的隐藏红仍按概率估算。
· 主面板、详情、迷你卡和 hover 使用同一份结果。悬停可查看候选组合、联合概率、
  各品质件数/格数、红品价值范围及当前采用的证据。
· 支持普通、排位、活动地图；红箱活动图 2541–2550 / 4541–4550 使用独立爆率校准,
  不会套用普通沉船或旧活动倍率。
· 已持续修复结算卡顿/漏藏品、跨局残留、开局不出数、深轮重复推理、窗口恢复、
  金红件格与价值错配、完整揭示少算等高影响问题。

【激活与试用】
· 软件标准新设备试用为【12 小时】；具体发放与剩余时间以悬浮窗显示的服务器权威额度为准。
  试用按自然时间计算。
· 每次启动需联网确认免费额度或会员权益,通常几秒完成；网络繁忙时会自动重试。
· 标题下方「免费额度 · …」一行显示状态:试用剩余 / 会员剩余(快到期会变红);
  付费剩余超过 90 天时整行隐藏,进入最后 90 天后显示倒计时和「更换 token」入口。
· 试用到期 / 未激活 → 界面锁定:不再给任何英雄出价建议,显示「需激活 token」。
· 怎么激活:点标题下方「点此输入/购买 token」→ 粘贴作者发你的 token → 点「激活」
  → 成功后立即解锁(无需重启；同一设备换新版通常不用重输)。
· 所有档位均可正常使用计算器。
· 绑定设备档:30 天 ¥15.88 ｜ 90 天 ¥35.88 ｜ 365 天 ¥88.88(公版最高档)。
· 可换绑档:30 天 ¥24.88 ｜ 90 天 ¥48.88 ｜ 365 天 ¥118.88。换设备激活时会重新绑定到当前设备。
· 一次性购买，不自动扣款；续费、换档或衔接剩余时间，请先联系作者核对。
  店铺新卡不承诺自动叠加已有时间；既有人工续费承诺按原约定处理。
· 猫猫:免费 10 分钟 ｜ 30 天 12 小时 ｜ 90/365 天有效期内可用。
· 90/365 天档在订阅有效期内可用「我的记录」。
· 365 天档和历史永久版另含完整私有大数据和高级个性化；永久档已不再新售。
  音效、动画与互动成长将逐步扩充。

【启动会做什么 · 需要什么】
· Steam 可以保持开启，但 BidKing.exe 必须完全退出。新版必须按顺序启动:
  【完全退出游戏】→ 双击「BidKingLive.exe」→ 等悬浮窗出现 → 再从 Steam 启动游戏。
· 已经登录、位于大厅或对局时不要中途打开或重启计算器；否则本局可能无法正常读取。
· 双击「BidKingLive.exe」(小猫图标)会弹出管理员授权,点「是」。
· 首次启动会询问是否为当前 Windows 用户信任一张【本机生成】的兼容证书。
  该设置仅用于本机对局数据兼容；不会记录或上传登录账号、激活 token，
  证书和私钥不会随包分发或上传。点击取消不会添加证书信任，并退出。
  确认后，exact 产品证书会保留在当前 Windows 用户的信任区，后续正常启停直接复用，
  不会在每次退出时要求删除。需要明确撤销时，才运行
  「诊断工具\高级卸载与清理\卸载本地兼容证书（高级清理）.bat」。
· 启动后会同时运行后台数据读取和悬浮窗。游戏运行中关闭悬浮窗只会关闭界面,
  后台读取会继续；再次启动计算器可恢复界面。游戏退出后后台读取会自动结束
  (有短暂宽限),不需要重新打开悬浮窗再关闭。
· 需要(系统要求):
    - Windows 10 / 11(64 位)。不支持 Windows 7 / 8 / 8.1 与 32 位系统
      (内嵌的 Python 3.13 已不再支持旧系统;在旧系统上会启动后自动退出)。
    - 需「Microsoft Visual C++ 2015-2022 可再发行组件 (x64)」。多数 Win10/11 已自带;
      若启动时提示"运行环境自检未通过", 装一次即可:https://aka.ms/vs/17/release/vc_redist.x64.exe
    - 管理员授权
    - Hero Ref 启动完成后再启动游戏并进入对局
    - 整个文件夹完整解压;杀毒软件请放行 runtime / vendor / .exe(易误报)
· 试用确认、token 激活/续期、每次启动授权和云端上传需要联网。运行中网络中断时
  可能暂时锁定报价；网络恢复后会自动重试,无需反复更换 token。

【首次兼容设置 / 能进游戏但不计算】
1. 完整解压程序包，不要在 ZIP 内直接运行。
2. 将整个文件夹（解压后的 Hero Ref/BidKingLive）加入火绒或 360 的信任区/白名单。
3. 首次启动或能进游戏但不计算时，完整退出火绒、360、游戏加速器；
   仅关闭主窗口可能仍有后台防护或服务。
4. 先启动 Hero Ref，等待悬浮窗出现，再启动游戏。
5. 仍不计算时按同一顺序重启，再收集脱敏诊断私发；不要反复更换 token。
6. 不要卸载或永久关闭安全软件。测试后可恢复防护；若恢复后再次失效，
   请保持安全设置并等待兼容更新。
· Hero Ref 不会自动修改安全软件、Windows 安全功能、代理、路由或 DNS。
· 两台独立机器已确认火绒防护调整前后存在同向兼容表现，但这不代表所有失败都由
  火绒造成，也不代表文件夹白名单对每台机器都必然足够。

【怎么用】
1. Steam 可以保持开启；确认 BidKing.exe 游戏进程已完全退出。
2. 双击 BidKingLive.exe,点「是」授权；首次使用按提示完成本机兼容设置。
3. 等悬浮窗出现后,再从 Steam 启动游戏并进入拍卖。标题会显示「英雄 · 地图 · 轮次」,
   对局进行中实时更新估价。
4. 主要看「参考」档作为出价参考;保守=安全下限,激进=博隐藏红的上限。
5. 把鼠标移到红品、紫金件、红/空格或三档报价上,查看概率、候选和证据详情。
6. 悬浮窗可拖动移动;拖右下角 / 右上角的小三角可缩放大小。位置、大小和配色
   会保存到用户配置,换新包后仍可恢复。

【界面布局】
· 顶部标题: 英雄 · 地图 · 轮次   |   阶段 · session 编号
· 三档报价:
    保守(绿) = 安全下限(假设看不见的红 = 0,稳)
    参考(橙) = 主要参考价(最可能的总价值)
    激进(红) = 上限(博一个隐藏红)
· 红品与值:
    红件 / 红格 = 估计的红色藏品件数 / 格子数(范围)
    紫金件     = 紫色 / 金色藏品件数
    红值       = 红色藏品总价值(范围)
    低品件     = 已确定的白绿蓝低品(公开揭示 / 已锁定)
· 当前建议:
    动作   = 当前可否出价 / 等待
    最近   = 最近一次揭示 / 抽检结果
    红/空格 = 估总格减去已知白绿/蓝/紫/金格后的几何余量(范围)
    候选   = 估计总件数 · 总格(范围)
    下一步 = 建议补什么信息(用道具 / 技能揭示)
· 顶部额度行 = 试用 / 最后 30 天会员倒计时 ｜ 点此输入/购买 token。

【按钮】(顶部一排,鼠标悬停都有中文提示)
  藏价/显价 = 隐藏 / 显示结算金额(只影响界面、不影响计算;想自己先看结算就藏起来)
  导出      = 异常 / 卡住 / 结算不对时点这里，导出当前可用的对局状态和近期日志；
              诊断包保存在 Windows“文档\BidKingLive\exports”，可按完成提示中的路径查找
  地图      = 悬停查看小地图;点击把小地图钉住
  配色      = 切换界面配色
  手填      = 手动填写(断网或识别缺项时,补总件 / 均格 / 件数 / 均价等;
              手填时实时抓取不会覆盖你的输入)
  详情      = 展开 / 收起 详情面板 + 小地图 + 手填区
  ⟳         = 刷新当前界面显示。任何时候都可使用,不会重启后台读取或影响当前对局
  T         = 置顶开关(置顶 / 自由窗口)
  ×         = 关闭悬浮窗。游戏运行中后台读取继续;游戏退出后会自动结束后台
  右下/右上小三角 = 拖动缩放(实时,横竖都放大,高度自动贴合内容)

【常见问题】
· 提示「请先关闭游戏」/ 开了却没数据:
    ① Steam 可以保持开启,但 BidKing.exe 必须完全退出
    ② 先开 Hero Ref,等悬浮窗出现  ③ 再从 Steam 启动游戏
    ④ 确认程序文件夹已完整解压且未被杀毒软件拦截。
· 游戏运行中整局没数据 / 卡住:
    先点「导出」保留诊断。顶部 ⟳ 只刷新当前界面;关闭后重新打开也只恢复当前界面,
    不能重新接管已经丢失的数据连接。需要恢复连接时必须完全退出 BidKing.exe,
    再启动 Hero Ref,最后重新从 Steam 启动游戏。
· 不想保留本机兼容设置:
    运行「诊断工具\高级卸载与清理\卸载本地兼容证书（高级清理）.bat」。
    这是卸载/清理动作，不是诊断。工具会先经过完整性门，只处理 exact 产品 CA
    与私有 journal；预先存在或身份不明的证书一律保留。清理后，下次启动需要
    重新完成一次产品兼容初始化。
· 网吧/还原盘/受限 Windows 用户首次设置失败:
    先运行「诊断工具\网吧环境兼容检查.bat」。该检查不会安装证书、组件、
    驱动或服务，只输出固定分类。若结果为 internet_cafe_realtime_unsupported，
    更换 token、Npcap、解压路径或 off_native 都不能替代 WSS 本地解密；请联系
    网吧管理员放行已验证组件/驱动，或改用受支持的个人电脑。
· 开了加速器/VPN 后没有数据:
    先确认启动顺序，再点导出诊断；不要在游戏已经运行时反复重启计算器。
· 主界面打不开，并提示后台身份、旧版本进程或启动锁冲突:
    先完全退出 BidKing.exe，再运行「诊断工具\启动修复.bat」。工具会先只读分类，
    仅在你明确确认后处理已完整证明属于 BidKing 的旧后台或已退出进程留下的单个锁；
    身份不明、查询失败、状态变化或游戏仍在运行时不会终止进程或删除锁。
    脱敏修复回执保存到“文档\BidKingLive\exports”，可连同收集诊断私发支持人员。
· 杀软误报: 把整个程序文件夹加入白名单。
· 估价不对 / 卡住 / 结算没进入:点「导出」保存当前可用的对局状态和近期日志，或运行
  「诊断工具\收集诊断.bat」生成系统与日志诊断报告。两者均保存到“文档\BidKingLive\exports”；
  完成后按提示路径查找文件，若失败请保留错误提示并联系支持人员。
  诊断可能含设备与软件环境。请连同英雄、地图、轮次、等待时间和画面仅私发支持人员，
  不要发群或公开上传，也不要发送活动日志目录里的原始文件。
· 激活显示 offline / 网络连接失败:运行「诊断工具\激活网络诊断.bat」,
  把包根生成的 activation_transport_diagnostic.txt 私发给作者。报告会判断本机加密缓存
  是否可读,但该缓存只用于诊断,不代表离线授权；offline 时不要反复更换 token 或清除缓存,
  也不要公开完整 token。
· 激活显示 token 无效:只在此提示下重新核对并粘贴 token；网络失败无需反复换 token。
· 激活显示 token 已验证但保存失败:检查程序目录或当前 Windows 身份的写入权限后重试。
· 关闭悬浮窗后仍有后台进程:
    游戏仍运行时这是保护当前连接的正常行为。完全退出 BidKing.exe 后等待几秒,
    后台读取会自动结束;如果长时间仍未退出,请运行诊断并私发作者。

【重要说明】
· 估价是统计推断,不是绝对真值。红色藏品对部分英雄不可见,只能按期望估算;
  当某局开出「长尾稀有红」(价值远超同类)时,引擎会显示「欠估」,这是正常的。
· 公开信息(每件均格、总件数等)会被引擎自动吸收,提高准确度。
· 本地 sessions 历史只保留最近 300 个对局及其全部轮次,降低长期使用后的文件膨胀
  和结算卡顿；成功上传的云端记录不受这个本地保留上限影响。

【数据与隐私】
· 公版在对局结算后默认自动上传经裁剪的结算数据,用于统计、产品改进、故障排查和
  具备权限用户的「我的记录」。数据可能包含游戏内昵称、参与者/赢家、出价、排位信息、
  付费身份哈希及结算统计;不上传原始网络内容、网络 IP 或明文激活 token。
· 服务器私有域保留逐局业务数据并限制访问。无需登录的公共大数据页面只输出去身份的
  统计聚合,不展示昵称、账号/uid 标识、session、逐局出价或逐局记录。
· 公共大数据可查看地图掉率、波动、时间趋势、藏品价格、样本量及联合筛选/排序:
  https://api.bidkinglab.cn/public
· 「我的记录」与私有大数据需每次由用户确认 token；浏览器可记住输入,但不会自动越权。
  「我的记录」向有效 90/365 天订阅和历史永久版开放；完整私有大数据仍只向有效
  365 天订阅和历史永久版开放。服务端只返回对应权限范围的数据。

【购买 / 续费 / 联系】
· 本工具为付费激活版,标准新设备试用 12 小时；具体发放与剩余时间以悬浮窗显示的服务器权威额度为准。
· 所有档位均可正常使用计算器。
· 绑定设备档:30 天 ¥15.88 ｜ 90 天 ¥35.88 ｜ 365 天 ¥88.88(公版最高档)。
· 可换绑档:30 天 ¥24.88 ｜ 90 天 ¥48.88 ｜ 365 天 ¥118.88;换设备时重新绑定到当前设备。
· 可换绑卡累计最多换绑 8 次；首次绑定不计次，同卡续签/重签不重置次数，不追溯补计历史换绑。
· 一次性购买，不自动扣款；续费、换档或衔接剩余时间，请先联系作者核对。
  店铺新卡不承诺自动叠加已有时间；既有人工续费承诺按原约定处理。
· 猫猫:免费 10 分钟 ｜ 30 天 12 小时 ｜ 90/365 天有效期内可用。
· 90/365 天档在订阅有效期内可用「我的记录」。
· 365 天档和历史永久版另含完整私有大数据和高级个性化。
  音效、动画与互动成长将逐步扩充。历史永久版保留既有权益,但永久档已不再新售。
· 店铺:打开「购买与续费\打开店铺.html」，或扫描该目录「店铺二维码.png」进入店铺。
  主店铺:https://www.kufaka.com/shop/GGTO42L9；店铺二维码不是付款码。商品及发放方式以实际商品说明为准。
· 人工购买:打开「购买与续费」文件夹,支付宝扫「支付宝付款码.png」或微信扫「微信付款码.jpg」。
  付款后把付款截图 + 想要的档位发给作者,人工核对后回复 token；当前不会自动到账。
  收到后点悬浮窗「点此输入/购买 token」粘贴激活。详细步骤见「购买与续费\扫码购买说明.txt」。
· 续费:续费、换档或衔接剩余时间，请先联系作者核对，不要仅购买新卡就假定会自动合并。
· 30 天猫猫只在显示时扣减配额，不是每天 12 小时；30 天不含「我的记录」及完整私有大数据。
  90 天不含完整私有大数据；会员按自然时间计时，90/365 天若先用本卡登录会员数据页，也会开始计时。
· 联系方式:QQ 1748885430 · 群 980106659(有任何问题、bug、换设备申诉都可找作者)。

祝竞拍愉快 —— 作者: 加菲_Barista · 协作: lemyes
