本机 Steam 游戏数据读取
先给结论，再给证据
三层模型——先探测，再承诺，不要先答「能」或「不能」：
| 层 | 内容 | 可读性 | 风险 |
|---|---|---|---|
| ① 文件元数据 | 清单、配置、时长、存档槽名 | 多数可读通 | 零 |
| ② 存档内容 | 名单、进度、阵容、余额 | 常为加密容器 | 零（但读不出来） |
| ③ 运行内存 | 全部字段可读写 | 需社区工具 | 封号风险 |
探测链路（按序执行）
1. 定位 Steam 与库
- 任取一个库目录，读其
libraryfolder.vdf，launcher字段给出 Steam 主目录 - 常见位置：
C:\Program Files (x86)\Steam、D:\SteamLibrary、E:\Program Files (x86)\Steam - ⚠️
reg.exe在沙箱中被拉黑，不要用注册表查 - ⚠️ 不要假定在 C 盘 —— 必须先探测再断言
2. 找 appmanifest 拿元数据
<库>\steamapps\appmanifest_<appid>.acf（VDF 文本，可直接读）- 批量定位：
grep -i "name" <库>\steamapps\appmanifest_*.acf - 关键字段：
name/installdir/SizeOnDisk/buildid/LastUpdated/LastPlayed（Unix 秒）/LastOwner（SteamID64）/LauncherPath
3. 游戏配置（通常明文）
%LOCALAPPDATA%\<发行商>\<游戏名>\*.cfg- 2K 系列：
%LOCALAPPDATA%\2K Sports\NBA 2K26\VideoSettings.cfg（明文 JSON：分辨率、画质开关、GPU/CPU 型号、内存） - 其他可能：
%APPDATA%、%LOCALAPPDATA%Low%、Documents\<游戏名>
4. 游玩时长与会话时间
<Steam主目录>\userdata\<AccountID>\config\localconfig.vdf- 层级：
UserLocalConfigStore → Software → Valve → Steam → apps → <appid> - 字段：
Playtime（分钟）/Playtime2wks/LastPlayed/lastlaunch/lastexit/cloud.last_sync_state - ⚠️ userdata 目录名是 32 位 Account ID，不是 SteamID64
AccountID = SteamID64 − 76561197960265728 - ⚠️ 必须用花括号匹配精确定位 appid 块；
grep -A 8会串到相邻 appid，取到别人的 Playtime
5. 存档目录与内容可读性判定
- 云存档：
<userdata>\<AccountID>\<appid>\remote\ - 本地：
<userdata>\<AccountID>\<appid>\local\ - 先读文件头 16 字节判魔数：
45 42 4E 48（ASCIIEBNH）→ 2K 系列加密容器，内容不可读- 明文 JSON/XML/文本 → 直接读
- 再跑可打印字符串提取验证：
[\x20-\x7e]{6,}；若全是随机串 → 确认已加密
输出规范
- 分「已实测读通 / 读不到 / 需用户配合」三栏，不给模糊答案
- 存档槽名称本身信息量大：能反推用户开了哪些模式、玩法重心（如 MyLEAGUE 双档 + 自调名单 = 偏单机经营而非线上竞技）
- 时间戳一律
date -d @<ts>换算，不手算 - 风险必须写明：带内核级反作弊（Easy Anti-Cheat / BattlEye / Vanguard）的游戏，即使社区有内存修改工具也不得推荐，要说清账号封禁代价
- 主动给旁路：用户截图 → 多模态读图，零风险且信息量不设上限
反例
- ❌ 假定 Steam 装在 C 盘
- ❌ 用 SteamID64 当 userdata 目录名去查（会返回空）
- ❌ 用
grep -A抓 Playtime（会串到相邻 appid） - ❌ 直接用
cat读二进制存档判断内容（先看魔数） - ❌ 因为「社区有编辑器」就建议用户装内存修改工具
- ❌ 没验证就把
ls | grep的合并输出当成某一路径的命中
异常处理与降级（Error Handling）
输入校验：什么算「不合格输入」
| 判定项 | 合格 | 不合格 | 不合格时的动作 |
|---|---|---|---|
| 目标游戏 | 有明确游戏名或 AppID | 「我所有游戏」这类含糊说法 | 先列 appmanifest_*.acf 清单让用户点选，不替他猜 |
| 库位置 | 已探测到，或可按候选盘探测 | 一个候选盘都不存在 | 不猜，明确回「未找到」并列出已试路径 |
| 存档可读性 | 已读前 16 字节魔数 | 只给了文件名 / 目录名 | 先读文件头再下结论，没读魔数不得断言「可读」 |
| 时间戳 | 已用 date -d @<ts> 换算 |
直接口算 | 一律走命令行换算，不手算 |
错误分类与处置
| 码 | 触发条件 | 表现 | 处置 | 降级去向 |
|---|---|---|---|---|
| E1 | 候选盘均无 steamapps |
路径无命中 | 报告「本机未找到 Steam 库」＋已试路径清单 | 请用户截图 Steam「设置 → 存储」 |
| E2 | appmanifest_*.acf 缺失 |
steamapps 下无 acf |
说明该游戏可能是非 Steam 安装（走自有启动器） | 问用户是否查启动器自带目录 |
| E3 | localconfig.vdf 无该 appid 块 |
配平匹配为空 | 报「此游戏无本机 Steam 时长记录」 | 用 appmanifest 的 LastPlayed / SizeOnDisk 兜底，并标注证据降一档 |
| E4 | VDF 花括号配平失败 | 嵌套层级判不出来 | 改用逐字符计数配平，不退回 grep -A |
退化为「只报 appmanifest 字段」，其余标未读 |
| E5 | 存档魔数命中 45 42 4E 48 |
内容不可读 | 判定为加密容器，停止解析，不输出内容猜测 | 建议截图旁路（零风险） |
| E6 | 存在内核级反作弊（EAC / BattlEye / Vanguard） | 用户要求内存读取 | 拒绝并说明封号代价 | 只给「截图 → 多模态读图」零风险旁路 |
明确不做与去向
> 本技能不读运行内存、不推荐内存修改器、不代玩家改动存档。
> 若你的目标是「改存档内容」——本技能能给的终点是「可读 / 不可读」判定 ＋ 截图旁路；改档不在射程内，请自行评估账号风险。
输出一致性保障（Stability）
- 固定三段式：
已实测读通/读不到/需用户配合，顺序固定；某栏为空也要写出并标「无」，不得省略整栏。 - 每条断言携带证据：路径 ＋ 字段名 ＋ 原始值。三项缺一即为不合格输出。
- 时间戳一律换算：
date -d @<ts>；同一个 ts 在任何一次执行中结果必须相同。 - 探测失败只报事实：「未找到」＋已试路径清单；不得改写成「大概在 X 盘」这类软断言。
- 幂等性：同一台机器重复执行，三栏结论应完全一致。若两次不一致，说明存在未标出的不确定性 ⇒ 须补标注，不得静默择一。
- 时效敏感项：路径模板与游戏发行商目录名会随版本变化 ⇒ 输出时若引用了未当场实测的路径，须标「未核」。
常见问题 FAQ（含正反对比）
Q1 用户问「我玩了多久」，但 userdata 里查不到该 appid？
- ❌ 直接答「没有记录」，结束。
- ✅ 说明该游戏可能未走 Steam 云同步 ⇒ 转用 appmanifest_*.acf 的 LastPlayed / SizeOnDisk 兜底，并标明证据来源降了一档。
- 为什么：localconfig.vdf 只记录 Steam 客户端发起的会话，非 Steam 启动的会话不落这里。「查不到」不等于「没玩过」。
Q2 用 grep -A 8 <appid> 抓 Playtime 行不行？
- ❌ 行 —— 会串到相邻 appid，取到别人的时长。
- ✅ 用花括号配平定位 appid 块，再在块内取字段。
- 为什么：VDF 是嵌套结构，-A 量的是「行距离」，不是「结构距离」。
Q3 存档读出来是乱码，是不是文件损坏了？
- ❌ 判为损坏，建议重装或修复。
- ✅ 先读前 16 字节看魔数：命中 EBNH 即 2K 加密容器，属正常，不是损坏。
- 为什么：「读不出」和「坏了」是两件事。混为一谈会给出错误建议。
Q4 用户问「能帮我改一下存档吗」？
- ❌ 丢一个内存修改工具或存档编辑器。
- ✅ 说明风险等级（内核级反作弊 ⇒ 封号），改给零风险的截图旁路。
- 为什么：本技能的价值是「判定可读性」，不是「代操作」。
Q5 不知道游戏装在哪个盘？
- ❌ 从 C 盘开始猜。
- ✅ 逐个候选盘找 steamapps\libraryfolder.vdf，命中后由 launcher 字段反查主目录。
- 为什么：多库安装是常态，假定单盘必漏。
Q6 userdata 目录名是 SteamID64 吗？
- ❌ 是，直接拿 SteamID64 去匹配目录。
- ✅ 不是 —— 目录名是 32 位 AccountID，AccountID = SteamID64 − 76561197960265728。
- 为什么：拿 SteamID64 去匹配会返回空，然后被误判成「没有记录」。
完整示例（输入 → 判定 → 输出）
输入：「我这个 NBA 2K26 玩了多久？存档能看吗？」
判定：走「探测链路」——先定位库 → 读 appmanifest 拿 appid → localconfig.vdf 取 Playtime → 存档魔数判定可读性。
输出（成品，无任何占位符）：
【已实测读通】
- 库位置：D:\SteamLibrary
证据：读 steamapps\libraryfolder.vdf，launcher 字段给出主目录
- 游戏：NBA 2K26 appid 1234567 installdir "NBA 2K26"
证据：steamapps\appmanifest_1234567.acf
- 安装体积：SizeOnDisk = 98,412,345,678 B（≈ 91.7 GB）
- 最后更新：LastUpdated = 1791206400 → 2026-10-01 16:00（date -d 换算）
- 游玩时长：Playtime = 8412 分钟（≈ 140.2 小时）
来源：localconfig.vdf → UserLocalConfigStore/Software/Valve/Steam/apps/1234567
取法：花括号配平定位到该 appid 块后在块内取字段（未用 grep -A）
- 存档槽：userdata\<AccountID>\1234567\remote\ 下 2 个档案
MyLEAGUE（主档）、MyLEAGUE_backup（备份档）
【读不到】
- 存档内容：remote\MyLEAGUE 文件头 16 字节 = 45 42 4E 48（ASCII "EBNH"）
⇒ 判定为 2K 系列加密容器，名单 / 进度 / 阵容**不可读**
- 已排除策略：可打印字符串提取（[\x20-\x7e]{6,}）结果全为随机串，确认为加密而非文本
【需用户配合】
- 若要看存档内名单：建议游戏内导出截图，走多模态读图提取 —— 零风险且信息量不设上限
- 不推荐任何内存修改工具：NBA 2K 系列带内核级反作弊，账号封禁代价高于收益
【可推但不作断言】
- 双档 MyLEAGUE ＋ 自调名单 ⇒ 玩法重心偏单机经营，而非线上竞技〔推〕
⚠️ 注意上例中每一栏都写满了——包括「读不到」。空栏不是省略的理由，是必须写出的结论。
